Home | History | Annotate | Download | only in ippcp
      1 /*******************************************************************************
      2 * Copyright 2010-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 //
     43 //  Purpose:
     44 //     Intel(R) Integrated Performance Primitives. Cryptography Primitives.
     45 //     EC over GF(p) Operations
     46 //
     47 //     Context:
     48 //        ippsGFpECMulPoint()
     49 //
     50 */
     51 
     52 #include "owndefs.h"
     53 #include "owncp.h"
     54 #include "pcpgfpecstuff.h"
     55 
     56 /*F*
     57 // Name: ippsGFpECMulPoint
     58 //
     59 // Purpose: Multiplies a point on an elliptic curve by a scalar
     60 //
     61 // Returns:                   Reason:
     62 //    ippStsNullPtrErr               pP == NULL
     63 //                                   pQ == NULL
     64 //                                   pR == NULL
     65 //                                   pEC == NULL
     66 //
     67 //    ippStsContextMatchErr          invalid pEC->idCtx
     68 //                                   pEC->subgroup == NULL
     69 //                                   invalid pP->idCtx
     70 //                                   invalid pQ->idCtx
     71 //                                   invalid pR->idCtx
     72 //
     73 //    ippStsOutOfRangeErr            ECP_POINT_FELEN(pP)!=GFP_FELEN()
     74 //                                   ECP_POINT_FELEN(pR)!=GFP_FELEN()
     75 //
     76 //    ippStsBadArgErr                pN is negative
     77 //                                   pN > MOD_MODULUS(ECP_MONT_R(pEC))
     78 //
     79 //    ippStsNoErr                    no error
     80 //
     81 // Parameters:
     82 //    pP              Pointer to the context of the given point on the elliptic curve
     83 //    pN              Pointer to the Big Number context storing the scalar value
     84 //    pR              Pointer to the context of the resulting elliptic curve point
     85 //    pEC             Pointer to the context of the elliptic curve
     86 //    pScratchBuffer  Pointer to the scratch buffer
     87 //
     88 //  Note:
     89 //    computes [N]*P, 0 < N < order
     90 //
     91 *F*/
     92 
     93 IPPFUN(IppStatus, ippsGFpECMulPoint,(const IppsGFpECPoint* pP,
     94                                      const IppsBigNumState* pN,
     95                                      IppsGFpECPoint* pR,
     96                                      IppsGFpECState* pEC,
     97                                      Ipp8u* pScratchBuffer))
     98 {
     99    IPP_BAD_PTR4_RET(pP, pR, pEC, pScratchBuffer);
    100    pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) );
    101    IPP_BADARG_RET( !ECP_TEST_ID(pEC), ippStsContextMatchErr );
    102    IPP_BADARG_RET(!ECP_SUBGROUP(pEC), ippStsContextMatchErr);
    103 
    104    IPP_BADARG_RET( !ECP_POINT_TEST_ID(pP), ippStsContextMatchErr );
    105    IPP_BADARG_RET( !ECP_POINT_TEST_ID(pR), ippStsContextMatchErr );
    106 
    107    IPP_BADARG_RET( ECP_POINT_FELEN(pP)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr);
    108    IPP_BADARG_RET( ECP_POINT_FELEN(pR)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr);
    109 
    110    IPP_BAD_PTR1_RET(pN);
    111    pN = (IppsBigNumState*)( IPP_ALIGNED_PTR(pN, BN_ALIGNMENT) );
    112    IPP_BADARG_RET(!BN_VALID_ID(pN), ippStsContextMatchErr );
    113    IPP_BADARG_RET( BN_NEGATIVE(pN), ippStsBadArgErr );
    114 
    115    {
    116       BNU_CHUNK_T* pScalar = BN_NUMBER(pN);
    117       int scalarLen = BN_SIZE(pN);
    118       IPP_BADARG_RET(0<cpCmp_BNU(pScalar, scalarLen, MOD_MODULUS(ECP_MONT_R(pEC)), MOD_LEN(ECP_MONT_R(pEC))), ippStsBadArgErr);
    119 
    120       gfec_MulPoint(pR, pP, pScalar, scalarLen, pEC, pScratchBuffer);
    121       return ippStsNoErr;
    122    }
    123 }
    124