EXTERNAL_HEADERS/corecrypto/ccdrbg_impl.h

   1 /*
   2  *  ccdrbg_impl.h
   3  *  corecrypto
   4  *
   5  *  Created on 01/03/2012
   6  *
   7  *  Copyright (c) 2012,2015 Apple Inc. All rights reserved.
   8  *
   9  */
  10
  11 #ifndef _CORECRYPTO_CCDRBG_IMPL_H_
  12 #define _CORECRYPTO_CCDRBG_IMPL_H_
  13
  14 /* opaque drbg structure */
  15 struct ccdrbg_state;
  16
  17 struct ccdrbg_info {
  18     /*! Size of the DRBG state in bytes **/
  19     size_t size;
  20
  21     /*! Instantiate the PRNG
  22      @param prng       The PRNG state
  23      @param entropylen Length of entropy
  24      @param entropy    Entropy bytes
  25      @param inlen      Length of additional input
  26      @param in         Additional input bytes
  27      @return 0 if successful
  28      */
  29     int (*init)(const struct ccdrbg_info *info, struct ccdrbg_state *drbg,
  30                 size_t entropyLength, const void* entropy,
  31                 size_t nonceLength, const void* nonce,
  32                 size_t psLength, const void* ps);
  33
  34     /*! Add entropy to the PRNG
  35      @param prng       The PRNG state
  36      @param entropylen Length of entropy
  37      @param entropy    Entropy bytes
  38      @param inlen      Length of additional input
  39      @param in         Additional input bytes
  40      @return 0 if successful
  41      */
  42     int (*reseed)(struct ccdrbg_state *prng,
  43                   size_t entropylen, const void *entropy,
  44                   size_t inlen, const void *in);
  45
  46     /*! Read from the PRNG in a FIPS Testing compliant manor
  47      @param prng    The PRNG state to read from
  48      @param out     [out] Where to store the data
  49      @param outlen  Length of data desired (octets)
  50      @param inlen   Length of additional input
  51      @param in      Additional input bytes
  52      @return 0 if successfull
  53      */
  54     int (*generate)(struct ccdrbg_state *prng,
  55                     size_t outlen, void *out,
  56                     size_t inlen, const void *in);
  57
  58     /*! Terminate a PRNG state
  59      @param prng   The PRNG state to terminate
  60      */
  61     void (*done)(struct ccdrbg_state *prng);
  62
  63     /** private parameters */
  64     const void *custom;
  65 };
  66
  67
  68
  69 #endif // _CORECRYPTO_CCDRBG_IMPL_H_