Cryptography for Intel® Integrated Performance Primitives Developer Reference

Developer Reference

Contents

ECCPGet

Retrieves elliptic curve domain parameters over GF(p).

Syntax

IppStatus ippsECCPGet(IppsBigNumState*
pPrime
, IppsBigNumState*
pA
, IppsBigNumState*
pB
, IppsBigNumState*
pGX
,IppsBigNumState*
pGY
, IppsBigNumState*
pOrder
, int*
cofactor
, IppsECCPState*
pECC
);
Include Files
ippcp.h
Parameters
pPrime
Pointer to the characteristic
p
 of the prime finite field GF(
p
).
pA
Pointer to the coefficient
A
 of the equation defining the elliptic curve.
pB
Pointer to the coefficient
B
 of the equation defining the elliptic curve.
pGX
Pointer to the
x
-coordinate of the elliptic curve base point.
pGY
Pointer to the
y
-coordinate of the elliptic curve base point.
pOrder
Pointer to the order
n
 of the elliptic curve base point.
cofactor
Pointer to the cofactor
h
.
pECC
Pointer to the context of the cryptosystem.
Description
The function retrieves elliptic curve domain parameters from the context of the elliptic cryptosystem over a finite field GF(
p
) and allocates them in accordance with the pointers
pPrime
,
pA
,
pB
,
pGX
,
pGY
,
pOrder
, and
cofactor
. The elliptic curve domain parameters must be hitherto defined by one of the functions:
ECCPSet
 or
ECCPSetStd
.
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 one of the contexts pointed by
pPrime
,
pA
,
pB
,
pGX
,
pGY
,
pOrder
, or
pECC
is not valid.
ippStsRangeErr
Indicates an error condition if the memory size of one of the parameters pointed by
pPrime
,
pA
,
pB
,
pGX
,
pGY
,
pOrder
, and
pECC
is less than the value of
feBitSize
 in the
ECCPInit
 function.

Product and Performance Information

1

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