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 c8b6342d 2005-01-13 devnull truly random bytes read via
26 c8b6342d 2005-01-13 devnull .I truerand
27 c8b6342d 2005-01-13 devnull (see
28 d32deab1 2020-08-16 rsc .MR rand (3) ).
29 cfa37a7b 2004-04-10 devnull .PP
30 cfa37a7b 2004-04-10 devnull .I Prng
31 cfa37a7b 2004-04-10 devnull uses the native
32 d32deab1 2020-08-16 rsc .MR rand (3)
33 cfa37a7b 2004-04-10 devnull pseudo-random number generator to fill the buffer.  Used with
34 cfa37a7b 2004-04-10 devnull .IR srand ,
35 cfa37a7b 2004-04-10 devnull this function can produce a reproducible stream of pseudo random
36 cfa37a7b 2004-04-10 devnull numbers useful in testing.
37 cfa37a7b 2004-04-10 devnull .PP
38 cfa37a7b 2004-04-10 devnull Both functions may be passed to
39 cfa37a7b 2004-04-10 devnull .I mprand
40 cfa37a7b 2004-04-10 devnull (see
41 d32deab1 2020-08-16 rsc .MR mp (3) ).
42 cfa37a7b 2004-04-10 devnull .SH SOURCE
43 c3674de4 2005-01-11 devnull .B \*9/src/libsec
44 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
45 d32deab1 2020-08-16 rsc .MR mp (3)