Visible to Intel only — GUID: GUID-D5328087-0866-4B41-90F1-1C54897799A4
Visible to Intel only — GUID: GUID-D5328087-0866-4B41-90F1-1C54897799A4
GFpInit
Initializes the context of a prime finite field GF(q).
Syntax
IppStatus ippsGFpInit(const IppsBigNumState* pPrime, int primeBitSize, const IppsGFpMethod* method, IppsGFpState* pGF);
Include Files
ippcp.h
Parameters
pPrime |
Pointer to the Big Number context storing the GF(q) modulus. |
primeBitSize |
Size, in bytes, of the odd prime number p (modulus of GF(q)). |
method |
Pointer to the implementation of a basic arithmetic (methods) over the prime finite field GF(q). |
pGF |
Pointer to the context of the GF(q) field being initialized. |
Description
The function initializes the pGF context parameter with the values of the input parameterspPrime, primeBitSize, and method. The three parameters have to be compatible with each other.
The method parameter must be an output from one of the GFpMethod functions with predefined modulus q, and the parameters primeBitSize and method must be compatible with each other.
If pPrime is not NULL, and method is an output from one of the GFpMethod functions with predefined modulus q, then the pair pPrime and primeBitSize should define the same prime q as defined in method.
If both pPrime and method are not NULL, then ippsGFpInit() provides the required initialization if the parameters are compatible with each other.
The initialized context is used in the functions that create contexts of elements of the GF(p) field, which, in turn, are used to perform operations with the field elements.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or warning. |
ippStsNullPtrErr |
Indicates an error condition in the following cases:
|
ippStsSizeErr |
Indicates an error condition if primeBitSize is less than 2 or greater than 1024. |
ippStsContextMatchErr |
Indicates an error condition if the pPrime context parameter is not NULL and does not match the operation. |
ippStsBadArgErr |
Indicates an error condition in the following cases:
|