4 Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 #include <Protocol/MpService.h>
19 #include <Library/SynchronizationLib.h>
22 Initialize Multi-processor support.
32 (EFIAPI
*STACKLESS_AP_ENTRY_POINT
)(
37 Starts the Application Processors and directs them to jump to the
40 The processor jumps to this code in flat mode, but the processor's
41 stack is not initialized.
43 @param ApEntryPoint Pointer to the Entry Point routine
45 @retval EFI_SUCCESS The APs were started
46 @retval EFI_OUT_OF_RESOURCES Cannot allocate memory to start APs
51 IN STACKLESS_AP_ENTRY_POINT ApEntryPoint
55 The AP entry point that the Startup-IPI target code will jump to.
57 The processor jumps to this code in flat mode, but the processor's
58 stack is not initialized.
68 Releases the lock preventing other APs from using the shared AP
71 Once the AP has transitioned to using a new stack, it can call this
72 function to allow another AP to proceed with using the shared stack.
77 AsmApDoneWithCommonStack (
90 Define Individual Processor Data block.
94 EFI_PROCESSOR_INFORMATION Info
;
95 SPIN_LOCK CpuDataLock
;
96 volatile CPU_STATE State
;
98 EFI_AP_PROCEDURE Procedure
;
103 Define MP data block which consumes individual processor block.
107 CPU_DATA_BLOCK
*CpuDatas
;
108 UINTN NumberOfProcessors
;
109 UINTN NumberOfEnabledProcessors
;
113 This function is called by all processors (both BSP and AP) once and collects MP related data.
115 @param Bsp TRUE if the CPU is BSP
116 @param ProcessorNumber The specific processor number
118 @retval EFI_SUCCESS Data for the processor collected and filled in
122 FillInProcessorInformation (
124 IN UINTN ProcessorNumber
128 This return the handle number for the calling processor. This service may be
129 called from the BSP and APs.
131 This service returns the processor handle number for the calling processor.
132 The returned value is in the range from 0 to the total number of logical
133 processors minus 1. The total number of logical processors can be retrieved
134 with EFI_MP_SERVICES_PROTOCOL.GetNumberOfProcessors(). This service may be
135 called from the BSP and APs. If ProcessorNumber is NULL, then EFI_INVALID_PARAMETER
136 is returned. Otherwise, the current processors handle number is returned in
137 ProcessorNumber, and EFI_SUCCESS is returned.
139 @param[in] This A pointer to the EFI_MP_SERVICES_PROTOCOL instance.
140 @param[out] ProcessorNumber The handle number of AP that is to become the new
141 BSP. The range is from 0 to the total number of
142 logical processors minus 1. The total number of
143 logical processors can be retrieved by
144 EFI_MP_SERVICES_PROTOCOL.GetNumberOfProcessors().
146 @retval EFI_SUCCESS The current processor handle number was returned
148 @retval EFI_INVALID_PARAMETER ProcessorNumber is NULL.
154 IN EFI_MP_SERVICES_PROTOCOL
*This
,
155 OUT UINTN
*ProcessorNumber