Virtual Network Computing vncconfig(1)
NAME
vncconfig - configure and control a VNC server
SYNOPSIS
/usr/bin/vncconfig [parameters]
vncconfig [parameters] -connect host[:port]
vncconfig [parameters] -disconnect
vncconfig [parameters] [-set] Xvnc-param=value ...
vncconfig [parameters] -list
vncconfig [parameters] -get Xvnc-param
vncconfig [parameters] -desc Xvnc-param
DESCRIPTION
vncconfig is used to configure and control a running
instance of Xvnc, or any other X server with the VNC exten-
sion. 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 Xvnc. Its main purpose when run in this mode is to support clipboard transfer to and from the VNCviewer(s). Note that without a running instance of vnccon-
fig there will be no clipboard support. It puts up a window with some checkboxes which can be used to disable clipboardtransfers if required (in the future there may be more func-
tions available from this window). The -nowin flag can be
used if you always want clipboard support but don't wish toclutter the desktop with this window - alternatively the
-iconic option can be used to make it iconified by default.
When run in any other mode, vncconfig is a one-shot program
used to configure or control Xvnc as appropriate. It can be used to tell Xvnc to connect or disconnect from listening viewers, and to set and retrieve Xvnc's parameters.Note that the DISPLAY environment variable or the -display
option must be set as appropriate to control Xvnc. If you run it on an ordinary X server (or on a version 3 Xvnc) youwill get an error message saying that there is no VNC exten-
sion. OPTIONS-connect host[:port]
Tells an Xvnc server to make a "reverse" connection to a listening VNC viewer (normally connections are madethe other way round - the viewer connects to the
server). host is the host where the listening viewer is running. If it's not listening on the default port of 5500, you can specify host:port instead. TigerVNC Last change: 17 Apr 2006 1Virtual Network Computing vncconfig(1)
-disconnect
This causes Xvnc to disconnect from all viewers so that the VNC desktop is not displayed anywhere.[-set] Xvnc-param=value
Sets an Xvnc parameter to the given value. Note that some of Xvnc's parameters are read only once at startup so that changing them in this way may not have any effect.-list
Lists all the parameters supported by Xvnc.-get Xvnc-param
Prints the current value of the given Xvnc parameter.-desc Xvnc-param
Prints a short description of the given Xvnc parameter.PARAMETERS
vncconfig also has parameters of its own which can be set on
the command line. These should not be confused with Xvnc'sparameters which are manipulated with the -set, -get, -list
and -desc options.
Parameters can be turned on with -param or off with
-param=0. Parameters which take a value can be specified as
-param value. Other valid forms are param=value
-param=value --param=value. Parameter names are case-
insensitive.-display Xdisplay
Specifies the Xvnc server to control.-nowin
When run as a "helper" app, don't put up a window.-iconic
When run as a "helper" app, make the window iconified at startup.SEE ALSO
vncpasswd(1), vncviewer(1), vncserver(1), Xvnc(1) TigerVNC Last change: 17 Apr 2006 2Virtual Network Computing vncconfig(1)
http://www.tigervnc.org AUTHOR Tristan Richardson, RealVNC Ltd. 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 participated in development, testing and support.ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/server/xvnc ||_____________________________|_____________________________|
| Interface Stability | Volatile ||_____________________________|_____________________________|
TigerVNC Last change: 17 Apr 2006 3