1*86d7f5d3SJohn Marino.\"- 2*86d7f5d3SJohn Marino.\" Copyright (c) 2003 Sam Leffler, Errno Consulting 3*86d7f5d3SJohn Marino.\" All rights reserved. 4*86d7f5d3SJohn Marino.\" 5*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without 6*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions 7*86d7f5d3SJohn Marino.\" are met: 8*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright 9*86d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer. 10*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright 11*86d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer in the 12*86d7f5d3SJohn Marino.\" documentation and/or other materials provided with the distribution. 13*86d7f5d3SJohn Marino.\" 14*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15*86d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17*86d7f5d3SJohn Marino.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18*86d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19*86d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20*86d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21*86d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22*86d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23*86d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24*86d7f5d3SJohn Marino.\" SUCH DAMAGE. 25*86d7f5d3SJohn Marino.\" 26*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man4/rndtest.4,v 1.2.4.1 2003/06/04 17:10:30 sam Exp $ 27*86d7f5d3SJohn Marino.\" 28*86d7f5d3SJohn Marino.Dd March 11, 2003 29*86d7f5d3SJohn Marino.Dt RNDTEST 4 30*86d7f5d3SJohn Marino.Os 31*86d7f5d3SJohn Marino.Sh NAME 32*86d7f5d3SJohn Marino.Nm rndtest 33*86d7f5d3SJohn Marino.Nd FIPS 140-2 random number generator test monitor 34*86d7f5d3SJohn Marino.Sh SYNOPSIS 35*86d7f5d3SJohn Marino.Cd device rndtest 36*86d7f5d3SJohn Marino.Sh DESCRIPTION 37*86d7f5d3SJohn MarinoThe 38*86d7f5d3SJohn Marino.Nm 39*86d7f5d3SJohn Marinodriver ``hooks up'' to hardware crypto devices to monitor the 40*86d7f5d3SJohn Marinoentropy data passed to the 41*86d7f5d3SJohn Marino.Xr random 4 42*86d7f5d3SJohn Marinosubsystem. 43*86d7f5d3SJohn MarinoThis data is periodically tested for FIPS 140-2 compliance and 44*86d7f5d3SJohn Marinostatistics are collected. 45*86d7f5d3SJohn MarinoIf the harvested entropy fails any of the FIPS test suite, then 46*86d7f5d3SJohn Marinoit is discarded and testing is continuously applied until ``good data'' 47*86d7f5d3SJohn Marinois received from the device. 48*86d7f5d3SJohn MarinoFailures are optionally reported on the console. 49*86d7f5d3SJohn Marino.Sh SEE ALSO 50*86d7f5d3SJohn Marino.Xr crypto 4 , 51*86d7f5d3SJohn Marino.Xr hifn 4 , 52*86d7f5d3SJohn Marino.Xr random 4 , 53*86d7f5d3SJohn Marino.Xr safe 4 , 54*86d7f5d3SJohn Marino.Xr ubsec 4 , 55*86d7f5d3SJohn Marino.Xr crypto 9 56*86d7f5d3SJohn Marino.Sh HISTORY 57*86d7f5d3SJohn MarinoThe idea for this and the original code came from Jason L. Wright. 58*86d7f5d3SJohn MarinoThe 59*86d7f5d3SJohn Marino.Nm 60*86d7f5d3SJohn Marinodevice driver first appeared in 61*86d7f5d3SJohn Marino.Fx 5.0 . 62*86d7f5d3SJohn Marino.Sh BUGS 63*86d7f5d3SJohn MarinoCrypto device drivers must be compiled specially to make use of this driver; 64*86d7f5d3SJohn Marinothis should not be necessary. 65*86d7f5d3SJohn MarinoThis feature might better be integrated into the 66*86d7f5d3SJohn Marino.Xr random 4 67*86d7f5d3SJohn Marinosubsystem where it can be used applied to devices that claim to supply 68*86d7f5d3SJohn Marino``pure entropy''. 69