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.\" 26*97e25132SJohn Baldwin.Dd May 11, 2020 27d9477962SSam Leffler.Dt RNDTEST 4 28d9477962SSam Leffler.Os 29d9477962SSam Leffler.Sh NAME 30d9477962SSam Leffler.Nm rndtest 31d9477962SSam Leffler.Nd FIPS 140-2 random number generator test monitor 32d9477962SSam Leffler.Sh SYNOPSIS 33bc9a9cb4SRuslan Ermilov.Cd "device rndtest" 34d9477962SSam Leffler.Sh DESCRIPTION 35d9477962SSam LefflerThe 36d9477962SSam Leffler.Nm 37bc9a9cb4SRuslan Ermilovdriver 38bc9a9cb4SRuslan Ermilov.Dq "hooks up" 39bc9a9cb4SRuslan Ermilovto 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 46bc9a9cb4SRuslan Ermilovit is discarded and testing is continuously applied until 47bc9a9cb4SRuslan Ermilov.Dq "good data" 48d9477962SSam Leffleris received from the device. 49d9477962SSam LefflerFailures are optionally reported on the console. 50d9477962SSam Leffler.Sh SEE ALSO 51d9477962SSam Leffler.Xr crypto 4 , 52d9477962SSam Leffler.Xr hifn 4 , 53d9477962SSam Leffler.Xr random 4 , 5403cfc716SChristian Brueffer.Xr safe 4 , 55d9477962SSam Leffler.Xr crypto 9 56d9477962SSam Leffler.Sh HISTORY 57bc9a9cb4SRuslan ErmilovThe idea for this and the original code came from 58bc9a9cb4SRuslan Ermilov.An "Jason L. Wright" . 59d9477962SSam LefflerThe 60d9477962SSam Leffler.Nm 61d9477962SSam Lefflerdevice driver first appeared in 62d9477962SSam Leffler.Fx 5.0 . 63d9477962SSam Leffler.Sh BUGS 64d9477962SSam LefflerCrypto device drivers must be compiled specially to make use of this driver; 65d9477962SSam Lefflerthis should not be necessary. 66d9477962SSam LefflerThis feature might better be integrated into the 67d9477962SSam Leffler.Xr random 4 6803cfc716SChristian Brueffersubsystem where it can be applied to devices that claim to supply 69bc9a9cb4SRuslan Ermilov.Dq "pure entropy" . 70