/** @file | |
SHA-384 and SHA-512 Digest Wrapper Implementations over MbedTLS. | |
Copyright (c) 2023, Intel Corporation. All rights reserved.<BR> | |
SPDX-License-Identifier: BSD-2-Clause-Patent | |
**/ | |
#include "InternalCryptLib.h" | |
#include <mbedtls/sha512.h> | |
/** | |
Retrieves the size, in bytes, of the context buffer required for SHA-384 hash operations. | |
@return The size, in bytes, of the context buffer required for SHA-384 hash operations. | |
**/ | |
UINTN | |
EFIAPI | |
Sha384GetContextSize ( | |
VOID | |
) | |
{ | |
return (UINTN)(sizeof (mbedtls_sha512_context)); | |
} | |
/** | |
Initializes user-supplied memory pointed by Sha384Context as SHA-384 hash context for | |
subsequent use. | |
If Sha384Context is NULL, then return FALSE. | |
@param[out] Sha384Context Pointer to SHA-384 context being initialized. | |
@retval TRUE SHA-384 context initialization succeeded. | |
@retval FALSE SHA-384 context initialization failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha384Init ( | |
OUT VOID *Sha384Context | |
) | |
{ | |
INT32 Ret; | |
if (Sha384Context == NULL) { | |
return FALSE; | |
} | |
mbedtls_sha512_init (Sha384Context); | |
Ret = mbedtls_sha512_starts (Sha384Context, TRUE); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Makes a copy of an existing SHA-384 context. | |
If Sha384Context is NULL, then return FALSE. | |
If NewSha384Context is NULL, then return FALSE. | |
If this interface is not supported, then return FALSE. | |
@param[in] Sha384Context Pointer to SHA-384 context being copied. | |
@param[out] NewSha384Context Pointer to new SHA-384 context. | |
@retval TRUE SHA-384 context copy succeeded. | |
@retval FALSE SHA-384 context copy failed. | |
@retval FALSE This interface is not supported. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha384Duplicate ( | |
IN CONST VOID *Sha384Context, | |
OUT VOID *NewSha384Context | |
) | |
{ | |
if ((Sha384Context == NULL) || (NewSha384Context == NULL)) { | |
return FALSE; | |
} | |
mbedtls_sha512_clone (NewSha384Context, Sha384Context); | |
return TRUE; | |
} | |
/** | |
Digests the input data and updates SHA-384 context. | |
This function performs SHA-384 digest on a data buffer of the specified size. | |
It can be called multiple times to compute the digest of long or discontinuous data streams. | |
SHA-384 context should be already correctly initialized by Sha384Init(), and should not be finalized | |
by Sha384Final(). Behavior with invalid context is undefined. | |
If Sha384Context is NULL, then return FALSE. | |
@param[in, out] Sha384Context Pointer to the SHA-384 context. | |
@param[in] Data Pointer to the buffer containing the data to be hashed. | |
@param[in] DataSize Size of Data buffer in bytes. | |
@retval TRUE SHA-384 data digest succeeded. | |
@retval FALSE SHA-384 data digest failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha384Update ( | |
IN OUT VOID *Sha384Context, | |
IN CONST VOID *Data, | |
IN UINTN DataSize | |
) | |
{ | |
INT32 Ret; | |
if (Sha384Context == NULL) { | |
return FALSE; | |
} | |
if ((Data == NULL) && (DataSize != 0)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512_update (Sha384Context, Data, DataSize); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Completes computation of the SHA-384 digest value. | |
This function completes SHA-384 hash computation and retrieves the digest value into | |
the specified memory. After this function has been called, the SHA-384 context cannot | |
be used again. | |
SHA-384 context should be already correctly initialized by Sha384Init(), and should not be | |
finalized by Sha384Final(). Behavior with invalid SHA-384 context is undefined. | |
If Sha384Context is NULL, then return FALSE. | |
If HashValue is NULL, then return FALSE. | |
@param[in, out] Sha384Context Pointer to the SHA-384 context. | |
@param[out] HashValue Pointer to a buffer that receives the SHA-384 digest | |
value (48 bytes). | |
@retval TRUE SHA-384 digest computation succeeded. | |
@retval FALSE SHA-384 digest computation failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha384Final ( | |
IN OUT VOID *Sha384Context, | |
OUT UINT8 *HashValue | |
) | |
{ | |
INT32 Ret; | |
if ((Sha384Context == NULL) || (HashValue == NULL)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512_finish (Sha384Context, HashValue); | |
mbedtls_sha512_free (Sha384Context); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Computes the SHA-384 message digest of a input data buffer. | |
This function performs the SHA-384 message digest of a given data buffer, and places | |
the digest value into the specified memory. | |
If this interface is not supported, then return FALSE. | |
@param[in] Data Pointer to the buffer containing the data to be hashed. | |
@param[in] DataSize Size of Data buffer in bytes. | |
@param[out] HashValue Pointer to a buffer that receives the SHA-384 digest | |
value (48 bytes). | |
@retval TRUE SHA-384 digest computation succeeded. | |
@retval FALSE SHA-384 digest computation failed. | |
@retval FALSE This interface is not supported. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha384HashAll ( | |
IN CONST VOID *Data, | |
IN UINTN DataSize, | |
OUT UINT8 *HashValue | |
) | |
{ | |
INT32 Ret; | |
if (HashValue == NULL) { | |
return FALSE; | |
} | |
if ((Data == NULL) && (DataSize != 0)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512 (Data, DataSize, HashValue, TRUE); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Retrieves the size, in bytes, of the context buffer required for SHA-512 hash operations. | |
@return The size, in bytes, of the context buffer required for SHA-512 hash operations. | |
**/ | |
UINTN | |
EFIAPI | |
Sha512GetContextSize ( | |
VOID | |
) | |
{ | |
return (UINTN)(sizeof (mbedtls_sha512_context)); | |
} | |
/** | |
Initializes user-supplied memory pointed by Sha512Context as SHA-512 hash context for | |
subsequent use. | |
If Sha512Context is NULL, then return FALSE. | |
@param[out] Sha512Context Pointer to SHA-512 context being initialized. | |
@retval TRUE SHA-512 context initialization succeeded. | |
@retval FALSE SHA-512 context initialization failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha512Init ( | |
OUT VOID *Sha512Context | |
) | |
{ | |
INT32 Ret; | |
if (Sha512Context == NULL) { | |
return FALSE; | |
} | |
mbedtls_sha512_init (Sha512Context); | |
Ret = mbedtls_sha512_starts (Sha512Context, FALSE); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Makes a copy of an existing SHA-512 context. | |
If Sha512Context is NULL, then return FALSE. | |
If NewSha512Context is NULL, then return FALSE. | |
If this interface is not supported, then return FALSE. | |
@param[in] Sha512Context Pointer to SHA-512 context being copied. | |
@param[out] NewSha512Context Pointer to new SHA-512 context. | |
@retval TRUE SHA-512 context copy succeeded. | |
@retval FALSE SHA-512 context copy failed. | |
@retval FALSE This interface is not supported. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha512Duplicate ( | |
IN CONST VOID *Sha512Context, | |
OUT VOID *NewSha512Context | |
) | |
{ | |
if ((Sha512Context == NULL) || (NewSha512Context == NULL)) { | |
return FALSE; | |
} | |
mbedtls_sha512_clone (NewSha512Context, Sha512Context); | |
return TRUE; | |
} | |
/** | |
Digests the input data and updates SHA-512 context. | |
This function performs SHA-512 digest on a data buffer of the specified size. | |
It can be called multiple times to compute the digest of long or discontinuous data streams. | |
SHA-512 context should be already correctly initialized by Sha512Init(), and should not be finalized | |
by Sha512Final(). Behavior with invalid context is undefined. | |
If Sha512Context is NULL, then return FALSE. | |
@param[in, out] Sha512Context Pointer to the SHA-512 context. | |
@param[in] Data Pointer to the buffer containing the data to be hashed. | |
@param[in] DataSize Size of Data buffer in bytes. | |
@retval TRUE SHA-512 data digest succeeded. | |
@retval FALSE SHA-512 data digest failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha512Update ( | |
IN OUT VOID *Sha512Context, | |
IN CONST VOID *Data, | |
IN UINTN DataSize | |
) | |
{ | |
INT32 Ret; | |
if (Sha512Context == NULL) { | |
return FALSE; | |
} | |
if ((Data == NULL) && (DataSize != 0)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512_update (Sha512Context, Data, DataSize); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Completes computation of the SHA-512 digest value. | |
This function completes SHA-512 hash computation and retrieves the digest value into | |
the specified memory. After this function has been called, the SHA-512 context cannot | |
be used again. | |
SHA-512 context should be already correctly initialized by Sha512Init(), and should not be | |
finalized by Sha512Final(). Behavior with invalid SHA-512 context is undefined. | |
If Sha512Context is NULL, then return FALSE. | |
If HashValue is NULL, then return FALSE. | |
@param[in, out] Sha512Context Pointer to the SHA-512 context. | |
@param[out] HashValue Pointer to a buffer that receives the SHA-512 digest | |
value (64 bytes). | |
@retval TRUE SHA-512 digest computation succeeded. | |
@retval FALSE SHA-512 digest computation failed. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha512Final ( | |
IN OUT VOID *Sha512Context, | |
OUT UINT8 *HashValue | |
) | |
{ | |
INT32 Ret; | |
if ((Sha512Context == NULL) || (HashValue == NULL)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512_finish (Sha512Context, HashValue); | |
mbedtls_sha512_free (Sha512Context); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} | |
/** | |
Computes the SHA-512 message digest of a input data buffer. | |
This function performs the SHA-512 message digest of a given data buffer, and places | |
the digest value into the specified memory. | |
If this interface is not supported, then return FALSE. | |
@param[in] Data Pointer to the buffer containing the data to be hashed. | |
@param[in] DataSize Size of Data buffer in bytes. | |
@param[out] HashValue Pointer to a buffer that receives the SHA-512 digest | |
value (64 bytes). | |
@retval TRUE SHA-512 digest computation succeeded. | |
@retval FALSE SHA-512 digest computation failed. | |
@retval FALSE This interface is not supported. | |
**/ | |
BOOLEAN | |
EFIAPI | |
Sha512HashAll ( | |
IN CONST VOID *Data, | |
IN UINTN DataSize, | |
OUT UINT8 *HashValue | |
) | |
{ | |
INT32 Ret; | |
if (HashValue == NULL) { | |
return FALSE; | |
} | |
if ((Data == NULL) && (DataSize != 0)) { | |
return FALSE; | |
} | |
Ret = mbedtls_sha512 (Data, DataSize, HashValue, FALSE); | |
if (Ret != 0) { | |
return FALSE; | |
} | |
return TRUE; | |
} |