PURE-FTPD-WRAPPER(8)

NAME
pure-ftpd-wrapper - configures and starts Pure-FTPd daemon

SYNOPSIS
pure-ftpd-wrapper

DESCRIPTION
pure-ftpd-wrapper reads the configuration for the Pure-FTPd daemon from files in the directory /etc/pure-ftpd/conf. Each file in this directory is related to a command line option. No more than one line with configuration values is allowed. Empty lines or lines starting with the comment character "#" are discarded.

The Pure-FTPd daemon allows one to use different authentication methods together. The authentication methods are tried in the order they are specified on the command line. In order to achieve the same flexibility with files in the /etc/pure-ftpd directory, pure-ftpd-wrapper checks all valid symbolic links within the directory /etc/pure-ftpd/auth in alphabetical order. E.g., a link in this directory pointing to /etc/pure-ftpd/conf/PureDB would enable authentication against a PureDB database.

There are no means to configure the PIDFile setting, it is hardwired to /var/run/pure-ftpd/pure-ftpd.pid in this script.

You can display the Pure-FTPd commandline options with "-s" or "--show-options":

    pure-ftpd-wrapper --show-options

CONFIGURATION

  Boolean values
The strings "Yes",1,"On" enable the corresponding commandline option (case doesn't matter). To disable the option use "No",0 or "Off".

Configuration files containing boolean values are "AllowAnonymousFXP", "AllowDotFiles", "AllowUserFXP", "AnonymousCanCreateDirs", "AnonymousCantUpload", "AnonymousOnly", "AntiWarez", "AutoRename", "BrokenClientsCompatibility", "CallUploadScript", "ChrootEveryone", "CreateHomeDir", "CustomerProof", "Daemonize", "DisplayDotFiles", "DontResolve", "IPV4Only", "IPV6Only", "KeepAllFiles", "LogPID", "NATmode", "NoAnonymous", "NoChmod", "NoRename", "NoTruncate", "PAMAuthentication", "ProhibitDotFilesRead", "ProhibitDotFilesWrite", "UnixAuthentication" and "VerboseLog".

  Numerical values
There are several types of numerical values (one number, two numbers, one or two numbers, two octal numbers).

One number
    "MaxClientsNumber", "MaxClientsPerIP", "MaxDiskUsage", "MaxIdleTime", "MaxLoad", "MinUID", "TLS", "TrustedGID".

Two numbers
    "AnonymousRatio", "LimitRecursion", "PassivePortRange", "PerUserLimits", "Quota", "UserRatio".

Two numbers (with unlimited value)
    This allows -1 in addition to positive numbers indicating an unlimited values.

    "LimitRecursion".

One or two numbers
    "AnonymousBandwidth", "UserBandwidth".

Two octal numbers
    "Umask".

  String values

Arbritrary strings
    "AltLog", "Bind", "ForcePassiveIP".

Words
    "SyslogFacility".

  Character Sets
"FSCharset", "ClientCharset".

These options were removed from PureFTPd in release 1.0.48 and will be ignored by the wrapper.

  IP values
"TrustedIP".

  File values
These values designate an existing file or socket.

File
    "FortunesFile", "LDAPConfigFile", "MySQLConfigFile", "PGSQLConfigFile", "PureDB".

Socket
    "ExtAuth".

AUTHOR
This manual page was written by Stefan Hornburg (Racke) <racke@linuxia.de> for the Debian GNU/Linux system.