Developer Reference

Contents

GFpSqrt

Computes the square root of an element of the finite field.

Syntax

IppStatus ippsGFpSqrt(const IppsGFpElement*
pA
, IppsGFpElement*
pR
, IppsGFpState*
pGFp
);
Include Files
ippcp.h
Parameters
pA
Pointer to the context of the finite field element.
pR
Pointer to the context of the resulting element of the finite field.
pGFp
Pointer to the context of the finite field.
Description
This function computes the square root of a given element of the GF(
p
) field. The following pseudocode represents this operation:
R ⋅ R = A
. The finite field is specified by the
pGFp
context.
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
IppsGFpState
and
IppsGFpElement
context parameters does not match the operation.
ippStsOutOfRangeErr
Indicates an error condition if
pA
does not belong to the finite field specified by the context
pGFp
.
ippStsBadArgErr
Indicates an error condition the finite field specified by the context
pGFp
is not prime.
ippStsQuadraticNonResidueErr
Indicates an error condition if
pA
is a square non-residue element.

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