FTPASSWD(8) Debian GNU/Linux FTPASSWD(8)
NAME
ftpasswd - manipulates ProFTPD authentication files
SYNOPSIS
ftpasswd --help|-h|--version
ftpasswd --hash [ --des|--md5|--sha256|--sha512 ] [ --stdin ]
[ --use-cracklib[=path] ]
ftpasswd --passwd [ -F|--force ] [ --file=filename ] [--gecos=string ]
[ --gid=gid ] [ --des|--md5|--sha256|--sha512 ] [ --not-sys-
tem-password ]
[ --not-previous-password ] [ --delete-user [ --stdin ]
[ --use-cracklib[=path] ] --home=path --name=username
--shell=shellpath --uid=uid
ftpasswd --group [ -F|--force ] [ --enable-group-passwd ] [
--delete-group ]
[ --file=filename ] [ -m|--member ] [
--des|--md5|--sha256|--sha512 ]
[ --stdin ] [ --use-cracklib[=path] ] --gid=gid --name=group-
name
ftpasswd --passwd --change-password --name=username
ftpasswd --passwd -l|--lock --name=username
ftpasswd --passwd -u|--unlock --name=username
DESCRIPTION
ftpasswd is a Perl script which can be used to manipulate the password
and group files suitable for use with ProFTPD AuthUserFile and Auth-
GroupFile 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, respec-
tively.
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 "./ftpd.group".
OPTIONS
-F, --force
If the password or group file be used already exists, delete it
and write a new one. By default, new entries will be appended
to the file.
--file=filename
Write output to specified file (password or group files), rather
than default one.
--gecos=string
Descriptive string for the given user (usually the user's full
name).
--gid=gid
Set primary group ID for this user (optional, will default to
given --uid value if absent) when --passwd is specified.
--uid=uid
numerical user ID.
-h, --help, --version
Show usage and version of the program.
--home=path
Set the home directory for the user (required).
--des, --md5, --sha256, --sha512
Use the DES, MD5, SHA-256 or SHA-512 algorithm for encrypting
passwords. The default is the MD5 algorithm.
--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=path
Shell for the user (required). Recommended: /bin/false
--change-password
Update only the password field for a user. This option requires
that the --name and --passwd options 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.
--not-previous-password
Double-checks the given password against the previous password
for the user, and requests that a new password be given if the
entered password is the same as the previous password.
--not-system-password
Double-checks the given password against the system password for
the user, and requests that a new password be given if the en-
tered password is the same as the system password. This helps
to enforce different passwords for different types of access.
--stdin
Read the password directly from standard in rather than prompt-
ing for it. This is useful for writing scripts that automate
use of ftpasswd.
-l, --lock
Lock the password of the named account. This option disables a
password by changing it to a value which matches no possible en-
crypted value (it adds a '!' at the beginning of the password).
-u, --unlock
Unlock the password of the named account. This option re-enables
a password by changing the password back to its previous value
(to the value before using the -l option).
--use-cracklib[=path]
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 dictio-
nary files to use -- default path is /usr/lib/cracklib_dict.
This requires the Perl Crypt::Cracklib module to be installed on
your system.
--delete-user
Remove the entry for the given user name from the file.
--delete-group
Remove the entry for the given group name from the file.
--enable-group-passwd
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.
BUGS
No known bugs at this time. If you discover any bugs, please contact
the author.
AUTHOR
This program has been written by TJ Saunders <tj@castaglia.org> as a
contributed software for ProFTPD.
SEE ALSO
proftpd(8), passwd(5), group(5), ftpusers(8), ftpstats(8),
proftpd.conf(5)
CREDITS
This manual page was written by Francesco Paolo Lovergine <frankie@de-
bian.org>. Last update Thu Mar 10 16:45:27 UTC 2011 by Mahyuddin Su-
santo <udienz@ubuntu.com> for the Debian GNU/Linux system (but may be
used by others).
1.1.2 October 19, 2002 FTPASSWD(8)