[libvirt] [PATCH v2] doc: Fix doc for backingStore

Deepak Shetty dpkshetty at gmail.com
Wed Mar 18 13:48:22 UTC 2015


I spent quite some time figuring that backingStore info
isn't included in the dom xml, unless guest is up and
running. Hopefully putting that in the doc should help.

This patch adds that info to the doc.

Signed-off-by: Deepak C Shetty <deepakcs at redhat.com>
---
 docs/formatdomain.html.in | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index ab51982..a41c2c6 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -2113,7 +2113,12 @@
         and only used for output to describe the detected backing chains.
         <span class="since">Since 1.2.4</span>. An empty
         <code>backingStore</code> element means the sibling source is
-        self-contained and is not based on any backing store. The following
+        self-contained and is not based on any backing store. Note that
+        <code>backingStore</code> info is included in the output only when
+        the guest is up and running, otherwise it's not included. For
accurate
+        <code>backingStore</code> info, when using external snapshot with
the
+        destination of a existing file, the snapshot must be created with
+        backing file format specified in the metadata. The following
         attributes and sub-elements are supported in
         <code>backingStore</code>:
         <dl>
--
1.9.3
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20150318/615fad9f/attachment-0001.htm>


More information about the libvir-list mailing list