.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "VIRT-VIEWER 1"
.TH VIRT-VIEWER 1 "2012-05-28" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
virt\-viewer \- display the graphical console for a virtual machine
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBvirt-viewer\fR [\s-1OPTIONS\s0] DOMAIN\-NAME|ID|UUID
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBvirt-viewer\fR is a minimal tool for displaying the graphical console
of a virtual machine. The console is accessed using the \s-1VNC\s0 or \s-1SPICE\s0
protocol. The guest can be referred to based on its name, \s-1ID\s0, or
\&\s-1UUID\s0. If the guest is not already running, then the viewer can be told
to wait until is starts before attempting to connect to the console
The viewer can connect to remote hosts to lookup the console
information and then also connect to the remote console using the same
network transport.
.SH "OPTIONS"
.IX Header "OPTIONS"
The following options are accepted when running \f(CW\*(C`virt\-viewer\*(C'\fR:
.IP "\-h, \-\-help" 4
.IX Item "-h, --help"
Display command line help summary
.IP "\-V, \-\-version" 4
.IX Item "-V, --version"
Display program version number
.IP "\-v, \-\-verbose" 4
.IX Item "-v, --verbose"
Display information about the connection
.IP "\-c \s-1URI\s0, \-\-connect=URI" 4
.IX Item "-c URI, --connect=URI"
Specify the hypervisor connection \s-1URI\s0
.IP "\-w, \-\-wait" 4
.IX Item "-w, --wait"
Wait for the domain to start up before attempting to connect to the console
.IP "\-r, \-\-reconnect" 4
.IX Item "-r, --reconnect"
Automatically reconnect to the domain if it shuts down and restarts
.IP "\-z \s-1PCT\s0, \-\-zoom=PCT" 4
.IX Item "-z PCT, --zoom=PCT"
Zoom level of the display window in percentage. Range 10\-200.
.IP "\-d, \-\-direct" 4
.IX Item "-d, --direct"
Do not attempt to tunnel the console over \s-1SSH\s0, even if the main connection \s-1URI\s0
used \s-1SSH\s0.
.IP "\-a, \-\-attach" 4
.IX Item "-a, --attach"
Use libvirt to directly attach to a local display, instead of making a
\&\s-1TCP/UNIX\s0 socket connection. This avoids the need to authentication with
the remote display, if authentication with libvirt is already allowed.
This option does not work with remote displays.
.IP "\-f, \-\-full\-screen" 4
.IX Item "-f, --full-screen"
Start with the window maximised to fullscreen
.IP "\-\-debug" 4
.IX Item "--debug"
Print debugging information
.SH "EXAMPLES"
.IX Header "EXAMPLES"
To connect to the guest called 'demo' running under Xen
.PP
.Vb 1
\&   virt\-viewer demo
.Ve
.PP
To connect to the guest with \s-1ID\s0 7 running under \s-1QEMU\s0
.PP
.Vb 1
\&   virt\-viewer \-\-connect qemu:///system 7
.Ve
.PP
To wait for the guest with \s-1UUID\s0 66ab33c0\-6919\-a3f7\-e659\-16c82d248521 to
startup and then connect, also reconnecting upon restart of \s-1VM\s0
.PP
.Vb 1
\&   virt\-viewer \-\-reconnect \-\-wait 66ab33c0\-6919\-a3f7\-e659\-16c82d248521
.Ve
.PP
To connect to a remote console using \s-1TLS\s0
.PP
.Vb 1
\&   virt\-viewer \-\-connect xen://example.org/ demo
.Ve
.PP
To connect to a remote host using \s-1SSH\s0, lookup the guest config and
then make a direct non-tunnelled connection of the console
.PP
.Vb 1
\&   virt\-viewer \-\-direct \-\-connect xen+ssh://root@example.org/ demo
.Ve
.SH "AUTHOR"
.IX Header "AUTHOR"
Written by Daniel P. Berrange, based on the GTK-VNC example program gvncviewer.
.SH "BUGS"
.IX Header "BUGS"
Report bugs to the mailing list \f(CW\*(C`http://www.redhat.com/mailman/listinfo/virt\-tools\-list\*(C'\fR
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2007\-2008 Red Hat, Inc., and various contributors.
This is free software. You may redistribute copies of it under the terms of the \s-1GNU\s0 General
Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR. There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent
permitted by law.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\f(CWvirsh(1)\fR, \f(CW\*(C`virt\-manager(1)\*(C'\fR, the project website \f(CW\*(C`http://virt\-manager.org\*(C'\fR