FreeBSD manual
download PDF document: vncpasswd.1.pdf
vncpasswd(1) TightVNC vncpasswd(1)
NAME
vncpasswd - set passwords for VNC server
SYNOPSIS
vncpasswd [file]
vncpasswd -t
vncpasswd -f
DESCRIPTION
The vncpasswd utility should be used to create and change passwords for
the TightVNC server authentication. Xvnc uses such passwords when
started with the -rfbauth command-line option (or when started from the
vncserver script).
vncpasswd allows one to enter either one or two passwords. The first
password is the primary one, the second password can be used for view-
only authentication. Xvnc will restrict mouse and keyboard input from
clients who authenticated with the view-only password. The vncpasswd
utility asks interactively if it should set the second password.
The password file name defaults to $HOME/.vnc/passwd unless the -t
command-line option was used (see the OPTIONS section below). The
$HOME/.vnc/ directory will be created if it does not exist.
Each password has to be longer than five characters (unless the -f
command-line option was used, see its description below). Only the
first eight characters are significant. If the primary password is too
short, the program will abort. If the view-only password is too short,
then only the primary password will be saved.
Unless a file name was provided in the command-line explicitly, this
utility may perform certain sanity checks to prevent writing a password
file into some hazardous place.
If at least one password was saved successfully, vncpasswd will exit
with status code 0. Otherwise the returned status code will be set to
1.
OPTIONS
-t Write passwords into /tmp/$USER-vnc/passwd, creating the
/tmp/$USER-vnc/ directory if it does not exist, and checking the
permissions on that directory (the mode must be 700). This
option can help to improve security when your home partition may
be shared via network (e.g. when using NFS).
-f Filter mode. Read plain-text passwords from stdin, write
encrypted versions to stdout. One or two passwords (full-control
and view-only) can be supplied in the input stream, newline
terminates a password. Note that in the filter mode, short or
even empty passwords will be silently accepted.
SEE ALSO
vncserver(1), Xvnc(1), vncviewer(1), vncconnect(1)
AUTHORS
Original VNC was developed in AT&T Laboratories Cambridge. TightVNC
additions were implemented by Constantin Kaplinsky. Many other people
August 2006 vncpasswd(1)