Home | History | Annotate | Download | only in ippcp
      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