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 // ippsGFpInv() 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: ippsGFpInv 59 // 60 // Purpose: Multiplicative inverse GF element 61 // 62 // Returns: Reason: 63 // ippStsNullPtrErr NULL == pGFp 64 // NULL == pA 65 // NULL == pR 66 // 67 // ippStsContextMatchErr invalid pGFp->idCtx 68 // invalid pA->idCtx 69 // invalid pR->idCtx 70 // 71 // ippStsOutOfRangeErr GFPE_ROOM() != GFP_FELEN() 72 // 73 // ippStsDivByZeroErr pA is zero 74 // 75 // ippStsBadArgErr computational error 76 // 77 // ippStsNoErr no error 78 // 79 // Parameters: 80 // pA Pointer to the context of the source finite field element. 81 // pR Pointer to the context of the result finite field element. 82 // pGFp Pointer to the context of the finite field. 83 // 84 *F*/ 85 86 IPPFUN(IppStatus, ippsGFpInv,(const IppsGFpElement* pA, 87 IppsGFpElement* pR, IppsGFpState* pGFp)) 88 { 89 IPP_BAD_PTR3_RET(pA, pR, pGFp); 90 pGFp = (IppsGFpState*)( IPP_ALIGNED_PTR(pGFp, GFP_ALIGNMENT) ); 91 IPP_BADARG_RET( !GFP_TEST_ID(pGFp), ippStsContextMatchErr ); 92 IPP_BADARG_RET( !GFPE_TEST_ID(pA), ippStsContextMatchErr ); 93 IPP_BADARG_RET( !GFPE_TEST_ID(pR), ippStsContextMatchErr ); 94 { 95 gsModEngine* pGFE = GFP_PMA(pGFp); 96 IPP_BADARG_RET( (GFPE_ROOM(pA)!=GFP_FELEN(pGFE)) || (GFPE_ROOM(pR)!=GFP_FELEN(pGFE)), ippStsOutOfRangeErr); 97 IPP_BADARG_RET( GFP_IS_ZERO(GFPE_DATA(pA),GFP_FELEN(pGFE)), ippStsDivByZeroErr ); 98 99 return NULL != cpGFpxInv(GFPE_DATA(pR), GFPE_DATA(pA), pGFE)? ippStsNoErr : ippStsBadArgErr; 100 } 101 } 102