Provided by: proftpd-basic_1.3.5a-1build1_amd64 bug


       ftpasswd - manipulates ProFTPD authentication files


       ftpasswd --help|-h|--version

       ftpasswd --hash  [ --des|--md5 ] [ --stdin ] [ --use-cracklib[=path] ]

       ftpasswd --passwd [ -F|--force ] [ --file=filename ] [--gecos=string ]
               [ --gid=gid ] [ --des | --md5 ] [ --not-system-password ]
               [ --stdin ] [ --use-cracklib[=path] ] --home=path

       ftpasswd --group [ -F|--force ] [ --enable-group-passwd ]
               [ --file=filename ] [ -m|--member ] [ --des|--md5 ]
               [ --stdin ] [ --use-cracklib[=path] ] --gid=gid

       ftpasswd --passwd --change-password --name=username


       ftpasswd  is  a  Perl  script which can be used to manipulate the password and group files
       suitable for use with ProFTPD AuthUserFile  and  AuthGroupFile  configuration  directives.
       The idea is somewhat similar to Apache's htpasswd program.

       Required  options  are --passwd, --group, or --hash.  These specify whether ftpasswd is to
       operate on a passwd(5) format file, on a group(5) format file, or  simply  to  generate  a
       password hash, respectively.

       If  used  with --passwd, ftpasswd creates a file in the passwd(5) format, suitable for use
       with proftpd's AuthUserFile  configuration  directive.   You  will  be  prompted  for  the
       password  to  use  of  the user, which will be encrypted, and written out as the encrypted
       string.  By default, using --passwd will write output to "./ftpd.passwd",

       If used with --hash, ftpasswd generates a hash of  a  password,  as  would  appear  in  an
       AuthUserFile.   The  hash  is written to standard out.  This hash is suitable for use with
       proftpd's UserPassword directive.

       If used with --group, ftpasswd creates a file in the group(5)  format,  suitable  for  use
       with  proftpd's  AuthGroupFile  configuration  directive.   By default, using --group will
       write output to "./".


       -F, --force
              If the password or group file be used already exists, delete it  and  write  a  new

              Write output to specified file (password or group files), rather than default one.

              Descriptive string for the given user (usually the user's full name).

              Set  primary group ID for this user (optional, will default to given --uid value if
              absent) when  --passwd is specified.

              numerical group ID.

       -h, --help, --version
              Show usage and version of the program.

              Set the home directory for the user (required).

       --des, --md5
              Use the DES or MD5 algorithm for encrypting passwords.  The latter is the default.

       --name=username, --name=groupname
              Name of the user account or group (required).  If the name does not  exist  in  the
              specified output-file, an entry will be created for it. Otherwise, the given fields
              will be updated.

              Shell for the user (required).  Recommended: /bin/false

              Update only the password field for a user.  This option requires  that  the  --name
              option  be used, but no others.  This also double-checks the given password against
              the user's current password in the existing passwd file, and requests  that  a  new
              password be given if the entered password is the same as the current password.

              Double-checks  the  given  password  against  the system password for the user, and
              requests that a new password be given if the entered password is the  same  as  the
              system  password.  This helps to enforce different passwords for different types of

              Read the password directly from standard in rather than prompting for it.  This  is
              useful for writing scripts that automate use of ftpasswd.

              Causes  ftpasswd  to  use Alec Muffet's cracklib routines in order to determine and
              prevent the use of bad or  weak  passwords.   The  optional  path  to  this  option
              specifies   the   path   to  the  dictionary  files  to  use  --  default  path  is
              /usr/lib/cracklib_dict.  This  requires  the  Perl  Crypt::Cracklib  module  to  be
              installed on your system.

              Prompt  for  a group password.  This is disabled by default, as group passwords are
              not usually a good idea at all.

       -m username, --member=username
              user to be a member of the group.  This argument may be used This argument  may  be
              used multiple times to specify the full list of users to be members of this group.


       No known bugs at this time.  If you discover any bugs, please contact the author.


       This  program has been written by TJ Saunders <> as a contributed software
       for ProFTPD.


       proftpd(8), passwd(5), group(5), ftpusers(8), ftpstats(8), proftpd.conf(5)


       This manual page was written by  Francesco  Paolo  Lovergine  <>.   Last
       update  Thu  Mar  10  16:45:27  UTC  2011 by Mahyuddin Susanto <> for the
       Debian GNU/Linux system (but may be used by others).