1 /*******************************************************************************
2 * Copyright 2003-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 //     Cryptography Primitive.
45 //     EC over Prime Finite Field (validate domain parameters)
46 //
47 //  Contents:
48 //     ippsECCPValidate()
49 //
50 //
51 */
52 
53 #include "owndefs.h"
54 #include "owncp.h"
55 #include "pcpeccp.h"
56 
57 
58 /*F*
59 //    Name: ippsECCPValidate
60 //
61 // Purpose: Validate ECC Domain Parameters.
62 //
63 // Returns:                Reason:
64 //    ippStsNullPtrErr        NULL == pEC
65 //                            NULL == c
66 //                            NULL == pSeed
67 //                            NULL == pResult
68 //
69 //    ippStsContextMatchErr   illegal pEC->idCtx
70 //                            illegal c->idCtx
71 //
72 //    ippStsBadArgErr         nTrials <=0
73 //                            BN_SIZE(c)<5
74 //
75 //    ippStsNoErr             no errors
76 //
77 // Parameters:
78 //    nTrials     number of trials of primality test
79 //    pResult     pointer to the validation result
80 //    pEC        pointer to the ECC context
81 //    rndFunc     Specified Random Generator.
82 //    pRndParam   Pointer to Random Generator context.
83 //
84 // Note
85 //    Validation Domain Parameters folowing by P1363 recommendation
86 //    (reference A.16.8)
87 //
88 *F*/
89 
90 #define _DISABLE_TEST_PRIMALITY_
91 // validation has been reduced in comparison with legacy version:
92 // - no primality test of underlying prime
93 // - no primality test of base point order
94 // - no MOV test
95 
96 IPPFUN(IppStatus, ippsECCPValidate, (int nTrials, IppECResult* pResult, IppsECCPState* pEC,
97                                      IppBitSupplier rndFunc, void* pRndParam))
98 {
99    #if defined(_DISABLE_TEST_PRIMALITY_)
100    UNREFERENCED_PARAMETER(nTrials);
101    UNREFERENCED_PARAMETER(rndFunc);
102    UNREFERENCED_PARAMETER(pRndParam);
103    #else
104    /* test number of trials for primality check */
105    IPP_BADARG_RET(nTrials<=0, ippStsBadArgErr);
106    IPP_BAD_PTR2_RET(rndFunc, pRndParam);
107    #endif
108 
109    IPP_BAD_PTR2_RET(pResult, pEC);
110 
111    /* use aligned EC context */
112    pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) );
113    IPP_BADARG_RET(!ECP_TEST_ID(pEC), ippStsContextMatchErr);
114 
115    return ippsGFpECVerify(pResult, pEC, (Ipp8u*)ECP_SBUFFER(pEC));
116 }
117