Update firmware management protocol definition to expose the lowest supported firmwar...

[mirror_edk2.git] / MdePkg / Include / Protocol / Hash.h

diff --git a/MdePkg/Include/Protocol/Hash.h b/MdePkg/Include/Protocol/Hash.h
index b9ed6daa6d9a26704961e7ce0ac141223e13f031..9299c96699407873e64ddd3c4ed81818144989ad 100644 (file)
--- a/MdePkg/Include/Protocol/Hash.h
+++ b/MdePkg/Include/Protocol/Hash.h
@@ -5,14 +5,14 @@
   provided by a driver and to create and destroy instances of the EFI Hash Protocol \r
   so that a multiple drivers can use the underlying hashing services.\r
 \r
-  Copyright (c) 2006 - 2009, Intel Corporation                                                         \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
+Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution.  \r
+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
 **/\r
 \r
@@ -59,6 +59,16 @@
     0xaf7c79c, 0x65b5, 0x4319, {0xb0, 0xae, 0x44, 0xec, 0x48, 0x4e, 0x4a, 0xd7 } \\r
   }\r
 \r
+#define EFI_HASH_ALGORITHM_SHA1_NOPAD_GUID \\r
+  { \\r
+    0x24c5dc2f, 0x53e2, 0x40ca, {0x9e, 0xd6, 0xa5, 0xd9, 0xa4, 0x9f, 0x46, 0x3b } \\r
+  }\r
+\r
+#define EFI_HASH_ALGORITHM_SHA256_NOPAD_GUID \\r
+  { \\r
+    0x8628752a, 0x6cb7, 0x4814, {0x96, 0xfc, 0x24, 0xa8, 0x15, 0xac, 0x22, 0x26 } \\r
+  }\r
+\r
 typedef struct _EFI_HASH_PROTOCOL EFI_HASH_PROTOCOL;\r
 \r
 typedef UINT8  EFI_MD5_HASH[16];\r
@@ -99,7 +109,7 @@ EFI_STATUS
   );      \r
 \r
 /**\r
-  Returns the size of the hash which results from a specific algorithm.\r
+  Creates a hash for the specified message text.\r
 \r
   @param[in]  This          Points to this instance of EFI_HASH_PROTOCOL.\r
   @param[in]  HashAlgorithm Points to the EFI_GUID which identifies the algorithm to use.\r
@@ -107,13 +117,17 @@ EFI_STATUS
                             existing hash (TRUE).\r
   @param[in]  Message       Points to the start of the message.\r
   @param[in]  MessageSize   The size of Message, in bytes.\r
-  @param[in,out]  Hash      On input, if Extend is TRUE, then this holds the hash to extend. On\r
-                            output, holds the resulting hash computed from the message.\r
-\r
+  @param[in,out]  Hash      On input, if Extend is TRUE, then this parameter holds a pointer \r
+                            to a pointer to an array containing the hash to extend. If Extend \r
+                            is FALSE, then this parameter holds a pointer to a pointer to a \r
+                            caller-allocated array that will receive the result of the hash \r
+                            computation. On output (regardless of the value of Extend), the \r
+                            array will contain the result of the hash computation.\r
+  \r
   @retval EFI_SUCCESS           Hash returned successfully.\r
   @retval EFI_INVALID_PARAMETER Message or Hash is NULL\r
   @retval EFI_UNSUPPORTED       The algorithm specified by HashAlgorithm is not supported by this\r
-                                 driver. Or extend is TRUE and the algorithm doesn't support extending the hash.\r
+                                 driver. Or, Extend is TRUE, and the algorithm doesn't support extending the hash.\r
 \r
 **/\r
 typedef\r
@@ -144,5 +158,7 @@ extern EFI_GUID gEfiHashAlgorithmSha256Guid;
 extern EFI_GUID gEfiHashAlgorithmSha384Guid;\r
 extern EFI_GUID gEfiHashAlgorithmSha512Guid;\r
 extern EFI_GUID gEfiHashAlgorithmMD5Guid;\r
+extern EFI_GUID gEfiHashAlgorithmSha1NoPadGuid;\r
+extern EFI_GUID gEfiHashAlgorithmSha256NoPadGuid;\r
 \r
 #endif\r