/** @file\r
MD5 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
//\r
// Retrieves the OpenSSL MD5 Context Size\r
//\r
- return (UINTN)(sizeof (MD5_CTX));\r
+ return (UINTN) (sizeof (MD5_CTX));\r
}\r
\r
\r
Initializes user-supplied memory pointed by Md5Context as MD5 hash context for\r
subsequent use.\r
\r
- If Md5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
\r
@param[out] Md5Context Pointer to MD5 context being initialized.\r
\r
)\r
{\r
//\r
- // ASSERT if Md5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
+ if (Md5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD5 Context Initialization\r
//\r
- return (BOOLEAN) (MD5_Init ((MD5_CTX *)Md5Context));\r
+ return (BOOLEAN) (MD5_Init ((MD5_CTX *) Md5Context));\r
}\r
\r
/**\r
Makes a copy of an existing MD5 context.\r
\r
- If Md5Context is NULL, then ASSERT().\r
- If NewMd5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
+ If NewMd5Context is NULL, then return FALSE.\r
\r
@param[in] Md5Context Pointer to MD5 context being copied.\r
@param[out] NewMd5Context Pointer to new MD5 context.\r
)\r
{\r
//\r
- // ASSERT if Md5Context or NewMd5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
- ASSERT (NewMd5Context != NULL);\r
+ if (Md5Context == NULL || NewMd5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewMd5Context, Md5Context, sizeof (MD5_CTX));\r
\r
\r
This function performs MD5 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
- MD5 context should be already correctly intialized by Md5Init(), and should not be finalized\r
+ MD5 context should be already correctly initialized by Md5Init(), and should not be finalized\r
by Md5Final(). Behavior with invalid context is undefined.\r
\r
- If Md5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
\r
@param[in, out] Md5Context Pointer to the MD5 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
)\r
{\r
//\r
- // ASSERT if Md5Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
+ if (Md5Context == 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 (DataSize == 0);\r
+ if (Data == NULL && (DataSize != 0)) {\r
+ return FALSE;\r
}\r
\r
//\r
// OpenSSL MD5 Hash Update\r
//\r
- return (BOOLEAN) (MD5_Update ((MD5_CTX *)Md5Context, Data, DataSize));\r
+ return (BOOLEAN) (MD5_Update ((MD5_CTX *) Md5Context, Data, DataSize));\r
}\r
\r
/**\r
This function completes MD5 hash computation and retrieves the digest value into\r
the specified memory. After this function has been called, the MD5 context cannot\r
be used again.\r
- MD5 context should be already correctly intialized by Md5Init(), and should not be\r
+ MD5 context should be already correctly initialized by Md5Init(), and should not be\r
finalized by Md5Final(). Behavior with invalid MD5 context is undefined.\r
\r
- If Md5Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] Md5Context Pointer to the MD5 context.\r
@param[out] HashValue Pointer to a buffer that receives the MD5 digest\r
)\r
{\r
//\r
- // ASSERT if Md5Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Md5Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD5 Hash Finalization\r
//\r
- return (BOOLEAN) (MD5_Final (HashValue, (MD5_CTX *)Md5Context));\r
+ return (BOOLEAN) (MD5_Final (HashValue, (MD5_CTX *) Md5Context));\r
+}\r
+\r
+/**\r
+ Computes the MD5 message digest of a input data buffer.\r
+\r
+ This function performs the MD5 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 MD5 digest\r
+ value (16 bytes).\r
+\r
+ @retval TRUE MD5 digest computation succeeded.\r
+ @retval FALSE MD5 digest computation failed.\r
+ @retval FALSE This interface is not supported.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+Md5HashAll (\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 MD5 Hash Computation.\r
+ //\r
+ if (MD5 (Data, DataSize, HashValue) == NULL) {\r
+ return FALSE;\r
+ } else {\r
+ return TRUE;\r
+ }\r
}\r