Visible to Intel only — GUID: GUID-2FAA6EB5-A161-4DAF-BE3C-89506FC0EBF4
Visible to Intel only — GUID: GUID-2FAA6EB5-A161-4DAF-BE3C-89506FC0EBF4
RSA_MB_Sign_PSS_rmf
Performs RSA multi-buffer signature generation using RSASSA-PSS scheme.
Syntax
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.
Important
- Sizes of all moduli n in all IppsRSAPublicKeyState contexts in the pPubKeys array must be equal.
Sizes and values of all public exponents e in 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 n sizes in the input contexts. |
ippStsBadArgErr |
Indicates a mismatch between types of private keys or exponents e in public keys. |
ippStsContextMatchErr |
No valid keys were found. |
Related Information