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