/** @file\r
SHA-256 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2009 - 2010, 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) 2009 - 2016, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
-#include <Library/BaseLib.h>\r
-#include <Library/DebugLib.h>\r
-\r
-#include <Library/BaseCryptLib.h>\r
+#include "InternalCryptLib.h"\r
#include <openssl/sha.h>\r
\r
-\r
/**\r
- Retrieves the size, in bytes, of the context buffer required for SHA-256 operations.\r
+ Retrieves the size, in bytes, of the context buffer required for SHA-256 hash operations.\r
\r
- @return The size, in bytes, of the context buffer required for SHA-256 operations.\r
+ @return The size, in bytes, of the context buffer required for SHA-256 hash operations.\r
\r
**/\r
UINTN\r
//\r
// Retrieves OpenSSL SHA-256 Context Size\r
//\r
- return (UINTN)(sizeof (SHA256_CTX));\r
+ return (UINTN) (sizeof (SHA256_CTX));\r
}\r
\r
-\r
/**\r
Initializes user-supplied memory pointed by Sha256Context as SHA-256 hash context for\r
subsequent use.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
\r
- @param[in, out] Sha256Context Pointer to SHA-256 Context being initialized.\r
+ @param[out] Sha256Context Pointer to SHA-256 context being initialized.\r
\r
@retval TRUE SHA-256 context initialization succeeded.\r
@retval FALSE SHA-256 context initialization failed.\r
BOOLEAN\r
EFIAPI\r
Sha256Init (\r
- IN OUT VOID *Sha256Context\r
+ OUT VOID *Sha256Context\r
)\r
{\r
//\r
- // ASSERT if Sha256Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
+ if (Sha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-256 Context Initialization\r
//\r
- return (BOOLEAN) (SHA256_Init ((SHA256_CTX *)Sha256Context));\r
+ return (BOOLEAN) (SHA256_Init ((SHA256_CTX *) Sha256Context));\r
}\r
\r
+/**\r
+ Makes a copy of an existing SHA-256 context.\r
+\r
+ If Sha256Context is NULL, then return FALSE.\r
+ If NewSha256Context is NULL, then return FALSE.\r
+\r
+ @param[in] Sha256Context Pointer to SHA-256 context being copied.\r
+ @param[out] NewSha256Context Pointer to new SHA-256 context.\r
+\r
+ @retval TRUE SHA-256 context copy succeeded.\r
+ @retval FALSE SHA-256 context copy failed.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+Sha256Duplicate (\r
+ IN CONST VOID *Sha256Context,\r
+ OUT VOID *NewSha256Context\r
+ )\r
+{\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Sha256Context == NULL || NewSha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
+\r
+ CopyMem (NewSha256Context, Sha256Context, sizeof (SHA256_CTX));\r
+\r
+ return TRUE;\r
+}\r
\r
/**\r
- Performs SHA-256 digest on a data buffer of the specified length. This function can\r
- be called multiple times to compute the digest of long or discontinuous data streams.\r
+ Digests the input data and updates SHA-256 context.\r
+\r
+ This function performs SHA-256 digest on a data buffer of the specified size.\r
+ It can be called multiple times to compute the digest of long or discontinuous data streams.\r
+ SHA-256 context should be already correctly initialized by Sha256Init(), and should not be finalized\r
+ by Sha256Final(). Behavior with invalid context is undefined.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
\r
@param[in, out] Sha256Context Pointer to the SHA-256 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
- @param[in] DataLength Length of Data buffer in bytes.\r
+ @param[in] DataSize Size of Data buffer in bytes.\r
\r
@retval TRUE SHA-256 data digest succeeded.\r
- @retval FALSE Invalid SHA-256 context. After Sha256Final function has been called, the\r
- SHA-256 context cannot be reused.\r
+ @retval FALSE SHA-256 data digest failed.\r
\r
**/\r
BOOLEAN\r
Sha256Update (\r
IN OUT VOID *Sha256Context,\r
IN CONST VOID *Data,\r
- IN UINTN DataLength\r
+ IN UINTN DataSize\r
)\r
{\r
//\r
- // ASSERT if Sha256Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
+ if (Sha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataLength == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\r
// OpenSSL SHA-256 Hash Update\r
//\r
- return (BOOLEAN) (SHA256_Update ((SHA256_CTX *)Sha256Context, Data, DataLength));\r
+ return (BOOLEAN) (SHA256_Update ((SHA256_CTX *) Sha256Context, Data, DataSize));\r
}\r
\r
-\r
/**\r
- Completes SHA-256 hash computation and retrieves the digest value into the specified\r
- memory. After this function has been called, the SHA-256 context cannot be used again.\r
+ Completes computation of the SHA-256 digest value.\r
+\r
+ This function completes SHA-256 hash computation and retrieves the digest value into\r
+ the specified memory. After this function has been called, the SHA-256 context cannot\r
+ be used again.\r
+ SHA-256 context should be already correctly initialized by Sha256Init(), and should not be\r
+ finalized by Sha256Final(). Behavior with invalid SHA-256 context is undefined.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
- @param[in, out] Sha256Context Pointer to SHA-256 context\r
+ @param[in, out] Sha256Context Pointer to the SHA-256 context.\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
value (32 bytes).\r
\r
)\r
{\r
//\r
- // ASSERT if Sha256Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Sha256Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-256 Hash Finalization\r
//\r
- return (BOOLEAN) (SHA256_Final (HashValue, (SHA256_CTX *)Sha256Context));\r
+ return (BOOLEAN) (SHA256_Final (HashValue, (SHA256_CTX *) Sha256Context));\r
+}\r
+\r
+/**\r
+ Computes the SHA-256 message digest of a input data buffer.\r
+\r
+ This function performs the SHA-256 message digest of a given data buffer, and places\r
+ the digest value into the specified memory.\r
+\r
+ If this interface is not supported, then return FALSE.\r
+\r
+ @param[in] Data Pointer to the buffer containing the data to be hashed.\r
+ @param[in] DataSize Size of Data buffer in bytes.\r
+ @param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
+ value (32 bytes).\r
+\r
+ @retval TRUE SHA-256 digest computation succeeded.\r
+ @retval FALSE SHA-256 digest computation failed.\r
+ @retval FALSE This interface is not supported.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+Sha256HashAll (\r
+ IN CONST VOID *Data,\r
+ IN UINTN DataSize,\r
+ OUT UINT8 *HashValue\r
+ )\r
+{\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
+ }\r
+\r
+ //\r
+ // OpenSSL SHA-256 Hash Computation.\r
+ //\r
+ if (SHA256 (Data, DataSize, HashValue) == NULL) {\r
+ return FALSE;\r
+ } else {\r
+ return TRUE;\r
+ }\r
}\r