Home | History | Annotate | Download | only in ippcp
      1 /*******************************************************************************
      2 * Copyright 2002-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
     43 //                   Cryptographic Primitives (ippcp)
     44 //
     45 //  Contents:
     46 //        ippsMontMul()
     47 //
     48 */
     49 
     50 #include "owndefs.h"
     51 #include "owncp.h"
     52 #include "pcpbn.h"
     53 #include "pcpmontgomery.h"
     54 #include "pcptool.h"
     55 
     56 /*F*
     57 // Name: ippsMontMul
     58 //
     59 // Purpose: Computes Montgomery modular multiplication for positive big
     60 //      number integers of Montgomery form. The following pseudocode
     61 //      represents this function:
     62 //      r <- ( a * b * R^(-1) ) mod m
     63 //
     64 // Returns:                Reason:
     65 //      ippStsNoErr         Returns no error.
     66 //      ippStsNullPtrErr    Returns an error when pointers are null.
     67 //      ippStsBadArgErr     Returns an error when a or b is a negative integer.
     68 //      ippStsScaleRangeErr Returns an error when a or b is more than m.
     69 //      ippStsOutOfRangeErr Returns an error when IppsBigNumState *r is larger than
     70 //                          IppsMontState *m.
     71 //      ippStsContextMatchErr Returns an error when the context parameter does
     72 //                          not match the operation.
     73 //
     74 // Parameters:
     75 //      pA   Multiplicand within the range [0, m - 1].
     76 //      pB   Multiplier within the range [0, m - 1].
     77 //      pCtx Modulus.
     78 //      pR   Montgomery multiplication result.
     79 //
     80 // Notes: The size of IppsBigNumState *r should not be less than the data
     81 //      length of the modulus m.
     82 *F*/
     83 IPPFUN(IppStatus, ippsMontMul, (const IppsBigNumState* pA, const IppsBigNumState* pB, IppsMontState* pCtx, IppsBigNumState* pR))
     84 {
     85    IPP_BAD_PTR4_RET(pA, pB, pCtx, pR);
     86 
     87    pCtx = (IppsMontState*)(IPP_ALIGNED_PTR((pCtx), MONT_ALIGNMENT));
     88    pA = (IppsBigNumState*)( IPP_ALIGNED_PTR(pA, BN_ALIGNMENT) );
     89    pB = (IppsBigNumState*)( IPP_ALIGNED_PTR(pB, BN_ALIGNMENT) );
     90    pR = (IppsBigNumState*)( IPP_ALIGNED_PTR(pR, BN_ALIGNMENT) );
     91 
     92    IPP_BADARG_RET(!MNT_VALID_ID(pCtx), ippStsContextMatchErr);
     93    IPP_BADARG_RET(!BN_VALID_ID(pA), ippStsContextMatchErr);
     94    IPP_BADARG_RET(!BN_VALID_ID(pB), ippStsContextMatchErr);
     95    IPP_BADARG_RET(!BN_VALID_ID(pR), ippStsContextMatchErr);
     96 
     97    IPP_BADARG_RET(BN_NEGATIVE(pA) || BN_NEGATIVE(pB), ippStsBadArgErr);
     98    IPP_BADARG_RET(cpCmp_BNU(BN_NUMBER(pA), BN_SIZE(pA), MOD_MODULUS( MNT_ENGINE(pCtx) ), MOD_LEN( MNT_ENGINE(pCtx) )) >= 0, ippStsScaleRangeErr);
     99    IPP_BADARG_RET(cpCmp_BNU(BN_NUMBER(pB), BN_SIZE(pB), MOD_MODULUS( MNT_ENGINE(pCtx) ), MOD_LEN( MNT_ENGINE(pCtx) )) >= 0, ippStsScaleRangeErr);
    100    IPP_BADARG_RET(BN_ROOM(pR) < MOD_LEN( MNT_ENGINE(pCtx) ), ippStsOutOfRangeErr);
    101 
    102    {
    103       const int usedPoolLen = 2;
    104       cpSize nsM = MOD_LEN( MNT_ENGINE(pCtx) );
    105       BNU_CHUNK_T* pDataR  = BN_NUMBER(pR);
    106       BNU_CHUNK_T* pDataA  = gsModPoolAlloc(MNT_ENGINE(pCtx), usedPoolLen);
    107       BNU_CHUNK_T* pDataB  = pDataA + nsM;
    108       //tbcd: temporary excluded: assert(NULL!=pDataA);
    109 
    110       ZEXPAND_COPY_BNU(pDataA, nsM, BN_NUMBER(pA), BN_SIZE(pA));
    111       ZEXPAND_COPY_BNU(pDataB, nsM, BN_NUMBER(pB), BN_SIZE(pB));
    112 
    113       MOD_METHOD( MNT_ENGINE(pCtx) )->mul(pDataR, pDataA, pDataB, MNT_ENGINE(pCtx));
    114 
    115       gsModPoolFree(MNT_ENGINE(pCtx), usedPoolLen);
    116 
    117       FIX_BNU(pDataR, nsM);
    118       BN_SIZE(pR) = nsM;
    119       BN_SIGN(pR) = ippBigNumPOS;
    120 
    121       return ippStsNoErr;
    122    }
    123 }
    124