]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdeModulePkg/Core/Pei/PeiMain.h
MdeModulePkg: Apply uncrustify changes
[mirror_edk2.git] / MdeModulePkg / Core / Pei / PeiMain.h
index e2f8cd9c775841213b6ec98ed8beb0da802ae2ba..556beddad533989f12967d2dedd21319d39f90b9 100644 (file)
@@ -1,14 +1,8 @@
 /** @file\r
   Definition of Pei Core Structures and Services\r
 \r
-Copyright (c) 2006 - 2018, 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
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
@@ -31,6 +25,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Ppi/TemporaryRamSupport.h>\r
 #include <Ppi/TemporaryRamDone.h>\r
 #include <Ppi/SecHobData.h>\r
+#include <Ppi/PeiCoreFvLocation.h>\r
 #include <Library/DebugLib.h>\r
 #include <Library/PeiCoreEntryPoint.h>\r
 #include <Library/BaseLib.h>\r
@@ -49,111 +44,140 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Guid/FirmwareFileSystem2.h>\r
 #include <Guid/FirmwareFileSystem3.h>\r
 #include <Guid/AprioriFileName.h>\r
+#include <Guid/MigratedFvInfo.h>\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
+#define PEI_CORE_INTERNAL_FFS_FILE_DISPATCH_TYPE  0xff\r
 \r
 ///\r
 /// Pei Core private data structures\r
 ///\r
 typedef union {\r
-  EFI_PEI_PPI_DESCRIPTOR      *Ppi;\r
-  EFI_PEI_NOTIFY_DESCRIPTOR   *Notify;\r
-  VOID                        *Raw;\r
+  EFI_PEI_PPI_DESCRIPTOR       *Ppi;\r
+  EFI_PEI_NOTIFY_DESCRIPTOR    *Notify;\r
+  VOID                         *Raw;\r
 } PEI_PPI_LIST_POINTERS;\r
 \r
 ///\r
-/// PPI database structure which contains two link: PpiList and NotifyList. PpiList\r
-/// is in head of PpiListPtrs array and notify is in end of PpiListPtrs.\r
+/// Number of PEI_PPI_LIST_POINTERS to grow by each time we run out of room\r
 ///\r
+#define PPI_GROWTH_STEP              64\r
+#define CALLBACK_NOTIFY_GROWTH_STEP  32\r
+#define DISPATCH_NOTIFY_GROWTH_STEP  8\r
+\r
 typedef struct {\r
+  UINTN                    CurrentCount;\r
+  UINTN                    MaxCount;\r
+  UINTN                    LastDispatchedCount;\r
   ///\r
-  /// index of end of PpiList link list.\r
+  /// MaxCount number of entries.\r
   ///\r
-  INTN                    PpiListEnd;\r
+  PEI_PPI_LIST_POINTERS    *PpiPtrs;\r
+} PEI_PPI_LIST;\r
+\r
+typedef struct {\r
+  UINTN                    CurrentCount;\r
+  UINTN                    MaxCount;\r
   ///\r
-  /// index of end of notify link list.\r
+  /// MaxCount number of entries.\r
   ///\r
-  INTN                    NotifyListEnd;\r
+  PEI_PPI_LIST_POINTERS    *NotifyPtrs;\r
+} PEI_CALLBACK_NOTIFY_LIST;\r
+\r
+typedef struct {\r
+  UINTN                    CurrentCount;\r
+  UINTN                    MaxCount;\r
+  UINTN                    LastDispatchedCount;\r
   ///\r
-  /// index of the dispatched notify list.\r
+  /// MaxCount number of entries.\r
   ///\r
-  INTN                    DispatchListEnd;\r
+  PEI_PPI_LIST_POINTERS    *NotifyPtrs;\r
+} PEI_DISPATCH_NOTIFY_LIST;\r
+\r
+///\r
+/// PPI database structure which contains three links:\r
+/// PpiList, CallbackNotifyList and DispatchNotifyList.\r
+///\r
+typedef struct {\r
   ///\r
-  /// index of last installed Ppi description in PpiList link list.\r
+  /// PPI List.\r
   ///\r
-  INTN                    LastDispatchedInstall;\r
+  PEI_PPI_LIST                PpiList;\r
   ///\r
-  /// index of last dispatched notify in Notify link list.\r
+  /// Notify List at dispatch level.\r
   ///\r
-  INTN                    LastDispatchedNotify;\r
+  PEI_CALLBACK_NOTIFY_LIST    CallbackNotifyList;\r
   ///\r
-  /// Ppi database has the PcdPeiCoreMaxPpiSupported number of entries.\r
+  /// Notify List at callback level.\r
   ///\r
-  PEI_PPI_LIST_POINTERS   *PpiListPtrs;\r
+  PEI_DISPATCH_NOTIFY_LIST    DispatchNotifyList;\r
 } PEI_PPI_DATABASE;\r
 \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
-#define PEIM_STATE_NOT_DISPATCHED         0x00\r
-#define PEIM_STATE_DISPATCHED             0x01\r
-#define PEIM_STATE_REGISTER_FOR_SHADOW    0x02\r
-#define PEIM_STATE_DONE                   0x03\r
+#define PEIM_STATE_NOT_DISPATCHED       0x00\r
+#define PEIM_STATE_DISPATCHED           0x01\r
+#define PEIM_STATE_REGISTER_FOR_SHADOW  0x02\r
+#define PEIM_STATE_DONE                 0x03\r
+\r
+//\r
+// Number of FV instances to grow by each time we run out of room\r
+//\r
+#define FV_GROWTH_STEP  8\r
 \r
 typedef struct {\r
-  EFI_FIRMWARE_VOLUME_HEADER          *FvHeader;\r
-  EFI_PEI_FIRMWARE_VOLUME_PPI         *FvPpi;\r
-  EFI_PEI_FV_HANDLE                   FvHandle;\r
+  EFI_FIRMWARE_VOLUME_HEADER     *FvHeader;\r
+  EFI_PEI_FIRMWARE_VOLUME_PPI    *FvPpi;\r
+  EFI_PEI_FV_HANDLE              FvHandle;\r
+  UINTN                          PeimCount;\r
   //\r
-  // Ponter to the buffer with the PcdPeiCoreMaxPeimPerFv number of Entries.\r
+  // Pointer to the buffer with the PeimCount number of Entries.\r
   //\r
-  UINT8                               *PeimState;\r
+  UINT8                          *PeimState;\r
   //\r
-  // Ponter to the buffer with the PcdPeiCoreMaxPeimPerFv 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
-  UINT32                              AuthenticationStatus;\r
+  EFI_PEI_FILE_HANDLE            *FvFileHandles;\r
+  BOOLEAN                        ScanFv;\r
+  UINT32                         AuthenticationStatus;\r
 } PEI_CORE_FV_HANDLE;\r
 \r
 typedef struct {\r
-  EFI_GUID                            FvFormat;\r
-  VOID                                *FvInfo;\r
-  UINT32                              FvInfoSize;\r
-  UINT32                              AuthenticationStatus;\r
-  EFI_PEI_NOTIFY_DESCRIPTOR           NotifyDescriptor;\r
+  EFI_GUID                     FvFormat;\r
+  VOID                         *FvInfo;\r
+  UINT32                       FvInfoSize;\r
+  UINT32                       AuthenticationStatus;\r
+  EFI_PEI_NOTIFY_DESCRIPTOR    NotifyDescriptor;\r
 } PEI_CORE_UNKNOW_FORMAT_FV_INFO;\r
 \r
-#define CACHE_SETION_MAX_NUMBER       0x10\r
+#define CACHE_SETION_MAX_NUMBER  0x10\r
 typedef struct {\r
-  EFI_COMMON_SECTION_HEADER*          Section[CACHE_SETION_MAX_NUMBER];\r
-  VOID*                               SectionData[CACHE_SETION_MAX_NUMBER];\r
-  UINTN                               SectionSize[CACHE_SETION_MAX_NUMBER];\r
-  UINT32                              AuthenticationStatus[CACHE_SETION_MAX_NUMBER];\r
-  UINTN                               AllSectionCount;\r
-  UINTN                               SectionIndex;\r
+  EFI_COMMON_SECTION_HEADER    *Section[CACHE_SETION_MAX_NUMBER];\r
+  VOID                         *SectionData[CACHE_SETION_MAX_NUMBER];\r
+  UINTN                        SectionSize[CACHE_SETION_MAX_NUMBER];\r
+  UINT32                       AuthenticationStatus[CACHE_SETION_MAX_NUMBER];\r
+  UINTN                        AllSectionCount;\r
+  UINTN                        SectionIndex;\r
 } CACHE_SECTION_DATA;\r
 \r
-#define HOLE_MAX_NUMBER       0x3\r
+#define HOLE_MAX_NUMBER  0x3\r
 typedef struct {\r
-  EFI_PHYSICAL_ADDRESS               Base;\r
-  UINTN                              Size;\r
-  UINTN                              Offset;\r
-  BOOLEAN                            OffsetPositive;\r
+  EFI_PHYSICAL_ADDRESS    Base;\r
+  UINTN                   Size;\r
+  UINTN                   Offset;\r
+  BOOLEAN                 OffsetPositive;\r
 } HOLE_MEMORY_DATA;\r
 \r
 ///\r
 /// Forward declaration for PEI_CORE_INSTANCE\r
 ///\r
-typedef struct _PEI_CORE_INSTANCE  PEI_CORE_INSTANCE;\r
-\r
+typedef struct _PEI_CORE_INSTANCE PEI_CORE_INSTANCE;\r
 \r
 /**\r
   Function Pointer type for PeiCore function.\r
@@ -176,78 +200,89 @@ EFI_STATUS
   IN PEI_CORE_INSTANCE              *OldCoreData\r
   );\r
 \r
+//\r
+// Number of files to grow by each time we run out of room\r
+//\r
+#define TEMP_FILE_GROWTH_STEP  32\r
+\r
 #define PEI_CORE_HANDLE_SIGNATURE  SIGNATURE_32('P','e','i','C')\r
 \r
 ///\r
 /// Pei Core private data structure instance\r
 ///\r
 struct _PEI_CORE_INSTANCE {\r
-  UINTN                              Signature;\r
+  UINTN                             Signature;\r
 \r
   ///\r
   /// Point to ServiceTableShadow\r
   ///\r
-  EFI_PEI_SERVICES                   *Ps;\r
-  PEI_PPI_DATABASE                   PpiData;\r
+  EFI_PEI_SERVICES                  *Ps;\r
+  PEI_PPI_DATABASE                  PpiData;\r
 \r
   ///\r
   /// The count of FVs which contains FFS and could be dispatched by PeiCore.\r
   ///\r
-  UINTN                              FvCount;\r
+  UINTN                             FvCount;\r
 \r
   ///\r
-  /// Pointer to the buffer with the PcdPeiCoreMaxFvSupported number of entries.\r
+  /// The max count of FVs which contains FFS and could be dispatched by PeiCore.\r
+  ///\r
+  UINTN                             MaxFvCount;\r
+\r
+  ///\r
+  /// Pointer to the buffer with the MaxFvCount number of entries.\r
   /// Each entry is for one FV which contains FFS and could be dispatched by PeiCore.\r
   ///\r
-  PEI_CORE_FV_HANDLE                 *Fv;\r
+  PEI_CORE_FV_HANDLE                *Fv;\r
 \r
   ///\r
-  /// Pointer to the buffer with the PcdPeiCoreMaxFvSupported number of entries.\r
+  /// Pointer to the buffer with the MaxUnknownFvInfoCount number of entries.\r
   /// Each entry is for one FV which could not be dispatched by PeiCore.\r
   ///\r
-  PEI_CORE_UNKNOW_FORMAT_FV_INFO     *UnknownFvInfo;\r
-  UINTN                              UnknownFvInfoCount;\r
+  PEI_CORE_UNKNOW_FORMAT_FV_INFO    *UnknownFvInfo;\r
+  UINTN                             MaxUnknownFvInfoCount;\r
+  UINTN                             UnknownFvInfoCount;\r
 \r
   ///\r
-  /// Pointer to the buffer with the PcdPeiCoreMaxPeimPerFv number of entries.\r
+  /// Pointer to the buffer FvFileHandlers in PEI_CORE_FV_HANDLE specified by CurrentPeimFvCount.\r
   ///\r
-  EFI_PEI_FILE_HANDLE                *CurrentFvFileHandles;\r
-  UINTN                              AprioriCount;\r
-  UINTN                              CurrentPeimFvCount;\r
-  UINTN                              CurrentPeimCount;\r
-  EFI_PEI_FILE_HANDLE                CurrentFileHandle;\r
-  BOOLEAN                            PeimNeedingDispatch;\r
-  BOOLEAN                            PeimDispatchOnThisPass;\r
-  BOOLEAN                            PeimDispatcherReenter;\r
-  EFI_PEI_HOB_POINTERS               HobList;\r
-  BOOLEAN                            SwitchStackSignal;\r
-  BOOLEAN                            PeiMemoryInstalled;\r
-  VOID                               *CpuIo;\r
-  EFI_PEI_SECURITY2_PPI              *PrivateSecurityPpi;\r
-  EFI_PEI_SERVICES                   ServiceTableShadow;\r
-  EFI_PEI_PPI_DESCRIPTOR             *XipLoadFile;\r
-  EFI_PHYSICAL_ADDRESS               PhysicalMemoryBegin;\r
-  UINT64                             PhysicalMemoryLength;\r
-  EFI_PHYSICAL_ADDRESS               FreePhysicalMemoryTop;\r
-  UINTN                              HeapOffset;\r
-  BOOLEAN                            HeapOffsetPositive;\r
-  UINTN                              StackOffset;\r
-  BOOLEAN                            StackOffsetPositive;\r
+  EFI_PEI_FILE_HANDLE               *CurrentFvFileHandles;\r
+  UINTN                             AprioriCount;\r
+  UINTN                             CurrentPeimFvCount;\r
+  UINTN                             CurrentPeimCount;\r
+  EFI_PEI_FILE_HANDLE               CurrentFileHandle;\r
+  BOOLEAN                           PeimNeedingDispatch;\r
+  BOOLEAN                           PeimDispatchOnThisPass;\r
+  BOOLEAN                           PeimDispatcherReenter;\r
+  EFI_PEI_HOB_POINTERS              HobList;\r
+  BOOLEAN                           SwitchStackSignal;\r
+  BOOLEAN                           PeiMemoryInstalled;\r
+  VOID                              *CpuIo;\r
+  EFI_PEI_SECURITY2_PPI             *PrivateSecurityPpi;\r
+  EFI_PEI_SERVICES                  ServiceTableShadow;\r
+  EFI_PEI_PPI_DESCRIPTOR            *XipLoadFile;\r
+  EFI_PHYSICAL_ADDRESS              PhysicalMemoryBegin;\r
+  UINT64                            PhysicalMemoryLength;\r
+  EFI_PHYSICAL_ADDRESS              FreePhysicalMemoryTop;\r
+  UINTN                             HeapOffset;\r
+  BOOLEAN                           HeapOffsetPositive;\r
+  UINTN                             StackOffset;\r
+  BOOLEAN                           StackOffsetPositive;\r
   //\r
   // Information for migrating memory pages allocated in pre-memory phase.\r
   //\r
-  HOLE_MEMORY_DATA                   MemoryPages;\r
-  PEICORE_FUNCTION_POINTER           ShadowedPeiCore;\r
-  CACHE_SECTION_DATA                 CacheSection;\r
+  HOLE_MEMORY_DATA                  MemoryPages;\r
+  PEICORE_FUNCTION_POINTER          ShadowedPeiCore;\r
+  CACHE_SECTION_DATA                CacheSection;\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
+  EFI_PHYSICAL_ADDRESS              LoadModuleAtFixAddressTopAddress;\r
   //\r
   // The field is define for Loading modules at fixed address feature to tracker the PEI code\r
-  // memory range usage. It is a bit mapped array in which every bit indicates the correspoding memory page\r
+  // memory range usage. It is a bit mapped array in which every bit indicates the corresponding memory page\r
   // available or not.\r
   //\r
   UINT64                            *PeiCodeMemoryRangeUsageBitMap;\r
@@ -256,14 +291,16 @@ struct _PEI_CORE_INSTANCE {
   //\r
   PE_COFF_LOADER_READ_FILE          ShadowedImageRead;\r
 \r
+  UINTN                             TempPeimCount;\r
+\r
   //\r
-  // Pointer to the temp buffer with the PcdPeiCoreMaxPeimPerFv + 1 number of entries.\r
+  // Pointer to the temp buffer with the TempPeimCount number of entries.\r
   //\r
-  EFI_PEI_FILE_HANDLE               *FileHandles;\r
+  EFI_PEI_FILE_HANDLE               *TempFileHandles;\r
   //\r
-  // Pointer to the temp buffer with the PcdPeiCoreMaxPeimPerFv number of entries.\r
+  // Pointer to the temp buffer with the TempPeimCount number of entries.\r
   //\r
-  EFI_GUID                          *FileGuid;\r
+  EFI_GUID                          *TempFileGuid;\r
 \r
   //\r
   // Temp Memory Range is not covered by PeiTempMem and Stack.\r
@@ -282,13 +319,13 @@ struct _PEI_CORE_INSTANCE {
 /// Union of temporarily used function pointers (to save stack space)\r
 ///\r
 typedef union {\r
-  PEICORE_FUNCTION_POINTER     PeiCore;\r
-  EFI_PEIM_ENTRY_POINT2        PeimEntry;\r
-  EFI_PEIM_NOTIFY_ENTRY_POINT  PeimNotifyEntry;\r
-  EFI_DXE_IPL_PPI              *DxeIpl;\r
-  EFI_PEI_PPI_DESCRIPTOR       *PpiDescriptor;\r
-  EFI_PEI_NOTIFY_DESCRIPTOR    *NotifyDescriptor;\r
-  VOID                         *Raw;\r
+  PEICORE_FUNCTION_POINTER       PeiCore;\r
+  EFI_PEIM_ENTRY_POINT2          PeimEntry;\r
+  EFI_PEIM_NOTIFY_ENTRY_POINT    PeimNotifyEntry;\r
+  EFI_DXE_IPL_PPI                *DxeIpl;\r
+  EFI_PEI_PPI_DESCRIPTOR         *PpiDescriptor;\r
+  EFI_PEI_NOTIFY_DESCRIPTOR      *NotifyDescriptor;\r
+  VOID                           *Raw;\r
 } PEI_CORE_TEMP_POINTERS;\r
 \r
 typedef struct {\r
@@ -300,6 +337,7 @@ typedef struct {
 //\r
 // PeiCore function\r
 //\r
+\r
 /**\r
 \r
   The entry routine to Pei Core, invoked by PeiMain during transition\r
@@ -322,9 +360,9 @@ typedef struct {
 VOID\r
 EFIAPI\r
 PeiCore (\r
-  IN CONST EFI_SEC_PEI_HAND_OFF        *SecCoreData,\r
-  IN CONST EFI_PEI_PPI_DESCRIPTOR      *PpiList,\r
-  IN VOID                              *Data\r
+  IN CONST EFI_SEC_PEI_HAND_OFF    *SecCoreData,\r
+  IN CONST EFI_PEI_PPI_DESCRIPTOR  *PpiList,\r
+  IN VOID                          *Data\r
   );\r
 \r
 //\r
@@ -335,7 +373,7 @@ PeiCore (
 \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
@@ -353,8 +391,43 @@ PeiCore (
 **/\r
 BOOLEAN\r
 PeimDispatchReadiness (\r
-  IN EFI_PEI_SERVICES   **PeiServices,\r
-  IN VOID               *DependencyExpression\r
+  IN EFI_PEI_SERVICES  **PeiServices,\r
+  IN VOID              *DependencyExpression\r
+  );\r
+\r
+/**\r
+  Migrate a PEIM from temporary RAM to permanent memory.\r
+\r
+  @param PeimFileHandle       Pointer to the FFS file header of the image.\r
+  @param MigratedFileHandle   Pointer to the FFS file header of the migrated image.\r
+\r
+  @retval EFI_SUCCESS         Sucessfully migrated the PEIM to permanent memory.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+MigratePeim (\r
+  IN  EFI_PEI_FILE_HANDLE  FileHandle,\r
+  IN  EFI_PEI_FILE_HANDLE  MigratedFileHandle\r
+  );\r
+\r
+/**\r
+  Migrate FVs out of temporary RAM before the cache is flushed.\r
+\r
+  @param Private         PeiCore's private data structure\r
+  @param SecCoreData     Points to a data structure containing information about the PEI core's operating\r
+                         environment, such as the size and location of temporary RAM, the stack location and\r
+                         the BFV location.\r
+\r
+  @retval EFI_SUCCESS           Successfully migrated installed FVs from temporary RAM to permanent memory.\r
+  @retval EFI_OUT_OF_RESOURCES  Insufficient memory exists to allocate needed pages.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+EvacuateTempRam (\r
+  IN PEI_CORE_INSTANCE           *Private,\r
+  IN CONST EFI_SEC_PEI_HAND_OFF  *SecCoreData\r
   );\r
 \r
 /**\r
@@ -375,16 +448,16 @@ PeiDispatcher (
 \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
 VOID\r
 InitializeDispatcherData (\r
-  IN PEI_CORE_INSTANCE            *PrivateData,\r
-  IN PEI_CORE_INSTANCE            *OldCoreData,\r
-  IN CONST EFI_SEC_PEI_HAND_OFF   *SecCoreData\r
+  IN PEI_CORE_INSTANCE           *PrivateData,\r
+  IN PEI_CORE_INSTANCE           *OldCoreData,\r
+  IN CONST EFI_SEC_PEI_HAND_OFF  *SecCoreData\r
   );\r
 \r
 /**\r
@@ -402,27 +475,28 @@ InitializeDispatcherData (
 **/\r
 BOOLEAN\r
 DepexSatisfied (\r
-  IN PEI_CORE_INSTANCE          *Private,\r
-  IN EFI_PEI_FILE_HANDLE        FileHandle,\r
-  IN UINTN                      PeimCount\r
+  IN PEI_CORE_INSTANCE    *Private,\r
+  IN EFI_PEI_FILE_HANDLE  FileHandle,\r
+  IN UINTN                PeimCount\r
   );\r
 \r
 //\r
 // PPI support functions\r
 //\r
+\r
 /**\r
 \r
   Initialize PPI services.\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
 InitializePpiServices (\r
-  IN PEI_CORE_INSTANCE   *PrivateData,\r
-  IN PEI_CORE_INSTANCE   *OldCoreData\r
+  IN PEI_CORE_INSTANCE  *PrivateData,\r
+  IN PEI_CORE_INSTANCE  *OldCoreData\r
   );\r
 \r
 /**\r
@@ -440,12 +514,56 @@ ConvertPpiPointers (
   IN PEI_CORE_INSTANCE           *PrivateData\r
   );\r
 \r
+/**\r
+\r
+  Migrate Notify Pointers inside an FV from temporary memory to permanent memory.\r
+\r
+  @param PrivateData      Pointer to PeiCore's private data structure.\r
+  @param OrgFvHandle      Address of FV Handle in temporary memory.\r
+  @param FvHandle         Address of FV Handle in permanent memory.\r
+  @param FvSize           Size of the FV.\r
+\r
+**/\r
+VOID\r
+ConvertPpiPointersFv (\r
+  IN  PEI_CORE_INSTANCE  *PrivateData,\r
+  IN  UINTN              OrgFvHandle,\r
+  IN  UINTN              FvHandle,\r
+  IN  UINTN              FvSize\r
+  );\r
+\r
+/**\r
+\r
+  Migrate PPI Pointers of PEI_CORE from temporary memory to permanent memory.\r
+\r
+  @param PrivateData      Pointer to PeiCore's private data structure.\r
+  @param CoreFvHandle     Address of PEI_CORE FV Handle in temporary memory.\r
+\r
+**/\r
+VOID\r
+ConvertPeiCorePpiPointers (\r
+  IN  PEI_CORE_INSTANCE   *PrivateData,\r
+  IN  PEI_CORE_FV_HANDLE  *CoreFvHandle\r
+  );\r
+\r
+/**\r
+\r
+  Dumps the PPI lists to debug output.\r
+\r
+  @param PrivateData     Points to PeiCore's private instance data.\r
+\r
+**/\r
+VOID\r
+DumpPpiList (\r
+  IN PEI_CORE_INSTANCE  *PrivateData\r
+  );\r
+\r
 /**\r
 \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
@@ -518,7 +636,7 @@ PeiLocatePpi (
 \r
   @retval EFI_SUCCESS           if successful\r
   @retval EFI_OUT_OF_RESOURCES  if no space in the database\r
-  @retval EFI_INVALID_PARAMETER if not a good decriptor\r
+  @retval EFI_INVALID_PARAMETER if not a good descriptor\r
 \r
 **/\r
 EFI_STATUS\r
@@ -536,13 +654,13 @@ PeiNotifyPpi (
 \r
 **/\r
 VOID\r
-ProcessNotifyList (\r
+ProcessDispatchNotifyList (\r
   IN PEI_CORE_INSTANCE  *PrivateData\r
   );\r
 \r
 /**\r
 \r
-  Dispatch notifications.\r
+  Process notifications.\r
 \r
   @param PrivateData        PeiCore's private data structure\r
   @param NotifyType         Type of notify to fire.\r
@@ -553,13 +671,13 @@ ProcessNotifyList (
 \r
 **/\r
 VOID\r
-DispatchNotify (\r
+ProcessNotify (\r
   IN PEI_CORE_INSTANCE  *PrivateData,\r
-  IN UINTN               NotifyType,\r
-  IN INTN                InstallStartIndex,\r
-  IN INTN                InstallStopIndex,\r
-  IN INTN                NotifyStartIndex,\r
-  IN INTN                NotifyStopIndex\r
+  IN UINTN              NotifyType,\r
+  IN INTN               InstallStartIndex,\r
+  IN INTN               InstallStopIndex,\r
+  IN INTN               NotifyStartIndex,\r
+  IN INTN               NotifyStopIndex\r
   );\r
 \r
 /**\r
@@ -572,13 +690,14 @@ DispatchNotify (
 **/\r
 VOID\r
 ProcessPpiListFromSec (\r
-  IN CONST EFI_PEI_SERVICES         **PeiServices,\r
-  IN CONST EFI_PEI_PPI_DESCRIPTOR   *PpiList\r
+  IN CONST EFI_PEI_SERVICES        **PeiServices,\r
+  IN CONST EFI_PEI_PPI_DESCRIPTOR  *PpiList\r
   );\r
 \r
 //\r
 // Boot mode support functions\r
 //\r
+\r
 /**\r
   This service enables PEIMs to ascertain the present value of the boot mode.\r
 \r
@@ -610,25 +729,26 @@ EFI_STATUS
 EFIAPI\r
 PeiSetBootMode (\r
   IN CONST EFI_PEI_SERVICES  **PeiServices,\r
-  IN EFI_BOOT_MODE     BootMode\r
+  IN EFI_BOOT_MODE           BootMode\r
   );\r
 \r
 //\r
 // Security support functions\r
 //\r
+\r
 /**\r
 \r
   Initialize the security services.\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
 InitializeSecurityServices (\r
-  IN EFI_PEI_SERVICES  **PeiServices,\r
-  IN PEI_CORE_INSTANCE *OldCoreData\r
+  IN EFI_PEI_SERVICES   **PeiServices,\r
+  IN PEI_CORE_INSTANCE  *OldCoreData\r
   );\r
 \r
 /**\r
@@ -650,7 +770,7 @@ VerifyFv (
 \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
@@ -659,10 +779,10 @@ VerifyFv (
 **/\r
 EFI_STATUS\r
 VerifyPeim (\r
-  IN PEI_CORE_INSTANCE      *PrivateData,\r
-  IN EFI_PEI_FV_HANDLE      VolumeHandle,\r
-  IN EFI_PEI_FILE_HANDLE    FileHandle,\r
-  IN UINT32                 AuthenticationStatus\r
+  IN PEI_CORE_INSTANCE    *PrivateData,\r
+  IN EFI_PEI_FV_HANDLE    VolumeHandle,\r
+  IN EFI_PEI_FILE_HANDLE  FileHandle,\r
+  IN UINT32               AuthenticationStatus\r
   );\r
 \r
 /**\r
@@ -682,7 +802,7 @@ EFI_STATUS
 EFIAPI\r
 PeiGetHobList (\r
   IN CONST EFI_PEI_SERVICES  **PeiServices,\r
-  IN OUT VOID          **HobList\r
+  IN OUT VOID                **HobList\r
   );\r
 \r
 /**\r
@@ -693,7 +813,7 @@ PeiGetHobList (
   @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
@@ -703,9 +823,9 @@ EFI_STATUS
 EFIAPI\r
 PeiCreateHob (\r
   IN CONST EFI_PEI_SERVICES  **PeiServices,\r
-  IN UINT16            Type,\r
-  IN UINT16            Length,\r
-  IN OUT VOID          **Hob\r
+  IN UINT16                  Type,\r
+  IN UINT16                  Length,\r
+  IN OUT VOID                **Hob\r
   );\r
 \r
 /**\r
@@ -738,14 +858,14 @@ PeiCoreBuildHobHandoffInfoTable (
 **/\r
 EFI_STATUS\r
 PeiInstallSecHobData (\r
-  IN CONST EFI_PEI_SERVICES     **PeiServices,\r
-  IN EFI_HOB_GENERIC_HEADER     *SecHobList\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices,\r
+  IN EFI_HOB_GENERIC_HEADER  *SecHobList\r
   );\r
 \r
-\r
 //\r
 // FFS Fw Volume support functions\r
 //\r
+\r
 /**\r
   Searches for the next matching file in the firmware volume.\r
 \r
@@ -765,10 +885,41 @@ PeiInstallSecHobData (
 EFI_STATUS\r
 EFIAPI\r
 PeiFfsFindNextFile (\r
-  IN CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN UINT8                       SearchType,\r
-  IN EFI_PEI_FV_HANDLE           FvHandle,\r
-  IN OUT EFI_PEI_FILE_HANDLE     *FileHandle\r
+  IN CONST EFI_PEI_SERVICES   **PeiServices,\r
+  IN UINT8                    SearchType,\r
+  IN EFI_PEI_FV_HANDLE        FvHandle,\r
+  IN OUT EFI_PEI_FILE_HANDLE  *FileHandle\r
+  );\r
+\r
+/**\r
+  Go through the file to search SectionType section.\r
+  Search within encapsulation sections (compression and GUIDed) recursively,\r
+  until the match section is found.\r
+\r
+  @param PeiServices          An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.\r
+  @param SectionType          Filter to find only section of this type.\r
+  @param SectionInstance      Pointer to the filter to find the specific instance of section.\r
+  @param Section              From where to search.\r
+  @param SectionSize          The file size to search.\r
+  @param OutputBuffer         A pointer to the discovered section, if successful.\r
+                              NULL if section not found.\r
+  @param AuthenticationStatus Updated upon return to point to the authentication status for this section.\r
+  @param IsFfs3Fv             Indicates the FV format.\r
+\r
+  @return EFI_NOT_FOUND       The match section is not found.\r
+  @return EFI_SUCCESS         The match section is found.\r
+\r
+**/\r
+EFI_STATUS\r
+ProcessSection (\r
+  IN CONST EFI_PEI_SERVICES     **PeiServices,\r
+  IN EFI_SECTION_TYPE           SectionType,\r
+  IN OUT UINTN                  *SectionInstance,\r
+  IN EFI_COMMON_SECTION_HEADER  *Section,\r
+  IN UINTN                      SectionSize,\r
+  OUT VOID                      **OutputBuffer,\r
+  OUT UINT32                    *AuthenticationStatus,\r
+  IN BOOLEAN                    IsFfs3Fv\r
   );\r
 \r
 /**\r
@@ -787,10 +938,10 @@ PeiFfsFindNextFile (
 EFI_STATUS\r
 EFIAPI\r
 PeiFfsFindSectionData (\r
-  IN CONST EFI_PEI_SERVICES    **PeiServices,\r
-  IN     EFI_SECTION_TYPE      SectionType,\r
-  IN     EFI_PEI_FILE_HANDLE   FileHandle,\r
-  OUT VOID                     **SectionData\r
+  IN CONST EFI_PEI_SERVICES   **PeiServices,\r
+  IN     EFI_SECTION_TYPE     SectionType,\r
+  IN     EFI_PEI_FILE_HANDLE  FileHandle,\r
+  OUT VOID                    **SectionData\r
   );\r
 \r
 /**\r
@@ -810,12 +961,12 @@ PeiFfsFindSectionData (
 EFI_STATUS\r
 EFIAPI\r
 PeiFfsFindSectionData3 (\r
-  IN CONST EFI_PEI_SERVICES    **PeiServices,\r
-  IN     EFI_SECTION_TYPE      SectionType,\r
-  IN     UINTN                 SectionInstance,\r
-  IN     EFI_PEI_FILE_HANDLE   FileHandle,\r
-  OUT VOID                     **SectionData,\r
-  OUT UINT32                   *AuthenticationStatus\r
+  IN CONST EFI_PEI_SERVICES   **PeiServices,\r
+  IN     EFI_SECTION_TYPE     SectionType,\r
+  IN     UINTN                SectionInstance,\r
+  IN     EFI_PEI_FILE_HANDLE  FileHandle,\r
+  OUT VOID                    **SectionData,\r
+  OUT UINT32                  *AuthenticationStatus\r
   );\r
 \r
 /**\r
@@ -834,14 +985,15 @@ PeiFfsFindSectionData3 (
 EFI_STATUS\r
 EFIAPI\r
 PeiFfsFindNextVolume (\r
-  IN CONST EFI_PEI_SERVICES          **PeiServices,\r
-  IN UINTN                           Instance,\r
-  IN OUT EFI_PEI_FV_HANDLE           *VolumeHandle\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices,\r
+  IN UINTN                   Instance,\r
+  IN OUT EFI_PEI_FV_HANDLE   *VolumeHandle\r
   );\r
 \r
 //\r
 // Memory support functions\r
 //\r
+\r
 /**\r
 \r
   Initialize the memory services.\r
@@ -850,7 +1002,7 @@ PeiFfsFindNextVolume (
   @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
@@ -875,9 +1027,9 @@ InitializeMemoryServices (
 EFI_STATUS\r
 EFIAPI\r
 PeiInstallPeiMemory (\r
-  IN CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN EFI_PHYSICAL_ADDRESS  MemoryBegin,\r
-  IN UINT64                MemoryLength\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices,\r
+  IN EFI_PHYSICAL_ADDRESS    MemoryBegin,\r
+  IN UINT64                  MemoryLength\r
   );\r
 \r
 /**\r
@@ -890,8 +1042,35 @@ PeiInstallPeiMemory (
 **/\r
 VOID\r
 MigrateMemoryPages (\r
-  IN PEI_CORE_INSTANCE      *Private,\r
-  IN BOOLEAN                TemporaryRamMigrated\r
+  IN PEI_CORE_INSTANCE  *Private,\r
+  IN BOOLEAN            TemporaryRamMigrated\r
+  );\r
+\r
+/**\r
+  Removes any FV HOBs whose base address is not in PEI installed memory.\r
+\r
+  @param[in] Private          Pointer to PeiCore's private data structure.\r
+\r
+**/\r
+VOID\r
+RemoveFvHobsInTemporaryMemory (\r
+  IN PEI_CORE_INSTANCE  *Private\r
+  );\r
+\r
+/**\r
+  Migrate the base address in firmware volume allocation HOBs\r
+  from temporary memory to PEI installed memory.\r
+\r
+  @param[in] PrivateData      Pointer to PeiCore's private data structure.\r
+  @param[in] OrgFvHandle      Address of FV Handle in temporary memory.\r
+  @param[in] FvHandle         Address of FV Handle in permanent memory.\r
+\r
+**/\r
+VOID\r
+ConvertFvHob (\r
+  IN PEI_CORE_INSTANCE  *PrivateData,\r
+  IN UINTN              OrgFvHandle,\r
+  IN UINTN              FvHandle\r
   );\r
 \r
 /**\r
@@ -903,7 +1082,7 @@ MigrateMemoryPages (
 **/\r
 VOID\r
 ConvertMemoryAllocationHobs (\r
-  IN PEI_CORE_INSTANCE          *PrivateData\r
+  IN PEI_CORE_INSTANCE  *PrivateData\r
   );\r
 \r
 /**\r
@@ -931,10 +1110,10 @@ ConvertMemoryAllocationHobs (
 EFI_STATUS\r
 EFIAPI\r
 PeiAllocatePages (\r
-  IN CONST EFI_PEI_SERVICES     **PeiServices,\r
-  IN       EFI_MEMORY_TYPE      MemoryType,\r
-  IN       UINTN                Pages,\r
-  OUT      EFI_PHYSICAL_ADDRESS *Memory\r
+  IN CONST EFI_PEI_SERVICES      **PeiServices,\r
+  IN       EFI_MEMORY_TYPE       MemoryType,\r
+  IN       UINTN                 Pages,\r
+  OUT      EFI_PHYSICAL_ADDRESS  *Memory\r
   );\r
 \r
 /**\r
@@ -953,9 +1132,9 @@ PeiAllocatePages (
 EFI_STATUS\r
 EFIAPI\r
 PeiFreePages (\r
-  IN CONST EFI_PEI_SERVICES     **PeiServices,\r
-  IN EFI_PHYSICAL_ADDRESS       Memory,\r
-  IN UINTN                      Pages\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices,\r
+  IN EFI_PHYSICAL_ADDRESS    Memory,\r
+  IN UINTN                   Pages\r
   );\r
 \r
 /**\r
@@ -975,9 +1154,9 @@ PeiFreePages (
 EFI_STATUS\r
 EFIAPI\r
 PeiAllocatePool (\r
-  IN CONST EFI_PEI_SERVICES           **PeiServices,\r
-  IN UINTN                      Size,\r
-  OUT VOID                      **Buffer\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices,\r
+  IN UINTN                   Size,\r
+  OUT VOID                   **Buffer\r
   );\r
 \r
 /**\r
@@ -998,11 +1177,11 @@ PeiAllocatePool (
 **/\r
 EFI_STATUS\r
 PeiLoadImage (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  EFI_PEI_FILE_HANDLE         FileHandle,\r
-  IN  UINT8                       PeimState,\r
-  OUT    EFI_PHYSICAL_ADDRESS     *EntryPoint,\r
-  OUT    UINT32                   *AuthenticationState\r
+  IN  CONST EFI_PEI_SERVICES   **PeiServices,\r
+  IN  EFI_PEI_FILE_HANDLE      FileHandle,\r
+  IN  UINT8                    PeimState,\r
+  OUT    EFI_PHYSICAL_ADDRESS  *EntryPoint,\r
+  OUT    UINT32                *AuthenticationState\r
   );\r
 \r
 /**\r
@@ -1024,12 +1203,12 @@ PeiLoadImage (
 EFI_STATUS\r
 EFIAPI\r
 PeiReportStatusCode (\r
-  IN CONST EFI_PEI_SERVICES         **PeiServices,\r
-  IN EFI_STATUS_CODE_TYPE     CodeType,\r
-  IN EFI_STATUS_CODE_VALUE    Value,\r
-  IN UINT32                   Instance,\r
-  IN CONST EFI_GUID                 *CallerId,\r
-  IN CONST EFI_STATUS_CODE_DATA     *Data OPTIONAL\r
+  IN CONST EFI_PEI_SERVICES      **PeiServices,\r
+  IN EFI_STATUS_CODE_TYPE        CodeType,\r
+  IN EFI_STATUS_CODE_VALUE       Value,\r
+  IN UINT32                      Instance,\r
+  IN CONST EFI_GUID              *CallerId,\r
+  IN CONST EFI_STATUS_CODE_DATA  *Data OPTIONAL\r
   );\r
 \r
 /**\r
@@ -1047,7 +1226,7 @@ PeiReportStatusCode (
 EFI_STATUS\r
 EFIAPI\r
 PeiResetSystem (\r
-  IN CONST EFI_PEI_SERVICES   **PeiServices\r
+  IN CONST EFI_PEI_SERVICES  **PeiServices\r
   );\r
 \r
 /**\r
@@ -1060,23 +1239,21 @@ PeiResetSystem (
                             the data buffer starts with a Null-terminated string, optionally\r
                             followed by additional binary data. The string is a description\r
                             that the caller may use to further indicate the reason for the\r
-                            system reset. ResetData is only valid if ResetStatus is something\r
-                            other than EFI_SUCCESS unless the ResetType is EfiResetPlatformSpecific\r
-                            where a minimum amount of ResetData is always required.\r
+                            system reset.\r
 \r
 **/\r
 VOID\r
 EFIAPI\r
 PeiResetSystem2 (\r
-  IN EFI_RESET_TYPE     ResetType,\r
-  IN EFI_STATUS         ResetStatus,\r
-  IN UINTN              DataSize,\r
-  IN VOID               *ResetData OPTIONAL\r
+  IN EFI_RESET_TYPE  ResetType,\r
+  IN EFI_STATUS      ResetStatus,\r
+  IN UINTN           DataSize,\r
+  IN VOID            *ResetData OPTIONAL\r
   );\r
 \r
 /**\r
 \r
-  Initialize PeiCore Fv List.\r
+  Initialize PeiCore FV List.\r
 \r
 \r
   @param PrivateData     - Pointer to PEI_CORE_INSTANCE.\r
@@ -1085,12 +1262,12 @@ PeiResetSystem2 (
 **/\r
 VOID\r
 PeiInitializeFv (\r
-  IN  PEI_CORE_INSTANCE           *PrivateData,\r
-  IN CONST EFI_SEC_PEI_HAND_OFF   *SecCoreData\r
+  IN  PEI_CORE_INSTANCE          *PrivateData,\r
+  IN CONST EFI_SEC_PEI_HAND_OFF  *SecCoreData\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
@@ -1101,10 +1278,10 @@ PeiInitializeFv (
 **/\r
 EFI_STATUS\r
 EFIAPI\r
-FirmwareVolmeInfoPpiNotifyCallback (\r
-  IN EFI_PEI_SERVICES              **PeiServices,\r
-  IN EFI_PEI_NOTIFY_DESCRIPTOR     *NotifyDescriptor,\r
-  IN VOID                          *Ppi\r
+FirmwareVolumeInfoPpiNotifyCallback (\r
+  IN EFI_PEI_SERVICES           **PeiServices,\r
+  IN EFI_PEI_NOTIFY_DESCRIPTOR  *NotifyDescriptor,\r
+  IN VOID                       *Ppi\r
   );\r
 \r
 /**\r
@@ -1123,9 +1300,9 @@ FirmwareVolmeInfoPpiNotifyCallback (
 EFI_STATUS\r
 EFIAPI\r
 PeiFfsFindFileByName (\r
-  IN  CONST EFI_GUID        *FileName,\r
-  IN  EFI_PEI_FV_HANDLE     VolumeHandle,\r
-  OUT EFI_PEI_FILE_HANDLE   *FileHandle\r
+  IN  CONST EFI_GUID       *FileName,\r
+  IN  EFI_PEI_FV_HANDLE    VolumeHandle,\r
+  OUT EFI_PEI_FILE_HANDLE  *FileHandle\r
   );\r
 \r
 /**\r
@@ -1182,8 +1359,8 @@ PeiFfsGetVolumeInfo (
   );\r
 \r
 /**\r
-  This routine enable a PEIM to register itself to shadow when PEI Foundation\r
-  discovery permanent memory.\r
+  This routine enables a PEIM to register itself for shadow when the PEI Foundation\r
+  discovers permanent memory.\r
 \r
   @param FileHandle             File handle of a PEIM.\r
 \r
@@ -1195,7 +1372,7 @@ PeiFfsGetVolumeInfo (
 EFI_STATUS\r
 EFIAPI\r
 PeiRegisterForShadow (\r
-  IN EFI_PEI_FILE_HANDLE       FileHandle\r
+  IN EFI_PEI_FILE_HANDLE  FileHandle\r
   );\r
 \r
 /**\r
@@ -1210,8 +1387,40 @@ PeiRegisterForShadow (
 **/\r
 VOID\r
 InitializeImageServices (\r
-  IN  PEI_CORE_INSTANCE   *PrivateData,\r
-  IN  PEI_CORE_INSTANCE   *OldCoreData\r
+  IN  PEI_CORE_INSTANCE  *PrivateData,\r
+  IN  PEI_CORE_INSTANCE  *OldCoreData\r
+  );\r
+\r
+/**\r
+  Loads and relocates a PE/COFF image in place.\r
+\r
+  @param Pe32Data         The base address of the PE/COFF file that is to be loaded and relocated\r
+  @param ImageAddress     The base address of the relocated PE/COFF image\r
+\r
+  @retval EFI_SUCCESS     The file was loaded and relocated\r
+  @retval Others          The file not be loaded and error occurred.\r
+\r
+**/\r
+EFI_STATUS\r
+LoadAndRelocatePeCoffImageInPlace (\r
+  IN  VOID  *Pe32Data,\r
+  IN  VOID  *ImageAddress\r
+  );\r
+\r
+/**\r
+  Find the PE32 Data for an FFS file.\r
+\r
+  @param FileHandle       Pointer to the FFS file header of the image.\r
+  @param Pe32Data         Pointer to a (VOID *) PE32 Data pointer.\r
+\r
+  @retval EFI_SUCCESS      Image is successfully loaded.\r
+  @retval EFI_NOT_FOUND    Fail to locate PE32 Data.\r
+\r
+**/\r
+EFI_STATUS\r
+PeiGetPe32Data (\r
+  IN     EFI_PEI_FILE_HANDLE  FileHandle,\r
+  OUT    VOID                 **Pe32Data\r
   );\r
 \r
 /**\r
@@ -1232,8 +1441,8 @@ EFIAPI
 PeiLoadImageLoadImageWrapper (\r
   IN     CONST EFI_PEI_LOAD_FILE_PPI  *This,\r
   IN     EFI_PEI_FILE_HANDLE          FileHandle,\r
-  OUT    EFI_PHYSICAL_ADDRESS         *ImageAddressArg,  OPTIONAL\r
-  OUT    UINT64                       *ImageSizeArg,     OPTIONAL\r
+  OUT    EFI_PHYSICAL_ADDRESS         *ImageAddressArg   OPTIONAL,\r
+  OUT    UINT64                       *ImageSizeArg      OPTIONAL,\r
   OUT    EFI_PHYSICAL_ADDRESS         *EntryPoint,\r
   OUT    UINT32                       *AuthenticationState\r
   );\r
@@ -1258,11 +1467,11 @@ SecurityPpiNotifyCallback (
   );\r
 \r
 /**\r
-  Get Fv image from the FV type file, then install FV INFO(2) ppi, Build FV 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
@@ -1273,18 +1482,19 @@ SecurityPpiNotifyCallback (
 **/\r
 EFI_STATUS\r
 ProcessFvFile (\r
-  IN  PEI_CORE_INSTANCE           *PrivateData,\r
-  IN  PEI_CORE_FV_HANDLE          *ParentFvCoreHandle,\r
-  IN  EFI_PEI_FILE_HANDLE         ParentFvFileHandle\r
+  IN  PEI_CORE_INSTANCE    *PrivateData,\r
+  IN  PEI_CORE_FV_HANDLE   *ParentFvCoreHandle,\r
+  IN  EFI_PEI_FILE_HANDLE  ParentFvFileHandle\r
   );\r
 \r
 /**\r
-  Get instance of PEI_CORE_FV_HANDLE for next volume according to given index.\r
+  Gets a PEI_CORE_FV_HANDLE instance for the next volume according to the given index.\r
 \r
-  This routine also will install FvInfo ppi for FV hob in PI ways.\r
+  This routine also will install an instance of the FvInfo PPI for the FV HOB\r
+  as defined in the PI specification.\r
 \r
   @param Private    Pointer of PEI_CORE_INSTANCE\r
-  @param Instance   The index of FV want to be searched.\r
+  @param Instance   Index of the FV to search\r
 \r
   @return Instance of PEI_CORE_FV_HANDLE.\r
 **/\r
@@ -1320,12 +1530,12 @@ FindNextCoreFvHandle (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultMemRead (\r
-  IN  CONST EFI_PEI_SERVICES            **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI          *This,\r
-  IN  EFI_PEI_CPU_IO_PPI_WIDTH          Width,\r
-  IN  UINT64                            Address,\r
-  IN  UINTN                             Count,\r
-  IN  OUT VOID                          *Buffer\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  EFI_PEI_CPU_IO_PPI_WIDTH  Width,\r
+  IN  UINT64                    Address,\r
+  IN  UINTN                     Count,\r
+  IN  OUT VOID                  *Buffer\r
   );\r
 \r
 /**\r
@@ -1350,12 +1560,12 @@ PeiDefaultMemRead (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultMemWrite (\r
-  IN  CONST EFI_PEI_SERVICES            **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI          *This,\r
-  IN  EFI_PEI_CPU_IO_PPI_WIDTH          Width,\r
-  IN  UINT64                            Address,\r
-  IN  UINTN                             Count,\r
-  IN  OUT VOID                          *Buffer\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  EFI_PEI_CPU_IO_PPI_WIDTH  Width,\r
+  IN  UINT64                    Address,\r
+  IN  UINTN                     Count,\r
+  IN  OUT VOID                  *Buffer\r
   );\r
 \r
 /**\r
@@ -1379,12 +1589,12 @@ PeiDefaultMemWrite (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultIoRead (\r
-  IN      CONST EFI_PEI_SERVICES          **PeiServices,\r
-  IN      CONST EFI_PEI_CPU_IO_PPI        *This,\r
-  IN      EFI_PEI_CPU_IO_PPI_WIDTH        Width,\r
-  IN      UINT64                          Address,\r
-  IN      UINTN                           Count,\r
-  IN OUT  VOID                            *Buffer\r
+  IN      CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN      CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN      EFI_PEI_CPU_IO_PPI_WIDTH  Width,\r
+  IN      UINT64                    Address,\r
+  IN      UINTN                     Count,\r
+  IN OUT  VOID                      *Buffer\r
   );\r
 \r
 /**\r
@@ -1408,12 +1618,12 @@ PeiDefaultIoRead (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultIoWrite (\r
-  IN      CONST EFI_PEI_SERVICES          **PeiServices,\r
-  IN      CONST EFI_PEI_CPU_IO_PPI        *This,\r
-  IN      EFI_PEI_CPU_IO_PPI_WIDTH        Width,\r
-  IN      UINT64                          Address,\r
-  IN      UINTN                           Count,\r
-  IN OUT  VOID                            *Buffer\r
+  IN      CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN      CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN      EFI_PEI_CPU_IO_PPI_WIDTH  Width,\r
+  IN      UINT64                    Address,\r
+  IN      UINTN                     Count,\r
+  IN OUT  VOID                      *Buffer\r
   );\r
 \r
 /**\r
@@ -1431,9 +1641,9 @@ PeiDefaultIoWrite (
 UINT8\r
 EFIAPI\r
 PeiDefaultIoRead8 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1451,9 +1661,9 @@ PeiDefaultIoRead8 (
 UINT16\r
 EFIAPI\r
 PeiDefaultIoRead16 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1471,9 +1681,9 @@ PeiDefaultIoRead16 (
 UINT32\r
 EFIAPI\r
 PeiDefaultIoRead32 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1491,9 +1701,9 @@ PeiDefaultIoRead32 (
 UINT64\r
 EFIAPI\r
 PeiDefaultIoRead64 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1507,10 +1717,10 @@ PeiDefaultIoRead64 (
 VOID\r
 EFIAPI\r
 PeiDefaultIoWrite8 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address,\r
-  IN  UINT8                       Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT8                     Data\r
   );\r
 \r
 /**\r
@@ -1524,10 +1734,10 @@ PeiDefaultIoWrite8 (
 VOID\r
 EFIAPI\r
 PeiDefaultIoWrite16 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address,\r
-  IN  UINT16                      Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT16                    Data\r
   );\r
 \r
 /**\r
@@ -1541,10 +1751,10 @@ PeiDefaultIoWrite16 (
 VOID\r
 EFIAPI\r
 PeiDefaultIoWrite32 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address,\r
-  IN  UINT32                      Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT32                    Data\r
   );\r
 \r
 /**\r
@@ -1558,10 +1768,10 @@ PeiDefaultIoWrite32 (
 VOID\r
 EFIAPI\r
 PeiDefaultIoWrite64 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address,\r
-  IN  UINT64                      Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT64                    Data\r
   );\r
 \r
 /**\r
@@ -1580,9 +1790,9 @@ PeiDefaultIoWrite64 (
 UINT8\r
 EFIAPI\r
 PeiDefaultMemRead8 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1601,9 +1811,9 @@ PeiDefaultMemRead8 (
 UINT16\r
 EFIAPI\r
 PeiDefaultMemRead16 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1622,9 +1832,9 @@ PeiDefaultMemRead16 (
 UINT32\r
 EFIAPI\r
 PeiDefaultMemRead32 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1643,9 +1853,9 @@ PeiDefaultMemRead32 (
 UINT64\r
 EFIAPI\r
 PeiDefaultMemRead64 (\r
-  IN  CONST EFI_PEI_SERVICES      **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI    *This,\r
-  IN  UINT64                      Address\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address\r
   );\r
 \r
 /**\r
@@ -1660,10 +1870,10 @@ PeiDefaultMemRead64 (
 VOID\r
 EFIAPI\r
 PeiDefaultMemWrite8 (\r
-  IN  CONST EFI_PEI_SERVICES        **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI      *This,\r
-  IN  UINT64                        Address,\r
-  IN  UINT8                         Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT8                     Data\r
   );\r
 \r
 /**\r
@@ -1678,10 +1888,10 @@ PeiDefaultMemWrite8 (
 VOID\r
 EFIAPI\r
 PeiDefaultMemWrite16 (\r
-  IN  CONST EFI_PEI_SERVICES        **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI      *This,\r
-  IN  UINT64                        Address,\r
-  IN  UINT16                        Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT16                    Data\r
   );\r
 \r
 /**\r
@@ -1696,10 +1906,10 @@ PeiDefaultMemWrite16 (
 VOID\r
 EFIAPI\r
 PeiDefaultMemWrite32 (\r
-  IN  CONST EFI_PEI_SERVICES        **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI      *This,\r
-  IN  UINT64                        Address,\r
-  IN  UINT32                        Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT32                    Data\r
   );\r
 \r
 /**\r
@@ -1714,13 +1924,13 @@ PeiDefaultMemWrite32 (
 VOID\r
 EFIAPI\r
 PeiDefaultMemWrite64 (\r
-  IN  CONST EFI_PEI_SERVICES        **PeiServices,\r
-  IN  CONST EFI_PEI_CPU_IO_PPI      *This,\r
-  IN  UINT64                        Address,\r
-  IN  UINT64                        Data\r
+  IN  CONST EFI_PEI_SERVICES    **PeiServices,\r
+  IN  CONST EFI_PEI_CPU_IO_PPI  *This,\r
+  IN  UINT64                    Address,\r
+  IN  UINT64                    Data\r
   );\r
 \r
-extern EFI_PEI_CPU_IO_PPI gPeiDefaultCpuIoPpi;\r
+extern EFI_PEI_CPU_IO_PPI  gPeiDefaultCpuIoPpi;\r
 \r
 //\r
 // Default EFI_PEI_PCI_CFG2_PPI support for EFI_PEI_SERVICES table when PeiCore initialization.\r
@@ -1748,11 +1958,11 @@ extern EFI_PEI_CPU_IO_PPI gPeiDefaultCpuIoPpi;
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultPciCfg2Read (\r
-  IN CONST  EFI_PEI_SERVICES          **PeiServices,\r
-  IN CONST  EFI_PEI_PCI_CFG2_PPI      *This,\r
-  IN        EFI_PEI_PCI_CFG_PPI_WIDTH Width,\r
-  IN        UINT64                    Address,\r
-  IN OUT    VOID                      *Buffer\r
+  IN CONST  EFI_PEI_SERVICES           **PeiServices,\r
+  IN CONST  EFI_PEI_PCI_CFG2_PPI       *This,\r
+  IN        EFI_PEI_PCI_CFG_PPI_WIDTH  Width,\r
+  IN        UINT64                     Address,\r
+  IN OUT    VOID                       *Buffer\r
   );\r
 \r
 /**\r
@@ -1776,11 +1986,11 @@ PeiDefaultPciCfg2Read (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultPciCfg2Write (\r
-  IN CONST  EFI_PEI_SERVICES          **PeiServices,\r
-  IN CONST  EFI_PEI_PCI_CFG2_PPI      *This,\r
-  IN        EFI_PEI_PCI_CFG_PPI_WIDTH Width,\r
-  IN        UINT64                    Address,\r
-  IN OUT    VOID                      *Buffer\r
+  IN CONST  EFI_PEI_SERVICES           **PeiServices,\r
+  IN CONST  EFI_PEI_PCI_CFG2_PPI       *This,\r
+  IN        EFI_PEI_PCI_CFG_PPI_WIDTH  Width,\r
+  IN        UINT64                     Address,\r
+  IN OUT    VOID                       *Buffer\r
   );\r
 \r
 /**\r
@@ -1805,15 +2015,15 @@ PeiDefaultPciCfg2Write (
 EFI_STATUS\r
 EFIAPI\r
 PeiDefaultPciCfg2Modify (\r
-  IN CONST  EFI_PEI_SERVICES          **PeiServices,\r
-  IN CONST  EFI_PEI_PCI_CFG2_PPI      *This,\r
-  IN        EFI_PEI_PCI_CFG_PPI_WIDTH Width,\r
-  IN        UINT64                    Address,\r
-  IN        VOID                      *SetBits,\r
-  IN        VOID                      *ClearBits\r
+  IN CONST  EFI_PEI_SERVICES           **PeiServices,\r
+  IN CONST  EFI_PEI_PCI_CFG2_PPI       *This,\r
+  IN        EFI_PEI_PCI_CFG_PPI_WIDTH  Width,\r
+  IN        UINT64                     Address,\r
+  IN        VOID                       *SetBits,\r
+  IN        VOID                       *ClearBits\r
   );\r
 \r
-extern EFI_PEI_PCI_CFG2_PPI gPeiDefaultPciCfg2Ppi;\r
+extern EFI_PEI_PCI_CFG2_PPI  gPeiDefaultPciCfg2Ppi;\r
 \r
 /**\r
   After PeiCore image is shadowed into permanent memory, all build-in FvPpi should\r
@@ -1825,7 +2035,7 @@ extern EFI_PEI_PCI_CFG2_PPI gPeiDefaultPciCfg2Ppi;
 **/\r
 VOID\r
 PeiReinitializeFv (\r
-  IN  PEI_CORE_INSTANCE           *PrivateData\r
+  IN  PEI_CORE_INSTANCE  *PrivateData\r
   );\r
 \r
 #endif\r