RSA_MB_Sign_PSS_rmf¶
Performs RSA multi-buffer signature generation using RSASSA-PSS scheme.
Syntax¶
Note
This API is deprecated from Intel® IPP Cryptography and is removed since 2021.2 release. It is recommended to switch to Crypto MB library. If you have any concerns, open a ticket and provide feedback at Intel ® online support center.
IppStatus ippsRSA_MB_Sign_PSS_rmf(const Ipp8u*pMsgs[8],const intmsgLens[8], const Ipp8u*pSalts[8],const intsaltLens[8],Ipp8u*pSignts[8], const IppsRSAPrivateKeyState*pPrvKeys[8], const IppsRSAPublicKeyState*pPubKeys[8], const IppsHashMethod*pMethod, IppStatusstatuses[8], Ipp8u*pBuffer);
Include Files¶
ippcp.h
Parameters¶
pMsgs[8] |
Pointer to the array of messages to be signed. |
msgLens[8] |
Pointer to the array of messages lengths. |
pSalts[8] |
Pointer to the array of random octet salt strings. |
saltLens[8] |
Pointer to the array of salts lengths. |
pSignts[8] |
Pointer to the array of output signatures. |
pPrvKeys[8] |
Pointer to the array of preliminary initialized IppsRSAPrivateKeyState contexts. |
pPubKeys[8] |
Pointer to the array of preliminary initialized IppsRSAPublicKeyState contexts. |
pMethod |
Pointer to the hash method. For details, see HashMethod functions. |
statuses[8] |
Pointer to the array of execution statuses for each performed operation. |
pBuffer |
Pointer to a temporary buffer. The size of the buffer must be not less than the value returned by the RSA_MB_GetBufferSizePrivateKey and RSA_MB_GetBufferSizePublicKey functions. |
Description¶
This function generates the message signature according to the RSASSA-PSS scheme defined in [ PKCS 1.2.1 ]. The function can perform up to 8 signature generation operations at once.
Specify parameters for each single signature generation operation under the corresponding index in an input array in accordance with the ippsRSASign_PSS_rmf function API requirements.
To perform less than 8 operations, set one or more pointers to a context in input context arrays to NULL. In this case, each single operation with the context set to NULL will not be performed, and the function will return ippStsMbWarning . Once the function execution is completed, the statuses array will contain return codes for each single signature generation operation according to the ippsRSASign_PSS_rmf return values.
Note
Important
Sizes of all moduli
nin all IppsRSAPublicKeyState contexts in the pPubKeys array must be equal.Sizes and values of all public exponents
ein all IppsRSAPublicKeyState contexts in the pPubKeys array must be equal.Types of RSA private keys must be equal.
Return Values¶
ippStsNoErr |
Indicates no error. All single operations executed without errors. Any other value indicates an error or warning. |
ippStsMbWarning |
One or more of performed operations executed with error. Check statuses array for details. |
ippStsNullPtrErr |
Any of the input parameters is a NULL pointer. |
ippStsSizeErr |
Indicates a mismatch between moduli |
ippStsBadArgErr |
Indicates a mismatch between types of private keys or exponents |
ippStsContextMatchErr |
No valid keys were found. |
Related Information