xref: /dflybsd-src/share/man/man4/virtio_random.4 (revision 0625343f0e53be7c02f32c09deed7565e5bee953)
1*0625343fSSascha Wildner.\" Copyright (c) 2013 Bryan Venteicher
2*0625343fSSascha Wildner.\" All rights reserved.
3*0625343fSSascha Wildner.\"
4*0625343fSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
5*0625343fSSascha Wildner.\" modification, are permitted provided that the following conditions
6*0625343fSSascha Wildner.\" are met:
7*0625343fSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
8*0625343fSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
9*0625343fSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
10*0625343fSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
11*0625343fSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
12*0625343fSSascha Wildner.\"
13*0625343fSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14*0625343fSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*0625343fSSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*0625343fSSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17*0625343fSSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*0625343fSSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*0625343fSSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*0625343fSSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*0625343fSSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*0625343fSSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*0625343fSSascha Wildner.\" SUCH DAMAGE.
24*0625343fSSascha Wildner.\"
25*0625343fSSascha Wildner.\" $FreeBSD: head/share/man/man4/virtio_random.4 275990 2014-12-21 09:53:29Z brueffer $
26*0625343fSSascha Wildner.\"
27*0625343fSSascha Wildner.Dd September 30, 2018
28*0625343fSSascha Wildner.Dt VIRTIO_RANDOM 4
29*0625343fSSascha Wildner.Os
30*0625343fSSascha Wildner.Sh NAME
31*0625343fSSascha Wildner.Nm virtio_random
32*0625343fSSascha Wildner.Nd VirtIO Entropy driver
33*0625343fSSascha Wildner.Sh SYNOPSIS
34*0625343fSSascha WildnerTo compile this driver into the kernel,
35*0625343fSSascha Wildnerplace the following lines in your
36*0625343fSSascha Wildnerkernel configuration file:
37*0625343fSSascha Wildner.Bd -ragged -offset indent
38*0625343fSSascha Wildner.Cd "device virtio_random"
39*0625343fSSascha Wildner.Ed
40*0625343fSSascha Wildner.Pp
41*0625343fSSascha WildnerAlternatively, to load the driver as a
42*0625343fSSascha Wildnermodule at boot time, place the following line in
43*0625343fSSascha Wildner.Xr loader.conf 5 :
44*0625343fSSascha Wildner.Bd -literal -offset indent
45*0625343fSSascha Wildnervirtio_random_load="YES"
46*0625343fSSascha Wildner.Ed
47*0625343fSSascha Wildner.Sh DESCRIPTION
48*0625343fSSascha WildnerThe
49*0625343fSSascha Wildner.Nm
50*0625343fSSascha Wildnerdevice driver provides support for VirtIO entropy devices.
51*0625343fSSascha Wildner.Pp
52*0625343fSSascha WildnerThe entropy device supplies high-quality randomness from the
53*0625343fSSascha Wildnerhypervisor to the guest.
54*0625343fSSascha Wildner.Pp
55*0625343fSSascha WildnerSee the URL in
56*0625343fSSascha Wildner.Sx SEE ALSO
57*0625343fSSascha Wildnerfor some instrunctions on how to test the
58*0625343fSSascha Wildner.Nm
59*0625343fSSascha Wildnerdriver.
60*0625343fSSascha Wildner.Sh SEE ALSO
61*0625343fSSascha Wildner.Xr random 4 ,
62*0625343fSSascha Wildner.Xr virtio 4
63*0625343fSSascha Wildner.Pp
64*0625343fSSascha Wildner.Pa https://fedoraproject.org/wiki/QA:Testcase_Virtualization_VirtioRNG
65*0625343fSSascha Wildner.Sh HISTORY
66*0625343fSSascha WildnerThe
67*0625343fSSascha Wildner.Nm
68*0625343fSSascha Wildnerdriver was written by
69*0625343fSSascha Wildner.An Bryan Venteicher Aq Mt bryanv@FreeBSD.org .
70