Annotation of sys/dev/rndvar.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: rndvar.h,v 1.19 2003/11/03 18:24:28 tedu Exp $ */
2:
3: /*
4: * Copyright (c) 1996,2000 Michael Shalayeff.
5: *
6: * This software derived from one contributed by Theodore Ts'o.
7: *
8: * Redistribution and use in source and binary forms, with or without
9: * modification, are permitted provided that the following conditions
10: * are met:
11: * 1. Redistributions of source code must retain the above copyright
12: * notice, this list of conditions and the following disclaimer.
13: * 2. Redistributions in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in the
15: * documentation and/or other materials provided with the distribution.
16: *
17: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27: * SUCH DAMAGE.
28: *
29: */
30:
31: #ifndef __RNDVAR_H__
32: #define __RNDVAR_H__
33:
34: #define POOLWORDS 1024 /* Power of 2 - note that this is 32-bit words */
35:
36: #define RND_RND 0 /* real randomness like nuclear chips */
37: #define RND_SRND 1 /* strong random source */
38: #define RND_URND 2 /* less strong random source */
39: #define RND_PRND 3 /* pseudo random source */
40: #define RND_ARND 4 /* aRC4 based random number generator */
41: #define RND_NODEV 5 /* First invalid minor device number */
42:
43: #define RND_SRC_TRUE 0
44: #define RND_SRC_TIMER 1
45: #define RND_SRC_MOUSE 2
46: #define RND_SRC_TTY 3
47: #define RND_SRC_DISK 4
48: #define RND_SRC_NET 5
49: #define RND_SRC_AUDIO 6
50: #define RND_SRC_VIDEO 7
51: #define RND_SRC_NUM 8
52:
53: struct rndstats {
54: quad_t rnd_total; /* total bits of entropy generated */
55: quad_t rnd_used; /* strong data bits read so far */
56: quad_t rnd_reads; /* strong read calls */
57: quad_t arc4_reads; /* aRC4 data bytes read so far */
58: quad_t arc4_nstirs; /* arc4 pool stirs */
59: quad_t arc4_stirs; /* arc4 pool stirs (bits used) */
60:
61: quad_t rnd_pad[5];
62:
63: quad_t rnd_waits; /* sleeps for data */
64: quad_t rnd_enqs; /* enqueue calls */
65: quad_t rnd_deqs; /* dequeue calls */
66: quad_t rnd_drops; /* queue-full drops */
67: quad_t rnd_drople; /* queue low watermark low entropy drops */
68:
69: quad_t rnd_ed[32]; /* entropy feed distribution */
70: quad_t rnd_sc[RND_SRC_NUM]; /* add* calls */
71: quad_t rnd_sb[RND_SRC_NUM]; /* add* bits */
72: };
73:
74: #ifdef _KERNEL
75: extern struct rndstats rndstats;
76:
77: #define add_true_randomness(d) enqueue_randomness(RND_SRC_TRUE, (int)(d))
78: #define add_timer_randomness(d) enqueue_randomness(RND_SRC_TIMER, (int)(d))
79: #define add_mouse_randomness(d) enqueue_randomness(RND_SRC_MOUSE, (int)(d))
80: #define add_tty_randomness(d) enqueue_randomness(RND_SRC_TTY, (int)(d))
81: #define add_disk_randomness(d) enqueue_randomness(RND_SRC_DISK, (int)(d))
82: #define add_net_randomness(d) enqueue_randomness(RND_SRC_NET, (int)(d))
83: #define add_audio_randomness(d) enqueue_randomness(RND_SRC_AUDIO, (int)(d))
84: #define add_video_randomness(d) enqueue_randomness(RND_SRC_VIDEO, (int)(d))
85:
86: void enqueue_randomness(int, int);
87: void get_random_bytes(void *, size_t);
88: void arc4random_bytes(void *, size_t);
89: u_int32_t arc4random(void);
90:
91: #endif /* _KERNEL */
92:
93: #endif /* __RNDVAR_H__ */
CVSweb