Home | History | Annotate | Download | only in ippcp
      1 /*******************************************************************************
      2 * Copyright 2017-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 #if !defined(_GS_MOD_STUFF_H)
     42 #define _GS_MOD_STUFF_H
     43 
     44 //#define MONTMUL_ONESTAGE
     45 
     46 #include "owncp.h"
     47 
     48 #include "pcpbnuimpl.h"
     49 #include "gsmodmethod.h"
     50 
     51 #define MOD_ENGINE_MIN_POOL_SIZE 1
     52 
     53 typedef struct _gsModEngine gsModEngine_T;
     54 
     55 typedef struct _gsModEngine
     56 {
     57    gsModEngine_T*       pParentME;     /* pointer to parent stuff          */
     58    int                  extdegree;     /* parent modulus extension (deg)   */
     59    int                  modBitLen;     /* length of modulus in bits        */
     60    int                  modLen;        /* length of modulus  (BNU_CHUNK_T) */
     61    int                  modLen32;      /* length of modulus  (Ipp32u)      */
     62    int                  peLen;         /* length of pool element (BNU_CHUNK_T) */
     63    const gsModMethod*   method;        /* modular arithmetic methods       */
     64    BNU_CHUNK_T*         pModulus;      /* modulus                          */
     65    BNU_CHUNK_T          k0;            /* low word of (1/modulus) mod R    */
     66    BNU_CHUNK_T*         pMontR;        /* mont_enc(1)                      */
     67    BNU_CHUNK_T*         pMontR2;       /* mont_enc(1)^2                    */
     68    BNU_CHUNK_T*         pHalfModulus;  /* modulus/2                        */
     69    BNU_CHUNK_T*         pQnr;          /* quadratic non-residue            */
     70    int                  poolLenUsed;   /* number of reserved temporary BNU */
     71    int                  poolLen;       /* max number of temporary BNU      */
     72    BNU_CHUNK_T*         pBuffer;       /* buffer of modLen*nBuffers length */
     73 } gsModEngine;
     74 
     75 /* accessory macros */
     76 #define MOD_PARENT(eng)      ((eng)->pParentME)
     77 #define MOD_EXTDEG(eng)      ((eng)->extdegree)
     78 #define MOD_BITSIZE(eng)     ((eng)->modBitLen)
     79 #define MOD_LEN(eng)         ((eng)->modLen)
     80 #define MOD_LEN32(eng)       ((eng)->modLen32)
     81 #define MOD_PELEN(eng)       ((eng)->peLen)
     82 #define MOD_METHOD(eng)      ((eng)->method)
     83 #define MOD_MODULUS(eng)     ((eng)->pModulus)
     84 #define MOD_MNT_FACTOR(eng)  ((eng)->k0)
     85 #define MOD_MNT_R(eng)       ((eng)->pMontR)
     86 #define MOD_MNT_R2(eng)      ((eng)->pMontR2)
     87 #define MOD_HMODULUS(eng)    ((eng)->pHalfModulus)
     88 #define MOD_QNR(eng)         ((eng)->pQnr)
     89 #define MOD_POOL_BUF(eng)    ((eng)->pBuffer)
     90 #define MOD_MAXPOOL(eng)     ((eng)->poolLen)
     91 #define MOD_USEDPOOL(eng)    ((eng)->poolLenUsed)
     92 
     93 #define MOD_BUFFER(eng,n)    ((eng)->pBuffer+(MOD_PELEN(eng))*(n))
     94 
     95 #define MOD_ENGINE_ALIGNMENT ((int)sizeof(void*))
     96 
     97 /*
     98 // size of context and it initialization
     99 */
    100 #define   gsModEngineGetSize OWNAPI(gsModEngineGetSize)
    101 IppStatus gsModEngineGetSize(int modulusBitSIze, int numpe, int* pSize);
    102 
    103 #define   gsModEngineInit OWNAPI(gsModEngineInit)
    104 IppStatus gsModEngineInit(gsModEngine* pME, const Ipp32u* pModulus, int modulusBitSize, int numpe, const gsModMethod* method);
    105 
    106 #define     gsMontFactor OWNAPI(gsMontFactor)
    107 BNU_CHUNK_T gsMontFactor(BNU_CHUNK_T m0);
    108 
    109 
    110 /*
    111 // pool management methods
    112 */
    113 
    114 /*F*
    115 // Name: gsModPoolAlloc
    116 //
    117 // Purpose: Allocation pool.
    118 //
    119 // Returns:                        Reason:
    120 //       pointer to allocate Pool       enough of pool
    121 //       NULL                           required pool more than pME have
    122 //
    123 // Parameters:
    124 //    pME       ModEngine
    125 //    poolReq   Required pool
    126 *F*/
    127 
    128 __INLINE BNU_CHUNK_T* gsModPoolAlloc(gsModEngine* pME, int poolReq)
    129 {
    130    BNU_CHUNK_T* pPool = MOD_BUFFER(pME, pME->poolLenUsed);
    131 
    132    if(pME->poolLenUsed + poolReq > pME->poolLen)
    133       pPool = NULL;
    134    else
    135       pME->poolLenUsed += poolReq;
    136 
    137    return pPool;
    138 }
    139 
    140 /*F*
    141 // Name: gsModPoolFree
    142 //
    143 // Purpose: Delete pool.
    144 //
    145 // Returns:
    146 //    nothing
    147 //
    148 // Parameters:
    149 //    pME       ModEngine
    150 //    poolReq   Required pool
    151 *F*/
    152 
    153 __INLINE void gsModPoolFree(gsModEngine* pME, int poolReq)
    154 {
    155    if(pME->poolLenUsed < poolReq)
    156       poolReq = pME->poolLenUsed;
    157    pME->poolLenUsed -= poolReq;
    158 }
    159 
    160 /* return pointer to the top pool buffer */
    161 #define      gsModGetPool OWNAPI(gsModGetPool)
    162 BNU_CHUNK_T* gsModGetPool(gsModEngine* pME);
    163 
    164 /*
    165 // advanced operations
    166 */
    167 typedef int (*alm_inv)(BNU_CHUNK_T* pr, const BNU_CHUNK_T* pa, gsModEngine* pMA);
    168 
    169 #define alm_mont_inv OWNAPI(alm_mont_inv)
    170 int     alm_mont_inv(BNU_CHUNK_T* pr, const BNU_CHUNK_T* pa, gsModEngine* pMA);
    171 
    172 #define alm_mont_inv_ct OWNAPI(alm_mont_inv_ct)
    173 int     alm_mont_inv_ct(BNU_CHUNK_T* pr, const BNU_CHUNK_T* pa, gsModEngine* pMA);
    174 
    175 #define      gs_mont_inv OWNAPI(gs_mont_inv)
    176 BNU_CHUNK_T* gs_mont_inv(BNU_CHUNK_T* pr, const BNU_CHUNK_T* pa, gsModEngine* pMA, alm_inv invf);
    177 
    178 #define      gs_inv OWNAPI(gs_inv)
    179 BNU_CHUNK_T* gs_inv(BNU_CHUNK_T* pr, const BNU_CHUNK_T* pa, gsModEngine* pMA, alm_inv invf);
    180 
    181 /*
    182 // Pack/Unpack methods
    183 */
    184 #define gsPackModEngineCtx OWNAPI(gsPackModEngineCtx)
    185 void    gsPackModEngineCtx(const gsModEngine* pCtx, Ipp8u* pBuffer);
    186 
    187 #define gsUnpackModEngineCtx OWNAPI(gsUnpackModEngineCtx)
    188 void    gsUnpackModEngineCtx(const Ipp8u* pBuffer, gsModEngine* pCtx);
    189 
    190 #endif /* _GS_MOD_STUFF_H */
    191