]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Library/PeiServicesLib/PeiServicesLib.c
Merge branch of PI tree to main trunk
[mirror_edk2.git] / MdePkg / Library / PeiServicesLib / PeiServicesLib.c
index e64618de21845511974914f7dc6f64b684e16064..29aaaaa235e94196df250f554ba0cb75895686f4 100644 (file)
@@ -1,21 +1,26 @@
 /** @file\r
   Implementation for PEI Services Library.\r
 \r
-  Copyright (c) 2006, Intel Corporation<BR>\r
-  All rights reserved. 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
+  Copyright (c) 2006 - 2007, Intel Corporation<BR>\r
+  All rights reserved. This program and the accompanying materials\r
+  are licensed and made available under the terms and conditions of the BSD License\r
+  which accompanies this distribution.  The full text of the license may be found at\r
+  http://opensource.org/licenses/bsd-license.php\r
 \r
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
-\r
-  Module Name:  PeiServicesLib.c\r
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
 **/\r
 \r
+\r
+#include <PiPei.h>\r
+\r
+\r
+#include <Library/PeiServicesLib.h>\r
+#include <Library/PeiServicesTablePointerLib.h>\r
+\r
 /**\r
-  This service enables a given PEIM to register an interface into the PEI Foundation. \r
+  This service enables a given PEIM to register an interface into the PEI Foundation.\r
 \r
   @param  PpiList               A pointer to the list of interfaces that the caller shall install.\r
 \r
 EFI_STATUS\r
 EFIAPI\r
 PeiServicesInstallPpi (\r
-  IN EFI_PEI_PPI_DESCRIPTOR     *PpiList\r
+  IN CONST EFI_PEI_PPI_DESCRIPTOR     *PpiList\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES  **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES  **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->InstallPpi (PeiServices, PpiList);\r
 }\r
 \r
@@ -56,13 +61,13 @@ PeiServicesInstallPpi (
 EFI_STATUS\r
 EFIAPI\r
 PeiServicesReInstallPpi (\r
-  IN EFI_PEI_PPI_DESCRIPTOR     *OldPpi,\r
-  IN EFI_PEI_PPI_DESCRIPTOR     *NewPpi\r
+  IN CONST EFI_PEI_PPI_DESCRIPTOR     *OldPpi,\r
+  IN CONST EFI_PEI_PPI_DESCRIPTOR     *NewPpi\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->ReInstallPpi (PeiServices, OldPpi, NewPpi);\r
 }\r
 \r
@@ -82,15 +87,15 @@ PeiServicesReInstallPpi (
 EFI_STATUS\r
 EFIAPI\r
 PeiServicesLocatePpi (\r
-  IN EFI_GUID                   *Guid,\r
+  IN CONST EFI_GUID                   *Guid,\r
   IN UINTN                      Instance,\r
   IN OUT EFI_PEI_PPI_DESCRIPTOR **PpiDescriptor,\r
   IN OUT VOID                   **Ppi\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->LocatePpi (PeiServices, Guid, Instance, PpiDescriptor, Ppi);\r
 }\r
 \r
@@ -111,17 +116,17 @@ PeiServicesLocatePpi (
 EFI_STATUS\r
 EFIAPI\r
 PeiServicesNotifyPpi (\r
-  IN EFI_PEI_NOTIFY_DESCRIPTOR  *NotifyList\r
+  IN CONST EFI_PEI_NOTIFY_DESCRIPTOR  *NotifyList\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->NotifyPpi (PeiServices, NotifyList);\r
 }\r
 \r
 /**\r
-  This service enables PEIMs to ascertain the present value of the boot mode.  \r
+  This service enables PEIMs to ascertain the present value of the boot mode.\r
 \r
   @param  BootMode              A pointer to contain the value of the boot mode.\r
 \r
@@ -135,14 +140,14 @@ PeiServicesGetBootMode (
   IN OUT EFI_BOOT_MODE          *BootMode\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->GetBootMode (PeiServices, BootMode);\r
 }\r
 \r
 /**\r
-  This service enables PEIMs to update the boot mode variable.    \r
+  This service enables PEIMs to update the boot mode variable.\r
 \r
   @param  BootMode              The value of the boot mode to set.\r
 \r
@@ -155,9 +160,9 @@ PeiServicesSetBootMode (
   IN EFI_BOOT_MODE              BootMode\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->SetBootMode (PeiServices, BootMode);\r
 }\r
 \r
@@ -176,9 +181,9 @@ PeiServicesGetHobList (
   IN OUT VOID                   **HobList\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->GetHobList (PeiServices, HobList);\r
 }\r
 \r
@@ -201,9 +206,9 @@ PeiServicesCreateHob (
   IN OUT VOID                   **Hob\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->CreateHob (PeiServices, Type, Length, Hob);\r
 }\r
 \r
@@ -223,13 +228,13 @@ EFI_STATUS
 EFIAPI\r
 PeiServicesFfsFindNextVolume (\r
   IN UINTN                          Instance,\r
-  IN OUT EFI_FIRMWARE_VOLUME_HEADER **FwVolHeader\r
+  IN OUT EFI_PEI_FV_HANDLE          *VolumeHandle\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
-  return (*PeiServices)->FfsFindNextVolume (PeiServices, Instance, FwVolHeader);\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
+  return (*PeiServices)->FfsFindNextVolume (PeiServices, Instance, VolumeHandle);\r
 }\r
 \r
 /**\r
@@ -249,14 +254,14 @@ EFI_STATUS
 EFIAPI\r
 PeiServicesFfsFindNextFile (\r
   IN EFI_FV_FILETYPE            SearchType,\r
-  IN EFI_FIRMWARE_VOLUME_HEADER *FwVolHeader,\r
-  IN OUT EFI_FFS_FILE_HEADER    **FileHeader\r
+  IN EFI_PEI_FV_HANDLE          VolumeHandle,\r
+  IN OUT EFI_PEI_FILE_HANDLE    *FileHandle\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
-  return (*PeiServices)->FfsFindNextFile (PeiServices, SearchType, FwVolHeader, FileHeader);\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
+  return (*PeiServices)->FfsFindNextFile (PeiServices, SearchType, VolumeHandle, FileHandle);\r
 }\r
 \r
 /**\r
@@ -275,13 +280,13 @@ EFI_STATUS
 EFIAPI\r
 PeiServicesFfsFindSectionData (\r
   IN EFI_SECTION_TYPE           SectionType,\r
-  IN EFI_FFS_FILE_HEADER        *FfsFileHeader,\r
+  IN EFI_PEI_FILE_HANDLE        FfsFileHeader,\r
   IN OUT VOID                   **SectionData\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->FfsFindSectionData (PeiServices, SectionType, FfsFileHeader, SectionData);\r
 }\r
 \r
@@ -304,9 +309,9 @@ PeiServicesInstallPeiMemory (
   IN UINT64                     MemoryLength\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->InstallPeiMemory (PeiServices, MemoryBegin, MemoryLength);\r
 }\r
 \r
@@ -332,9 +337,9 @@ PeiServicesAllocatePages (
   IN OUT EFI_PHYSICAL_ADDRESS   *Memory\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->AllocatePages (PeiServices, MemoryType, Pages, Memory);\r
 }\r
 \r
@@ -356,15 +361,15 @@ PeiServicesAllocatePool (
   OUT VOID                      **Buffer\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
-  PeiServices = GetPeiServicesTablePointer ();\r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
   return (*PeiServices)->AllocatePool (PeiServices, Size, Buffer);\r
 }\r
 \r
 /**\r
   This service resets the entire platform, including all processors and devices, and reboots the\r
-  system. \r
+  system.\r
 \r
   @retval EFI_NOT_AVAILABLE_YET The service has not been installed yet.\r
 \r
@@ -375,8 +380,57 @@ PeiServicesResetSystem (
   VOID\r
   )\r
 {\r
-  EFI_PEI_SERVICES  **PeiServices;\r
-  \r
+  CONST EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = (CONST EFI_PEI_SERVICES **) GetPeiServicesTablePointer ();\r
+  return (*PeiServices)->ResetSystem (PeiServices);\r
+}\r
+\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesRegisterForShadow (\r
+  IN  EFI_PEI_FILE_HANDLE FileHandle\r
+  )\r
+{\r
+  EFI_PEI_SERVICES **PeiServices;\r
+\r
+  PeiServices = GetPeiServicesTablePointer ();\r
+  return (*PeiServices)->RegisterForShadow (FileHandle);\r
+}\r
+\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesFfsGetFileInfo (\r
+  IN CONST  EFI_PEI_FILE_HANDLE   FileHandle,\r
+  OUT EFI_FV_FILE_INFO            *FileInfo\r
+  )\r
+{\r
+  EFI_PEI_SERVICES **PeiServices;\r
+\r
   PeiServices = GetPeiServicesTablePointer ();\r
-  return (*PeiServices)->PeiResetSystem (PeiServices);\r
+  return (*PeiServices)->FfsGetFileInfo (FileHandle, FileInfo);\r
+}\r
+\r
+\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesFfsFindFileByName (\r
+  IN CONST  EFI_GUID            *FileName,\r
+  IN CONST  EFI_PEI_FV_HANDLE   VolumeHandle,\r
+  OUT       EFI_PEI_FILE_HANDLE *FileHandle\r
+  )\r
+{\r
+  return (*GetPeiServicesTablePointer())->FfsFindFileByName (FileName, VolumeHandle, FileHandle);\r
 }\r
+\r
+\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesFfsGetVolumeInfo (\r
+  IN  EFI_PEI_FV_HANDLE       VolumeHandle,\r
+  OUT EFI_FV_INFO             *VolumeInfo\r
+  )\r
+{\r
+  return (*GetPeiServicesTablePointer())->FfsGetVolumeInfo (VolumeHandle, VolumeInfo);\r
+}\r
+\r