]> xenbits.xensource.com Git - people/liuw/libxenctrl-split/libvirt.git/commitdiff
clarify virsh net commands
authorGene Czarcinski <gene@czarc.net>
Sat, 16 Mar 2013 17:36:32 +0000 (13:36 -0400)
committerEric Blake <eblake@redhat.com>
Wed, 20 Mar 2013 19:55:17 +0000 (13:55 -0600)
Clarify that net-create deals with a transient virtual
network whereas net-define defines a persistent virtual
network definition and will create the network (xml)
definition file.

Clarify that net-destroy works with both transient and
persistent virtual networks.

Signed-off-by: Gene Czarcinski <gene@czarc.net>
tools/virsh.pod

index 7fb89e41ee826014c757f74e8e09260d7d1ccdf7..b5e632e9ea20d47333785afd13cdc88c0669c38d 100644 (file)
@@ -2034,19 +2034,20 @@ The I<--disable> option disable autostarting.
 
 =item B<net-create> I<file>
 
-Create a virtual network from an XML I<file>, see the documentation at
-L<http://libvirt.org/formatnetwork.html> to get a description of the
-XML network format used by libvirt.
+Create a transient (temporary) virtual network from an
+XML I<file> and instantiate (start) the network.
+See the documentation at L<http://libvirt.org/formatnetwork.html>
+to get a description of the XML network format used by libvirt.
 
 =item B<net-define> I<file>
 
-Define a virtual network from an XML I<file>, the network is just defined but
-not instantiated.
+Define a persistent virtual network from an XML I<file>, the network is just
+defined but not instantiated (started).
 
 =item B<net-destroy> I<network>
 
-Destroy (stop) a given virtual network specified by its name or UUID. This
-takes effect immediately.
+Destroy (stop) a given transient or persistent virtual network
+specified by its name or UUID. This takes effect immediately.
 
 =item B<net-dumpxml> I<network> [I<--inactive>]