Runtime Cryptographic Driver Implementation, which produce one crypto\r
protocol.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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[in, out] Sha256Context Pointer to SHA-256 Context being initialized.\r
\r
Performs SHA-256 digest on a data buffer of the specified length. This function can\r
be called multiple times to compute the digest of long or discontinuous data streams.\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
Completes SHA-256 hash computation and retrieves the digest value into the specified\r
memory. After this function has been called, the SHA-256 context cannot be used again.\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 SHA-256 context\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
the user-specified nonnegative integer (octet string format represented in RSA\r
PKCS#1).\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
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 HashLength is not equal to the size of MD5, SHA-1 or 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 HashLength is not equal to the size of MD5, SHA-1 or SHA-256 digest, 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
/** @file\r
Header file of Runtime Cryptographic Driver.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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[in, out] Sha256Context Pointer to SHA-256 Context being initialized.\r
\r
Performs SHA-256 digest on a data buffer of the specified length. This function can\r
be called multiple times to compute the digest of long or discontinuous data streams.\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
Completes SHA-256 hash computation and retrieves the digest value into the specified\r
memory. After this function has been called, the SHA-256 context cannot be used again.\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 SHA-256 context\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
the user-specified nonnegative integer (octet string format represented in RSA\r
PKCS#1).\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
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 HashLength is not equal to the size of MD5, SHA-1 or 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 HashLength is not equal to the size of MD5, SHA-1 or SHA-256 digest, 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
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
Only limited crypto primitives (SHA-256 and RSA) are provided for runtime\r
authenticated variable service.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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[in, out] Sha256Context Pointer to SHA-256 Context being initialized.\r
\r
Performs SHA-256 digest on a data buffer of the specified length. This function can\r
be called multiple times to compute the digest of long or discontinuous data streams.\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
Completes SHA-256 hash computation and retrieves the digest value into the specified\r
memory. After this function has been called, the SHA-256 context cannot be used again.\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 SHA-256 context\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
the user-specified nonnegative integer (octet string format represented in RSA\r
PKCS#1).\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
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 HashLength is not equal to the size of MD5, SHA-1 or 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 HashLength is not equal to the size of MD5, SHA-1 or 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
/** @file\r
AES Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
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
{\r
AES_KEY *AesKey;\r
\r
- ASSERT (AesContext != NULL);\r
//\r
- // AES Key Checking\r
+ // Check input parameters.\r
//\r
- ASSERT (Key != NULL);\r
- ASSERT ((KeyLength == 128) || (KeyLength == 192) || (KeyLength == 256));\r
+ if (AesContext == NULL || Key == NULL || (KeyLength != 128 && KeyLength != 192 && KeyLength != 256)) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// Initialize AES encryption & decryption key schedule.\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
)\r
{\r
AES_KEY *AesKey;\r
- \r
- ASSERT (AesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % AES_BLOCK_SIZE) == 0);\r
- ASSERT (Output != NULL);\r
\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (AesContext == NULL || Input == NULL || (InputSize % AES_BLOCK_SIZE) != 0 || Output == NULL) {\r
+ return FALSE;\r
+ }\r
+ \r
AesKey = (AES_KEY *) AesContext;\r
\r
//\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
)\r
{\r
AES_KEY *AesKey;\r
- \r
- ASSERT (AesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % AES_BLOCK_SIZE) == 0);\r
- ASSERT (Output != NULL);\r
+\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (AesContext == NULL || Input == NULL || (InputSize % AES_BLOCK_SIZE) != 0 || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
AesKey = (AES_KEY *) AesContext;\r
\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
AES_KEY *AesKey;\r
UINT8 IvecBuffer[AES_BLOCK_SIZE];\r
\r
- ASSERT (AesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % AES_BLOCK_SIZE) == 0);\r
- ASSERT (Ivec != NULL);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (AesContext == NULL || Input == NULL || (InputSize % AES_BLOCK_SIZE) != 0 || Ivec == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
AesKey = (AES_KEY *) AesContext;\r
CopyMem (IvecBuffer, Ivec, AES_BLOCK_SIZE);\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
{\r
AES_KEY *AesKey;\r
UINT8 IvecBuffer[AES_BLOCK_SIZE];\r
- \r
- ASSERT (AesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % AES_BLOCK_SIZE) == 0);\r
- ASSERT (Ivec != NULL);\r
- ASSERT (Output != NULL);\r
+\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (AesContext == NULL || Input == NULL || (InputSize % AES_BLOCK_SIZE) != 0 || Ivec == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
AesKey = (AES_KEY *) AesContext;\r
CopyMem (IvecBuffer, Ivec, AES_BLOCK_SIZE);\r
/** @file\r
ARC4 Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
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
{\r
RC4_KEY *Rc4Key;\r
\r
- ASSERT (Arc4Context != NULL);\r
- ASSERT (Key != NULL);\r
- ASSERT ((KeySize >= 5) && (KeySize <= 256));\r
+ //\r
+ // Check input parameters.\r
+ // \r
+ if (Arc4Context == NULL || Key == NULL || (KeySize < 5 || KeySize > 256)) {\r
+ return FALSE;\r
+ }\r
\r
Rc4Key = (RC4_KEY *) Arc4Context;\r
\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, out] Arc4Context Pointer to the ARC4 context.\r
@param[in] Input Pointer to the buffer containing the data to be encrypted.\r
{\r
RC4_KEY *Rc4Key;\r
\r
- ASSERT (Arc4Context != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Arc4Context == NULL || Input == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Rc4Key = (RC4_KEY *) Arc4Context;\r
\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, out] Arc4Context Pointer to the ARC4 context.\r
@param[in] Input Pointer to the buffer containing the data to be decrypted.\r
{\r
RC4_KEY *Rc4Key;\r
\r
- ASSERT (Arc4Context != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Arc4Context == NULL || Input == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Rc4Key = (RC4_KEY *) Arc4Context;\r
\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
RC4_KEY *Rc4Key;\r
\r
- ASSERT (Arc4Context != NULL);\r
-\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Arc4Context == NULL) {\r
+ return FALSE;\r
+ }\r
+ \r
Rc4Key = (RC4_KEY *) Arc4Context;\r
\r
CopyMem (Rc4Key, Rc4Key + 1, sizeof(RC4_KEY));\r
/** @file\r
TDES Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
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
{\r
DES_key_schedule *KeySchedule;\r
\r
- ASSERT (TdesContext != NULL);\r
- ASSERT (Key != NULL);\r
- ASSERT ((KeyLength == 64) || (KeyLength == 128) || (KeyLength == 192));\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (TdesContext == NULL || Key == NULL || (KeyLength != 64 && KeyLength != 128 && KeyLength != 192)) {\r
+ return FALSE;\r
+ }\r
\r
KeySchedule = (DES_key_schedule *) TdesContext;\r
\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
{\r
DES_key_schedule *KeySchedule;\r
\r
- ASSERT (TdesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % TDES_BLOCK_SIZE) == 0);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (TdesContext == NULL || Input == NULL || (InputSize % TDES_BLOCK_SIZE) != 0 || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
KeySchedule = (DES_key_schedule *) TdesContext;\r
\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
{\r
DES_key_schedule *KeySchedule;\r
\r
- ASSERT (TdesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % TDES_BLOCK_SIZE) == 0);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (TdesContext == NULL || Input == NULL || (InputSize % TDES_BLOCK_SIZE) != 0 || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
KeySchedule = (DES_key_schedule *) TdesContext;\r
\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
DES_key_schedule *KeySchedule;\r
UINT8 IvecBuffer[TDES_BLOCK_SIZE];\r
\r
- ASSERT (TdesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % TDES_BLOCK_SIZE) == 0);\r
- ASSERT (Ivec != NULL);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (TdesContext == NULL || Input == NULL || (InputSize % TDES_BLOCK_SIZE) != 0 || Ivec == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
KeySchedule = (DES_key_schedule *) TdesContext;\r
CopyMem (IvecBuffer, Ivec, TDES_BLOCK_SIZE);\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
DES_key_schedule *KeySchedule;\r
UINT8 IvecBuffer[TDES_BLOCK_SIZE];\r
\r
- ASSERT (TdesContext != NULL);\r
- ASSERT (Input != NULL);\r
- ASSERT ((InputSize % TDES_BLOCK_SIZE) == 0);\r
- ASSERT (Ivec != NULL);\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (TdesContext == NULL || Input == NULL || (InputSize % TDES_BLOCK_SIZE) != 0 || Ivec == NULL || Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
KeySchedule = (DES_key_schedule *) TdesContext;\r
CopyMem (IvecBuffer, Ivec, TDES_BLOCK_SIZE);\r
/** @file\r
MD4 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
{\r
//\r
- // ASSERT if Md4Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md4Context != NULL);\r
+ if (Md4Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD4 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if Md4Context or NewMd4Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md4Context != NULL);\r
- ASSERT (NewMd4Context != NULL);\r
+ if (Md4Context == NULL || NewMd4Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewMd4Context, Md4Context, sizeof (MD4_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if Md4Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md4Context != NULL);\r
+ if (Md4Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\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
)\r
{\r
//\r
- // ASSERT if Md4Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md4Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Md4Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD4 Hash Finalization\r
/** @file\r
MD5 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2009 - 2010, 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 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
{\r
//\r
- // ASSERT if Md5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
+ if ((Md5Context == NULL)) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD5 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if Md5Context or NewMd5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
- ASSERT (NewMd5Context != NULL);\r
+ if (Md5Context == NULL || NewMd5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewMd5Context, Md5Context, sizeof (MD5_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if Md5Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
+ if (Md5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && (DataSize != 0)) {\r
+ return FALSE;\r
}\r
\r
//\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
)\r
{\r
//\r
- // ASSERT if Md5Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Md5Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Md5Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL MD5 Hash Finalization\r
/** @file\r
SHA-1 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2009 - 2010, 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 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
{\r
//\r
- // ASSERT if Sha1Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha1Context != NULL);\r
+ if (Sha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-1 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if Sha1Context or NewSha1Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha1Context != NULL);\r
- ASSERT (NewSha1Context != NULL);\r
+ if (Sha1Context == NULL || NewSha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewSha1Context, Sha1Context, sizeof (SHA_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if Sha1Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha1Context != NULL);\r
+ if (Sha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\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
)\r
{\r
//\r
- // ASSERT if Sha1Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha1Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Sha1Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-1 Hash Finalization\r
/** @file\r
SHA-256 Digest Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2009 - 2010, 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 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
{\r
//\r
- // ASSERT if Sha256Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
+ if (Sha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-256 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if Sha256Context or NewSha256Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
- ASSERT (NewSha256Context != NULL);\r
+ if (Sha256Context == NULL || NewSha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewSha256Context, Sha256Context, sizeof (SHA256_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if Sha256Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
+ if (Sha256Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\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
)\r
{\r
//\r
- // ASSERT if Sha256Context is NULL or HashValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (Sha256Context != NULL);\r
- ASSERT (HashValue != NULL);\r
+ if (Sha256Context == NULL || HashValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL SHA-256 Hash Finalization\r
/** @file\r
HMAC-MD5 Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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
{\r
//\r
- // ASSERT if HmacMd5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacMd5Context != NULL);\r
+ if (HmacMd5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL HMAC-MD5 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if HmacMd5Context or NewHmacMd5Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacMd5Context != NULL);\r
- ASSERT (NewHmacMd5Context != NULL);\r
+ if (HmacMd5Context == NULL || NewHmacMd5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewHmacMd5Context, HmacMd5Context, sizeof (HMAC_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if HmacMd5Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacMd5Context != NULL);\r
+ if (HmacMd5Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\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 HmacValue is NULL, then ASSERT().\r
+ If HmacMd5Context is NULL, then return FALSE.\r
+ If HmacValue is NULL, then return FALSE.\r
\r
@param[in, out] HmacMd5Context Pointer to the HMAC-MD5 context.\r
@param[out] HmacValue Pointer to a buffer that receives the HMAC-MD5 digest\r
UINT32 Length;\r
\r
//\r
- // ASSERT if HmacMd5Context is NULL or HmacValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacMd5Context != NULL);\r
- ASSERT (HmacValue != NULL);\r
+ if (HmacMd5Context == NULL || HmacValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL HMAC-MD5 digest finalization\r
/** @file\r
HMAC-SHA1 Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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
{\r
//\r
- // ASSERT if HmacSha1Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacSha1Context != NULL);\r
+ if (HmacSha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL HMAC-SHA1 Context Initialization\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
)\r
{\r
//\r
- // ASSERT if HmacSha1Context or NewHmacSha1Context is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacSha1Context != NULL);\r
- ASSERT (NewHmacSha1Context != NULL);\r
+ if (HmacSha1Context == NULL || NewHmacSha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
CopyMem (NewHmacSha1Context, HmacSha1Context, sizeof (HMAC_CTX));\r
\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
)\r
{\r
//\r
- // ASSERT if HmacSha1Context is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacSha1Context != NULL);\r
+ if (HmacSha1Context == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
- // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
+ // Check invalid parameters, in case that only DataLength was checked in OpenSSL\r
//\r
- if (Data == NULL) {\r
- ASSERT (DataSize == 0);\r
+ if (Data == NULL && DataSize != 0) {\r
+ return FALSE;\r
}\r
\r
//\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 HmacValue is NULL, then ASSERT().\r
+ If HmacSha1Context is NULL, then return FALSE.\r
+ If HmacValue is NULL, then return FALSE.\r
\r
@param[in, out] HmacSha1Context Pointer to the HMAC-SHA1 context.\r
@param[out] HmacValue Pointer to a buffer that receives the HMAC-SHA1 digest\r
UINT32 Length;\r
\r
//\r
- // ASSERT if HmacSha1Context is NULL or HmacValue is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (HmacSha1Context != NULL);\r
- ASSERT (HmacValue != NULL);\r
+ if (HmacSha1Context == NULL || HmacValue == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// OpenSSL HMAC-SHA1 digest finalization\r
/** @file\r
PEM (Privacy Enhanced Mail) Format Handler Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010 - 2011, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
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
BIO *PemBio;\r
\r
//\r
- // ASSERT if PemData is NULL or RsaContext is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (PemData != NULL);\r
- ASSERT (RsaContext != NULL);\r
- ASSERT (PemSize <= INT_MAX);\r
+ if (PemData == NULL || RsaContext == NULL || PemSize > INT_MAX) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
PemBio = NULL;\r
/** @file\r
Authenticode Portable Executable Signature Verification over OpenSSL.\r
\r
-Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2011 - 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
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
UINTN ContentSize;\r
\r
//\r
- // ASSERT if Authenticode Signature Data or PE Image Hash is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (AuthData != NULL);\r
- ASSERT (ImageHash != NULL);\r
- ASSERT (DataSize <= INT_MAX);\r
+ if ((AuthData == NULL) || (TrustedCert == NULL) || (ImageHash == NULL)) {\r
+ return FALSE;\r
+ }\r
+\r
+ if ((DataSize > INT_MAX) || (CertSize > INT_MAX) || (HashSize > INT_MAX)) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
Pkcs7 = NULL;\r
// Retrieve the SEQUENCE data size from ASN.1-encoded SpcIndirectDataContent.\r
//\r
Asn1Byte = *(SpcIndirectDataContent + 1);\r
+\r
if ((Asn1Byte & 0x80) == 0) {\r
//\r
// Short Form of Length Encoding\r
// Skip the SEQUENCE Tag;\r
//\r
SpcIndirectDataContent += 2;\r
- } else {\r
+ } else if ((Asn1Byte & 0x82) == 0x82) {\r
//\r
- // Long Form of Length Encoding (Assume Only two bytes here)\r
+ // Long Form of Length Encoding, only support two bytes.\r
//\r
ContentSize = (UINTN) (*(SpcIndirectDataContent + 2));\r
ContentSize = (ContentSize << 8) + (UINTN)(*(SpcIndirectDataContent + 3));\r
// Skip the SEQUENCE Tag;\r
//\r
SpcIndirectDataContent += 4;\r
+ } else {\r
+ goto _Exit;\r
}\r
\r
//\r
/** @file\r
Diffie-Hellman Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
/**\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
{\r
BOOLEAN RetVal;\r
\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (DhContext == NULL || Prime == NULL) {\r
+ return FALSE;\r
+ }\r
+\r
if (Generator != DH_GENERATOR_2 && Generator != DH_GENERATOR_5) {\r
return FALSE;\r
}\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
{\r
DH *Dh;\r
\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (DhContext == NULL || Prime == NULL) {\r
+ return FALSE;\r
+ }\r
+ \r
if (Generator != DH_GENERATOR_2 && Generator != DH_GENERATOR_5) {\r
return FALSE;\r
}\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
BOOLEAN RetVal;\r
DH *Dh;\r
\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (DhContext == NULL || PublicKeySize == NULL) {\r
+ return FALSE;\r
+ }\r
+\r
+ if (PublicKey == NULL && *PublicKeySize != 0) {\r
+ return FALSE;\r
+ }\r
+ \r
Dh = (DH *) DhContext;\r
*PublicKeySize = 0;\r
\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
BIGNUM *Bn;\r
\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (DhContext == NULL || PeerPublicKey == NULL || KeySize == NULL) {\r
+ return FALSE;\r
+ }\r
+\r
+ if (Key == NULL && *KeySize != 0) {\r
+ return FALSE;\r
+ }\r
+ \r
Bn = BN_bin2bn (PeerPublicKey, (UINT32) PeerPublicKeySize, NULL);\r
\r
*KeySize = (BOOLEAN) DH_compute_key (Key, Bn, DhContext);\r
/** @file\r
PKCS#7 SignedData Verification Wrapper Implementation over OpenSSL.\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
//\r
// Check input parameters.\r
//\r
- ASSERT (PrivateKey != NULL);\r
- ASSERT (KeyPassword != NULL);\r
- ASSERT (InData != NULL);\r
- ASSERT (SignCert != NULL);\r
- ASSERT (SignedData != NULL);\r
- ASSERT (SignedDataSize != NULL);\r
- ASSERT (InDataSize <= INT_MAX);\r
+ if (PrivateKey == NULL || KeyPassword == NULL || InData == NULL ||\r
+ SignCert == NULL || SignedData == NULL || SignedDataSize == NULL || InDataSize > INT_MAX) {\r
+ return FALSE;\r
+ }\r
\r
RsaContext = NULL;\r
Key = NULL;\r
Cryptographic Message Syntax Standard". The input signed data could be wrapped\r
in a ContentInfo structure.\r
\r
- If P7Data is NULL, then ASSERT().\r
+ If P7Data, TrustedCert or InData is NULL, then return FALSE.\r
+ If P7Length, CertLength or DataLength overflow, then return FAlSE.\r
\r
@param[in] P7Data Pointer to the PKCS#7 message to verify.\r
@param[in] P7Length Length of the PKCS#7 message in bytes.\r
BOOLEAN Wrapped;\r
\r
//\r
- // ASSERT if any input parameter is invalid.\r
+ // Check input parameters.\r
//\r
- ASSERT (P7Data != NULL);\r
- ASSERT (TrustedCert != NULL);\r
- ASSERT (InData != NULL);\r
- ASSERT (P7Length <= INT_MAX);\r
- ASSERT (CertLength <= INT_MAX);\r
- ASSERT (DataLength <= INT_MAX);\r
-\r
+ if (P7Data == NULL || TrustedCert == NULL || InData == NULL || \r
+ P7Length > INT_MAX || CertLength > INT_MAX || DataLength > INT_MAX) {\r
+ return FALSE;\r
+ }\r
+ \r
Status = FALSE;\r
Pkcs7 = NULL;\r
CertBio = NULL;\r
/** @file\r
RSA Asymmetric Cipher Wrapper Implementation over OpenSSL.\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
/**\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
IN VOID *RsaContext\r
)\r
{\r
- ASSERT (RsaContext != NULL);\r
-\r
//\r
// Free OpenSSL RSA Context\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
RSA *RsaKey;\r
\r
//\r
- // ASSERT if RsaContext is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (RsaContext != NULL);\r
-\r
+ if (RsaContext == NULL) {\r
+ return FALSE;\r
+ }\r
\r
RsaKey = (RSA *)RsaContext;\r
//\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
BIGNUM *BnKey;\r
UINTN Size;\r
\r
- ASSERT (RsaContext != NULL);\r
- ASSERT (BnSize != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (RsaContext == NULL || BnSize == NULL) {\r
+ return FALSE;\r
+ }\r
\r
RsaKey = (RSA *) RsaContext;\r
Size = *BnSize;\r
return FALSE;\r
}\r
\r
- ASSERT (BigNumber != NULL);\r
+ if (BigNumber == NULL) {\r
+ return FALSE;\r
+ }\r
*BnSize = BN_bn2bin (BnKey, BigNumber) ;\r
\r
return TRUE;\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
BIGNUM *KeyE;\r
BOOLEAN RetVal;\r
\r
- ASSERT (RsaContext != NULL);\r
-\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (RsaContext == NULL) {\r
+ return FALSE;\r
+ }\r
+ \r
KeyE = BN_new ();\r
if (PublicExponent == NULL) {\r
BN_set_word (KeyE, 0x10001);\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
{\r
UINTN Reason;\r
\r
- ASSERT (RsaContext != NULL);\r
-\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (RsaContext == NULL) {\r
+ return FALSE;\r
+ }\r
+ \r
if (RSA_check_key ((RSA *) RsaContext) != 1) {\r
Reason = ERR_GET_REASON (ERR_peek_last_error ());\r
if (Reason == RSA_R_P_NOT_PRIME ||\r
CONST UINT8 *HashDer;\r
UINTN DerSize;\r
\r
- ASSERT (Message != NULL);\r
- ASSERT (DigestInfo != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Message == NULL || DigestInfo == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// The original message length is used to determine the hash algorithm since\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
UINTN Size;\r
INTN ReturnVal;\r
\r
- ASSERT (RsaContext != NULL);\r
- ASSERT (MessageHash != NULL);\r
- ASSERT ((HashSize == MD5_DIGEST_SIZE) ||\r
- (HashSize == SHA1_DIGEST_SIZE) ||\r
- (HashSize == SHA256_DIGEST_SIZE));\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (RsaContext == NULL || MessageHash == NULL ||\r
+ (HashSize != MD5_DIGEST_SIZE && HashSize != SHA1_DIGEST_SIZE && HashSize != SHA256_DIGEST_SIZE)) {\r
+ return FALSE;\r
+ }\r
\r
Rsa = (RSA *) RsaContext;\r
Size = BN_num_bytes (Rsa->n);\r
return FALSE;\r
}\r
\r
- ASSERT (Signature != NULL);\r
+ if (Signature == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Size = DigestInfoEncoding (MessageHash, HashSize, Signature);\r
\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 or 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 or 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
INTN Length;\r
\r
//\r
- // ASSERT if RsaContext, MessageHash or Signature is NULL\r
+ // Check input parameters.\r
//\r
- ASSERT (RsaContext != NULL);\r
- ASSERT (MessageHash != NULL);\r
- ASSERT (Signature != NULL);\r
+ if (RsaContext == NULL || MessageHash == NULL || Signature == NULL) {\r
+ return FALSE;\r
+ }\r
\r
+ \r
//\r
- // ASSERT if unsupported hash size:\r
+ // Check for unsupported hash size:\r
// Only MD5, SHA-1 or SHA-256 digest size is supported\r
//\r
- ASSERT ((HashSize == MD5_DIGEST_SIZE) || (HashSize == SHA1_DIGEST_SIZE) ||\r
- (HashSize == SHA256_DIGEST_SIZE));\r
-\r
+ if (HashSize != MD5_DIGEST_SIZE && HashSize != SHA1_DIGEST_SIZE && HashSize != SHA256_DIGEST_SIZE) {\r
+ return FALSE;\r
+ }\r
+ \r
//\r
// RSA PKCS#1 Signature Decoding using OpenSSL RSA Decryption with Public Key\r
//\r
/** @file\r
X.509 Certificate Handler Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010 - 2011, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
/**\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
BOOLEAN Status;\r
\r
//\r
- // ASSERT if Cert is NULL or SingleX509Cert is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Cert != NULL);\r
- ASSERT (SingleX509Cert != NULL);\r
- ASSERT (CertSize <= INT_MAX);\r
+ if (Cert == NULL || SingleX509Cert == NULL || CertSize > INT_MAX) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
\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
UINTN Index;\r
\r
//\r
- // ASSERT if input X509Stack is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (X509Stack != NULL);\r
+ if (X509Stack == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
\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
X509Free (\r
IN VOID *X509Cert\r
)\r
-{\r
- ASSERT (X509Cert != NULL);\r
-\r
+{ \r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (X509Cert == NULL) {\r
+ return;\r
+ }\r
+ \r
//\r
// Free OpenSSL X509 object.\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
IN VOID *X509Stack\r
)\r
{\r
- ASSERT (X509Stack != NULL);\r
-\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (X509Stack == NULL) {\r
+ return;\r
+ }\r
+ \r
//\r
// Free OpenSSL X509 stack object.\r
//\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
X509_NAME *X509Name;\r
\r
//\r
- // ASSERT if Cert is NULL or SubjectSize is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Cert != NULL);\r
- ASSERT (SubjectSize != NULL);\r
+ if (Cert == NULL || SubjectSize == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
X509Cert = NULL;\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
BOOLEAN Status;\r
EVP_PKEY *Pkey;\r
X509 *X509Cert;\r
-\r
+ \r
//\r
- // ASSERT if Cert is NULL or RsaContext is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Cert != NULL);\r
- ASSERT (RsaContext != NULL);\r
+ if (Cert == NULL || RsaContext == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
Pkey = NULL;\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
X509 *X509CACert;\r
X509_STORE *CertStore;\r
X509_STORE_CTX CertCtx;\r
-\r
+ \r
//\r
- // ASSERT if Cert is NULL or CACert is NULL.\r
+ // Check input parameters.\r
//\r
- ASSERT (Cert != NULL);\r
- ASSERT (CACert != NULL);\r
+ if (Cert == NULL || CACert == NULL) {\r
+ return FALSE;\r
+ }\r
\r
Status = FALSE;\r
X509Cert = NULL;\r
/** @file\r
Pseudorandom Number Generator Wrapper Implementation over OpenSSL.\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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
/**\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
IN UINTN Size\r
)\r
{\r
- ASSERT (Output != NULL);\r
+ //\r
+ // Check input parameters.\r
+ //\r
+ if (Output == NULL) {\r
+ return FALSE;\r
+ }\r
\r
//\r
// Generate random data.\r
/** @file\r
Implementation of The runtime cryptographic library instance (for IPF).\r
\r
-Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2010 - 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 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[in, out] Sha256Context Pointer to SHA-256 Context being initialized.\r
\r
Performs SHA-256 digest on a data buffer of the specified length. This function can\r
be called multiple times to compute the digest of long or discontinuous data streams.\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
Completes SHA-256 hash computation and retrieves the digest value into the specified\r
memory. After this function has been called, the SHA-256 context cannot be used again.\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 SHA-256 context\r
@param[out] HashValue Pointer to a buffer that receives the SHA-256 digest\r
the user-specified nonnegative integer (octet string format represented in RSA\r
PKCS#1).\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
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 HashLength is not equal to the size of MD5, SHA-1 or 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 HashLength is not equal to the size of MD5, SHA-1 or 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
projects / mirror_edk2.git / commitdiff