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 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
participated in development, testing and support.
Man page authors:
Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de>,
Tim Waugh <twaugh@redhat.com>,
Constantin Kaplinsky <const@tightvnc.com>