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 com
mand-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 sta
tus code will be set to 1.
OPTIONS
- -t Write passwords into /tmp/$USER-vnc/passwd, creat
- ing the /tmp/$USER-vnc/ directory if it does not
exist, and checking the permissions on that direc
tory (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 sup
plied 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 was implemented by Constantin Kaplin
sky. Many other people participated in development, test
ing and support.
- Man page authors:
Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de>,
Tim Waugh <twaugh@redhat.com>,
Constantin Kaplinsky <const@ce.cctpu.edu.ru>