[mirror_edk2.git] / UefiCpuPkg / Library / MpInitLib / MpLib.c

/** @file\r
  CPU MP Initialize Library common functions.\r
\r
  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include "MpLib.h"\r
\r
EFI_GUID mCpuInitMpLibHobGuid = CPU_INIT_MP_LIB_HOB_GUID;\r
\r
/**\r
  The function will check if BSP Execute Disable is enabled.\r
  DxeIpl may have enabled Execute Disable for BSP,\r
  APs need to get the status and sync up the settings.\r
\r
  @retval TRUE      BSP Execute Disable is enabled.\r
  @retval FALSE     BSP Execute Disable is not enabled.\r
**/\r
BOOLEAN\r
IsBspExecuteDisableEnabled (\r
  VOID\r
  )\r
{\r
  UINT32                      Eax;\r
  CPUID_EXTENDED_CPU_SIG_EDX  Edx;\r
  MSR_IA32_EFER_REGISTER      EferMsr;\r
  BOOLEAN                     Enabled;\r
\r
  Enabled = FALSE;\r
  AsmCpuid (CPUID_EXTENDED_FUNCTION, &Eax, NULL, NULL, NULL);\r
  if (Eax >= CPUID_EXTENDED_CPU_SIG) {\r
    AsmCpuid (CPUID_EXTENDED_CPU_SIG, NULL, NULL, NULL, &Edx.Uint32);\r
    //\r
    // CPUID 0x80000001\r
    // Bit 20: Execute Disable Bit available.\r
    //\r
    if (Edx.Bits.NX != 0) {\r
      EferMsr.Uint64 = AsmReadMsr64 (MSR_IA32_EFER);\r
      //\r
      // MSR 0xC0000080\r
      // Bit 11: Execute Disable Bit enable.\r
      //\r
      if (EferMsr.Bits.NXE != 0) {\r
        Enabled = TRUE;\r
      }\r
    }\r
  }\r
\r
  return Enabled;\r
}\r
\r
/**\r
  Get the Application Processors state.\r
\r
  @param[in]  CpuData    The pointer to CPU_AP_DATA of specified AP\r
\r
  @return  The AP status\r
**/\r
CPU_STATE\r
GetApState (\r
  IN  CPU_AP_DATA     *CpuData\r
  )\r
{\r
  return CpuData->State;\r
}\r
\r
/**\r
  Set the Application Processors state.\r
\r
  @param[in]   CpuData    The pointer to CPU_AP_DATA of specified AP\r
  @param[in]   State      The AP status\r
**/\r
VOID\r
SetApState (\r
  IN  CPU_AP_DATA     *CpuData,\r
  IN  CPU_STATE       State\r
  )\r
{\r
  AcquireSpinLock (&CpuData->ApLock);\r
  CpuData->State = State;\r
  ReleaseSpinLock (&CpuData->ApLock);\r
}\r
\r
/**\r
  Save the volatile registers required to be restored following INIT IPI.\r
\r
  @param[out]  VolatileRegisters    Returns buffer saved the volatile resisters\r
**/\r
VOID\r
SaveVolatileRegisters (\r
  OUT CPU_VOLATILE_REGISTERS    *VolatileRegisters\r
  )\r
{\r
  CPUID_VERSION_INFO_EDX        VersionInfoEdx;\r
\r
  VolatileRegisters->Cr0 = AsmReadCr0 ();\r
  VolatileRegisters->Cr3 = AsmReadCr3 ();\r
  VolatileRegisters->Cr4 = AsmReadCr4 ();\r
\r
  AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &VersionInfoEdx.Uint32);\r
  if (VersionInfoEdx.Bits.DE != 0) {\r
    //\r
    // If processor supports Debugging Extensions feature\r
    // by CPUID.[EAX=01H]:EDX.BIT2\r
    //\r
    VolatileRegisters->Dr0 = AsmReadDr0 ();\r
    VolatileRegisters->Dr1 = AsmReadDr1 ();\r
    VolatileRegisters->Dr2 = AsmReadDr2 ();\r
    VolatileRegisters->Dr3 = AsmReadDr3 ();\r
    VolatileRegisters->Dr6 = AsmReadDr6 ();\r
    VolatileRegisters->Dr7 = AsmReadDr7 ();\r
  }\r
}\r
\r
/**\r
  Restore the volatile registers following INIT IPI.\r
\r
  @param[in]  VolatileRegisters   Pointer to volatile resisters\r
  @param[in]  IsRestoreDr         TRUE:  Restore DRx if supported\r
                                  FALSE: Do not restore DRx\r
**/\r
VOID\r
RestoreVolatileRegisters (\r
  IN CPU_VOLATILE_REGISTERS    *VolatileRegisters,\r
  IN BOOLEAN                   IsRestoreDr\r
  )\r
{\r
  CPUID_VERSION_INFO_EDX        VersionInfoEdx;\r
\r
  AsmWriteCr0 (VolatileRegisters->Cr0);\r
  AsmWriteCr3 (VolatileRegisters->Cr3);\r
  AsmWriteCr4 (VolatileRegisters->Cr4);\r
\r
  if (IsRestoreDr) {\r
    AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &VersionInfoEdx.Uint32);\r
    if (VersionInfoEdx.Bits.DE != 0) {\r
      //\r
      // If processor supports Debugging Extensions feature\r
      // by CPUID.[EAX=01H]:EDX.BIT2\r
      //\r
      AsmWriteDr0 (VolatileRegisters->Dr0);\r
      AsmWriteDr1 (VolatileRegisters->Dr1);\r
      AsmWriteDr2 (VolatileRegisters->Dr2);\r
      AsmWriteDr3 (VolatileRegisters->Dr3);\r
      AsmWriteDr6 (VolatileRegisters->Dr6);\r
      AsmWriteDr7 (VolatileRegisters->Dr7);\r
    }\r
  }\r
}\r
\r
/**\r
  Detect whether Mwait-monitor feature is supported.\r
\r
  @retval TRUE    Mwait-monitor feature is supported.\r
  @retval FALSE   Mwait-monitor feature is not supported.\r
**/\r
BOOLEAN\r
IsMwaitSupport (\r
  VOID\r
  )\r
{\r
  CPUID_VERSION_INFO_ECX        VersionInfoEcx;\r
\r
  AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, &VersionInfoEcx.Uint32, NULL);\r
  return (VersionInfoEcx.Bits.MONITOR == 1) ? TRUE : FALSE;\r
}\r
\r
/**\r
  Get AP loop mode.\r
\r
  @param[out] MonitorFilterSize  Returns the largest monitor-line size in bytes.\r
\r
  @return The AP loop mode.\r
**/\r
UINT8\r
GetApLoopMode (\r
  OUT UINT32     *MonitorFilterSize\r
  )\r
{\r
  UINT8                         ApLoopMode;\r
  CPUID_MONITOR_MWAIT_EBX       MonitorMwaitEbx;\r
\r
  ASSERT (MonitorFilterSize != NULL);\r
\r
  ApLoopMode = PcdGet8 (PcdCpuApLoopMode);\r
  ASSERT (ApLoopMode >= ApInHltLoop && ApLoopMode <= ApInRunLoop);\r
  if (ApLoopMode == ApInMwaitLoop) {\r
    if (!IsMwaitSupport ()) {\r
      //\r
      // If processor does not support MONITOR/MWAIT feature,\r
      // force AP in Hlt-loop mode\r
      //\r
      ApLoopMode = ApInHltLoop;\r
    }\r
  }\r
\r
  if (ApLoopMode != ApInMwaitLoop) {\r
    *MonitorFilterSize = sizeof (UINT32);\r
  } else {\r
    //\r
    // CPUID.[EAX=05H]:EBX.BIT0-15: Largest monitor-line size in bytes\r
    // CPUID.[EAX=05H].EDX: C-states supported using MWAIT\r
    //\r
    AsmCpuid (CPUID_MONITOR_MWAIT, NULL, &MonitorMwaitEbx.Uint32, NULL, NULL);\r
    *MonitorFilterSize = MonitorMwaitEbx.Bits.LargestMonitorLineSize;\r
  }\r
\r
  return ApLoopMode;\r
}\r
\r
/**\r
  Do sync on APs.\r
\r
  @param[in, out] Buffer  Pointer to private data buffer.\r
**/\r
VOID\r
EFIAPI\r
ApInitializeSync (\r
  IN OUT VOID  *Buffer\r
  )\r
{\r
  CPU_MP_DATA  *CpuMpData;\r
\r
  CpuMpData = (CPU_MP_DATA *) Buffer;\r
  //\r
  // Sync BSP's MTRR table to AP\r
  //\r
  MtrrSetAllMtrrs (&CpuMpData->MtrrTable);\r
  //\r
  // Load microcode on AP\r
  //\r
  MicrocodeDetect (CpuMpData);\r
}\r
\r
/**\r
  Find the current Processor number by APIC ID.\r
\r
  @param[in] CpuMpData         Pointer to PEI CPU MP Data\r
  @param[in] ProcessorNumber   Return the pocessor number found\r
\r
  @retval EFI_SUCCESS          ProcessorNumber is found and returned.\r
  @retval EFI_NOT_FOUND        ProcessorNumber is not found.\r
**/\r
EFI_STATUS\r
GetProcessorNumber (\r
  IN CPU_MP_DATA               *CpuMpData,\r
  OUT UINTN                    *ProcessorNumber\r
  )\r
{\r
  UINTN                   TotalProcessorNumber;\r
  UINTN                   Index;\r
\r
  TotalProcessorNumber = CpuMpData->CpuCount;\r
  for (Index = 0; Index < TotalProcessorNumber; Index ++) {\r
    if (CpuMpData->CpuData[Index].ApicId == GetApicId ()) {\r
      *ProcessorNumber = Index;\r
      return EFI_SUCCESS;\r
    }\r
  }\r
  return EFI_NOT_FOUND;\r
}\r
\r
/*\r
  Initialize CPU AP Data when AP is wakeup at the first time.\r
\r
  @param[in, out] CpuMpData        Pointer to PEI CPU MP Data\r
  @param[in]      ProcessorNumber  The handle number of processor\r
  @param[in]      BistData         Processor BIST data\r
\r
**/\r
VOID\r
InitializeApData (\r
  IN OUT CPU_MP_DATA      *CpuMpData,\r
  IN     UINTN            ProcessorNumber,\r
  IN     UINT32           BistData\r
  )\r
{\r
  CpuMpData->CpuData[ProcessorNumber].Waiting    = FALSE;\r
  CpuMpData->CpuData[ProcessorNumber].Health     = BistData;\r
  CpuMpData->CpuData[ProcessorNumber].CpuHealthy = (BistData == 0) ? TRUE : FALSE;\r
  CpuMpData->CpuData[ProcessorNumber].ApicId     = GetApicId ();\r
  CpuMpData->CpuData[ProcessorNumber].InitialApicId = GetInitialApicId ();\r
  if (CpuMpData->CpuData[ProcessorNumber].InitialApicId >= 0xFF) {\r
    //\r
    // Set x2APIC mode if there are any logical processor reporting\r
    // an Initial APIC ID of 255 or greater.\r
    //\r
    AcquireSpinLock(&CpuMpData->MpLock);\r
    CpuMpData->X2ApicEnable = TRUE;\r
    ReleaseSpinLock(&CpuMpData->MpLock);\r
  }\r
\r
  InitializeSpinLock(&CpuMpData->CpuData[ProcessorNumber].ApLock);\r
  SetApState (&CpuMpData->CpuData[ProcessorNumber], CpuStateIdle);\r
}\r
\r
/**\r
  This function will be called from AP reset code if BSP uses WakeUpAP.\r
\r
  @param[in] ExchangeInfo     Pointer to the MP exchange info buffer\r
  @param[in] NumApsExecuting  Number of current executing AP\r
**/\r
VOID\r
EFIAPI\r
ApWakeupFunction (\r
  IN MP_CPU_EXCHANGE_INFO      *ExchangeInfo,\r
  IN UINTN                     NumApsExecuting\r
  )\r
{\r
  CPU_MP_DATA                *CpuMpData;\r
  UINTN                      ProcessorNumber;\r
  EFI_AP_PROCEDURE           Procedure;\r
  VOID                       *Parameter;\r
  UINT32                     BistData;\r
  volatile UINT32            *ApStartupSignalBuffer;\r
\r
  //\r
  // AP finished assembly code and begin to execute C code\r
  //\r
  CpuMpData = ExchangeInfo->CpuMpData;\r
\r
  ProgramVirtualWireMode (); \r
\r
  while (TRUE) {\r
    if (CpuMpData->InitFlag == ApInitConfig) {\r
      //\r
      // Add CPU number\r
      //\r
      InterlockedIncrement ((UINT32 *) &CpuMpData->CpuCount);\r
      ProcessorNumber = NumApsExecuting;\r
      //\r
      // This is first time AP wakeup, get BIST information from AP stack\r
      //\r
      BistData = *(UINT32 *) (CpuMpData->Buffer + ProcessorNumber * CpuMpData->CpuApStackSize - sizeof (UINTN));\r
      //\r
      // Do some AP initialize sync\r
      //\r
      ApInitializeSync (CpuMpData);\r
      //\r
      // Sync BSP's Control registers to APs\r
      //\r
      RestoreVolatileRegisters (&CpuMpData->CpuData[0].VolatileRegisters, FALSE);\r
      InitializeApData (CpuMpData, ProcessorNumber, BistData);\r
      ApStartupSignalBuffer = CpuMpData->CpuData[ProcessorNumber].StartupApSignal;\r
    } else {\r
      //\r
      // Execute AP function if AP is ready\r
      //\r
      GetProcessorNumber (CpuMpData, &ProcessorNumber);\r
      //\r
      // Clear AP start-up signal when AP waken up\r
      //\r
      ApStartupSignalBuffer = CpuMpData->CpuData[ProcessorNumber].StartupApSignal;\r
      InterlockedCompareExchange32 (\r
        (UINT32 *) ApStartupSignalBuffer,\r
        WAKEUP_AP_SIGNAL,\r
        0\r
        );\r
      if (CpuMpData->ApLoopMode == ApInHltLoop) {\r
        //\r
        // Restore AP's volatile registers saved\r
        //\r
        RestoreVolatileRegisters (&CpuMpData->CpuData[ProcessorNumber].VolatileRegisters, TRUE);\r
      }\r
\r
      if (GetApState (&CpuMpData->CpuData[ProcessorNumber]) == CpuStateReady) {\r
        Procedure = (EFI_AP_PROCEDURE)CpuMpData->CpuData[ProcessorNumber].ApFunction;\r
        Parameter = (VOID *) CpuMpData->CpuData[ProcessorNumber].ApFunctionArgument;\r
        if (Procedure != NULL) {\r
          SetApState (&CpuMpData->CpuData[ProcessorNumber], CpuStateBusy);\r
          //\r
          // Invoke AP function here\r
          //\r
          Procedure (Parameter);\r
          //\r
          // Re-get the CPU APICID and Initial APICID\r
          //\r
          CpuMpData->CpuData[ProcessorNumber].ApicId        = GetApicId ();\r
          CpuMpData->CpuData[ProcessorNumber].InitialApicId = GetInitialApicId ();\r
        }\r
        SetApState (&CpuMpData->CpuData[ProcessorNumber], CpuStateFinished);\r
      }\r
    }\r
\r
    //\r
    // AP finished executing C code\r
    //\r
    InterlockedIncrement ((UINT32 *) &CpuMpData->FinishedCount);\r
\r
    //\r
    // Place AP is specified loop mode\r
    //\r
    if (CpuMpData->ApLoopMode == ApInHltLoop) {\r
      //\r
      // Save AP volatile registers\r
      //\r
      SaveVolatileRegisters (&CpuMpData->CpuData[ProcessorNumber].VolatileRegisters);\r
      //\r
      // Place AP in HLT-loop\r
      //\r
      while (TRUE) {\r
        DisableInterrupts ();\r
        CpuSleep ();\r
        CpuPause ();\r
      }\r
    }\r
    while (TRUE) {\r
      DisableInterrupts ();\r
      if (CpuMpData->ApLoopMode == ApInMwaitLoop) {\r
        //\r
        // Place AP in MWAIT-loop\r
        //\r
        AsmMonitor ((UINTN) ApStartupSignalBuffer, 0, 0);\r
        if (*ApStartupSignalBuffer != WAKEUP_AP_SIGNAL) {\r
          //\r
          // Check AP start-up signal again.\r
          // If AP start-up signal is not set, place AP into\r
          // the specified C-state\r
          //\r
          AsmMwait (CpuMpData->ApTargetCState << 4, 0);\r
        }\r
      } else if (CpuMpData->ApLoopMode == ApInRunLoop) {\r
        //\r
        // Place AP in Run-loop\r
        //\r
        CpuPause ();\r
      } else {\r
        ASSERT (FALSE);\r
      }\r
\r
      //\r
      // If AP start-up signal is written, AP is waken up\r
      // otherwise place AP in loop again\r
      //\r
      if (*ApStartupSignalBuffer == WAKEUP_AP_SIGNAL) {\r
        break;\r
      }\r
    }\r
  }\r
}\r
\r
/**\r
  This function will fill the exchange info structure.\r
\r
  @param[in] CpuMpData          Pointer to CPU MP Data\r
\r
**/\r
VOID\r
FillExchangeInfoData (\r
  IN CPU_MP_DATA               *CpuMpData\r
  )\r
{\r
  volatile MP_CPU_EXCHANGE_INFO    *ExchangeInfo;\r
\r
  ExchangeInfo                  = CpuMpData->MpCpuExchangeInfo;\r
  ExchangeInfo->Lock            = 0;\r
  ExchangeInfo->StackStart      = CpuMpData->Buffer;\r
  ExchangeInfo->StackSize       = CpuMpData->CpuApStackSize;\r
  ExchangeInfo->BufferStart     = CpuMpData->WakeupBuffer;\r
  ExchangeInfo->ModeOffset      = CpuMpData->AddressMap.ModeEntryOffset;\r
\r
  ExchangeInfo->CodeSegment     = AsmReadCs ();\r
  ExchangeInfo->DataSegment     = AsmReadDs ();\r
\r
  ExchangeInfo->Cr3             = AsmReadCr3 ();\r
\r
  ExchangeInfo->CFunction       = (UINTN) ApWakeupFunction;\r
  ExchangeInfo->NumApsExecuting = 0;\r
  ExchangeInfo->CpuMpData       = CpuMpData;\r
\r
  ExchangeInfo->EnableExecuteDisable = IsBspExecuteDisableEnabled ();\r
\r
  //\r
  // Get the BSP's data of GDT and IDT\r
  //\r
  AsmReadGdtr ((IA32_DESCRIPTOR *) &ExchangeInfo->GdtrProfile);\r
  AsmReadIdtr ((IA32_DESCRIPTOR *) &ExchangeInfo->IdtrProfile);\r
}\r
\r
/**\r
  MP Initialize Library initialization.\r
\r
  This service will allocate AP reset vector and wakeup all APs to do APs\r
  initialization.\r
\r
  This service must be invoked before all other MP Initialize Library\r
  service are invoked.\r
\r
  @retval  EFI_SUCCESS           MP initialization succeeds.\r
  @retval  Others                MP initialization fails.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
MpInitLibInitialize (\r
  VOID\r
  )\r
{\r
  UINT32                   MaxLogicalProcessorNumber;\r
  UINT32                   ApStackSize;\r
  MP_ASSEMBLY_ADDRESS_MAP  AddressMap;\r
  UINTN                    BufferSize;\r
  UINT32                   MonitorFilterSize;\r
  VOID                     *MpBuffer;\r
  UINTN                    Buffer;\r
  CPU_MP_DATA              *CpuMpData;\r
  UINT8                    ApLoopMode;\r
  UINT8                    *MonitorBuffer;\r
  UINTN                    Index;\r
  UINTN                    ApResetVectorSize;\r
  UINTN                    BackupBufferAddr;\r
  MaxLogicalProcessorNumber = PcdGet32(PcdCpuMaxLogicalProcessorNumber);\r
\r
  AsmGetAddressMap (&AddressMap);\r
  ApResetVectorSize = AddressMap.RendezvousFunnelSize + sizeof (MP_CPU_EXCHANGE_INFO);\r
  ApStackSize = PcdGet32(PcdCpuApStackSize);\r
  ApLoopMode  = GetApLoopMode (&MonitorFilterSize);\r
\r
  BufferSize  = ApStackSize * MaxLogicalProcessorNumber;\r
  BufferSize += MonitorFilterSize * MaxLogicalProcessorNumber;\r
  BufferSize += sizeof (CPU_MP_DATA);\r
  BufferSize += ApResetVectorSize;\r
  BufferSize += (sizeof (CPU_AP_DATA) + sizeof (CPU_INFO_IN_HOB))* MaxLogicalProcessorNumber;\r
  MpBuffer    = AllocatePages (EFI_SIZE_TO_PAGES (BufferSize));\r
  ASSERT (MpBuffer != NULL);\r
  ZeroMem (MpBuffer, BufferSize);\r
  Buffer = (UINTN) MpBuffer;\r
\r
  MonitorBuffer    = (UINT8 *) (Buffer + ApStackSize * MaxLogicalProcessorNumber);\r
  BackupBufferAddr = (UINTN) MonitorBuffer + MonitorFilterSize * MaxLogicalProcessorNumber;\r
  CpuMpData = (CPU_MP_DATA *) (BackupBufferAddr + ApResetVectorSize);\r
  CpuMpData->Buffer           = Buffer;\r
  CpuMpData->CpuApStackSize   = ApStackSize;\r
  CpuMpData->BackupBuffer     = BackupBufferAddr;\r
  CpuMpData->BackupBufferSize = ApResetVectorSize;\r
  CpuMpData->EndOfPeiFlag     = FALSE;\r
  CpuMpData->WakeupBuffer     = (UINTN) -1;\r
  CpuMpData->CpuCount         = 1;\r
  CpuMpData->BspNumber        = 0;\r
  CpuMpData->WaitEvent        = NULL;\r
  CpuMpData->CpuData          = (CPU_AP_DATA *) (CpuMpData + 1);\r
  CpuMpData->CpuInfoInHob     = (UINT64) (UINTN) (CpuMpData->CpuData + MaxLogicalProcessorNumber);\r
  InitializeSpinLock(&CpuMpData->MpLock);\r
  //\r
  // Save BSP's Control registers to APs\r
  //\r
  SaveVolatileRegisters (&CpuMpData->CpuData[0].VolatileRegisters);\r
  //\r
  // Set BSP basic information\r
  //\r
  InitializeApData (CpuMpData, 0, 0);\r
  //\r
  // Save assembly code information\r
  //\r
  CopyMem (&CpuMpData->AddressMap, &AddressMap, sizeof (MP_ASSEMBLY_ADDRESS_MAP));\r
  //\r
  // Finally set AP loop mode\r
  //\r
  CpuMpData->ApLoopMode = ApLoopMode;\r
  DEBUG ((DEBUG_INFO, "AP Loop Mode is %d\n", CpuMpData->ApLoopMode));\r
  //\r
  // Set up APs wakeup signal buffer\r
  //\r
  for (Index = 0; Index < MaxLogicalProcessorNumber; Index++) {\r
    CpuMpData->CpuData[Index].StartupApSignal =\r
      (UINT32 *)(MonitorBuffer + MonitorFilterSize * Index);\r
  }\r
  //\r
  // Load Microcode on BSP\r
  //\r
  MicrocodeDetect (CpuMpData);\r
  //\r
  // Store BSP's MTRR setting\r
  //\r
  MtrrGetAllMtrrs (&CpuMpData->MtrrTable);\r
\r
\r
  //\r
  // Initialize global data for MP support\r
  //\r
  InitMpGlobalData (CpuMpData);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Gets detailed MP-related information on the requested processor at the\r
  instant this call is made. This service may only be called from the BSP.\r
\r
  @param[in]  ProcessorNumber       The handle number of processor.\r
  @param[out] ProcessorInfoBuffer   A pointer to the buffer where information for\r
                                    the requested processor is deposited.\r
  @param[out]  HealthData            Return processor health data.\r
\r
  @retval EFI_SUCCESS             Processor information was returned.\r
  @retval EFI_DEVICE_ERROR        The calling processor is an AP.\r
  @retval EFI_INVALID_PARAMETER   ProcessorInfoBuffer is NULL.\r
  @retval EFI_NOT_FOUND           The processor with the handle specified by\r
                                  ProcessorNumber does not exist in the platform.\r
  @retval EFI_NOT_READY           MP Initialize Library is not initialized.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
MpInitLibGetProcessorInfo (\r
  IN  UINTN                      ProcessorNumber,\r
  OUT EFI_PROCESSOR_INFORMATION  *ProcessorInfoBuffer,\r
  OUT EFI_HEALTH_FLAGS           *HealthData  OPTIONAL\r
  )\r
{\r
  return EFI_UNSUPPORTED;\r
}\r
/**\r
  This return the handle number for the calling processor.  This service may be\r
  called from the BSP and APs.\r
\r
  @param[out] ProcessorNumber  Pointer to the handle number of AP.\r
                               The range is from 0 to the total number of\r
                               logical processors minus 1. The total number of\r
                               logical processors can be retrieved by\r
                               MpInitLibGetNumberOfProcessors().\r
\r
  @retval EFI_SUCCESS             The current processor handle number was returned\r
                                  in ProcessorNumber.\r
  @retval EFI_INVALID_PARAMETER   ProcessorNumber is NULL.\r
  @retval EFI_NOT_READY           MP Initialize Library is not initialized.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
MpInitLibWhoAmI (\r
  OUT UINTN                    *ProcessorNumber\r
  )\r
{\r
  return EFI_UNSUPPORTED;\r
}\r
/**\r
  Retrieves the number of logical processor in the platform and the number of\r
  those logical processors that are enabled on this boot. This service may only\r
  be called from the BSP.\r
\r
  @param[out] NumberOfProcessors          Pointer to the total number of logical\r
                                          processors in the system, including the BSP\r
                                          and disabled APs.\r
  @param[out] NumberOfEnabledProcessors   Pointer to the number of enabled logical\r
                                          processors that exist in system, including\r
                                          the BSP.\r
\r
  @retval EFI_SUCCESS             The number of logical processors and enabled\r
                                  logical processors was retrieved.\r
  @retval EFI_DEVICE_ERROR        The calling processor is an AP.\r
  @retval EFI_INVALID_PARAMETER   NumberOfProcessors is NULL and NumberOfEnabledProcessors\r
                                  is NULL.\r
  @retval EFI_NOT_READY           MP Initialize Library is not initialized.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
MpInitLibGetNumberOfProcessors (\r
  OUT UINTN                     *NumberOfProcessors,       OPTIONAL\r
  OUT UINTN                     *NumberOfEnabledProcessors OPTIONAL\r
  )\r
{\r
  return EFI_UNSUPPORTED;\r
}\r
/**\r
  Get pointer to CPU MP Data structure from GUIDed HOB.\r
\r
  @return  The pointer to CPU MP Data structure.\r
**/\r
CPU_MP_DATA *\r
GetCpuMpDataFromGuidedHob (\r
  VOID\r
  )\r
{\r
  EFI_HOB_GUID_TYPE       *GuidHob;\r
  VOID                    *DataInHob;\r
  CPU_MP_DATA             *CpuMpData;\r
\r
  CpuMpData = NULL;\r
  GuidHob = GetFirstGuidHob (&mCpuInitMpLibHobGuid);\r
  if (GuidHob != NULL) {\r
    DataInHob = GET_GUID_HOB_DATA (GuidHob);\r
    CpuMpData = (CPU_MP_DATA *) (*(UINTN *) DataInHob);\r
  }\r
  return CpuMpData;\r
}\r