Cryptography for Intel(R) Integrated Performance Primitives Developer Reference

Download
ID 768738
Date 12/16/2022
Public
Document Table of Contents
Document Table of Contents x
Developer Reference for Intel® Integrated Performance Primitives Cryptography
Developer Reference for Intel® Integrated Performance Primitives Cryptography x
Getting Help and Support What's New Notational Conventions Related Products Overview Symmetric Cryptography Primitive Functions One-Way Hash Primitives Data Authentication Primitive Functions Public Key Cryptography Functions Finite Field Arithmetic Multi-buffer Cryptography Functions Appendix A: Support Functions and Classes Removed Functions Bibliography Notices and Disclaimers
Overview x
Basic Features Function Context Structures Data Security Considerations
Symmetric Cryptography Primitive Functions x
Block Cipher Modes of Operation Rijndael Functions AES-CCM Functions AES-GCM Functions AES-SIV Functions AES-XTS Functions TDES Functions SMS4 Functions ARCFour Functions
Rijndael Functions x
<span class='option'>AESGetSize</span> <span class='option'>AESInit</span> <span class='option'>AESSetKey</span> <span class='option'>AESPack, AESUnpack</span> <span class='option'>AESEncryptECB</span> <span class='option'>AESDecryptECB</span> <span class='option'>AESEncryptCBC</span> <span class='option'>AESDecryptCBC</span> <span class='option'>AESEncryptCBC_CS</span> <span class='option'>AESDecryptCBC_CS</span> <span class='option'>AESEncryptCFB</span> <span class='option'>AES_EncryptCFB16_MB</span> <span class='option'> AESDecryptCFB</span> <span class='option'>AESEncryptOFB</span> <span class='option'>AESDecryptOFB</span> <span class='option'>AESEncryptCTR</span> <span class='option'>AESDecryptCTR</span> <span class='option'>AESEncryptXTS_Direct, AESDecryptXTS_Direct</span> Example of Using AES Functions
AES-CCM Functions x
<span class='option'>AES_CCMGetSize</span> <span class='option'>AES_CCMInit</span> <span class='option'>AES_CCMStart</span> <span class='option'>AES_CCMEncrypt</span> <span class='option'>AES_CCMDecrypt</span> <span class='option'>AES_CCMGetTag</span> <span class='option'>AES_CCMMessageLen</span> <span class='option'>AES_CCMTagLen</span>
AES-GCM Functions x
<span class='option'>AES_GCMGetSize</span> <span class='option'>AES_GCMInit</span> <span class='option'>AES_GCMStart</span> <span class='option'>AES_GCMReset</span> <span class='option'>AES_GCMProcessIV</span> <span class='option'>AES_GCMProcessAAD</span> <span class='option'>AES_GCMEncrypt</span> <span class='option'>AES_GCMDecrypt</span> <span class='option'>AES_GCMGetTag</span>
AES-SIV Functions x
<span class='option'>AES_S2V_CMAC</span> <span class='option'>AES_SIVEncrypt</span> <span class='option'>AES_SIVDecrypt</span> Usage Example
AES-XTS Functions x
<span class='option'>AES_XTSGetSize</span> <span class='option'>AES_XTSInit</span> <span class='option'>AES_XTSEncrypt</span> <span class='option'>AES_XTSDecrypt</span>
TDES Functions x
<span class='option'>DESGetSize </span> <span class='option'>DESInit</span> DESPack, DESUnpack <span class='option'>TDESEncryptECB</span> <span class='option'>TDESDecryptECB</span> <span class='option'>TDESEncryptCBC</span> <span class='option'>TDESDecryptCBC</span> <span class='option'>TDESEncryptCFB</span> <span class='option'>TDESDecryptCFB</span> <span class='option'>TDESEncryptOFB</span> <span class='option'>TDESDecryptOFB</span> <span class='option'>TDESEncryptCTR</span> <span class='option'>TDESDecryptCTR</span> Example of Using TDES Functions
SMS4 Functions x
<span class='option'>SMS4GetSize</span> <span class='option'>SMS4Init</span> <span class='option'>SMS4SetKey</span> <span class='option'>SMS4EncryptECB</span> <span class='option'>SMS4DecryptECB</span> <span class='option'>SMS4EncryptCBC</span> <span class='option'>SMS4DecryptCBC</span> <span class='option'>SMS4EncryptCBC_CS</span> <span class='option'>SMS4DecryptCBC_CS</span> <span class='option'>SMS4EncryptCFB</span> <span class='option'>SMS4DecryptCFB</span> <span class='option'>SMS4EncryptOFB</span> <span class='option'>SMS4DecryptOFB</span> <span class='option'>SMS4EncryptCTR</span> <span class='option'>SMS4DecryptCTR</span>
ARCFour Functions x
<span class='option'>ARCFourGetSize</span> <span class='option'>ARCFourCheckKey</span> <span class='option'>ARCFourInit</span> ARCFourPack, ARCFourUnpack <span class='option'>ARCFourEncrypt</span> <span class='option'>ARCFourDecrypt</span> <span class='option'>ARCFourReset</span>
One-Way Hash Primitives x
Hash Functions Hash Functions for Non-Streaming Messages Mask Generation Functions
Hash Functions x
<span class='option'>HashGetSize</span> <span class='option'>HashInit</span> <span class='option'>HashPack, HashUnpack</span> <span class='option'>HashDuplicate</span> <span class='option'>HashUpdate</span> <span class='option'>HashFinal</span> <span class='option'>HashGetTag</span> <span class='option'>HashMethod</span> <span class='option'> HashMethodSet</span> <span class='option'>HashMethodGetSize</span> <span class='option'>SM3GetSize</span> <span class='option'>SM3Init</span> <span class='option'>SM3Pack, SM3Unpack</span> <span class='option'>SM3Duplicate</span> <span class='option'>SM3Update</span> <span class='option'>SM3Final</span> <span class='option'>SM3GetTag</span> <span class='option'>MD5GetSize</span> <span class='option'>MD5Init</span> <span class='option'>MD5Pack, MD5Unpack</span> <span class='option'>MD5Duplicate</span> <span class='option'>MD5Update</span> <span class='option'>MD5Final</span> <span class='option'>MD5GetTag</span> <span class='option'>SHA1GetSize</span> <span class='option'>SHA1Init</span> SHA1Pack, SHA1Unpack <span class='option'>SHA1Duplicate</span> <span class='option'>SHA1Update</span> <span class='option'>SHA1Final</span> <span class='option'>SHA1GetTag</span> <span class='option'>SHA224GetSize</span> <span class='option'>SHA224Init</span> SHA224Pack, SHA224Unpack <span class='option'>SHA224Duplicate</span> <span class='option'>SHA224Update</span> <span class='option'>SHA224Final</span> <span class='option'>SHA224GetTag</span> <span class='option'>SHA256GetSize</span> <span class='option'>SHA256Init</span> SHA256Pack, SHA256Unpack <span class='option'>SHA256Duplicate</span> <span class='option'>SHA256Update</span> <span class='option'>SHA256Final</span> <span class='option'>SHA256GetTag</span> <span class='option'>SHA384GetSize</span> <span class='option'>SHA384Init</span> SHA384Pack, SHA384Unpack <span class='option'>SHA384Duplicate</span> <span class='option'>SHA384Update</span> <span class='option'> SHA384Final</span> <span class='option'>SHA384GetTag</span> <span class='option'>SHA512GetSize</span> <span class='option'>SHA512Init</span> SHA512Pack, SHA512Unpack <span class='option'>SHA512Duplicate</span> <span class='option'>SHA512Update</span> <span class='option'>SHA512Final</span> <span class='option'>SHA512GetTag</span>
Hash Functions for Non-Streaming Messages x
General Definition of a Hash Function <span class='option'>HashMessage</span> <span class='option'>SM3MessageDigest</span> <span class='option'>MD5MessageDigest</span> <span class='option'>SHA1MessageDigest</span> <span class='option'>SHA224MessageDigest</span> <span class='option'>SHA256MessageDigest</span> <span class='option'>SHA384MessageDigest</span> <span class='option'>SHA512MessageDigest</span>
Mask Generation Functions x
User's Implementation of a Mask Generation Function <span class='option'>MGF</span> <span class='option'>MGF1_rmf, MGF2_rmf</span>
Data Authentication Primitive Functions x
Message Authentication Functions
Message Authentication Functions x
Keyed Hash Functions CMAC Functions
Keyed Hash Functions x
<span class='option'>HMAC_GetSize</span> <span class='option'>HMAC_Init</span> <span class='option'>HMAC_Pack, HMAC_Unpack</span> <span class='option'>HMAC_Duplicate </span> <span class='option'>HMAC_Update</span> <span class='option'>HMAC_Final</span> <span class='option'>HMAC_GetTag</span> <span class='option'>HMAC_Message</span>
CMAC Functions x
<span class='option'>AES_CMACGetSize</span> <span class='option'>AES_CMACInit</span> <span class='option'>AES_CMACUpdate</span> <span class='option'>AES_CMACFinal</span> <span class='option'>AES_CMACGetTag</span>
Public Key Cryptography Functions x
Big Number Arithmetic Montgomery Reduction Scheme Functions Pseudorandom Number Generation Functions See Also Prime Number Generation Functions RSA Algorithm Functions Discrete-Logarithm-Based Cryptography Functions Elliptic Curve Cryptography Functions
Big Number Arithmetic x
<span class='option'> BigNumGetSize</span> <span class='option'> BigNumInit</span> <span class='option'>Set_BN</span> <span class='option'>SetOctString_BN</span> <span class='option'> GetSize_BN </span> <span class='option'> Get_BN</span> <span class='option'>ExtGet_BN</span> <span class='option'> Ref_BN</span> <span class='option'>GetOctString_BN</span> <span class='option'> Cmp_BN </span> <span class='option'> CmpZero_BN</span> <span class='option'>Add_BN</span> <span class='option'>Sub_BN</span> <span class='option'>Mul_BN</span> <span class='option'>MAC_BN_I</span> <span class='option'>Div_BN</span> <span class='option'>Mod_BN</span> <span class='option'>Gcd_BN</span> <span class='option'>ModInv_BN</span>
Montgomery Reduction Scheme Functions x
<span class='option'> MontGetSize</span> <span class='option'>MontInit</span> <span class='option'>MontSet</span> <span class='option'>MontGet</span> <span class='option'>MontForm</span> <span class='option'>MontMul</span> Example of Using Montgomery Reduction Scheme Functions <span class='option'>MontExp</span>
Pseudorandom Number Generation Functions x
See Also User's Implementation of a Pseudorandom Number Generator <span class='option'> PRNGGetSize </span> <span class='option'> PRNGInit</span> <span class='option'>PRNGSetSeed</span> <span class='option'>PRNGGetSeed</span> <span class='option'> PRNGSetAugment </span> <span class='option'> PRNGSetModulus </span> <span class='option'> PRNGSetH0 </span> <span class='option'>PRNGen</span> <span class='option'>PRNGenRDRAND</span> <span class='option'>TRNGenRDSEED</span> <span class='option'> PRNGen_BN </span> <span class='option'>PRNGenRDRAND_BN </span> <span class='option'>TRNGenRDSEED_BN </span> Example of Using Pseudorandom Number Generation Functions
Prime Number Generation Functions x
<span class='option'> PrimeGetSize </span> <span class='option'> PrimeInit</span> <span class='option'>PrimeGen_BN</span> <span class='option'>PrimeTest_BN</span> <span class='option'>PrimeGen</span> <span class='option'>PrimeTest</span> <span class='option'>PrimeSet</span> <span class='option'>PrimeSet_BN </span> <span class='option'>PrimeGet</span> <span class='option'>PrimeGet_BN </span> Example of Using Prime Number Generation Functions
RSA Algorithm Functions x
Functions for Building RSA System RSA Primitives RSA Encryption Schemes RSA Signature Schemes
Functions for Building RSA System x
<span class='option'>RSA_GetSizePublicKey, RSA_GetSizePrivateKeyType1, RSA_GetSizePrivateKeyType2</span> <span class='option'>RSA_InitPublicKey, RSA_InitPrivateKeyType1, RSA_InitPrivateKeyType2</span> <span class='option'>RSA_SetPublicKey, RSA_SetPrivateKeyType1, RSA_SetPrivateKeyType2</span> <span class='option'>RSA_GetPublicKey, RSA_GetPrivateKeyType1, RSA_GetPrivateKeyType2</span> <span class='option'>RSA_GetBufferSizePublicKey, RSA_GetBufferSizePrivateKey</span> <span class='option'>RSA_MB_GetBufferSizePublicKey, RSA_MB_GetBufferSizePrivateKey</span> <span class='option'>RSA_GenerateKeys</span> <span class='option'>RSA_ValidateKeys</span>
RSA Primitives x
<span class='option'>RSA_Encrypt</span> <span class='option'>RSA_MB_Encrypt</span> <span class='option'>RSA_Decrypt</span> <span class='option'>RSA_MB_Decrypt</span> Example of Using RSA Primitive Functions
RSA Encryption Schemes x
RSA-OAEP Scheme Functions PKCS V1.5 Encryption Scheme Functions
RSA-OAEP Scheme Functions x
<span class='option'>RSAEncrypt_OAEP</span> <span class='option'>RSADecrypt_OAEP</span>
PKCS V1.5 Encryption Scheme Functions x
<span class='option'>RSAEncrypt_PKCSv15 </span> <span class='option'>RSADecrypt_PKCSv15 </span>
RSA Signature Schemes x
RSA-SSA Scheme Functions PKCS V1.5 Signature Scheme Functions
RSA-SSA Scheme Functions x
<span class='option'>RSASign_PSS</span> <span class='option'>RSA_MB_Sign_PSS_rmf</span> <span class='option'>RSAVerify_PSS</span> <span class='option'>RSA_MB_Verify_PSS_rmf</span>
PKCS V1.5 Signature Scheme Functions x
<span class='option'>RSASign_PKCS1v15</span> <span class='option'>RSA_MB_Sign_PKCS1v15_rmf</span> <span class='option'>RSAVerify_PKCS1v15</span> <span class='option'>RSA_MB_Verify_PKCS1v15_rmf</span>
Discrete-Logarithm-Based Cryptography Functions x
<span class='option'> DLPGetSize </span> <span class='option'> DLPInit </span> DLPPack, DLPUnpack <span class='option'> DLPSet </span> <span class='option'> DLPGet </span> <span class='option'> DLPSetDP </span> <span class='option'> DLPGetDP </span> <span class='option'> DLPGenKeyPair </span> <span class='option'> DLPPublicKey </span> <span class='option'> DLPValidateKeyPair </span> <span class='option'> DLPSetKeyPair </span> <span class='option'> DLPGenerateDSA </span> <span class='option'> DLPValidateDSA </span> <span class='option'> DLPSignDSA </span> <span class='option'>DLPVerifyDSA</span> Example of Using Discrete-logarithm Based Primitive Functions <span class='option'> DLPGenerateDH </span> <span class='option'> DLPValidateDH </span> <span class='option'> DLPSharedSecretDH </span> <span class='option'>DLGetResultString</span>
Elliptic Curve Cryptography Functions x
Functions Based on GF(<i>p</i>) Functions based on SM2 Arithmetic of the Group of Elliptic Curve Points <span class='option'>ECCGetResultString</span>
Functions Based on GF(<i>p</i>) x
<span class='option'>ECCPGetSize</span> <span class='option'>ECCPGetSizeStd</span> <span class='option'> ECCPInit </span> <span class='option'>ECCPInitStd</span> <span class='option'>ECCPBindGxyTblStd</span> <span class='option'> ECCPSet </span> <span class='option'>ECCPSetStd </span> <span class='option'>ECCPGet</span> <span class='option'>ECCPGetOrderBitSize</span> <span class='option'> ECCPValidate </span> <span class='option'> ECCPPointGetSize </span> <span class='option'> ECCPPointInit </span> <span class='option'> ECCPSetPoint </span> <span class='option'> ECCPSetPointAtInfinity </span> <span class='option'> ECCPGetPoint </span> <span class='option'> ECCPCheckPoint </span> <span class='option'> ECCPComparePoint </span> <span class='option'> ECCPNegativePoint </span> <span class='option'> ECCPAddPoint </span> <span class='option'> ECCPMulPointScalar </span> <span class='option'> ECCPGenKeyPair </span> <span class='option'> ECCPPublicKey </span> <span class='option'> ECCPValidateKeyPair </span> <span class='option'> ECCPSetKeyPair </span> <span class='option'> ECCPSharedSecretDH </span> <span class='option'>ECCPSharedSecretDHC</span> <span class='option'>ECCPSignDSA </span> <span class='option'>ECCPVerifyDSA </span> <span class='option'>ECCPSignNR</span> <span class='option'>ECCPVerifyNR </span> <span class='option'>ECCPSignSM2</span> <span class='option'>ECCPVerifySM2</span> Signing/Verification Using the Elliptic Curve Cryptography Functions over a Prime Finite Field
Functions based on SM2 x
<span class='option'>GFpECESGetSize_SM2</span> <span class='option'>GFpECESInit_SM2</span> <span class='option'>GFpECESSetKey_SM2</span> <span class='option'>GFpECESStart_SM2</span> <span class='option'>GFpECESEncrypt_SM2</span> <span class='option'>GFpECESDecrypt_SM2</span> <span class='option'>GFpECESFinal_SM2</span> <span class='option'>GFpECESGetBufferSize_SM2</span>
Arithmetic of the Group of Elliptic Curve Points x
<span class='option'>GFpECGetSize</span> <span class='option'>GFpECInit</span> <span class='option'>GFpECSet</span> <span class='option'>GFpECSetSubgroup</span> <span class='option'>GFpECInitStd</span> <span class='option'>GFpECGet</span> <span class='option'>GFpECGetSubgroup</span> <span class='option'>GFpECScratchBufferSize</span> <span class='option'>GFpECVerify</span> <span class='option'>GFpECPointGetSize</span> <span class='option'>GFpECPointInit</span> <span class='option'>GFpECSetPointAtInfinity</span> <span class='option'>GFpECSetPoint</span>, <span class='option'>GFpECSetPointREgular</span> <span class='option'>GFpECSetPointOctString</span> <span class='option'>GFpECSetPointRandom</span> <span class='option'>GFpECMakePoint</span> <span class='option'>GFpECSetPointHash</span>, <span class='option'>GFpECSetPointHashBackCompatible</span>, <span class='option'>GFpECSetPointHash_rmf</span>, <span class='option'>GFpECSetPointHashBackCompatible_rmf</span> <span class='option'>GFpECGetPoint</span> , <span class='option'>GFpECGetPointRegular</span> <span class='option'>GFpECGetPointOctString</span> <span class='option'>GFpECTstPoint</span> <span class='option'>GFpECTstPointInSubgroup</span> <span class='option'>GFpECCpyPoint</span> <span class='option'>GFpECCmpPoint</span> <span class='option'>GFpECNegPoint</span> <span class='option'>GFpECAddPoint</span> <span class='option'>GFpECMulPoint</span> <span class='option'>GFpECPrivateKey</span>, <span class='option'>GFpECPublicKey</span>, <span class='option'>GFpECTstKeyPair</span> <span class='option'>GFpECPublicKey</span> <span class='option'>GFpECTstKeyPair</span> <span class='option'>GFpECPSharedSecretDH</span>, <span class='option'>GFpECPSharedSecretDHC</span> <span class='option'>GFpECSharedSecretDHC</span> <span class='option'>GFpECPSignDSA</span>, <span class='option'>GFpECPSignNR</span>, <span class='option'>GFpECPSignSM2</span> <span class='option'>GFpECPVerifyDSA</span>, <span class='option'>GFpECPVerifyNR</span>, <span class='option'>GFpECPVerifySM2</span> <span class='option'>GFpECSignNR</span> <span class='option'>GFpECVerifyNR</span> <span class='option'>GFpECSignSM2</span> <span class='option'>GFpECVerifySM2</span>
Finite Field Arithmetic x
<span class='option'>GFpInit</span> <span class='option'>GFpMethod</span> <span class='option'>GFpGetSize</span> <span class='option'>GFpxInitBinomial</span> <span class='option'>GFpxInit</span> <span class='option'>GFpxMethod</span> <span class='option'>GFpxGetSize</span> <span class='option'>GFpScratchBufferSize</span> <span class='option'>GFpElementGetSize</span> <span class='option'>GFpElementInit</span> <span class='option'>GFpSetElement</span> <span class='option'>GFpSetElementOctString</span> <span class='option'>GFpSetElementRandom</span> <span class='option'>GFpSetElementHash</span> <span class='option'>GFpCpyElement</span> <span class='option'>GFpGetElement</span> <span class='option'>GFpGetElementOctString</span> <span class='option'>GFpCmpElement</span> <span class='option'>GFpIsZeroElement</span> <span class='option'>GFpIsUnityElement</span> <span class='option'>GFpConj</span> <span class='option'>GFpNeg</span> <span class='option'>GFpInv</span> <span class='option'>GFpSqrt</span> <span class='option'>GFpAdd</span> <span class='option'>GFpSub</span> <span class='option'>GFpMul</span> <span class='option'>GFpSqr</span> <span class='option'>GFpExp</span> <span class='option'>GFpMultiExp</span> <span class='option'>GFpAdd_PE</span> <span class='option'>GFpSub_PE</span> <span class='option'>GFpMul_PE</span>
Multi-buffer Cryptography Functions x
RSA Algorithm Functions NIST Recommended Elliptic Curve Functions Montgomery Curve25519 Elliptic Curve Functions Edwards Curve25519 Elliptic Curve Functions SM2 Elliptic Curve Functions SM3 Hash Functions SM4 Algorithm Functions Modular Exponentiation
RSA Algorithm Functions x
<span class='option'>mbx_rsa_public</span> <span class='option'>mbx_rsa_private</span> <span class='option'>mbx_rsa_private_crt</span> <span class='option'>mbx_RSA_Method_BufSize</span>
NIST Recommended Elliptic Curve Functions x
<span class='option'>mbx_nistp256/384/521_ecdsa_sign_setup</span> <span class='option'>mbx_nistp256/384/521_ecdsa_sign_complete</span> <span class='option'>mbx_nistp256/384/521_ecdsa_sign</span> <span class='option'>mbx_nistp256/384/521_ecdsa_verify</span> <span class='option'>mbx_nistp256/384/521_ecpublic_key</span> <span class='option'>mbx_nistp256/384/521_ecdh</span>
Montgomery Curve25519 Elliptic Curve Functions x
<span class='option'>mbx_x25519_public_key</span> <span class='option'>mbx_x25519</span>
Edwards Curve25519 Elliptic Curve Functions x
<span class='option'>mbx_ed25519_public_key_mb8</span> <span class='option'>mbx_ed25519_sign_mb8</span> <span class='option'>mbx_ed25519_verify_mb8</span>
SM2 Elliptic Curve Functions x
<span class='option'>mbx_sm2_ecdsa_sign</span> <span class='option'>mbx_sm2_ecdsa_verify</span> <span class='option'>mbx_sm2_ecpublic_key</span> <span class='option'>mbx_nistp256/384/521_ecdh</span>
SM3 Hash Functions x
<span class='option'>mbx_sm3_msg_digest_mb16</span> <span class='option'>mbx_sm3_init_mb16</span> <span class='option'>mbx_sm3_update_mb16</span> <span class='option'>mbx_sm3_final_mb16</span>
SM4 Algorithm Functions x
<span class='option'>mbx_sm4_set_key_mb16</span> <span class='option'>mbx_sm4_encrypt/decrypt_ecb_mb16</span> <span class='option'>mbx_sm4_encrypt/decrypt_cbc_mb16</span> <span class='option'>mbx_sm4_encrypt/decrypt_ctr128_mb16</span> <span class='option'>mbx_sm4_encrypt/decrypt_ofb_mb16</span> <span class='option'>mbx_sm4_encrypt/decrypt_cfb128_mb16</span>
Modular Exponentiation x
<span class='option'>mbx_exp/1024/2048/3072/4096_mb8</span> <span class='option'>mbx_exp_BufferSize</span>
Appendix A: Support Functions and Classes x
Security Validation of Library Functions Version Information Function Dispatcher Control Functions Other Functions Classes and Functions Used in Examples
Version Information Function x
<span class='option'>GetLibVersion</span>
Dispatcher Control Functions x
<span class='option'>Init</span>
Other Functions x
<span class='option'>GetCpuFeatures</span> <span class='option'>SetCpuFeatures</span> <span class='option'>GetEnabledCpuFeatures</span> <span class='option'>GetCpuClocks</span> <span class='option'>GetNumThreads</span> <span class='option'>GetEnabledNumThreads</span> <span class='option'>SetNumThreads</span> <span class='option'>GetStatusString</span>
Classes and Functions Used in Examples x
BigNumber Class Functions for Creation of Cryptographic Contexts
Developer Reference for Intel® Integrated Performance Primitives Cryptography

Pseudorandom Number Generation Functions

Many cryptographic systems rely on pseudorandom number generation functions in their design that make the unpredictable nature inherited from a pseudorandom number generator the security foundation to ensure safe communication over open channels and protection against potential adversaries.

This section describes functions that make the pseudorandom bit sequence generator implemented by a US FIPS-approved method and based on a SHA-1 one-way hash function specified by [FIPS PUB 186-2], appendix 3.

The application code for generating a sequence of pseudorandom bits should perform the following sequence of operations:

  1. Call the function PRNGGetSize to get the size required to configure the IppsPRNGState context.
  2. Ensure that the required memory space is properly allocated. With the allocated memory, call the PRNGInit function to set up the default value of the parameters for pseudorandom generation process.
  3. If the default values of the parameters are not satisfied, call the function PRNGSetSeed and/or PRNGSetAugment and/or PRNGSetModulus and/or PRNGSetH0 to reset any of the control pseudorandom generator parameters.
  4. Keep calling the function PRNGen or PRNGen_BN to generate pseudo random value of the desired format.
  5. Clean up secret data stored in the context.
  6. Free the memory allocated for the IppsPRNGState context by calling the operating system memory free service function.
Parent topic: Public Key Cryptography Functions
  • User's Implementation of a Pseudorandom Number Generator
  • PRNGGetSize
    Gets the size of the IppsPRNGState context in bytes.
  • PRNGInit
    Initializes user-supplied memory as IppsPRNGState context for future use.
  • PRNGSetSeed
    Sets up the seed value for the pseudorandom number generator.
  • PRNGGetSeed
    Extracts the seed value of the pseudorandom number generator from the context structure.
  • PRNGSetAugment
    Sets the initial state with the given input entropy for the pseudorandom number generation.
  • PRNGSetModulus
    Sets the initial state with the given input modulus for the pseudorandom number generation.
  • PRNGSetH0
    Sets the initial state with the given input IV for the SHA-1 algorithm.
  • PRNGen
    Generates a pseudorandom unsigned Big Number of the specified bit length.
  • PRNGenRDRAND
    Generates a pseudorandom unsigned Big Number of the specified bit length using the RDRAND instruction.
  • TRNGenRDSEED
    Generates a true random unsigned Big Number of the specified bit length using the RDSEED instruction.
  • PRNGen_BN
    Generates a pseudorandom positive Big Number of the specified bitlength.
  • PRNGenRDRAND_BN
    Generates a pseudorandom positive Big Number of the specified bit length using the RDRAND instruction.
  • TRNGenRDSEED_BN
    Generates a true random positive Big Number of the specified bit length using the RDSEED instruction.
  • Example of Using Pseudorandom Number Generation Functions

See Also

Level Two Title

Did you find the information on this page useful?

Characters remaining:

Feedback Message