UefiCpuPkg/CpuDxe: implement Mp Services:StartupAllAPs()
Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Chen Fan <chen.fan.fnst@cn.fujitsu.com> Reviewed-by: Jeff Fan <jeff.fan@intel.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@16359 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
Chen Fan
jljusten
parent
3f4f0af872
commit
5fee172fb7
|
|
@ -28,7 +28,7 @@ VOID *mApStackStart = 0;
|
||||||
EFI_MP_SERVICES_PROTOCOL mMpServicesTemplate = {
|
EFI_MP_SERVICES_PROTOCOL mMpServicesTemplate = {
|
||||||
GetNumberOfProcessors,
|
GetNumberOfProcessors,
|
||||||
GetProcessorInfo,
|
GetProcessorInfo,
|
||||||
NULL, // StartupAllAPs,
|
StartupAllAPs,
|
||||||
StartupThisAP,
|
StartupThisAP,
|
||||||
NULL, // SwitchBSP,
|
NULL, // SwitchBSP,
|
||||||
EnableDisableAP,
|
EnableDisableAP,
|
||||||
|
|
@ -238,6 +238,106 @@ GetNextBlockedNumber (
|
||||||
return EFI_NOT_FOUND;
|
return EFI_NOT_FOUND;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Check if the APs state are finished, and update them to idle state
|
||||||
|
by StartupAllAPs().
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
CheckAndUpdateAllAPsToIdleState (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
UINTN ProcessorNumber;
|
||||||
|
UINTN NextNumber;
|
||||||
|
CPU_DATA_BLOCK *CpuData;
|
||||||
|
EFI_STATUS Status;
|
||||||
|
CPU_STATE CpuState;
|
||||||
|
|
||||||
|
for (ProcessorNumber = 0; ProcessorNumber < mMpSystemData.NumberOfProcessors; ProcessorNumber++) {
|
||||||
|
CpuData = &mMpSystemData.CpuDatas[ProcessorNumber];
|
||||||
|
if (TestCpuStatusFlag (CpuData, PROCESSOR_AS_BSP_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip BSP
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!TestCpuStatusFlag (CpuData, PROCESSOR_ENABLED_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip Disabled processors
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
CpuState = GetApState (CpuData);
|
||||||
|
if (CpuState == CpuStateFinished) {
|
||||||
|
mMpSystemData.FinishCount++;
|
||||||
|
if (mMpSystemData.SingleThread) {
|
||||||
|
Status = GetNextBlockedNumber (&NextNumber);
|
||||||
|
if (!EFI_ERROR (Status)) {
|
||||||
|
SetApState (&mMpSystemData.CpuDatas[NextNumber], CpuStateReady);
|
||||||
|
SetApProcedure (&mMpSystemData.CpuDatas[NextNumber],
|
||||||
|
mMpSystemData.Procedure,
|
||||||
|
mMpSystemData.ProcedureArgument);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
SetApState (CpuData, CpuStateIdle);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
If the timeout expires before all APs returns from Procedure,
|
||||||
|
we should forcibly terminate the executing AP and fill FailedList back
|
||||||
|
by StartupAllAPs().
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
ResetAllFailedAPs (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
CPU_DATA_BLOCK *CpuData;
|
||||||
|
UINTN Number;
|
||||||
|
CPU_STATE CpuState;
|
||||||
|
|
||||||
|
if (mMpSystemData.FailedList != NULL) {
|
||||||
|
*mMpSystemData.FailedList = AllocatePool ((mMpSystemData.StartCount - mMpSystemData.FinishCount + 1) * sizeof(UINTN));
|
||||||
|
ASSERT (*mMpSystemData.FailedList != NULL);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (Number = 0; Number < mMpSystemData.NumberOfProcessors; Number++) {
|
||||||
|
CpuData = &mMpSystemData.CpuDatas[Number];
|
||||||
|
if (TestCpuStatusFlag (CpuData, PROCESSOR_AS_BSP_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip BSP
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!TestCpuStatusFlag (CpuData, PROCESSOR_ENABLED_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip Disabled processors
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
CpuState = GetApState (CpuData);
|
||||||
|
if (CpuState != CpuStateIdle) {
|
||||||
|
if (mMpSystemData.FailedList != NULL) {
|
||||||
|
(*mMpSystemData.FailedList)[mMpSystemData.FailedListIndex++] = Number;
|
||||||
|
}
|
||||||
|
ResetProcessorToIdleState (CpuData);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (mMpSystemData.FailedList != NULL) {
|
||||||
|
(*mMpSystemData.FailedList)[mMpSystemData.FailedListIndex] = END_OF_CPU_LIST;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This service retrieves the number of logical processor in the platform
|
This service retrieves the number of logical processor in the platform
|
||||||
and the number of those logical processors that are enabled on this boot.
|
and the number of those logical processors that are enabled on this boot.
|
||||||
|
|
@ -345,6 +445,281 @@ GetProcessorInfo (
|
||||||
return EFI_SUCCESS;
|
return EFI_SUCCESS;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
This service executes a caller provided function on all enabled APs. APs can
|
||||||
|
run either simultaneously or one at a time in sequence. This service supports
|
||||||
|
both blocking and non-blocking requests. The non-blocking requests use EFI
|
||||||
|
events so the BSP can detect when the APs have finished. This service may only
|
||||||
|
be called from the BSP.
|
||||||
|
|
||||||
|
This function is used to dispatch all the enabled APs to the function specified
|
||||||
|
by Procedure. If any enabled AP is busy, then EFI_NOT_READY is returned
|
||||||
|
immediately and Procedure is not started on any AP.
|
||||||
|
|
||||||
|
If SingleThread is TRUE, all the enabled APs execute the function specified by
|
||||||
|
Procedure one by one, in ascending order of processor handle number. Otherwise,
|
||||||
|
all the enabled APs execute the function specified by Procedure simultaneously.
|
||||||
|
|
||||||
|
If WaitEvent is NULL, execution is in blocking mode. The BSP waits until all
|
||||||
|
APs finish or TimeoutInMicroseconds expires. Otherwise, execution is in non-blocking
|
||||||
|
mode, and the BSP returns from this service without waiting for APs. If a
|
||||||
|
non-blocking mode is requested after the UEFI Event EFI_EVENT_GROUP_READY_TO_BOOT
|
||||||
|
is signaled, then EFI_UNSUPPORTED must be returned.
|
||||||
|
|
||||||
|
If the timeout specified by TimeoutInMicroseconds expires before all APs return
|
||||||
|
from Procedure, then Procedure on the failed APs is terminated. All enabled APs
|
||||||
|
are always available for further calls to EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
and EFI_MP_SERVICES_PROTOCOL.StartupThisAP(). If FailedCpuList is not NULL, its
|
||||||
|
content points to the list of processor handle numbers in which Procedure was
|
||||||
|
terminated.
|
||||||
|
|
||||||
|
Note: It is the responsibility of the consumer of the EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
to make sure that the nature of the code that is executed on the BSP and the
|
||||||
|
dispatched APs is well controlled. The MP Services Protocol does not guarantee
|
||||||
|
that the Procedure function is MP-safe. Hence, the tasks that can be run in
|
||||||
|
parallel are limited to certain independent tasks and well-controlled exclusive
|
||||||
|
code. EFI services and protocols may not be called by APs unless otherwise
|
||||||
|
specified.
|
||||||
|
|
||||||
|
In blocking execution mode, BSP waits until all APs finish or
|
||||||
|
TimeoutInMicroseconds expires.
|
||||||
|
|
||||||
|
In non-blocking execution mode, BSP is freed to return to the caller and then
|
||||||
|
proceed to the next task without having to wait for APs. The following
|
||||||
|
sequence needs to occur in a non-blocking execution mode:
|
||||||
|
|
||||||
|
-# The caller that intends to use this MP Services Protocol in non-blocking
|
||||||
|
mode creates WaitEvent by calling the EFI CreateEvent() service. The caller
|
||||||
|
invokes EFI_MP_SERVICES_PROTOCOL.StartupAllAPs(). If the parameter WaitEvent
|
||||||
|
is not NULL, then StartupAllAPs() executes in non-blocking mode. It requests
|
||||||
|
the function specified by Procedure to be started on all the enabled APs,
|
||||||
|
and releases the BSP to continue with other tasks.
|
||||||
|
-# The caller can use the CheckEvent() and WaitForEvent() services to check
|
||||||
|
the state of the WaitEvent created in step 1.
|
||||||
|
-# When the APs complete their task or TimeoutInMicroSecondss expires, the MP
|
||||||
|
Service signals WaitEvent by calling the EFI SignalEvent() function. If
|
||||||
|
FailedCpuList is not NULL, its content is available when WaitEvent is
|
||||||
|
signaled. If all APs returned from Procedure prior to the timeout, then
|
||||||
|
FailedCpuList is set to NULL. If not all APs return from Procedure before
|
||||||
|
the timeout, then FailedCpuList is filled in with the list of the failed
|
||||||
|
APs. The buffer is allocated by MP Service Protocol using AllocatePool().
|
||||||
|
It is the caller's responsibility to free the buffer with FreePool() service.
|
||||||
|
-# This invocation of SignalEvent() function informs the caller that invoked
|
||||||
|
EFI_MP_SERVICES_PROTOCOL.StartupAllAPs() that either all the APs completed
|
||||||
|
the specified task or a timeout occurred. The contents of FailedCpuList
|
||||||
|
can be examined to determine which APs did not complete the specified task
|
||||||
|
prior to the timeout.
|
||||||
|
|
||||||
|
@param[in] This A pointer to the EFI_MP_SERVICES_PROTOCOL
|
||||||
|
instance.
|
||||||
|
@param[in] Procedure A pointer to the function to be run on
|
||||||
|
enabled APs of the system. See type
|
||||||
|
EFI_AP_PROCEDURE.
|
||||||
|
@param[in] SingleThread If TRUE, then all the enabled APs execute
|
||||||
|
the function specified by Procedure one by
|
||||||
|
one, in ascending order of processor handle
|
||||||
|
number. If FALSE, then all the enabled APs
|
||||||
|
execute the function specified by Procedure
|
||||||
|
simultaneously.
|
||||||
|
@param[in] WaitEvent The event created by the caller with CreateEvent()
|
||||||
|
service. If it is NULL, then execute in
|
||||||
|
blocking mode. BSP waits until all APs finish
|
||||||
|
or TimeoutInMicroseconds expires. If it's
|
||||||
|
not NULL, then execute in non-blocking mode.
|
||||||
|
BSP requests the function specified by
|
||||||
|
Procedure to be started on all the enabled
|
||||||
|
APs, and go on executing immediately. If
|
||||||
|
all return from Procedure, or TimeoutInMicroseconds
|
||||||
|
expires, this event is signaled. The BSP
|
||||||
|
can use the CheckEvent() or WaitForEvent()
|
||||||
|
services to check the state of event. Type
|
||||||
|
EFI_EVENT is defined in CreateEvent() in
|
||||||
|
the Unified Extensible Firmware Interface
|
||||||
|
Specification.
|
||||||
|
@param[in] TimeoutInMicroseconds Indicates the time limit in microseconds for
|
||||||
|
APs to return from Procedure, either for
|
||||||
|
blocking or non-blocking mode. Zero means
|
||||||
|
infinity. If the timeout expires before
|
||||||
|
all APs return from Procedure, then Procedure
|
||||||
|
on the failed APs is terminated. All enabled
|
||||||
|
APs are available for next function assigned
|
||||||
|
by EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
or EFI_MP_SERVICES_PROTOCOL.StartupThisAP().
|
||||||
|
If the timeout expires in blocking mode,
|
||||||
|
BSP returns EFI_TIMEOUT. If the timeout
|
||||||
|
expires in non-blocking mode, WaitEvent
|
||||||
|
is signaled with SignalEvent().
|
||||||
|
@param[in] ProcedureArgument The parameter passed into Procedure for
|
||||||
|
all APs.
|
||||||
|
@param[out] FailedCpuList If NULL, this parameter is ignored. Otherwise,
|
||||||
|
if all APs finish successfully, then its
|
||||||
|
content is set to NULL. If not all APs
|
||||||
|
finish before timeout expires, then its
|
||||||
|
content is set to address of the buffer
|
||||||
|
holding handle numbers of the failed APs.
|
||||||
|
The buffer is allocated by MP Service Protocol,
|
||||||
|
and it's the caller's responsibility to
|
||||||
|
free the buffer with FreePool() service.
|
||||||
|
In blocking mode, it is ready for consumption
|
||||||
|
when the call returns. In non-blocking mode,
|
||||||
|
it is ready when WaitEvent is signaled. The
|
||||||
|
list of failed CPU is terminated by
|
||||||
|
END_OF_CPU_LIST.
|
||||||
|
|
||||||
|
@retval EFI_SUCCESS In blocking mode, all APs have finished before
|
||||||
|
the timeout expired.
|
||||||
|
@retval EFI_SUCCESS In non-blocking mode, function has been dispatched
|
||||||
|
to all enabled APs.
|
||||||
|
@retval EFI_UNSUPPORTED A non-blocking mode request was made after the
|
||||||
|
UEFI event EFI_EVENT_GROUP_READY_TO_BOOT was
|
||||||
|
signaled.
|
||||||
|
@retval EFI_DEVICE_ERROR Caller processor is AP.
|
||||||
|
@retval EFI_NOT_STARTED No enabled APs exist in the system.
|
||||||
|
@retval EFI_NOT_READY Any enabled APs are busy.
|
||||||
|
@retval EFI_TIMEOUT In blocking mode, the timeout expired before
|
||||||
|
all enabled APs have finished.
|
||||||
|
@retval EFI_INVALID_PARAMETER Procedure is NULL.
|
||||||
|
|
||||||
|
**/
|
||||||
|
EFI_STATUS
|
||||||
|
EFIAPI
|
||||||
|
StartupAllAPs (
|
||||||
|
IN EFI_MP_SERVICES_PROTOCOL *This,
|
||||||
|
IN EFI_AP_PROCEDURE Procedure,
|
||||||
|
IN BOOLEAN SingleThread,
|
||||||
|
IN EFI_EVENT WaitEvent OPTIONAL,
|
||||||
|
IN UINTN TimeoutInMicroseconds,
|
||||||
|
IN VOID *ProcedureArgument OPTIONAL,
|
||||||
|
OUT UINTN **FailedCpuList OPTIONAL
|
||||||
|
)
|
||||||
|
{
|
||||||
|
EFI_STATUS Status;
|
||||||
|
CPU_DATA_BLOCK *CpuData;
|
||||||
|
UINTN Number;
|
||||||
|
CPU_STATE APInitialState;
|
||||||
|
|
||||||
|
CpuData = NULL;
|
||||||
|
|
||||||
|
if (FailedCpuList != NULL) {
|
||||||
|
*FailedCpuList = NULL;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!IsBSP ()) {
|
||||||
|
return EFI_DEVICE_ERROR;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (mMpSystemData.NumberOfProcessors == 1) {
|
||||||
|
return EFI_NOT_STARTED;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Procedure == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (Number = 0; Number < mMpSystemData.NumberOfProcessors; Number++) {
|
||||||
|
CpuData = &mMpSystemData.CpuDatas[Number];
|
||||||
|
if (TestCpuStatusFlag (CpuData, PROCESSOR_AS_BSP_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip BSP
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!TestCpuStatusFlag (CpuData, PROCESSOR_ENABLED_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip Disabled processors
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (GetApState (CpuData) != CpuStateIdle) {
|
||||||
|
return EFI_NOT_READY;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
mMpSystemData.Procedure = Procedure;
|
||||||
|
mMpSystemData.ProcedureArgument = ProcedureArgument;
|
||||||
|
mMpSystemData.WaitEvent = WaitEvent;
|
||||||
|
mMpSystemData.Timeout = TimeoutInMicroseconds;
|
||||||
|
mMpSystemData.TimeoutActive = !!(TimeoutInMicroseconds);
|
||||||
|
mMpSystemData.FinishCount = 0;
|
||||||
|
mMpSystemData.StartCount = 0;
|
||||||
|
mMpSystemData.SingleThread = SingleThread;
|
||||||
|
mMpSystemData.FailedList = FailedCpuList;
|
||||||
|
mMpSystemData.FailedListIndex = 0;
|
||||||
|
APInitialState = CpuStateReady;
|
||||||
|
|
||||||
|
for (Number = 0; Number < mMpSystemData.NumberOfProcessors; Number++) {
|
||||||
|
CpuData = &mMpSystemData.CpuDatas[Number];
|
||||||
|
if (TestCpuStatusFlag (CpuData, PROCESSOR_AS_BSP_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip BSP
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!TestCpuStatusFlag (CpuData, PROCESSOR_ENABLED_BIT)) {
|
||||||
|
//
|
||||||
|
// Skip Disabled processors
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
//
|
||||||
|
// Get APs prepared, and put failing APs into FailedCpuList
|
||||||
|
// if "SingleThread", only 1 AP will put to ready state, other AP will be put to ready
|
||||||
|
// state 1 by 1, until the previous 1 finished its task
|
||||||
|
// if not "SingleThread", all APs are put to ready state from the beginning
|
||||||
|
//
|
||||||
|
if (GetApState (CpuData) == CpuStateIdle) {
|
||||||
|
mMpSystemData.StartCount++;
|
||||||
|
|
||||||
|
SetApState (CpuData, APInitialState);
|
||||||
|
|
||||||
|
if (APInitialState == CpuStateReady) {
|
||||||
|
SetApProcedure (CpuData, Procedure, ProcedureArgument);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (SingleThread) {
|
||||||
|
APInitialState = CpuStateBlocked;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (WaitEvent != NULL) {
|
||||||
|
Status = gBS->SetTimer (
|
||||||
|
mMpSystemData.CheckAllAPsEvent,
|
||||||
|
TimerPeriodic,
|
||||||
|
EFI_TIMER_PERIOD_MICROSECONDS (100)
|
||||||
|
);
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
|
while (TRUE) {
|
||||||
|
CheckAndUpdateAllAPsToIdleState ();
|
||||||
|
if (mMpSystemData.FinishCount == mMpSystemData.StartCount) {
|
||||||
|
Status = EFI_SUCCESS;
|
||||||
|
goto Done;
|
||||||
|
}
|
||||||
|
|
||||||
|
//
|
||||||
|
// task timeout
|
||||||
|
//
|
||||||
|
if (mMpSystemData.TimeoutActive && mMpSystemData.Timeout < 0) {
|
||||||
|
ResetAllFailedAPs();
|
||||||
|
Status = EFI_TIMEOUT;
|
||||||
|
goto Done;
|
||||||
|
}
|
||||||
|
|
||||||
|
gBS->Stall (gPollInterval);
|
||||||
|
mMpSystemData.Timeout -= gPollInterval;
|
||||||
|
}
|
||||||
|
|
||||||
|
Done:
|
||||||
|
|
||||||
|
return Status;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This service lets the caller get one enabled AP to execute a caller-provided
|
This service lets the caller get one enabled AP to execute a caller-provided
|
||||||
function. The caller can request the BSP to either wait for the completion
|
function. The caller can request the BSP to either wait for the completion
|
||||||
|
|
@ -746,6 +1121,56 @@ out:
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Checks APs' status periodically.
|
||||||
|
|
||||||
|
This function is triggerred by timer perodically to check the
|
||||||
|
state of APs for StartupAllAPs() executed in non-blocking mode.
|
||||||
|
|
||||||
|
@param Event Event triggered.
|
||||||
|
@param Context Parameter passed with the event.
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
CheckAllAPsStatus (
|
||||||
|
IN EFI_EVENT Event,
|
||||||
|
IN VOID *Context
|
||||||
|
)
|
||||||
|
{
|
||||||
|
if (mMpSystemData.TimeoutActive) {
|
||||||
|
mMpSystemData.Timeout -= gPollInterval;
|
||||||
|
}
|
||||||
|
|
||||||
|
CheckAndUpdateAllAPsToIdleState ();
|
||||||
|
|
||||||
|
//
|
||||||
|
// task timeout
|
||||||
|
//
|
||||||
|
if (mMpSystemData.TimeoutActive && mMpSystemData.Timeout < 0) {
|
||||||
|
ResetAllFailedAPs();
|
||||||
|
//
|
||||||
|
// force exit
|
||||||
|
//
|
||||||
|
mMpSystemData.FinishCount = mMpSystemData.StartCount;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (mMpSystemData.FinishCount != mMpSystemData.StartCount) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
gBS->SetTimer (
|
||||||
|
mMpSystemData.CheckAllAPsEvent,
|
||||||
|
TimerCancel,
|
||||||
|
0
|
||||||
|
);
|
||||||
|
|
||||||
|
if (mMpSystemData.WaitEvent) {
|
||||||
|
gBS->SignalEvent (mMpSystemData.WaitEvent);
|
||||||
|
mMpSystemData.WaitEvent = NULL;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Application Processor C code entry point.
|
Application Processor C code entry point.
|
||||||
|
|
||||||
|
|
@ -831,6 +1256,15 @@ InitMpSystemData (
|
||||||
mMpSystemData.CpuDatas = AllocateZeroPool (sizeof (CPU_DATA_BLOCK) * gMaxLogicalProcessorNumber);
|
mMpSystemData.CpuDatas = AllocateZeroPool (sizeof (CPU_DATA_BLOCK) * gMaxLogicalProcessorNumber);
|
||||||
ASSERT(mMpSystemData.CpuDatas != NULL);
|
ASSERT(mMpSystemData.CpuDatas != NULL);
|
||||||
|
|
||||||
|
Status = gBS->CreateEvent (
|
||||||
|
EVT_TIMER | EVT_NOTIFY_SIGNAL,
|
||||||
|
TPL_CALLBACK,
|
||||||
|
CheckAllAPsStatus,
|
||||||
|
NULL,
|
||||||
|
&mMpSystemData.CheckAllAPsEvent
|
||||||
|
);
|
||||||
|
ASSERT_EFI_ERROR (Status);
|
||||||
|
|
||||||
for (ProcessorNumber = 0; ProcessorNumber < gMaxLogicalProcessorNumber; ProcessorNumber++) {
|
for (ProcessorNumber = 0; ProcessorNumber < gMaxLogicalProcessorNumber; ProcessorNumber++) {
|
||||||
CpuData = &mMpSystemData.CpuDatas[ProcessorNumber];
|
CpuData = &mMpSystemData.CpuDatas[ProcessorNumber];
|
||||||
Status = gBS->CreateEvent (
|
Status = gBS->CreateEvent (
|
||||||
|
|
|
||||||
|
|
@ -112,6 +112,18 @@ typedef struct {
|
||||||
CPU_DATA_BLOCK *CpuDatas;
|
CPU_DATA_BLOCK *CpuDatas;
|
||||||
UINTN NumberOfProcessors;
|
UINTN NumberOfProcessors;
|
||||||
UINTN NumberOfEnabledProcessors;
|
UINTN NumberOfEnabledProcessors;
|
||||||
|
|
||||||
|
EFI_AP_PROCEDURE Procedure;
|
||||||
|
VOID *ProcedureArgument;
|
||||||
|
UINTN StartCount;
|
||||||
|
UINTN FinishCount;
|
||||||
|
BOOLEAN SingleThread;
|
||||||
|
UINTN **FailedList;
|
||||||
|
UINTN FailedListIndex;
|
||||||
|
INTN Timeout;
|
||||||
|
EFI_EVENT WaitEvent;
|
||||||
|
BOOLEAN TimeoutActive;
|
||||||
|
EFI_EVENT CheckAllAPsEvent;
|
||||||
} MP_SYSTEM_DATA;
|
} MP_SYSTEM_DATA;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
@ -207,6 +219,154 @@ GetProcessorInfo (
|
||||||
OUT EFI_PROCESSOR_INFORMATION *ProcessorInfoBuffer
|
OUT EFI_PROCESSOR_INFORMATION *ProcessorInfoBuffer
|
||||||
);
|
);
|
||||||
|
|
||||||
|
/**
|
||||||
|
This service executes a caller provided function on all enabled APs. APs can
|
||||||
|
run either simultaneously or one at a time in sequence. This service supports
|
||||||
|
both blocking and non-blocking requests. The non-blocking requests use EFI
|
||||||
|
events so the BSP can detect when the APs have finished. This service may only
|
||||||
|
be called from the BSP.
|
||||||
|
|
||||||
|
This function is used to dispatch all the enabled APs to the function specified
|
||||||
|
by Procedure. If any enabled AP is busy, then EFI_NOT_READY is returned
|
||||||
|
immediately and Procedure is not started on any AP.
|
||||||
|
|
||||||
|
If SingleThread is TRUE, all the enabled APs execute the function specified by
|
||||||
|
Procedure one by one, in ascending order of processor handle number. Otherwise,
|
||||||
|
all the enabled APs execute the function specified by Procedure simultaneously.
|
||||||
|
|
||||||
|
If WaitEvent is NULL, execution is in blocking mode. The BSP waits until all
|
||||||
|
APs finish or TimeoutInMicroseconds expires. Otherwise, execution is in non-blocking
|
||||||
|
mode, and the BSP returns from this service without waiting for APs. If a
|
||||||
|
non-blocking mode is requested after the UEFI Event EFI_EVENT_GROUP_READY_TO_BOOT
|
||||||
|
is signaled, then EFI_UNSUPPORTED must be returned.
|
||||||
|
|
||||||
|
If the timeout specified by TimeoutInMicroseconds expires before all APs return
|
||||||
|
from Procedure, then Procedure on the failed APs is terminated. All enabled APs
|
||||||
|
are always available for further calls to EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
and EFI_MP_SERVICES_PROTOCOL.StartupThisAP(). If FailedCpuList is not NULL, its
|
||||||
|
content points to the list of processor handle numbers in which Procedure was
|
||||||
|
terminated.
|
||||||
|
|
||||||
|
Note: It is the responsibility of the consumer of the EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
to make sure that the nature of the code that is executed on the BSP and the
|
||||||
|
dispatched APs is well controlled. The MP Services Protocol does not guarantee
|
||||||
|
that the Procedure function is MP-safe. Hence, the tasks that can be run in
|
||||||
|
parallel are limited to certain independent tasks and well-controlled exclusive
|
||||||
|
code. EFI services and protocols may not be called by APs unless otherwise
|
||||||
|
specified.
|
||||||
|
|
||||||
|
In blocking execution mode, BSP waits until all APs finish or
|
||||||
|
TimeoutInMicroseconds expires.
|
||||||
|
|
||||||
|
In non-blocking execution mode, BSP is freed to return to the caller and then
|
||||||
|
proceed to the next task without having to wait for APs. The following
|
||||||
|
sequence needs to occur in a non-blocking execution mode:
|
||||||
|
|
||||||
|
-# The caller that intends to use this MP Services Protocol in non-blocking
|
||||||
|
mode creates WaitEvent by calling the EFI CreateEvent() service. The caller
|
||||||
|
invokes EFI_MP_SERVICES_PROTOCOL.StartupAllAPs(). If the parameter WaitEvent
|
||||||
|
is not NULL, then StartupAllAPs() executes in non-blocking mode. It requests
|
||||||
|
the function specified by Procedure to be started on all the enabled APs,
|
||||||
|
and releases the BSP to continue with other tasks.
|
||||||
|
-# The caller can use the CheckEvent() and WaitForEvent() services to check
|
||||||
|
the state of the WaitEvent created in step 1.
|
||||||
|
-# When the APs complete their task or TimeoutInMicroSecondss expires, the MP
|
||||||
|
Service signals WaitEvent by calling the EFI SignalEvent() function. If
|
||||||
|
FailedCpuList is not NULL, its content is available when WaitEvent is
|
||||||
|
signaled. If all APs returned from Procedure prior to the timeout, then
|
||||||
|
FailedCpuList is set to NULL. If not all APs return from Procedure before
|
||||||
|
the timeout, then FailedCpuList is filled in with the list of the failed
|
||||||
|
APs. The buffer is allocated by MP Service Protocol using AllocatePool().
|
||||||
|
It is the caller's responsibility to free the buffer with FreePool() service.
|
||||||
|
-# This invocation of SignalEvent() function informs the caller that invoked
|
||||||
|
EFI_MP_SERVICES_PROTOCOL.StartupAllAPs() that either all the APs completed
|
||||||
|
the specified task or a timeout occurred. The contents of FailedCpuList
|
||||||
|
can be examined to determine which APs did not complete the specified task
|
||||||
|
prior to the timeout.
|
||||||
|
|
||||||
|
@param[in] This A pointer to the EFI_MP_SERVICES_PROTOCOL
|
||||||
|
instance.
|
||||||
|
@param[in] Procedure A pointer to the function to be run on
|
||||||
|
enabled APs of the system. See type
|
||||||
|
EFI_AP_PROCEDURE.
|
||||||
|
@param[in] SingleThread If TRUE, then all the enabled APs execute
|
||||||
|
the function specified by Procedure one by
|
||||||
|
one, in ascending order of processor handle
|
||||||
|
number. If FALSE, then all the enabled APs
|
||||||
|
execute the function specified by Procedure
|
||||||
|
simultaneously.
|
||||||
|
@param[in] WaitEvent The event created by the caller with CreateEvent()
|
||||||
|
service. If it is NULL, then execute in
|
||||||
|
blocking mode. BSP waits until all APs finish
|
||||||
|
or TimeoutInMicroseconds expires. If it's
|
||||||
|
not NULL, then execute in non-blocking mode.
|
||||||
|
BSP requests the function specified by
|
||||||
|
Procedure to be started on all the enabled
|
||||||
|
APs, and go on executing immediately. If
|
||||||
|
all return from Procedure, or TimeoutInMicroseconds
|
||||||
|
expires, this event is signaled. The BSP
|
||||||
|
can use the CheckEvent() or WaitForEvent()
|
||||||
|
services to check the state of event. Type
|
||||||
|
EFI_EVENT is defined in CreateEvent() in
|
||||||
|
the Unified Extensible Firmware Interface
|
||||||
|
Specification.
|
||||||
|
@param[in] TimeoutInMicroseconds Indicates the time limit in microseconds for
|
||||||
|
APs to return from Procedure, either for
|
||||||
|
blocking or non-blocking mode. Zero means
|
||||||
|
infinity. If the timeout expires before
|
||||||
|
all APs return from Procedure, then Procedure
|
||||||
|
on the failed APs is terminated. All enabled
|
||||||
|
APs are available for next function assigned
|
||||||
|
by EFI_MP_SERVICES_PROTOCOL.StartupAllAPs()
|
||||||
|
or EFI_MP_SERVICES_PROTOCOL.StartupThisAP().
|
||||||
|
If the timeout expires in blocking mode,
|
||||||
|
BSP returns EFI_TIMEOUT. If the timeout
|
||||||
|
expires in non-blocking mode, WaitEvent
|
||||||
|
is signaled with SignalEvent().
|
||||||
|
@param[in] ProcedureArgument The parameter passed into Procedure for
|
||||||
|
all APs.
|
||||||
|
@param[out] FailedCpuList If NULL, this parameter is ignored. Otherwise,
|
||||||
|
if all APs finish successfully, then its
|
||||||
|
content is set to NULL. If not all APs
|
||||||
|
finish before timeout expires, then its
|
||||||
|
content is set to address of the buffer
|
||||||
|
holding handle numbers of the failed APs.
|
||||||
|
The buffer is allocated by MP Service Protocol,
|
||||||
|
and it's the caller's responsibility to
|
||||||
|
free the buffer with FreePool() service.
|
||||||
|
In blocking mode, it is ready for consumption
|
||||||
|
when the call returns. In non-blocking mode,
|
||||||
|
it is ready when WaitEvent is signaled. The
|
||||||
|
list of failed CPU is terminated by
|
||||||
|
END_OF_CPU_LIST.
|
||||||
|
|
||||||
|
@retval EFI_SUCCESS In blocking mode, all APs have finished before
|
||||||
|
the timeout expired.
|
||||||
|
@retval EFI_SUCCESS In non-blocking mode, function has been dispatched
|
||||||
|
to all enabled APs.
|
||||||
|
@retval EFI_UNSUPPORTED A non-blocking mode request was made after the
|
||||||
|
UEFI event EFI_EVENT_GROUP_READY_TO_BOOT was
|
||||||
|
signaled.
|
||||||
|
@retval EFI_DEVICE_ERROR Caller processor is AP.
|
||||||
|
@retval EFI_NOT_STARTED No enabled APs exist in the system.
|
||||||
|
@retval EFI_NOT_READY Any enabled APs are busy.
|
||||||
|
@retval EFI_TIMEOUT In blocking mode, the timeout expired before
|
||||||
|
all enabled APs have finished.
|
||||||
|
@retval EFI_INVALID_PARAMETER Procedure is NULL.
|
||||||
|
|
||||||
|
**/
|
||||||
|
EFI_STATUS
|
||||||
|
EFIAPI
|
||||||
|
StartupAllAPs (
|
||||||
|
IN EFI_MP_SERVICES_PROTOCOL *This,
|
||||||
|
IN EFI_AP_PROCEDURE Procedure,
|
||||||
|
IN BOOLEAN SingleThread,
|
||||||
|
IN EFI_EVENT WaitEvent OPTIONAL,
|
||||||
|
IN UINTN TimeoutInMicroseconds,
|
||||||
|
IN VOID *ProcedureArgument OPTIONAL,
|
||||||
|
OUT UINTN **FailedCpuList OPTIONAL
|
||||||
|
);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
This service lets the caller get one enabled AP to execute a caller-provided
|
This service lets the caller get one enabled AP to execute a caller-provided
|
||||||
function. The caller can request the BSP to either wait for the completion
|
function. The caller can request the BSP to either wait for the completion
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue