vncconfig(1)		  Virtual Network Computing		 vncconfig(1)



NAME
       vncconfig - configure and control a VNC server

SYNOPSIS
       vncconfig [-display Xdisplay] [-nowin] [-iconic]
       vncconfig [-display Xdisplay] -connect host[:port]
       vncconfig [-display Xdisplay] -disconnect
       vncconfig [-display Xdisplay] param=value ...
       vncconfig [-display Xdisplay] -list
       vncconfig [-display Xdisplay] -get param
       vncconfig [-display Xdisplay] -desc 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.

       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	clip-
       board  transfer	to  and	 from the VNC viewer(s).  Note that without a
       running instance of vncconfig there will be no clipboard support.   It
       puts  up	 a  window  with some checkboxes which can be used to disable
       clipboard transfers 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 to	clutter	 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) you will get an error message saying
       that there is no VNC extension.


OPTIONS
       -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.


       -connect host[:port]
	      Tells  an	 Xvnc server to make a "reverse" connection to a lis-
	      tening 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.


       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 chang-
	      ing them in this way may not have any effect.


       -list  Lists all the parameters supported by Xvnc.


       -get param
	      Prints the current value of the given Xvnc parameter.


       -desc param
	      Prints a short description of the given Xvnc parameter.


SEE ALSO
       vncpasswd(1), vncviewer(1), vncserver(1), Xvnc(1)
       http://www.realvnc.com


AUTHOR
       Tristan Richardson, RealVNC Ltd.

       VNC was originally developed by the RealVNC  team  while	 at  Olivetti
       Research	 Ltd  /	 AT&T  Laboratories Cambridge.	It is now being main-
       tained by RealVNC Ltd.  See http://www.realvnc.com for details.



RealVNC Ltd			 3 June 2003			 vncconfig(1)

UNIX/Linux commands referenced on this page:

1. as
2. which
3. more
4. make
5. Xvnc
6. host
7. at