2004-04-10 18:53:55 +00:00
|
|
|
.TH GENRANDOM 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
genrandom, prng \- random number generation
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B #include <u.h>
|
|
|
|
|
.br
|
|
|
|
|
.B #include <libc.h>
|
|
|
|
|
.br
|
|
|
|
|
.B #include <mp.h>
|
|
|
|
|
.br
|
|
|
|
|
.B #include <libsec.h>
|
|
|
|
|
.PP
|
|
|
|
|
.B
|
|
|
|
|
void genrandom(uchar *buf, int nbytes)
|
|
|
|
|
.PP
|
|
|
|
|
.B
|
|
|
|
|
void prng(uchar *buf, int nbytes)
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
Most security software requires a source of random or, at the
|
|
|
|
|
very least, unguessable numbers.
|
|
|
|
|
.PP
|
|
|
|
|
.I Genrandom
|
|
|
|
|
fills a buffer with bytes from the X9.17 pseudo-random
|
|
|
|
|
number generator. The X9.17 generator is seeded by 24
|
2005-01-13 04:49:19 +00:00
|
|
|
truly random bytes read via
|
|
|
|
|
.I truerand
|
|
|
|
|
(see
|
2020-08-16 00:07:38 +00:00
|
|
|
.MR rand (3) ).
|
2004-04-10 18:53:55 +00:00
|
|
|
.PP
|
|
|
|
|
.I Prng
|
|
|
|
|
uses the native
|
2020-08-16 00:07:38 +00:00
|
|
|
.MR rand (3)
|
2004-04-10 18:53:55 +00:00
|
|
|
pseudo-random number generator to fill the buffer. Used with
|
|
|
|
|
.IR srand ,
|
|
|
|
|
this function can produce a reproducible stream of pseudo random
|
|
|
|
|
numbers useful in testing.
|
|
|
|
|
.PP
|
|
|
|
|
Both functions may be passed to
|
|
|
|
|
.I mprand
|
|
|
|
|
(see
|
2020-08-16 00:07:38 +00:00
|
|
|
.MR mp (3) ).
|
2004-04-10 18:53:55 +00:00
|
|
|
.SH SOURCE
|
2005-01-11 17:37:33 +00:00
|
|
|
.B \*9/src/libsec
|
2004-04-10 18:53:55 +00:00
|
|
|
.SH SEE ALSO
|
2020-08-16 00:07:38 +00:00
|
|
|
.MR mp (3)
|
