]> git.ipfire.org Git - thirdparty/libvirt.git/commitdiff
docs: Reformat snapshot-revert force reasons
authorMichael Weiser <michael.weiser@gmx.de>
Fri, 3 Jan 2020 18:43:24 +0000 (19:43 +0100)
committerMichal Privoznik <mprivozn@redhat.com>
Fri, 10 Jan 2020 09:41:26 +0000 (10:41 +0100)
Reformat explanations of the snapshot-revert force reasons in
preparation for more to be added. This is a simple reformat without any
wording changes.

Signed-off-by: Michael Weiser <michael.weiser@gmx.de>
Reviewed-by: Daniel Henrique Barboza <danielhb413@gmail.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
docs/manpages/virsh.rst

index 856074c8db7bc64e67bbbd00a2a8ddde4ec2878d..56c0a0c15360b77351ea7a98948c82f9e116ec57 100644 (file)
@@ -6971,20 +6971,22 @@ transient domains cannot be inactive, it is required to use one of these
 flags when reverting to a disk snapshot of a transient domain.
 
 There are two cases where a snapshot revert involves extra risk, which
-requires the use of *--force* to proceed.  One is the case of a
-snapshot that lacks full domain information for reverting
-configuration (such as snapshots created prior to libvirt 0.9.5);
-since libvirt cannot prove that the current configuration matches what
-was in use at the time of the snapshot, supplying *--force* assures
-libvirt that the snapshot is compatible with the current configuration
-(and if it is not, the domain will likely fail to run).  The other is
-the case of reverting from a running domain to an active state where a
-new hypervisor has to be created rather than reusing the existing
-hypervisor, because it implies drawbacks such as breaking any existing
-VNC or Spice connections; this condition happens with an active
-snapshot that uses a provably incompatible configuration, as well as
-with an inactive snapshot that is combined with the *--start* or
-*--pause* flag.
+requires the use of *--force* to proceed:
+
+  * One is the case of a snapshot that lacks full domain information for
+    reverting configuration (such as snapshots created prior to libvirt
+    0.9.5); since libvirt cannot prove that the current configuration matches
+    what was in use at the time of the snapshot, supplying *--force* assures
+    libvirt that the snapshot is compatible with the current configuration
+    (and if it is not, the domain will likely fail to run).
+
+  * The other is the case of reverting from a running domain to an active
+    state where a new hypervisor has to be created rather than reusing the
+    existing hypervisor, because it implies drawbacks such as breaking any
+    existing VNC or Spice connections; this condition happens with an active
+    snapshot that uses a provably incompatible configuration, as well as with
+    an inactive snapshot that is combined with the *--start* or *--pause*
+    flag.
 
 
 snapshot-delete