.TH tigervncconfig 1 "" "TigerVNC" "Virtual Network Computing"
.SH NAME
tigervncconfig \- configure and control a VNC server
.SH SYNOPSIS
.B tigervncconfig
.RI [ parameters ] 
.br
.B tigervncconfig
.RI [ parameters ] 
.B \-connect
.IR host [: port ]
.br
.B tigervncconfig
.RI [ parameters ] 
.B \-disconnect
.br
.B tigervncconfig
.RI [ parameters ] 
.RB [ -set ] 
.IR Xtigervnc-param = value " ..."
.br
.B tigervncconfig
.RI [ parameters ] 
.B \-list
.br
.B tigervncconfig
.RI [ parameters ] 
\fB\-get\fP \fIXtigervnc-param\fP
.br
.B tigervncconfig
.RI [ parameters ] 
\fB\-desc\fP \fIXtigervnc-param\fP
.SH DESCRIPTION
.B tigervncconfig
is used to configure and control a running instance of Xtigervnc, or any other X
server with the VNC extension.  Note that it cannot be used to control VNC
servers prior to version 4.

When run with no options, it runs as a kind of "helper" application for Xtigervnc.
Its main purpose when run in this mode is to query the user how new
connections should be handled (provided this feature is enabled). The
\fB-nowin\fP flag can be used if you always want the query support but don't
wish to clutter the desktop with the settings window - alternatively the
\fB-iconic\fP option can be used to make it iconified by default.

When run in any other mode, \fBtigervncconfig\fP is a one-shot program used to
configure or control Xtigervnc as appropriate.  It can be used to tell Xtigervnc to
connect or disconnect from listening viewers, and to set and retrieve Xtigervnc's
parameters.

Note that the DISPLAY environment variable or the \fB\-display\fP option
must be set as appropriate to control Xtigervnc.  If you run it on an ordinary X
server (or on a version 3 Xtigervnc) you will get an error message saying that there
is no VNC extension.

.SH OPTIONS
.TP
.B \-connect \fIhost\fP[:\fIport\fP]
Tells an Xtigervnc server to make a "reverse" connection to a listening VNC viewer
(normally connections are made the other way round - the viewer connects to the
server). \fIhost\fP is the host where the listening viewer is running. If it's
not listening on the default port of 5500, you can specify \fIhost:port\fP
instead.
.
.TP
.B \-disconnect
This causes Xtigervnc to disconnect from all viewers so that the VNC desktop is not
displayed anywhere.
.
.TP
[\fB-set\fP] \fIXtigervnc-param\fP=\fIvalue\fP
Sets an Xtigervnc parameter to the given value.  Note that some of Xtigervnc's parameters
are read only once at startup so that changing them in this way may not have
any effect.
.
.TP
.B \-list
Lists all the parameters supported by Xtigervnc.
.
.TP
.B \-get \fIXtigervnc-param\fP
Prints the current value of the given Xtigervnc parameter.
.
.TP
.B \-desc \fIXtigervnc-param\fP
Prints a short description of the given Xtigervnc parameter.

.SH PARAMETERS
.B tigervncconfig
also has parameters of its own which can be set on the command line.  These
should not be confused with Xtigervnc's parameters which are manipulated with the
\fB-set\fP, \fB-get\fP, \fB-list\fP and \fB-desc\fP options.

Parameters can be turned on with -\fIparam\fP or off with -\fIparam\fP=0.
Parameters which take a value can be specified as -\fIparam\fP \fIvalue\fP.
Other valid forms are \fIparam\fP\fB=\fP\fIvalue\fP -\fIparam\fP=\fIvalue\fP
--\fIparam\fP=\fIvalue\fP.  Parameter names are case-insensitive.

.TP
.B \-display \fIXdisplay\fP
Specifies the Xtigervnc server to control.
.
.TP
.B \-nowin
When run as a "helper" app, don't put up a window.
.
.TP
.B \-iconic
When run as a "helper" app, make the window iconified at startup.

.SH SEE ALSO
.BR tigervncpasswd (1),
.BR xtigervncviewer (1),
.BR Xtigervnc (1),
.BR tigervncsession (8)
.br
https://www.tigervnc.org

.SH AUTHOR
Tristan Richardson, RealVNC Ltd. and others.

VNC was originally developed by the RealVNC team while at Olivetti
Research Ltd / AT&T Laboratories Cambridge.  TightVNC additions were
implemented by Constantin Kaplinsky. Many other people have since
participated in development, testing and support. This manual is part
of the TigerVNC software suite.