Home | History | Annotate | Download | only in ippcp
      1 /*******************************************************************************
      2 * Copyright 2018 Intel Corporation
      3 * All Rights Reserved.
      4 *
      5 * If this  software was obtained  under the  Intel Simplified  Software License,
      6 * the following terms apply:
      7 *
      8 * The source code,  information  and material  ("Material") contained  herein is
      9 * owned by Intel Corporation or its  suppliers or licensors,  and  title to such
     10 * Material remains with Intel  Corporation or its  suppliers or  licensors.  The
     11 * Material  contains  proprietary  information  of  Intel or  its suppliers  and
     12 * licensors.  The Material is protected by  worldwide copyright  laws and treaty
     13 * provisions.  No part  of  the  Material   may  be  used,  copied,  reproduced,
     14 * modified, published,  uploaded, posted, transmitted,  distributed or disclosed
     15 * in any way without Intel's prior express written permission.  No license under
     16 * any patent,  copyright or other  intellectual property rights  in the Material
     17 * is granted to  or  conferred  upon  you,  either   expressly,  by implication,
     18 * inducement,  estoppel  or  otherwise.  Any  license   under such  intellectual
     19 * property rights must be express and approved by Intel in writing.
     20 *
     21 * Unless otherwise agreed by Intel in writing,  you may not remove or alter this
     22 * notice or  any  other  notice   embedded  in  Materials  by  Intel  or Intel's
     23 * suppliers or licensors in any way.
     24 *
     25 *
     26 * If this  software  was obtained  under the  Apache License,  Version  2.0 (the
     27 * "License"), the following terms apply:
     28 *
     29 * You may  not use this  file except  in compliance  with  the License.  You may
     30 * obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
     31 *
     32 *
     33 * Unless  required  by   applicable  law  or  agreed  to  in  writing,  software
     34 * distributed under the License  is distributed  on an  "AS IS"  BASIS,  WITHOUT
     35 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     36 *
     37 * See the   License  for the   specific  language   governing   permissions  and
     38 * limitations under the License.
     39 *******************************************************************************/
     40 
     41 /*
     42 //     Intel(R) Integrated Performance Primitives. Cryptography Primitives.
     43 //     Operations over GF(p).
     44 //
     45 //     Context:
     46 //        ippsGFpInitArbitrary()
     47 //
     48 */
     49 #include "owndefs.h"
     50 #include "owncp.h"
     51 
     52 #include "pcpgfpstuff.h"
     53 #include "pcpgfpxstuff.h"
     54 #include "pcptool.h"
     55 
     56 
     57 /*F*
     58 // Name: ippsGFpInitArbitrary
     59 //
     60 // Purpose: initializes prime finite field GF(p)
     61 //
     62 // Returns:                   Reason:
     63 //    ippStsNullPtrErr           NULL == pPrime
     64 //                               NULL == pGFp
     65 //
     66 //    ippStsSizeErr              !(IPP_MIN_GF_BITSIZE <= primeBitSize <=IPP_MAX_GF_BITSIZE)
     67 //
     68 //    ippStsContextMatchErr      incorrect pPrime context ID
     69 //
     70 //    ippStsBadArgErr            prime <0
     71 //                               bitsize(prime) != primeBitSize
     72 //                               prime <IPP_MIN_GF_CHAR
     73 //                               prime is even
     74 //
     75 //    ippStsNoErr                no error
     76 //
     77 // Parameters:
     78 //    pPrime         pointer to the prime context
     79 //    primeBitSize   length of prime in bits
     80 //    pGFp           pointer to Finite Field context is being initialized
     81 *F*/
     82 IPPFUN(IppStatus, ippsGFpInitArbitrary,(const IppsBigNumState* pPrime, int primeBitSize, IppsGFpState* pGFp))
     83 {
     84    IPP_BAD_PTR1_RET(pGFp);
     85    pGFp = (IppsGFpState*)( IPP_ALIGNED_PTR(pGFp, GFP_ALIGNMENT) );
     86 
     87    IPP_BADARG_RET((primeBitSize< IPP_MIN_GF_BITSIZE) || (primeBitSize> IPP_MAX_GF_BITSIZE), ippStsSizeErr);
     88 
     89    IPP_BAD_PTR1_RET(pPrime);
     90    pPrime = (IppsBigNumState*)( IPP_ALIGNED_PTR(pPrime, BN_ALIGNMENT) );
     91    IPP_BADARG_RET(!BN_VALID_ID(pPrime), ippStsContextMatchErr);
     92    IPP_BADARG_RET(BN_SIGN(pPrime)!= IppsBigNumPOS, ippStsBadArgErr);                                   /* prime is negative */
     93    IPP_BADARG_RET(BITSIZE_BNU(BN_NUMBER(pPrime),BN_SIZE(pPrime)) != primeBitSize, ippStsBadArgErr);  /* primeBitSize == bitsize(prime) */
     94    IPP_BADARG_RET((BN_SIZE(pPrime)==1) && (BN_NUMBER(pPrime)[0]<IPP_MIN_GF_CHAR), ippStsBadArgErr);  /* prime < 3 */
     95    IPP_BADARG_RET(0==(BN_NUMBER(pPrime)[0] & 1), ippStsBadArgErr);                                     /* prime is even */
     96 
     97    {
     98       /* init GF */
     99       IppStatus sts = cpGFpInitGFp(primeBitSize, pGFp);
    100 
    101       /* set up GF engine */
    102       if(ippStsNoErr==sts) {
    103          cpGFpSetGFp(BN_NUMBER(pPrime), primeBitSize, ippsGFpMethod_pArb(), pGFp);
    104       }
    105 
    106       return sts;
    107    }
    108 }
    109