Developer Guide and Reference for Intel® Cryptography Primitives Library
A newer version of this document is available. Customers should click here to go to the newest version.
HKDF
Computes the output key material from input key material, salt, info, and hash method per the HKDF standard.
Syntax
IppStatus ippsHKDF(const Ipp8u* ikm, int ikmLen, Ipp8u* okm, int okmLen, const Ipp8u* salt, int saltLen, const Ipp8u* info, int infoLen, const IppsHashMethod* pMethod);
Include Files
ippcp.h
Parameters
ikm |
Pointer to the input keying material. |
ikmLen |
Length of the input keying material in bytes. |
okm |
Pointer to the output keying material. |
okmLen |
Length of needed output keying material in bytes. |
salt |
Pointer to salt value. |
saltLen |
Length of salt value in bytes. |
info |
Pointer to the info. |
infoLen |
Length of the info in bytes. |
pMethod |
Pointer to the hash method context. |
Description
The function computes the output keying material as a part of the Hashed Message Authentication Code (HMAC)-based key derivation function (HKDF) as specified in RFC 5869.
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. |
ippStsLengthErr |
Indicates an error condition if any of the specified length parameters are invalid. |
ippStsNotSupportedModeErr |
Indicates hash method is not supported |