ippsAES_CMACSetupNoise

Turns on the mitigation for AES-CMAC mode - the ippsAES_CMACUpdate processing function.

Syntax

IppStatus ippsAES_CMACSetupNoise,(Ipp32u noiseLevel, IppsAES_CMACState* pState)

Include Files

ippcp.h

Parameters

noiseLevel

The value of this parameter is directly proportional to the amount of noise to be injected. Increasing the noiseLevel by 1 means the delay (performance impact) is doubled.

pState

Pointer to the IppsAES_CMACState context.

Description

This function saves noise parameters in the pState context structure. A user-adjustable parameter is noiseLevel, it can be varied from 0 to 4. When processing function is called with this context it checks the context for the noiseLevel value and if it is non-zero, the function enables mitigation mechanism: the data passed to the processing function is divided into chunks, and each chunk is followed by probabilistic noise injection.

Return Values

ippStsNullPtrErr

Indicates an error condition if pState pointer is NULL.

ippStsContextMatchErr

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

ippStsLengthErr

Indicates an error if noiseLevel > 4.

ippStsNotSupportedModeErr

Indicates an error condition if the AES-NI and VAES-NI instructions are not available on the target processor.

ippStsNoErr

Indicates no error.

Any other value indicates an error or a warning.