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.\" 28*97e25132SJohn Baldwin.Dd May 11, 2020 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 35bc9a9cb4SRuslan Ermilov.Cd "device rndtest" 36d9477962SSam Leffler.Sh DESCRIPTION 37d9477962SSam LefflerThe 38d9477962SSam Leffler.Nm 39bc9a9cb4SRuslan Ermilovdriver 40bc9a9cb4SRuslan Ermilov.Dq "hooks up" 41bc9a9cb4SRuslan Ermilovto hardware crypto devices to monitor the 42d9477962SSam Lefflerentropy data passed to the 43d9477962SSam Leffler.Xr random 4 44d9477962SSam Lefflersubsystem. 45d9477962SSam LefflerThis data is periodically tested for FIPS 140-2 compliance and 46d9477962SSam Lefflerstatistics are collected. 47d9477962SSam LefflerIf the harvested entropy fails any of the FIPS test suite, then 48bc9a9cb4SRuslan Ermilovit is discarded and testing is continuously applied until 49bc9a9cb4SRuslan Ermilov.Dq "good data" 50d9477962SSam Leffleris received from the device. 51d9477962SSam LefflerFailures are optionally reported on the console. 52d9477962SSam Leffler.Sh SEE ALSO 53d9477962SSam Leffler.Xr crypto 4 , 54d9477962SSam Leffler.Xr hifn 4 , 55d9477962SSam Leffler.Xr random 4 , 5603cfc716SChristian Brueffer.Xr safe 4 , 57d9477962SSam Leffler.Xr crypto 9 58d9477962SSam Leffler.Sh HISTORY 59bc9a9cb4SRuslan ErmilovThe idea for this and the original code came from 60bc9a9cb4SRuslan Ermilov.An "Jason L. Wright" . 61d9477962SSam LefflerThe 62d9477962SSam Leffler.Nm 63d9477962SSam Lefflerdevice driver first appeared in 64d9477962SSam Leffler.Fx 5.0 . 65d9477962SSam Leffler.Sh BUGS 66d9477962SSam LefflerCrypto device drivers must be compiled specially to make use of this driver; 67d9477962SSam Lefflerthis should not be necessary. 68d9477962SSam LefflerThis feature might better be integrated into the 69d9477962SSam Leffler.Xr random 4 7003cfc716SChristian Brueffersubsystem where it can be applied to devices that claim to supply 71bc9a9cb4SRuslan Ermilov.Dq "pure entropy" . 72