1b640b928SAlex Hornung.\" Copyright (c) 2010 Konstantin Belousov <kib@FreeBSD.org> 2b640b928SAlex Hornung.\" All rights reserved. 3b640b928SAlex Hornung.\" 4b640b928SAlex Hornung.\" Redistribution and use in source and binary forms, with or without 5b640b928SAlex Hornung.\" modification, are permitted provided that the following conditions 6b640b928SAlex Hornung.\" are met: 7b640b928SAlex Hornung.\" 1. Redistributions of source code must retain the above copyright 8b640b928SAlex Hornung.\" notice, this list of conditions and the following disclaimer. 9b640b928SAlex Hornung.\" 2. Redistributions in binary form must reproduce the above copyright 10b640b928SAlex Hornung.\" notice, this list of conditions and the following disclaimer in the 11b640b928SAlex Hornung.\" documentation and/or other materials provided with the distribution. 12b640b928SAlex Hornung.\" 13b640b928SAlex Hornung.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14b640b928SAlex Hornung.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15b640b928SAlex Hornung.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16b640b928SAlex Hornung.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17b640b928SAlex Hornung.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18b640b928SAlex Hornung.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19b640b928SAlex Hornung.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20b640b928SAlex Hornung.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21b640b928SAlex Hornung.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22b640b928SAlex Hornung.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23b640b928SAlex Hornung.\" SUCH DAMAGE. 24b640b928SAlex Hornung.\" 25b640b928SAlex Hornung.\" $FreeBSD: src/share/man/man4/aesni.4,v 1.3 2010/09/09 21:37:05 brueffer Exp $ 26b640b928SAlex Hornung.\" 27b640b928SAlex Hornung.Dd February 25, 2012 28b640b928SAlex Hornung.Dt RDRAND 4 29b640b928SAlex Hornung.Os 30b640b928SAlex Hornung.Sh NAME 31b640b928SAlex Hornung.Nm rdrand 32b640b928SAlex Hornung.Nd "driver for the RNG module on Intel CPUs" 33b640b928SAlex Hornung.Sh SYNOPSIS 34b640b928SAlex HornungTo compile this driver into the kernel, 35b640b928SAlex Hornungplace the following lines in your 36b640b928SAlex Hornungkernel configuration file: 37b640b928SAlex Hornung.Bd -ragged -offset indent 38b640b928SAlex Hornung.Cd "device rdrand" 39b640b928SAlex Hornung.Ed 40b640b928SAlex Hornung.Pp 41b640b928SAlex HornungAlternatively, to load the driver as a 42b640b928SAlex Hornungmodule at boot time, place the following line in 43b640b928SAlex Hornung.Xr loader.conf 5 : 44b640b928SAlex Hornung.Bd -literal -offset indent 45b640b928SAlex Hornungrdrand_load="YES" 46b640b928SAlex Hornung.Ed 47b640b928SAlex Hornung.Sh DESCRIPTION 4845870e41SAlex HornungWARNING: This driver is still untested. 4945870e41SAlex Hornung.Pp 50b640b928SAlex HornungStarting with some models of the Ivy Bridge Core i5/i7, Intel processors 51b640b928SAlex Hornungimplement a new set of instructions called RdRand. 52b640b928SAlex HornungThis set of instructions uses a hardware based RNG providing 53b640b928SAlex Hornunghigh-speed true randomness. 54b640b928SAlex Hornung.Pp 55b640b928SAlex HornungThe processor capability is reported as RDRND in the Features2 line at boot. 56b640b928SAlex HornungThe 57b640b928SAlex Hornung.Nm 58b640b928SAlex Hornungdriver does not attach on systems that lack the required CPU capability. 59b640b928SAlex Hornung.Pp 60b640b928SAlex HornungThe 61b640b928SAlex Hornung.Nm 627993828eSSascha Wildnerdriver continuously feeds entropy to the kernel's random number generator. 63b640b928SAlex Hornung.Sh SEE ALSO 64b640b928SAlex Hornung.Xr intro 4 , 65b640b928SAlex Hornung.Xr padlock 4 , 66b640b928SAlex Hornung.Xr random 4 67b640b928SAlex Hornung.Sh HISTORY 68b640b928SAlex HornungThe 69b640b928SAlex Hornung.Nm 70b640b928SAlex Hornungdriver first appeared in 71b640b928SAlex Hornung.Dx 3.1 . 72b640b928SAlex Hornung.Sh AUTHORS 73b640b928SAlex Hornung.An -nosplit 74b640b928SAlex HornungThe 75b640b928SAlex Hornung.Nm 76b640b928SAlex Hornungdriver was written by 77*e18a87e3SFranco Fichtner.An Alex Hornung Aq Mt alex@alexhornung.com . 78