ippsAESSetupNoise

Turns on the mitigation for AES-ECB mode - the ippsAESDecryptECB and ippsAESEncryptECB processing functions.

Syntax

IppStatus ippsAESSetupNoise(Ipp32u noiseLevel, IppsAESSpec* pCtx);

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.

pCtx

Pointer to the IppsAESSpec context.

Description

ippsAESSetupNoise saves noise parameters in the pCtx context structure. A user-adjustable parameter is noiseLevel, it can be varied from 0 to 4. When the processing function is called with this context it checks the context for 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 pCtx pointer is NULL.

ippStsContextMatchErr

Indicates an error condition if the pCtx 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.