Cryptography for Intel® Integrated Performance Primitives Developer Reference

Developer Reference

Contents

GFpECPVerifyDSA
,
GFpECPVerifyNR
,
GFpECPVerifySM2

Verifies authenticity of the digital signature over a message digest (ECDSA).

Syntax

IppStatus ippsGFpECVerifyDSA(const IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
IppStatus ippsGFpECVerifyNR(onst IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
IppStatus ippsGFpECVerifySM2(const IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
Include Files
ippcp.h
Parameters
pMsgDigest
Pointer to the message digest
msg
.
pRegPublic
Pointer to the signer's regular public key.
pSignR
Pointer to the integer
r
 of the digital signature.
pSignS
Pointer to the integer
s
 of the digital signature.
pResult
Pointer to the digital signature verification result.
pEC
Pointer to the context of the elliptic curve.
pScratchBuffer
Pointer to the scratch buffer.
Description
These functions verify authenticity of the digital signature generated by the
ippsGFpECPSignDSA
 ,
ippsGFpECPSignNR
, and
ippsGFpECPSignSM2
 functions, respectively. The signature consists of two large integers:
r
 and
s
.
Return Values
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
,
pRegPublic
,
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
 is negative.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.