vncconnect(1)

NAME

vncconnect - tell a VNC server to connect to a viewer

SYNOPSIS

vncconnect [-display Xdisplay] host[:port]
vncconnect [-display Xdisplay] -away
vncconnect [-display Xdisplay] -deferupdate time

DESCRIPTION

vncconnect tells an Xvnc server to make a "reverse" con

nection to a listening VNC viewer (normally connections are made

the other way round - the viewer connects to the server). Simply

run:

vncconnect host

where host is the host where the listening viewer is run

ning. If it's not listening on the default port of 5500, you can

specify host:port instead. vncconnect is just a simple X program

which sets a property on the root window - it is Xvnc which actu

ally makes the connection. Any feedback about the success or

failure of the connection will appear in the log file for Xvnc

rather than on the terminal where you run vncconnect.

Note also 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 then nothing will happen.

OPTIONS

-display Xdisplay

Specifies the Xvnc server to control.

-away Instead of connecting, this causes Xvnc to discon

nect from all viewers so that the VNC desktop is not displayed

anywhere. Note that this option will have no effect on Xvnc

servers prior to version 3.3.4.

-deferupdate time

This option has nothing to do with connecting, but

is put here to avoid the need for a separate configuration utili

ty. It changes Xvnc's "deferred update" time on the fly - see

Xvnc

fect on Xvnc servers prior to version 3.3.7.

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 maintained by RealVNC Ltd. See http://www.realvnc.com for

details.

RealVNC Ltd 28 February 2003

vncconnect(1)