[libvirt] [PATCH 3/3] virsh: Document the --timestamp option

Andrea Bolognani abologna at redhat.com
Fri Jan 8 12:21:19 UTC 2016


The event, net-event and qemu-monitor-event virsh commands all
support the --timestamp option now, but such option was not
referenced in the man page.
---
 tools/virsh.pod | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 9456db8..e830c59 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1370,7 +1370,7 @@ The editor used can be supplied by the C<$VISUAL> or C<$EDITOR> environment
 variables, and defaults to C<vi>.
 
 =item B<event> {[I<domain>] { I<event> | I<--all> } [I<--loop>]
-[I<--timeout> I<seconds>] | I<--list>}
+[I<--timeout> I<seconds>] [I<--timestamp>] | I<--list>}
 
 Wait for a class of domain events to occur, and print appropriate details
 of events as they happen.  The events can optionally be filtered by
@@ -1386,6 +1386,9 @@ If I<--timeout> is specified, the command gives up waiting for events
 after I<seconds> have elapsed.   With I<--loop>, the command prints all
 events until a timeout or interrupt key.
 
+When I<--timestamp> is used, a human-readable timestamp will be printed
+before the event.
+
 =item B<iothreadinfo> I<domain> [[I<--live>] [I<--config>] | [I<--current>]]
 
 Display basic domain IOThreads information including the IOThread ID and
@@ -2877,7 +2880,7 @@ The editor used can be supplied by the C<$VISUAL> or C<$EDITOR> environment
 variables, and defaults to C<vi>.
 
 =item B<net-event> {[I<network>] I<event> [I<--loop>] [I<--timeout>
-I<seconds>] | I<--list>}
+I<seconds>] [I<--timestamp>] | I<--list>}
 
 Wait for a class of network events to occur, and print appropriate details
 of events as they happen.  The events can optionally be filtered by
@@ -2891,6 +2894,9 @@ If I<--timeout> is specified, the command gives up waiting for events
 after I<seconds> have elapsed.   With I<--loop>, the command prints all
 events until a timeout or interrupt key.
 
+When I<--timestamp> is used, a human-readable timestamp will be printed
+before the event.
+
 =item B<net-info> I<network>
 
 Returns basic information about the I<network> object.
@@ -4074,6 +4080,7 @@ timeout.
 
 =item B<qemu-monitor-event> [I<domain>] [I<--event> I<event-name>] [I<--loop>]
 [I<--timeout> I<seconds>] [I<--pretty>] [I<--regex>] [I<--no-case>]
+[I<--timestamp>]
 
 Wait for arbitrary QEMU monitor events to occur, and print out the
 details of events as they happen.  The events can optionally be filtered
@@ -4090,6 +4097,10 @@ after I<seconds> have elapsed.  With I<--loop>, the command prints all
 events until a timeout or interrupt key.  If I<--pretty> is specified,
 any JSON event details are pretty-printed for better legibility.
 
+When I<--timestamp> is used, a human-readable timestamp will be printed
+before the event, and the timing information provided by QEMU will be
+omitted.
+
 =item B<lxc-enter-namespace> I<domain> -- /path/to/binary [arg1, [arg2, ...]]
 
 Enter the namespace of I<domain> and execute the command C</path/to/binary>
-- 
2.5.0




More information about the libvir-list mailing list