vncconfig(1) manual page

NAME vncconfig - configure and control a VNC server SYNOPSIS vncconfig [parameters] vncconfig [parameters] -connect host[:port] vncconfig [parameters] -disconnect vncconfig [parameters] [-set] Xvnc-param=value ... vncconfig [parameters] -list vncconfig [parameters] -listconnections 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 extension. Note that it cannot be used to control VNC servers prior to version 4. It can be run either in interactive mode or in command-line mode. INTERACTIVE MODE In interactive mode, the vncconfig command launches a graphical front-end to the VNC server. This serves three purposes: to support clipboard transfer to and from VNC viewers; to support the "query connection" feature of VNC server; and to provide a visual status and configuration interface. Two command-line options are available in interactive mode: -nowin Do not display the vncconfig window. This is useful you want clipboard or query connection support but don't wish to clutter the desktop. If your window manager supports application status icons, then vncconfig will still install an icon that can be used to open the status/configuration interface, or to quit the program. -iconic Make the vncconfig window iconified by default. COMMAND-LINE MODE When run with any other command-line options, 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) you will get an error message saying that there is no VNC extension. OPTIONS -connect host[:port] Tells an Xvnc 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). 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. -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. -listconnections Lists the current connections to the VNC desktop. -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's parameters 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 in interactive mode, don't put up a window. -iconic When run in interactive mode, make the window iconified at startup. -poll millis Some badly-behaved X applications change the contents of the clipboard without notifying the rest of the system. To cope with these applications, vncconfig can be made to check the contents of the clipboard every millis milliseconds to see if it has changed. SEE ALSO vncserver(1), vncviewer(1), vncaddrbook(1), vncpasswd(1), vnclicense(1), vnckeygen(1), Xvnc(1), x0vncserver(1), vncinitconfig(1) http://www.realvnc.com AUTHOR RealVNC Ltd.