123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295 |
- /** @file
- Unified Hash API Implementation
- This file implements the Unified Hash API.
- This API, when called, will calculate the Hash using the
- hashing algorithm specified by PcdHashApiLibPolicy.
- Copyright (c) 2020-2022, Intel Corporation. All rights reserved.<BR>
- SPDX-License-Identifier: BSD-2-Clause-Patent
- **/
- #include <Base.h>
- #include <IndustryStandard/Tpm20.h>
- #include <Library/BaseLib.h>
- #include <Library/BaseMemoryLib.h>
- #include <Library/MemoryAllocationLib.h>
- #include <Library/BaseCryptLib.h>
- #include <Library/DebugLib.h>
- #include <Library/PcdLib.h>
- #include <Library/HashApiLib.h>
- /**
- Retrieves the size, in bytes, of the context buffer required for hash operations.
- @return The size, in bytes, of the context buffer required for hash operations.
- **/
- UINTN
- EFIAPI
- HashApiGetContextSize (
- VOID
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1GetContextSize ();
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256GetContextSize ();
- break;
- case HASH_ALG_SHA384:
- return Sha384GetContextSize ();
- break;
- case HASH_ALG_SHA512:
- return Sha512GetContextSize ();
- break;
- case HASH_ALG_SM3_256:
- return Sm3GetContextSize ();
- break;
- default:
- ASSERT (FALSE);
- return 0;
- break;
- }
- }
- /**
- Init hash sequence.
- @param[out] HashContext Hash context.
- @retval TRUE Hash start and HashHandle returned.
- @retval FALSE Hash Init unsuccessful.
- **/
- BOOLEAN
- EFIAPI
- HashApiInit (
- OUT HASH_API_CONTEXT HashContext
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1Init (HashContext);
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256Init (HashContext);
- break;
- case HASH_ALG_SHA384:
- return Sha384Init (HashContext);
- break;
- case HASH_ALG_SHA512:
- return Sha512Init (HashContext);
- break;
- case HASH_ALG_SM3_256:
- return Sm3Init (HashContext);
- break;
- default:
- ASSERT (FALSE);
- return FALSE;
- break;
- }
- }
- /**
- Makes a copy of an existing hash context.
- @param[in] HashContext Hash context.
- @param[out] NewHashContext New copy of hash context.
- @retval TRUE Hash context copy succeeded.
- @retval FALSE Hash context copy failed.
- **/
- BOOLEAN
- EFIAPI
- HashApiDuplicate (
- IN HASH_API_CONTEXT HashContext,
- OUT HASH_API_CONTEXT NewHashContext
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1Duplicate (HashContext, NewHashContext);
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256Duplicate (HashContext, NewHashContext);
- break;
- case HASH_ALG_SHA384:
- return Sha384Duplicate (HashContext, NewHashContext);
- break;
- case HASH_ALG_SHA512:
- return Sha512Duplicate (HashContext, NewHashContext);
- break;
- case HASH_ALG_SM3_256:
- return Sm3Duplicate (HashContext, NewHashContext);
- break;
- default:
- ASSERT (FALSE);
- return FALSE;
- break;
- }
- }
- /**
- Update hash data.
- @param[in] HashContext Hash context.
- @param[in] DataToHash Data to be hashed.
- @param[in] DataToHashLen Data size.
- @retval TRUE Hash updated.
- @retval FALSE Hash updated unsuccessful.
- **/
- BOOLEAN
- EFIAPI
- HashApiUpdate (
- IN HASH_API_CONTEXT HashContext,
- IN VOID *DataToHash,
- IN UINTN DataToHashLen
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1Update (HashContext, DataToHash, DataToHashLen);
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256Update (HashContext, DataToHash, DataToHashLen);
- break;
- case HASH_ALG_SHA384:
- return Sha384Update (HashContext, DataToHash, DataToHashLen);
- break;
- case HASH_ALG_SHA512:
- return Sha512Update (HashContext, DataToHash, DataToHashLen);
- break;
- case HASH_ALG_SM3_256:
- return Sm3Update (HashContext, DataToHash, DataToHashLen);
- break;
- default:
- ASSERT (FALSE);
- return FALSE;
- break;
- }
- }
- /**
- Hash complete.
- @param[in] HashContext Hash context.
- @param[out] Digest Hash Digest.
- @retval TRUE Hash complete and Digest is returned.
- @retval FALSE Hash complete unsuccessful.
- **/
- BOOLEAN
- EFIAPI
- HashApiFinal (
- IN HASH_API_CONTEXT HashContext,
- OUT UINT8 *Digest
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1Final (HashContext, Digest);
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256Final (HashContext, Digest);
- break;
- case HASH_ALG_SHA384:
- return Sha384Final (HashContext, Digest);
- break;
- case HASH_ALG_SHA512:
- return Sha512Final (HashContext, Digest);
- break;
- case HASH_ALG_SM3_256:
- return Sm3Final (HashContext, Digest);
- break;
- default:
- ASSERT (FALSE);
- return FALSE;
- break;
- }
- }
- /**
- Computes hash message digest of a input data buffer.
- @param[in] DataToHash Data to be hashed.
- @param[in] DataToHashLen Data size.
- @param[out] Digest Hash Digest.
- @retval TRUE Hash digest computation succeeded.
- @retval FALSE Hash digest computation failed.
- **/
- BOOLEAN
- EFIAPI
- HashApiHashAll (
- IN CONST VOID *DataToHash,
- IN UINTN DataToHashLen,
- OUT UINT8 *Digest
- )
- {
- switch (PcdGet32 (PcdHashApiLibPolicy)) {
- #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
- case HASH_ALG_SHA1:
- return Sha1HashAll (DataToHash, DataToHashLen, Digest);
- break;
- #endif
- case HASH_ALG_SHA256:
- return Sha256HashAll (DataToHash, DataToHashLen, Digest);
- break;
- case HASH_ALG_SHA384:
- return Sha384HashAll (DataToHash, DataToHashLen, Digest);
- break;
- case HASH_ALG_SHA512:
- return Sha512HashAll (DataToHash, DataToHashLen, Digest);
- break;
- case HASH_ALG_SM3_256:
- return Sm3HashAll (DataToHash, DataToHashLen, Digest);
- break;
- default:
- ASSERT (FALSE);
- return FALSE;
- break;
- }
- }
|