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