[libvirt] [PATCH 2/9] 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>
---
docs/formatdomain.html.in | 13 +++++++++----
docs/schemas/domaincommon.rng | 8 ++++++++
2 files changed, 17 insertions(+), 4 deletions(-)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index a61895f..158bafa 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1091,7 +1091,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'>
@@ -1202,10 +1202,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 3908733..e1e1027 100644
--- a/docs/schemas/domaincommon.rng
+++ b/docs/schemas/domaincommon.rng
@@ -959,6 +959,14 @@
</choice>
</attribute>
</optional>
+ <optional>
+ <attribute name="tray">
+ <choice>
+ <value>open</value>
+ <value>closed</value>
+ </choice>
+ </attribute>
+ </optional>
</element>
</define>
<!--
--
1.7.1