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 //
43 //  Purpose:
44 //     Intel(R) Integrated Performance Primitives. Cryptography Primitives.
45 //     EC over GF(p) Operations
46 //
47 //     Context:
48 //        ippsGFpECMakePoint()
49 //
50 */
51 
52 #include "owndefs.h"
53 #include "owncp.h"
54 #include "pcpgfpecstuff.h"
55 #include "pcphash.h"
56 #include "pcphash_rmf.h"
57 
58 
59 /*
60    computes for given x- computes y-coodinates of P(x,y) point belonging EC if existing
61 */
62 
63 /*F*
64 // Name: ippsGFpECMakePoint
65 //
66 // Purpose: Constructs the coordinates of a point on an elliptic curve based on the X-coordinate
67 //
68 // Returns:                   Reason:
69 //    ippStsNullPtrErr               pPoint == NULL
70 //                                   pEC == NULL
71 //                                   pX == NULL
72 //
73 //    ippStsContextMatchErr          invalid pEC->idCtx
74 //                                   invalid pPoint->idCtx
75 //                                   invalid pX->idCtx
76 //
77 //    ippStsBadArgErr                !GFP_IS_BASIC(GFP_PMA(ECP_GFP(pEC)))
78 //
79 //    ippStsOutOfRangeErr            ECP_POINT_FELEN(pPoint)!=GFP_FELEN()
80 //                                   GFPE_ROOM(pX)!=GFP_FELEN()
81 //
82 //    ippStsQuadraticNonResidueErr   square of the Y-coordinate of
83 //                                   the pPoint is a quadratic non-residue modulo
84 //
85 //
86 //    ippStsNoErr                    no error
87 //
88 // Parameters:
89 //    pPoint      Pointer to the IppsGFpECPoint context
90 //    pEC         Pointer to the context of the elliptic curve
91 //    pX          Pointer to the X-coordinate of the point on the elliptic curve
92 //
93 // Note:
94 //    Is not a fact that computed point belongs to BP-related subgroup BP
95 //
96 *F*/
97 
98 IPPFUN(IppStatus, ippsGFpECMakePoint,(const IppsGFpElement* pX, IppsGFpECPoint* pPoint, IppsGFpECState* pEC))
99 {
100    IPP_BAD_PTR3_RET(pX, pPoint, pEC);
101    pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) );
102    IPP_BADARG_RET( !ECP_TEST_ID(pEC), ippStsContextMatchErr );
103    IPP_BADARG_RET( !GFP_IS_BASIC(GFP_PMA(ECP_GFP(pEC))), ippStsBadArgErr );
104    IPP_BADARG_RET( !GFPE_TEST_ID(pX), ippStsContextMatchErr );
105    IPP_BADARG_RET( !ECP_POINT_TEST_ID(pPoint), ippStsContextMatchErr );
106 
107    IPP_BADARG_RET( GFPE_ROOM(pX)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr);
108    IPP_BADARG_RET( ECP_POINT_FELEN(pPoint)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr);
109 
110    return gfec_MakePoint(pPoint, GFPE_DATA(pX), pEC)? ippStsNoErr : ippStsQuadraticNonResidueErr;
111 }
112