1 /*******************************************************************************
2 * Copyright 2010-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 //     EC over GF(p^m) definitinons
44 //
45 //     Context:
46 //        ippsGFpECSet()
47 //
48 */
49 
50 #include "owndefs.h"
51 #include "owncp.h"
52 #include "pcpgfpecstuff.h"
53 #include "pcpeccp.h"
54 
55 /*F*
56 // Name: ippsGFpECSet
57 //
58 // Purpose: Sets up the parameters of an elliptic curve over a finite field
59 //
60 // Returns:                   Reason:
61 //    ippStsNullPtrErr              NULL == pEC
62 //                                  NULL == pA
63 //                                  NULL == pB
64 //
65 //    ippStsContextMatchErr         invalid pEC->idCtx
66 //                                  invalid pA->idCtx
67 //                                  invalid pB->idCtx
68 //
69 //    ippStsOutOfRangeErr           GFPE_ROOM(pA)!=GFP_FELEN(pGFE)
70 //                                  GFPE_ROOM(pB)!=GFP_FELEN(pGFE)
71 //
72 //    ippStsNoErr                   no error
73 //
74 // Parameters:
75 //    pA        Pointer to the coefficient A of the equation defining the elliptic curve
76 //    pB        Pointer to the coefficient B of the equation defining the elliptic curve
77 //    pEC       Pointer to the context of the elliptic curve
78 //
79 *F*/
80 
81 IPPFUN(IppStatus, ippsGFpECSet,(const IppsGFpElement* pA,
82                                 const IppsGFpElement* pB,
83                                 IppsGFpECState* pEC))
84 {
85    IPP_BAD_PTR1_RET(pEC);
86    pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) );
87    IPP_BADARG_RET( !ECP_TEST_ID(pEC), ippStsContextMatchErr );
88 
89    IPP_BAD_PTR2_RET(pA, pB);
90    IPP_BADARG_RET( !GFPE_TEST_ID(pA), ippStsContextMatchErr );
91    IPP_BADARG_RET( !GFPE_TEST_ID(pB), ippStsContextMatchErr );
92 
93    {
94       gsModEngine* pGFE = GFP_PMA(ECP_GFP(pEC));
95       int elemLen = GFP_FELEN(pGFE);
96 
97       IPP_BADARG_RET( GFPE_ROOM(pA)!=GFP_FELEN(pGFE), ippStsOutOfRangeErr);
98       IPP_BADARG_RET( GFPE_ROOM(pB)!=GFP_FELEN(pGFE), ippStsOutOfRangeErr);
99 
100       /* copy A */
101       cpGFpElementPadd(ECP_A(pEC), elemLen, 0);
102       cpGFpElementCopy(ECP_A(pEC), GFPE_DATA(pA), elemLen);
103       /* and set up A-specific (a==0 or a==-3) if is */
104       if(GFP_IS_ZERO(ECP_A(pEC), elemLen))
105          ECP_SPECIFIC(pEC) = ECP_EPID2;
106 
107       cpGFpElementSetChunk(ECP_B(pEC), elemLen, 3);
108       GFP_METHOD(pGFE)->encode(ECP_B(pEC), ECP_B(pEC), pGFE);
109       GFP_METHOD(pGFE)->add(ECP_B(pEC), ECP_A(pEC), ECP_B(pEC), pGFE);
110       if(GFP_IS_ZERO(ECP_B(pEC), elemLen))
111          ECP_SPECIFIC(pEC) = ECP_STD;
112 
113       /* copy B */
114       cpGFpElementPadd(ECP_B(pEC), elemLen, 0);
115       cpGFpElementCopy(ECP_B(pEC), GFPE_DATA(pB), elemLen);
116       /* and set type of affine infinity representation:
117       // (0,1) if B==0
118       // (0,0) if B!=0 */
119       ECP_INFINITY(pEC) = GFP_IS_ZERO(ECP_B(pEC), elemLen);
120 
121       return ippStsNoErr;
122    }
123 }
124