Home | History | Annotate | Download | only in ippcp 
      1 /*******************************************************************************
      2 * Copyright 2015-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 //     PRNG Functions
     46 //
     47 //  Contents:
     48 //        ippsPRNGenRDRAND_BN()
     49 //
     50 */
     51 
     52 #include "owndefs.h"
     53 #include "owncp.h"
     54 #include "pcpbn.h"
     55 #include "pcptool.h"
     56 #include "pcpprng_genhw.h"
     57 
     58 /*F*
     59 // Name: ippsPRNGenRDRAND_BN
     60 //
     61 // Purpose: Generates a pseudorandom big number
     62 //          based on RDRAND instruction of the specified nBits length.
     63 //
     64 // Returns:                   Reason:
     65 //    ippStsNullPtrErr           NULL == pBuffer
     66 //
     67 //    ippStsLengthErr            1 > nBits
     68 //                               nBits > BN_ROOM(pRand)
     69 //
     70 //    ippStsNotSupportedModeErr  unsupported rdrand instruction
     71 //
     72 //    ippStsErr                  random big number can't be generated
     73 //
     74 //    ippStsNoErr                no error
     75 //
     76 // Parameters:
     77 //    pRand  pointer to the big number
     78 //    nBits    number of bits be requested
     79 //    pCtx     pointer to the context
     80 *F*/
     81 IPPFUN(IppStatus, ippsPRNGenRDRAND_BN,(IppsBigNumState* pRand, int nBits, void* pCtx))
     82 {
     83    /* test random BN */
     84    IPP_BAD_PTR1_RET(pRand);
     85    pRand = (IppsBigNumState*)( IPP_ALIGNED_PTR(pRand, BN_ALIGNMENT) );
     86    IPP_BADARG_RET(!BN_VALID_ID(pRand), ippStsContextMatchErr);
     87 
     88    /* test sizes */
     89    IPP_BADARG_RET(nBits< 1, ippStsLengthErr);
     90    IPP_BADARG_RET(nBits> BN_ROOM(pRand)*BNU_CHUNK_BITS, ippStsLengthErr);
     91 
     92    UNREFERENCED_PARAMETER(pCtx);
     93 
     94    #if ((_IPP>=_IPP_G9) || (_IPP32E>=_IPP32E_E9))
     95    if( IsFeatureEnabled(ippCPUID_RDRAND) ) {
     96       BNU_CHUNK_T* pRandBN = BN_NUMBER(pRand);
     97       cpSize rndSize = BITS_BNU_CHUNK(nBits);
     98       BNU_CHUNK_T rndMask = MASK_BNU_CHUNK(nBits);
     99 
    100       if(cpRandHW_buffer((Ipp32u*)pRandBN, rndSize*sizeof(BNU_CHUNK_T)/sizeof(Ipp32u))) {
    101          pRandBN[rndSize-1] &= rndMask;
    102 
    103          FIX_BNU(pRandBN, rndSize);
    104          BN_SIZE(pRand) = rndSize;
    105          BN_SIGN(pRand) = ippBigNumPOS;
    106 
    107          return ippStsNoErr;
    108       }
    109       else
    110          return ippStsErr;
    111    }
    112 
    113    /* unsupported rdrand instruction */
    114    else
    115    #endif
    116       IPP_ERROR_RET(ippStsNotSupportedModeErr);
    117 }
    118