A whole bunch of changes to eventually support
[libgcrypt.git] / random / rand-internal.h
1 /* rand-internal.h - header to glue the random functions
2  *      Copyright (C) 1998, 2002 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, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef G10_RAND_INTERNAL_H
21 #define G10_RAND_INTERNAL_H
22
23
24 /* Constants used to define the origin of random added to the pool.
25    The code is sensitive to the order of the values.  */
26 enum random_origins 
27   {
28     RANDOM_ORIGIN_INIT = 0,      /* Used only for initialization. */
29     RANDOM_ORIGIN_EXTERNAL = 1,  /* Added from an external source.  */
30     RANDOM_ORIGIN_FASTPOLL = 2,  /* Fast random poll function.  */
31     RANDOM_ORIGIN_SLOWPOLL = 3,  /* Slow poll function.  */
32     RANDOM_ORIGIN_EXTRAPOLL = 4  /* Used to mark an extra pool seed
33                                     due to a GCRY_VERY_STRONG_RANDOM
34                                     random request.  */
35   };
36
37
38
39 /*-- random.c --*/
40 void _gcry_random_progress (const char *what, int printchar,
41                             int current, int total);
42
43
44 /*-- random-csprng.c --*/
45 void _gcry_rngcsprng_initialize (int full);
46 void _gcry_rngcsprng_dump_stats (void);
47 void _gcry_rngcsprng_secure_alloc (void);
48 void _gcry_rngcsprng_enable_quick_gen (void);
49 void _gcry_rngcsprng_set_daemon_socket (const char *socketname);
50 int  _gcry_rngcsprng_use_daemon (int onoff);
51 int  _gcry_rngcsprng_is_faked (void);
52 gcry_error_t _gcry_rngcsprng_add_bytes (const void *buf, size_t buflen,
53                                         int quality);
54 void *_gcry_rngcsprng_get_bytes (size_t nbytes,
55                                  enum gcry_random_level level);
56 void *_gcry_rngcsprng_get_bytes_secure (size_t nbytes, 
57                                         enum gcry_random_level level);
58 void _gcry_rngcsprng_randomize (void *buffer, size_t length,
59                                 enum gcry_random_level level);
60 void _gcry_rngcsprng_set_seed_file (const char *name);
61 void _gcry_rngcsprng_update_seed_file (void);
62 void _gcry_rngcsprng_fast_poll (void);
63 void _gcry_rngcsprng_create_nonce (void *buffer, size_t length);
64
65 /*-- random-rngcsprng.c --*/
66 void _gcry_rngfips_initialize (int full);
67 void _gcry_rngfips_dump_stats (void);
68 int  _gcry_rngfips_is_faked (void);
69 gcry_error_t _gcry_rngfips_add_bytes (const void *buf, size_t buflen,
70                                         int quality);
71 void *_gcry_rngfips_get_bytes (size_t nbytes,
72                                enum gcry_random_level level);
73 void *_gcry_rngfips_get_bytes_secure (size_t nbytes, 
74                                       enum gcry_random_level level);
75 void _gcry_rngfips_randomize (void *buffer, size_t length,
76                                 enum gcry_random_level level);
77 void _gcry_rngfips_create_nonce (void *buffer, size_t length);
78
79
80
81
82
83
84 /*-- rndlinux.c --*/
85 int _gcry_rndlinux_gather_random (void (*add) (const void *, size_t,
86                                                enum random_origins),
87                                    enum random_origins origin,
88                                   size_t length, int level);
89
90 /*-- rndunix.c --*/
91 int _gcry_rndunix_gather_random (void (*add) (const void *, size_t,
92                                               enum random_origins),
93                                  enum random_origins origin,
94                                  size_t length, int level);
95
96 /*-- rndelg.c --*/
97 int _gcry_rndegd_gather_random (void (*add) (const void *, size_t,
98                                              enum random_origins),
99                                 enum random_origins origin,
100                                 size_t length, int level);
101 int _gcry_rndegd_connect_socket (int nofail);
102
103 /*-- rndw32.c --*/
104 int _gcry_rndw32_gather_random (void (*add) (const void *, size_t,
105                                              enum random_origins),
106                                 enum random_origins origin,
107                                 size_t length, int level);
108 void _gcry_rndw32_gather_random_fast (void (*add)(const void*, size_t, 
109                                                   enum random_origins),
110                                       enum random_origins origin );
111
112 /*-- rndhw.c --*/
113 int _gcry_rndhw_failed_p (void);
114 void _gcry_rndhw_poll_fast (void (*add)(const void*, size_t,
115                                         enum random_origins),
116                             enum random_origins origin);
117 size_t _gcry_rndhw_poll_slow (void (*add)(const void*, size_t,
118                                           enum random_origins),
119                               enum random_origins origin);
120
121
122
123 #endif /*G10_RAND_INTERNAL_H*/