diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index dc6b1526c7451689ef42d0b84dca081ffd936b6f..fcffb2518ef4b8c27af7ebf0f0001d494064d007 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -891,7 +891,7 @@
<devices>
<disk type='file' snapshot='external'>
<driver name="tap" type="aio" cache="default"/>
- <source file='/var/lib/xen/images/fv0'/>
+ <source file='/var/lib/xen/images/fv0'/ startupPolicy='optional'>
<target dev='hda' bus='ide'/>
<boot order='2'/>
<encryption type='...'>
@@ -962,7 +962,29 @@
"network", the source
may have zero or
more host
sub-elements used to specify the hosts
to connect.
- Since 0.0.3
+ Since 0.0.3
+ For "file" disk type which represents cdrom or floppy
+ (the device
attribute) it is possible to define
+ policy what to do with disk if source is not accessible.
+ This is done by startupPolicy
attribute accepting
+ these values:
+
mandatory | +fail if missing for any reason (the default) | +
requisite | +fail if missing on boot up, + drop if missing on migrate/restore/revert | +
optional | +drop if missing at any start attempt | +
target
target
element controls the bus / device
under which the disk is exposed to the guest
diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng
index cd1a067a8e854e5378c5289cd3c3a739c665e026..08cc64f6d01985c8174f2c00944ae7b06a52747b 100644
--- a/docs/schemas/domaincommon.rng
+++ b/docs/schemas/domaincommon.rng
@@ -665,6 +665,17 @@
+
+