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 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
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

<span class='option'>GFpECESEncrypt_SM2</span>

Encrypts the plaintext data buffer.

Syntax

IppStatus ippsGFpECESEncrypt_SM2(const Ipp8u* pInput, Ipp8u* pOutput, int len, IppsECES_StateSM2* pState);

Include Files

ippcp.h

Parameters

pInput

 Pointer to the plaintext data buffer.

pOutput

 Pointer to the ciphertext data buffer.

len

 Length of the input and output buffers.

pState

 Pointer to the buffer being initialized as the ECES context.
Description

The function encrypts the plaintext data buffer and updates the authentication tag. For more information on encryption and authentication, see [SM2 PKE]

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or warning.

ippStsNullPtrErr

 Indicates an error condition if any of the specified pointers is NULL.

ippStsContextMatchErr

 Indicates an error condition if the IppsECES_StateSM2 context parameter does not match the operation.

ippStsSizeErr

 Indicates an error condition if the len parameter has a negative value.
Parent topic: Functions based on SM2
Level Two Title

Did you find the information on this page useful?

Characters remaining:

Feedback Message