diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index a9003d70d6..12c946858a 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -4279,6 +4279,75 @@ qemu-kvm -net nic,model=? /dev/null +
+ The virtual random number generator device allows the host to pass + through entropy to guest operating systems. + Since 1.0.3 +
+ ++ Example: usage of the RNG device: +
++ ... + <devices> + <rng model='virtio'> + <backend model='random'>/dev/random</backend> + <!-- OR --> + <backend model='egd' type='udp'> + <source mode='bind' service='1234'> + <source mode='connect' host='1.2.3.4' service='1234'> + </backend> + </rng> + </devices> + ... ++
model
+ The required model
attribute specifies what type
+ of RNG device is provided. Valid values are specific to
+ the virtualization platform:
+
backend
+ The backend
element specifies the source of entropy
+ to be used for the domain. The source model is configured using the
+ model
attribute. Supported source models are:
+
backend type='random'
+ This backend type expects a non-blocking character device as input.
+ Examples of such devices are /dev/random and /dev/urandom. The file
+ name is specified as contents of the backend
element.
+ When no file name is specified the hypervisor default is used.
+
backend type='egd'
+ This backend connects to a source using the EGD protocol. + The source is specified as a character device. Refer to + character device host interface + for more information. +
+