Developer Reference

Contents

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 where
feBitSize
==112
IppECCPStd112r2
For the cryptosystem context where
feBitSize
==112
IppECCPStd128r1
For the cryptosystem context where
feBitSize
==128
IppECCPStd128r2
For the cryptosystem context where
feBitSize
==128
IppECCPStd160r1
For the cryptosystem context where
feBitSize
==160
IppECCPStd160r2
For the cryptosystem context where
feBitSize
==160
IppECCPStd192r1
For the cryptosystem context where
feBitSize
==192
IppECCPStd224r1
For the cryptosystem context where
feBitSize
==224
IppECCPStd256r1
For the cryptosystem context where
feBitSize
==256
IppECCPStd384r1
For the cryptosystem context where
feBitSize
==384
IppECCPStd521r1
For the cryptosystem context where
feBitSize
==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 is
NULL
.
ippStsContextMatchErr
Indicates an error condition if the cryptosystem context is not valid.
ippStsECCInvalidFlagErr
Indicates an error condition if the value of the parameter
flag
is not valid.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804