| Peter Åstrand | 9fb4e0e | 2004-12-30 10:03:00 +0000 | [diff] [blame] | 1 | .TH vncconfig 1 "30 December 2004" "TightVNC" "Virtual Network Computing" |
| Constantin Kaplinsky | 47ed8d3 | 2004-10-08 09:43:57 +0000 | [diff] [blame] | 2 | .SH NAME |
| 3 | vncconfig \- configure and control a VNC server |
| 4 | .SH SYNOPSIS |
| 5 | .B vncconfig |
| 6 | [\fB\-display\fP \fIXdisplay\fP] [\fB\-nowin\fP] [\fB\-iconic\fP] |
| 7 | .br |
| 8 | .B vncconfig |
| 9 | [\fB\-display\fP \fIXdisplay\fP] |
| 10 | .B \-connect |
| 11 | .IR host [: port ] |
| 12 | .br |
| 13 | .B vncconfig |
| 14 | [\fB\-display\fP \fIXdisplay\fP] |
| 15 | .B \-disconnect |
| 16 | .br |
| 17 | .B vncconfig |
| 18 | [\fB\-display\fP \fIXdisplay\fP] |
| 19 | .IR param = value " ..." |
| 20 | .br |
| 21 | .B vncconfig |
| 22 | [\fB\-display\fP \fIXdisplay\fP] |
| 23 | .B \-list |
| 24 | .br |
| 25 | .B vncconfig |
| 26 | [\fB\-display\fP \fIXdisplay\fP] |
| 27 | \fB\-get\fP \fIparam\fP |
| 28 | .br |
| 29 | .B vncconfig |
| 30 | [\fB\-display\fP \fIXdisplay\fP] |
| 31 | \fB\-desc\fP \fIparam\fP |
| 32 | .SH DESCRIPTION |
| 33 | .B vncconfig |
| 34 | is used to configure and control a running instance of Xvnc, or any other X |
| 35 | server with the VNC extension. Note that it cannot be used to control VNC |
| 36 | servers prior to version 4. |
| 37 | |
| 38 | When run with no options, it runs as a kind of "helper" application for Xvnc. |
| 39 | Its main purpose when run in this mode is to support clipboard transfer to and |
| 40 | from the VNC viewer(s). Note that without a running instance of |
| 41 | \fBvncconfig\fP there will be no clipboard support. It puts up a window with |
| 42 | some checkboxes which can be used to disable clipboard transfers if required |
| 43 | (in the future there may be more functions available from this window). The |
| 44 | \fB-nowin\fP flag can be used if you always want clipboard support but don't |
| 45 | wish to clutter the desktop with this window - alternatively the \fB-iconic\fP |
| 46 | option can be used to make it iconified by default. |
| 47 | |
| 48 | When run in any other mode, \fBvncconfig\fP is a one-shot program used to |
| 49 | configure or control Xvnc as appropriate. It can be used to tell Xvnc to |
| 50 | connect or disconnect from listening viewers, and to set and retrieve Xvnc's |
| 51 | parameters. |
| 52 | |
| 53 | Note that the DISPLAY environment variable or the \fB\-display\fP option |
| 54 | must be set as appropriate to control Xvnc. If you run it on an ordinary X |
| 55 | server (or on a version 3 Xvnc) you will get an error message saying that there |
| 56 | is no VNC extension. |
| 57 | |
| 58 | .SH OPTIONS |
| 59 | .TP |
| 60 | .B \-display \fIXdisplay\fP |
| 61 | Specifies the Xvnc server to control. |
| 62 | |
| 63 | .TP |
| 64 | .B \-nowin |
| 65 | When run as a "helper" app, don't put up a window. |
| 66 | |
| 67 | .TP |
| 68 | .B \-iconic |
| 69 | When run as a "helper" app, make the window iconified at startup. |
| 70 | |
| 71 | .TP |
| 72 | .B \-connect \fIhost\fP[:\fIport\fP] |
| 73 | Tells an Xvnc server to make a "reverse" connection to a listening VNC viewer |
| 74 | (normally connections are made the other way round - the viewer connects to the |
| 75 | server). \fIhost\fP is the host where the listening viewer is running. If it's |
| 76 | not listening on the default port of 5500, you can specify \fIhost:port\fP |
| 77 | instead. |
| 78 | |
| 79 | .TP |
| 80 | .B \-disconnect |
| 81 | This causes Xvnc to disconnect from all viewers so that the VNC desktop is not |
| 82 | displayed anywhere. |
| 83 | |
| 84 | .TP |
| 85 | .IR param = value |
| 86 | Sets an Xvnc parameter to the given value. Note that some of Xvnc's parameters |
| 87 | are read only once at startup so that changing them in this way may not have |
| 88 | any effect. |
| 89 | |
| 90 | .TP |
| 91 | .B \-list |
| 92 | Lists all the parameters supported by Xvnc. |
| 93 | |
| 94 | .TP |
| 95 | .B \-get \fIparam\fP |
| 96 | Prints the current value of the given Xvnc parameter. |
| 97 | |
| 98 | .TP |
| 99 | .B \-desc \fIparam\fP |
| 100 | Prints a short description of the given Xvnc parameter. |
| 101 | |
| 102 | .SH SEE ALSO |
| 103 | .BR vncpasswd (1), |
| 104 | .BR vncviewer (1), |
| 105 | .BR vncserver (1), |
| 106 | .BR Xvnc (1) |
| 107 | .br |
| Peter Åstrand | 9fb4e0e | 2004-12-30 10:03:00 +0000 | [diff] [blame] | 108 | http://www.tightvnc.com |
| Constantin Kaplinsky | 47ed8d3 | 2004-10-08 09:43:57 +0000 | [diff] [blame] | 109 | |
| 110 | .SH AUTHOR |
| 111 | Tristan Richardson, RealVNC Ltd. |
| 112 | |
| Peter Åstrand | 9fb4e0e | 2004-12-30 10:03:00 +0000 | [diff] [blame] | 113 | VNC was originally developed by the RealVNC team while at Olivetti |
| 114 | Research Ltd / AT&T Laboratories Cambridge. TightVNC additions was |
| 115 | implemented by Constantin Kaplinsky. Many other people participated in |
| 116 | development, testing and support. |