if a driver can be scheduled for execution. The criteria for\r
schedulability is that the dependency expression is satisfied.\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
}\r
\r
//\r
- // Copy the Guid into a locale variable so that there are no\r
+ // Copy the GUID into a local variable so that there are no\r
// possibilities of alignment faults for cross-compilation\r
// environments such as Intel?Itanium(TM).\r
//\r
\r
This is the POSTFIX version of the dependency evaluator. When a\r
PUSH [PPI GUID] is encountered, a pointer to the GUID is stored on\r
- the evaluation stack. When that entry is poped from the evaluation\r
+ the evaluation stack. When that entry is popped from the evaluation\r
stack, the PPI is checked if it is installed. This method allows\r
some time savings as not all PPIs must be checked for certain\r
operation types (AND, OR).\r
\r
//\r
// Push the pointer to the PUSH opcode operator (pointer to PPI GUID)\r
- // We will evaluate if the PPI is insalled on the POP operation.\r
+ // We will evaluate if the PPI is installed on the POP operation.\r
//\r
StackPtr->Operator = (VOID *) Iterator;\r
Iterator = Iterator + sizeof (EFI_GUID);\r
/** @file\r
EFI PEI Core dispatch services\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
(C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
\r
/**\r
\r
- Discover all Peims and optional Apriori file in one FV. There is at most one\r
+ Discover all PEIMs and optional Apriori file in one FV. There is at most one\r
Apriori file in one FV.\r
\r
\r
Guid = NULL;\r
\r
//\r
- // If the current Fv has been scanned, directly get its cached records.\r
+ // If the current FV has been scanned, directly get its cached records.\r
//\r
if (CoreFileHandle->ScanFv) {\r
Private->CurrentFvFileHandles = CoreFileHandle->FvFileHandles;\r
TempFileGuid = Private->TempFileGuid;\r
\r
//\r
- // Go ahead to scan this Fv, get PeimCount and cache FileHandles within it to TempFileHandles.\r
+ // Go ahead to scan this FV, get PeimCount and cache FileHandles within it to TempFileHandles.\r
//\r
PeimCount = 0;\r
FileHandle = NULL;\r
\r
for (Index = 0; Index < PeimCount; Index++) {\r
//\r
- // Make an array of file name guids that matches the FileHandle array so we can convert\r
+ // Make an array of file name GUIDs that matches the FileHandle array so we can convert\r
// quickly from file name to file handle\r
//\r
Status = FvPpi->GetFileInfo (FvPpi, TempFileHandles[Index], &FileInfo);\r
}\r
\r
//\r
- // Walk through TempFileGuid array to find out who is invalid PEIM guid in Apriori file.\r
+ // Walk through TempFileGuid array to find out who is invalid PEIM GUID in Apriori file.\r
// Add available PEIMs in Apriori file into FvFileHandles array.\r
//\r
Index = 0;\r
}\r
\r
//\r
- // The current Fv File Handles have been cached. So that we don't have to scan the Fv again.\r
- // Instead, we can retrieve the file handles within this Fv from cached records.\r
+ // The current FV File Handles have been cached. So that we don't have to scan the FV again.\r
+ // Instead, we can retrieve the file handles within this FV from cached records.\r
//\r
CoreFileHandle->ScanFv = TRUE;\r
Private->CurrentFvFileHandles = CoreFileHandle->FvFileHandles;\r
DEBUG ((EFI_D_INFO, "LOADING MODULE FIXED INFO: PcdLoadFixAddressPeiCodePageNumber= 0x%x.\n", PcdGet32(PcdLoadFixAddressPeiCodePageNumber)));\r
DEBUG ((EFI_D_INFO, "LOADING MODULE FIXED INFO: Total Reserved Memory Size = 0x%lx.\n", TotalReservedMemorySize));\r
//\r
- // Loop through the system memory typed hob to merge the adjacent memory range\r
+ // Loop through the system memory typed HOB to merge the adjacent memory range\r
//\r
for (Hob.Raw = PrivateData->HobList.Raw; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {\r
//\r
\r
ResourceHob = Hob.ResourceDescriptor;\r
//\r
- // If range described in this hob is not system memory or heigher than MAX_ADDRESS, ignored.\r
+ // If range described in this HOB is not system memory or higher than MAX_ADDRESS, ignored.\r
//\r
if (ResourceHob->ResourceType != EFI_RESOURCE_SYSTEM_MEMORY ||\r
ResourceHob->PhysicalStart + ResourceHob->ResourceLength > MAX_ADDRESS) {\r
if (GET_HOB_TYPE (NextHob) == EFI_HOB_TYPE_RESOURCE_DESCRIPTOR) {\r
NextResourceHob = NextHob.ResourceDescriptor;\r
//\r
- // If range described in this hob is not system memory or heigher than MAX_ADDRESS, ignored.\r
+ // If range described in this HOB is not system memory or higher than MAX_ADDRESS, ignored.\r
//\r
if (NextResourceHob->ResourceType != EFI_RESOURCE_SYSTEM_MEMORY || NextResourceHob->PhysicalStart + NextResourceHob->ResourceLength > MAX_ADDRESS) {\r
continue;\r
}\r
//\r
- // If the range describe in memory allocation HOB belongs to the memroy range described by the resource hob\r
+ // If the range describe in memory allocation HOB belongs to the memory range described by the resource HOB\r
//\r
if (MemoryHob->AllocDescriptor.MemoryBaseAddress >= NextResourceHob->PhysicalStart &&\r
MemoryHob->AllocDescriptor.MemoryBaseAddress + MemoryHob->AllocDescriptor.MemoryLength <= NextResourceHob->PhysicalStart + NextResourceHob->ResourceLength) {\r
//\r
- // Build seperate resource hob for this allocated range\r
+ // Build separate resource HOB for this allocated range\r
//\r
if (MemoryHob->AllocDescriptor.MemoryBaseAddress > NextResourceHob->PhysicalStart) {\r
BuildResourceDescriptorHob (\r
\r
ResourceHob = Hob.ResourceDescriptor;\r
//\r
- // See if this resource descrior HOB describes tested system memory below MAX_ADDRESS\r
+ // See if this resource descriptor HOB describes tested system memory below MAX_ADDRESS\r
//\r
if (ResourceHob->ResourceType == EFI_RESOURCE_SYSTEM_MEMORY &&\r
ResourceHob->PhysicalStart + ResourceHob->ResourceLength <= MAX_ADDRESS) {\r
DEBUG ((EFI_D_INFO, "LOADING MODULE FIXED ERROR:Top Address 0x%lx is invalid \n", TopLoadingAddress));\r
DEBUG ((EFI_D_INFO, "LOADING MODULE FIXED ERROR:The recommended Top Address for the platform is: \n"));\r
//\r
- // Print the recomended Top address range.\r
+ // Print the recommended Top address range.\r
//\r
for (Hob.Raw = PrivateData->HobList.Raw; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {\r
//\r
\r
ResourceHob = Hob.ResourceDescriptor;\r
//\r
- // See if this resource descrior HOB describes tested system memory below MAX_ADDRESS\r
+ // See if this resource descriptor HOB describes tested system memory below MAX_ADDRESS\r
//\r
if (ResourceHob->ResourceType == EFI_RESOURCE_SYSTEM_MEMORY &&\r
ResourceHob->PhysicalStart + ResourceHob->ResourceLength <= MAX_ADDRESS) {\r
\r
ResourceHob = Hob.ResourceDescriptor;\r
//\r
- // See if this resource descrior HOB describes tested system memory below MAX_ADDRESS\r
+ // See if this resource descriptor HOB describes tested system memory below MAX_ADDRESS\r
//\r
if (ResourceHob->ResourceType == EFI_RESOURCE_SYSTEM_MEMORY &&\r
ResourceHob->PhysicalStart + ResourceHob->ResourceLength <= MAX_ADDRESS &&\r
\r
if (CurrentResourceHob != NULL) {\r
//\r
- // rebuild resource HOB for PEI memmory and reserved memory\r
+ // rebuild resource HOB for PEI memory and reserved memory\r
//\r
BuildResourceDescriptorHob (\r
EFI_RESOURCE_SYSTEM_MEMORY,\r
ASSERT (NewStackSize >= SecCoreData->StackSize);\r
\r
//\r
- // Calculate stack offset and heap offset between temporary memory and new permement\r
+ // Calculate stack offset and heap offset between temporary memory and new permanent\r
// memory seperately.\r
//\r
TopOfOldStack = (UINTN)SecCoreData->StackBase + SecCoreData->StackSize;\r
//\r
// This is the main dispatch loop. It will search known FVs for PEIMs and\r
// attempt to dispatch them. If any PEIM gets dispatched through a single\r
- // pass of the dispatcher, it will start over from the Bfv again to see\r
+ // pass of the dispatcher, it will start over from the BFV again to see\r
// if any new PEIMs dependencies got satisfied. With a well ordered\r
// FV where PEIMs are found in the order their dependencies are also\r
- // satisfied, this dipatcher should run only once.\r
+ // satisfied, this dispatcher should run only once.\r
//\r
do {\r
//\r
}\r
\r
//\r
- // Start to dispatch all modules within the current Fv.\r
+ // Start to dispatch all modules within the current FV.\r
//\r
for (PeimCount = Private->CurrentPeimCount;\r
PeimCount < Private->Fv[FvCount].PeimCount;\r
ASSERT_EFI_ERROR (Status);\r
if (FvFileInfo.FileType == EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE) {\r
//\r
- // For Fv type file, Produce new FvInfo PPI and FV hob\r
+ // For FV type file, Produce new FvInfo PPI and FV HOB\r
//\r
Status = ProcessFvFile (Private, &Private->Fv[FvCount], PeimFileHandle);\r
if (Status == EFI_SUCCESS) {\r
\r
if (PeimCount < Private->AprioriCount) {\r
//\r
- // If it's in the Apriori file then we set Depex to TRUE\r
+ // If it's in the Apriori file then we set DEPEX to TRUE\r
//\r
DEBUG ((DEBUG_DISPATCH, " RESULT = TRUE (Apriori)\n"));\r
return TRUE;\r
{\r
EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK,\r
&gEfiPeiFirmwareVolumeInfoPpiGuid,\r
- FirmwareVolmeInfoPpiNotifyCallback\r
+ FirmwareVolumeInfoPpiNotifyCallback\r
},\r
{\r
(EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),\r
&gEfiPeiFirmwareVolumeInfo2PpiGuid,\r
- FirmwareVolmeInfoPpiNotifyCallback\r
+ FirmwareVolumeInfoPpiNotifyCallback\r
}\r
};\r
\r
}\r
\r
/**\r
- Initialize PeiCore Fv List.\r
+ Initialize PeiCore FV List.\r
\r
@param PrivateData - Pointer to PEI_CORE_INSTANCE.\r
@param SecCoreData - Pointer to EFI_SEC_PEI_HAND_OFF.\r
\r
//\r
// Post a call-back for the FvInfoPPI and FvInfo2PPI services to expose\r
- // additional Fvs to PeiCore.\r
+ // additional FVs to PeiCore.\r
//\r
Status = PeiServicesNotifyPpi (mNotifyOnFvInfoList);\r
ASSERT_EFI_ERROR (Status);\r
}\r
\r
/**\r
- Process Firmware Volum Information once FvInfoPPI or FvInfo2PPI install.\r
+ Process Firmware Volume Information once FvInfoPPI or FvInfo2PPI install.\r
The FV Info will be registered into PeiCore private data structure.\r
And search the inside FV image, if found, the new FV INFO(2) PPI will be installed.\r
\r
@param Ppi Address of the PPI that was installed.\r
\r
@retval EFI_SUCCESS The FV Info is registered into PeiCore private data structure.\r
- @return if not EFI_SUCESS, fail to verify FV.\r
+ @return if not EFI_SUCCESS, fail to verify FV.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
-FirmwareVolmeInfoPpiNotifyCallback (\r
+FirmwareVolumeInfoPpiNotifyCallback (\r
IN EFI_PEI_SERVICES **PeiServices,\r
IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor,\r
IN VOID *Ppi\r
}\r
\r
//\r
- // Locate the corresponding FV_PPI according to founded FV's format guid\r
+ // Locate the corresponding FV_PPI according to founded FV's format GUID\r
//\r
Status = PeiServicesLocatePpi (\r
&FvInfo2Ppi.FvFormat,\r
PrivateData->Fv[FvIndex].AuthenticationStatus = FvInfo2Ppi.AuthenticationStatus;\r
DEBUG ((EFI_D_INFO, "Update AuthenticationStatus of the %dth FV to 0x%x!\n", FvIndex, FvInfo2Ppi.AuthenticationStatus));\r
}\r
- DEBUG ((EFI_D_INFO, "The Fv %p has already been processed!\n", FvInfo2Ppi.FvInfo));\r
+ DEBUG ((DEBUG_INFO, "The FV %p has already been processed!\n", FvInfo2Ppi.FvInfo));\r
return EFI_SUCCESS;\r
}\r
}\r
PrivateData->FvCount ++;\r
\r
//\r
- // Scan and process the new discoveried FV for EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE\r
+ // Scan and process the new discovered FV for EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE\r
//\r
FileHandle = NULL;\r
do {\r
}\r
\r
/**\r
- Get Fv image(s) from the FV type file, then install FV INFO(2) ppi, Build FV(2, 3) hob.\r
+ Get FV image(s) from the FV type file, then install FV INFO(2) PPI, Build FV(2, 3) HOB.\r
\r
@param PrivateData PeiCore's private data structure\r
- @param ParentFvCoreHandle Pointer of EFI_CORE_FV_HANDLE to parent Fv image that contain this Fv image.\r
- @param ParentFvFileHandle File handle of a Fv type file that contain this Fv image.\r
+ @param ParentFvCoreHandle Pointer of EFI_CORE_FV_HANDLE to parent FV image that contain this FV image.\r
+ @param ParentFvFileHandle File handle of a FV type file that contain this FV image.\r
\r
@retval EFI_NOT_FOUND FV image can't be found.\r
@retval EFI_SUCCESS Successfully to process it.\r
);\r
\r
//\r
- // Inform the extracted FvImage to Fv HOB consumer phase, i.e. DXE phase\r
+ // Inform the extracted FvImage to FV HOB consumer phase, i.e. DXE phase\r
//\r
BuildFvHob (\r
(EFI_PHYSICAL_ADDRESS) (UINTN) FvHeader,\r
\r
//\r
// The build-in EFI_PEI_FIRMWARE_VOLUME_PPI for FFS2/FFS3 support memory-mapped\r
- // FV image and the handle is pointed to Fv image's buffer.\r
+ // FV image and the handle is pointed to FV image's buffer.\r
//\r
*FvHandle = (EFI_PEI_FV_HANDLE) Buffer;\r
\r
CopyMem (&FwVolHeader, FvHandle, sizeof (EFI_FIRMWARE_VOLUME_HEADER));\r
\r
//\r
- // Check Fv Image Signature\r
+ // Check FV Image Signature\r
//\r
if (FwVolHeader.Signature != EFI_FVH_SIGNATURE) {\r
return EFI_INVALID_PARAMETER;\r
/**\r
Get instance of PEI_CORE_FV_HANDLE for next volume according to given index.\r
\r
- This routine also will install FvInfo ppi for FV hob in PI ways.\r
+ This routine also will install FvInfo PPI for FV HOB in PI ways.\r
\r
@param Private Pointer of PEI_CORE_INSTANCE\r
@param Instance The index of FV want to be searched.\r
}\r
\r
/**\r
- Report the information for a new discoveried FV in unknown third-party format.\r
+ Report the information for a new discovered FV in unknown third-party format.\r
\r
If the EFI_PEI_FIRMWARE_VOLUME_PPI has not been installed for third-party FV format, but\r
- the FV in this format has been discoveried, then this FV's information will be cached into\r
+ the FV in this format has been discovered, then this FV's information will be cached into\r
PEI_CORE_INSTANCE's UnknownFvInfo array.\r
Also a notification would be installed for unknown third-party FV format guid, if EFI_PEI_FIRMWARE_VOLUME_PPI\r
is installed later by platform's PEIM, the original unknown third-party FV will be processed by\r
}\r
\r
/**\r
- Find the FV information according to third-party FV format guid.\r
+ Find the FV information according to third-party FV format GUID.\r
\r
- This routine also will remove the FV information found by given FV format guid from\r
+ This routine also will remove the FV information found by given FV format GUID from\r
PrivateData->UnknownFvInfo[].\r
\r
@param PrivateData Point to instance of PEI_CORE_INSTANCE\r
- @param Format Point to given FV format guid\r
+ @param Format Point to given FV format GUID\r
@param FvInfo On return, the pointer of FV information buffer\r
@param FvInfoSize On return, the size of FV information buffer.\r
@param AuthenticationStatus On return, the authentication status of FV information buffer.\r
Notification callback function for EFI_PEI_FIRMWARE_VOLUME_PPI.\r
\r
When a EFI_PEI_FIRMWARE_VOLUME_PPI is installed to support new FV format, this\r
- routine is called to process all discoveried FVs in this format.\r
+ routine is called to process all discovered FVs in this format.\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation\r
@param NotifyDescriptor Address of the notification descriptor data structure.\r
IsProcessed = FALSE;\r
for (FvIndex = 0; FvIndex < PrivateData->FvCount; FvIndex ++) {\r
if (PrivateData->Fv[FvIndex].FvHandle == FvHandle) {\r
- DEBUG ((EFI_D_INFO, "The Fv %p has already been processed!\n", FvInfo));\r
+ DEBUG ((DEBUG_INFO, "The FV %p has already been processed!\n", FvInfo));\r
IsProcessed = TRUE;\r
break;\r
}\r
PrivateData->FvCount ++;\r
\r
//\r
- // Scan and process the new discoveried FV for EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE\r
+ // Scan and process the new discovered FV for EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE\r
//\r
FileHandle = NULL;\r
do {\r
/** @file\r
The internal header file for firmware volume related definitions.\r
\r
-Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2009 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
);\r
\r
/**\r
- Report the information for a new discoveried FV in unknown format.\r
+ Report the information for a new discovered FV in unknown format.\r
\r
- If the EFI_PEI_FIRMWARE_VOLUME_PPI has not been installed for specifical FV format, but\r
- the FV in this FV format has been discoveried, then the information of this FV\r
+ If the EFI_PEI_FIRMWARE_VOLUME_PPI has not been installed for specific FV format, but\r
+ the FV in this FV format has been discovered, then the information of this FV\r
will be cached into PEI_CORE_INSTANCE's UnknownFvInfo array.\r
- Also a notification would be installed for unknown FV format guid, if EFI_PEI_FIRMWARE_VOLUME_PPI\r
+ Also a notification would be installed for unknown FV format GUID, if EFI_PEI_FIRMWARE_VOLUME_PPI\r
is installed later by platform's PEIM, the original unknown FV will be processed by\r
using new installed EFI_PEI_FIRMWARE_VOLUME_PPI.\r
\r
);\r
\r
/**\r
- Find the FV information according to FV format guid.\r
+ Find the FV information according to FV format GUID.\r
\r
- This routine also will remove the FV information found by given FV format guid from\r
+ This routine also will remove the FV information found by given FV format GUID from\r
PrivateData->UnknownFvInfo[].\r
\r
@param PrivateData Point to instance of PEI_CORE_INSTANCE\r
- @param Format Point to given FV format guid\r
- @param FvInfo On return, the pointer of FV information buffer in given FV format guid\r
+ @param Format Point to given FV format GUID\r
+ @param FvInfo On return, the pointer of FV information buffer in given FV format GUID\r
@param FvInfoSize On return, the size of FV information buffer.\r
@param AuthenticationStatus On return, the authentication status of FV information buffer.\r
\r
Notification callback function for EFI_PEI_FIRMWARE_VOLUME_PPI.\r
\r
When a EFI_PEI_FIRMWARE_VOLUME_PPI is installed to support new FV format, this\r
- routine is called to process all discoveried FVs in this format.\r
+ routine is called to process all discovered FVs in this format.\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation\r
@param NotifyDescriptor Address of the notification descriptor data structure.\r
/** @file\r
This module provide Hand-Off Block manupulation.\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
@param Length Length of the new HOB to allocate.\r
@param Hob Pointer to the new HOB.\r
\r
- @return EFI_SUCCESS Success to create hob.\r
+ @return EFI_SUCCESS Success to create HOB.\r
@retval EFI_INVALID_PARAMETER if Hob is NULL\r
@retval EFI_NOT_AVAILABLE_YET if HobList is still not available.\r
@retval EFI_OUT_OF_RESOURCES if there is no more memory to grow the Hoblist.\r
/** @file\r
Pei Core Load Image Support\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
}\r
\r
//\r
- // Test if the memory is avalaible or not.\r
+ // Test if the memory is available or not.\r
//\r
MemoryUsageBitMap = Private->PeiCodeMemoryRangeUsageBitMap;\r
BaseOffsetPageNumber = EFI_SIZE_TO_PAGES((UINT32)(ImageBase - PeiCodeBase));\r
}\r
\r
//\r
- // Initilize local IsS3Boot and IsRegisterForShadow variable\r
+ // Initialize local IsS3Boot and IsRegisterForShadow variable\r
//\r
IsS3Boot = FALSE;\r
if (Private->HobList.HandoffInformationTable->BootMode == BOOT_ON_S3_RESUME) {\r
if (EFI_ERROR (Status)){\r
DEBUG ((EFI_D_INFO|EFI_D_LOAD, "LOADING MODULE FIXED ERROR: Failed to load module at fixed address. \n"));\r
//\r
- // The PEIM is not assiged valid address, try to allocate page to load it.\r
+ // The PEIM is not assigned valid address, try to allocate page to load it.\r
//\r
Status = PeiServicesAllocatePages (EfiBootServicesCode,\r
EFI_SIZE_TO_PAGES ((UINT32) AlignImageSize),\r
//\r
// Copy the PDB file name to our temporary string, and replace .pdb with .efi\r
// The PDB file name is limited in the range of 0~511.\r
- // If the length is bigger than 511, trim the redudant characters to avoid overflow in array boundary.\r
+ // If the length is bigger than 511, trim the redundant characters to avoid overflow in array boundary.\r
//\r
for (Index = 0; Index < sizeof (EfiFileName) - 4; Index++) {\r
EfiFileName[Index] = AsciiString[Index + StartIndex];\r
/** @file\r
EFI PEI Core memory services\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
environment, such as the size and location of temporary RAM, the stack location and\r
the BFV location.\r
@param OldCoreData Pointer to the PEI Core data.\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
\r
**/\r
VOID\r
\r
//\r
// First entering PeiCore, following code will initialized some field\r
- // in PeiCore's private data according to hand off data from sec core.\r
+ // in PeiCore's private data according to hand off data from SEC core.\r
//\r
if (OldCoreData == NULL) {\r
\r
The usage model is that the PEIM that discovers the permanent memory shall invoke this service.\r
This routine will hold discoveried memory information into PeiCore's private data,\r
and set SwitchStackSignal flag. After PEIM who discovery memory is dispatched,\r
- PeiDispatcher will migrate temporary memory to permenement memory.\r
+ PeiDispatcher will migrate temporary memory to permanent memory.\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
@param MemoryBegin Start of memory address.\r
//\r
// PEI_SERVICE.InstallPeiMemory should only be called one time during whole PEI phase.\r
// If it is invoked more than one time, ASSERT information is given for developer debugging in debug tip and\r
- // simply return EFI_SUCESS in release tip to ignore it.\r
+ // simply return EFI_SUCCESS in release tip to ignore it.\r
//\r
if (PrivateData->PeiMemoryInstalled) {\r
DEBUG ((EFI_D_ERROR, "ERROR: PeiInstallPeiMemory is called more than once!\n"));\r
\r
/**\r
\r
- Pool allocation service. Before permanent memory is discoveried, the pool will\r
- be allocated the heap in the temporary memory. Genenrally, the size of heap in temporary\r
+ Pool allocation service. Before permanent memory is discovered, the pool will\r
+ be allocated the heap in the temporary memory. Generally, the size of heap in temporary\r
memory does not exceed to 64K, so the biggest pool size could be allocated is\r
64K.\r
\r
\r
//\r
// Generally, the size of heap in temporary memory does not exceed to 64K,\r
- // HobLength is multiples of 8 bytes, so the maxmium size of pool is 0xFFF8 - sizeof (EFI_HOB_MEMORY_POOL)\r
+ // HobLength is multiples of 8 bytes, so the maximum size of pool is 0xFFF8 - sizeof (EFI_HOB_MEMORY_POOL)\r
//\r
if (Size > (0xFFF8 - sizeof (EFI_HOB_MEMORY_POOL))) {\r
return EFI_OUT_OF_RESOURCES;\r
\r
///\r
/// It is an FFS type extension used for PeiFindFileEx. It indicates current\r
-/// Ffs searching is for all PEIMs can be dispatched by PeiCore.\r
+/// FFS searching is for all PEIMs can be dispatched by PeiCore.\r
///\r
#define PEI_CORE_INTERNAL_FFS_FILE_DISPATCH_TYPE 0xff\r
\r
} PEI_PPI_DATABASE;\r
\r
//\r
-// PEI_CORE_FV_HANDE.PeimState\r
+// PEI_CORE_FV_HANDLE.PeimState\r
// Do not change these values as there is code doing math to change states.\r
// Look for Private->Fv[FvCount].PeimState[PeimCount]++;\r
//\r
EFI_PEI_FV_HANDLE FvHandle;\r
UINTN PeimCount;\r
//\r
- // Ponter to the buffer with the PeimCount number of Entries.\r
+ // Pointer to the buffer with the PeimCount number of Entries.\r
//\r
UINT8 *PeimState;\r
//\r
- // Ponter to the buffer with the PeimCount number of Entries.\r
+ // Pointer to the buffer with the PeimCount number of Entries.\r
//\r
EFI_PEI_FILE_HANDLE *FvFileHandles;\r
BOOLEAN ScanFv;\r
//\r
// For Loading modules at fixed address feature to cache the top address below which the\r
// Runtime code, boot time code and PEI memory will be placed. Please note that the offset between this field\r
- // and Ps should not be changed since maybe user could get this top address by using the offet to Ps.\r
+ // and Ps should not be changed since maybe user could get this top address by using the offset to Ps.\r
//\r
EFI_PHYSICAL_ADDRESS LoadModuleAtFixAddressTopAddress;\r
//\r
\r
This is the POSTFIX version of the dependency evaluator. When a\r
PUSH [PPI GUID] is encountered, a pointer to the GUID is stored on\r
- the evaluation stack. When that entry is poped from the evaluation\r
+ the evaluation stack. When that entry is popped from the evaluation\r
stack, the PPI is checked if it is installed. This method allows\r
some time savings as not all PPIs must be checked for certain\r
operation types (AND, OR).\r
\r
@param PrivateData PeiCore's private data structure\r
@param OldCoreData Old data from SecCore\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
@param SecCoreData Points to a data structure containing SEC to PEI handoff data, such as the size\r
and location of temporary RAM, the stack location and the BFV location.\r
\r
\r
@param PrivateData Pointer to the PEI Core data.\r
@param OldCoreData Pointer to old PEI Core data.\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
\r
**/\r
VOID\r
Install PPI services. It is implementation of EFI_PEI_SERVICE.InstallPpi.\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
- @param PpiList Pointer to ppi array that want to be installed.\r
+ @param PpiList Pointer to PPI array that want to be installed.\r
\r
@retval EFI_SUCCESS if all PPIs in PpiList are successfully installed.\r
@retval EFI_INVALID_PARAMETER if PpiList is NULL pointer\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
@param OldCoreData Pointer to the old core data.\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
\r
**/\r
VOID\r
\r
@param PrivateData PeiCore's private data structure\r
@param VolumeHandle Handle of FV\r
- @param FileHandle Handle of PEIM's ffs\r
+ @param FileHandle Handle of PEIM's FFS\r
@param AuthenticationStatus Authentication status\r
\r
@retval EFI_SUCCESS Image is OK\r
@param Length Length of the new HOB to allocate.\r
@param Hob Pointer to the new HOB.\r
\r
- @return EFI_SUCCESS Success to create hob.\r
+ @return EFI_SUCCESS Success to create HOB.\r
@retval EFI_INVALID_PARAMETER if Hob is NULL\r
@retval EFI_NOT_AVAILABLE_YET if HobList is still not available.\r
@retval EFI_OUT_OF_RESOURCES if there is no more memory to grow the Hoblist.\r
@param SecCoreData Points to a data structure containing SEC to PEI handoff data, such as the size\r
and location of temporary RAM, the stack location and the BFV location.\r
@param OldCoreData Pointer to the PEI Core data.\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
\r
**/\r
VOID\r
\r
/**\r
\r
- Initialize PeiCore Fv List.\r
+ Initialize PeiCore FV List.\r
\r
\r
@param PrivateData - Pointer to PEI_CORE_INSTANCE.\r
);\r
\r
/**\r
- Process Firmware Volum Information once FvInfoPPI install.\r
+ Process Firmware Volume Information once FvInfoPPI install.\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
@param NotifyDescriptor Address of the notification descriptor data structure.\r
**/\r
EFI_STATUS\r
EFIAPI\r
-FirmwareVolmeInfoPpiNotifyCallback (\r
+FirmwareVolumeInfoPpiNotifyCallback (\r
IN EFI_PEI_SERVICES **PeiServices,\r
IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor,\r
IN VOID *Ppi\r
);\r
\r
/**\r
- Get Fv image(s) from the FV type file, then install FV INFO(2) ppi, Build FV(2, 3) hob.\r
+ Get FV image(s) from the FV type file, then install FV INFO(2) PPI, Build FV(2, 3) HOB.\r
\r
@param PrivateData PeiCore's private data structure\r
- @param ParentFvCoreHandle Pointer of EFI_CORE_FV_HANDLE to parent Fv image that contain this Fv image.\r
- @param ParentFvFileHandle File handle of a Fv type file that contain this Fv image.\r
+ @param ParentFvCoreHandle Pointer of EFI_CORE_FV_HANDLE to parent FV image that contain this FV image.\r
+ @param ParentFvFileHandle File handle of a FV type file that contain this FV image.\r
\r
@retval EFI_NOT_FOUND FV image can't be found.\r
@retval EFI_SUCCESS Successfully to process it.\r
/**\r
Get instance of PEI_CORE_FV_HANDLE for next volume according to given index.\r
\r
- This routine also will install FvInfo ppi for FV hob in PI ways.\r
+ This routine also will install FvInfo PPI for FV HOB in PI ways.\r
\r
@param Private Pointer of PEI_CORE_INSTANCE\r
@param Instance The index of FV want to be searched.\r
\r
[Guids]\r
gPeiAprioriFileNameGuid ## SOMETIMES_CONSUMES ## File\r
- ## PRODUCES ## UNDEFINED # Install ppi\r
- ## CONSUMES ## UNDEFINED # Locate ppi\r
+ ## PRODUCES ## UNDEFINED # Install PPI\r
+ ## CONSUMES ## UNDEFINED # Locate PPI\r
gEfiFirmwareFileSystem2Guid\r
- ## PRODUCES ## UNDEFINED # Install ppi\r
- ## CONSUMES ## UNDEFINED # Locate ppi\r
- ## CONSUMES ## GUID # Used to compare with FV's file system guid and get the FV's file system format\r
+ ## PRODUCES ## UNDEFINED # Install PPI\r
+ ## CONSUMES ## UNDEFINED # Locate PPI\r
+ ## CONSUMES ## GUID # Used to compare with FV's file system GUID and get the FV's file system format\r
gEfiFirmwareFileSystem3Guid\r
\r
[Ppis]\r
}\r
\r
//\r
- // Shadow PEI Core. When permanent memory is avaiable, shadow\r
+ // Shadow PEI Core. When permanent memory is available, shadow\r
// PEI Core and PEIMs to get high performance.\r
//\r
OldCoreData->ShadowedPeiCore = (PEICORE_FUNCTION_POINTER) (UINTN) PeiCore;\r
/** @file\r
EFI PEI Core PPI services\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
//\r
// Check if the PEIM that was just dispatched resulted in any\r
// Notifies getting installed. If so, go process any dispatch\r
- // level Notifies that match the previouly installed PPIs.\r
+ // level Notifies that match the previously installed PPIs.\r
// Use "while" instead of "if" since ProcessNotify can modify\r
// DispatchNotifyList.CurrentCount (with NotifyPpi) so we have\r
// to iterate until the same.\r
/** @file\r
EFI PEI Core Security services\r
\r
-Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
@param OldCoreData Pointer to the old core data.\r
- NULL if being run in non-permament memory mode.\r
+ NULL if being run in non-permanent memory mode.\r
\r
**/\r
VOID\r
\r
@param PrivateData PeiCore's private data structure\r
@param VolumeHandle Handle of FV\r
- @param FileHandle Handle of PEIM's ffs\r
+ @param FileHandle Handle of PEIM's FFS\r
@param AuthenticationStatus Authentication status\r
\r
@retval EFI_SUCCESS Image is OK\r
)\r
{\r
EFI_STATUS Status;\r
- BOOLEAN DeferExection;\r
+ BOOLEAN DeferExecution;\r
\r
Status = EFI_NOT_FOUND;\r
if (PrivateData->PrivateSecurityPpi == NULL) {\r
AuthenticationStatus,\r
VolumeHandle,\r
FileHandle,\r
- &DeferExection\r
+ &DeferExecution\r
);\r
- if (DeferExection) {\r
+ if (DeferExecution) {\r
Status = EFI_SECURITY_VIOLATION;\r
}\r
}\r
projects / mirror_edk2.git / commitdiff