/** @file\r
SHA-256 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2009 - 2012, 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
//\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
// 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
//\r
// Check input parameters.\r
//\r
- if (Sha256Context == NULL || NewSha256Context == NULL) {\r
+ if ((Sha256Context == NULL) || (NewSha256Context == NULL)) {\r
return FALSE;\r
}\r
\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 intialized by Sha256Init(), and should not be finalized\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 return FALSE.\r
//\r
// Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL && DataSize != 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, DataSize));\r
+ return (BOOLEAN)(SHA256_Update ((SHA256_CTX *)Sha256Context, Data, DataSize));\r
}\r
\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 intialized by Sha256Init(), and should not be\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 return FALSE.\r
//\r
// Check input parameters.\r
//\r
- if (Sha256Context == NULL || 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
+\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