ippsMLDSA_Init

ippsMLDSA_Init#

Initializes IppsMLDSAState for the further ML-DSA computations.

Syntax#

IppStatus ippsMLDSA_Init(IppsMLDSAState* pMLDSACtx,
                         Ipp32s maxMessageLength,
                         IppsMLDSAParamSet schemeType);

Include Files#

ippcp.h

Parameters#

pMLDSACtx

Pointer to the ML-DSA state.

maxMessageLength

Maximum message length in bytes. The parameter is used to calculate the size of the internal buffers. The maximum message length should be less than 2^32 bytes - number of bytes required for temporary buffers. Size of such buffers can be obtained using API to query working buffers size.

schemeType

Parameter specifying the scheme type. See Supported ML-DSA parameters for more information.

Description#

The function initializes IppsMLDSAState for the further ML-DSA computations.

Note

Important

The API family is supported in experimental mode. To use the functions, users need to define the IPPCP_PREVIEW_ML_DSA macro before including the ippcp.h header file. See Preview Features for more details.

Return Values#

ippStsNoErr

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

ippStsNullPtrErr

pMLDSACtx is a NULL pointer.

ippStsBadArgErr

schemeType is not supported.

ippStsLengthErr

maxMessageLength is less than 1 or greater than the allowed maximum.
Contents