1. Enable use-cases in PEI using SecurityPPI co-equal to the use-cases in DXE using...

[mirror_edk2.git] / MdePkg / Include / Library / PeiServicesLib.h

diff --git a/MdePkg/Include/Library/PeiServicesLib.h b/MdePkg/Include/Library/PeiServicesLib.h
index 358c9cddf511dc600561105e3f4316b96991b880..2b51d374c9b4056e383bf2913049e408107f7ecc 100644 (file)
--- a/MdePkg/Include/Library/PeiServicesLib.h
+++ b/MdePkg/Include/Library/PeiServicesLib.h
@@ -220,6 +220,30 @@ PeiServicesFfsFindSectionData (
   OUT VOID                      **SectionData\r
   );\r
 \r
+/**\r
+  This service enables PEIMs to discover sections of a given instance and type within a valid FFS file.\r
+\r
+  @param  SectionType           The value of the section type to find.\r
+  @param  SectionInstance       Section instance to find.\r
+  @param  FileHandle            A pointer to the file header that contains the set \r
+                                of sections to be searched.\r
+  @param  SectionData           A pointer to the discovered section, if successful.\r
+  @param  AuthenticationStatus  A pointer to the authentication status for this section.\r
+\r
+  @retval EFI_SUCCESS           The section was found.\r
+  @retval EFI_NOT_FOUND         The section was not found.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesFfsFindSectionData3 (\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
   This service enables PEIMs to register the permanent memory configuration\r
   that has been initialized with the PEI Foundation.\r
@@ -348,6 +372,31 @@ PeiServicesFfsGetFileInfo (
   OUT EFI_FV_FILE_INFO            *FileInfo\r
   );\r
 \r
+/**\r
+  This service is a wrapper for the PEI Service FfsGetFileInfo2(), except the pointer to the PEI Services\r
+  Table has been removed. See the Platform Initialization Pre-EFI Initialization Core Interface\r
+  Specification for details.\r
+\r
+  @param FileHandle   Handle of the file.\r
+\r
+  @param FileInfo     Upon exit, points to the file's\r
+                      information.\r
+\r
+  @retval EFI_SUCCESS             File information returned.\r
+  \r
+  @retval EFI_INVALID_PARAMETER   If FileHandle does not\r
+                                  represent a valid file.\r
+  \r
+  @retval EFI_INVALID_PARAMETER   If FileInfo is NULL.\r
+  \r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+PeiServicesFfsGetFileInfo2 (\r
+  IN CONST  EFI_PEI_FILE_HANDLE   FileHandle,\r
+  OUT EFI_FV_FILE_INFO2           *FileInfo\r
+  );\r
+\r
 /**\r
   This service is a wrapper for the PEI Service FfsGetVolumeInfo(), except the pointer to the PEI Services \r
   Table has been removed.  See the Platform Initialization Pre-EFI Initialization Core Interface \r
@@ -431,4 +480,45 @@ PeiServicesInstallFvInfoPpi (
   IN CONST EFI_GUID                *ParentFileName OPTIONAL\r
   );\r
 \r
+/**\r
+  Install a EFI_PEI_FIRMWARE_VOLUME_INFO2_PPI instance so the PEI Core will be notified about a new firmware volume.\r
+\r
+  This function allocates, initializes, and installs a new EFI_PEI_FIRMWARE_VOLUME_INFO2_PPI using\r
+  the parameters passed in to initialize the fields of the EFI_PEI_FIRMWARE_VOLUME_INFO2_PPI instance.\r
+  If the resources can not be allocated for EFI_PEI_FIRMWARE_VOLUME_INFO2_PPI, then ASSERT().\r
+  If the EFI_PEI_FIRMWARE_VOLUME_INFO2_PPI can not be installed, then ASSERT().\r
+\r
+  @param  FvFormat             Unique identifier of the format of the memory-mapped\r
+                               firmware volume.  This parameter is optional and\r
+                               may be NULL.  If NULL is specified, the\r
+                               EFI_FIRMWARE_FILE_SYSTEM2_GUID format is assumed.\r
+  @param  FvInfo               Points to a buffer which allows the\r
+                               EFI_PEI_FIRMWARE_VOLUME_PPI to process the volume.\r
+                               The format of this buffer is specific to the FvFormat.\r
+                               For memory-mapped firmware volumes, this typically\r
+                               points to the first byte of the firmware volume.\r
+  @param  FvInfoSize           The size, in bytes, of FvInfo. For memory-mapped\r
+                               firmware volumes, this is typically the size of\r
+                               the firmware volume.\r
+  @param  ParentFvName         If the new firmware volume originated from a file\r
+                               in a different firmware volume, then this parameter\r
+                               specifies the GUID name of the originating firmware\r
+                               volume. Otherwise, this parameter must be NULL.\r
+  @param  ParentFileName       If the new firmware volume originated from a file\r
+                               in a different firmware volume, then this parameter\r
+                               specifies the GUID file name of the originating\r
+                               firmware file. Otherwise, this parameter must be NULL.\r
+  @param  AuthenticationStatus Authentication Status\r
+**/\r
+VOID\r
+EFIAPI\r
+PeiServicesInstallFvInfo2Ppi (\r
+  IN CONST EFI_GUID                *FvFormat, OPTIONAL\r
+  IN CONST VOID                    *FvInfo,\r
+  IN       UINT32                  FvInfoSize,\r
+  IN CONST EFI_GUID                *ParentFvName, OPTIONAL\r
+  IN CONST EFI_GUID                *ParentFileName, OPTIONAL\r
+  IN       UINT32                  AuthenticationStatus\r
+  );\r
+\r
 #endif\r