1 cfa37a7b 2004-04-10 devnull .TH GENRANDOM 3
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull genrandom, prng \- random number generation
 4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
 5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
 6 cfa37a7b 2004-04-10 devnull .br
 7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
 8 cfa37a7b 2004-04-10 devnull .br
 9 cfa37a7b 2004-04-10 devnull .B #include <mp.h>
10 cfa37a7b 2004-04-10 devnull .br
11 cfa37a7b 2004-04-10 devnull .B #include <libsec.h>
12 cfa37a7b 2004-04-10 devnull .PP
13 cfa37a7b 2004-04-10 devnull .B
14 cfa37a7b 2004-04-10 devnull void	genrandom(uchar *buf, int nbytes)
15 cfa37a7b 2004-04-10 devnull .PP
16 cfa37a7b 2004-04-10 devnull .B
17 cfa37a7b 2004-04-10 devnull void	prng(uchar *buf, int nbytes)
18 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
19 cfa37a7b 2004-04-10 devnull .PP
20 cfa37a7b 2004-04-10 devnull Most security software requires a source of random or, at the
21 cfa37a7b 2004-04-10 devnull very least, unguessable numbers.
22 cfa37a7b 2004-04-10 devnull .PP
23 cfa37a7b 2004-04-10 devnull .I Genrandom
24 cfa37a7b 2004-04-10 devnull fills a buffer with bytes from the X9.17 pseudo-random
25 cfa37a7b 2004-04-10 devnull number generator.  The X9.17 generator is seeded by 24
26 cfa37a7b 2004-04-10 devnull truly random bytes read from
27 cfa37a7b 2004-04-10 devnull .BR /dev/random .
28 cfa37a7b 2004-04-10 devnull .PP
29 cfa37a7b 2004-04-10 devnull .I Prng
30 cfa37a7b 2004-04-10 devnull uses the native
31 bf8a59fa 2004-04-11 devnull .IR rand (3)
32 cfa37a7b 2004-04-10 devnull pseudo-random number generator to fill the buffer.  Used with
33 cfa37a7b 2004-04-10 devnull .IR srand ,
34 cfa37a7b 2004-04-10 devnull this function can produce a reproducible stream of pseudo random
35 cfa37a7b 2004-04-10 devnull numbers useful in testing.
36 cfa37a7b 2004-04-10 devnull .PP
37 cfa37a7b 2004-04-10 devnull Both functions may be passed to
38 cfa37a7b 2004-04-10 devnull .I mprand
39 cfa37a7b 2004-04-10 devnull (see
40 bf8a59fa 2004-04-11 devnull .IR mp (3)).
41 cfa37a7b 2004-04-10 devnull .SH SOURCE
42 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/libsec
43 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
44 bf8a59fa 2004-04-11 devnull .IR mp (3)