]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/Bis.h
Clean the Bis.h
[mirror_edk2.git] / MdePkg / Include / Protocol / Bis.h
index 138a3270fa6238b54fc39ab38ce66c8524fcf31d..ab16ada035e0c1c270e4f607c432f634112c3ddb 100644 (file)
@@ -10,8 +10,6 @@
   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:  Bis.h\r
-\r
 **/\r
 \r
 #ifndef __BIS_H__\r
     0x0b64aab0, 0x5429, 0x11d4, {0x98, 0x16, 0x00, 0xa0, 0xc9, 0x1f, 0xad, 0xcf } \\r
   }\r
 \r
+//\r
+// X-Intel-BIS-ParameterSet\r
+// Attribute value\r
+// Binary Value of X-Intel-BIS-ParameterSet Attribute.\r
+// (Value is Base-64 encoded in actual signed manifest).\r
+//\r
+#define BOOT_OBJECT_AUTHORIZATION_PARMSET_GUID \\r
+  { \\r
+    0xedd35e31, 0x7b9, 0x11d2, { 0x83,0xa3,0x0,0xa0,0xc9,0x1f,0xad,0xcf } \\r
+  }\r
+\r
+\r
+\r
 typedef struct _EFI_BIS_PROTOCOL  EFI_BIS_PROTOCOL;\r
 \r
 \r
@@ -103,19 +114,6 @@ typedef struct {
 //\r
 #define BIS_GET_SIGINFO_ARRAY(BisDataPtr) ((EFI_BIS_SIGNATURE_INFO *) (BisDataPtr)->Data)\r
 \r
-//\r
-// Binary Value of "X-Intel-BIS-ParameterSet" Attribute.\r
-// (Value is Base64 encoded in actual signed manifest).\r
-// {EDD35E31-07B9-11d2-83A3-00A0C91FADCF}\r
-//\r
-#define BOOT_OBJECT_AUTHORIZATION_PARMSET_GUID \\r
-  { \\r
-    0xedd35e31, 0x7b9, 0x11d2, \\r
-    { \\r
-      0x83, 0xa3, 0x0, 0xa0, 0xc9, 0x1f, 0xad, 0xcf \\r
-    } \\r
-  }\r
-\r
 //\r
 // Support old name for backward compatible\r
 //\r
@@ -161,7 +159,7 @@ EFI_STATUS
 /**                                                                 \r
   Frees memory structures allocated and returned by other functions in the EFI_BIS protocol.  \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                         \r
   @param  ToFree                   An EFI_BIS_DATA* and associated memory block to be freed.\r
 \r
@@ -181,10 +179,10 @@ EFI_STATUS
   );\r
 \r
 /**                                                                 \r
-  Shuts down an application¡¯s instance of the BIS service, invalidating the application handle. After\r
+  Shuts down an application's instance of the BIS service, invalidating the application handle. After\r
   this call, other BIS functions may no longer be invoked using the application handle value.         \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
 \r
   @retval EFI_SUCCESS              The function completed successfully.\r
@@ -204,7 +202,7 @@ EFI_STATUS
   Retrieves the certificate that has been configured as the identity of the organization designated as\r
   the source of authorization for signatures of boot objects.\r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  Certificate              The function writes an allocated EFI_BIS_DATA* containing the Boot\r
                                    Object Authorization Certificate object.                            \r
@@ -229,7 +227,7 @@ EFI_STATUS
   Verifies the integrity and authorization of the indicated data object according to the\r
   indicated credentials.                                                                \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  Credentials              A Signed Manifest containing verification information for the indicated\r
                                    data object.                                                            \r
@@ -259,7 +257,7 @@ EFI_STATUS
 /**                                                                 \r
   Retrieves the current status of the Boot Authorization Check Flag.\r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  CheckIsRequired          The function writes the value TRUE if a Boot Authorization Check is\r
                                    currently required on this platform, otherwise the function writes \r
@@ -284,7 +282,7 @@ EFI_STATUS
   Retrieves a unique token value to be included in the request credential for the next update of any\r
   parameter in the Boot Object Authorization set                                                    \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  UpdateToken              The function writes an allocated EFI_BIS_DATA* containing the new\r
                                    unique update token value.                                                                          \r
@@ -308,7 +306,7 @@ EFI_STATUS
 /**                                                                 \r
   Updates one of the configurable parameters of the Boot Object Authorization set.\r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  RequestCredential        This is a Signed Manifest with embedded attributes that carry the details\r
                                    of the requested update.                                                 \r
@@ -337,7 +335,7 @@ EFI_STATUS
   Verifies the integrity and authorization of the indicated data object according to the indicated\r
   credentials and authority certificate.                                                          \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  Credentials              A Signed Manifest containing verification information for the\r
                                    indicated data object.                                       \r
@@ -345,7 +343,7 @@ EFI_STATUS
   @param  SectionName              An ASCII (not Unicode) string giving the section name in the  \r
                                    manifest holding the verification information (in other words,\r
                                    hash value) that corresponds to DataObject.                             \r
-  @param  AuthorityCertificate     A digital certificate whose public key must match the signer¡¯s                              \r
+  @param  AuthorityCertificate     A digital certificate whose public key must match the signer's                              \r
                                    public key which is found in the credentials.                  \r
   @param  IsVerified               The function writes TRUE if the verification was successful.\r
                                    Otherwise, the function writes FALSE.                       \r
@@ -377,7 +375,7 @@ EFI_STATUS
   Retrieves a list of digital certificate identifier, digital signature algorithm, hash algorithm, and keylength\r
   combinations that the platform supports.                                                                      \r
       \r
-  @param  AppHandle                An opaque handle that identifies the caller¡¯s instance of initialization\r
+  @param  AppHandle                An opaque handle that identifies the caller's instance of initialization\r
                                    of the BIS service.                                                                                           \r
   @param  SignatureInfo            The function writes an allocated EFI_BIS_DATA* containing the array\r
                                    of EFI_BIS_SIGNATURE_INFO structures representing the supported    \r