xref: /dflybsd-src/share/man/man4/rndtest.4 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"-
286d7f5d3SJohn Marino.\" Copyright (c) 2003 Sam Leffler, Errno Consulting
386d7f5d3SJohn Marino.\" All rights reserved.
486d7f5d3SJohn Marino.\"
586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
786d7f5d3SJohn Marino.\" are met:
886d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
986d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1086d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1186d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1286d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1386d7f5d3SJohn Marino.\"
1486d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1586d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1686d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1786d7f5d3SJohn Marino.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1886d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1986d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2086d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2186d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2286d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2386d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2486d7f5d3SJohn Marino.\" SUCH DAMAGE.
2586d7f5d3SJohn Marino.\"
2686d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man4/rndtest.4,v 1.2.4.1 2003/06/04 17:10:30 sam Exp $
2786d7f5d3SJohn Marino.\"
2886d7f5d3SJohn Marino.Dd March 11, 2003
2986d7f5d3SJohn Marino.Dt RNDTEST 4
3086d7f5d3SJohn Marino.Os
3186d7f5d3SJohn Marino.Sh NAME
3286d7f5d3SJohn Marino.Nm rndtest
3386d7f5d3SJohn Marino.Nd FIPS 140-2 random number generator test monitor
3486d7f5d3SJohn Marino.Sh SYNOPSIS
3586d7f5d3SJohn Marino.Cd device rndtest
3686d7f5d3SJohn Marino.Sh DESCRIPTION
3786d7f5d3SJohn MarinoThe
3886d7f5d3SJohn Marino.Nm
3986d7f5d3SJohn Marinodriver ``hooks up'' to hardware crypto devices to monitor the
4086d7f5d3SJohn Marinoentropy data passed to the
4186d7f5d3SJohn Marino.Xr random 4
4286d7f5d3SJohn Marinosubsystem.
4386d7f5d3SJohn MarinoThis data is periodically tested for FIPS 140-2 compliance and
4486d7f5d3SJohn Marinostatistics are collected.
4586d7f5d3SJohn MarinoIf the harvested entropy fails any of the FIPS test suite, then
4686d7f5d3SJohn Marinoit is discarded and testing is continuously applied until ``good data''
4786d7f5d3SJohn Marinois received from the device.
4886d7f5d3SJohn MarinoFailures are optionally reported on the console.
4986d7f5d3SJohn Marino.Sh SEE ALSO
5086d7f5d3SJohn Marino.Xr crypto 4 ,
5186d7f5d3SJohn Marino.Xr hifn 4 ,
5286d7f5d3SJohn Marino.Xr random 4 ,
5386d7f5d3SJohn Marino.Xr safe 4 ,
5486d7f5d3SJohn Marino.Xr ubsec 4 ,
5586d7f5d3SJohn Marino.Xr crypto 9
5686d7f5d3SJohn Marino.Sh HISTORY
5786d7f5d3SJohn MarinoThe idea for this and the original code came from Jason L. Wright.
5886d7f5d3SJohn MarinoThe
5986d7f5d3SJohn Marino.Nm
6086d7f5d3SJohn Marinodevice driver first appeared in
6186d7f5d3SJohn Marino.Fx 5.0 .
6286d7f5d3SJohn Marino.Sh BUGS
6386d7f5d3SJohn MarinoCrypto device drivers must be compiled specially to make use of this driver;
6486d7f5d3SJohn Marinothis should not be necessary.
6586d7f5d3SJohn MarinoThis feature might better be integrated into the
6686d7f5d3SJohn Marino.Xr random 4
6786d7f5d3SJohn Marinosubsystem where it can be used applied to devices that claim to supply
6886d7f5d3SJohn Marino``pure entropy''.
69