From nobody Mon Feb 9 23:57:51 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+52381+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+52381+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1576707401; cv=none; d=zohomail.com; s=zohoarc; b=nUYuVpn+mQNHsETLfzm70hf7eLaphgt0JqFrX+FDbSnxrJLpDVxUl2VqjMwrWY66w9yMVZE+ArT93H4mQ4uk7zxgTJWcdKJUjHdGAzS9WoUiDgBiC30M+Qbj+l/Q9VfWW1ztVd/NQ0HqNqfJmP0POOqDZXVU8HNjOcNBXomaZzY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1576707401; h=Content-Transfer-Encoding:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=BsEY9TVewhcNOrCQvBQQWB/nAXAy0Xw0iF/hYPvd+1Q=; b=gFfKP/VUIYLionEuq7vVsJHwvzrVHbauyxAiwF3OOq/uIExXYPGae6XDVHJEPNA8jKo3RBKksm5vVKc+Wy4FMTmlbA3qbetWe5Z9EsWvZwG2/vhqcmArACojuMtWH1ewuoL1+520Sg91H5OLR1MEn91m14pHZwADDcgshFuKJO0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+52381+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1576707401284269.562289911187; Wed, 18 Dec 2019 14:16:41 -0800 (PST) Return-Path: X-Received: by 127.0.0.2 with SMTP id zdXZYY1788612xGuI6f74pCb; Wed, 18 Dec 2019 14:16:40 -0800 X-Received: from mga02.intel.com (mga02.intel.com []) by mx.groups.io with SMTP id smtpd.web12.1767.1576704760204204400 for ; Wed, 18 Dec 2019 13:32:46 -0800 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Dec 2019 13:32:45 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.69,330,1571727600"; d="scan'208";a="212815430" X-Received: from ansukerk-mobl.amr.corp.intel.com ([10.78.16.174]) by fmsmga007.fm.intel.com with ESMTP; 18 Dec 2019 13:32:45 -0800 From: "Sukerkar, Amol N" To: devel@edk2.groups.io Subject: [edk2-devel] [PATCH v1 3/6] SecurityPkg/HashApiInstanceSha256: Implement API registration mechanism for SHA256 Date: Wed, 18 Dec 2019 14:32:33 -0700 Message-Id: <20191218213236.1563-4-amol.n.sukerkar@intel.com> In-Reply-To: <20191218213236.1563-1-amol.n.sukerkar@intel.com> References: <20191218213236.1563-1-amol.n.sukerkar@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,amol.n.sukerkar@intel.com X-Gm-Message-State: fAWXnFDcJu4fSk7qHjfnrZ6Ix1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1576707400; bh=WpcxgcJYytreXRwrYdbJPaRICLs/leG/ARela/fd000=; h=Date:From:Reply-To:Subject:To; b=FGkOLJ3yh3uEA8bnyUWB424ldaYup7lJshFeP01jjRE15303DAc/qjThqDiHCQCzVoY k34ek4Gyxp19D4abD3TrHcfh5nrR+lPMms1gRNlflYHigWVev1QFRHiBnOmmdgkaNSMRu dzTzTD6Fbx7tlgzIJcRY100+UG0XVEB/7GY= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" This is the HashApiInstance implementation for SHA256 which registers the SHA256 hash library in CryptoPkg with BaseHashLib based on whether a platfo= rm supports SHA256 hash algorithm (provided by PcdTpm2HashMask). Signed-off-by: Sukerkar, Amol N --- SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.c | 128 = ++++++++++++++++++++ SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.inf | 40 = ++++++ SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.uni | 16 = +++ SecurityPkg/SecurityPkg.dsc | 1 + 4 files changed, 185 insertions(+) diff --git a/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha25= 6.c b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.c new file mode 100644 index 000000000000..129d60a387fd --- /dev/null +++ b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.c @@ -0,0 +1,128 @@ +/** @file + This library is BaseCrypto SHA256 hash instance. + It can be registered to BaseCrypto router, to serve as hash engine. + +Copyright (c) 2013 - 2019, Intel Corporation. All rights reserved.
+SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#include +#include +#include +#include +#include +#include +#include + +/** + Start hash sequence. + + @param HashHandle Hash handle. + + @retval EFI_SUCCESS Hash sequence start and HandleHandle return= ed. + @retval EFI_OUT_OF_RESOURCES No enough resource to start hash. +**/ +EFI_STATUS +EFIAPI +Sha256_Init ( + OUT HASH_HANDLE *HashHandle + ) +{ + VOID *Sha256Ctx; + UINTN CtxSize; + + CtxSize =3D Sha256GetContextSize (); + Sha256Ctx =3D AllocatePool (CtxSize); + ASSERT (Sha256Ctx !=3D NULL); + + Sha256Init (Sha256Ctx); + + *HashHandle =3D (HASH_HANDLE)Sha256Ctx; + + return EFI_SUCCESS; +} + +/** + Update hash sequence data. + + @param HashHandle Hash handle. + @param DataToHash Data to be hashed. + @param DataToHashLen Data size. + + @retval EFI_SUCCESS Hash sequence updated. +**/ +EFI_STATUS +EFIAPI +Sha256_Update ( + IN HASH_HANDLE HashHandle, + IN VOID *DataToHash, + IN UINTN DataToHashLen + ) +{ + VOID *Sha256Ctx; + + Sha256Ctx =3D (VOID *)HashHandle; + Sha256Update (Sha256Ctx, DataToHash, DataToHashLen); + + return EFI_SUCCESS; +} + +/** + Complete hash sequence complete. + + @param HashHandle Hash handle. + @param DigestList Digest list. + + @retval EFI_SUCCESS Hash sequence complete and DigestList is returne= d. +**/ +EFI_STATUS +EFIAPI +Sha256_Final ( + IN HASH_HANDLE HashHandle, + OUT UINT8 **Digest + ) +{ + UINT8 Sha256Digest[SHA256_DIGEST_SIZE]; + VOID *Sha256Ctx; + + Sha256Ctx =3D (VOID *)HashHandle; + Sha256Final (Sha256Ctx, Sha256Digest); + + CopyMem (*Digest, Sha256Digest, SHA256_DIGEST_SIZE); + + FreePool (Sha256Ctx); + + return EFI_SUCCESS; +} + +HASH_INTERFACE_UNIFIED_API mSha256InternalHashApiInstance =3D { + HASH_ALGORITHM_SHA256_GUID, + Sha256_Init, + Sha256_Update, + Sha256_Final, +}; + +/** + The function register SHA256 instance. + + @retval EFI_SUCCESS SHA256 instance is registered, or system dose not = surpport registr SHA256 instance +**/ +EFI_STATUS +EFIAPI +HashApiInstanceSha256Constructor ( + VOID + ) +{ + EFI_STATUS Status; + + Status =3D RegisterHashApiLib (&mSha256InternalHashApiInstance); + if ((Status =3D=3D EFI_SUCCESS) || (Status =3D=3D EFI_UNSUPPORTED)) { + // + // Unsupported means platform policy does not need this instance enabl= ed. + // + DEBUG ((DEBUG_ERROR, "[ansukerk]: Hash Interface SHA256 is registered\= n")); + return EFI_SUCCESS; + } + return Status; +} diff --git a/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha25= 6.inf b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.inf new file mode 100644 index 000000000000..08d802cd69f4 --- /dev/null +++ b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.inf @@ -0,0 +1,40 @@ +## @file +# Provides BaseCrypto SHA1 hash service +# +# This library can be registered to BaseCrypto router, to serve as hash e= ngine. +# +# Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.
+# SPDX-License-Identifier: BSD-2-Clause-Patent +# +## + +[Defines] + INF_VERSION =3D 0x00010005 + BASE_NAME =3D HashApiInstanceSha256 + MODULE_UNI_FILE =3D HashApiInstanceSha256.uni + FILE_GUID =3D 9A7A6AB4-9DA6-4aa4-90CB-6D4B79EDA7B9 + MODULE_TYPE =3D BASE + VERSION_STRING =3D 1.0 + LIBRARY_CLASS =3D NULL + CONSTRUCTOR =3D HashApiInstanceSha256Constructor + +# +# The following information is for reference only and not required by the = build tools. +# +# VALID_ARCHITECTURES =3D IA32 X64 +# + +[Sources] + HashApiInstanceSha256.c + +[Packages] + MdePkg/MdePkg.dec + SecurityPkg/SecurityPkg.dec + CryptoPkg/CryptoPkg.dec + +[LibraryClasses] + BaseLib + BaseMemoryLib + DebugLib + MemoryAllocationLib + BaseCryptLib diff --git a/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha25= 6.uni b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.uni new file mode 100644 index 000000000000..b2121464c552 --- /dev/null +++ b/SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.uni @@ -0,0 +1,16 @@ +// /** @file +// Provides BaseCrypto SHA256 hash service +// +// This library can be registered to BaseCrypto router, to serve as hash e= ngine. +// +// Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.
+// +// SPDX-License-Identifier: BSD-2-Clause-Patent +// +// **/ + + +#string STR_MODULE_ABSTRACT #language en-US "Provides BaseCryp= to SHA256 hash service API" + +#string STR_MODULE_DESCRIPTION #language en-US "This library can = be registered to Base Hash API, to serve as hash engine." + diff --git a/SecurityPkg/SecurityPkg.dsc b/SecurityPkg/SecurityPkg.dsc index 6c0832d48e88..95a5710735e0 100644 --- a/SecurityPkg/SecurityPkg.dsc +++ b/SecurityPkg/SecurityPkg.dsc @@ -245,6 +245,7 @@ [Components.IA32, Components.X64] # Hash API # SecurityPkg/Library/HashApiInstanceSha1/HashApiInstanceSha1.inf + SecurityPkg/Library/HashApiInstanceSha256/HashApiInstanceSha256.inf =20 # # TPM --=20 2.16.2.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#52381): https://edk2.groups.io/g/devel/message/52381 Mute This Topic: https://groups.io/mt/68808202/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-