Cryptography for Intel(R) Integrated Performance Primitives Developer Reference

ID 768738
Date 12/16/2022
Document Table of Contents


Initializes the context of a GF(pd) field.


IppStatus ippsGFpxInit(const IppsGFpState* pParentGF, int extDeg, const IppsGfpElement* const ppGroundElm[], int polyTerms, const IppsGFpMethod* method, IppsGFpState* pGFpx);

Include Files




Pointer to the context of the finite field GF(p) being extended.


Degree of the extension.


Double pointer to the array of IppsGFpElement contexts representing coefficients of the field polynomial.


Number of the field polynomial coefficients.


Pointer to the implementation of a basic arithmetic (methods) over the extended GF(p) finite field.


Pointer to the context of the GF(pd) field being initialized.

The function initializes the memory buffer pGFpx associated with the IppsGFpState context and sets up the specific irreducible polynomial. The initialized context is used in the functions that create contexts of elements of the GF(pd) field and perform operations with the field elements. The function assumes the use of a general field polynomial g(x) = xd + xd - 1ad - 1 + xd - 2ad - 2 + ⋯ + x1a1 + a0 over GF(p).

  • The function does not check the polynomial's irreducibility.

  • In general, the GF(pd) extension requires a field polynomial g(x) of degree d. However, because g(x) is considered a monic polynomial (the coefficient of xd is always assumed equal to 1), the leading coefficient is not required: polyTerms <= (extDeg - 1).
  • When calling the functions over the GF(pd) field, a properly initialized pParentGF context of the finite field GF(p) is required.

  • Do not release the pParentGF context of the parent field as long as application deals with either the parent or the extended finite field pointed to by pGFpx.

Return Values


Indicates no error. Any other value indicates an error or warning.


Indicates an error condition if any of the specified pointers is NULL.


Indicates an error condition if any of the context parameters referenced by elements of ppGroundElm[] or pParentGF does not match the operation.


Indicates an error condition in the following cases:
  • extDeg > 8 or extDeg < 2.
  • polyTerms > (extDeg - 1) or polyTerms < 1.
  • method is not an output of a GFpxMethod function.
  • method is not compatible with the value of extDeg.


Indicates an error condition if the length of any of the values defined by ppGroundElm[] is not equal to the length of an element of the parent finite field pParentGF.

Did you find the information on this page useful?

Characters remaining:

Feedback Message