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
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<-h>
|
|
|
|
|
|
|
|
=item B<--help>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display command line help summary
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--version>
|
2013-08-19 04:04:54 +08:00
|
|
|
|
|
|
|
Show virt-manager's version number and exit
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<-c> URI
|
|
|
|
|
|
|
|
=item B<--connect>=URI
|
2007-07-25 03:38:31 +08:00
|
|
|
|
2013-07-11 00:14:24 +08:00
|
|
|
Specify the hypervisor connection C<URI>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--debug>
|
2009-05-12 22:35:43 +08:00
|
|
|
|
|
|
|
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
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--no-fork>
|
2009-05-12 22:35:43 +08: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 22:35:43 +08:00
|
|
|
current terminal. Useful for seeing possible errors dumped to stdout/stderr.
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--show-DIALOG-WINDOW>
|
2013-07-11 00:14:25 +08:00
|
|
|
|
2018-03-17 02:19:35 +08: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 17:21:30 +08:00
|
|
|
at startup in this case.
|
2013-07-11 00:14:25 +08:00
|
|
|
|
|
|
|
The following C<DIALOG-WINDOW> options are currently available:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--show-domain-creator>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display the wizard for creating new virtual machines
|
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--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
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--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
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--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
|
|
|
|
2015-04-05 05:43:28 +08:00
|
|
|
=item B<--show-host-summary>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
Display the main window summarizing performance for all virtual machines
|
|
|
|
on the host.
|
|
|
|
|
2016-05-20 21:30:57 +08:00
|
|
|
=back
|
|
|
|
|
2007-07-25 03:38:31 +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
|
|
|
|
|
2018-04-30 20:56:53 +08:00
|
|
|
Please see L<https://virt-manager.org/bugs/>
|
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
|
2018-04-30 20:56:53 +08:00
|
|
|
Public License C<https://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent
|
2007-07-25 03:38:31 +08:00
|
|
|
permitted by law.
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2018-04-30 20:56:53 +08:00
|
|
|
C<virsh(1)>, C<virt-viewer(1)>, the project website C<https://virt-manager.org>
|
2007-07-25 03:38:31 +08:00
|
|
|
|
|
|
|
=cut
|
|
|
|
|