External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-02-22 11:22:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Document support for obeying <backingStore> of <disk> on input

Browse Source 
Until now we've only supported <backingStore> in an output mode. The
documentation for the element states that hypervisor drivers may start
to obey it in the future.

Update the documentation so that it mentions the recently added
'backingStoreInput' domain capability and explain what happens if it is
supported and <backingStore> is present on input.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
Peter Krempa 2019-11-18 16:51:20 +01:00
parent 757203ee52
commit 4321bd0dd2
1 changed files with 20 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/formatdomain.html.in
View File

@ -3340,15 +3340,26 @@
<dt><code>backingStore</code></dt> <dt><code>backingStore</code></dt>
<dd> <dd>
This element describes the backing store used by the disk This element describes the backing store used by the disk
specified by sibling <code>source</code> element. It is specified by sibling <code>source</code> element.
currently ignored on input and only used for output to <span class="since">Since 1.2.4.</span>
describe the detected backing chains of running
domains <span class="since">since 1.2.4</span> (although a If the hypervisor driver does not support the
future version of libvirt may start accepting chains on input, <a href='formatdomaincaps.html#featureBackingStoreInput'>
or output information for offline domains). An <code>backingStoreInput</code></a>
empty <code>backingStore</code> element means the sibling (<span class='since'>Since 5.10.0</span>)
source is self-contained and is not based on any backing domain feature the <code>backingStore</code> is ignored on
store. For backing chain information to be accurate, the input and only used for output to describe the detected
backing chains of running domains.
If <code>backingStoreInput</code> is supported
the <code>backingStore</code> is used as the backing image of
<code>source</code> or other <code>backingStore</code> overriding
any backing image information recorded in the image metadata.
An empty <code>backingStore</code> element means the sibling
source is self-contained and is not based on any backing store.
For the detected backing chain information to be accurate, the
backing format must be correctly specified in the metadata of backing format must be correctly specified in the metadata of
each file of the chain (files created by libvirt satisfy this each file of the chain (files created by libvirt satisfy this
property, but using existing external files for snapshot or property, but using existing external files for snapshot or