1RAND_DRBG_SET_EX_DATA(3)            OpenSSL           RAND_DRBG_SET_EX_DATA(3)
2
3
4

NAME

6       RAND_DRBG_set_ex_data, RAND_DRBG_get_ex_data,
7       RAND_DRBG_get_ex_new_index - store and retrieve extra data from the
8       DRBG instance
9

SYNOPSIS

11        #include <openssl/rand_drbg.h>
12
13        int RAND_DRBG_set_ex_data(RAND_DRBG *drbg, int idx, void *data);
14
15        void *RAND_DRBG_get_ex_data(const RAND_DRBG *drbg, int idx);
16
17        int RAND_DRBG_get_ex_new_index(long argl, void *argp,
18                                       CRYPTO_EX_new *new_func,
19                                       CRYPTO_EX_dup *dup_func,
20                                       CRYPTO_EX_free *free_func);
21

DESCRIPTION

23       RAND_DRBG_set_ex_data() enables an application to store arbitrary
24       application specific data data in a RAND_DRBG instance drbg. The index
25       idx should be a value previously returned from a call to
26       RAND_DRBG_get_ex_new_index().
27
28       RAND_DRBG_get_ex_data() retrieves application specific data previously
29       stored in an RAND_DRBG instance drbg. The idx value should be the same
30       as that used when originally storing the data.
31
32       For more detailed information see CRYPTO_get_ex_data(3) and
33       CRYPTO_set_ex_data(3) which implement these functions and
34       CRYPTO_get_ex_new_index(3) for generating a unique index.
35

RETURN VALUES

37       RAND_DRBG_set_ex_data() returns 1 for success or 0 for failure.
38
39       RAND_DRBG_get_ex_data() returns the previously stored value or NULL on
40       failure. NULL may also be a valid value.
41

NOTES

43       RAND_DRBG_get_ex_new_index(...) is implemented as a macro and
44       equivalent to CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DRBG,...).
45

SEE ALSO

47       CRYPTO_get_ex_data(3), CRYPTO_set_ex_data(3),
48       CRYPTO_get_ex_new_index(3), RAND_DRBG(7)
49

51       Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved.
52
53       Licensed under the OpenSSL license (the "License").  You may not use
54       this file except in compliance with the License.  You can obtain a copy
55       in the file LICENSE in the source distribution or at
56       <https://www.openssl.org/source/license.html>.
57
58
59
601.1.1q                            2022-07-21          RAND_DRBG_SET_EX_DATA(3)
Impressum