aboutsummaryrefslogtreecommitdiff
path: root/tools
diff options
context:
space:
mode:
authorJustin Clift <justin@salasaga.org>2010-05-30 13:28:42 +1000
committerEric Blake <eblake@redhat.com>2010-06-01 16:46:51 -0600
commite5f31f461f63bbad211e84b810d6ba43a705f9dd (patch)
treeaaf7b9898921614bf39e9c326a6aca1f5ed3a756 /tools
parentbuild: fix VPATH 'make syntax-check' (diff)
downloadlibvirt-e5f31f461f63bbad211e84b810d6ba43a705f9dd.tar.gz
libvirt-e5f31f461f63bbad211e84b810d6ba43a705f9dd.tar.bz2
libvirt-e5f31f461f63bbad211e84b810d6ba43a705f9dd.zip
Trivial virsh.pod additions --all for "list" command and similar
This is just a trivial patch to virsh.pod (from git master). It adds the following pieces to the virsh man page: + Shows the --inactive and --all optional parameters for the list command. Closes Bugzilla #575512, reported by Renich Bon Ciric https://bugzilla.redhat.com/show_bug.cgi?id=575512 + Corrects the existing description of the list command, to now say that only running domains are listed if no domains are specified. The man page up until this point has said all domains are listed if no domains are specified, which is incorrect. + Adds the "shut off" state to the list of states for the list command. + Adds a missing =back around line 755, that pod2man was complaining was missing.
Diffstat (limited to 'tools')
-rw-r--r--tools/virsh.pod13
1 files changed, 10 insertions, 3 deletions
diff --git a/tools/virsh.pod b/tools/virsh.pod
index cf7585dd2..495bb4679 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -156,10 +156,10 @@ description see:
L<http://libvirt.org/formatcaps.html>
The XML also show the NUMA topology information if available.
-=item B<list>
+=item B<list> optional I<--inactive> I<--all>
Prints information about one or more domains. If no domains are
-specified it prints out information about all domains.
+specified it prints out information about running domains.
An example format for the list is as follows:
@@ -177,7 +177,7 @@ State is the run state (see below).
B<STATES>
-The State field lists 6 states for a domain, and which ones the
+The State field lists 7 states for a domain, and which ones the
current domain is in.
=over 4
@@ -205,6 +205,11 @@ The domain is in the process of shutting down, i.e. the guest operating system
has been notified and should be in the process of stopping its operations
gracefully.
+=item B<shut off>
+
+The domain is not running. Usually this indicates the domain has been
+shut down completely, or has not been started.
+
=item B<crashed>
The domain has crashed, which is always a violent ending. Usually
@@ -748,6 +753,8 @@ Undefine the configuration for an inactive I<pool>.
Returns the UUID of the named I<pool>.
+=back
+
=head1 SECRET COMMMANDS
The following commands manipulate "secrets" (e.g. passwords, passphrases and