NAME

vncviewer - VNC® Viewer  

SYNOPSIS

vncviewer [OPTION...] [HOST][:DISPLAY]
vncviewer [OPTION...] -listen [PORT]  

DESCRIPTION

vncviewer is a VNC Viewer (client) for VNC connections. It can connect to any computer running a VNC Server, displaying a desktop for the user to control.

Run vncviewer to start VNC Viewer and prompt the user for a VNC Server to connect to.

Run vncviewer and specify a HOST and DISPLAY to start VNC Viewer and automatically connect to a particular computer. For example:

vncviewer snoopy:2

connects to a computer 'snoopy' on display number 2 (equivalent to port 5902). Note either the hostname or display number can be omitted, so for example vncviewer :1 connects to display number 1 on localhost (port 5901), and vncviewer snoopy connects to display 0 on 'snoopy' (port 5900).

Run vncviewer -listen to start VNC Viewer listening for a reverse connection from a VNC Server, on port 5500 by default.  

OPTIONS

Options are VNC parameters, used to configure VNC Viewer, and also the following:
-config FILE.vnc
Loads the VNC parameters and connection information (such as HOST and password) stored in a .vnc file.

To see a list of valid VNC parameters, run vncviewer -help.  

VNC CONFIGURATION FILES

VNC parameters can be specified as command line OPTIONS, but preferably in VNC configuration files. VNC configuration files are available for:
o
All VNC applications, or just VNC Viewer
o
All users of the computer, or just the user starting VNC Viewer
o
Policy, in order to lock down VNC Viewer

When VNC Viewer starts, VNC parameters are applied in the following order:

1
System-wide VNC configuration files
2
Per-user VNC configuration files
3
Command line OPTIONS
4
Policy VNC configuration files

This means that a particular VNC parameter specified at the command line overrides the same parameter specified in a per-user or in a system-wide VNC configuration file, but is itself overridden by the same parameter specified in a policy VNC configuration file. Policy cannot be changed by users.

For a list of the VNC configuration files available for VNC Viewer, and for detailed explanations of individual VNC parameters, start with
http://www.realvnc.com/products/vnc/documentation/latest/guides/user/am1082101.html#Ram86607  

LOGGING

By default, vncviewer logs basic activity to the standard error stream.

To change the log quality, quantity, or destination, specify the Log, LogDir, and LogFile VNC parameters.  

SEE ALSO

vncserver-x11(1), vncserver-virtual(1), vncserver-x11-serviced(1), vncaddrbook(1)  

AUTHOR

Copyright © 2002-2014 RealVNC Ltd.

VNC is a registered trademark of RealVNC Ltd. in the U.S. and in other countries. Protected by UK patent 2481870.

http://www.realvnc.com