
RNGTEST(1) RNGTEST(1)
NAME
rngtest  Check the randomness of data using FIPS 1402 tests
SYNOPSIS
rngtest [c n  blockcount=n] [b n  blockstats=n] [t n  timedstats=n] [p 
pipe] [?] [help] [V] [version]
DESCRIPTION
rngtest works on blocks of 20000 bits at a time, using the FIPS 1402 (errata of
20011010) tests to verify the randomness of the block of data.
It takes input from stdin, and outputs statistics to stderr, optionally echoing blocks
that passed the FIPS tests to stdout (when operating in pipe mode). Errors are sent to
stderr.
At startup, rngtest will trow away the first 32 bits of data when operating in pipe mode.
It will use the next 32 bits of data to bootstrap the FIPS tests (even when not operating
in pipe mode). These bits are not tested for randomness.
Statistics are dumped to stderr when the program exits.
OPTIONS
p, pipe
Enable pipe mode. All data blocks that pass the FIPS tests are echoed to stdout,
and rngtest operates in silent mode.
c n, blockcount=n (default: 0)
Exit after processing n input blocks, if n is not zero.
b n, blockstats=n (default: 0)
Dump statistics every n blocks, if n is not zero.
t n, timedstats=n (default: 0)
Dump statistics every n seconds, if n is not zero.
?, help
Give a short summary of all program options.
V, version
Print program version
STATISTICS
rngtest will dump statistics to stderr when it exits, and when told to by blockstats or
timedstats.
FIPS 1402 successes and FIPS 1402 failures counts the number of 20000bit blocks either
accepted or rejected by the FIPS 1402 tests. The other statistics show a breakdown of
the FIPS 1402 failures by FIPS 1402 test. See the FIPS 1402 document for more informa
tion (note that these tests are defined on FIPS 1401 and FIPS 1402 errata of 20011010.
They were removed in FIPS 1402 errata of 20021203).
The speed statistics are taken for every 20000bit block transferred or processed.
EXIT STATUS
0 if no errors happen, and no blocks fail the FIPS tests.
1 if no errors happen, but at least one block fails the FIPS tests.
10 if there are problems with the parameters.
11 if an input/output error happens.
12 if an operating system or resource starvation error happens.
SEE ALSO
random(4), rngd(8)
FIPS PUB 1402 Security Requirements for Cryptographic Modules, NIST,
http://csrc.nist.gov/cryptval/1402.htm
AUTHORS
Henrique de Moraes Holschuh <hmh@debian.org>
rngtools 4 March 2004 RNGTEST(1) 
