Developer Reference

Contents

GFpECSetPointOctString

Sets the coordinates of a point on an elliptic curve defined over GF(p).

Syntax

IppStatus ippsGFpECSetPointOctString(const Ipp8u*
pStr
, int
strLen
, IppsGFpECPoint*
pPoint
, IppsGFpECState*
pEC
);
Include Files
ippcp.h
Parameters
pStr
Pointer octet string containing
X
and
Y
coordinates of the point on the elliptic curve.
strLen
Length of the input
pStr
string, in bytes.
pPoint
Pointer to the context of the elliptic curve point.
pEC
Pointer to the context of the elliptic cryptosystem.
Description
This function sets the coordinates of a point on the elliptic curve defined over a prime finite field GF(
p
). The input data is the octet string containing the pair (
X
,
Y
) of coordinates. The left half of the
pStr
string represents an
X
-coordinate and the right half represents a
Y
-coordinate. The left byte in
X
and
Y
representations corresponds to the most significant byte of coordinates. Length of each part is equal to the length of the GF(
p
) field element in bytes. Before using this function, you need to:
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error when any of the specified pointers is
NULL
.
ippStsContextMatchErr
Indicates an error when one of the contexts pointed by
pPoint
or
pEC
is not valid or not a defined subgroup.
ippStsNotSupportedModeErr
Indicates an error when the finite field over which the elliptic curve is initialized is not prime.

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