Blame


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 Most security software requires a source of random or, at the
20 cfa37a7b 2004-04-10 devnull very least, unguessable numbers.
21 cfa37a7b 2004-04-10 devnull .PP
22 cfa37a7b 2004-04-10 devnull .I Genrandom
23 cfa37a7b 2004-04-10 devnull fills a buffer with bytes from the X9.17 pseudo-random
24 cfa37a7b 2004-04-10 devnull number generator. The X9.17 generator is seeded by 24
25 cfa37a7b 2004-04-10 devnull truly random bytes read from
26 cfa37a7b 2004-04-10 devnull .BR /dev/random .
27 cfa37a7b 2004-04-10 devnull .PP
28 cfa37a7b 2004-04-10 devnull .I Prng
29 cfa37a7b 2004-04-10 devnull uses the native
30 bf8a59fa 2004-04-11 devnull .IR rand (3)
31 cfa37a7b 2004-04-10 devnull pseudo-random number generator to fill the buffer. Used with
32 cfa37a7b 2004-04-10 devnull .IR srand ,
33 cfa37a7b 2004-04-10 devnull this function can produce a reproducible stream of pseudo random
34 cfa37a7b 2004-04-10 devnull numbers useful in testing.
35 cfa37a7b 2004-04-10 devnull .PP
36 cfa37a7b 2004-04-10 devnull Both functions may be passed to
37 cfa37a7b 2004-04-10 devnull .I mprand
38 cfa37a7b 2004-04-10 devnull (see
39 bf8a59fa 2004-04-11 devnull .IR mp (3)).
40 cfa37a7b 2004-04-10 devnull .SH SOURCE
41 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/libsec
42 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
43 bf8a59fa 2004-04-11 devnull .IR mp (3)