Developer Reference

Contents

GFpxInitBinomial

Initializes the context of a GF(p
d
) field.

Syntax

IppStatus ippsGFpxInitBinomial(const IppsGFpState*
pParentGF
, int
extDeg
, const IppsGFpElement* const
pGroundElm
, const IppsGFpMethod*
method
, IppsGFpState*
pGFpx
);
Include Files
ippcp.h
Parameters
pParentGF
Pointer to the context of the finite field GF(
p
) being extended.
extDeg
Degree of the extension.
pGroundElm
Pointer to the
IppsGFpElement
context containing the trailing coefficient of the field binomial.
method
Pointer to the implementation of a basic arithmetic (methods) over GF(
p
d
).
pGFpx
Pointer to the context of the GF(
p
d
) field being initialized.
Description
This function initializes the memory buffer
pGFpx
associated with the
IppsGFpState
context and sets up the specific irreducible binomial. The initialized context is used in the functions that create contexts of elements of the GF(
p
d
) field and perform operations with field elements.
The function does not check the binomial's irreducibility.
When calling the functions over the GF(
p
d
) field, a properly initialized
pParentGF
context of the finite field GF(
p
) is required.
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 context parameters
pParentGF
and
pGroundElm
does not match the operation.
ippStsBadArgErr
Indicates an error condition in the following cases:
  • extDeg
    > 8 or
    extDeg
    < 2.
  • method
    is not in agreement with other parameters.
ippStsOutOfRangeErr
Indicates an error condition if the length of the value defined in
pGroundElm
is not equal to that of an element of
pParentGF
.

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