~ubuntu-branches/ubuntu/maverick/libvirt/maverick

 

All B<virsh> operations rely upon the libvirt library.

For any virsh commands to run xend/qemu, or what ever virtual library that libvirt supports.  For this reason you should start xend/qemu as a service when your system first boots using xen/qemu. This can usually be done using the command

 

Most B<virsh> commands require root privileges to run due to the

communications channels used to talk to the hypervisor.  Running as

Name is the name of the domain.  ID the domain numeric id.

State is the run state (see below).

 

B<STATES>

 

The State field lists 6 states for a domain, and which ones the

current domain is in.

 

=item B<running>

 

The domain is currently running on a CPU

Prints the available amount of memory on the machine or within a

NUMA cell if I<cellno> is provided.

 

=head1 DOMAIN COMMANDS

 

The following commands manipulate domains directly, as stated

previously most commands take domain-id as the first parameter. The

I<domain-id> can be specified as an short integer, a name or a full UUID.

 

=item B<autostart> optional I<--disable> I<domain-id>

 

Configure a domain to be automatically started at boot.

Output the IP address and port number for the VNC display. If the information

is not available the processes will provide an exit code of 1.

 

 

The following commands manipulate devices associated to domains.

The domain-id can be specified as an short integer, a name or a full UUID.

reading the documentation at L<http://libvirt.org/format.html> on the

format of the device sections to get the most accurate set of accepted values.

 

=item B<attach-device> I<domain-id> I<FILE>

 

Attach a device to the domain, using a device definition in an XML file.

It is recommended to use the I<mac> option to distinguish between the interfaces

if more than one are present on the domain.

 

 

The following commands manipulate networks. Libvirt has the capability to

define virtual networks which can then be used by domains and linked to

of the command for virtual networks are similar to the one used for domains,

but the way to name a virtual network is either by its name or UUID.

 

=item B<net-autostart> I<network> optional I<--disable>

 

Configure a virtual network to be automatically started at boot.

 

Convert a network name to network UUID.

 

=head1 ENVIRONMENT

 

=item VIRSH_DEFAULT_CONNECT_URI

 

The hypervisor to connect to by default. Set this to a URI, in the same

format as accepted by the B<connect> option.

 

 

  Andrew Puch <apuch @ redhat.com>

  Daniel Veillard <veillard @ redhat.com>

  Sean Dague <sean at dague dot net>

  Daniel Stekloff <dsteklof at us dot ibm dot com>