UefiCpuPkg/MpInitLib: Add two instances PeiMpInitLib and DxeMpInitLib

Add two MP Initialize Library instances PeiMpInitLib.inf and DxeMpInitLib.inf
with NULL implementation.

One PeiMpInitLib.inf is consumed by PEI MP driver. Another DxeMpInitLib.inf is
consumed by DXE MP driver.

Place MpInitLibStartupAllAPs()/MpInitLibStartupThisAp()/MpInitLibSwitchBSP()/
MpInitLibEnableDisableAP() into PeiMpLib.c and DxeMpLib.c, because they have
the different implementations and will be updated in latter patches.

v5:
  1. Add back PeiExceptionHandlerLib.inf in UefiCpuPkg.dsc. It is removed
     incorrectly.

v4:
  1. Return EFI_UNSUPPORTED instead of EFI_SUCCESS for NULL implementation of
     all Functions.
  2. Sync MpInitLibxxx functions header updating described in v4 part of Patch
     #4.

v3:
  1. Rename MpInitLibSwitchBsp to MpInitLibSwitchBSP to match PI spec

Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Feng Tian <feng.tian@intel.com>
Cc: Giri P Mudusuru <giri.p.mudusuru@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Giri P Mudusuru <giri.p.mudusuru@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>

1 files changed, 119 insertions, 0 deletions

diff --git a/UefiCpuPkg/Library/MpInitLib/MpLib.c b/UefiCpuPkg/Library/MpInitLib/MpLib.c
new file mode 100644
index 0000000000..12bd04e151
--- /dev/null
+++ b/UefiCpuPkg/Library/MpInitLib/MpLib.c
@@ -0,0 +1,119 @@
+/** @file

+  CPU MP Initialize Library common functions.

+

+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>

+  This program and the accompanying materials

+  are licensed and made available under the terms and conditions of the BSD License

+  which accompanies this distribution.  The full text of the license may be found at

+  http://opensource.org/licenses/bsd-license.php

+

+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+

+**/

+

+#include "MpLib.h"

+

+

+/**

+  MP Initialize Library initialization.

+

+  This service will allocate AP reset vector and wakeup all APs to do APs

+  initialization.

+

+  This service must be invoked before all other MP Initialize Library

+  service are invoked.

+

+  @retval  EFI_SUCCESS           MP initialization succeeds.

+  @retval  Others                MP initialization fails.

+

+**/

+EFI_STATUS

+EFIAPI

+MpInitLibInitialize (

+  VOID

+  )

+{

+  return EFI_UNSUPPORTED;

+}

+

+/**

+  Gets detailed MP-related information on the requested processor at the

+  instant this call is made. This service may only be called from the BSP.

+

+  @param[in]  ProcessorNumber       The handle number of processor.

+  @param[out] ProcessorInfoBuffer   A pointer to the buffer where information for

+                                    the requested processor is deposited.

+  @param[out]  HealthData            Return processor health data.

+

+  @retval EFI_SUCCESS             Processor information was returned.

+  @retval EFI_DEVICE_ERROR        The calling processor is an AP.

+  @retval EFI_INVALID_PARAMETER   ProcessorInfoBuffer is NULL.

+  @retval EFI_NOT_FOUND           The processor with the handle specified by

+                                  ProcessorNumber does not exist in the platform.

+  @retval EFI_NOT_READY           MP Initialize Library is not initialized.

+

+**/

+EFI_STATUS

+EFIAPI

+MpInitLibGetProcessorInfo (

+  IN  UINTN                      ProcessorNumber,

+  OUT EFI_PROCESSOR_INFORMATION  *ProcessorInfoBuffer,

+  OUT EFI_HEALTH_FLAGS           *HealthData  OPTIONAL

+  )

+{

+  return EFI_UNSUPPORTED;

+}

+/**

+  This return the handle number for the calling processor.  This service may be

+  called from the BSP and APs.

+

+  @param[out] ProcessorNumber  Pointer to the handle number of AP.

+                               The range is from 0 to the total number of

+                               logical processors minus 1. The total number of

+                               logical processors can be retrieved by

+                               MpInitLibGetNumberOfProcessors().

+

+  @retval EFI_SUCCESS             The current processor handle number was returned

+                                  in ProcessorNumber.

+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is NULL.

+  @retval EFI_NOT_READY           MP Initialize Library is not initialized.

+

+**/

+EFI_STATUS

+EFIAPI

+MpInitLibWhoAmI (

+  OUT UINTN                    *ProcessorNumber

+  )

+{

+  return EFI_UNSUPPORTED;

+}

+/**

+  Retrieves the number of logical processor in the platform and the number of

+  those logical processors that are enabled on this boot. This service may only

+  be called from the BSP.

+

+  @param[out] NumberOfProcessors          Pointer to the total number of logical

+                                          processors in the system, including the BSP

+                                          and disabled APs.

+  @param[out] NumberOfEnabledProcessors   Pointer to the number of enabled logical

+                                          processors that exist in system, including

+                                          the BSP.

+

+  @retval EFI_SUCCESS             The number of logical processors and enabled

+                                  logical processors was retrieved.

+  @retval EFI_DEVICE_ERROR        The calling processor is an AP.

+  @retval EFI_INVALID_PARAMETER   NumberOfProcessors is NULL and NumberOfEnabledProcessors

+                                  is NULL.

+  @retval EFI_NOT_READY           MP Initialize Library is not initialized.

+

+**/

+EFI_STATUS

+EFIAPI

+MpInitLibGetNumberOfProcessors (

+  OUT UINTN                     *NumberOfProcessors,       OPTIONAL

+  OUT UINTN                     *NumberOfEnabledProcessors OPTIONAL

+  )

+{

+  return EFI_UNSUPPORTED;

+}