[libvirt] [PATCH 11/24] formatdomain.html.in: Kill useless spaces in <pre/>

The <pre/> section is rendered as-is on the page. That is, if all the lines are prefixed with 4 spaces the rendered page will also have them. Problem is if we put a box around such <pre/> because the content might not fix into it. Signed-off-by: Michal Privoznik <mprivozn(a)redhat.com&gt; --- docs/formatdomain.html.in | 2338 ++++++++++++++++++++++----------------------- 1 file changed, 1169 insertions(+), 1169 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 11b3330..4e40aa1 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -99,18 +99,18 @@ </p> <pre> - ... - &lt;os&gt; - &lt;type&gt;hvm&lt;/type&gt; - &lt;loader readonly='yes' secure='no' type='rom'&gt;/usr/lib/xen/boot/hvmloader&lt;/loader&gt; - &lt;nvram template='/usr/share/OVMF/OVMF_VARS.fd'&gt;/var/lib/libvirt/nvram/guest_VARS.fd&lt;/nvram&gt; - &lt;boot dev='hd'/&gt; - &lt;boot dev='cdrom'/&gt; - &lt;bootmenu enable='yes' timeout='3000'/&gt; - &lt;smbios mode='sysinfo'/&gt; - &lt;bios useserial='yes' rebootTimeout='0'/&gt; - &lt;/os&gt; - ...</pre> +... +&lt;os&gt; + &lt;type&gt;hvm&lt;/type&gt; + &lt;loader readonly='yes' secure='no' type='rom'&gt;/usr/lib/xen/boot/hvmloader&lt;/loader&gt; + &lt;nvram template='/usr/share/OVMF/OVMF_VARS.fd'&gt;/var/lib/libvirt/nvram/guest_VARS.fd&lt;/nvram&gt; + &lt;boot dev='hd'/&gt; + &lt;boot dev='cdrom'/&gt; + &lt;bootmenu enable='yes' timeout='3000'/&gt; + &lt;smbios mode='sysinfo'/&gt; + &lt;bios useserial='yes' rebootTimeout='0'/&gt; +&lt;/os&gt; +...</pre> <dl> <dt><code>type</code></dt> @@ -242,10 +242,10 @@ </p> <pre> - ... - &lt;bootloader&gt;/usr/bin/pygrub&lt;/bootloader&gt; - &lt;bootloader_args&gt;--append single&lt;/bootloader_args&gt; - ...</pre> +... +&lt;bootloader&gt;/usr/bin/pygrub&lt;/bootloader&gt; +&lt;bootloader_args&gt;--append single&lt;/bootloader_args&gt; +...</pre> <dl> <dt><code>bootloader</code></dt> @@ -272,19 +272,19 @@ </p> <pre> - ... - &lt;os&gt; - &lt;type&gt;hvm&lt;/type&gt; - &lt;loader&gt;/usr/lib/xen/boot/hvmloader&lt;/loader&gt; - &lt;kernel&gt;/root/f8-i386-vmlinuz&lt;/kernel&gt; - &lt;initrd&gt;/root/f8-i386-initrd&lt;/initrd&gt; - &lt;cmdline&gt;console=ttyS0 ks=http://example.com/f8-i386/os/&lt;/cmdline&gt; - &lt;dtb&gt;/root/ppc.dtb&lt;/dtb&gt; - &lt;acpi&gt; - &lt;table type='slic'&gt;/path/to/slic.dat&lt;/table&gt; - &lt;/acpi&gt; - &lt;/os&gt; - ...</pre> +... +&lt;os&gt; + &lt;type&gt;hvm&lt;/type&gt; + &lt;loader&gt;/usr/lib/xen/boot/hvmloader&lt;/loader&gt; + &lt;kernel&gt;/root/f8-i386-vmlinuz&lt;/kernel&gt; + &lt;initrd&gt;/root/f8-i386-initrd&lt;/initrd&gt; + &lt;cmdline&gt;console=ttyS0 ks=http://example.com/f8-i386/os/&lt;/cmdline&gt; + &lt;dtb&gt;/root/ppc.dtb&lt;/dtb&gt; + &lt;acpi&gt; + &lt;table type='slic'&gt;/path/to/slic.dat&lt;/table&gt; + &lt;/acpi&gt; +&lt;/os&gt; +...</pre> <dl> <dt><code>type</code></dt> @@ -328,12 +328,12 @@ </p> <pre> - &lt;os&gt; - &lt;type arch='x86_64'&gt;exe&lt;/type&gt; - &lt;init&gt;/bin/systemd&lt;/init&gt; - &lt;initarg&gt;--unit&lt;/initarg&gt; - &lt;initarg&gt;emergency.service&lt;/initarg&gt; - &lt;/os&gt; +&lt;os&gt; + &lt;type arch='x86_64'&gt;exe&lt;/type&gt; + &lt;init&gt;/bin/systemd&lt;/init&gt; + &lt;initarg&gt;--unit&lt;/initarg&gt; + &lt;initarg&gt;emergency.service&lt;/initarg&gt; +&lt;/os&gt; </pre> @@ -353,10 +353,10 @@ </dl> <pre> - &lt;idmap&gt; - &lt;uid start='0' target='1000' count='10'/&gt; - &lt;gid start='0' target='1000' count='10'/&gt; - &lt;/idmap&gt; +&lt;idmap&gt; + &lt;uid start='0' target='1000' count='10'/&gt; + &lt;gid start='0' target='1000' count='10'/&gt; +&lt;/idmap&gt; </pre> @@ -372,28 +372,28 @@ </p> <pre> +... +&lt;os&gt; + &lt;smbios mode='sysinfo'/&gt; ... - &lt;os&gt; - &lt;smbios mode='sysinfo'/&gt; - ... - &lt;/os&gt; - &lt;sysinfo type='smbios'&gt; - &lt;bios&gt; - &lt;entry name='vendor'&gt;LENOVO&lt;/entry&gt; - &lt;/bios&gt; - &lt;system&gt; - &lt;entry name='manufacturer'&gt;Fedora&lt;/entry&gt; - &lt;entry name='product'&gt;Virt-Manager&lt;/entry&gt; - &lt;entry name='version'&gt;0.9.4&lt;/entry&gt; - &lt;/system&gt; - &lt;baseBoard&gt; - &lt;entry name='manufacturer'&gt;LENOVO&lt;/entry&gt; - &lt;entry name='product'&gt;20BE0061MC&lt;/entry&gt; - &lt;entry name='version'&gt;0B98401 Pro&lt;/entry&gt; - &lt;entry name='serial'&gt;W1KS427111E&lt;/entry&gt; - &lt;/baseBoard&gt; - &lt;/sysinfo&gt; - ...</pre> +&lt;/os&gt; +&lt;sysinfo type='smbios'&gt; + &lt;bios&gt; + &lt;entry name='vendor'&gt;LENOVO&lt;/entry&gt; + &lt;/bios&gt; + &lt;system&gt; + &lt;entry name='manufacturer'&gt;Fedora&lt;/entry&gt; + &lt;entry name='product'&gt;Virt-Manager&lt;/entry&gt; + &lt;entry name='version'&gt;0.9.4&lt;/entry&gt; + &lt;/system&gt; + &lt;baseBoard&gt; + &lt;entry name='manufacturer'&gt;LENOVO&lt;/entry&gt; + &lt;entry name='product'&gt;20BE0061MC&lt;/entry&gt; + &lt;entry name='version'&gt;0B98401 Pro&lt;/entry&gt; + &lt;entry name='serial'&gt;W1KS427111E&lt;/entry&gt; + &lt;/baseBoard&gt; +&lt;/sysinfo&gt; +...</pre> <p> The <code>sysinfo</code> element has a mandatory @@ -1149,11 +1149,11 @@ by default. </p> <pre> - ... - &lt;resource&gt; - &lt;partition&gt;/virtualmachines/production&lt;/partition&gt; - &lt;/resource&gt; - ... +... +&lt;resource&gt; + &lt;partition&gt;/virtualmachines/production&lt;/partition&gt; +&lt;/resource&gt; +... </pre> <p> @@ -1171,26 +1171,26 @@ </p> <pre> - ... - &lt;cpu match='exact'&gt; - &lt;model fallback='allow'&gt;core2duo&lt;/model&gt; - &lt;vendor&gt;Intel&lt;/vendor&gt; - &lt;topology sockets='1' cores='2' threads='1'/&gt; - &lt;feature policy='disable' name='lahf_lm'/&gt; - &lt;/cpu&gt; - ...</pre> +... +&lt;cpu match='exact'&gt; + &lt;model fallback='allow'&gt;core2duo&lt;/model&gt; + &lt;vendor&gt;Intel&lt;/vendor&gt; + &lt;topology sockets='1' cores='2' threads='1'/&gt; + &lt;feature policy='disable' name='lahf_lm'/&gt; +&lt;/cpu&gt; +...</pre> <pre> - &lt;cpu mode='host-model'&gt; - &lt;model fallback='forbid'/&gt; - &lt;topology sockets='1' cores='2' threads='1'/&gt; - &lt;/cpu&gt; - ...</pre> +&lt;cpu mode='host-model'&gt; + &lt;model fallback='forbid'/&gt; + &lt;topology sockets='1' cores='2' threads='1'/&gt; +&lt;/cpu&gt; +...</pre> <pre> - &lt;cpu mode='host-passthrough'&gt; - &lt;feature policy='disable' name='lahf_lm'/&gt; - ...</pre> +&lt;cpu mode='host-passthrough'&gt; + &lt;feature policy='disable' name='lahf_lm'/&gt; +...</pre> <p> In case no restrictions need to be put on CPU model and its features, a @@ -1199,11 +1199,11 @@ </p> <pre> - ... - &lt;cpu&gt; - &lt;topology sockets='1' cores='2' threads='1'/&gt; - &lt;/cpu&gt; - ...</pre> +... +&lt;cpu&gt; + &lt;topology sockets='1' cores='2' threads='1'/&gt; +&lt;/cpu&gt; +...</pre> <dl> <dt><code>cpu</code></dt> @@ -1281,10 +1281,10 @@ When a user needs a power7 VM to run in compatibility mode on a Power8 host, this can be described in XML as follows : <pre> - &lt;cpu mode='host-model'&gt; - &lt;model&gt;power7&lt;/model&gt; - &lt;/cpu&gt; - ...</pre> +&lt;cpu mode='host-model'&gt; + &lt;model&gt;power7&lt;/model&gt; +&lt;/cpu&gt; +...</pre> </dd> <dt><code>host-passthrough</code></dt> <dd>With this mode, the CPU visible to the guest should be exactly @@ -1374,16 +1374,16 @@ </p> <pre> +... +&lt;cpu&gt; ... - &lt;cpu&gt; - ... - &lt;numa&gt; - &lt;cell id='0' cpus='0-3' memory='512000' unit='KiB'/&gt; - &lt;cell id='1' cpus='4-7' memory='512000' unit='KiB' memAccess='shared'/&gt; - &lt;/numa&gt; - ... - &lt;/cpu&gt; - ...</pre> + &lt;numa&gt; + &lt;cell id='0' cpus='0-3' memory='512000' unit='KiB'/&gt; + &lt;cell id='1' cpus='4-7' memory='512000' unit='KiB' memAccess='shared'/&gt; + &lt;/numa&gt; + ... +&lt;/cpu&gt; +...</pre> <p> Each <code>cell</code> element specifies a NUMA cell or a NUMA node. @@ -1431,12 +1431,12 @@ </p> <pre> - ... - &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt; - &lt;on_reboot&gt;restart&lt;/on_reboot&gt; - &lt;on_crash&gt;restart&lt;/on_crash&gt; - &lt;on_lockfailure&gt;poweroff&lt;/on_lockfailure&gt; - ...</pre> +... +&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt; +&lt;on_reboot&gt;restart&lt;/on_reboot&gt; +&lt;on_crash&gt;restart&lt;/on_crash&gt; +&lt;on_lockfailure&gt;poweroff&lt;/on_lockfailure&gt; +...</pre> <p> The following collections of elements allow the actions to be @@ -1530,12 +1530,12 @@ </p> <pre> - ... - &lt;pm&gt; - &lt;suspend-to-disk enabled='no'/&gt; - &lt;suspend-to-mem enabled='yes'/&gt; - &lt;/pm&gt; - ...</pre> +... +&lt;pm&gt; + &lt;suspend-to-disk enabled='no'/&gt; + &lt;suspend-to-mem enabled='yes'/&gt; +&lt;/pm&gt; +...</pre> <dl> <dt><code>pm</code></dt> @@ -1553,31 +1553,31 @@ </p> <pre> - ... - &lt;features&gt; - &lt;pae/&gt; - &lt;acpi/&gt; - &lt;apic/&gt; - &lt;hap/&gt; - &lt;privnet/&gt; - &lt;hyperv&gt; - &lt;relaxed state='on'/&gt; - &lt;vapic state='on'/&gt; - &lt;spinlocks state='on' retries='4096'/&gt; - &lt;vpindex state='on'/&gt; - &lt;runtime state='on'/&gt; - &lt;synic state='on'/&gt; - &lt;reset state='on'/&gt; - &lt;vendor_id state='on' value='KVM Hv'/&gt; - &lt;/hyperv&gt; - &lt;kvm&gt; - &lt;hidden state='on'/&gt; - &lt;/kvm&gt; - &lt;pvspinlock state='on'/&gt; - &lt;gic version='2'/&gt; +... +&lt;features&gt; + &lt;pae/&gt; + &lt;acpi/&gt; + &lt;apic/&gt; + &lt;hap/&gt; + &lt;privnet/&gt; + &lt;hyperv&gt; + &lt;relaxed state='on'/&gt; + &lt;vapic state='on'/&gt; + &lt;spinlocks state='on' retries='4096'/&gt; + &lt;vpindex state='on'/&gt; + &lt;runtime state='on'/&gt; + &lt;synic state='on'/&gt; + &lt;reset state='on'/&gt; + &lt;vendor_id state='on' value='KVM Hv'/&gt; + &lt;/hyperv&gt; + &lt;kvm&gt; + &lt;hidden state='on'/&gt; + &lt;/kvm&gt; + &lt;pvspinlock state='on'/&gt; + &lt;gic version='2'/&gt; - &lt;/features&gt; - ...</pre> +&lt;/features&gt; +...</pre> <p> All features are listed within the <code>features</code> @@ -1748,14 +1748,14 @@ </p> <pre> - ... - &lt;clock offset='localtime'&gt; - &lt;timer name='rtc' tickpolicy='catchup' track='guest'&gt; - &lt;catchup threshold='123' slew='120' limit='10000'/&gt; - &lt;/timer&gt; - &lt;timer name='pit' tickpolicy='delay'/&gt; - &lt;/clock&gt; - ...</pre> +... +&lt;clock offset='localtime'&gt; + &lt;timer name='rtc' tickpolicy='catchup' track='guest'&gt; + &lt;catchup threshold='123' slew='120' limit='10000'/&gt; + &lt;/timer&gt; + &lt;timer name='pit' tickpolicy='delay'/&gt; +&lt;/clock&gt; +...</pre> <dl> <dt><code>clock</code></dt> @@ -1918,17 +1918,17 @@ </p> <pre> - ... - &lt;perf&gt; - &lt;event name='cmt' enabled='yes'/&gt; - &lt;event name='mbmt' enabled='no'/&gt; - &lt;event name='mbml' enabled='yes'/&gt; - &lt;event name='cpu_cycles' enabled='no'/&gt; - &lt;event name='instructions' enabled='yes'/&gt; - &lt;event name='cache_references' enabled='no'/&gt; - &lt;event name='cache_misses' enabled='no'/&gt; - &lt;/perf&gt; - ... +... +&lt;perf&gt; + &lt;event name='cmt' enabled='yes'/&gt; + &lt;event name='mbmt' enabled='no'/&gt; + &lt;event name='mbml' enabled='yes'/&gt; + &lt;event name='cpu_cycles' enabled='no'/&gt; + &lt;event name='instructions' enabled='yes'/&gt; + &lt;event name='cache_references' enabled='no'/&gt; + &lt;event name='cache_misses' enabled='no'/&gt; +&lt;/perf&gt; +... </pre> <table class="top_table"> @@ -1984,11 +1984,11 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;emulator&gt;/usr/lib/xen/bin/qemu-dm&lt;/emulator&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;emulator&gt;/usr/lib/xen/bin/qemu-dm&lt;/emulator&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>emulator</code></dt> @@ -2010,166 +2010,166 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;disk type='file' snapshot='external'&gt; - &lt;driver name="tap" type="aio" cache="default"/&gt; - &lt;source file='/var/lib/xen/images/fv0' startupPolicy='optional'&gt; - &lt;seclabel relabel='no'/&gt; - &lt;/source&gt; - &lt;target dev='hda' bus='ide'/&gt; - &lt;iotune&gt; - &lt;total_bytes_sec&gt;10000000&lt;/total_bytes_sec&gt; - &lt;read_iops_sec&gt;400000&lt;/read_iops_sec&gt; - &lt;write_iops_sec&gt;100000&lt;/write_iops_sec&gt; - &lt;/iotune&gt; - &lt;boot order='2'/&gt; - &lt;encryption type='...'&gt; - ... - &lt;/encryption&gt; - &lt;shareable/&gt; - &lt;serial&gt; - ... - &lt;/serial&gt; - &lt;/disk&gt; +... +&lt;devices&gt; + &lt;disk type='file' snapshot='external'&gt; + &lt;driver name="tap" type="aio" cache="default"/&gt; + &lt;source file='/var/lib/xen/images/fv0' startupPolicy='optional'&gt; + &lt;seclabel relabel='no'/&gt; + &lt;/source&gt; + &lt;target dev='hda' bus='ide'/&gt; + &lt;iotune&gt; + &lt;total_bytes_sec&gt;10000000&lt;/total_bytes_sec&gt; + &lt;read_iops_sec&gt;400000&lt;/read_iops_sec&gt; + &lt;write_iops_sec&gt;100000&lt;/write_iops_sec&gt; + &lt;/iotune&gt; + &lt;boot order='2'/&gt; + &lt;encryption type='...'&gt; ... - &lt;disk type='network'&gt; - &lt;driver name="qemu" type="raw" io="threads" ioeventfd="on" event_idx="off"/&gt; - &lt;source protocol="sheepdog" name="image_name"&gt; - &lt;host name="hostname" port="7000"/&gt; - &lt;/source&gt; - &lt;target dev="hdb" bus="ide"/&gt; - &lt;boot order='1'/&gt; - &lt;transient/&gt; - &lt;address type='drive' controller='0' bus='1' unit='0'/&gt; - &lt;/disk&gt; - &lt;disk type='network'&gt; - &lt;driver name="qemu" type="raw"/&gt; - &lt;source protocol="rbd" name="image_name2"&gt; - &lt;host name="hostname" port="7000"/&gt; - &lt;snapshot name="snapname"/&gt; - &lt;config file="/path/to/file"/&gt; - &lt;/source&gt; - &lt;target dev="hdc" bus="ide"/&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='ceph' usage='mypassid'/&gt; - &lt;/auth&gt; - &lt;/disk&gt; - &lt;disk type='block' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;target dev='hdd' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol="http" name="url_path"&gt; - &lt;host name="hostname" port="80"/&gt; - &lt;/source&gt; - &lt;target dev='hde' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol="https" name="url_path"&gt; - &lt;host name="hostname" port="443"/&gt; - &lt;/source&gt; - &lt;target dev='hdf' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol="ftp" name="url_path"&gt; - &lt;host name="hostname" port="21"/&gt; - &lt;/source&gt; - &lt;target dev='hdg' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol="ftps" name="url_path"&gt; - &lt;host name="hostname" port="990"/&gt; - &lt;/source&gt; - &lt;target dev='hdh' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='cdrom'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol="tftp" name="url_path"&gt; - &lt;host name="hostname" port="69"/&gt; - &lt;/source&gt; - &lt;target dev='hdi' bus='ide' tray='open'/&gt; - &lt;readonly/&gt; - &lt;/disk&gt; - &lt;disk type='block' device='lun'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source dev='/dev/sda'/&gt; - &lt;target dev='sda' bus='scsi'/&gt; - &lt;address type='drive' controller='0' bus='0' target='3' unit='0'/&gt; - &lt;/disk&gt; - &lt;disk type='block' device='disk'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source dev='/dev/sda'/&gt; - &lt;geometry cyls='16383' heads='16' secs='63' trans='lba'/&gt; - &lt;blockio logical_block_size='512' physical_block_size='4096'/&gt; - &lt;target dev='hdj' bus='ide'/&gt; - &lt;/disk&gt; - &lt;disk type='volume' device='disk'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source pool='blk-pool0' volume='blk-pool0-vol0'/&gt; - &lt;target dev='hdk' bus='ide'/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='disk'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol='iscsi' name='iqn.2013-07.com.example:iscsi-nopool/2'&gt; - &lt;host name='example.com' port='3260'/&gt; - &lt;/source&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; - &lt;/auth&gt; - &lt;target dev='vda' bus='virtio'/&gt; - &lt;/disk&gt; - &lt;disk type='network' device='lun'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source protocol='iscsi' name='iqn.2013-07.com.example:iscsi-nopool/1'&gt; - &lt;host name='example.com' port='3260'/&gt; - &lt;/source&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; - &lt;/auth&gt; - &lt;target dev='sdb' bus='scsi'/&gt; - &lt;/disk&gt; - &lt;disk type='volume' device='disk'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source pool='iscsi-pool' volume='unit:0:0:1' mode='host'/&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; - &lt;/auth&gt; - &lt;target dev='vdb' bus='virtio'/&gt; - &lt;/disk&gt; - &lt;disk type='volume' device='disk'&gt; - &lt;driver name='qemu' type='raw'/&gt; - &lt;source pool='iscsi-pool' volume='unit:0:0:2' mode='direct'/&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; - &lt;/auth&gt; - &lt;target dev='vdc' bus='virtio'/&gt; - &lt;/disk&gt; - &lt;disk type='file' device='disk'&gt; - &lt;driver name='qemu' type='qcow2'/&gt; - &lt;source file='/var/lib/libvirt/images/domain.qcow'/&gt; - &lt;backingStore type='file'&gt; - &lt;format type='qcow2'/&gt; - &lt;source file='/var/lib/libvirt/images/snapshot.qcow'/&gt; - &lt;backingStore type='block'&gt; - &lt;format type='raw'/&gt; - &lt;source dev='/dev/mapper/base'/&gt; - &lt;backingStore/&gt; - &lt;/backingStore&gt; + &lt;/encryption&gt; + &lt;shareable/&gt; + &lt;serial&gt; + ... + &lt;/serial&gt; + &lt;/disk&gt; + ... + &lt;disk type='network'&gt; + &lt;driver name="qemu" type="raw" io="threads" ioeventfd="on" event_idx="off"/&gt; + &lt;source protocol="sheepdog" name="image_name"&gt; + &lt;host name="hostname" port="7000"/&gt; + &lt;/source&gt; + &lt;target dev="hdb" bus="ide"/&gt; + &lt;boot order='1'/&gt; + &lt;transient/&gt; + &lt;address type='drive' controller='0' bus='1' unit='0'/&gt; + &lt;/disk&gt; + &lt;disk type='network'&gt; + &lt;driver name="qemu" type="raw"/&gt; + &lt;source protocol="rbd" name="image_name2"&gt; + &lt;host name="hostname" port="7000"/&gt; + &lt;snapshot name="snapname"/&gt; + &lt;config file="/path/to/file"/&gt; + &lt;/source&gt; + &lt;target dev="hdc" bus="ide"/&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='ceph' usage='mypassid'/&gt; + &lt;/auth&gt; + &lt;/disk&gt; + &lt;disk type='block' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;target dev='hdd' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol="http" name="url_path"&gt; + &lt;host name="hostname" port="80"/&gt; + &lt;/source&gt; + &lt;target dev='hde' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol="https" name="url_path"&gt; + &lt;host name="hostname" port="443"/&gt; + &lt;/source&gt; + &lt;target dev='hdf' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol="ftp" name="url_path"&gt; + &lt;host name="hostname" port="21"/&gt; + &lt;/source&gt; + &lt;target dev='hdg' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol="ftps" name="url_path"&gt; + &lt;host name="hostname" port="990"/&gt; + &lt;/source&gt; + &lt;target dev='hdh' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='cdrom'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol="tftp" name="url_path"&gt; + &lt;host name="hostname" port="69"/&gt; + &lt;/source&gt; + &lt;target dev='hdi' bus='ide' tray='open'/&gt; + &lt;readonly/&gt; + &lt;/disk&gt; + &lt;disk type='block' device='lun'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source dev='/dev/sda'/&gt; + &lt;target dev='sda' bus='scsi'/&gt; + &lt;address type='drive' controller='0' bus='0' target='3' unit='0'/&gt; + &lt;/disk&gt; + &lt;disk type='block' device='disk'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source dev='/dev/sda'/&gt; + &lt;geometry cyls='16383' heads='16' secs='63' trans='lba'/&gt; + &lt;blockio logical_block_size='512' physical_block_size='4096'/&gt; + &lt;target dev='hdj' bus='ide'/&gt; + &lt;/disk&gt; + &lt;disk type='volume' device='disk'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source pool='blk-pool0' volume='blk-pool0-vol0'/&gt; + &lt;target dev='hdk' bus='ide'/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='disk'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol='iscsi' name='iqn.2013-07.com.example:iscsi-nopool/2'&gt; + &lt;host name='example.com' port='3260'/&gt; + &lt;/source&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; + &lt;/auth&gt; + &lt;target dev='vda' bus='virtio'/&gt; + &lt;/disk&gt; + &lt;disk type='network' device='lun'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source protocol='iscsi' name='iqn.2013-07.com.example:iscsi-nopool/1'&gt; + &lt;host name='example.com' port='3260'/&gt; + &lt;/source&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; + &lt;/auth&gt; + &lt;target dev='sdb' bus='scsi'/&gt; + &lt;/disk&gt; + &lt;disk type='volume' device='disk'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source pool='iscsi-pool' volume='unit:0:0:1' mode='host'/&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; + &lt;/auth&gt; + &lt;target dev='vdb' bus='virtio'/&gt; + &lt;/disk&gt; + &lt;disk type='volume' device='disk'&gt; + &lt;driver name='qemu' type='raw'/&gt; + &lt;source pool='iscsi-pool' volume='unit:0:0:2' mode='direct'/&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; + &lt;/auth&gt; + &lt;target dev='vdc' bus='virtio'/&gt; + &lt;/disk&gt; + &lt;disk type='file' device='disk'&gt; + &lt;driver name='qemu' type='qcow2'/&gt; + &lt;source file='/var/lib/libvirt/images/domain.qcow'/&gt; + &lt;backingStore type='file'&gt; + &lt;format type='qcow2'/&gt; + &lt;source file='/var/lib/libvirt/images/snapshot.qcow'/&gt; + &lt;backingStore type='block'&gt; + &lt;format type='raw'/&gt; + &lt;source dev='/dev/mapper/base'/&gt; + &lt;backingStore/&gt; &lt;/backingStore&gt; - &lt;target dev='vdd' bus='virtio'/&gt; - &lt;/disk&gt; - &lt;/devices&gt; - ...</pre> + &lt;/backingStore&gt; + &lt;target dev='vdd' bus='virtio'/&gt; + &lt;/disk&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>disk</code></dt> @@ -2929,28 +2929,28 @@ </p> <pre> +... +&lt;devices&gt; + &lt;filesystem type='template'&gt; + &lt;source name='my-vm-template'/&gt; + &lt;target dir='/'/&gt; + &lt;/filesystem&gt; + &lt;filesystem type='mount' accessmode='passthrough'&gt; + &lt;driver type='path' wrpolicy='immediate'/&gt; + &lt;source dir='/export/to/guest'/&gt; + &lt;target dir='/import/from/host'/&gt; + &lt;readonly/&gt; + &lt;/filesystem&gt; + &lt;filesystem type='file' accessmode='passthrough'&gt; + &lt;driver name='loop' type='raw'/&gt; + &lt;driver type='path' wrpolicy='immediate'/&gt; + &lt;source file='/export/to/guest.img'/&gt; + &lt;target dir='/import/from/host'/&gt; + &lt;readonly/&gt; + &lt;/filesystem&gt; ... - &lt;devices&gt; - &lt;filesystem type='template'&gt; - &lt;source name='my-vm-template'/&gt; - &lt;target dir='/'/&gt; - &lt;/filesystem&gt; - &lt;filesystem type='mount' accessmode='passthrough'&gt; - &lt;driver type='path' wrpolicy='immediate'/&gt; - &lt;source dir='/export/to/guest'/&gt; - &lt;target dir='/import/from/host'/&gt; - &lt;readonly/&gt; - &lt;/filesystem&gt; - &lt;filesystem type='file' accessmode='passthrough'&gt; - &lt;driver name='loop' type='raw'/&gt; - &lt;driver type='path' wrpolicy='immediate'/&gt; - &lt;source file='/export/to/guest.img'/&gt; - &lt;target dir='/import/from/host'/&gt; - &lt;readonly/&gt; - &lt;/filesystem&gt; - ... - &lt;/devices&gt; - ...</pre> +&lt;/devices&gt; +...</pre> <dl> <dt><code>filesystem</code></dt> @@ -3221,20 +3221,20 @@ </p> <pre> +... +&lt;devices&gt; + &lt;controller type='ide' index='0'/&gt; + &lt;controller type='virtio-serial' index='0' ports='16' vectors='4'/&gt; + &lt;controller type='virtio-serial' index='1'&gt; + &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x0a' function='0x0'/&gt; + &lt;/controller&gt; + &lt;controller type='scsi' index='0' model='virtio-scsi'&gt; + &lt;driver iothread='4'/&gt; + &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x0b' function='0x0'/&gt; + &lt;/controller&gt; ... - &lt;devices&gt; - &lt;controller type='ide' index='0'/&gt; - &lt;controller type='virtio-serial' index='0' ports='16' vectors='4'/&gt; - &lt;controller type='virtio-serial' index='1'&gt; - &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x0a' function='0x0'/&gt; - &lt;/controller&gt; - &lt;controller type='scsi' index='0' model='virtio-scsi'&gt; - &lt;driver iothread='4'/&gt; - &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x0b' function='0x0'/&gt; - &lt;/controller&gt; - ... - &lt;/devices&gt; - ...</pre> +&lt;/devices&gt; +...</pre> <p> Each controller has a mandatory attribute <code>type</code>, @@ -3356,18 +3356,18 @@ </p> <pre> +... +&lt;devices&gt; + &lt;controller type='usb' index='0' model='ich9-ehci1'&gt; + &lt;address type='pci' domain='0' bus='0' slot='4' function='7'/&gt; + &lt;/controller&gt; + &lt;controller type='usb' index='0' model='ich9-uhci1'&gt; + &lt;master startport='0'/&gt; + &lt;address type='pci' domain='0' bus='0' slot='4' function='0' multifunction='on'/&gt; + &lt;/controller&gt; ... - &lt;devices&gt; - &lt;controller type='usb' index='0' model='ich9-ehci1'&gt; - &lt;address type='pci' domain='0' bus='0' slot='4' function='7'/&gt; - &lt;/controller&gt; - &lt;controller type='usb' index='0' model='ich9-uhci1'&gt; - &lt;master startport='0'/&gt; - &lt;address type='pci' domain='0' bus='0' slot='4' function='0' multifunction='on'/&gt; - &lt;/controller&gt; - ... - &lt;/devices&gt; - ...</pre> +&lt;/devices&gt; +...</pre> <p> PCI controllers have an optional <code>model</code> attribute with @@ -3507,14 +3507,14 @@ configuration. </p> <pre> - ... - &lt;devices&gt; - &lt;controller type='pci' index='0' model='pci-root'/&gt; - &lt;controller type='pci' index='1' model='pci-bridge'&gt; - &lt;address type='pci' domain='0' bus='0' slot='5' function='0' multifunction='off'/&gt; - &lt;/controller&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;controller type='pci' index='0' model='pci-root'/&gt; + &lt;controller type='pci' index='1' model='pci-bridge'&gt; + &lt;address type='pci' domain='0' bus='0' slot='5' function='0' multifunction='off'/&gt; + &lt;/controller&gt; +&lt;/devices&gt; +...</pre> <p> For machine types which provide an implicit PCI Express (PCIe) @@ -3569,17 +3569,17 @@ 1.2.19</span>) </p> <pre> - ... - &lt;devices&gt; - &lt;controller type='pci' index='0' model='pcie-root'/&gt; - &lt;controller type='pci' index='1' model='dmi-to-pci-bridge'&gt; - &lt;address type='pci' domain='0' bus='0' slot='0xe' function='0'/&gt; - &lt;/controller&gt; - &lt;controller type='pci' index='2' model='pci-bridge'&gt; - &lt;address type='pci' domain='0' bus='1' slot='1' function='0'/&gt; - &lt;/controller&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;controller type='pci' index='0' model='pcie-root'/&gt; + &lt;controller type='pci' index='1' model='dmi-to-pci-bridge'&gt; + &lt;address type='pci' domain='0' bus='0' slot='0xe' function='0'/&gt; + &lt;/controller&gt; + &lt;controller type='pci' index='2' model='pci-bridge'&gt; + &lt;address type='pci' domain='0' bus='1' slot='1' function='0'/&gt; + &lt;/controller&gt; +&lt;/devices&gt; +...</pre> <h4><a name="elementsLease">Device leases</a></h4> @@ -3590,17 +3590,17 @@ </p> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;lease&gt; - &lt;lockspace&gt;somearea&lt;/lockspace&gt; - &lt;key&gt;somekey&lt;/key&gt; - &lt;target path='/some/lease/path' offset='1024'/&gt; - &lt;/lease&gt; - ... - &lt;/devices&gt; - ...</pre> + &lt;lease&gt; + &lt;lockspace&gt;somearea&lt;/lockspace&gt; + &lt;key&gt;somekey&lt;/key&gt; + &lt;target path='/some/lease/path' offset='1024'/&gt; + &lt;/lease&gt; + ... +&lt;/devices&gt; +...</pre> <dl> <dt><code>lockspace</code></dt> @@ -3633,66 +3633,66 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;hostdev mode='subsystem' type='usb'&gt; - &lt;source startupPolicy='optional'&gt; - &lt;vendor id='0x1234'/&gt; - &lt;product id='0xbeef'/&gt; - &lt;/source&gt; - &lt;boot order='2'/&gt; - &lt;/hostdev&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;hostdev mode='subsystem' type='usb'&gt; + &lt;source startupPolicy='optional'&gt; + &lt;vendor id='0x1234'/&gt; + &lt;product id='0xbeef'/&gt; + &lt;/source&gt; + &lt;boot order='2'/&gt; + &lt;/hostdev&gt; +&lt;/devices&gt; +...</pre> <p>or:</p> <pre> - ... - &lt;devices&gt; - &lt;hostdev mode='subsystem' type='pci' managed='yes'&gt; - &lt;source&gt; - &lt;address domain='0x0000' bus='0x06' slot='0x02' function='0x0'/&gt; - &lt;/source&gt; - &lt;boot order='1'/&gt; - &lt;rom bar='on' file='/etc/fake/boot.bin'/&gt; - &lt;/hostdev&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;hostdev mode='subsystem' type='pci' managed='yes'&gt; + &lt;source&gt; + &lt;address domain='0x0000' bus='0x06' slot='0x02' function='0x0'/&gt; + &lt;/source&gt; + &lt;boot order='1'/&gt; + &lt;rom bar='on' file='/etc/fake/boot.bin'/&gt; + &lt;/hostdev&gt; +&lt;/devices&gt; +...</pre> <p>or:</p> <pre> - ... - &lt;devices&gt; - &lt;hostdev mode='subsystem' type='scsi' sgio='filtered' rawio='yes'&gt; - &lt;source&gt; - &lt;adapter name='scsi_host0'/&gt; - &lt;address bus='0' target='0' unit='0'/&gt; - &lt;/source&gt; - &lt;readonly/&gt; - &lt;address type='drive' controller='0' bus='0' target='0' unit='0'/&gt; - &lt;/hostdev&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;hostdev mode='subsystem' type='scsi' sgio='filtered' rawio='yes'&gt; + &lt;source&gt; + &lt;adapter name='scsi_host0'/&gt; + &lt;address bus='0' target='0' unit='0'/&gt; + &lt;/source&gt; + &lt;readonly/&gt; + &lt;address type='drive' controller='0' bus='0' target='0' unit='0'/&gt; + &lt;/hostdev&gt; +&lt;/devices&gt; +...</pre> <p>or:</p> <pre> - ... - &lt;devices&gt; - &lt;hostdev mode='subsystem' type='scsi'&gt; - &lt;source protocol='iscsi' name='iqn.2014-08.com.example:iscsi-nopool/1'&gt; - &lt;host name='example.com' port='3260'/&gt; - &lt;auth username='myuser'&gt; - &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; - &lt;/auth&gt; - &lt;/source&gt; - &lt;address type='drive' controller='0' bus='0' target='0' unit='0'/&gt; - &lt;/hostdev&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;hostdev mode='subsystem' type='scsi'&gt; + &lt;source protocol='iscsi' name='iqn.2014-08.com.example:iscsi-nopool/1'&gt; + &lt;host name='example.com' port='3260'/&gt; + &lt;auth username='myuser'&gt; + &lt;secret type='iscsi' usage='libvirtiscsi'/&gt; + &lt;/auth&gt; + &lt;/source&gt; + &lt;address type='drive' controller='0' bus='0' target='0' unit='0'/&gt; + &lt;/hostdev&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>hostdev</code></dt> @@ -3942,18 +3942,18 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;redirdev bus='usb' type='tcp'&gt; - &lt;source mode='connect' host='localhost' service='4000'/&gt; - &lt;boot order='1'/&gt; - &lt;/redirdev&gt; - &lt;redirfilter&gt; - &lt;usbdev class='0x08' vendor='0x1234' product='0xbeef' version='2.56' allow='yes'/&gt; - &lt;usbdev allow='no'/&gt; - &lt;/redirfilter&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;redirdev bus='usb' type='tcp'&gt; + &lt;source mode='connect' host='localhost' service='4000'/&gt; + &lt;boot order='1'/&gt; + &lt;/redirdev&gt; + &lt;redirfilter&gt; + &lt;usbdev class='0x08' vendor='0x1234' product='0xbeef' version='2.56' allow='yes'/&gt; + &lt;usbdev allow='no'/&gt; + &lt;/redirfilter&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>redirdev</code></dt> @@ -4016,23 +4016,23 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;smartcard mode='host'/&gt; - &lt;smartcard mode='host-certificates'&gt; - &lt;certificate&gt;cert1&lt;/certificate&gt; - &lt;certificate&gt;cert2&lt;/certificate&gt; - &lt;certificate&gt;cert3&lt;/certificate&gt; - &lt;database&gt;/etc/pki/nssdb/&lt;/database&gt; - &lt;/smartcard&gt; - &lt;smartcard mode='passthrough' type='tcp'&gt; - &lt;source mode='bind' host='127.0.0.1' service='2001'/&gt; - &lt;protocol type='raw'/&gt; - &lt;address type='ccid' controller='0' slot='0'/&gt; - &lt;/smartcard&gt; - &lt;smartcard mode='passthrough' type='spicevmc'/&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;smartcard mode='host'/&gt; + &lt;smartcard mode='host-certificates'&gt; + &lt;certificate&gt;cert1&lt;/certificate&gt; + &lt;certificate&gt;cert2&lt;/certificate&gt; + &lt;certificate&gt;cert3&lt;/certificate&gt; + &lt;database&gt;/etc/pki/nssdb/&lt;/database&gt; + &lt;/smartcard&gt; + &lt;smartcard mode='passthrough' type='tcp'&gt; + &lt;source mode='bind' host='127.0.0.1' service='2001'/&gt; + &lt;protocol type='raw'/&gt; + &lt;address type='ccid' controller='0' slot='0'/&gt; + &lt;/smartcard&gt; + &lt;smartcard mode='passthrough' type='spicevmc'/&gt; +&lt;/devices&gt; +... </pre> <p> @@ -4096,16 +4096,16 @@ <h4><a name="elementsNICS">Network interfaces</a></h4> <pre> - ... - &lt;devices&gt; - &lt;interface type='direct' trustGuestRxFilters='yes'&gt; - &lt;source dev='eth0'/&gt; - &lt;mac address='52:54:00:5d:c7:9e'/&gt; - &lt;boot order='1'/&gt; - &lt;rom bar='off'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='direct' trustGuestRxFilters='yes'&gt; + &lt;source dev='eth0'/&gt; + &lt;mac address='52:54:00:5d:c7:9e'/&gt; + &lt;boot order='1'/&gt; + &lt;rom bar='off'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> There are several possibilities for specifying a network @@ -4221,23 +4221,23 @@ </p> <pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;/interface&gt; ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;/interface&gt; - ... - &lt;interface type='network'&gt; - &lt;source network='default' portgroup='engineering'/&gt; - &lt;target dev='vnet7'/&gt; - &lt;mac address="00:11:22:33:44:55"/&gt; - &lt;virtualport&gt; - &lt;parameters instanceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; - &lt;/virtualport&gt; + &lt;interface type='network'&gt; + &lt;source network='default' portgroup='engineering'/&gt; + &lt;target dev='vnet7'/&gt; + &lt;mac address="00:11:22:33:44:55"/&gt; + &lt;virtualport&gt; + &lt;parameters instanceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; + &lt;/virtualport&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSBridge">Bridge to LAN</a></h5> @@ -4275,26 +4275,26 @@ the interfaces "port-profile". </p> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='bridge'&gt; - &lt;source bridge='br0'/&gt; - &lt;/interface&gt; - &lt;interface type='bridge'&gt; - &lt;source bridge='br1'/&gt; - &lt;target dev='vnet7'/&gt; - &lt;mac address="00:11:22:33:44:55"/&gt; - &lt;/interface&gt; - &lt;interface type='bridge'&gt; - &lt;source bridge='ovsbr'/&gt; - &lt;virtualport type='openvswitch'&gt; - &lt;parameters profileid='menial' interfaceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - ... - &lt;/devices&gt; - ...</pre> + &lt;interface type='bridge'&gt; + &lt;source bridge='br0'/&gt; + &lt;/interface&gt; + &lt;interface type='bridge'&gt; + &lt;source bridge='br1'/&gt; + &lt;target dev='vnet7'/&gt; + &lt;mac address="00:11:22:33:44:55"/&gt; + &lt;/interface&gt; + &lt;interface type='bridge'&gt; + &lt;source bridge='ovsbr'/&gt; + &lt;virtualport type='openvswitch'&gt; + &lt;parameters profileid='menial' interfaceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; + ... +&lt;/devices&gt; +...</pre> <p> On hosts that support Open vSwitch on the kernel side and have the @@ -4309,26 +4309,26 @@ to the interface. </p> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='bridge'&gt; - &lt;source bridge='br0'/&gt; - &lt;/interface&gt; - &lt;interface type='bridge'&gt; - &lt;source bridge='br1'/&gt; - &lt;target dev='vnet7'/&gt; - &lt;mac address="00:11:22:33:44:55"/&gt; - &lt;/interface&gt; - &lt;interface type='bridge'&gt; - &lt;source bridge='midonet'/&gt; - &lt;virtualport type='midonet'&gt; - &lt;parameters interfaceid='0b2d64da-3d0e-431e-afdd-804415d6ebbb'/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - ... - &lt;/devices&gt; - ...</pre> + &lt;interface type='bridge'&gt; + &lt;source bridge='br0'/&gt; + &lt;/interface&gt; + &lt;interface type='bridge'&gt; + &lt;source bridge='br1'/&gt; + &lt;target dev='vnet7'/&gt; + &lt;mac address="00:11:22:33:44:55"/&gt; + &lt;/interface&gt; + &lt;interface type='bridge'&gt; + &lt;source bridge='midonet'/&gt; + &lt;virtualport type='midonet'&gt; + &lt;parameters interfaceid='0b2d64da-3d0e-431e-afdd-804415d6ebbb'/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; + ... +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSSlirp">Userspace SLIRP stack</a></h5> @@ -4342,15 +4342,15 @@ </p> <pre> +... +&lt;devices&gt; + &lt;interface type='user'/&gt; ... - &lt;devices&gt; - &lt;interface type='user'/&gt; - ... - &lt;interface type='user'&gt; - &lt;mac address="00:11:22:33:44:55"/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;interface type='user'&gt; + &lt;mac address="00:11:22:33:44:55"/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSEthernet">Generic ethernet connection</a></h5> @@ -4366,16 +4366,16 @@ </p> <pre> +... +&lt;devices&gt; + &lt;interface type='ethernet'/&gt; ... - &lt;devices&gt; - &lt;interface type='ethernet'/&gt; - ... - &lt;interface type='ethernet'&gt; - &lt;target dev='vnet7'/&gt; - &lt;script path='/etc/qemu-ifup-mynet'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;interface type='ethernet'&gt; + &lt;target dev='vnet7'/&gt; + &lt;script path='/etc/qemu-ifup-mynet'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSDirect">Direct attachment to physical interface</a></h5> @@ -4433,14 +4433,14 @@ </dl> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='direct' trustGuestRxFilters='no'&gt; - &lt;source dev='eth0' mode='vepa'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;interface type='direct' trustGuestRxFilters='no'&gt; + &lt;source dev='eth0' mode='vepa'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> The network access of direct attached virtual machines can be @@ -4481,17 +4481,17 @@ </dd> </dl> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='direct'&gt; - &lt;source dev='eth0.2' mode='vepa'/&gt; - &lt;virtualport type="802.1Qbg"&gt; - &lt;parameters managerid="11" typeid="1193047" typeidversion="2" instanceid="09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f"/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;interface type='direct'&gt; + &lt;source dev='eth0.2' mode='vepa'/&gt; + &lt;virtualport type="802.1Qbg"&gt; + &lt;parameters managerid="11" typeid="1193047" typeidversion="2" instanceid="09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f"/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> The interface can have additional parameters as shown below @@ -4508,18 +4508,18 @@ </dd> </dl> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='direct'&gt; - &lt;source dev='eth0' mode='private'/&gt; - &lt;virtualport type='802.1Qbh'&gt; - &lt;parameters profileid='finance'/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ... - </pre> + &lt;interface type='direct'&gt; + &lt;source dev='eth0' mode='private'/&gt; + &lt;virtualport type='802.1Qbh'&gt; + &lt;parameters profileid='finance'/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; +&lt;/devices&gt; +... +</pre> <h5><a name="elementsNICSHostdev">PCI Passthrough</a></h5> @@ -4579,20 +4579,20 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;interface type='hostdev' managed='yes'&gt; - &lt;driver name='vfio'/&gt; - &lt;source&gt; - &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x07' function='0x0'/&gt; - &lt;/source&gt; - &lt;mac address='52:54:00:6d:90:02'/&gt; - &lt;virtualport type='802.1Qbh'&gt; - &lt;parameters profileid='finance'/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='hostdev' managed='yes'&gt; + &lt;driver name='vfio'/&gt; + &lt;source&gt; + &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x07' function='0x0'/&gt; + &lt;/source&gt; + &lt;mac address='52:54:00:6d:90:02'/&gt; + &lt;virtualport type='802.1Qbh'&gt; + &lt;parameters profileid='finance'/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSMulticast">Multicast tunnel</a></h5> @@ -4610,14 +4610,14 @@ </p> <pre> - ... - &lt;devices&gt; - &lt;interface type='mcast'&gt; - &lt;mac address='52:54:00:6d:90:01'/&gt; - &lt;source address='230.0.0.1' port='5558'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='mcast'&gt; + &lt;mac address='52:54:00:6d:90:01'/&gt; + &lt;source address='230.0.0.1' port='5558'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSTCP">TCP tunnel</a></h5> @@ -4631,19 +4631,19 @@ to one of the first 4 network types and do the appropriate routing.</p> <pre> +... +&lt;devices&gt; + &lt;interface type='server'&gt; + &lt;mac address='52:54:00:22:c9:42'/&gt; + &lt;source address='192.168.0.1' port='5558'/&gt; + &lt;/interface&gt; ... - &lt;devices&gt; - &lt;interface type='server'&gt; - &lt;mac address='52:54:00:22:c9:42'/&gt; - &lt;source address='192.168.0.1' port='5558'/&gt; - &lt;/interface&gt; - ... - &lt;interface type='client'&gt; - &lt;mac address='52:54:00:8b:c9:51'/&gt; - &lt;source address='192.168.0.1' port='5558'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;interface type='client'&gt; + &lt;mac address='52:54:00:8b:c9:51'/&gt; + &lt;source address='192.168.0.1' port='5558'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSUDP">UDP unicast tunnel</a></h5> @@ -4658,29 +4658,29 @@ <span class="since">Since 1.2.20</span></p> <pre> - ... - &lt;devices&gt; - &lt;interface type='udp'&gt; - &lt;mac address='52:54:00:22:c9:42'/&gt; - &lt;source address='127.0.0.1' port='11115'&gt; - &lt;local address='127.0.0.1' port='11116'/&gt; - &lt;/source&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='udp'&gt; + &lt;mac address='52:54:00:22:c9:42'/&gt; + &lt;source address='127.0.0.1' port='11115'&gt; + &lt;local address='127.0.0.1' port='11116'/&gt; + &lt;/source&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSModel">Setting the NIC model</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet1'/&gt; - <b>&lt;model type='ne2k_pci'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet1'/&gt; + <b>&lt;model type='ne2k_pci'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> For hypervisors which support this, you can set the model of @@ -4707,20 +4707,20 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementsDriverBackendOptions">Setting NIC driver-specific options</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet1'/&gt; - &lt;model type='virtio'/&gt; - <b>&lt;driver name='vhost' txmode='iothread' ioeventfd='on' event_idx='off' queues='5' rx_queue_size='256'&gt; - &lt;host csum='off' gso='off' tso4='off' tso6='off' ecn='off' ufo='off' mrg_rxbuf='off'/&gt; - &lt;guest csum='off' tso4='off' tso6='off' ecn='off' ufo='off'/&gt; - &lt;/driver&gt; - </b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet1'/&gt; + &lt;model type='virtio'/&gt; + <b>&lt;driver name='vhost' txmode='iothread' ioeventfd='on' event_idx='off' queues='5' rx_queue_size='256'&gt; + &lt;host csum='off' gso='off' tso4='off' tso6='off' ecn='off' ufo='off' mrg_rxbuf='off'/&gt; + &lt;guest csum='off' tso4='off' tso6='off' ecn='off' ufo='off'/&gt; + &lt;/driver&gt; + </b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> Some NICs may have tunable driver-specific options. These are @@ -4876,17 +4876,17 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementsBackendOptions">Setting network backend-specific options</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet1'/&gt; - &lt;model type='virtio'/&gt; - <b>&lt;backend tap='/dev/net/tun' vhost='/dev/vhost-net'/&gt;</b> - &lt;driver name='vhost' txmode='iothread' ioeventfd='on' event_idx='off' queues='5'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet1'/&gt; + &lt;model type='virtio'/&gt; + <b>&lt;backend tap='/dev/net/tun' vhost='/dev/vhost-net'/&gt;</b> + &lt;driver name='vhost' txmode='iothread' ioeventfd='on' event_idx='off' queues='5'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> For tuning the backend of the network, the <code>backend</code> element @@ -4899,14 +4899,14 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementsNICSTargetOverride">Overriding the target element</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - <b>&lt;target dev='vnet1'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + <b>&lt;target dev='vnet1'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> If no target is specified, certain hypervisors will @@ -4925,27 +4925,27 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - <b>&lt;guest dev='myeth'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + <b>&lt;guest dev='myeth'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <h5><a name="elementsNICSBoot">Specifying boot order</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet1'/&gt; - <b>&lt;boot order='1'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet1'/&gt; + <b>&lt;boot order='1'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> For hypervisors which support this, you can set a specific NIC to @@ -4960,15 +4960,15 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementsNICSROM">Interface ROM BIOS configuration</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet1'/&gt; - <b>&lt;rom bar='on' file='/etc/fake/boot.bin'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet1'/&gt; + <b>&lt;rom bar='on' file='/etc/fake/boot.bin'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> For hypervisors which support this, you can change how a PCI Network @@ -4988,16 +4988,16 @@ qemu-kvm -net nic,model=? /dev/null </p> <h5><a name="elementDomain">Setting up a network backend in a driver domain</a></h5> <pre> +... +&lt;devices&gt; ... - &lt;devices&gt; - ... - &lt;interface type='bridge'&gt; - &lt;source bridge='br0'/&gt; - <b>&lt;backenddomain name='netvm'/&gt;</b> - &lt;/interface&gt; - ... - &lt;/devices&gt; - ...</pre> + &lt;interface type='bridge'&gt; + &lt;source bridge='br0'/&gt; + <b>&lt;backenddomain name='netvm'/&gt;</b> + &lt;/interface&gt; + ... +&lt;/devices&gt; +...</pre> <p> The optional <code>backenddomain</code> element allows specifying a @@ -5013,18 +5013,18 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementQoS">Quality of service</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet0'/&gt; - <b>&lt;bandwidth&gt; - &lt;inbound average='1000' peak='5000' floor='200' burst='1024'/&gt; - &lt;outbound average='128' peak='256' burst='256'/&gt; - &lt;/bandwidth&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet0'/&gt; + <b>&lt;bandwidth&gt; + &lt;inbound average='1000' peak='5000' floor='200' burst='1024'/&gt; + &lt;outbound average='128' peak='256' burst='256'/&gt; + &lt;/bandwidth&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> This part of interface XML provides setting quality of service. Incoming @@ -5037,26 +5037,26 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementVlanTag">Setting VLAN tag (on supported network types only)</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='bridge'&gt; - <b>&lt;vlan&gt;</b> - <b>&lt;tag id='42'/&gt;</b> - <b>&lt;/vlan&gt;</b> - &lt;source bridge='ovsbr0'/&gt; - &lt;virtualport type='openvswitch'&gt; - &lt;parameters interfaceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; - &lt;/virtualport&gt; - &lt;/interface&gt; - &lt;interface type='bridge'&gt; - <b>&lt;vlan trunk='yes'&gt;</b> - <b>&lt;tag id='42'/&gt;</b> - <b>&lt;tag id='123' nativeMode='untagged'/&gt;</b> - <b>&lt;/vlan&gt;</b> - ... - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='bridge'&gt; + <b>&lt;vlan&gt;</b> + <b>&lt;tag id='42'/&gt;</b> + <b>&lt;/vlan&gt;</b> + &lt;source bridge='ovsbr0'/&gt; + &lt;virtualport type='openvswitch'&gt; + &lt;parameters interfaceid='09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f'/&gt; + &lt;/virtualport&gt; + &lt;/interface&gt; + &lt;interface type='bridge'&gt; + <b>&lt;vlan trunk='yes'&gt;</b> + <b>&lt;tag id='42'/&gt;</b> + <b>&lt;tag id='123' nativeMode='untagged'/&gt;</b> + <b>&lt;/vlan&gt;</b> + ... + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> If (and only if) the network connection used by the guest @@ -5104,15 +5104,15 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="elementLink">Modifying virtual link state</a></h5> <pre> - ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet0'/&gt; - <b>&lt;link state='down'/&gt;</b> - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet0'/&gt; + <b>&lt;link state='down'/&gt;</b> + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> This element provides means of setting state of the virtual network link. @@ -5125,28 +5125,28 @@ qemu-kvm -net nic,model=? /dev/null <h5><a name="ipconfig">IP configuration</a></h5> <pre> +... +&lt;devices&gt; + &lt;interface type='network'&gt; + &lt;source network='default'/&gt; + &lt;target dev='vnet0'/&gt; + <b>&lt;ip address='192.168.122.5' prefix='24'/&gt;</b> + <b>&lt;ip address='192.168.122.5' prefix='24' peer='10.0.0.10'/&gt;</b> + <b>&lt;route family='ipv4' address='192.168.122.0' prefix='24' gateway='192.168.122.1'/&gt;</b> + <b>&lt;route family='ipv4' address='192.168.122.8' gateway='192.168.122.1'/&gt;</b> + &lt;/interface&gt; ... - &lt;devices&gt; - &lt;interface type='network'&gt; - &lt;source network='default'/&gt; - &lt;target dev='vnet0'/&gt; - <b>&lt;ip address='192.168.122.5' prefix='24'/&gt;</b> - <b>&lt;ip address='192.168.122.5' prefix='24' peer='10.0.0.10'/&gt;</b> - <b>&lt;route family='ipv4' address='192.168.122.0' prefix='24' gateway='192.168.122.1'/&gt;</b> - <b>&lt;route family='ipv4' address='192.168.122.8' gateway='192.168.122.1'/&gt;</b> - &lt;/interface&gt; - ... - &lt;hostdev mode='capabilities' type='net'&gt; - &lt;source&gt; - &lt;interface&gt;eth0&lt;/interface&gt; - &lt;/source&gt; - <b>&lt;ip address='192.168.122.6' prefix='24'/&gt;</b> - <b>&lt;route family='ipv4' address='192.168.122.0' prefix='24' gateway='192.168.122.1'/&gt;</b> - <b>&lt;route family='ipv4' address='192.168.122.8' gateway='192.168.122.1'/&gt;</b> - &lt;/hostdev&gt; + &lt;hostdev mode='capabilities' type='net'&gt; + &lt;source&gt; + &lt;interface&gt;eth0&lt;/interface&gt; + &lt;/source&gt; + <b>&lt;ip address='192.168.122.6' prefix='24'/&gt;</b> + <b>&lt;route family='ipv4' address='192.168.122.0' prefix='24' gateway='192.168.122.1'/&gt;</b> + <b>&lt;route family='ipv4' address='192.168.122.8' gateway='192.168.122.1'/&gt;</b> + &lt;/hostdev&gt; - &lt;/devices&gt; - ... +&lt;/devices&gt; +... </pre> <p> @@ -5177,19 +5177,19 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;interface type='ethernet'&gt; - <b>&lt;source/&gt;</b> - <b>&lt;ip address='192.168.123.1' prefix='24'/&gt;</b> - <b>&lt;ip address='10.0.0.10' prefix='24' peer='192.168.122.5'/&gt;</b> - <b>&lt;route family='ipv4' address='192.168.42.0' prefix='24' gateway='192.168.123.4'/&gt;</b> - <b>&lt;source/&gt;</b> - ... - &lt;/interface&gt; +... +&lt;devices&gt; + &lt;interface type='ethernet'&gt; + <b>&lt;source/&gt;</b> + <b>&lt;ip address='192.168.123.1' prefix='24'/&gt;</b> + <b>&lt;ip address='10.0.0.10' prefix='24' peer='192.168.122.5'/&gt;</b> + <b>&lt;route family='ipv4' address='192.168.42.0' prefix='24' gateway='192.168.123.4'/&gt;</b> + <b>&lt;source/&gt;</b> ... - &lt;/devices&gt; + &lt;/interface&gt; ... +&lt;/devices&gt; +... </pre> <p> @@ -5212,21 +5212,21 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;interface type='vhostuser'&gt; - &lt;mac address='52:54:00:3b:83:1a'/&gt; - &lt;source type='unix' path='/tmp/vhost1.sock' mode='server'/&gt; - &lt;model type='virtio'/&gt; - &lt;/interface&gt; - &lt;interface type='vhostuser'&gt; - &lt;mac address='52:54:00:3b:83:1b'/&gt; - &lt;source type='unix' path='/tmp/vhost2.sock' mode='client'/&gt; - &lt;model type='virtio'/&gt; - &lt;driver queues='5'/&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;interface type='vhostuser'&gt; + &lt;mac address='52:54:00:3b:83:1a'/&gt; + &lt;source type='unix' path='/tmp/vhost1.sock' mode='server'/&gt; + &lt;model type='virtio'/&gt; + &lt;/interface&gt; + &lt;interface type='vhostuser'&gt; + &lt;mac address='52:54:00:3b:83:1b'/&gt; + &lt;source type='unix' path='/tmp/vhost2.sock' mode='client'/&gt; + &lt;model type='virtio'/&gt; + &lt;driver queues='5'/&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> The <code>&lt;source&gt;</code> element has to be specified @@ -5251,23 +5251,23 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;interface ...&gt; +... +&lt;devices&gt; + &lt;interface ...&gt; + ... + &lt;filterref filter='clean-traffic'/&gt; + &lt;/interface&gt; + &lt;interface ...&gt; + ... + &lt;filterref filter='myfilter'&gt; + &lt;parameter name='IP' value='104.207.129.11'/&gt; + &lt;parameter name='IP6_ADDR' value='2001:19f0:300:2102::'/&gt; + &lt;parameter name='IP6_MASK' value='64'/&gt; ... - &lt;filterref filter='clean-traffic'/&gt; - &lt;/interface&gt; - &lt;interface ...&gt; - ... - &lt;filterref filter='myfilter'&gt; - &lt;parameter name='IP' value='104.207.129.11'/&gt; - &lt;parameter name='IP6_ADDR' value='2001:19f0:300:2102::'/&gt; - &lt;parameter name='IP6_MASK' value='64'/&gt; - ... - &lt;/filterref&gt; - &lt;/interface&gt; - &lt;/devices&gt; - ...</pre> + &lt;/filterref&gt; + &lt;/interface&gt; +&lt;/devices&gt; +...</pre> <p> The <code>filter</code> attribute specifies the name of the nwfilter @@ -5290,18 +5290,18 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;input type='mouse' bus='usb'/&gt; - &lt;input type='keyboard' bus='usb'/&gt; - &lt;input type='mouse' bus='virtio'/&gt; - &lt;input type='keyboard' bus='virtio'/&gt; - &lt;input type='tablet' bus='virtio'/&gt; - &lt;input type='passthrough' bus='virtio'&gt; - &lt;source evdev='/dev/input/event1/&gt; - &lt;/input&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;input type='mouse' bus='usb'/&gt; + &lt;input type='keyboard' bus='usb'/&gt; + &lt;input type='mouse' bus='virtio'/&gt; + &lt;input type='keyboard' bus='virtio'/&gt; + &lt;input type='tablet' bus='virtio'/&gt; + &lt;input type='passthrough' bus='virtio'&gt; + &lt;source evdev='/dev/input/event1/&gt; + &lt;/input&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>input</code></dt> @@ -5336,11 +5336,11 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;hub type='usb'/&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;hub type='usb'/&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>hub</code></dt> @@ -5366,19 +5366,19 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;graphics type='sdl' display=':0.0'/&gt; - &lt;graphics type='vnc' port='5904' sharePolicy='allow-exclusive'&gt; - &lt;listen type='address' address='1.2.3.4'/&gt; - &lt;/graphics&gt; - &lt;graphics type='rdp' autoport='yes' multiUser='yes' /&gt; - &lt;graphics type='desktop' fullscreen='yes'/&gt; - &lt;graphics type='spice'&gt; - &lt;listen type='network' network='rednet'/&gt; - &lt;/graphics&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;graphics type='sdl' display=':0.0'/&gt; + &lt;graphics type='vnc' port='5904' sharePolicy='allow-exclusive'&gt; + &lt;listen type='address' address='1.2.3.4'/&gt; + &lt;/graphics&gt; + &lt;graphics type='rdp' autoport='yes' multiUser='yes' /&gt; + &lt;graphics type='desktop' fullscreen='yes'/&gt; + &lt;graphics type='spice'&gt; + &lt;listen type='network' network='rednet'/&gt; + &lt;/graphics&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>graphics</code></dt> @@ -5488,16 +5488,16 @@ qemu-kvm -net nic,model=? /dev/null and <code>usbredir</code> (<span class="since">since 0.9.12</span>). </p> <pre> - &lt;graphics type='spice' port='-1' tlsPort='-1' autoport='yes'&gt; - &lt;channel name='main' mode='secure'/&gt; - &lt;channel name='record' mode='insecure'/&gt; - &lt;image compression='auto_glz'/&gt; - &lt;streaming mode='filter'/&gt; - &lt;clipboard copypaste='no'/&gt; - &lt;mouse mode='client'/&gt; - &lt;filetransfer enable='no'/&gt; - &lt;gl enable='yes'/&gt; - &lt;/graphics&gt;</pre> +&lt;graphics type='spice' port='-1' tlsPort='-1' autoport='yes'&gt; + &lt;channel name='main' mode='secure'/&gt; + &lt;channel name='record' mode='insecure'/&gt; + &lt;image compression='auto_glz'/&gt; + &lt;streaming mode='filter'/&gt; + &lt;clipboard copypaste='no'/&gt; + &lt;mouse mode='client'/&gt; + &lt;filetransfer enable='no'/&gt; + &lt;gl enable='yes'/&gt; +&lt;/graphics&gt;</pre> <p> Spice supports variable compression settings for audio, images and streaming. These settings are accessible via the <code>compression @@ -5652,15 +5652,15 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;video&gt; - &lt;model type='vga' vram='16384' heads='1'&gt; - &lt;acceleration accel3d='yes' accel2d='yes'/&gt; - &lt;/model&gt; - &lt;/video&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;video&gt; + &lt;model type='vga' vram='16384' heads='1'&gt; + &lt;acceleration accel3d='yes' accel2d='yes'/&gt; + &lt;/model&gt; + &lt;/video&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>video</code></dt> @@ -5750,32 +5750,32 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;parallel type='pty'&gt; - &lt;source path='/dev/pts/2'/&gt; - &lt;target port='0'/&gt; - &lt;/parallel&gt; - &lt;serial type='pty'&gt; - &lt;source path='/dev/pts/3'/&gt; - &lt;target port='0'/&gt; - &lt;/serial&gt; - &lt;serial type='file'&gt; - &lt;source path='/tmp/file' append='on'&gt; - &lt;seclabel model='dac' relabel='no'/&gt; - &lt;/source&gt; - &lt;target port='0'/&gt; - &lt;/serial&gt; - &lt;console type='pty'&gt; - &lt;source path='/dev/pts/4'/&gt; - &lt;target port='0'/&gt; - &lt;/console&gt; - &lt;channel type='unix'&gt; - &lt;source mode='bind' path='/tmp/guestfwd'/&gt; - &lt;target type='guestfwd' address='10.0.2.1' port='4600'/&gt; - &lt;/channel&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;parallel type='pty'&gt; + &lt;source path='/dev/pts/2'/&gt; + &lt;target port='0'/&gt; + &lt;/parallel&gt; + &lt;serial type='pty'&gt; + &lt;source path='/dev/pts/3'/&gt; + &lt;target port='0'/&gt; + &lt;/serial&gt; + &lt;serial type='file'&gt; + &lt;source path='/tmp/file' append='on'&gt; + &lt;seclabel model='dac' relabel='no'/&gt; + &lt;/source&gt; + &lt;target port='0'/&gt; + &lt;/serial&gt; + &lt;console type='pty'&gt; + &lt;source path='/dev/pts/4'/&gt; + &lt;target port='0'/&gt; + &lt;/console&gt; + &lt;channel type='unix'&gt; + &lt;source mode='bind' path='/tmp/guestfwd'/&gt; + &lt;target type='guestfwd' address='10.0.2.1' port='4600'/&gt; + &lt;/channel&gt; +&lt;/devices&gt; +...</pre> <p> In each of these directives, the top-level element name (parallel, serial, @@ -5815,9 +5815,9 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;log file="/var/log/libvirt/qemu/guestname-serial0.log" append="off"/&gt; - ...</pre> +... +&lt;log file="/var/log/libvirt/qemu/guestname-serial0.log" append="off"/&gt; +...</pre> <p> Each character device element has an optional @@ -5837,14 +5837,14 @@ qemu-kvm -net nic,model=? /dev/null <h6><a name="elementCharParallel">Parallel port</a></h6> <pre> - ... - &lt;devices&gt; - &lt;parallel type='pty'&gt; - &lt;source path='/dev/pts/2'/&gt; - &lt;target port='0'/&gt; - &lt;/parallel&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;parallel type='pty'&gt; + &lt;source path='/dev/pts/2'/&gt; + &lt;target port='0'/&gt; + &lt;/parallel&gt; +&lt;/devices&gt; +...</pre> <p> <code>target</code> can have a <code>port</code> attribute, which @@ -5855,14 +5855,14 @@ qemu-kvm -net nic,model=? /dev/null <h6><a name="elementCharSerial">Serial port</a></h6> <pre> - ... - &lt;devices&gt; - &lt;serial type='pty'&gt; - &lt;source path='/dev/pts/3'/&gt; - &lt;target port='0'/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type='pty'&gt; + &lt;source path='/dev/pts/3'/&gt; + &lt;target port='0'/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <p> <code>target</code> can have a <code>port</code> attribute, which @@ -5921,31 +5921,31 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;console type='pty'&gt; - &lt;source path='/dev/pts/4'/&gt; - &lt;target port='0'/&gt; - &lt;/console&gt; +... +&lt;devices&gt; + &lt;console type='pty'&gt; + &lt;source path='/dev/pts/4'/&gt; + &lt;target port='0'/&gt; + &lt;/console&gt; - &lt;!-- KVM virtio console --&gt; - &lt;console type='pty'&gt; - &lt;source path='/dev/pts/5'/&gt; - &lt;target type='virtio' port='0'/&gt; - &lt;/console&gt; - &lt;/devices&gt; - ...</pre> + &lt;!-- KVM virtio console --&gt; + &lt;console type='pty'&gt; + &lt;source path='/dev/pts/5'/&gt; + &lt;target type='virtio' port='0'/&gt; + &lt;/console&gt; +&lt;/devices&gt; +...</pre> <pre> - ... - &lt;devices&gt; - &lt;!-- KVM S390 sclp console --&gt; - &lt;console type='pty'&gt; - &lt;source path='/dev/pts/1'/&gt; - &lt;target type='sclp' port='0'/&gt; - &lt;/console&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;!-- KVM S390 sclp console --&gt; + &lt;console type='pty'&gt; + &lt;source path='/dev/pts/1'/&gt; + &lt;target type='sclp' port='0'/&gt; + &lt;/console&gt; +&lt;/devices&gt; +...</pre> <p> If the console is presented as a serial port, the <code>target</code> @@ -5961,26 +5961,26 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;channel type='unix'&gt; - &lt;source mode='bind' path='/tmp/guestfwd'/&gt; - &lt;target type='guestfwd' address='10.0.2.1' port='4600'/&gt; - &lt;/channel&gt; +... +&lt;devices&gt; + &lt;channel type='unix'&gt; + &lt;source mode='bind' path='/tmp/guestfwd'/&gt; + &lt;target type='guestfwd' address='10.0.2.1' port='4600'/&gt; + &lt;/channel&gt; - &lt;!-- KVM virtio channel --&gt; - &lt;channel type='pty'&gt; - &lt;target type='virtio' name='arbitrary.virtio.serial.port.name'/&gt; - &lt;/channel&gt; - &lt;channel type='unix'&gt; - &lt;source mode='bind' path='/var/lib/libvirt/qemu/f16x86_64.agent'/&gt; - &lt;target type='virtio' name='org.qemu.guest_agent.0' state='connected'/&gt; - &lt;/channel&gt; - &lt;channel type='spicevmc'&gt; - &lt;target type='virtio' name='com.redhat.spice.0'/&gt; - &lt;/channel&gt; - &lt;/devices&gt; - ...</pre> + &lt;!-- KVM virtio channel --&gt; + &lt;channel type='pty'&gt; + &lt;target type='virtio' name='arbitrary.virtio.serial.port.name'/&gt; + &lt;/channel&gt; + &lt;channel type='unix'&gt; + &lt;source mode='bind' path='/var/lib/libvirt/qemu/f16x86_64.agent'/&gt; + &lt;target type='virtio' name='org.qemu.guest_agent.0' state='connected'/&gt; + &lt;/channel&gt; + &lt;channel type='spicevmc'&gt; + &lt;target type='virtio' name='com.redhat.spice.0'/&gt; + &lt;/channel&gt; +&lt;/devices&gt; +...</pre> <p> This can be implemented in a variety of ways. The specific type of @@ -6060,13 +6060,13 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;console type='stdio'&gt; - &lt;target port='1'/&gt; - &lt;/console&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;console type='stdio'&gt; + &lt;target port='1'/&gt; + &lt;/console&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharFle">Device logfile</a></h6> @@ -6077,14 +6077,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="file"&gt; - &lt;source path="/var/log/vm/vm-serial.log"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="file"&gt; + &lt;source path="/var/log/vm/vm-serial.log"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharVC">Virtual console</a></h6> @@ -6095,13 +6095,13 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type='vc'&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type='vc'&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharNull">Null device</a></h6> @@ -6111,13 +6111,13 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type='null'&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type='null'&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharPTY">Pseudo TTY</a></h6> @@ -6128,14 +6128,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="pty"&gt; - &lt;source path="/dev/pts/3"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="pty"&gt; + &lt;source path="/dev/pts/3"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <p> NB special case if &lt;console type='pty'&gt;, then the TTY @@ -6155,14 +6155,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="dev"&gt; - &lt;source path="/dev/ttyS0"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="dev"&gt; + &lt;source path="/dev/ttyS0"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharPipe">Named pipe</a></h6> @@ -6172,14 +6172,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="pipe"&gt; - &lt;source path="/tmp/mypipe"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="pipe"&gt; + &lt;source path="/tmp/mypipe"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharTCP">TCP client/server</a></h6> @@ -6189,30 +6189,30 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="tcp"&gt; - &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; - &lt;protocol type="raw"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="tcp"&gt; + &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; + &lt;protocol type="raw"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; + ...</pre> <p> Or as a TCP server waiting for a client connection. </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="tcp"&gt; - &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt; - &lt;protocol type="raw"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="tcp"&gt; + &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt; + &lt;protocol type="raw"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <p> Alternatively you can use <code>telnet</code> instead @@ -6226,21 +6226,21 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> +... +&lt;devices&gt; + &lt;serial type="tcp"&gt; + &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; + &lt;protocol type="telnet"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; ... - &lt;devices&gt; - &lt;serial type="tcp"&gt; - &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; - &lt;protocol type="telnet"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - ... - &lt;serial type="tcp"&gt; - &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt; - &lt;protocol type="telnet"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> + &lt;serial type="tcp"&gt; + &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt; + &lt;protocol type="telnet"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <p> <span class="since">Since 2.4.0,</span> the optional attribute @@ -6260,15 +6260,15 @@ qemu-kvm -net nic,model=? /dev/null or <code>default_tls_x509_cert_dir</code> TLS directory structure exists. </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="tcp"&gt; - &lt;source mode='connect' host="127.0.0.1" service="5555" tls="yes"/&gt; - &lt;protocol type="raw"/&gt; - &lt;target port="0"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="tcp"&gt; + &lt;source mode='connect' host="127.0.0.1" service="5555" tls="yes"/&gt; + &lt;protocol type="raw"/&gt; + &lt;target port="0"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharUDP">UDP network console</a></h6> @@ -6278,15 +6278,15 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="udp"&gt; - &lt;source mode="bind" host="0.0.0.0" service="2445"/&gt; - &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="udp"&gt; + &lt;source mode="bind" host="0.0.0.0" service="2445"/&gt; + &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharUNIX">UNIX domain socket client/server</a></h6> @@ -6296,14 +6296,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="unix"&gt; - &lt;source mode="bind" path="/tmp/foo"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="unix"&gt; + &lt;source mode="bind" path="/tmp/foo"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsCharSpiceport">Spice channel</a></h6> @@ -6319,14 +6319,14 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="spiceport"&gt; - &lt;source channel="org.qemu.console.serial.0"/&gt; - &lt;target port="1"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="spiceport"&gt; + &lt;source channel="org.qemu.console.serial.0"/&gt; + &lt;target port="1"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <h6><a name="elementsNmdm">Nmdm device</a></h6> @@ -6337,13 +6337,13 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;serial type="nmdm"&gt; - &lt;source master="/dev/nmdm0A" slave="/dev/nmdm0B"/&gt; - &lt;/serial&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;serial type="nmdm"&gt; + &lt;source master="/dev/nmdm0A" slave="/dev/nmdm0B"/&gt; + &lt;/serial&gt; +&lt;/devices&gt; +...</pre> <p> The <code>source</code> element has these attributes: @@ -6367,11 +6367,11 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;sound model='es1370'/&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;sound model='es1370'/&gt; +&lt;/devices&gt; +...</pre> <dl> <dt><code>sound</code></dt> @@ -6397,13 +6397,13 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;sound model='ich6'&gt; - &lt;codec type='micro'/&gt; - &lt;/sound&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;sound model='ich6'&gt; + &lt;codec type='micro'/&gt; + &lt;/sound&gt; +&lt;/devices&gt; +...</pre> <p> Each <code>sound</code> element has an optional @@ -6433,11 +6433,11 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;watchdog model='i6300esb'/&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;watchdog model='i6300esb'/&gt; +&lt;/devices&gt; +...</pre> <pre> ... @@ -6520,11 +6520,11 @@ qemu-kvm -net nic,model=? /dev/null Example: automatically added device with KVM </p> <pre> - ... - &lt;devices&gt; - &lt;memballoon model='virtio'/&gt; - &lt;/devices&gt; - ...</pre> +... +&lt;devices&gt; + &lt;memballoon model='virtio'/&gt; +&lt;/devices&gt; +...</pre> <p> Example: manually added device with static PCI slot 2 requested @@ -6592,19 +6592,19 @@ qemu-kvm -net nic,model=? /dev/null Example: usage of the RNG device: </p> <pre> - ... - &lt;devices&gt; - &lt;rng model='virtio'&gt; - &lt;rate period="2000" bytes="1234"/&gt; - &lt;backend model='random'&gt;/dev/random&lt;/backend&gt; - &lt;!-- OR --&gt; - &lt;backend model='egd' type='udp'&gt; - &lt;source mode='bind' service='1234'/&gt; - &lt;source mode='connect' host='1.2.3.4' service='1234'/&gt; - &lt;/backend&gt; - &lt;/rng&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;rng model='virtio'&gt; + &lt;rate period="2000" bytes="1234"/&gt; + &lt;backend model='random'&gt;/dev/random&lt;/backend&gt; + &lt;!-- OR --&gt; + &lt;backend model='egd' type='udp'&gt; + &lt;source mode='bind' service='1234'/&gt; + &lt;source mode='connect' host='1.2.3.4' service='1234'/&gt; + &lt;/backend&gt; + &lt;/rng&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>model</code></dt> @@ -6680,15 +6680,15 @@ qemu-kvm -net nic,model=? /dev/null Example: usage of the TPM passthrough device </p> <pre> - ... - &lt;devices&gt; - &lt;tpm model='tpm-tis'&gt; - &lt;backend type='passthrough'&gt; - &lt;device path='/dev/tpm0'/&gt; - &lt;/backend&gt; - &lt;/tpm&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;tpm model='tpm-tis'&gt; + &lt;backend type='passthrough'&gt; + &lt;device path='/dev/tpm0'/&gt; + &lt;/backend&gt; + &lt;/tpm&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>model</code></dt> @@ -6734,13 +6734,13 @@ qemu-kvm -net nic,model=? /dev/null Example: usage of NVRAM configuration </p> <pre> - ... - &lt;devices&gt; - &lt;nvram&gt; - &lt;address type='spapr-vio' reg='0x3000'/&gt; - &lt;/nvram&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;nvram&gt; + &lt;address type='spapr-vio' reg='0x3000'/&gt; + &lt;/nvram&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>spapr-vio</code></dt> @@ -6778,14 +6778,14 @@ qemu-kvm -net nic,model=? /dev/null Example: usage of panic configuration </p> <pre> - ... - &lt;devices&gt; - &lt;panic model='hyperv'/&gt; - &lt;panic model='isa'&gt; - &lt;address type='isa' iobase='0x505'/&gt; - &lt;/panic&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;panic model='hyperv'/&gt; + &lt;panic model='isa'&gt; + &lt;address type='isa' iobase='0x505'/&gt; + &lt;/panic&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>model</code></dt> @@ -6823,20 +6823,20 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - ... - &lt;devices&gt; - &lt;shmem name='my_shmem0'&gt; - &lt;model type='ivshmem-plain'/&gt; - &lt;size unit='M'&gt;4&lt;/size&gt; - &lt;/shmem&gt; - &lt;shmem name='shmem_server'&gt; - &lt;model type='ivshmem-doorbell'/&gt; - &lt;size unit='M'&gt;2&lt;/size&gt; - &lt;server path='/tmp/socket-shmem'/&gt; - &lt;msi vectors='32' ioeventfd='on'/&gt; - &lt;/shmem&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;shmem name='my_shmem0'&gt; + &lt;model type='ivshmem-plain'/&gt; + &lt;size unit='M'&gt;4&lt;/size&gt; + &lt;/shmem&gt; + &lt;shmem name='shmem_server'&gt; + &lt;model type='ivshmem-doorbell'/&gt; + &lt;size unit='M'&gt;2&lt;/size&gt; + &lt;server path='/tmp/socket-shmem'/&gt; + &lt;msi vectors='32' ioeventfd='on'/&gt; + &lt;/shmem&gt; +&lt;/devices&gt; +... </pre> <dl> @@ -6896,26 +6896,26 @@ qemu-kvm -net nic,model=? /dev/null Example: usage of the memory devices </p> <pre> - ... - &lt;devices&gt; - &lt;memory model='dimm'&gt; - &lt;target&gt; - &lt;size unit='KiB'&gt;524287&lt;/size&gt; - &lt;node&gt;0&lt;/node&gt; - &lt;/target&gt; - &lt;/memory&gt; - &lt;memory model='dimm'&gt; - &lt;source&gt; - &lt;pagesize unit='KiB'&gt;4096&lt;/pagesize&gt; - &lt;nodemask&gt;1-3&lt;/nodemask&gt; - &lt;/source&gt; - &lt;target&gt; - &lt;size unit='KiB'&gt;524287&lt;/size&gt; - &lt;node&gt;1&lt;/node&gt; - &lt;/target&gt; - &lt;/memory&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;memory model='dimm'&gt; + &lt;target&gt; + &lt;size unit='KiB'&gt;524287&lt;/size&gt; + &lt;node&gt;0&lt;/node&gt; + &lt;/target&gt; + &lt;/memory&gt; + &lt;memory model='dimm'&gt; + &lt;source&gt; + &lt;pagesize unit='KiB'&gt;4096&lt;/pagesize&gt; + &lt;nodemask&gt;1-3&lt;/nodemask&gt; + &lt;/source&gt; + &lt;target&gt; + &lt;size unit='KiB'&gt;524287&lt;/size&gt; + &lt;node&gt;1&lt;/node&gt; + &lt;/target&gt; + &lt;/memory&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>model</code></dt> @@ -6975,11 +6975,11 @@ qemu-kvm -net nic,model=? /dev/null Example: </p> <pre> - ... - &lt;devices&gt; - &lt;iommu model='intel'/&gt; - &lt;/devices&gt; - ... +... +&lt;devices&gt; + &lt;iommu model='intel'/&gt; +&lt;/devices&gt; +... </pre> <dl> <dt><code>model</code></dt> @@ -7021,21 +7021,21 @@ qemu-kvm -net nic,model=? /dev/null </p> <pre> - &lt;seclabel type='dynamic' model='selinux'/&gt; +&lt;seclabel type='dynamic' model='selinux'/&gt; - &lt;seclabel type='dynamic' model='selinux'&gt; - &lt;baselabel&gt;system_u:system_r:my_svirt_t:s0&lt;/baselabel&gt; - &lt;/seclabel&gt; +&lt;seclabel type='dynamic' model='selinux'&gt; + &lt;baselabel&gt;system_u:system_r:my_svirt_t:s0&lt;/baselabel&gt; +&lt;/seclabel&gt; - &lt;seclabel type='static' model='selinux' relabel='no'&gt; - &lt;label&gt;system_u:system_r:svirt_t:s0:c392,c662&lt;/label&gt; - &lt;/seclabel&gt; +&lt;seclabel type='static' model='selinux' relabel='no'&gt; + &lt;label&gt;system_u:system_r:svirt_t:s0:c392,c662&lt;/label&gt; +&lt;/seclabel&gt; - &lt;seclabel type='static' model='selinux' relabel='yes'&gt; - &lt;label&gt;system_u:system_r:svirt_t:s0:c392,c662&lt;/label&gt; - &lt;/seclabel&gt; +&lt;seclabel type='static' model='selinux' relabel='yes'&gt; + &lt;label&gt;system_u:system_r:svirt_t:s0:c392,c662&lt;/label&gt; +&lt;/seclabel&gt; - &lt;seclabel type='none'/&gt; +&lt;seclabel type='none'/&gt; </pre> <p> -- 2.8.4