random: Symbol name cleanup for random-drbg.c.
[libgcrypt.git] / random / random.h
1 /* random.h - random functions
2  *      Copyright (C) 1998, 2002, 2006 Free Software Foundation, Inc.
3  *
4  * This file is part of Libgcrypt.
5  *
6  * Libgcrypt is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU Lesser General Public License as
8  * published by the Free Software Foundation; either version 2.1 of
9  * the License, or (at your option) any later version.
10  *
11  * Libgcrypt is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20 #ifndef G10_RANDOM_H
21 #define G10_RANDOM_H
22
23 #include "types.h"
24
25 /*-- random.c --*/
26 void _gcry_register_random_progress (void (*cb)(void *,const char*,int,int,int),
27                                      void *cb_data );
28
29 void _gcry_set_preferred_rng_type (int type);
30 void _gcry_random_initialize (int full);
31 void _gcry_random_close_fds (void);
32 int  _gcry_get_rng_type (int ignore_fips_mode);
33 void _gcry_random_dump_stats(void);
34 void _gcry_secure_random_alloc(void);
35 void _gcry_enable_quick_random_gen (void);
36 int  _gcry_random_is_faked(void);
37 void _gcry_set_random_daemon_socket (const char *socketname);
38 int  _gcry_use_random_daemon (int onoff);
39 void _gcry_set_random_seed_file (const char *name);
40 void _gcry_update_random_seed_file (void);
41
42 byte *_gcry_get_random_bits( size_t nbits, int level, int secure );
43 void _gcry_fast_random_poll( void );
44
45 gcry_err_code_t _gcry_random_init_external_test (void **r_context,
46                                                  unsigned int flags,
47                                                  const void *key,
48                                                  size_t keylen,
49                                                  const void *seed,
50                                                  size_t seedlen,
51                                                  const void *dt,
52                                                  size_t dtlen);
53 gcry_err_code_t _gcry_random_run_external_test (void *context,
54                                                 char *buffer, size_t buflen);
55 void            _gcry_random_deinit_external_test (void *context);
56
57 /*-- random-drbg.c --*/
58 gpg_err_code_t _gcry_rngdrbg_reinit (const char *flagstr,
59                                      gcry_buffer_t *pers, int npers);
60 /* private interfaces for testing of DRBG */
61 struct gcry_drbg_test_vector
62 {
63   u32 flags;
64   unsigned char *entropy;
65   size_t entropylen;
66   unsigned char *entpra;
67   unsigned char *entprb;
68   size_t entprlen;
69   unsigned char *addtla;
70   unsigned char *addtlb;
71   size_t addtllen;
72   unsigned char *pers;
73   size_t perslen;
74   unsigned char *expected;
75   size_t expectedlen;
76   unsigned char *entropyreseed;
77   size_t entropyreseed_len;
78   unsigned char *addtl_reseed;
79   size_t addtl_reseed_len;
80 };
81
82 gpg_err_code_t gcry_rngdrbg_cavs_test (struct gcry_drbg_test_vector *t,
83                                        unsigned char *buf);
84 gpg_err_code_t gcry_rngdrbg_healthcheck_one (struct gcry_drbg_test_vector *t);
85
86 /*-- rndegd.c --*/
87 gpg_error_t _gcry_rndegd_set_socket_name (const char *name);
88
89 /*-- random-daemon.c (only used from random.c) --*/
90 #ifdef USE_RANDOM_DAEMON
91 void _gcry_daemon_initialize_basics (void);
92 int _gcry_daemon_randomize (const char *socketname,
93                             void *buffer, size_t length,
94                             enum gcry_random_level level);
95 #endif /*USE_RANDOM_DAEMON*/
96
97 #endif /*G10_RANDOM_H*/