ECCPSetStd
ECCPSetStd
Sets up a recommended set of domain parameters for an elliptic curve over GF(
p
).Syntax
IppStatus ippsECCPSetStd128r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd128r2(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd192r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd224r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd256r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd384r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd521r1(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStdSM2(
IppsECCPState*
pECC
);
IppStatus ippsECCPSetStd(IppECCType
flag
, IppsECCPState*
pECC
);
Include Files
ippcp.h
Parameters
- flag
- Set specifier.
- pECC
- Pointer to the cryptosystem context.
Description
Each of the
ECCPSetStd
functions sets a recommended set of domain parameters for an elliptic curve over a prime finite field GF(p
). Functions with One Parameter
All the functions but the last one set domain parameters for standard elliptic curves, listed in table Standard Elliptic Curves. Before a call to each of these functions, create the cryptosystem context by calling the appropriate ECCPGetSizeStd and ECCPInitStd functions.
Function with Two Parameters
For the last function, the value of the parameter
flag
defines the set of domain parameters. Possible values of flag
are as follows:- IppECCPStd112r1
- For the cryptosystem context wherefeBitSize==112
- IppECCPStd112r2
- For the cryptosystem context wherefeBitSize==112
- IppECCPStd128r1
- For the cryptosystem context wherefeBitSize==128
- IppECCPStd128r2
- For the cryptosystem context wherefeBitSize==128
- IppECCPStd160r1
- For the cryptosystem context wherefeBitSize==160
- IppECCPStd160r2
- For the cryptosystem context wherefeBitSize==160
- IppECCPStd192r1
- For the cryptosystem context wherefeBitSize==192
- IppECCPStd224r1
- For the cryptosystem context wherefeBitSize==224
- IppECCPStd256r1
- For the cryptosystem context wherefeBitSize==256
- IppECCPStd384r1
- For the cryptosystem context wherefeBitSize==384
- IppECCPStd521r1
- For the cryptosystem context wherefeBitSize==521.
For more information on parameter values for the recommended elliptic curves, see [SEC2].
Before a call to this function, create the cryptosystem context by calling the
ECCPGetSize
and ECCPInit
functions. The value of feBitSize
is applied when these functions are called and predetermines the choice of the flag
value. 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 isNULL.
- ippStsContextMatchErr
- Indicates an error condition if the cryptosystem context is not valid.
- ippStsECCInvalidFlagErr
- Indicates an error condition if the value of the parameterflagis not valid.