docs: Add documentation for new attribute tray of disk target

Example XML:

    <disk type='file' device='cdrom'>
      <driver name='qemu' type='raw'/>
      <source file='/tmp/cdrom.img'/>
      <target dev='hdd' bus='ide' tray='open'/>
    </disk>
This commit is contained in:
Osier Yang 2012-03-14 23:26:46 +08:00
parent a26a1969c3
commit ab49b392cc
2 changed files with 17 additions and 4 deletions

View File

@ -1134,7 +1134,7 @@
&lt;/disk&gt;
&lt;disk type='block' device='cdrom'&gt;
&lt;driver name='qemu' type='raw'/&gt;
&lt;target dev='hdc' bus='ide'/&gt;
&lt;target dev='hdc' bus='ide' tray='open'/&gt;
&lt;readonly/&gt;
&lt;/disk&gt;
&lt;disk type='block' device='lun'&gt;
@ -1245,10 +1245,15 @@
possible values are driver specific, with typical values being
"ide", "scsi", "virtio", "xen", "usb" or "sata". If omitted, the bus
type is inferred from the style of the device name. eg, a device named
'sda' will typically be exported using a SCSI bus.
'sda' will typically be exported using a SCSI bus. The optional
attribute <code>tray</code> indicates the tray status of the
removable disks (i.e. CDROM or Floppy disk), the value can be either
"open" or "closed", defaults to "closed". NB, the value of
<code>tray</code> could be updated while the domain is running.
<span class="since">Since 0.0.3; <code>bus</code> attribute since 0.4.3;
"usb" attribute value since after 0.4.4; "sata" attribute value since
0.9.7</span></dd>
<code>tray</code> attribute since 0.9.11; "usb" attribute value since
after 0.4.4; "sata" attribute value since 0.9.7</span>
</dd>
<dt><code>iotune</code></dt>
<dd>The optional <code>iotune</code> element provides the
ability to provide additional per-device I/O tuning, with

View File

@ -967,6 +967,14 @@
</choice>
</attribute>
</optional>
<optional>
<attribute name="tray">
<choice>
<value>open</value>
<value>closed</value>
</choice>
</attribute>
</optional>
</element>
</define>
<!--