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>

                                                   August 2006                                      vncpasswd(1)