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 // ippsGFpECGetPoint() 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 /*F* 59 // Name: ippsGFpECGetPoint 60 // 61 // Purpose: Retrieves coordinates of a point on an elliptic curve 62 // 63 // Returns: Reason: 64 // ippStsNullPtrErr pPoint == NULL 65 // pEC == NULL 66 // 67 // ippStsContextMatchErr invalid pEC->idCtx 68 // invalid pPoint->idCtx 69 // pX != NULL && invalid pX->idCtx 70 // pY != NULL && invalid pY->idCtx 71 // pX != NULL && GFPE_ROOM(pX)!=GFP_FELEN() 72 // pY != NULL && GFPE_ROOM(pY)!=GFP_FELEN() 73 // 74 // ippStsOutOfRangeErr ECP_POINT_FELEN(pPoint)!=GFP_FELEN() 75 // pX != NULL && GFPE_ROOM(pX)!=GFP_FELEN() 76 // pY != NULL && GFPE_ROOM(pY)!=GFP_FELEN() 77 // 78 // ippStsNoErr no error 79 // 80 // Parameters: 81 // pPoint Pointer to the IppsGFpECPoint context 82 // pEC Pointer to the context of the elliptic curve 83 // pX, pY Pointers to the X and Y coordinates of a point on the elliptic curve 84 // 85 // Note: 86 // Is not a fact that computed point belongs to BP-related subgroup BP 87 // 88 *F*/ 89 90 IPPFUN(IppStatus, ippsGFpECGetPoint,(const IppsGFpECPoint* pPoint, 91 IppsGFpElement* pX, IppsGFpElement* pY, 92 IppsGFpECState* pEC)) 93 { 94 IPP_BAD_PTR2_RET(pPoint, pEC); 95 pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) ); 96 IPP_BADARG_RET( !ECP_TEST_ID(pEC), ippStsContextMatchErr ); 97 IPP_BADARG_RET( !ECP_POINT_TEST_ID(pPoint), ippStsContextMatchErr ); 98 99 IPP_BADARG_RET( pX && !GFPE_TEST_ID(pX), ippStsContextMatchErr ); 100 IPP_BADARG_RET( pY && !GFPE_TEST_ID(pY), ippStsContextMatchErr ); 101 102 IPP_BADARG_RET( pX && GFPE_ROOM(pX)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr); 103 IPP_BADARG_RET( pY && GFPE_ROOM(pY)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr); 104 IPP_BADARG_RET( ECP_POINT_FELEN(pPoint)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr); 105 106 /* returns (X,Y) == (0,0) if Point is at infinity */ 107 gfec_GetPoint((pX)? GFPE_DATA(pX):NULL, (pY)? GFPE_DATA(pY):NULL, pPoint, pEC); 108 return ippStsNoErr; 109 } 110