From: "Michael D Kinney" <michael.d.kinney@intel.com>
To: "Li, Yi1" <yi1.li@intel.com>,
"devel@edk2.groups.io" <devel@edk2.groups.io>,
"Chen, Christine" <yuwei.chen@intel.com>,
"Feng, Bob C" <bob.c.feng@intel.com>,
"Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Yao, Jiewen" <jiewen.yao@intel.com>,
"Wang, Jian J" <jian.j.wang@intel.com>,
"Lu, Xiaoyu1" <xiaoyu1.lu@intel.com>,
"Jiang, Guomin" <guomin.jiang@intel.com>
Subject: Re: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
Date: Fri, 23 Sep 2022 05:25:02 +0000 [thread overview]
Message-ID: <CO1PR11MB49295D0548BA83BD507BF2D7D2519@CO1PR11MB4929.namprd11.prod.outlook.com> (raw)
In-Reply-To: <SJ1PR11MB622769664C161A1F2D3A68C9C5519@SJ1PR11MB6227.namprd11.prod.outlook.com>
Hi Yi,
I agree there are some complex interactions in the opensll sources.
Since you are defining a family for EC, can we use the EC Family != 0 instead of
PcdOpensslEcEnabled and remove PcdOpensslEcEnabled.
I want to make sure developers do not run into strange build failures if
they do not keep the 2 different PCDs aligned. I prefer a single PCD
setting to enable use of EC services.
I also noticed that the use of a PCD expression in an INF to select source
files does not work if the PCD value is specified with the --pcd flag on
the build command line. This looks like a significant bug with the PCD
expression in an INF file. This also needs to be fixed.
Mike
> -----Original Message-----
> From: Li, Yi1 <yi1.li@intel.com>
> Sent: Thursday, September 22, 2022 8:02 PM
> To: Kinney, Michael D <michael.d.kinney@intel.com>; devel@edk2.groups.io
> Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> Guomin <guomin.jiang@intel.com>
> Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
>
> Hi Mike,
>
> 1. Yes, it matches.
> By Intel side, 100+kb(20%+) FV size increase will be a big concern, please refer to another internal email.
>
> 2. Additional size is coming from modules may consumed EC APIs, eg. TLS PEM X509 ...
>
> If we added EC source to OpensslLib.inf and disabled macro OPENSSL_NO_EC, those modules will link EC APIs and increase binary
> size,
> This an example from x509/x_pubkey.c , other modules is similar:
> #ifndef OPENSSL_NO_EC
> EC_KEY *d2i_EC_PUBKEY(EC_KEY **a, const unsigned char **pp, long length)
> {
> EVP_PKEY *pkey;
> EC_KEY *key = NULL;
> //.... call EC functions
> }
> #endif
>
> If we added EC source to OpensslLib.inf and enable macro OPENSSL_NO_EC, EC module will throw build error,
> Since some EC internal APIs or structs have been disabled by OPENSSL_NO_EC but not another.
> This an example from ec/ec_local.h , other error is similar:
>
> #ifndef OPENSSL_NO_EC
> typedef struct ec_group_st EC_GROUP;
> typedef struct ec_point_st EC_POINT;
> #endif
>
> // but this function not been enclosed by OPENSSL_NO_EC, and will throw build error
> int (*point_set_Jprojective_coordinates_GFp) (const EC_GROUP *,
> EC_POINT *, const BIGNUM *x,
> const BIGNUM *y,
> const BIGNUM *z, BN_CTX *);
>
> To avoid this annoying openssl error, we introduced conditional EC.
>
> Thanks,
> Yi
>
> -----Original Message-----
> From: Kinney, Michael D <michael.d.kinney@intel.com>
> Sent: Friday, September 23, 2022 6:47 AM
> To: Li, Yi1 <yi1.li@intel.com>; devel@edk2.groups.io; Kinney, Michael D <michael.d.kinney@intel.com>
> Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> Guomin <guomin.jiang@intel.com>
> Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
>
> Hi Yi,
>
> I agree EC is an important feature.
>
> I did some analysis of the size impact to the CryptoPkg modules on current trunk
> with EC on and off. Uncompressed size is important for PEI Phase. For DXE and
> SMM phase, the Crypto services can always be compressed. From the table below,
> building all the EC services in the OpensslLib has no size impact to the NONE
> profile and the MIN_PEI profile. It has ~105 KB impact to compressed DXE/SMM
> usages that may use the MIN_DXE_MIN_SMM or ALL profiles.
>
> Uncompressed LZMA Compressed
> CPU CRYPTO_SERVICES Module EC=FALSE EC=TRUE EC=FALSE EC=TRUE Increase
> ==== =============== ======== ======== ======= ======== ======= ========
> IA32 NONE CryptoPei 21536 21568 0 KB
> IA32 NONE CryptoDxe 21632 21696 0 KB
> IA32 NONE CryptoSmm 22976 23072 0 KB
> IA32 MIN_PEI CryptoPei 248992 249120 0 KB
> IA32 MIN_DXE_MIN_SMM CryptoDxe 636672 829568 288520 401034 113 KB
> IA32 MIN_DXE_MIN_SMM CryptoSmm 426048 601472 191517 296022 105 KB
> IA32 ALL CryptoPei 423840 598976 189047 293759 104 KB
> IA32 ALL CryptoDxe 645280 838144 292955 405277 113 KB
> IA32 ALL CryptoSmm 441888 617184 198779 303628 105 KB
> X64 NONE CryptoPei 29632 29664 0 KB
> X64 NONE CryptoDxe 29792 29792 0 KB
> X64 NONE CryptoSmm 31296 31296 0 KB
> X64 MIN_PEI CryptoPei 310784 310848 0 KB
> X64 MIN_DXE_MIN_SMM CryptoDxe 804288 1016256 311436 426596 115 KB
> X64 MIN_DXE_MIN_SMM CryptoSmm 543776 733920 204483 310775 106 KB
> X64 ALL CryptoPei 540384 730240 202494 308467 106 KB
> X64 ALL CryptoDxe 815392 1027296 316228 431321 115 KB
> X64 ALL CryptoSmm 563648 753696 213488 319644 106 KB
>
> NOTE: Even if multiple modules in an FV use static linking of Crypto libs, if the
> entire FV is compressed, the total size impact is typically the size of a
> single instance of a compressed CryptoLib. The sizes of the Crypto* modules
> in the table above should be a close approximation of the size impact to a
> single FV.
>
> Does this match your previous size analysis?
>
> The critical issue to evaluate here is why adding the EC sources to OpensllLib.inf
> causes the modules that do not use any EC services to grow by ~105KB. Has any
> detailed analysis of the final linked images been performed to see where this
> additional size is coming from?
>
> Thanks,
>
> Mike
>
> > -----Original Message-----
> > From: Li, Yi1 <yi1.li@intel.com>
> > Sent: Thursday, September 22, 2022 5:54 AM
> > To: Kinney, Michael D <michael.d.kinney@intel.com>; devel@edk2.groups.io; Kishore, Shelly <shelly.kishore@intel.com>
> > Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> > Guomin <guomin.jiang@intel.com>
> > Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
> >
> > Hi Mike,
> > I have did some POC that seems existed structured PCD is hard to control binary size,
> > Here is the previous discussion for reference.
> > https://bugzilla.tianocore.org/show_bug.cgi?id=3679
> > https://edk2.groups.io/g/devel/topic/86257810#81814
> > https://bugzilla.tianocore.org/show_bug.cgi?id=1446
> >
> > Anyway EC is an important feature which consumed by vary modern security features such WPA3 , SPDM, TLS1.3 etc.
> > Hope it can be added to edk2, and I am glad to take the code and test work if there are other ways to control the size.
> >
> > Thanks,
> > Yi
> >
> > -----Original Message-----
> > From: Kinney, Michael D <michael.d.kinney@intel.com>
> > Sent: Thursday, September 22, 2022 11:56 AM
> > To: Li, Yi1 <yi1.li@intel.com>; devel@edk2.groups.io; Kishore, Shelly <shelly.kishore@intel.com>
> > Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> > Guomin <guomin.jiang@intel.com>
> > Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
> >
> > That change to OpensslLib.inf should not have been done either.
> >
> > Looks like this EC feature needs more evaluation to fit into the
> > structured PCD control of the lib sizes.
> >
> > Mike
> >
> > > -----Original Message-----
> > > From: Li, Yi1 <yi1.li@intel.com>
> > > Sent: Wednesday, September 21, 2022 7:16 PM
> > > To: Kinney, Michael D <michael.d.kinney@intel.com>; devel@edk2.groups.io
> > > Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> > > Guomin <guomin.jiang@intel.com>
> > > Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
> > >
> > > Hi Mike,
> > > Thanks for review.
> > >
> > > Even PCD_CRYPTO_SERVICE_FAMILY_ENABLE is set to 0, CryptoEc.c will also be compiled and throw build error:
> > >
> > > d:\workspace\tianocore\edk2\CryptoPkg\Library\BaseCryptLib\Pk\CryptEc.c(77): error C2220: the following warning is treated
> > as
> > > an error
> > > 1 file(s) copied.
> > > d:\workspace\tianocore\edk2\CryptoPkg\Library\BaseCryptLib\Pk\CryptEc.c(77): warning C4013: 'EC_GROUP_new_by_curve_name'
> > > undefined; assuming extern returning int
> > > d:\workspace\tianocore\edk2\CryptoPkg\Library\BaseCryptLib\Pk\CryptEc.c(77): warning C4047: 'return': 'void *' differs in
> > > levels of indirection from 'int'
> > > d:\workspace\tianocore\edk2\CryptoPkg\Library\BaseCryptLib\Pk\CryptEc.c(105): warning C4013: 'EC_GROUP_get_curve'
> undefined;
> > > assuming extern returning int
> > >
> > > I think the root cause is that we have enabled conditional ec in OpensslLib.inf before by PcdOpensslEcEnabled,
> > >
> >
> https://github.com/tianocore/edk2/blob/2c17d676e402d75a3a674499342f7ddaccf387bd/CryptoPkg/Library/OpensslLib/OpensslLib.inf#L2
> > > 02-L238
> > > if PcdOpensslEcEnabled not true, all ec files will not be compiled.
> > > This will save 200+kb memory on platforms which use dxe driver but do not need ec feature.
> > >
> > > So I add this PCD to BaseCryptLib.inf also to avoid build error, Not sure if there is any other way, other better ideas
> are
> > > welcome.
> > >
> > > Thanks,
> > > Yi
> > >
> > > -----Original Message-----
> > > From: Kinney, Michael D <michael.d.kinney@intel.com>
> > > Sent: Thursday, September 22, 2022 12:22 AM
> > > To: devel@edk2.groups.io; Li, Yi1 <yi1.li@intel.com>; Kinney, Michael D <michael.d.kinney@intel.com>
> > > Cc: Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1 <xiaoyu1.lu@intel.com>; Jiang,
> > > Guomin <guomin.jiang@intel.com>
> > > Subject: RE: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
> > >
> > > Comments embedded below.
> > >
> > > Mike
> > >
> > > > -----Original Message-----
> > > > From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of yi1 li
> > > > Sent: Tuesday, September 20, 2022 9:55 PM
> > > > To: devel@edk2.groups.io
> > > > Cc: Li, Yi1 <yi1.li@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>; Wang, Jian J <jian.j.wang@intel.com>; Lu, Xiaoyu1
> > > > <xiaoyu1.lu@intel.com>; Jiang, Guomin <guomin.jiang@intel.com>
> > > > Subject: [edk2-devel] [PATCH V2 1/3] CryptoPkg: Add EC support
> > > >
> > > > REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3828
> > > >
> > > > This patch is used to add CryptEc library, which is wrapped
> > > > over OpenSSL.
> > > >
> > > > Cc: Jiewen Yao <jiewen.yao@intel.com>
> > > > Cc: Jian J Wang <jian.j.wang@intel.com>
> > > > Cc: Xiaoyu Lu <xiaoyu1.lu@intel.com>
> > > > Cc: Guomin Jiang <guomin.jiang@intel.com>
> > > >
> > > > Signed-off-by: Yi Li <yi1.li@intel.com>
> > > > ---
> > > > CryptoPkg/Include/Library/BaseCryptLib.h | 424 ++++++++++
> > > > .../Library/BaseCryptLib/BaseCryptLib.inf | 2 +
> > > > .../Library/BaseCryptLib/PeiCryptLib.inf | 1 +
> > > > CryptoPkg/Library/BaseCryptLib/Pk/CryptEc.c | 765 ++++++++++++++++++
> > > > .../Library/BaseCryptLib/Pk/CryptEcNull.c | 496 ++++++++++++
> > > > .../Library/BaseCryptLib/SmmCryptLib.inf | 1 +
> > > > .../BaseCryptLibNull/BaseCryptLibNull.inf | 1 +
> > > > .../Library/BaseCryptLibNull/Pk/CryptEcNull.c | 496 ++++++++++++
> > > > 8 files changed, 2186 insertions(+)
> > > > create mode 100644 CryptoPkg/Library/BaseCryptLib/Pk/CryptEc.c
> > > > create mode 100644 CryptoPkg/Library/BaseCryptLib/Pk/CryptEcNull.c
> > > > create mode 100644 CryptoPkg/Library/BaseCryptLibNull/Pk/CryptEcNull.c
> > > >
> > > > diff --git a/CryptoPkg/Include/Library/BaseCryptLib.h b/CryptoPkg/Include/Library/BaseCryptLib.h
> > > > index b253923dd8..d74fc21c1e 100644
> > > > --- a/CryptoPkg/Include/Library/BaseCryptLib.h
> > > > +++ b/CryptoPkg/Include/Library/BaseCryptLib.h
> > > > @@ -14,6 +14,13 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
> > > >
> > > > #include <Uefi/UefiBaseType.h>
> > > >
> > > > +#define CRYPTO_NID_NULL 0x0000
> > > > +
> > > > +// Key Exchange
> > > > +#define CRYPTO_NID_SECP256R1 0x0204
> > > > +#define CRYPTO_NID_SECP384R1 0x0205
> > > > +#define CRYPTO_NID_SECP521R1 0x0206
> > > > +
> > > > ///
> > > > /// MD5 digest size in bytes
> > > > ///
> > > > @@ -2850,4 +2857,421 @@ BigNumAddMod (
> > > > OUT VOID *BnRes
> > > > );
> > > >
> > > > +// =====================================================================================
> > > > +// Basic Elliptic Curve Primitives
> > > > +// =====================================================================================
> > > > +
> > > > +/**
> > > > + Initialize new opaque EcGroup object. This object represents an EC curve and
> > > > + and is used for calculation within this group. This object should be freed
> > > > + using EcGroupFree() function.
> > > > +
> > > > + @param[in] CryptoNid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > +
> > > > + @retval EcGroup object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcGroupInit (
> > > > + IN UINTN CryptoNid
> > > > + );
> > > > +
> > > > +/**
> > > > + Get EC curve parameters. While elliptic curve equation is Y^2 mod P = (X^3 + AX + B) Mod P.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnPrime Group prime number.
> > > > + @param[out] BnA A coefficient.
> > > > + @param[out] BnB B coefficient.
> > > > + @param[in] BnCtx BN context.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *BnPrime,
> > > > + OUT VOID *BnA,
> > > > + OUT VOID *BnB,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Get EC group order.
> > > > + This function will set the provided Big Number object to the corresponding
> > > > + value. The caller needs to make sure that the "out" BigNumber parameter
> > > > + is properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnOrder Group prime number.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetOrder (
> > > > + IN VOID *EcGroup,
> > > > + OUT VOID *BnOrder
> > > > + );
> > > > +
> > > > +/**
> > > > + Free previously allocated EC group object using EcGroupInit().
> > > > +
> > > > + @param[in] EcGroup EC group object to free.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcGroupFree (
> > > > + IN VOID *EcGroup
> > > > + );
> > > > +
> > > > +/**
> > > > + Initialize new opaque EC Point object. This object represents an EC point
> > > > + within the given EC group (curve).
> > > > +
> > > > + @param[in] EC Group, properly initialized using EcGroupInit().
> > > > +
> > > > + @retval EC Point object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcPointInit (
> > > > + IN CONST VOID *EcGroup
> > > > + );
> > > > +
> > > > +/**
> > > > + Free previously allocated EC Point object using EcPointInit().
> > > > +
> > > > + @param[in] EcPoint EC Point to free.
> > > > + @param[in] Clear TRUE iff the memory should be cleared.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcPointDeInit (
> > > > + IN VOID *EcPoint,
> > > > + IN BOOLEAN Clear
> > > > + );
> > > > +
> > > > +/**
> > > > + Get EC point affine (x,y) coordinates.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[out] BnX X coordinate.
> > > > + @param[out] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointGetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + OUT VOID *BnX,
> > > > + OUT VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Set EC point affine (x,y) coordinates.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN CONST VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + EC Point addition. EcPointResult = EcPointA + EcPointB.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPointA EC Point.
> > > > + @param[in] EcPointB EC Point.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointAdd (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Variable EC point multiplication. EcPointResult = EcPoint * BnPScalar.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnPScalar P Scalar.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointMul (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN CONST VOID *BnPScalar,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Calculate the inverse of the supplied EC point.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in,out] EcPoint EC point to invert.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointInvert (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN OUT VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Check if the supplied point is on EC curve.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On curve.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsOnCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Check if the supplied point is at infinity.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > +
> > > > + @retval TRUE At infinity.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsAtInfinity (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint
> > > > + );
> > > > +
> > > > +/**
> > > > + Check if EC points are equal.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPointA EC point A.
> > > > + @param[in] EcPointB EC point B.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE A == B.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointEqual (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +/**
> > > > + Set EC point compressed coordinates. Points can be described in terms of
> > > > + their compressed coordinates. For a point (x, y), for any given value for x
> > > > + such that the point is on the curve there will only ever be two possible
> > > > + values for y. Therefore, a point can be set using this function where BnX is
> > > > + the x coordinate and YBit is a value 0 or 1 to identify which of the two
> > > > + possible values for y should be used.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] YBit 0 or 1 to identify which Y value is used.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetCompressedCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN UINT8 YBit,
> > > > + IN VOID *BnCtx
> > > > + );
> > > > +
> > > > +// =====================================================================================
> > > > +// Elliptic Curve Diffie Hellman Primitives
> > > > +// =====================================================================================
> > > > +
> > > > +/**
> > > > + Allocates and Initializes one Elliptic Curve Context for subsequent use
> > > > + with the NID.
> > > > +
> > > > + @param[in] Nid cipher NID
> > > > + @return Pointer to the Elliptic Curve Context that has been initialized.
> > > > + If the allocations fails, EcNewByNid() returns NULL.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcNewByNid (
> > > > + IN UINTN Nid
> > > > + );
> > > > +
> > > > +/**
> > > > + Release the specified EC context.
> > > > +
> > > > + @param[in] EcContext Pointer to the EC context to be released.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcFree (
> > > > + IN VOID *EcContext
> > > > + );
> > > > +
> > > > +/**
> > > > + Generates EC key and returns EC public key (X, Y), Please note, this function uses
> > > > + pseudo random number generator. The caller must make sure RandomSeed()
> > > > + function was properly called before.
> > > > + The Ec context should be correctly initialized by EcNewByNid.
> > > > + This function generates random secret, and computes the public key (X, Y), which is
> > > > + returned via parameter Public, PublicSize.
> > > > + X is the first half of Public with size being PublicSize / 2,
> > > > + Y is the second half of Public with size being PublicSize / 2.
> > > > + EC context is updated accordingly.
> > > > + If the Public buffer is too small to hold the public X, Y, FALSE is returned and
> > > > + PublicSize is set to the required buffer size to obtain the public X, Y.
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PublicSize is NULL, then return FALSE.
> > > > + If PublicSize is large enough but Public is NULL, then return FALSE.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC public X,Y generation succeeded.
> > > > + @retval FALSE EC public X,Y generation failed.
> > > > + @retval FALSE PublicKeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGenerateKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + );
> > > > +
> > > > +/**
> > > > + Gets the public key component from the established EC context.
> > > > + The Ec context should be correctly initialized by EcNewByNid, and successfully
> > > > + generate key pair from EcGenerateKey().
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to EC context being set.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC key component was retrieved successfully.
> > > > + @retval FALSE Invalid EC key component.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGetPubKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + );
> > > > +
> > > > +/**
> > > > + Computes exchanged common key.
> > > > + Given peer's public key (X, Y), this function computes the exchanged common key,
> > > > + based on its own context including value of curve parameter and random secret.
> > > > + X is the first half of PeerPublic with size being PeerPublicSize / 2,
> > > > + Y is the second half of PeerPublic with size being PeerPublicSize / 2.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PeerPublic is NULL, then return FALSE.
> > > > + If PeerPublicSize is 0, then return FALSE.
> > > > + If Key is NULL, then return FALSE.
> > > > + If KeySize is not large enough, then return FALSE.
> > > > + For P-256, the PeerPublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PeerPublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PeerPublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[in] PeerPublic Pointer to the peer's public X,Y.
> > > > + @param[in] PeerPublicSize Size of peer's public X,Y in bytes.
> > > > + @param[in] CompressFlag Flag of PeerPublic is compressed or not.
> > > > + @param[out] Key Pointer to the buffer to receive generated key.
> > > > + @param[in, out] KeySize On input, the size of Key buffer in bytes.
> > > > + On output, the size of data returned in Key buffer in bytes.
> > > > + @retval TRUE EC exchanged key generation succeeded.
> > > > + @retval FALSE EC exchanged key generation failed.
> > > > + @retval FALSE KeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcDhComputeKey (
> > > > + IN OUT VOID *EcContext,
> > > > + IN CONST UINT8 *PeerPublic,
> > > > + IN UINTN PeerPublicSize,
> > > > + IN CONST INT32 *CompressFlag,
> > > > + OUT UINT8 *Key,
> > > > + IN OUT UINTN *KeySize
> > > > + );
> > > > +
> > > > #endif // __BASE_CRYPT_LIB_H__
> > > > diff --git a/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
> > > > index 9e4be2fb0d..ade6ee3fdd 100644
> > > > --- a/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
> > > > +++ b/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
> > > > @@ -52,6 +52,8 @@
> > > > Pk/CryptTs.c
> > > > Pk/CryptRsaPss.c
> > > > Pk/CryptRsaPssSign.c
> > > > + Pk/CryptEcNull.c |*|*|*|!gEfiCryptoPkgTokenSpaceGuid.PcdOpensslEcEnabled
> > > > + Pk/CryptEc.c |*|*|*|gEfiCryptoPkgTokenSpaceGuid.PcdOpensslEcEnabled
> > >
> > > The use of the PCD to select the file should not be needed here. The
> > > Ec Family and individual service enable/disable fields in the
> > > PCD_CRYPTO_SERVICE_FAMILY_ENABLE structured PCD are all that is needed to
> > > disable the Ec services.
> > >
> > > The PCD gEfiCryptoPkgTokenSpaceGuid.PcdOpensslEcEnabled should be removed
> > > completely as part of this patch series.
> > >
> > > > Pem/CryptPem.c
> > > > Bn/CryptBn.c
> > > >
> > > > diff --git a/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
> > > > index 65ad23fb81..383df2b23c 100644
> > > > --- a/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
> > > > +++ b/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
> > > > @@ -58,6 +58,7 @@
> > > > Pk/CryptTsNull.c
> > > > Pk/CryptRsaPss.c
> > > > Pk/CryptRsaPssSignNull.c
> > > > + Pk/CryptEcNull.c
> > > > Pem/CryptPemNull.c
> > > > Rand/CryptRandNull.c
> > > > Bn/CryptBnNull.c
> > > > diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptEc.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptEc.c
> > > > new file mode 100644
> > > > index 0000000000..396c819834
> > > > --- /dev/null
> > > > +++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptEc.c
> > > > @@ -0,0 +1,765 @@
> > > > +/** @file
> > > > + Elliptic Curve and ECDH API implementation based on OpenSSL
> > > > +
> > > > + Copyright (c) 2022, Intel Corporation. All rights reserved.<BR>
> > > > + SPDX-License-Identifier: BSD-2-Clause-Patent
> > > > +
> > > > +**/
> > > > +
> > > > +#include "InternalCryptLib.h"
> > > > +#include <openssl/objects.h>
> > > > +#include <openssl/bn.h>
> > > > +#include <openssl/ec.h>
> > > > +
> > > > +// =====================================================================================
> > > > +// Basic Elliptic Curve Primitives
> > > > +// =====================================================================================
> > > > +
> > > > +/**
> > > > + Return the Nid of certain ECC curve.
> > > > +
> > > > + @param[in] CryptoNid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > +
> > > > + @retval !=-1 On success.
> > > > + @retval -1 ECC curve not supported.
> > > > +**/
> > > > +STATIC
> > > > +INT32
> > > > +CryptoNidToOpensslNid (
> > > > + IN UINTN CryptoNid
> > > > + )
> > > > +{
> > > > + INT32 Nid;
> > > > +
> > > > + switch (CryptoNid) {
> > > > + case CRYPTO_NID_SECP256R1:
> > > > + Nid = NID_X9_62_prime256v1;
> > > > + break;
> > > > + case CRYPTO_NID_SECP384R1:
> > > > + Nid = NID_secp384r1;
> > > > + break;
> > > > + case CRYPTO_NID_SECP521R1:
> > > > + Nid = NID_secp521r1;
> > > > + break;
> > > > + default:
> > > > + return -1;
> > > > + }
> > > > +
> > > > + return Nid;
> > > > +}
> > > > +
> > > > +/**
> > > > + Initialize new opaque EcGroup object. This object represents an EC curve and
> > > > + and is used for calculation within this group. This object should be freed
> > > > + using EcGroupFree() function.
> > > > +
> > > > + @param[in] CryptoNid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > +
> > > > + @retval EcGroup object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcGroupInit (
> > > > + IN UINTN CryptoNid
> > > > + )
> > > > +{
> > > > + INT32 Nid;
> > > > +
> > > > + Nid = CryptoNidToOpensslNid (CryptoNid);
> > > > +
> > > > + if (Nid < 0) {
> > > > + return NULL;
> > > > + }
> > > > +
> > > > + return EC_GROUP_new_by_curve_name (Nid);
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC curve parameters. While elliptic curve equation is Y^2 mod P = (X^3 + AX + B) Mod P.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnPrime Group prime number.
> > > > + @param[out] BnA A coefficient.
> > > > + @param[out] BnB B coefficient..
> > > > + @param[in] BnCtx BN context.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *BnPrime,
> > > > + OUT VOID *BnA,
> > > > + OUT VOID *BnB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_GROUP_get_curve (EcGroup, BnPrime, BnA, BnB, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC group order.
> > > > + This function will set the provided Big Number object to the corresponding
> > > > + value. The caller needs to make sure that the "out" BigNumber parameter
> > > > + is properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnOrder Group prime number.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetOrder (
> > > > + IN VOID *EcGroup,
> > > > + OUT VOID *BnOrder
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_GROUP_get_order (EcGroup, BnOrder, NULL);
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC group object using EcGroupInit().
> > > > +
> > > > + @param[in] EcGroup EC group object to free.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcGroupFree (
> > > > + IN VOID *EcGroup
> > > > + )
> > > > +{
> > > > + EC_GROUP_free (EcGroup);
> > > > +}
> > > > +
> > > > +/**
> > > > + Initialize new opaque EC Point object. This object represents an EC point
> > > > + within the given EC group (curve).
> > > > +
> > > > + @param[in] EC Group, properly initialized using EcGroupInit().
> > > > +
> > > > + @retval EC Point object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcPointInit (
> > > > + IN CONST VOID *EcGroup
> > > > + )
> > > > +{
> > > > + return EC_POINT_new (EcGroup);
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC Point object using EcPointInit().
> > > > +
> > > > + @param[in] EcPoint EC Point to free.
> > > > + @param[in] Clear TRUE iff the memory should be cleared.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcPointDeInit (
> > > > + IN VOID *EcPoint,
> > > > + IN BOOLEAN Clear
> > > > + )
> > > > +{
> > > > + if (Clear) {
> > > > + EC_POINT_clear_free (EcPoint);
> > > > + } else {
> > > > + EC_POINT_free (EcPoint);
> > > > + }
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC point affine (x,y) coordinates.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[out] BnX X coordinate.
> > > > + @param[out] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointGetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + OUT VOID *BnX,
> > > > + OUT VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_get_affine_coordinates (EcGroup, EcPoint, BnX, BnY, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point affine (x,y) coordinates.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN CONST VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_set_affine_coordinates (EcGroup, EcPoint, BnX, BnY, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + EC Point addition. EcPointResult = EcPointA + EcPointB.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPointA EC Point.
> > > > + @param[in] EcPointB EC Point.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointAdd (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_add (EcGroup, EcPointResult, EcPointA, EcPointB, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + Variable EC point multiplication. EcPointResult = EcPoint * BnPScalar.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnPScalar P Scalar.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointMul (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN CONST VOID *BnPScalar,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_mul (EcGroup, EcPointResult, NULL, EcPoint, BnPScalar, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + Calculate the inverse of the supplied EC point.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in,out] EcPoint EC point to invert.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointInvert (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN OUT VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_invert (EcGroup, EcPoint, BnCtx);
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is on EC curve.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On curve.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsOnCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return EC_POINT_is_on_curve (EcGroup, EcPoint, BnCtx) == 1;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is at infinity.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > +
> > > > + @retval TRUE At infinity.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsAtInfinity (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint
> > > > + )
> > > > +{
> > > > + return EC_POINT_is_at_infinity (EcGroup, EcPoint) == 1;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if EC points are equal.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPointA EC point A.
> > > > + @param[in] EcPointB EC point B.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE A == B.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointEqual (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return EC_POINT_cmp (EcGroup, EcPointA, EcPointB, BnCtx) == 0;
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point compressed coordinates. Points can be described in terms of
> > > > + their compressed coordinates. For a point (x, y), for any given value for x
> > > > + such that the point is on the curve there will only ever be two possible
> > > > + values for y. Therefore, a point can be set using this function where BnX is
> > > > + the x coordinate and YBit is a value 0 or 1 to identify which of the two
> > > > + possible values for y should be used.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] YBit 0 or 1 to identify which Y value is used.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetCompressedCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN UINT8 YBit,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + return (BOOLEAN)EC_POINT_set_compressed_coordinates (EcGroup, EcPoint, BnX, YBit, BnCtx);
> > > > +}
> > > > +
> > > > +// =====================================================================================
> > > > +// Elliptic Curve Diffie Hellman Primitives
> > > > +// =====================================================================================
> > > > +
> > > > +/**
> > > > + Allocates and Initializes one Elliptic Curve Context for subsequent use
> > > > + with the NID.
> > > > +
> > > > + @param[in] Nid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > + @return Pointer to the Elliptic Curve Context that has been initialized.
> > > > + If the allocations fails, EcNewByNid() returns NULL.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcNewByNid (
> > > > + IN UINTN Nid
> > > > + )
> > > > +{
> > > > + INT32 OpenSslNid;
> > > > +
> > > > + OpenSslNid = CryptoNidToOpensslNid (Nid);
> > > > + if (OpenSslNid < 0) {
> > > > + return NULL;
> > > > + }
> > > > +
> > > > + return (VOID *)EC_KEY_new_by_curve_name (OpenSslNid);
> > > > +}
> > > > +
> > > > +/**
> > > > + Release the specified EC context.
> > > > +
> > > > + @param[in] EcContext Pointer to the EC context to be released.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcFree (
> > > > + IN VOID *EcContext
> > > > + )
> > > > +{
> > > > + EC_KEY_free ((EC_KEY *)EcContext);
> > > > +}
> > > > +
> > > > +/**
> > > > + Generates EC key and returns EC public key (X, Y), Please note, this function uses
> > > > + pseudo random number generator. The caller must make sure RandomSeed()
> > > > + function was properly called before.
> > > > + The Ec context should be correctly initialized by EcNewByNid.
> > > > + This function generates random secret, and computes the public key (X, Y), which is
> > > > + returned via parameter Public, PublicSize.
> > > > + X is the first half of Public with size being PublicSize / 2,
> > > > + Y is the second half of Public with size being PublicSize / 2.
> > > > + EC context is updated accordingly.
> > > > + If the Public buffer is too small to hold the public X, Y, FALSE is returned and
> > > > + PublicSize is set to the required buffer size to obtain the public X, Y.
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PublicSize is NULL, then return FALSE.
> > > > + If PublicSize is large enough but Public is NULL, then return FALSE.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC public X,Y generation succeeded.
> > > > + @retval FALSE EC public X,Y generation failed.
> > > > + @retval FALSE PublicKeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGenerateKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + EC_KEY *EcKey;
> > > > + CONST EC_GROUP *Group;
> > > > + CONST EC_POINT *EcPoint;
> > > > + BOOLEAN RetVal;
> > > > + BIGNUM *BnX;
> > > > + BIGNUM *BnY;
> > > > + UINTN HalfSize;
> > > > + INTN XSize;
> > > > + INTN YSize;
> > > > +
> > > > + if ((EcContext == NULL) || (PublicKeySize == NULL)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if ((PublicKey == NULL) && (*PublicKeySize != 0)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + EcKey = (EC_KEY *)EcContext;
> > > > + Group = EC_KEY_get0_group (EcKey);
> > > > + HalfSize = (EC_GROUP_get_degree (Group) + 7) / 8;
> > > > +
> > > > + // Assume RAND_seed was called
> > > > + if (EC_KEY_generate_key (EcKey) != 1) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if (*PublicKeySize < HalfSize * 2) {
> > > > + *PublicKeySize = HalfSize * 2;
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + *PublicKeySize = HalfSize * 2;
> > > > +
> > > > + EcPoint = EC_KEY_get0_public_key (EcKey);
> > > > + if (EcPoint == NULL) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + RetVal = FALSE;
> > > > + BnX = BN_new ();
> > > > + BnY = BN_new ();
> > > > + if ((BnX == NULL) || (BnY == NULL)) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (EC_POINT_get_affine_coordinates (Group, EcPoint, BnX, BnY, NULL) != 1) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + XSize = BN_num_bytes (BnX);
> > > > + YSize = BN_num_bytes (BnY);
> > > > + if ((XSize <= 0) || (YSize <= 0)) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + ASSERT ((UINTN)XSize <= HalfSize && (UINTN)YSize <= HalfSize);
> > > > +
> > > > + ZeroMem (PublicKey, *PublicKeySize);
> > > > + BN_bn2bin (BnX, &PublicKey[0 + HalfSize - XSize]);
> > > > + BN_bn2bin (BnY, &PublicKey[HalfSize + HalfSize - YSize]);
> > > > +
> > > > + RetVal = TRUE;
> > > > +
> > > > +fail:
> > > > + BN_free (BnX);
> > > > + BN_free (BnY);
> > > > + return RetVal;
> > > > +}
> > > > +
> > > > +/**
> > > > + Gets the public key component from the established EC context.
> > > > + The Ec context should be correctly initialized by EcNewByNid, and successfully
> > > > + generate key pair from EcGenerateKey().
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to EC context being set.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC key component was retrieved successfully.
> > > > + @retval FALSE Invalid EC key component.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGetPubKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + EC_KEY *EcKey;
> > > > + CONST EC_GROUP *Group;
> > > > + CONST EC_POINT *EcPoint;
> > > > + BIGNUM *BnX;
> > > > + BIGNUM *BnY;
> > > > + UINTN HalfSize;
> > > > + INTN XSize;
> > > > + INTN YSize;
> > > > + BOOLEAN RetVal;
> > > > +
> > > > + if ((EcContext == NULL) || (PublicKeySize == NULL)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if ((PublicKey == NULL) && (*PublicKeySize != 0)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + EcKey = (EC_KEY *)EcContext;
> > > > + Group = EC_KEY_get0_group (EcKey);
> > > > + HalfSize = (EC_GROUP_get_degree (Group) + 7) / 8;
> > > > + if (*PublicKeySize < HalfSize * 2) {
> > > > + *PublicKeySize = HalfSize * 2;
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + *PublicKeySize = HalfSize * 2;
> > > > +
> > > > + EcPoint = EC_KEY_get0_public_key (EcKey);
> > > > + if (EcPoint == NULL) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + RetVal = FALSE;
> > > > + BnX = BN_new ();
> > > > + BnY = BN_new ();
> > > > + if ((BnX == NULL) || (BnY == NULL)) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (EC_POINT_get_affine_coordinates (Group, EcPoint, BnX, BnY, NULL) != 1) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + XSize = BN_num_bytes (BnX);
> > > > + YSize = BN_num_bytes (BnY);
> > > > + if ((XSize <= 0) || (YSize <= 0)) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + ASSERT ((UINTN)XSize <= HalfSize && (UINTN)YSize <= HalfSize);
> > > > +
> > > > + if (PublicKey != NULL) {
> > > > + ZeroMem (PublicKey, *PublicKeySize);
> > > > + BN_bn2bin (BnX, &PublicKey[0 + HalfSize - XSize]);
> > > > + BN_bn2bin (BnY, &PublicKey[HalfSize + HalfSize - YSize]);
> > > > + }
> > > > +
> > > > + RetVal = TRUE;
> > > > +
> > > > +fail:
> > > > + BN_free (BnX);
> > > > + BN_free (BnY);
> > > > + return RetVal;
> > > > +}
> > > > +
> > > > +/**
> > > > + Computes exchanged common key.
> > > > + Given peer's public key (X, Y), this function computes the exchanged common key,
> > > > + based on its own context including value of curve parameter and random secret.
> > > > + X is the first half of PeerPublic with size being PeerPublicSize / 2,
> > > > + Y is the second half of PeerPublic with size being PeerPublicSize / 2.
> > > > + If public key is compressed, the PeerPublic will only contain half key (X).
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PeerPublic is NULL, then return FALSE.
> > > > + If PeerPublicSize is 0, then return FALSE.
> > > > + If Key is NULL, then return FALSE.
> > > > + If KeySize is not large enough, then return FALSE.
> > > > + For P-256, the PeerPublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PeerPublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PeerPublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[in] PeerPublic Pointer to the peer's public X,Y.
> > > > + @param[in] PeerPublicSize Size of peer's public X,Y in bytes.
> > > > + @param[in] CompressFlag Flag of PeerPublic is compressed or not.
> > > > + @param[out] Key Pointer to the buffer to receive generated key.
> > > > + @param[in, out] KeySize On input, the size of Key buffer in bytes.
> > > > + On output, the size of data returned in Key buffer in bytes.
> > > > + @retval TRUE EC exchanged key generation succeeded.
> > > > + @retval FALSE EC exchanged key generation failed.
> > > > + @retval FALSE KeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcDhComputeKey (
> > > > + IN OUT VOID *EcContext,
> > > > + IN CONST UINT8 *PeerPublic,
> > > > + IN UINTN PeerPublicSize,
> > > > + IN CONST INT32 *CompressFlag,
> > > > + OUT UINT8 *Key,
> > > > + IN OUT UINTN *KeySize
> > > > + )
> > > > +{
> > > > + EC_KEY *EcKey;
> > > > + EC_KEY *PeerEcKey;
> > > > + CONST EC_GROUP *Group;
> > > > + BOOLEAN RetVal;
> > > > + BIGNUM *BnX;
> > > > + BIGNUM *BnY;
> > > > + EC_POINT *Point;
> > > > + INT32 OpenSslNid;
> > > > + UINTN HalfSize;
> > > > +
> > > > + if ((EcContext == NULL) || (PeerPublic == NULL) || (KeySize == NULL)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if ((Key == NULL) && (*KeySize != 0)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if (PeerPublicSize > INT_MAX) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + EcKey = (EC_KEY *)EcContext;
> > > > + Group = EC_KEY_get0_group (EcKey);
> > > > + HalfSize = (EC_GROUP_get_degree (Group) + 7) / 8;
> > > > + if ((CompressFlag == NULL) && (PeerPublicSize != HalfSize * 2)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if ((CompressFlag != NULL) && (PeerPublicSize != HalfSize)) {
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + if (*KeySize < HalfSize) {
> > > > + *KeySize = HalfSize;
> > > > + return FALSE;
> > > > + }
> > > > +
> > > > + *KeySize = HalfSize;
> > > > +
> > > > + RetVal = FALSE;
> > > > + Point = NULL;
> > > > + BnX = BN_bin2bn (PeerPublic, (INT32)HalfSize, NULL);
> > > > + BnY = NULL;
> > > > + Point = EC_POINT_new (Group);
> > > > + PeerEcKey = NULL;
> > > > + if ((BnX == NULL) || (Point == NULL)) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (CompressFlag == NULL) {
> > > > + BnY = BN_bin2bn (PeerPublic + HalfSize, (INT32)HalfSize, NULL);
> > > > + if (BnY == NULL) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (EC_POINT_set_affine_coordinates (Group, Point, BnX, BnY, NULL) != 1) {
> > > > + goto fail;
> > > > + }
> > > > + } else {
> > > > + if (EC_POINT_set_compressed_coordinates (Group, Point, BnX, *CompressFlag, NULL) != 1) {
> > > > + goto fail;
> > > > + }
> > > > + }
> > > > +
> > > > + // Validate NIST ECDH public key
> > > > + OpenSslNid = EC_GROUP_get_curve_name (Group);
> > > > + PeerEcKey = EC_KEY_new_by_curve_name (OpenSslNid);
> > > > + if (PeerEcKey == NULL) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (EC_KEY_set_public_key (PeerEcKey, Point) != 1) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (EC_KEY_check_key (PeerEcKey) != 1) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + if (ECDH_compute_key (Key, *KeySize, Point, EcKey, NULL) <= 0) {
> > > > + goto fail;
> > > > + }
> > > > +
> > > > + RetVal = TRUE;
> > > > +
> > > > +fail:
> > > > + BN_free (BnX);
> > > > + BN_free (BnY);
> > > > + EC_POINT_free (Point);
> > > > + EC_KEY_free (PeerEcKey);
> > > > + return RetVal;
> > > > +}
> > > > diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptEcNull.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptEcNull.c
> > > > new file mode 100644
> > > > index 0000000000..d9f1004f6c
> > > > --- /dev/null
> > > > +++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptEcNull.c
> > > > @@ -0,0 +1,496 @@
> > > > +/** @file
> > > > + Elliptic Curve and ECDH API implementation based on OpenSSL
> > > > +
> > > > + Copyright (c) 2022, Intel Corporation. All rights reserved.<BR>
> > > > + SPDX-License-Identifier: BSD-2-Clause-Patent
> > > > +
> > > > +**/
> > > > +
> > > > +#include <Library/BaseCryptLib.h>
> > > > +#include <Library/DebugLib.h>
> > > > +
> > > > +/**
> > > > + Initialize new opaque EcGroup object. This object represents an EC curve and
> > > > + and is used for calculation within this group. This object should be freed
> > > > + using EcGroupFree() function.
> > > > +
> > > > + @param[in] CryptoNid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > +
> > > > + @retval EcGroup object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcGroupInit (
> > > > + IN UINTN CryptoNid
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC curve parameters. While elliptic curve equation is Y^2 mod P = (X^3 + AX + B) Mod P.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnPrime Group prime number.
> > > > + @param[out] BnA A coefficient.
> > > > + @param[out] BnB B coefficient..
> > > > + @param[in] BnCtx BN context.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *BnPrime,
> > > > + OUT VOID *BnA,
> > > > + OUT VOID *BnB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC group order.
> > > > + This function will set the provided Big Number object to the corresponding
> > > > + value. The caller needs to make sure that the "out" BigNumber parameter
> > > > + is properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnOrder Group prime number.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetOrder (
> > > > + IN VOID *EcGroup,
> > > > + OUT VOID *BnOrder
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC group object using EcGroupInit().
> > > > +
> > > > + @param[in] EcGroup EC group object to free.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcGroupFree (
> > > > + IN VOID *EcGroup
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Initialize new opaque EC Point object. This object represents an EC point
> > > > + within the given EC group (curve).
> > > > +
> > > > + @param[in] EC Group, properly initialized using EcGroupInit().
> > > > +
> > > > + @retval EC Point object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcPointInit (
> > > > + IN CONST VOID *EcGroup
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC Point object using EcPointInit().
> > > > +
> > > > + @param[in] EcPoint EC Point to free.
> > > > + @param[in] Clear TRUE iff the memory should be cleared.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcPointDeInit (
> > > > + IN VOID *EcPoint,
> > > > + IN BOOLEAN Clear
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC point affine (x,y) coordinates.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[out] BnX X coordinate.
> > > > + @param[out] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointGetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + OUT VOID *BnX,
> > > > + OUT VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point affine (x,y) coordinates.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN CONST VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + EC Point addition. EcPointResult = EcPointA + EcPointB.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPointA EC Point.
> > > > + @param[in] EcPointB EC Point.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointAdd (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Variable EC point multiplication. EcPointResult = EcPoint * BnPScalar.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnPScalar P Scalar.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointMul (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN CONST VOID *BnPScalar,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Calculate the inverse of the supplied EC point.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in,out] EcPoint EC point to invert.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointInvert (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN OUT VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is on EC curve.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On curve.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsOnCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is at infinity.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > +
> > > > + @retval TRUE At infinity.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsAtInfinity (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if EC points are equal.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPointA EC point A.
> > > > + @param[in] EcPointB EC point B.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE A == B.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointEqual (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point compressed coordinates. Points can be described in terms of
> > > > + their compressed coordinates. For a point (x, y), for any given value for x
> > > > + such that the point is on the curve there will only ever be two possible
> > > > + values for y. Therefore, a point can be set using this function where BnX is
> > > > + the x coordinate and YBit is a value 0 or 1 to identify which of the two
> > > > + possible values for y should be used.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] YBit 0 or 1 to identify which Y value is used.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetCompressedCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN UINT8 YBit,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Allocates and Initializes one Elliptic Curve Context for subsequent use
> > > > + with the NID.
> > > > +
> > > > + @param[in] Nid cipher NID
> > > > + @return Pointer to the Elliptic Curve Context that has been initialized.
> > > > + If the allocations fails, EcNewByNid() returns NULL.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcNewByNid (
> > > > + IN UINTN Nid
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Release the specified EC context.
> > > > +
> > > > + @param[in] EcContext Pointer to the EC context to be released.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcFree (
> > > > + IN VOID *EcContext
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Generates EC key and returns EC public key (X, Y), Please note, this function uses
> > > > + pseudo random number generator. The caller must make sure RandomSeed()
> > > > + function was properly called before.
> > > > + The Ec context should be correctly initialized by EcNewByNid.
> > > > + This function generates random secret, and computes the public key (X, Y), which is
> > > > + returned via parameter Public, PublicSize.
> > > > + X is the first half of Public with size being PublicSize / 2,
> > > > + Y is the second half of Public with size being PublicSize / 2.
> > > > + EC context is updated accordingly.
> > > > + If the Public buffer is too small to hold the public X, Y, FALSE is returned and
> > > > + PublicSize is set to the required buffer size to obtain the public X, Y.
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PublicSize is NULL, then return FALSE.
> > > > + If PublicSize is large enough but Public is NULL, then return FALSE.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC public X,Y generation succeeded.
> > > > + @retval FALSE EC public X,Y generation failed.
> > > > + @retval FALSE PublicKeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGenerateKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Gets the public key component from the established EC context.
> > > > + The Ec context should be correctly initialized by EcNewByNid, and successfully
> > > > + generate key pair from EcGenerateKey().
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to EC context being set.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC key component was retrieved successfully.
> > > > + @retval FALSE Invalid EC key component.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGetPubKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Computes exchanged common key.
> > > > + Given peer's public key (X, Y), this function computes the exchanged common key,
> > > > + based on its own context including value of curve parameter and random secret.
> > > > + X is the first half of PeerPublic with size being PeerPublicSize / 2,
> > > > + Y is the second half of PeerPublic with size being PeerPublicSize / 2.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PeerPublic is NULL, then return FALSE.
> > > > + If PeerPublicSize is 0, then return FALSE.
> > > > + If Key is NULL, then return FALSE.
> > > > + If KeySize is not large enough, then return FALSE.
> > > > + For P-256, the PeerPublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PeerPublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PeerPublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[in] PeerPublic Pointer to the peer's public X,Y.
> > > > + @param[in] PeerPublicSize Size of peer's public X,Y in bytes.
> > > > + @param[in] CompressFlag Flag of PeerPublic is compressed or not.
> > > > + @param[out] Key Pointer to the buffer to receive generated key.
> > > > + @param[in, out] KeySize On input, the size of Key buffer in bytes.
> > > > + On output, the size of data returned in Key buffer in bytes.
> > > > + @retval TRUE EC exchanged key generation succeeded.
> > > > + @retval FALSE EC exchanged key generation failed.
> > > > + @retval FALSE KeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcDhComputeKey (
> > > > + IN OUT VOID *EcContext,
> > > > + IN CONST UINT8 *PeerPublic,
> > > > + IN UINTN PeerPublicSize,
> > > > + IN CONST INT32 *CompressFlag,
> > > > + OUT UINT8 *Key,
> > > > + IN OUT UINTN *KeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > diff --git a/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.inf
> > > > index ce6a789dfd..4bc3063485 100644
> > > > --- a/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.inf
> > > > +++ b/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.inf
> > > > @@ -59,6 +59,7 @@
> > > > Pk/CryptTsNull.c
> > > > Pk/CryptRsaPss.c
> > > > Pk/CryptRsaPssSignNull.c
> > > > + Pk/CryptEcNull.c
> > > > Pem/CryptPem.c
> > > > Bn/CryptBnNull.c
> > > >
> > > > diff --git a/CryptoPkg/Library/BaseCryptLibNull/BaseCryptLibNull.inf
> > > b/CryptoPkg/Library/BaseCryptLibNull/BaseCryptLibNull.inf
> > > > index 354f3d80aa..e1a57ef09f 100644
> > > > --- a/CryptoPkg/Library/BaseCryptLibNull/BaseCryptLibNull.inf
> > > > +++ b/CryptoPkg/Library/BaseCryptLibNull/BaseCryptLibNull.inf
> > > > @@ -49,6 +49,7 @@
> > > > Pk/CryptX509Null.c
> > > > Pk/CryptAuthenticodeNull.c
> > > > Pk/CryptTsNull.c
> > > > + Pk/CryptEcNull.c
> > > > Pem/CryptPemNull.c
> > > > Rand/CryptRandNull.c
> > > > Pk/CryptRsaPssNull.c
> > > > diff --git a/CryptoPkg/Library/BaseCryptLibNull/Pk/CryptEcNull.c b/CryptoPkg/Library/BaseCryptLibNull/Pk/CryptEcNull.c
> > > > new file mode 100644
> > > > index 0000000000..d9f1004f6c
> > > > --- /dev/null
> > > > +++ b/CryptoPkg/Library/BaseCryptLibNull/Pk/CryptEcNull.c
> > > > @@ -0,0 +1,496 @@
> > > > +/** @file
> > > > + Elliptic Curve and ECDH API implementation based on OpenSSL
> > > > +
> > > > + Copyright (c) 2022, Intel Corporation. All rights reserved.<BR>
> > > > + SPDX-License-Identifier: BSD-2-Clause-Patent
> > > > +
> > > > +**/
> > > > +
> > > > +#include <Library/BaseCryptLib.h>
> > > > +#include <Library/DebugLib.h>
> > > > +
> > > > +/**
> > > > + Initialize new opaque EcGroup object. This object represents an EC curve and
> > > > + and is used for calculation within this group. This object should be freed
> > > > + using EcGroupFree() function.
> > > > +
> > > > + @param[in] CryptoNid Identifying number for the ECC curve (Defined in
> > > > + BaseCryptLib.h).
> > > > +
> > > > + @retval EcGroup object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcGroupInit (
> > > > + IN UINTN CryptoNid
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC curve parameters. While elliptic curve equation is Y^2 mod P = (X^3 + AX + B) Mod P.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnPrime Group prime number.
> > > > + @param[out] BnA A coefficient.
> > > > + @param[out] BnB B coefficient..
> > > > + @param[in] BnCtx BN context.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *BnPrime,
> > > > + OUT VOID *BnA,
> > > > + OUT VOID *BnB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC group order.
> > > > + This function will set the provided Big Number object to the corresponding
> > > > + value. The caller needs to make sure that the "out" BigNumber parameter
> > > > + is properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] BnOrder Group prime number.
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGroupGetOrder (
> > > > + IN VOID *EcGroup,
> > > > + OUT VOID *BnOrder
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC group object using EcGroupInit().
> > > > +
> > > > + @param[in] EcGroup EC group object to free.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcGroupFree (
> > > > + IN VOID *EcGroup
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Initialize new opaque EC Point object. This object represents an EC point
> > > > + within the given EC group (curve).
> > > > +
> > > > + @param[in] EC Group, properly initialized using EcGroupInit().
> > > > +
> > > > + @retval EC Point object On success.
> > > > + @retval NULL On failure.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcPointInit (
> > > > + IN CONST VOID *EcGroup
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Free previously allocated EC Point object using EcPointInit().
> > > > +
> > > > + @param[in] EcPoint EC Point to free.
> > > > + @param[in] Clear TRUE iff the memory should be cleared.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcPointDeInit (
> > > > + IN VOID *EcPoint,
> > > > + IN BOOLEAN Clear
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Get EC point affine (x,y) coordinates.
> > > > + This function will set the provided Big Number objects to the corresponding
> > > > + values. The caller needs to make sure all the "out" BigNumber parameters
> > > > + are properly initialized.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[out] BnX X coordinate.
> > > > + @param[out] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointGetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + OUT VOID *BnX,
> > > > + OUT VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point affine (x,y) coordinates.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point object.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] BnY Y coordinate.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetAffineCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN CONST VOID *BnY,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + EC Point addition. EcPointResult = EcPointA + EcPointB.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPointA EC Point.
> > > > + @param[in] EcPointB EC Point.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointAdd (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Variable EC point multiplication. EcPointResult = EcPoint * BnPScalar.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[out] EcPointResult EC point to hold the result. The point should
> > > > + be properly initialized.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnPScalar P Scalar.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointMul (
> > > > + IN CONST VOID *EcGroup,
> > > > + OUT VOID *EcPointResult,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN CONST VOID *BnPScalar,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Calculate the inverse of the supplied EC point.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in,out] EcPoint EC point to invert.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointInvert (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN OUT VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is on EC curve.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On curve.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsOnCurve (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if the supplied point is at infinity.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC point to check.
> > > > +
> > > > + @retval TRUE At infinity.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointIsAtInfinity (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPoint
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Check if EC points are equal.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPointA EC point A.
> > > > + @param[in] EcPointB EC point B.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE A == B.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointEqual (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN CONST VOID *EcPointA,
> > > > + IN CONST VOID *EcPointB,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Set EC point compressed coordinates. Points can be described in terms of
> > > > + their compressed coordinates. For a point (x, y), for any given value for x
> > > > + such that the point is on the curve there will only ever be two possible
> > > > + values for y. Therefore, a point can be set using this function where BnX is
> > > > + the x coordinate and YBit is a value 0 or 1 to identify which of the two
> > > > + possible values for y should be used.
> > > > +
> > > > + @param[in] EcGroup EC group object.
> > > > + @param[in] EcPoint EC Point.
> > > > + @param[in] BnX X coordinate.
> > > > + @param[in] YBit 0 or 1 to identify which Y value is used.
> > > > + @param[in] BnCtx BN context, created with BigNumNewContext().
> > > > +
> > > > + @retval TRUE On success.
> > > > + @retval FALSE Otherwise.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcPointSetCompressedCoordinates (
> > > > + IN CONST VOID *EcGroup,
> > > > + IN VOID *EcPoint,
> > > > + IN CONST VOID *BnX,
> > > > + IN UINT8 YBit,
> > > > + IN VOID *BnCtx
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Allocates and Initializes one Elliptic Curve Context for subsequent use
> > > > + with the NID.
> > > > +
> > > > + @param[in] Nid cipher NID
> > > > + @return Pointer to the Elliptic Curve Context that has been initialized.
> > > > + If the allocations fails, EcNewByNid() returns NULL.
> > > > +**/
> > > > +VOID *
> > > > +EFIAPI
> > > > +EcNewByNid (
> > > > + IN UINTN Nid
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return NULL;
> > > > +}
> > > > +
> > > > +/**
> > > > + Release the specified EC context.
> > > > +
> > > > + @param[in] EcContext Pointer to the EC context to be released.
> > > > +**/
> > > > +VOID
> > > > +EFIAPI
> > > > +EcFree (
> > > > + IN VOID *EcContext
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > +}
> > > > +
> > > > +/**
> > > > + Generates EC key and returns EC public key (X, Y), Please note, this function uses
> > > > + pseudo random number generator. The caller must make sure RandomSeed()
> > > > + function was properly called before.
> > > > + The Ec context should be correctly initialized by EcNewByNid.
> > > > + This function generates random secret, and computes the public key (X, Y), which is
> > > > + returned via parameter Public, PublicSize.
> > > > + X is the first half of Public with size being PublicSize / 2,
> > > > + Y is the second half of Public with size being PublicSize / 2.
> > > > + EC context is updated accordingly.
> > > > + If the Public buffer is too small to hold the public X, Y, FALSE is returned and
> > > > + PublicSize is set to the required buffer size to obtain the public X, Y.
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PublicSize is NULL, then return FALSE.
> > > > + If PublicSize is large enough but Public is NULL, then return FALSE.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC public X,Y generation succeeded.
> > > > + @retval FALSE EC public X,Y generation failed.
> > > > + @retval FALSE PublicKeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGenerateKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Gets the public key component from the established EC context.
> > > > + The Ec context should be correctly initialized by EcNewByNid, and successfully
> > > > + generate key pair from EcGenerateKey().
> > > > + For P-256, the PublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to EC context being set.
> > > > + @param[out] PublicKey Pointer to t buffer to receive generated public X,Y.
> > > > + @param[in, out] PublicKeySize On input, the size of Public buffer in bytes.
> > > > + On output, the size of data returned in Public buffer in bytes.
> > > > + @retval TRUE EC key component was retrieved successfully.
> > > > + @retval FALSE Invalid EC key component.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcGetPubKey (
> > > > + IN OUT VOID *EcContext,
> > > > + OUT UINT8 *PublicKey,
> > > > + IN OUT UINTN *PublicKeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > +
> > > > +/**
> > > > + Computes exchanged common key.
> > > > + Given peer's public key (X, Y), this function computes the exchanged common key,
> > > > + based on its own context including value of curve parameter and random secret.
> > > > + X is the first half of PeerPublic with size being PeerPublicSize / 2,
> > > > + Y is the second half of PeerPublic with size being PeerPublicSize / 2.
> > > > + If EcContext is NULL, then return FALSE.
> > > > + If PeerPublic is NULL, then return FALSE.
> > > > + If PeerPublicSize is 0, then return FALSE.
> > > > + If Key is NULL, then return FALSE.
> > > > + If KeySize is not large enough, then return FALSE.
> > > > + For P-256, the PeerPublicSize is 64. First 32-byte is X, Second 32-byte is Y.
> > > > + For P-384, the PeerPublicSize is 96. First 48-byte is X, Second 48-byte is Y.
> > > > + For P-521, the PeerPublicSize is 132. First 66-byte is X, Second 66-byte is Y.
> > > > + @param[in, out] EcContext Pointer to the EC context.
> > > > + @param[in] PeerPublic Pointer to the peer's public X,Y.
> > > > + @param[in] PeerPublicSize Size of peer's public X,Y in bytes.
> > > > + @param[in] CompressFlag Flag of PeerPublic is compressed or not.
> > > > + @param[out] Key Pointer to the buffer to receive generated key.
> > > > + @param[in, out] KeySize On input, the size of Key buffer in bytes.
> > > > + On output, the size of data returned in Key buffer in bytes.
> > > > + @retval TRUE EC exchanged key generation succeeded.
> > > > + @retval FALSE EC exchanged key generation failed.
> > > > + @retval FALSE KeySize is not large enough.
> > > > +**/
> > > > +BOOLEAN
> > > > +EFIAPI
> > > > +EcDhComputeKey (
> > > > + IN OUT VOID *EcContext,
> > > > + IN CONST UINT8 *PeerPublic,
> > > > + IN UINTN PeerPublicSize,
> > > > + IN CONST INT32 *CompressFlag,
> > > > + OUT UINT8 *Key,
> > > > + IN OUT UINTN *KeySize
> > > > + )
> > > > +{
> > > > + ASSERT (FALSE);
> > > > + return FALSE;
> > > > +}
> > > > --
> > > > 2.31.1.windows.1
> > > >
> > > >
> > > >
> > > >
> > > >
next prev parent reply other threads:[~2022-09-23 5:25 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <cover.1663735439.git.yi1.li@intel.com>
2022-09-21 4:54 ` [PATCH V2 1/3] CryptoPkg: Add EC support yi1 li
2022-09-21 16:21 ` [edk2-devel] " Michael D Kinney
2022-09-22 2:15 ` yi1 li
2022-09-22 3:56 ` Michael D Kinney
2022-09-22 12:54 ` yi1 li
2022-09-22 22:46 ` Michael D Kinney
2022-09-23 3:01 ` yi1 li
2022-09-23 5:25 ` Michael D Kinney [this message]
2022-09-23 7:08 ` yi1 li
2022-09-23 22:40 ` Yao, Jiewen
2022-09-24 2:19 ` Michael D Kinney
2022-09-24 3:44 ` yi1 li
2022-09-24 10:21 ` Yao, Jiewen
2022-09-24 15:16 ` Michael D Kinney
2022-09-24 16:03 ` Yao, Jiewen
2022-09-21 4:54 ` [PATCH V2 2/3] CryptoPkg: Add EC APIs to DXE and protocol yi1 li
2022-09-21 4:54 ` [PATCH V2 3/3] CryptoPkg/Test: Add unit test for CryptoEc yi1 li
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CO1PR11MB49295D0548BA83BD507BF2D7D2519@CO1PR11MB4929.namprd11.prod.outlook.com \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox