1VIRT-VIEWER(1)        User Contributed Perl Documentation       VIRT-VIEWER(1)
2
3
4

NAME

6       virt-viewer - display the graphical console for a virtual machine
7

SYNOPSIS

9       virt-viewer [OPTIONS] DOMAIN-NAME|ID|UUID
10

DESCRIPTION

12       virt-viewer is a minimal tool for displaying the graphical console of a
13       virtual machine. The console is accessed using the VNC protocol.  The
14       guest can be referred to based on its name, ID, or UUID. If the guest
15       is not already running, then the viewer can be told to wait until is
16       starts before attempting to connect to the console The viewer can
17       connect to remote hosts to lookup the console information and then also
18       connect to the remote console using the same network transport.
19

OPTIONS

21       The following options are accepted when running "virt-viewer":
22
23       -h, --help
24           Display command line help summary
25
26       -V, --version
27           Display program version number
28
29       -v, --verbose
30           Display information about the connection
31
32       -c URI, --connect=URI
33           Specify the hypervisor connection URI
34
35       -w, --wait
36           Wait for the domain to start up before attempting to connect to the
37           console
38
39       -w, --reconnect
40           Automatically reconnect to the domain if it shuts down and restarts
41
42       -d, --direct
43           Do not attempt to tunnel the console over SSH, even if the main
44           connection URI used SSH.
45

EXAMPLES

47       To connect to the guest called 'demo' running under Xen
48
49          virt-viewer demo
50
51       To connect to the guest with ID 7 running under QEMU
52
53          virt-viewer --connect qemu:///system 7
54
55       To wait for the guest with UUID 66ab33c0-6919-a3f7-e659-16c82d248521 to
56       startup and then connect, also reconnecting upon restart of VM
57
58          virt-viewer --reconnect --wait 66ab33c0-6919-a3f7-e659-16c82d248521
59
60       To connect to a remote console using TLS
61
62          virt-viewer --connect xen://example.org/ demo
63
64       To connect to a remote host using SSH, lookup the guest config and then
65       make a direct non-tunnelled connection of the console
66
67          virt-viewer --direct --connect xen+ssh://root@example.org/ demo
68

AUTHOR

70       Written by Daniel P. Berrange, based on the GTK-VNC example program
71       gvncviewer.
72

BUGS

74       Report bugs to the mailing list
75       "http://www.redhat.com/mailman/listinfo/et-mgmt-tools"
76

78       Copyright (C) 2007-2008 Red Hat, Inc, and various contributors.  This
79       is free software. You may redistribute copies of it under the terms of
80       the GNU General Public License "http://www.gnu.org/licenses/gpl.html".
81       There is NO WARRANTY, to the extent permitted by law.
82

SEE ALSO

84       virsh(1), "virt-manager(1)", the project website
85       "http://virt-manager.org"
86
87
88
89perl v5.10.1                      2010-01-15                    VIRT-VIEWER(1)
Impressum