primitives (Hash Serials, HMAC, RSA, Diffie-Hellman, etc) for UEFI security\r
functionality enabling.\r
\r
-Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2009 - 2012, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
Initializes user-supplied memory pointed by Md4Context as MD4 hash context for\r
subsequent use.\r
\r
- If Md4Context is NULL, then ASSERT().\r
+ If Md4Context is NULL, then return FALSE.\r
\r
@param[out] Md4Context Pointer to MD4 context being initialized.\r
\r
/**\r
Makes a copy of an existing MD4 context.\r
\r
- If Md4Context is NULL, then ASSERT().\r
- If NewMd4Context is NULL, then ASSERT().\r
+ If Md4Context is NULL, then return FALSE.\r
+ If NewMd4Context is NULL, then return FALSE.\r
\r
@param[in] Md4Context Pointer to MD4 context being copied.\r
@param[out] NewMd4Context Pointer to new MD4 context.\r
MD4 context should be already correctly intialized by Md4Init(), and should not be finalized\r
by Md4Final(). Behavior with invalid context is undefined.\r
\r
- If Md4Context is NULL, then ASSERT().\r
+ If Md4Context is NULL, then return FALSE.\r
\r
@param[in, out] Md4Context Pointer to the MD4 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
MD4 context should be already correctly intialized by Md4Init(), and should not be\r
finalized by Md4Final(). Behavior with invalid MD4 context is undefined.\r
\r
- If Md4Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Md4Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] Md4Context Pointer to the MD4 context.\r
@param[out] HashValue Pointer to a buffer that receives the MD4 digest\r
Initializes user-supplied memory pointed by Md5Context as MD5 hash context for\r
subsequent use.\r
\r
- If Md5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
\r
@param[out] Md5Context Pointer to MD5 context being initialized.\r
\r
/**\r
Makes a copy of an existing MD5 context.\r
\r
- If Md5Context is NULL, then ASSERT().\r
- If NewMd5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
+ If NewMd5Context is NULL, then return FALSE.\r
\r
@param[in] Md5Context Pointer to MD5 context being copied.\r
@param[out] NewMd5Context Pointer to new MD5 context.\r
MD5 context should be already correctly intialized by Md5Init(), and should not be finalized\r
by Md5Final(). Behavior with invalid context is undefined.\r
\r
- If Md5Context is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
\r
@param[in, out] Md5Context Pointer to the MD5 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
MD5 context should be already correctly intialized by Md5Init(), and should not be\r
finalized by Md5Final(). Behavior with invalid MD5 context is undefined.\r
\r
- If Md5Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Md5Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] Md5Context Pointer to the MD5 context.\r
@param[out] HashValue Pointer to a buffer that receives the MD5 digest\r
Initializes user-supplied memory pointed by Sha1Context as SHA-1 hash context for\r
subsequent use.\r
\r
- If Sha1Context is NULL, then ASSERT().\r
+ If Sha1Context is NULL, then return FALSE.\r
\r
@param[out] Sha1Context Pointer to SHA-1 context being initialized.\r
\r
/**\r
Makes a copy of an existing SHA-1 context.\r
\r
- If Sha1Context is NULL, then ASSERT().\r
- If NewSha1Context is NULL, then ASSERT().\r
+ If Sha1Context is NULL, then return FALSE.\r
+ If NewSha1Context is NULL, then return FALSE.\r
\r
@param[in] Sha1Context Pointer to SHA-1 context being copied.\r
@param[out] NewSha1Context Pointer to new SHA-1 context.\r
SHA-1 context should be already correctly intialized by Sha1Init(), and should not be finalized\r
by Sha1Final(). Behavior with invalid context is undefined.\r
\r
- If Sha1Context is NULL, then ASSERT().\r
+ If Sha1Context is NULL, then return FALSE.\r
\r
@param[in, out] Sha1Context Pointer to the SHA-1 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
SHA-1 context should be already correctly intialized by Sha1Init(), and should not be\r
finalized by Sha1Final(). Behavior with invalid SHA-1 context is undefined.\r
\r
- If Sha1Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Sha1Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] Sha1Context Pointer to the SHA-1 context.\r
@param[out] HashValue Pointer to a buffer that receives the SHA-1 digest\r
Initializes user-supplied memory pointed by Sha256Context as SHA-256 hash context for\r
subsequent use.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
\r
@param[out] Sha256Context Pointer to SHA-256 context being initialized.\r
\r
/**\r
Makes a copy of an existing SHA-256 context.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
- If NewSha256Context is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
+ If NewSha256Context is NULL, then return FALSE.\r
\r
@param[in] Sha256Context Pointer to SHA-256 context being copied.\r
@param[out] NewSha256Context Pointer to new SHA-256 context.\r
SHA-256 context should be already correctly intialized by Sha256Init(), and should not be finalized\r
by Sha256Final(). Behavior with invalid context is undefined.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
\r
@param[in, out] Sha256Context Pointer to the SHA-256 context.\r
@param[in] Data Pointer to the buffer containing the data to be hashed.\r
SHA-256 context should be already correctly intialized by Sha256Init(), and should not be\r
finalized by Sha256Final(). Behavior with invalid SHA-256 context is undefined.\r
\r
- If Sha256Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If Sha256Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] Sha256Context Pointer to the SHA-256 context.\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
Initializes user-supplied memory pointed by HmacMd5Context as HMAC-MD5 context for\r
subsequent use.\r
\r
- If HmacMd5Context is NULL, then ASSERT().\r
+ If HmacMd5Context is NULL, then return FALSE.\r
\r
@param[out] HmacMd5Context Pointer to HMAC-MD5 context being initialized.\r
@param[in] Key Pointer to the user-supplied key.\r
/**\r
Makes a copy of an existing HMAC-MD5 context.\r
\r
- If HmacMd5Context is NULL, then ASSERT().\r
- If NewHmacMd5Context is NULL, then ASSERT().\r
+ If HmacMd5Context is NULL, then return FALSE.\r
+ If NewHmacMd5Context is NULL, then return FALSE.\r
\r
@param[in] HmacMd5Context Pointer to HMAC-MD5 context being copied.\r
@param[out] NewHmacMd5Context Pointer to new HMAC-MD5 context.\r
HMAC-MD5 context should be already correctly intialized by HmacMd5Init(), and should not be\r
finalized by HmacMd5Final(). Behavior with invalid context is undefined.\r
\r
- If HmacMd5Context is NULL, then ASSERT().\r
+ If HmacMd5Context is NULL, then return FALSE.\r
\r
@param[in, out] HmacMd5Context Pointer to the HMAC-MD5 context.\r
@param[in] Data Pointer to the buffer containing the data to be digested.\r
HMAC-MD5 context should be already correctly intialized by HmacMd5Init(), and should not be\r
finalized by HmacMd5Final(). Behavior with invalid HMAC-MD5 context is undefined.\r
\r
- If HmacMd5Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If HmacMd5Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] HmacMd5Context Pointer to the HMAC-MD5 context.\r
@param[out] HashValue Pointer to a buffer that receives the HMAC-MD5 digest\r
Initializes user-supplied memory pointed by HmacSha1Context as HMAC-SHA1 context for\r
subsequent use.\r
\r
- If HmacSha1Context is NULL, then ASSERT().\r
+ If HmacSha1Context is NULL, then return FALSE.\r
\r
@param[out] HmacSha1Context Pointer to HMAC-SHA1 context being initialized.\r
@param[in] Key Pointer to the user-supplied key.\r
/**\r
Makes a copy of an existing HMAC-SHA1 context.\r
\r
- If HmacSha1Context is NULL, then ASSERT().\r
- If NewHmacSha1Context is NULL, then ASSERT().\r
+ If HmacSha1Context is NULL, then return FALSE.\r
+ If NewHmacSha1Context is NULL, then return FALSE.\r
\r
@param[in] HmacSha1Context Pointer to HMAC-SHA1 context being copied.\r
@param[out] NewHmacSha1Context Pointer to new HMAC-SHA1 context.\r
HMAC-SHA1 context should be already correctly intialized by HmacSha1Init(), and should not\r
be finalized by HmacSha1Final(). Behavior with invalid context is undefined.\r
\r
- If HmacSha1Context is NULL, then ASSERT().\r
+ If HmacSha1Context is NULL, then return FALSE.\r
\r
@param[in, out] HmacSha1Context Pointer to the HMAC-SHA1 context.\r
@param[in] Data Pointer to the buffer containing the data to be digested.\r
HMAC-SHA1 context should be already correctly intialized by HmacSha1Init(), and should\r
not be finalized by HmacSha1Final(). Behavior with invalid HMAC-SHA1 context is undefined.\r
\r
- If HmacSha1Context is NULL, then ASSERT().\r
- If HashValue is NULL, then ASSERT().\r
+ If HmacSha1Context is NULL, then return FALSE.\r
+ If HashValue is NULL, then return FALSE.\r
\r
@param[in, out] HmacSha1Context Pointer to the HMAC-SHA1 context.\r
@param[out] HashValue Pointer to a buffer that receives the HMAC-SHA1 digest\r
KeyLength = 128, Keying option 2: K1 != K2 and K3 = K1 (Less Security)\r
KeyLength = 192 Keying option 3: K1 != K2 != K3 (Strongest)\r
\r
- If TdesContext is NULL, then ASSERT().\r
- If Key is NULL, then ASSERT().\r
- If KeyLength is not valid, then ASSERT().\r
+ If TdesContext is NULL, then return FALSE.\r
+ If Key is NULL, then return FALSE.\r
+ If KeyLength is not valid, then return FALSE.\r
\r
@param[out] TdesContext Pointer to TDES context being initialized.\r
@param[in] Key Pointer to the user-supplied TDES key.\r
TdesContext should be already correctly initialized by TdesInit(). Behavior with\r
invalid TDES context is undefined.\r
\r
- If TdesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (8 bytes), then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If TdesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (8 bytes), then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] TdesContext Pointer to the TDES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
TdesContext should be already correctly initialized by TdesInit(). Behavior with\r
invalid TDES context is undefined.\r
\r
- If TdesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (8 bytes), then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If TdesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (8 bytes), then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] TdesContext Pointer to the TDES context.\r
@param[in] Input Pointer to the buffer containing the data to be decrypted.\r
TdesContext should be already correctly initialized by TdesInit(). Behavior with\r
invalid TDES context is undefined.\r
\r
- If TdesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (8 bytes), then ASSERT().\r
- If Ivec is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If TdesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (8 bytes), then return FALSE.\r
+ If Ivec is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] TdesContext Pointer to the TDES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
TdesContext should be already correctly initialized by TdesInit(). Behavior with\r
invalid TDES context is undefined.\r
\r
- If TdesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (8 bytes), then ASSERT().\r
- If Ivec is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If TdesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (8 bytes), then return FALSE.\r
+ If Ivec is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] TdesContext Pointer to the TDES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
operations.\r
There are 3 options for key length, 128 bits, 192 bits, and 256 bits.\r
\r
- If AesContext is NULL, then ASSERT().\r
- If Key is NULL, then ASSERT().\r
- If KeyLength is not valid, then ASSERT().\r
+ If AesContext is NULL, then return FALSE.\r
+ If Key is NULL, then return FALSE.\r
+ If KeyLength is not valid, then return FALSE.\r
\r
@param[out] AesContext Pointer to AES context being initialized.\r
@param[in] Key Pointer to the user-supplied AES key.\r
AesContext should be already correctly initialized by AesInit(). Behavior with\r
invalid AES context is undefined.\r
\r
- If AesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (16 bytes), then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If AesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (16 bytes), then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] AesContext Pointer to the AES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
AesContext should be already correctly initialized by AesInit(). Behavior with\r
invalid AES context is undefined.\r
\r
- If AesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (16 bytes), then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If AesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (16 bytes), then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] AesContext Pointer to the AES context.\r
@param[in] Input Pointer to the buffer containing the data to be decrypted.\r
AesContext should be already correctly initialized by AesInit(). Behavior with\r
invalid AES context is undefined.\r
\r
- If AesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (16 bytes), then ASSERT().\r
- If Ivec is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If AesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (16 bytes), then return FALSE.\r
+ If Ivec is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] AesContext Pointer to the AES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
AesContext should be already correctly initialized by AesInit(). Behavior with\r
invalid AES context is undefined.\r
\r
- If AesContext is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If InputSize is not multiple of block size (16 bytes), then ASSERT().\r
- If Ivec is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If AesContext is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If InputSize is not multiple of block size (16 bytes), then return FALSE.\r
+ If Ivec is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] AesContext Pointer to the AES context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
In addtion, it sets up all ARC4 key materials for subsequent encryption and decryption\r
operations.\r
\r
- If Arc4Context is NULL, then ASSERT().\r
- If Key is NULL, then ASSERT().\r
- If KeySize does not in the range of [5, 256] bytes, then ASSERT().\r
+ If Arc4Context is NULL, then return FALSE.\r
+ If Key is NULL, then return FALSE.\r
+ If KeySize does not in the range of [5, 256] bytes, then return FALSE.\r
\r
@param[out] Arc4Context Pointer to ARC4 context being initialized.\r
@param[in] Key Pointer to the user-supplied ARC4 key.\r
Arc4Context should be already correctly initialized by Arc4Init(). Behavior with\r
invalid ARC4 context is undefined.\r
\r
- If Arc4Context is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If Arc4Context is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] Arc4Context Pointer to the ARC4 context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
Arc4Context should be already correctly initialized by Arc4Init(). Behavior with\r
invalid ARC4 context is undefined.\r
\r
- If Arc4Context is NULL, then ASSERT().\r
- If Input is NULL, then ASSERT().\r
- If Output is NULL, then ASSERT().\r
+ If Arc4Context is NULL, then return FALSE.\r
+ If Input is NULL, then return FALSE.\r
+ If Output is NULL, then return FALSE.\r
\r
@param[in] Arc4Context Pointer to the ARC4 context.\r
@param[in] Input Pointer to the buffer containing the data to be decrypted.\r
Contrary to ARC4Init(), Arc4Reset() requires no secret key as input, but ARC4 context\r
should be already correctly initialized by ARC4Init().\r
\r
- If Arc4Context is NULL, then ASSERT().\r
+ If Arc4Context is NULL, then return FALSE.\r
\r
@param[in, out] Arc4Context Pointer to the ARC4 context.\r
\r
/**\r
Release the specified RSA context.\r
\r
- If RsaContext is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@param[in] RsaContext Pointer to the RSA context to be released.\r
\r
represented in RSA PKCS#1).\r
If BigNumber is NULL, then the specified key componenet in RSA context is cleared.\r
\r
- If RsaContext is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@param[in, out] RsaContext Pointer to RSA context being set.\r
@param[in] KeyTag Tag of RSA key component being set.\r
If the BigNumber buffer is too small to hold the contents of the key, FALSE\r
is returned and BnSize is set to the required buffer size to obtain the key.\r
\r
- If RsaContext is NULL, then ASSERT().\r
- If BnSize is NULL, then ASSERT().\r
- If BnSize is large enough but BigNumber is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
+ If BnSize is NULL, then return FALSE.\r
+ If BnSize is large enough but BigNumber is NULL, then return FALSE.\r
\r
@param[in, out] RsaContext Pointer to RSA context being set.\r
@param[in] KeyTag Tag of RSA key component being set.\r
Before this function can be invoked, pseudorandom number generator must be correctly\r
initialized by RandomSeed().\r
\r
- If RsaContext is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@param[in, out] RsaContext Pointer to RSA context being set.\r
@param[in] ModulusLength Length of RSA modulus N in bits.\r
- Whether n = p * q\r
- Whether d*e = 1 mod lcm(p-1,q-1)\r
\r
- If RsaContext is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@param[in] RsaContext Pointer to RSA context to check.\r
\r
If the Signature buffer is too small to hold the contents of signature, FALSE\r
is returned and SigSize is set to the required buffer size to obtain the signature.\r
\r
- If RsaContext is NULL, then ASSERT().\r
- If MessageHash is NULL, then ASSERT().\r
- If HashSize is not equal to the size of MD5, SHA-1 or SHA-256 digest, then ASSERT().\r
- If SigSize is large enough but Signature is NULL, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
+ If MessageHash is NULL, then return FALSE.\r
+ If HashSize is not equal to the size of MD5, SHA-1 or SHA-256 digest, then return FALSE.\r
+ If SigSize is large enough but Signature is NULL, then return FALSE.\r
\r
@param[in] RsaContext Pointer to RSA context for signature generation.\r
@param[in] MessageHash Pointer to octet message hash to be signed.\r
Verifies the RSA-SSA signature with EMSA-PKCS1-v1_5 encoding scheme defined in\r
RSA PKCS#1.\r
\r
- If RsaContext is NULL, then ASSERT().\r
- If MessageHash is NULL, then ASSERT().\r
- If Signature is NULL, then ASSERT().\r
- If HashSize is not equal to the size of MD5, SHA-1, SHA-256 digest, then ASSERT().\r
+ If RsaContext is NULL, then return FALSE.\r
+ If MessageHash is NULL, then return FALSE.\r
+ If Signature is NULL, then return FALSE.\r
+ If HashSize is not equal to the size of MD5, SHA-1, SHA-256 digest, then return FALSE.\r
\r
@param[in] RsaContext Pointer to RSA context for signature verification.\r
@param[in] MessageHash Pointer to octet message hash to be checked.\r
RSA private key component. Use RsaFree() function to free the\r
resource.\r
\r
- If PemData is NULL, then ASSERT().\r
- If RsaContext is NULL, then ASSERT().\r
+ If PemData is NULL, then return FALSE.\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@retval TRUE RSA Private Key was retrieved successfully.\r
@retval FALSE Invalid PEM key data or incorrect password.\r
RSA public key component. Use RsaFree() function to free the\r
resource.\r
\r
- If Cert is NULL, then ASSERT().\r
- If RsaContext is NULL, then ASSERT().\r
+ If Cert is NULL, then return FALSE.\r
+ If RsaContext is NULL, then return FALSE.\r
\r
@retval TRUE RSA Public Key was retrieved successfully.\r
@retval FALSE Fail to retrieve RSA public key from X509 certificate.\r
@param[in, out] SubjectSize The size in bytes of the CertSubject buffer on input,\r
and the size of buffer returned CertSubject on output.\r
\r
- If Cert is NULL, then ASSERT().\r
- If SubjectSize is NULL, then ASSERT().\r
+ If Cert is NULL, then return FALSE.\r
+ If SubjectSize is NULL, then return FALSE.\r
\r
@retval TRUE The certificate subject retrieved successfully.\r
@retval FALSE Invalid certificate, or the SubjectSize is too small for the result.\r
@param[in] CACert Pointer to the DER-encoded trusted CA certificate.\r
@param[in] CACertSize Size of the CA Certificate in bytes.\r
\r
- If Cert is NULL, then ASSERT().\r
- If CACert is NULL, then ASSERT().\r
+ If Cert is NULL, then return FALSE.\r
+ If CACert is NULL, then return FALSE.\r
\r
@retval TRUE The certificate was issued by the trusted CA.\r
@retval FALSE Invalid certificate or the certificate was not issued by the given\r
/**\r
Construct a X509 object from DER-encoded certificate data.\r
\r
- If Cert is NULL, then ASSERT().\r
- If SingleX509Cert is NULL, then ASSERT().\r
+ If Cert is NULL, then return FALSE.\r
+ If SingleX509Cert is NULL, then return FALSE.\r
\r
@param[in] Cert Pointer to the DER-encoded certificate data.\r
@param[in] CertSize The size of certificate data in bytes.\r
/**\r
Construct a X509 stack object from a list of DER-encoded certificate data.\r
\r
- If X509Stack is NULL, then ASSERT().\r
+ If X509Stack is NULL, then return FALSE.\r
\r
@param[in, out] X509Stack On input, pointer to an existing X509 stack object.\r
On output, pointer to the X509 stack object with new\r
/**\r
Release the specified X509 object.\r
\r
- If X509Cert is NULL, then ASSERT().\r
+ If X509Cert is NULL, then return FALSE.\r
\r
@param[in] X509Cert Pointer to the X509 object to be released.\r
\r
/**\r
Release the specified X509 stack object.\r
\r
- If X509Stack is NULL, then ASSERT().\r
+ If X509Stack is NULL, then return FALSE.\r
\r
@param[in] X509Stack Pointer to the X509 stack object to be released.\r
\r
Verifies the validility of a PKCS#7 signed data as described in "PKCS #7: Cryptographic\r
Message Syntax Standard".\r
\r
- If P7Data is NULL, then ASSERT().\r
+ If P7Data is NULL, then return FALSE.\r
\r
@param[in] P7Data Pointer to the PKCS#7 message to verify.\r
@param[in] P7Size Size of the PKCS#7 message in bytes.\r
Verifies the validility of a PE/COFF Authenticode Signature as described in "Windows\r
Authenticode Portable Executable Signature Format".\r
\r
- If AuthData is NULL, then ASSERT().\r
- If ImageHash is NULL, then ASSERT().\r
+ If AuthData is NULL, then return FALSE.\r
+ If ImageHash is NULL, then return FALSE.\r
\r
@param[in] AuthData Pointer to the Authenticode Signature retrieved from signed\r
PE/COFF image to be verified.\r
/**\r
Release the specified DH context.\r
\r
- If DhContext is NULL, then ASSERT().\r
+ If DhContext is NULL, then return FALSE.\r
\r
@param[in] DhContext Pointer to the DH context to be released.\r
\r
Before this function can be invoked, pseudorandom number generator must be correctly\r
initialized by RandomSeed().\r
\r
- If DhContext is NULL, then ASSERT().\r
- If Prime is NULL, then ASSERT().\r
+ If DhContext is NULL, then return FALSE.\r
+ If Prime is NULL, then return FALSE.\r
\r
@param[in, out] DhContext Pointer to the DH context.\r
@param[in] Generator Value of generator.\r
Given generator g, and prime number p, this function and sets DH\r
context accordingly.\r
\r
- If DhContext is NULL, then ASSERT().\r
- If Prime is NULL, then ASSERT().\r
+ If DhContext is NULL, then return FALSE.\r
+ If Prime is NULL, then return FALSE.\r
\r
@param[in, out] DhContext Pointer to the DH context.\r
@param[in] Generator Value of generator.\r
If the PublicKey buffer is too small to hold the public key, FALSE is returned and\r
PublicKeySize is set to the required buffer size to obtain the public key.\r
\r
- If DhContext is NULL, then ASSERT().\r
- If PublicKeySize is NULL, then ASSERT().\r
- If PublicKeySize is large enough but PublicKey is NULL, then ASSERT().\r
+ If DhContext is NULL, then return FALSE.\r
+ If PublicKeySize is NULL, then return FALSE.\r
+ If PublicKeySize is large enough but PublicKey is NULL, then return FALSE.\r
\r
@param[in, out] DhContext Pointer to the DH context.\r
@param[out] PublicKey Pointer to the buffer to receive generated public key.\r
Given peer's public key, this function computes the exchanged common key, based on its own\r
context including value of prime modulus and random secret exponent. \r
\r
- If DhContext is NULL, then ASSERT().\r
- If PeerPublicKey is NULL, then ASSERT().\r
- If KeySize is NULL, then ASSERT().\r
- If KeySize is large enough but Key is NULL, then ASSERT().\r
+ If DhContext is NULL, then return FALSE.\r
+ If PeerPublicKey is NULL, then return FALSE.\r
+ If KeySize is NULL, then return FALSE.\r
+ If KeySize is large enough but Key is NULL, then return FALSE.\r
\r
@param[in, out] DhContext Pointer to the DH context.\r
@param[in] PeerPublicKey Pointer to the peer's public key.\r
/**\r
Generates a pseudorandom byte stream of the specified size.\r
\r
- If Output is NULL, then ASSERT().\r
+ If Output is NULL, then return FALSE.\r
\r
@param[out] Output Pointer to buffer to receive random value.\r
@param[in] Size Size of randome bytes to generate.\r
projects / mirror_edk2.git / blobdiff