Home | History | Annotate | Download | only in ippcp
      1 /*******************************************************************************
      2 * Copyright 2002-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 //     Internal Definitions and
     46 //     Internal Pseudo Random Generator Function Prototypes
     47 //
     48 */
     49 
     50 #if !defined(_CP_PRNG_H)
     51 #define _CP_PRNG_H
     52 
     53 /*
     54 // Pseudo-random generation context
     55 */
     56 
     57 #define MAX_XKEY_SIZE       512
     58 #define DEFAULT_XKEY_SIZE   512 /* must be >=160 || <=512 */
     59 
     60 struct _cpPRNG {
     61    IppCtxId    idCtx;                                 /* PRNG identifier            */
     62    cpSize      seedBits;                              /* secret seed-key bitsize    */
     63    BNU_CHUNK_T Q[BITS_BNU_CHUNK(160)];                /* modulus                    */
     64    BNU_CHUNK_T T[BITS_BNU_CHUNK(160)];                /* parameter of SHA_G() funct */
     65    BNU_CHUNK_T xAug[BITS_BNU_CHUNK(MAX_XKEY_SIZE)];   /* optional entropy augment   */
     66    BNU_CHUNK_T xKey[BITS_BNU_CHUNK(MAX_XKEY_SIZE)];   /* secret seed-key            */
     67 };
     68 
     69 /* alignment */
     70 #define PRNG_ALIGNMENT ((int)(sizeof(void*)))
     71 
     72 #define RAND_ID(ctx)       ((ctx)->idCtx)
     73 #define RAND_SEEDBITS(ctx) ((ctx)->seedBits)
     74 #define RAND_Q(ctx)        ((ctx)->Q)
     75 #define RAND_T(ctx)        ((ctx)->T)
     76 #define RAND_XAUGMENT(ctx) ((ctx)->xAug)
     77 #define RAND_XKEY(ctx)     ((ctx)->xKey)
     78 
     79 #define RAND_VALID_ID(ctx)  (RAND_ID((ctx))==idCtxPRNG)
     80 
     81 #define cpPRNGen OWNAPI(cpPRNGen)
     82 int cpPRNGen(Ipp32u* pBuffer, cpSize bitLen, IppsPRNGState* pCtx);
     83 
     84 #define cpPRNGenPattern OWNAPI(cpPRNGenPattern)
     85 int cpPRNGenPattern(BNU_CHUNK_T* pRand, int bitSize,
     86                     BNU_CHUNK_T botPattern, BNU_CHUNK_T topPattern,
     87                     IppBitSupplier rndFunc, void* pRndParam);
     88 
     89 #define cpPRNGenRange OWNAPI(cpPRNGenRange)
     90 int cpPRNGenRange(BNU_CHUNK_T* pRand,
     91             const BNU_CHUNK_T* pLo, cpSize loLen,
     92             const BNU_CHUNK_T* pHi, cpSize hiLen,
     93                   IppBitSupplier rndFunc, void* pRndParam);
     94 
     95 #endif /* _CP_PRNG_H */
     96