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