summaryrefslogtreecommitdiff
path: root/tools
diff options
context:
space:
mode:
authorPeter Krempa <pkrempa@redhat.com>2014-07-11 10:20:33 +0200
committerPeter Krempa <pkrempa@redhat.com>2014-07-14 09:26:26 +0200
commit500f80a595216d38bbd7e462f99e2a7febc988de (patch)
treea5a89f5a79afb245552de3ba368c293d58c07987 /tools
parent270969c4ddee339cfd3b01805603e034fdc875d1 (diff)
downloadlibvirt-500f80a595216d38bbd7e462f99e2a7febc988de.tar.gz
doc: Document that snapshot name of block-backed disk isn't autogenerated
Libvirt generates external snapshot target file names for file backed storage but not for block backed storage. Document the limitation. Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1032363
Diffstat (limited to 'tools')
-rw-r--r--tools/virsh.pod4
1 files changed, 3 insertions, 1 deletions
diff --git a/tools/virsh.pod b/tools/virsh.pod
index a5e8406e12..5da71c3f34 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -3219,7 +3219,9 @@ The I<--diskspec> option can be used to control how I<--disk-only> and
external checkpoints create external files. This option can occur
multiple times, according to the number of <disk> elements in the domain
xml. Each <diskspec> is in the
-form B<disk[,snapshot=type][,driver=type][,file=name]>. To include a
+form B<disk[,snapshot=type][,driver=type][,file=name]>. A I<diskspec>
+must be provided for disks backed by block devices as libvirt doesn't
+auto-generate file names for those. To include a
literal comma in B<disk> or in B<file=name>, escape it with a second
comma. A literal I<--diskspec> must precede each B<diskspec> unless
all three of I<domain>, I<name>, and I<description> are also present.