mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-03-03 15:43:51 +00:00
docs: Emphasize that devices have to be inside the <devices> element
Also cleanup indentation of domain XML examples.
This commit is contained in:
Matthias Bolte
parent
0b907122b7
commit
ce71bfa817
@ -412,6 +412,7 @@
|
||||
...
|
||||
<devices>
|
||||
<emulator>/usr/lib/xen/bin/qemu-dm</emulator>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -435,6 +436,7 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<disk type='file'>
|
||||
<driver name="tap" type="aio" cache="default">
|
||||
<source file='/var/lib/xen/images/fv0'/>
|
||||
@ -444,6 +446,7 @@
|
||||
</encryption>
|
||||
<shareable/>
|
||||
</disk>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -502,21 +505,27 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<hostdev mode='subsystem' type='usb'>
|
||||
<source>
|
||||
<vendor id='0x1234'/>
|
||||
<product id='0xbeef'/>
|
||||
</source>
|
||||
</hostdev>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>or:</p>
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<hostdev mode='subsystem' type='pci'>
|
||||
<source>
|
||||
<address bus='0x06' slot='0x02' function='0x0'/>
|
||||
</source>
|
||||
</hostdev>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -558,11 +567,13 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='bridge'>
|
||||
<source bridge='xenbr0'/>
|
||||
<mac address='00:16:3e:5d:c7:9e'/>
|
||||
<script path='vif-bridge'/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSVirtual">Virtual network</a></h5>
|
||||
@ -591,6 +602,7 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='network'>
|
||||
<source network='default'/>
|
||||
</interface>
|
||||
@ -600,6 +612,7 @@
|
||||
<target dev='vnet7'/>
|
||||
<mac address="11:22:33:44:55:66"/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSBridge">Bridge to LAN</a></h5>
|
||||
@ -625,15 +638,17 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='bridge'>
|
||||
<source bridge='br0'/>
|
||||
</interface>
|
||||
|
||||
...
|
||||
<interface type='bridge'>
|
||||
<source bridge='br0'/>
|
||||
<target dev='vnet7'/>
|
||||
<mac address="11:22:33:44:55:66"/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSSlirp">Userspace SLIRP stack</a></h5>
|
||||
@ -649,11 +664,13 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='user'/>
|
||||
...
|
||||
<interface type='user'>
|
||||
<mac address="11:22:33:44:55:66"/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
|
||||
@ -671,12 +688,14 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='ethernet'/>
|
||||
...
|
||||
<interface type='ethernet'>
|
||||
<target dev='vnet7'/>
|
||||
<script path='/etc/qemu-ifup-mynet'/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSMulticast">Multicast tunnel</a></h5>
|
||||
@ -695,9 +714,11 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='mcast'>
|
||||
<source address='230.0.0.1' port='5558'/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSTCP">TCP tunnel</a></h5>
|
||||
@ -713,6 +734,7 @@
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='server'>
|
||||
<source address='192.168.0.1' port='5558'/>
|
||||
</interface>
|
||||
@ -720,17 +742,20 @@
|
||||
<interface type='client'>
|
||||
<source address='192.168.0.1' port='5558'/>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h5><a name="elementsNICSModel">Setting the NIC model</a></h5>
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='network'>
|
||||
<source network='default'/>
|
||||
<target dev='vnet1'/>
|
||||
<b><model type='ne2k_pci'/></b>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -759,10 +784,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<interface type='network'>
|
||||
<source network='default'/>
|
||||
<b><target dev='vnet1'/></b>
|
||||
</interface>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -785,7 +812,9 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<input type='mouse' bus='usb'/>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -809,10 +838,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<graphics type='sdl' display=':0.0'/>
|
||||
<graphics type='vnc' port='5904'/>
|
||||
<graphics type='rdp' autoport='yes' multiUser='yes' />
|
||||
<graphics type='desktop' fullscreen='yes'/>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -869,11 +900,13 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<video>
|
||||
<model type='vga' vram='8192' heads='1'>
|
||||
<acceleration accel3d='yes' accel3d='yes'/>
|
||||
</model>
|
||||
</video>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -909,6 +942,7 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<parallel type='pty'>
|
||||
<source path='/dev/pts/2'/>
|
||||
<target port='0'/>
|
||||
@ -926,7 +960,7 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
<target type='guestfwd' address='10.0.2.1' port='4600'/>
|
||||
</channel>
|
||||
</devices>
|
||||
</domain></pre>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
In each of these directives, the top-level element name (parallel, serial,
|
||||
@ -951,10 +985,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<parallel type='pty'>
|
||||
<source path='/dev/pts/2'/>
|
||||
<target port='0'/>
|
||||
</parallel>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -967,10 +1003,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type='pty'>
|
||||
<source path='/dev/pts/3'/>
|
||||
<target port='0'/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -989,10 +1027,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<console type='pty'>
|
||||
<source path='/dev/pts/4'/>
|
||||
<target port='0'/>
|
||||
</console>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -1010,10 +1050,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<channel type='unix'>
|
||||
<source mode='bind' path='/tmp/guestfwd'/>
|
||||
<target type='guestfwd' address='10.0.2.1' port='4600'/>
|
||||
</channel>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -1047,9 +1089,11 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<console type='stdio'>
|
||||
<target port='1'>
|
||||
</console>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
|
||||
@ -1062,10 +1106,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="file">
|
||||
<source path="/var/log/vm/vm-serial.log"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharVC">Virtual console</a></h6>
|
||||
@ -1078,9 +1124,11 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type='vc'>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharNull">Null device</a></h6>
|
||||
@ -1092,9 +1140,11 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type='null'>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharPTY">Pseudo TTY</a></h6>
|
||||
@ -1107,10 +1157,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="pty">
|
||||
<source path="/dev/pts/3"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -1132,10 +1184,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="dev">
|
||||
<source path="/dev/ttyS0"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharPipe">Named pipe</a></h6>
|
||||
@ -1147,10 +1201,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="pipe">
|
||||
<source path="/tmp/mypipe"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharTCP">TCP client/server</a></h6>
|
||||
@ -1162,11 +1218,13 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="tcp">
|
||||
<source mode="connect" host="0.0.0.0" service="2445"/>
|
||||
<protocol type="raw"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -1175,11 +1233,13 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="tcp">
|
||||
<source mode="bind" host="127.0.0.1" service="2445"/>
|
||||
<protocol type="raw"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
@ -1188,6 +1248,7 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="tcp">
|
||||
<source mode="connect" host="0.0.0.0" service="2445"/>
|
||||
<protocol type="telnet"/>
|
||||
@ -1199,6 +1260,7 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
<protocol type="telnet"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharUDP">UDP network console</a></h6>
|
||||
@ -1210,11 +1272,13 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="udp">
|
||||
<source mode="bind" host="0.0.0.0" service="2445"/>
|
||||
<source mode="connect" host="0.0.0.0" service="2445"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<h6><a name="elementsCharUNIX">UNIX domain socket client/server</a></h6>
|
||||
@ -1226,10 +1290,12 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<serial type="unix">
|
||||
<source mode="bind" path="/tmp/foo"/>
|
||||
<target port="1"/>
|
||||
</serial>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
|
||||
@ -1242,7 +1308,9 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<sound model='es1370'/>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<dl>
|
||||
@ -1278,13 +1346,17 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<watchdog model='i6300esb'/>
|
||||
</devices>
|
||||
...</pre>
|
||||
|
||||
<pre>
|
||||
...
|
||||
<devices>
|
||||
<watchdog model='i6300esb' action='poweroff'/>
|
||||
...</pre>
|
||||
</devices>
|
||||
</domain></pre>
|
||||
|
||||
<dl>
|
||||
<dt><code>model</code></dt>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user