text: /*******************************************************************************
  * Copyright 2019 Intel Corporation
  * All Rights Reserved.
  *
  * If this  software was obtained  under the  Intel Simplified  Software License,
  * the following terms apply:
  *
  * The source code,  information  and material  ("Material") contained  herein is
  * owned by Intel Corporation or its  suppliers or licensors,  and  title to such
  * Material remains with Intel  Corporation or its  suppliers or  licensors.  The
  * Material  contains  proprietary  information  of  Intel or  its suppliers  and
  * licensors.  The Material is protected by  worldwide copyright  laws and treaty
  * provisions.  No part  of  the  Material   may  be  used,  copied,  reproduced,
  * modified, published,  uploaded, posted, transmitted,  distributed or disclosed
  * in any way without Intel's prior express written permission.  No license under
  * any patent,  copyright or other  intellectual property rights  in the Material
  * is granted to  or  conferred  upon  you,  either   expressly,  by implication,
  * inducement,  estoppel  or  otherwise.  Any  license   under such  intellectual
  * property rights must be express and approved by Intel in writing.
  *
  * Unless otherwise agreed by Intel in writing,  you may not remove or alter this
  * notice or  any  other  notice   embedded  in  Materials  by  Intel  or Intel's
  * suppliers or licensors in any way.
  *
  *
  * If this  software  was obtained  under the  Apache License,  Version  2.0 (the
  * "License"), the following terms apply:
  *
  * You may  not use this  file except  in compliance  with  the License.  You may
  * obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
  *
  *
  * Unless  required  by   applicable  law  or  agreed  to  in  writing,  software
  * distributed under the License  is distributed  on an  "AS IS"  BASIS,  WITHOUT
  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  *
  * See the   License  for the   specific  language   governing   permissions  and
  * limitations under the License.
  *******************************************************************************/
  
  /* 
  //     Intel(R) Integrated Performance Primitives. Cryptography Primitives.
  //     Operations over GF(p).
  // 
  //     Context:
  //        ippsGFpInitFixed()
  // 
  */
  #include "owndefs.h"
  #include "owncp.h"
  
  #include "pcpgfpstuff.h"
  #include "pcpgfpxstuff.h"
  #include "pcptool.h"
  
  
  /*F*
  // Name: ippsGFpInitFixed
  //
  // Purpose: initializes prime finite field GF(p)
  //
  // Returns:                   Reason:
  //    ippStsNullPtrErr           NULL == pGFpMethod
  //                               NULL == pGFp
  //
  //    ippStsBadArgErr            pGFpMethod != ippsGFpMethod_pXXX() any fixed prime method
  //                               primeBitSize != sizeof modulus defined by fixed method
  //
  //    ippStsNoErr                no error
  //
  // Parameters:
  //    primeBitSize   length of prime in bits
  //    pGFpMethod     pointer to the basic arithmetic metods
  //    pGFp           pointer to Finite Field context is being initialized
  *F*/
  IPPFUN(IppStatus, ippsGFpInitFixed,(int primeBitSize, const IppsGFpMethod* pGFpMethod, IppsGFpState* pGFp))
  {
     IPP_BAD_PTR2_RET(pGFpMethod, pGFp);
     pGFp = (IppsGFpState*)( IPP_ALIGNED_PTR(pGFp, GFP_ALIGNMENT) );
  
     /* test method is prime based */
     IPP_BADARG_RET(cpID_Prime!=(pGFpMethod->modulusID & cpID_Prime), ippStsBadArgErr);
     /* test if method is not prime based arbitrary */
     IPP_BADARG_RET(!pGFpMethod->modulus, ippStsBadArgErr);
     /* size of the underlying prime must be equal to primeBitSize parameter*/
     IPP_BADARG_RET(pGFpMethod->modulusBitDeg!=primeBitSize, ippStsBadArgErr);
  
     {
        /* init GF */
        IppStatus sts = cpGFpInitGFp(primeBitSize, pGFp);
  
        /* set up GF engine */
        if(ippStsNoErr==sts) {
           cpGFpSetGFp(pGFpMethod->modulus, primeBitSize, pGFpMethod, pGFp);
        }
  
        return sts;
     }
  }
  