include/internal/rand.h

   1 /*
   2  * Copyright 2017 The OpenSSL Project Authors. All Rights Reserved.
   3  *
   4  * Licensed under the OpenSSL license (the "License").  You may not use
   5  * this file except in compliance with the License.  You can obtain a copy
   6  * in the file LICENSE in the source distribution or at
   7  * https://www.openssl.org/source/license.html
   8  */
   9
  10 #ifndef HEADER_DRBG_RAND_H
  11 # define HEADER_DRBG_RAND_H
  12
  13 /* Flag for CTR mode only: use derivation function ctr_df */
  14 #define RAND_DRBG_FLAG_CTR_USE_DF            0x2
  15
  16 const RAND_METHOD *RAND_drbg(void);
  17
  18 int RAND_DRBG_set(DRBG_CTX *ctx, int type, unsigned int flags);
  19 DRBG_CTX *RAND_DRBG_new(int type, unsigned int flags, DRBG_CTX *parent);
  20 int RAND_DRBG_instantiate(DRBG_CTX *dctx,
  21                           const unsigned char *pers, size_t perslen);
  22 int RAND_DRBG_uninstantiate(DRBG_CTX *dctx);
  23 int RAND_DRBG_reseed(DRBG_CTX *dctx, const unsigned char *adin, size_t adinlen);
  24 int RAND_DRBG_generate(DRBG_CTX *dctx, unsigned char *out, size_t outlen,
  25                        int prediction_resistance,
  26                        const unsigned char *adin, size_t adinlen);
  27 void RAND_DRBG_free(DRBG_CTX *dctx);
  28
  29 typedef size_t (*RAND_DRBG_get_entropy_fn)(DRBG_CTX *ctx, unsigned char **pout,
  30                                            int entropy, size_t min_len,
  31                                            size_t max_len);
  32 typedef void (*RAND_DRBG_cleanup_entropy_fn)(DRBG_CTX *ctx, unsigned char *out,
  33                                              size_t olen);
  34 typedef size_t (*RAND_DRBG_get_nonce_fn)(DRBG_CTX *ctx, unsigned char **pout,
  35                                          int entropy, size_t min_len,
  36                                          size_t max_len);
  37 typedef void (*RAND_DRBG_cleanup_nonce_fn)(DRBG_CTX *ctx, unsigned char *out,
  38                                            size_t olen);
  39
  40 int RAND_DRBG_set_callbacks(DRBG_CTX *dctx,
  41                             RAND_DRBG_get_entropy_fn get_entropy,
  42                             RAND_DRBG_cleanup_entropy_fn cleanup_entropy,
  43                             RAND_DRBG_get_nonce_fn get_nonce,
  44                             RAND_DRBG_cleanup_nonce_fn cleanup_nonce);
  45
  46 int RAND_DRBG_set_reseed_interval(DRBG_CTX *dctx, int interval);
  47
  48 #define RAND_DRBG_get_ex_new_index(l, p, newf, dupf, freef) \
  49     CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DRBG, l, p, newf, dupf, freef)
  50 int RAND_DRBG_set_ex_data(DRBG_CTX *dctx, int idx, void *arg);
  51 void *RAND_DRBG_get_ex_data(const DRBG_CTX *dctx, int idx);
  52
  53 DRBG_CTX *RAND_DRBG_get_default(void);
  54
  55
  56 #endif
  57
  58