xref: /freebsd-src/share/man/man4/virtio_random.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
110c40180SBryan Venteicher.\" Copyright (c) 2013 Bryan Venteicher
210c40180SBryan Venteicher.\" All rights reserved.
310c40180SBryan Venteicher.\"
410c40180SBryan Venteicher.\" Redistribution and use in source and binary forms, with or without
510c40180SBryan Venteicher.\" modification, are permitted provided that the following conditions
610c40180SBryan Venteicher.\" are met:
710c40180SBryan Venteicher.\" 1. Redistributions of source code must retain the above copyright
810c40180SBryan Venteicher.\"    notice, this list of conditions and the following disclaimer.
910c40180SBryan Venteicher.\" 2. Redistributions in binary form must reproduce the above copyright
1010c40180SBryan Venteicher.\"    notice, this list of conditions and the following disclaimer in the
1110c40180SBryan Venteicher.\"    documentation and/or other materials provided with the distribution.
1210c40180SBryan Venteicher.\"
1310c40180SBryan Venteicher.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1410c40180SBryan Venteicher.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1510c40180SBryan Venteicher.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1610c40180SBryan Venteicher.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1710c40180SBryan Venteicher.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1810c40180SBryan Venteicher.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
1910c40180SBryan Venteicher.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2010c40180SBryan Venteicher.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2110c40180SBryan Venteicher.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2210c40180SBryan Venteicher.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2310c40180SBryan Venteicher.\" SUCH DAMAGE.
2410c40180SBryan Venteicher.\"
2510c40180SBryan Venteicher.Dd December 28, 2013
2610c40180SBryan Venteicher.Dt VIRTIO_RANDOM 4
2710c40180SBryan Venteicher.Os
2810c40180SBryan Venteicher.Sh NAME
2910c40180SBryan Venteicher.Nm virtio_random
3010c40180SBryan Venteicher.Nd VirtIO Entropy driver
3110c40180SBryan Venteicher.Sh SYNOPSIS
3210c40180SBryan VenteicherTo compile this driver into the kernel,
3310c40180SBryan Venteicherplace the following lines in your
3410c40180SBryan Venteicherkernel configuration file:
3510c40180SBryan Venteicher.Bd -ragged -offset indent
3610c40180SBryan Venteicher.Cd "device virtio_random"
3710c40180SBryan Venteicher.Ed
3810c40180SBryan Venteicher.Pp
3910c40180SBryan VenteicherAlternatively, to load the driver as a
4010c40180SBryan Venteichermodule at boot time, place the following line in
4110c40180SBryan Venteicher.Xr loader.conf 5 :
4210c40180SBryan Venteicher.Bd -literal -offset indent
4310c40180SBryan Venteichervirtio_random_load="YES"
4410c40180SBryan Venteicher.Ed
4510c40180SBryan Venteicher.Sh DESCRIPTION
4610c40180SBryan VenteicherThe
4710c40180SBryan Venteicher.Nm
4810c40180SBryan Venteicherdevice driver provides support for VirtIO entropy devices.
4910c40180SBryan Venteicher.Pp
5010c40180SBryan VenteicherThe entropy device supplies high-quality randomness from the
5110c40180SBryan Venteicherhypervisor to the guest.
5210c40180SBryan Venteicher.Sh SEE ALSO
53*0b3504fdSChristian Brueffer.Xr random 4 ,
5410c40180SBryan Venteicher.Xr virtio 4
5510c40180SBryan Venteicher.Sh HISTORY
5610c40180SBryan VenteicherThe
5710c40180SBryan Venteicher.Nm
5810c40180SBryan Venteicherdriver was written by
596c899950SBaptiste Daroussin.An Bryan Venteicher Aq Mt bryanv@FreeBSD.org .
60