Developer Reference for Intel® Integrated Performance Primitives Cryptography 2018
Computes a digital signature over a message digest.
IppStatus ippsGFpECSignDSA(const IppsBigNumState* pMsgDigest, const IppsBigNumState* pRegPrivate, const IppsBigNumState* pEphPrivate, IppsBigNumState* pSignR, IppsBigNumState* pSignS, IppsGFpECState* pEC, Ipp8u* pScratchBuffer);
ippcp.h
pMsgDigest |
Pointer to the message digest msg to be digitally signed, that is, to be ecrypted with a private key. |
pRegPrivate |
Pointer to the signer's regular private key. |
pEphPrivate |
Pointer to the signer's ephemeral private key. |
pSignR |
Pointer to the integer r of the digital signature. |
pSignS |
Pointer to the integer s of the digital signature. |
pEC |
Pointer to the context of the elliptic curve. |
pScratchBuffer |
Pointer to the scratch buffer. |
A message digest is a fixed size number derived from the original message with an applied hash function over the binary code of the message. The signer's private key and the message digest are used to create a signature.
A digital signature over a message consists of a pair of large numbers r and s which the given function computes.
The scheme used for computing a digital signature is the ECDSA scheme, an elliptic curve analogue of the DSA scheme.
The regular private key regPrivKey and the ephemeral private key ephPrivKey can be generated by the functions GFpECPrivateKey and GFpECPublicKey with only the requirement that the key regPrivKey be different from the key ephPrivKey.
The elliptic curve domain parameters must be hitherto defined by the functions: GFpECInitStd, GFpECInit, GFpECSet, or GFpECSetSubgroup.
For more information on digital signatures, please refer to the [ANSI] standard.
ippStsNoErr |
Indicates no error. Any other value indicates an error or warning. |
ippStsNullPtrErr |
Indicates an error condition if any of the specified pointers is NULL. |
ippStsContextMatchErr |
Indicates an error condition if any of the contexts pointed to by pMsgDigest, pRegPrivate, pEphPrivate, pSignR, pSignS, or pEC does not match the operation. |
ippStsMessageErr |
Indicates an error condition if the value of msg pointed to by pMsgDigest falls outside the range of [1, n-1] where n is the order of the elliptic curve base point G. |
ippStsRangeErr |
Indicates an error condition if any of the parameters pointed to by pSignR or pSignS has a memory size that is less than the order n of the elliptic curve base point G. |
ippStsIvalidPrivateKey |
Indicates an error condition if any of the parameters pointed to by pRegPrivate or pEphPrivate has a memory size that is less than the order n of the elliptic curve base point G. |
ippStsNotSupportedModeErr |
Indicates an error condition if the finite field GFp under the elliptic curve is not prime. |