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 //        ippsGFpExp()
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: ippsGFpExp
59 //
60 // Purpose: Raise GF element to the specified power
61 //
62 // Returns:                   Reason:
63 //    ippStsNullPtrErr              NULL == pGFp
64 //                                  NULL == pA
65 //                                  NULL == pR
66 //                                  NULL == pE
67 //
68 //    ippStsContextMatchErr         invalid pGFp->idCtx
69 //                                  invalid pA->idCtx
70 //                                  invalid pR->idCtx
71 //                                  invalid pE->idCtx
72 //
73 //    ippStsOutOfRangeErr           GFPE_ROOM() != GFP_FELEN()
74 //
75 //    ippStsNoErr                   no error
76 //
77 // Parameters:
78 //    pA              Pointer to the context of the first finite field element.
79 //    pE              Pointer to the Big Number context storing the exponent
80 //    pR              Pointer to the context of the result finite field element.
81 //    pGFp            Pointer to the context of the finite field.
82 //    pScratchBuffer  Pointer to the scratch buffer.
83 //
84 *F*/
85 
86 IPPFUN(IppStatus, ippsGFpExp,(const IppsGFpElement* pA, const IppsBigNumState* pE,
87                                     IppsGFpElement* pR, IppsGFpState* pGFp,
88                                     Ipp8u* pScratchBuffer))
89 {
90    IPP_BAD_PTR4_RET(pA, pE, pR, pGFp);
91    pGFp = (IppsGFpState*)( IPP_ALIGNED_PTR(pGFp, GFP_ALIGNMENT) );
92    IPP_BADARG_RET( !GFP_TEST_ID(pGFp), ippStsContextMatchErr );
93    IPP_BADARG_RET( !GFPE_TEST_ID(pA), ippStsContextMatchErr );
94    IPP_BADARG_RET( !GFPE_TEST_ID(pR), ippStsContextMatchErr );
95 
96    pE = (IppsBigNumState*)( IPP_ALIGNED_PTR(pE, BN_ALIGNMENT) );
97    IPP_BADARG_RET( !BN_VALID_ID(pE), ippStsContextMatchErr );
98    {
99       gsModEngine* pGFE = GFP_PMA(pGFp);
100       IPP_BADARG_RET( (GFPE_ROOM(pA)!=GFP_FELEN(pGFE)) || (GFPE_ROOM(pR)!=GFP_FELEN(pGFE)), ippStsOutOfRangeErr);
101 
102       cpGFpxExp(GFPE_DATA(pR), GFPE_DATA(pA), BN_NUMBER(pE), BN_SIZE(pE), pGFE, pScratchBuffer);
103       return ippStsNoErr;
104    }
105 }