Cryptography for Intel® Integrated Performance Primitives Developer Reference

Developer Reference

Contents

GFpSetElementOctString

Assigns a value from the input octet string to an element of the finite field.

Syntax

IppStatus ippsGFpSetElementOctString(const Ipp8u*
pStr
, int
strSize
, IppsGFpElement*
pR
, IppsGFpState*
pGFp
);
Include Files
ippcp.h
Parameters
pStr
Pointer to the octet string.
strSize
Size of the octet string buffer in bytes.
pR
Pointer to the context of the finite field element.
pGFp
Pointer to the context of the finite field.
Description
This function assigns a value from the input octet string to an element of the finite field.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition in any of the following cases:
  • Either
    pR
     or
    pGFp
     is
    NULL
    .
  • The length of the string is greater than zero and the pointer
    pStr
     is
    NULL
    .
ippStsContextMatchErr
Indicates an error condition if any of the
pGFp
 and
pR
 context parameters does not match the operation.
ippStsSizeErr
Indicates an error condition in any of the following cases:
  • strSize
     exceeds the length of an element of the finite field.
  • strSize
     ≤ 0.
  • The maximum length of the element stored in the context
    pR
     exceeds the maximum length of an element of the finite field specified by the context
    pGFp
    .
ippStsOutOfRangeErr
Indicates an error condition in any of the following cases:
  • The length of the element stored in the context
    pR
     is not equal to the length of an element of the finite field specified by the context
    pGFp
    .
  • The value defined by
    pStr
     exceeds the modulus
    q
     of the basic prime finite field.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.