2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
virt-manager - display the virtual machine desktop management tool
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2008-09-22 22:28:29 +08:00
|
|
|
B<virt-manager> [OPTIONS]
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
B<virt-manager> is a desktop tool for managing virtual machines. It
|
2009-05-12 22:35:43 +08:00
|
|
|
provides the ability to control the lifecycle of existing machines
|
2007-07-25 03:38:31 +08:00
|
|
|
(bootup/shutdown,pause/resume,suspend/restore), provision new virtual
|
2009-05-12 22:35:43 +08:00
|
|
|
machines and various types of store, manage virtual networks,
|
|
|
|
access the graphical console of virtual machines, and view performance
|
|
|
|
statistics, all done locally or remotely.
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
The following options are accepted when running C<virt-manager>:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2014-01-21 09:58:14 +08:00
|
|
|
=item -h, --help
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display command line help summary
|
|
|
|
|
2013-08-19 04:04:54 +08:00
|
|
|
=item --version
|
|
|
|
|
|
|
|
Show virt-manager's version number and exit
|
|
|
|
|
2007-07-25 03:38:31 +08:00
|
|
|
=item -c URI, --connect=URI
|
|
|
|
|
2013-07-11 00:14:24 +08:00
|
|
|
Specify the hypervisor connection C<URI>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
2009-05-12 22:35:43 +08:00
|
|
|
=item --debug
|
|
|
|
|
|
|
|
List debugging output to the console (normally this is only logged in
|
2013-10-01 20:28:15 +08:00
|
|
|
~/.cache/virt-manager/virt-manager.log). This function implies --no-fork.
|
2009-05-12 22:35:43 +08:00
|
|
|
|
|
|
|
=item --no-fork
|
|
|
|
|
|
|
|
Don't fork C<virt-manager> off into the backround: run it blocking the
|
|
|
|
current terminal. Useful for seeing possible errors dumped to stdout/stderr.
|
|
|
|
|
|
|
|
=item --no-conn-autostart
|
|
|
|
|
|
|
|
Don't autostart any libvirt connections when launching C<virt-manager>.
|
|
|
|
|
2013-07-11 00:14:25 +08:00
|
|
|
=item --show-DIALOG-WINDOW
|
|
|
|
|
2013-07-13 17:21:30 +08:00
|
|
|
Display the corresponding C<DIALOG-WINDOW> when launching C<virt-manager>. This
|
|
|
|
function implies --no-conn-autostart and the manager window will not be shown
|
|
|
|
at startup in this case.
|
2013-07-11 00:14:25 +08:00
|
|
|
|
|
|
|
The following C<DIALOG-WINDOW> options are currently available:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2007-07-25 03:38:31 +08:00
|
|
|
=item --show-domain-creator
|
|
|
|
|
|
|
|
Display the wizard for creating new virtual machines
|
|
|
|
|
2014-01-31 00:36:07 +08:00
|
|
|
=item --show-domain-editor=NAME|ID|UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display the dialog for editing properties of the virtual machine with
|
2014-01-31 00:36:07 +08:00
|
|
|
unique ID matching either the domain name, ID, or UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
2014-01-31 00:36:07 +08:00
|
|
|
=item --show-domain-performance=NAME|ID|UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display the dialog for monitoring performance of the virtual machine with
|
2014-01-31 00:36:07 +08:00
|
|
|
unique ID matching either the domain name, ID, or UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
2014-01-31 00:36:07 +08:00
|
|
|
=item --show-domain-console=NAME|ID|UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display the virtual console of the virtual machine with
|
2014-01-31 00:36:07 +08:00
|
|
|
unique ID matching either the domain name, ID, or UUID
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=item --show-host-summary
|
|
|
|
|
|
|
|
Display the main window summarizing performance for all virtual machines
|
|
|
|
on the host.
|
|
|
|
|
2013-08-16 16:47:51 +08:00
|
|
|
=item --spice-disable-auto-usbredir
|
2014-01-29 10:15:23 +08:00
|
|
|
Auto USB redirection is supported by default. This option switches off it.
|
2013-08-16 16:47:51 +08:00
|
|
|
|
2007-07-25 03:38:31 +08:00
|
|
|
=back
|
|
|
|
|
2013-07-11 00:14:25 +08:00
|
|
|
=back
|
|
|
|
|
2013-02-17 03:13:47 +08:00
|
|
|
Standard GTK options like --g-fatal-warnings are also accepted.
|
|
|
|
|
2007-07-25 03:38:31 +08:00
|
|
|
=head1 BUGS
|
|
|
|
|
2009-05-12 22:35:43 +08:00
|
|
|
Please see L<http://virt-manager.org/page/BugReporting>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
2013-08-19 04:04:54 +08:00
|
|
|
Copyright (C) Red Hat, Inc, and various contributors.
|
2007-07-25 03:38:31 +08:00
|
|
|
This is free software. You may redistribute copies of it under the terms of the GNU General
|
|
|
|
Public License C<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent
|
|
|
|
permitted by law.
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
C<virsh(1)>, C<virt-viewer(1)>, the project website C<http://virt-manager.org>
|
|
|
|
|
|
|
|
=cut
|
|
|
|
|