Add DRBG random method
[openssl.git] / 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 int RAND_DRBG_set_callbacks(DRBG_CTX *dctx,
30     size_t (*get_entropy)(DRBG_CTX *ctx, unsigned char **pout,
31                           int entropy, size_t min_len, size_t max_len),
32     void (*cleanup_entropy)(DRBG_CTX *ctx, unsigned char *out, size_t olen),
33     size_t (*get_nonce)(DRBG_CTX *ctx, unsigned char **pout,
34                         int entropy, size_t min_len, size_t max_len),
35     void (*cleanup_nonce)(DRBG_CTX *ctx, unsigned char *out, size_t olen)
36     );
37
38 void RAND_DRBG_set_reseed_interval(DRBG_CTX *dctx, int interval);
39
40 #define RAND_DRBG_get_ex_new_index(l, p, newf, dupf, freef) \
41     CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DRBG, l, p, newf, dupf, freef)
42 int RAND_DRBG_set_ex_data(DRBG_CTX *dctx, int idx, void *arg);
43 void *RAND_DRBG_get_ex_data(const DRBG_CTX *dctx, int idx);
44
45 DRBG_CTX *RAND_DRBG_get_default(void);
46
47
48 #endif
49
50