[libvirt PATCH] docs: Fix blockCopy's documentation on --pivot & --abort flags

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



The --abort and --pivot flags for ``blockjob`` are mutually
exclusive — you either abort and keep the destination copy as a
point-in-time "snapshot"; or pivot to the new copy.  But you cannot
specify both flags at once.

Rephrase blockCopy's doc fragment to that effect.

Signed-off-by: Kashyap Chamarthy <kchamart@xxxxxxxxxx>
---
 docs/manpages/virsh.rst | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst
index dc404ddfe8..e7d4933c93 100644
--- a/docs/manpages/virsh.rst
+++ b/docs/manpages/virsh.rst
@@ -1254,18 +1254,19 @@ phases.  Initially, the job must copy all data from the source, and
 during this phase, the job can only be canceled to revert back to the
 source disk, with no guarantees about the destination.  After this phase
 completes, both the source and the destination remain mirrored until a
-call to ``blockjob`` with the *--abort* and *--pivot* flags pivots over
-to the copy, or a call without *--pivot* leaves the destination as a
-faithful copy of that point in time.  However, if *--wait* is specified,
-then this command will block until the mirroring phase begins, or cancel
-the operation if the optional *timeout* in seconds elapses or SIGINT is
-sent (usually with ``Ctrl-C``).  Using *--verbose* along with *--wait*
-will produce periodic status updates.  Using *--pivot* (similar to
-``blockjob`` *--pivot*) or *--finish* (similar to ``blockjob`` *--abort*)
-implies *--wait*, and will additionally end the job cleanly rather than
-leaving things in the mirroring phase.  If job cancellation is triggered
-by timeout or by *--finish*, *--async* will return control to the user
-as fast as possible, otherwise the command may continue to block a little
+call is issued to ``blockjob`` with either the *--abort* flag, which
+leaves the destination as a faithful copy of that point in time; or the
+*--pivot* flag, which pivots over to the copy on the destination.
+However, if *--wait* is specified, then this command will block until
+the mirroring phase begins, or cancel the operation if the optional
+*--timeout* in seconds elapses or SIGINT is sent (usually with
+``Ctrl-C``).  Using *--verbose* along with *--wait* will produce
+periodic status updates.  Using *--pivot* (similar to ``blockjob``
+*--pivot*) or *--finish* (similar to ``blockjob`` *--abort*) implies
+*--wait*, and will additionally end the job cleanly rather than leaving
+things in the mirroring phase.  If job cancellation is triggered by
+timeout or by *--finish*, *--async* will return control to the user as
+fast as possible, otherwise the command may continue to block a little
 while longer until the job has actually cancelled.
 
 *path* specifies fully-qualified path of the disk.
-- 
2.21.0





[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]

  Powered by Linux