NuKVM/libvirt
3
0
Fork 0
mirror of https://github.com/libvirt/libvirt.git synced 2025-02-25 18:55:26 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs: Fix some formatting oddities

Browse Source 
When describing attributes and elements, we mostly stick to
a certain pattern; however, there are a few cases when the
information is not presented in the usual way.

Since there doesn't seem to be any reason not to follow the
tried and true formula, rework those bits to fit the rest of
the documentation.
This commit is contained in:
Andrea Bolognani 2016-04-22 13:51:50 +02:00
parent 1f29f3da06
commit 7867c579ea
2 changed files with 105 additions and 95 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

165
docs/formatdomain.html.in
View File

@ -2013,20 +2013,19 @@
<dl> <dl>
<dt><code>disk</code></dt> <dt><code>disk</code></dt>
<dd>The <code>disk</code> element is the main container for describing <dd>The <code>disk</code> element is the main container for
disks (<span class="since">since 0.0.3</span>). describing disks and supports the following attributes:
<dl> <dl>
<dt><code>type</code> attribute <dt><code>type</code></dt>
<span class="since">since 0.0.3</span></dt>
<dd> <dd>
Valid values are "file", "block", Valid values are "file", "block",
"dir" (<span class="since">since 0.7.5</span>), "dir" (<span class="since">since 0.7.5</span>),
"network" (<span class="since">since 0.8.7</span>), or "network" (<span class="since">since 0.8.7</span>), or
"volume" (<span class="since">since 1.0.5</span>) "volume" (<span class="since">since 1.0.5</span>)
and refer to the underlying source for the disk. and refer to the underlying source for the disk.
<span class="since">Since 0.0.3</span>
</dd> </dd>
<dt><code>device</code> attribute <dt><code>device</code></dt>
<span class="since">since 0.1.4</span></dt>
<dd> <dd>
Indicates how the disk is to be exposed to the guest OS. Possible Indicates how the disk is to be exposed to the guest OS. Possible
values for this attribute are "floppy", "disk", "cdrom", and "lun", values for this attribute are "floppy", "disk", "cdrom", and "lun",
@ -2046,10 +2045,10 @@
but never for individual partitions or LVM partitions (in those but never for individual partitions or LVM partitions (in those
cases, the kernel will reject the generic SCSI commands, making cases, the kernel will reject the generic SCSI commands, making
it identical to device='disk'). it identical to device='disk').
<span class="since">Since 0.1.4</span>
</p> </p>
</dd> </dd>
<dt><code>rawio</code> attribute <dt><code>rawio</code></dt>
<span class="since">since 0.9.10</span></dt>
<dd> <dd>
Indicates whether the disk needs rawio capability. Valid Indicates whether the disk needs rawio capability. Valid
settings are "yes" or "no" (default is "no"). If any one disk settings are "yes" or "no" (default is "no"). If any one disk
@ -2063,17 +2062,17 @@
To confine the capability as much as possible for QEMU driver To confine the capability as much as possible for QEMU driver
as this stage, <code>sgio</code> is recommended, it's more as this stage, <code>sgio</code> is recommended, it's more
secure than <code>rawio</code>. secure than <code>rawio</code>.
<span class="since">Since 0.9.10</span>
</dd> </dd>
<dt><code>sgio</code> attribute <dt><code>sgio</code></dt>
<span class="since">since 1.0.2</span></dt>
<dd> <dd>
If supported by the hypervisor and OS, indicates whether If supported by the hypervisor and OS, indicates whether
unprivileged SG_IO commands are filtered for the disk. Valid unprivileged SG_IO commands are filtered for the disk. Valid
settings are "filtered" or "unfiltered" where the default is settings are "filtered" or "unfiltered" where the default is
"filtered". Only available when the <code>device</code> is 'lun'. "filtered". Only available when the <code>device</code> is 'lun'.
<span class="since">Since 1.0.2</span>
</dd> </dd>
<dt><code>snapshot</code> attribute <dt><code>snapshot</code></dt>
<span class="since">since 0.9.5</span></dt>
<dd> <dd>
Indicates the default behavior of the disk during disk snapshots: Indicates the default behavior of the disk during disk snapshots:
"internal" requires a file format such as qcow2 that can store "internal" requires a file format such as qcow2 that can store
@ -2087,6 +2086,7 @@
Not all snapshot modes are supported; for example, Not all snapshot modes are supported; for example,
<code>snapshot='yes'</code> with a transient disk generally <code>snapshot='yes'</code> with a transient disk generally
does not make sense. does not make sense.
<span class="since">Since 0.9.5</span>
</dd> </dd>
</dl> </dl>
</dd> </dd>
@ -2094,26 +2094,25 @@
<dd>Representation of the disk <code>source</code> depends on the <dd>Representation of the disk <code>source</code> depends on the
disk <code>type</code> attribute value as follows: disk <code>type</code> attribute value as follows:
<dl> <dl>
<dt><code>type='file'</code> <dt><code>file</code></dt>
<span class="since">since 0.0.3</span></dt>
<dd> <dd>
The <code>file</code> attribute specifies the fully-qualified The <code>file</code> attribute specifies the fully-qualified
path to the file holding the disk. path to the file holding the disk.
<span class="since">Since 0.0.3</span>
</dd> </dd>
<dt><code>type='block'</code> <dt><code>block</code></dt>
<span class="since">since 0.0.3</span></dt>
<dd> <dd>
The <code>dev</code> attribute specifies the fully-qualified path The <code>dev</code> attribute specifies the fully-qualified path
to the host device to serve as the disk. to the host device to serve as the disk.
<span class="since">Since 0.0.3</span>
</dd> </dd>
<dt><code>type='dir'</code> <dt><code>dir</code></dt>
<span class="since">since 0.7.5</span></dt>
<dd> <dd>
The <code>dir</code> attribute specifies the fully-qualified path The <code>dir</code> attribute specifies the fully-qualified path
to the directory to use as the disk. to the directory to use as the disk.
<span class="since">Since 0.7.5</span>
</dd> </dd>
<dt><code>type='network'</code> <dt><code>network</code></dt>
<span class="since">since 0.8.7</span></dt>
<dd> <dd>
The <code>protocol</code> attribute specifies the protocol to The <code>protocol</code> attribute specifies the protocol to
access to the requested image. Possible values are "nbd", access to the requested image. Possible values are "nbd",
@ -2127,9 +2126,9 @@
target's name by a slash (e.g., target's name by a slash (e.g.,
<code>iqn.2013-07.com.example:iscsi-pool/1</code>). If not <code>iqn.2013-07.com.example:iscsi-pool/1</code>). If not
specified, the default LUN is zero. specified, the default LUN is zero.
<span class="since">Since 0.8.7</span>
</dd> </dd>
<dt><code>type='volume'</code> <dt><code>volume</code></dt>
<span class="since">since 1.0.5</span></dt>
<dd> <dd>
The underlying disk source is represented by attributes The underlying disk source is represented by attributes
<code>pool</code> and <code>volume</code>. Attribute <code>pool</code> and <code>volume</code>. Attribute
@ -2163,6 +2162,7 @@
of 'lun' with respect to how the LUN is presented to and of 'lun' with respect to how the LUN is presented to and
may used by the guest. may used by the guest.
<span class="since">Since 1.0.5</span>
</p> </p>
</dd> </dd>
</dl> </dl>
@ -2303,16 +2303,16 @@
each file of the chain (files created by libvirt satisfy this each file of the chain (files created by libvirt satisfy this
property, but using existing external files for snapshot or property, but using existing external files for snapshot or
block copy operations requires the end user to pre-create the block copy operations requires the end user to pre-create the
file correctly). The following attributes and sub-elements are file correctly). The following attributes are
supported in <code>backingStore</code>: supported in <code>backingStore</code>:
<dl> <dl>
<dt><code>type</code> attribute</dt> <dt><code>type</code></dt>
<dd> <dd>
The <code>type</code> attribute represents the type of disk used The <code>type</code> attribute represents the type of disk used
by the backing store, see disk type attribute above for more by the backing store, see disk type attribute above for more
details and possible values. details and possible values.
</dd> </dd>
<dt><code>index</code> attribute</dt> <dt><code>index</code></dt>
<dd> <dd>
This attribute is only valid in output (and ignored on input) and This attribute is only valid in output (and ignored on input) and
it can be used to refer to a specific part of the disk chain when it can be used to refer to a specific part of the disk chain when
@ -2321,20 +2321,23 @@
<code>vda[2]</code> refers to the backing store with <code>vda[2]</code> refers to the backing store with
<code>index='2'</code> of the disk with <code>vda</code> target. <code>index='2'</code> of the disk with <code>vda</code> target.
</dd> </dd>
<dt><code>format</code> sub-element</dt> </dl>
Moreover, <code>backingStore</code> supports the following sub-elements:
<dl>
<dt><code>format</code></dt>
<dd> <dd>
The <code>format</code> element contains <code>type</code> The <code>format</code> element contains <code>type</code>
attribute which specifies the internal format of the backing attribute which specifies the internal format of the backing
store, such as <code>raw</code> or <code>qcow2</code>. store, such as <code>raw</code> or <code>qcow2</code>.
</dd> </dd>
<dt><code>source</code> sub-element</dt> <dt><code>source</code></dt>
<dd> <dd>
This element has the same structure as the <code>source</code> This element has the same structure as the <code>source</code>
element in <code>disk</code>. It specifies which file, device, element in <code>disk</code>. It specifies which file, device,
or network location contains the data of the described backing or network location contains the data of the described backing
store. store.
</dd> </dd>
<dt><code>backingStore</code> sub-element</dt> <dt><code>backingStore</code></dt>
<dd> <dd>
If the backing store is not self-contained, the next element If the backing store is not self-contained, the next element
in the chain is described by nested <code>backingStore</code> in the chain is described by nested <code>backingStore</code>
@ -2745,7 +2748,7 @@
<code>source</code>. The possible values are: <code>source</code>. The possible values are:
<dl> <dl>
<dt><code>type='mount'</code></dt> <dt><code>mount</code></dt>
<dd> <dd>
A host directory to mount in the guest. Used by LXC, A host directory to mount in the guest. Used by LXC,
OpenVZ <span class="since">(since 0.6.2)</span> OpenVZ <span class="since">(since 0.6.2)</span>
@ -2762,23 +2765,23 @@
is immediately triggered for all pages touched during a guest file is immediately triggered for all pages touched during a guest file
write operation <span class="since">(since 0.9.10)</span>. write operation <span class="since">(since 0.9.10)</span>.
</dd> </dd>
<dt><code>type='template'</code></dt> <dt><code>template</code></dt>
<dd> <dd>
OpenVZ filesystem template. Only used by OpenVZ driver. OpenVZ filesystem template. Only used by OpenVZ driver.
</dd> </dd>
<dt><code>type='file'</code></dt> <dt><code>file</code></dt>
<dd> <dd>
A host file will be treated as an image and mounted in A host file will be treated as an image and mounted in
the guest. The filesystem format will be autodetected. the guest. The filesystem format will be autodetected.
Only used by LXC driver. Only used by LXC driver.
</dd> </dd>
<dt><code>type='block'</code></dt> <dt><code>block</code></dt>
<dd> <dd>
A host block device to mount in the guest. The filesystem A host block device to mount in the guest. The filesystem
format will be autodetected. Only used by LXC driver format will be autodetected. Only used by LXC driver
<span class="since">(since 0.9.5)</span>. <span class="since">(since 0.9.5)</span>.
</dd> </dd>
<dt><code>type='ram'</code></dt> <dt><code>ram</code></dt>
<dd> <dd>
An in-memory filesystem, using memory from the host OS. An in-memory filesystem, using memory from the host OS.
The source element has a single attribute <code>usage</code> The source element has a single attribute <code>usage</code>
@ -2786,7 +2789,7 @@
are specified by the <code>units</code> attribute. Only used are specified by the <code>units</code> attribute. Only used
by LXC driver. by LXC driver.
<span class="since"> (since 0.9.13)</span></dd> <span class="since"> (since 0.9.13)</span></dd>
<dt><code>type='bind'</code></dt> <dt><code>bind</code></dt>
<dd> <dd>
A directory inside the guest will be bound to another A directory inside the guest will be bound to another
directory inside the guest. Only used by LXC driver directory inside the guest. Only used by LXC driver
@ -2800,20 +2803,20 @@
values are: values are:
<dl> <dl>
<dt><code>accessmode='passthrough'</code></dt> <dt><code>passthrough</code></dt>
<dd> <dd>
The <code>source</code> is accessed with the permissions of the The <code>source</code> is accessed with the permissions of the
user inside the guest. This is the default <code>accessmode</code> if user inside the guest. This is the default <code>accessmode</code> if
one is not specified. one is not specified.
<a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a> <a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a>
</dd> </dd>
<dt><code>accessmode='mapped'</code></dt> <dt><code>mapped</code></dt>
<dd> <dd>
The <code>source</code> is accessed with the permissions of the The <code>source</code> is accessed with the permissions of the
hypervisor (QEMU process). hypervisor (QEMU process).
<a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a> <a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a>
</dd> </dd>
<dt><code>accessmode='squash'</code></dt> <dt><code>squash</code></dt>
<dd> <dd>
Similar to 'passthrough', the exception is that failure of Similar to 'passthrough', the exception is that failure of
privileged operations like 'chown' are ignored. This makes a privileged operations like 'chown' are ignored. This makes a
@ -2912,7 +2915,7 @@
</p> </p>
<dl> <dl>
<dt><code>type='pci'</code></dt> <dt><code>pci</code></dt>
<dd>PCI addresses have the following additional <dd>PCI addresses have the following additional
attributes: <code>domain</code> (a 2-byte hex integer, not attributes: <code>domain</code> (a 2-byte hex integer, not
currently used by qemu), <code>bus</code> (a hex value between currently used by qemu), <code>bus</code> (a hex value between
@ -2927,32 +2930,32 @@
but should be set to 'on' for function 0 of a slot that will but should be set to 'on' for function 0 of a slot that will
have multiple functions used. have multiple functions used.
</dd> </dd>
<dt><code>type='drive'</code></dt> <dt><code>drive</code></dt>
<dd>Drive addresses have the following additional <dd>Drive addresses have the following additional
attributes: <code>controller</code> (a 2-digit controller attributes: <code>controller</code> (a 2-digit controller
number), <code>bus</code> (a 2-digit bus number), number), <code>bus</code> (a 2-digit bus number),
<code>target</code> (a 2-digit target number), <code>target</code> (a 2-digit target number),
and <code>unit</code> (a 2-digit unit number on the bus). and <code>unit</code> (a 2-digit unit number on the bus).
</dd> </dd>
<dt><code>type='virtio-serial'</code></dt> <dt><code>virtio-serial</code></dt>
<dd>Each virtio-serial address has the following additional <dd>Each virtio-serial address has the following additional
attributes: <code>controller</code> (a 2-digit controller attributes: <code>controller</code> (a 2-digit controller
number), <code>bus</code> (a 2-digit bus number), number), <code>bus</code> (a 2-digit bus number),
and <code>slot</code> (a 2-digit slot within the bus). and <code>slot</code> (a 2-digit slot within the bus).
</dd> </dd>
<dt><code>type='ccid'</code></dt> <dt><code>ccid</code></dt>
<dd>A CCID address, for smart-cards, has the following <dd>A CCID address, for smart-cards, has the following
additional attributes: <code>bus</code> (a 2-digit bus additional attributes: <code>bus</code> (a 2-digit bus
number), and <code>slot</code> attribute (a 2-digit slot number), and <code>slot</code> attribute (a 2-digit slot
within the bus). <span class="since">Since 0.8.8.</span> within the bus). <span class="since">Since 0.8.8.</span>
</dd> </dd>
<dt><code>type='usb'</code></dt> <dt><code>usb</code></dt>
<dd>USB addresses have the following additional <dd>USB addresses have the following additional
attributes: <code>bus</code> (a hex value between 0 and 0xfff, attributes: <code>bus</code> (a hex value between 0 and 0xfff,
inclusive), and <code>port</code> (a dotted notation of up to inclusive), and <code>port</code> (a dotted notation of up to
four octets, such as 1.2 or 2.1.3.1). four octets, such as 1.2 or 2.1.3.1).
</dd> </dd>
<dt><code>type='spapr-vio'</code></dt> <dt><code>spapr-vio</code></dt>
<dd>On PowerPC pseries guests, devices can be assigned to the <dd>On PowerPC pseries guests, devices can be assigned to the
SPAPR-VIO bus. It has a flat 64-bit address space; by SPAPR-VIO bus. It has a flat 64-bit address space; by
convention, devices are generally assigned at a non-zero convention, devices are generally assigned at a non-zero
@ -2962,7 +2965,7 @@
of the starting register). <span class="since">Since of the starting register). <span class="since">Since
0.9.9.</span> 0.9.9.</span>
</dd> </dd>
<dt><code>type='ccw'</code></dt> <dt><code>ccw</code></dt>
<dd>s390 guests with a <code>machine</code> value of <dd>s390 guests with a <code>machine</code> value of
s390-ccw-virtio use the native CCW bus for I/O devices. s390-ccw-virtio use the native CCW bus for I/O devices.
CCW bus addresses have the following additional attributes: CCW bus addresses have the following additional attributes:
@ -2975,7 +2978,7 @@
set to 0xfe. set to 0xfe.
<span class="since">Since 1.0.4</span> <span class="since">Since 1.0.4</span>
</dd> </dd>
<dt><code>type='isa'</code></dt> <dt><code>isa</code></dt>
<dd>ISA addresses have the following additional <dd>ISA addresses have the following additional
attributes: <code>iobase</code> and <code>irq</code>. attributes: <code>iobase</code> and <code>irq</code>.
<span class="since">Since 1.2.1</span> <span class="since">Since 1.2.1</span>
@ -3210,7 +3213,7 @@
downstream-port). downstream-port).
</p> </p>
</dd> </dd>
<dt><code>&lt;node&gt;</code></dt> <dt><code>node</code></dt>
<dd> <dd>
pci-expander-bus controllers can have an pci-expander-bus controllers can have an
optional <code>&lt;node&gt;</code> subelement within optional <code>&lt;node&gt;</code> subelement within
@ -3772,14 +3775,14 @@
</p> </p>
<dl> <dl>
<dt><code>mode='host'</code></dt> <dt><code>host</code></dt>
<dd>The simplest operation, where the hypervisor relays all <dd>The simplest operation, where the hypervisor relays all
requests from the guest into direct access to the host's requests from the guest into direct access to the host's
smartcard via NSS. No other attributes or sub-elements are smartcard via NSS. No other attributes or sub-elements are
required. See below about the use of an required. See below about the use of an
optional <code>&lt;address&gt;</code> sub-element.</dd> optional <code>&lt;address&gt;</code> sub-element.</dd>
<dt><code>mode='host-certificates'</code></dt> <dt><code>host-certificates</code></dt>
<dd>Rather than requiring a smartcard to be plugged into the <dd>Rather than requiring a smartcard to be plugged into the
host, it is possible to provide three NSS certificate names host, it is possible to provide three NSS certificate names
residing in a database on the host. These certificates can be residing in a database on the host. These certificates can be
@ -3793,7 +3796,7 @@
when creating the certificates); if not present, it defaults to when creating the certificates); if not present, it defaults to
/etc/pki/nssdb.</dd> /etc/pki/nssdb.</dd>
<dt><code>mode='passthrough'</code></dt> <dt><code>passthrough</code></dt>
<dd>Rather than having the hypervisor directly communicate with <dd>Rather than having the hypervisor directly communicate with
the host, it is possible to tunnel all requests through a the host, it is possible to tunnel all requests through a
secondary character device to a third-party provider (which may secondary character device to a third-party provider (which may
@ -4557,7 +4560,13 @@ qemu-kvm -net nic,model=? /dev/null
<span class="since">virtio-net since 1.0.6 (QEMU and KVM only)</span> <span class="since">virtio-net since 1.0.6 (QEMU and KVM only)</span>
<span class="since">vhost-user since 1.2.17 (QEMU and KVM only)</span> <span class="since">vhost-user since 1.2.17 (QEMU and KVM only)</span>
</dd> </dd>
<dt><code>host</code> offloading options</dt> </dl>
<p>
Offloading options for the host and guest can be configured using
the following sub-elements:
</p>
<dl>
<dt><code>host</code></dt>
<dd> <dd>
The <code>csum</code>, <code>gso</code>, <code>tso4</code>, The <code>csum</code>, <code>gso</code>, <code>tso4</code>,
<code>tso6</code>, <code>ecn</code> and <code>ufo</code> <code>tso6</code>, <code>ecn</code> and <code>ufo</code>
@ -4570,7 +4579,7 @@ qemu-kvm -net nic,model=? /dev/null
<code>on</code> (default) and <code>off</code>. <code>on</code> (default) and <code>off</code>.
<span class="since">Since 1.2.13 (QEMU only)</span> <span class="since">Since 1.2.13 (QEMU only)</span>
</dd> </dd>
<dt><code>guest</code> offloading options</dt> <dt><code>guest</code></dt>
<dd> <dd>
The <code>csum</code>, <code>tso4</code>, The <code>csum</code>, <code>tso4</code>,
<code>tso6</code>, <code>ecn</code> and <code>ufo</code> <code>tso6</code>, <code>ecn</code> and <code>ufo</code>
@ -5059,7 +5068,7 @@ qemu-kvm -net nic,model=? /dev/null
<code>spice</code>, <code>rdp</code> or <code>desktop</code>: <code>spice</code>, <code>rdp</code> or <code>desktop</code>:
</p> </p>
<dl> <dl>
<dt><code>"sdl"</code></dt> <dt><code>sdl</code></dt>
<dd> <dd>
<p> <p>
This displays a window on the host desktop, it can take 3 optional This displays a window on the host desktop, it can take 3 optional
@ -5069,7 +5078,7 @@ qemu-kvm -net nic,model=? /dev/null
<code>yes</code> or <code>no</code>. <code>yes</code> or <code>no</code>.
</p> </p>
</dd> </dd>
<dt><code>"vnc"</code></dt> <dt><code>vnc</code></dt>
<dd> <dd>
<p> <p>
Starts a VNC server. The <code>port</code> attribute specifies Starts a VNC server. The <code>port</code> attribute specifies
@ -5110,7 +5119,7 @@ qemu-kvm -net nic,model=? /dev/null
security reasons) <span class="since">Since 1.0.6</span>. security reasons) <span class="since">Since 1.0.6</span>.
</p> </p>
</dd> </dd>
<dt><code>"spice"</code> <span class="since">Since 0.8.6</span></dt> <dt><code>spice</code> <span class="since">Since 0.8.6</span></dt>
<dd> <dd>
<p> <p>
Starts a SPICE server. The <code>port</code> attribute specifies Starts a SPICE server. The <code>port</code> attribute specifies
@ -5216,7 +5225,7 @@ qemu-kvm -net nic,model=? /dev/null
property. (QEMU only, <span class="since">since 1.3.2</span>). property. (QEMU only, <span class="since">since 1.3.2</span>).
</p> </p>
</dd> </dd>
<dt><code>"rdp"</code></dt> <dt><code>rdp</code></dt>
<dd> <dd>
<p> <p>
Starts a RDP server. The <code>port</code> attribute specifies the Starts a RDP server. The <code>port</code> attribute specifies the
@ -5231,7 +5240,7 @@ qemu-kvm -net nic,model=? /dev/null
single connection mode. single connection mode.
</p> </p>
</dd> </dd>
<dt><code>"desktop"</code></dt> <dt><code>desktop</code></dt>
<dd> <dd>
<p> <p>
This value is reserved for VirtualBox domains for the moment. It This value is reserved for VirtualBox domains for the moment. It
@ -6230,22 +6239,18 @@ qemu-kvm -net nic,model=? /dev/null
to be used for the domain. The source model is configured using the to be used for the domain. The source model is configured using the
<code>model</code> attribute. Supported source models are: <code>model</code> attribute. Supported source models are:
</p> </p>
<ul> <dl>
<li>'random' &mdash; /dev/random (default) or /dev/hwrng <dt><code>random</code></dt>
device as source (for now, no other sources are permitted)</li>
<li>'egd' &mdash; a EGD protocol backend</li>
</ul>
</dd>
<dt><code>backend model='random'</code></dt>
<dd> <dd>
<p> <p>
This backend type expects a non-blocking character device as input. This backend type expects a non-blocking character device as
The only accepted paths are /dev/random and /dev/hwrng. The file input. The only accepted paths are /dev/random and /dev/hwrng.
name is specified as contents of the <code>backend</code> element. The file name is specified as contents of the
When no file name is specified the hypervisor default is used. <code>backend</code> element. When no file name is specified
the hypervisor default is used.
</p> </p>
</dd> </dd>
<dt><code>backend model='egd'</code></dt> <dt><code>egd</code></dt>
<dd> <dd>
<p> <p>
This backend connects to a source using the EGD protocol. This backend connects to a source using the EGD protocol.
@ -6254,6 +6259,8 @@ qemu-kvm -net nic,model=? /dev/null
for more information. for more information.
</p> </p>
</dd> </dd>
</dl>
</dd>
</dl> </dl>
@ -6299,19 +6306,21 @@ qemu-kvm -net nic,model=? /dev/null
The <code>backend</code> element specifies the type of The <code>backend</code> element specifies the type of
TPM device. The following types are supported: TPM device. The following types are supported:
</p> </p>
<ul> <dl>
<li>'passthrough' &mdash; use the host's TPM device.</li> <dt><code>passthrough</code></dt>
</ul>
</dd>
<dt><code>backend type='passthrough'</code></dt>
<dd> <dd>
<p> <p>
This backend type requires exclusive access to a TPM device on Use the host's TPM device.
the host.
An example for such a device is /dev/tpm0. The fully qualified file
name is specified by path attribute of the <code>source</code> element.
If no file name is specified then /dev/tpm0 is automatically used.
</p> </p>
<p>
This backend type requires exclusive access to a TPM device on
the host. An example for such a device is /dev/tpm0. The fully
qualified file name is specified by path attribute of the
<code>source</code> element. If no file name is specified then
/dev/tpm0 is automatically used.
</p>
</dd>
</dl>
</dd> </dd>
</dl> </dl>

7
docs/formatnetwork.html.in
View File

@ -54,13 +54,14 @@
The format must be RFC 4122 compliant, eg <code>3e3fce45-4f53-4fa7-bb32-11f34168b82b</code>. The format must be RFC 4122 compliant, eg <code>3e3fce45-4f53-4fa7-bb32-11f34168b82b</code>.
If omitted when defining/creating a new network, a random If omitted when defining/creating a new network, a random
UUID is generated. <span class="since">Since 0.3.0</span></dd> UUID is generated. <span class="since">Since 0.3.0</span></dd>
<dt><code>ipv6='yes'</code></dt> <dt><code>ipv6</code></dt>
<dd>The new, optional parameter <code>ipv6='yes'</code> enables <dd>When set to <code>yes</code>, the optional parameter
<code>ipv6</code> enables
a network definition with no IPv6 gateway addresses specified a network definition with no IPv6 gateway addresses specified
to have guest-to-guest communications. For further information, to have guest-to-guest communications. For further information,
see the example below for the example with no gateway addresses. see the example below for the example with no gateway addresses.
<span class="since">Since 1.0.1</span></dd> <span class="since">Since 1.0.1</span></dd>
<dt><code>trustGuestRxFilters='yes'</code></dt> <dt><code>trustGuestRxFilters</code></dt>
<dd>The optional parameter <code>trustGuestRxFilters</code> can <dd>The optional parameter <code>trustGuestRxFilters</code> can
be used to set that attribute of the same name for each domain be used to set that attribute of the same name for each domain
interface connected to this network (<span class="since">since interface connected to this network (<span class="since">since