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. If the context is used exclusively for ippsMLDSA_Verify_Mu, which does not depend on the message length, the IPPCP_MLDSA_NO_MESSAGE macro can be passed as a dummy value.

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.

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 (and not equal to IPPCP_MLDSA_NO_MESSAGE) or greater than the allowed maximum.
Contents