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>

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 21372b7cd40bfda135fbd3627c857e6087d4282c..814e270fda3576de389b6cc930a259c8e122fb84 100644 (file)
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1134,7 +1134,7 @@
     </disk>
     <disk type='block' device='cdrom'>
       <driver name='qemu' type='raw'/>
-      <target dev='hdc' bus='ide'/>
+      <target dev='hdc' bus='ide' tray='open'/>
       <readonly/>
     </disk>
     <disk type='block' device='lun'>
@@ -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

diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng
index f62969193c4f31b63c2a3e7aed7c37d0df0eef7c..1f5232ef15a765ffde59142bbe3d762f901e3771 100644 (file)
--- a/docs/schemas/domaincommon.rng
+++ b/docs/schemas/domaincommon.rng
@@ -967,6 +967,14 @@
           </choice>
         </attribute>
       </optional>
+      <optional>
+        <attribute name="tray">
+          <choice>
+            <value>open</value>
+            <value>closed</value>
+          </choice>
+        </attribute>
+      </optional>
     </element>
   </define>
   <!--