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()
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
60 //
61 // Purpose: Generates a pseudorandom bit sequence
62 //          based on RDRAND instruction of the specified nBits length.
63 //
64 // Returns:                   Reason:
65 //    ippStsNullPtrErr           NULL == pRand
66 //
67 //    ippStsLengthErr            1 > nBits
68 //
69 //    ippStsNotSupportedModeErr  unsupported rdrand instruction
70 //
71 //    ippStsErr                  random bit sequence can't be generated
72 //
73 //    ippStsNoErr                no error
74 //
75 // Parameters:
76 //    pRand    pointer to the buffer
77 //    nBits    number of bits be requested
78 //    pCtx     pointer to the context
79 *F*/
80 IPPFUN(IppStatus, ippsPRNGenRDRAND,(Ipp32u* pRand, int nBits, void* pCtx))
81 {
82    /* test PRNG buffer */
83    IPP_BAD_PTR1_RET(pRand);
84 
85    /* test sizes */
86    IPP_BADARG_RET(nBits< 1, ippStsLengthErr);
87 
88    UNREFERENCED_PARAMETER(pCtx);
89 
90    #if ((_IPP>=_IPP_G9) || (_IPP32E>=_IPP32E_E9))
91    if( IsFeatureEnabled(ippCPUID_RDRAND) ) {
92       cpSize rndSize = BITS2WORD32_SIZE(nBits);
93       Ipp32u rndMask = MAKEMASK32(nBits);
94 
95       if(cpRandHW_buffer(pRand, rndSize)) {
96          pRand[rndSize-1] &= rndMask;
97          return ippStsNoErr;
98       }
99       else
100          return ippStsErr;
101    }
102    /* unsupported rdrand instruction */
103    else
104    #endif
105       IPP_ERROR_RET(ippStsNotSupportedModeErr);
106 }
107