pure-pw

Section: Pure-FTPd (8)
Updated: 1.0.36
Index Return to Main Contents

NAME

pure-pw - Manage virtual users files for Pure-FTPd

SYNTAX

pure-pw useradd login [-f passwd_file] [-F puredb_file] -u uid [-g gid]
                -D/-d home_directory [-c gecos]
                [-t download_bandwidth] [-T upload_bandwidth]
                [-n max number_of_files] [-N max_Mbytes]
                [-q upload_ratio] [-Q download_ratio]
                [-r <allow client host>/<mask>[,<ip>/<mask>]...] [-R <deny client host>/<mask>[,<ip>/<mask>]...]
                [-i <allow local host>/<mask>[,<ip>/<mask>]...] [-I <deny local host>/<mask>[,<ip>/<mask>]...]
                [-y <max number of concurrent sessions>]
                [-z <hhmm>-<hhmm>] [-m]
pure-pw usermod login [-f passwd_file] [-F puredb_file] [-u uid] [-g gid]
                -D/-d home_directory -[c gecos]
                [-t download_bandwidth] [-T upload_bandwidth]
                [-n max_number_of_files] [-N max_Mbytes]
                [-q upload_ratio] [-Q download_ratio]
                [-r <allow client host>/<mask>[,<ip>/<mask>]...] [-R <deny client host>/<mask>[,<ip>/<mask>]...]
                [-i <allow local host>/<mask>[,<ip>/<mask>]...] [-I <deny local host>/<mask>[,<ip>/<mask>]...]
                [-y <max number of concurrent sessions>]
                [-z <hhmm>-<hhmm>] [-m]
pure-pw userdel login [-f passwd_file] [-F puredb_file] [-m]
pure-pw passwd login [-f passwd_file] [-F puredb_file] [-m]
pure-pw show login [-f passwd_file] [-m]
pure-pw mkdb [<puredb_database_file> [-f passwd_file]] [-F puredb_file]
pure-pw list [-f passwd_file]

DESCRIPTION

Virtual users is a simple mechanism to store a list of users, with their password, name, uid, directory, etc. It's just like /etc/passwd. But it's not /etc/passwd. It's a different file, only for FTP.
It means that you can easily create FTP-only accounts without messing your system accounts.
Additionnaly, virtual users files can store individual quotas, ratios, bandwidth, etc. System accounts can't do this.
Thousands of virtual users can share the same system user, as long as they all are chrooted, and they have their own home directory.

FILES

/etc/pureftpd.passwd
/etc/pureftpd.pdb

ENVIRONMENT VARIABLES

PURE_PASSWDFILE If this variable is defined, this is the default value for the text password file. Without this variable, /etc/pureftpd.passwd is assumed.
PURE_DBFILE If this variable is defined, this is the default value for the PureDB password file. Without this variable, /etc/pureftpd.pdb is assumed.

EXAMPLES

Please read http://download.pureftpd.org/pub/pure-ftpd/doc/README.Virtual-Users

AUTHORS

Frank DENIS <j at pureftpd dot org>

This document was created by