Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 pass-
     word is the primary one, the second password can be used for view-only  au-
     thentication.  Xvnc will restrict mouse and keyboard input from clients who
     authenticated with the view-only password. The vncpasswd utility  asks  in-
     teractively 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/ di-
     rectory 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 pro-
     gram will abort. If the view-only password is too short, then only the pri-
     mary password will be saved.

     Unless a file name was provided in the command-line explicitly, this  util-
     ity  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 im-
	    prove 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  pass-
	    words 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 addi-
     tions were implemented by Constantin Kaplinsky. Many other people	partici-
     pated 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vncpasswd&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help