CMACRijndael128MessageDigest

Computes the MAC value of the entire message.

Syntax

IppStatus ippsCMACRijndael128MessageDigest(const Ipp8u *pMsg, int msgLen, const Ipp8u *pKey, IppsRijndaelKeyLength keyLen, Ipp8u *pMD, int mdLen);

Parameters

pMsg

Pointer to the input message.

msgLen

Message length in bytes.

pKey

Pointer to the user-supplied key.

keyLen

Key length.

pMD

Pointer to the resulting MAC value.

mdLen

Specified MAC length.

Description

This function is declared in the ippcp.h file. The function takes the input key pKey of the specified key length keyLen and applies keyed cipher-based message authentication code scheme to transform the entire input message into the respective message authentication code pMAC of the specified length mdLen.

The function is actually a wrapper around the CMACRijndael128Init, CMACSafeRijndael128Init, CMACRijndael128Update, and CMACRijndael128Final functions. If your application has no access to all the necessary data, you can compute the MAC using a typical sequence of invoking the primitives, like the one described at the beginning of the Keyed Hash Functions section. CMACMessageDigest is convenient when the application can access the entire message. In this case, you can use this function to compute the result in a single call.

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 msgLen is less than zero, mdLen is less than 1 or greater than cipher's data block length, or keyLen value is illegal.

See Also

Submit feedback on this help topic

Copyright © 2000 - 2010, Intel Corporation. All rights reserved.