.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PURE-FTPD-WRAPPER 8"
.TH PURE-FTPD-WRAPPER 8 "2019-03-30" "Debian GNU/Linux buster/sid" "Debian GNU/Linux Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
pure\-ftpd\-wrapper \- configures and starts Pure\-FTPd daemon
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
pure-ftpd-wrapper
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBpure-ftpd-wrapper\fR reads the configuration for the Pure-FTPd daemon
from files in the directory \fI/etc/pure\-ftpd/conf\fR. 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 \f(CW\*(C`#\*(C'\fR are discarded.
.PP
The Pure-FTPd daemon allows 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 \fI/etc/pure\-ftpd\fR directory, \fBpure-ftpd-wrapper\fR
checks all valid symbolic links within the directory \fI/etc/pure\-ftpd/auth\fR
in alphabetical order. E.g., a link in this directory pointing to
\&\fI/etc/pure\-ftpd/conf/PureDB\fR would enable authentication against
a PureDB database.
.PP
There are no means to configure the \fIPIDFile\fR setting, it is hardwired
to /var/run/pure\-ftpd/pure\-ftpd.pid in this script.
.PP
You can display the Pure-FTPd commandline options with \f(CW\*(C`\-s\*(C'\fR or
\&\f(CW\*(C`\-\-show\-options\*(C'\fR:
.PP
.Vb 1
\&    pure\-ftpd\-wrapper \-\-show\-options
.Ve
.SH "CONFIGURATION"
.IX Header "CONFIGURATION"
.SS "Boolean values"
.IX Subsection "Boolean values"
The strings \f(CW\*(C`Yes\*(C'\fR,\f(CW1\fR,\f(CW\*(C`On\*(C'\fR enable the corresponding commandline option
(case doesn't matter). To disable the option use \f(CW\*(C`No\*(C'\fR,\f(CW0\fR or \f(CW\*(C`Off\*(C'\fR.
.PP
Configuration files containing boolean values are \f(CW\*(C`AllowAnonymousFXP\*(C'\fR,
\&\f(CW\*(C`AllowDotFiles\*(C'\fR, \f(CW\*(C`AllowUserFXP\*(C'\fR, \f(CW\*(C`AnonymousCanCreateDirs\*(C'\fR,
\&\f(CW\*(C`AnonymousCantUpload\*(C'\fR, \f(CW\*(C`AnonymousOnly\*(C'\fR, \f(CW\*(C`AntiWarez\*(C'\fR, \f(CW\*(C`AutoRename\*(C'\fR,
\&\f(CW\*(C`BrokenClientsCompatibility\*(C'\fR, \f(CW\*(C`CallUploadScript\*(C'\fR, \f(CW\*(C`ChrootEveryone\*(C'\fR,
\&\f(CW\*(C`CreateHomeDir\*(C'\fR, \f(CW\*(C`CustomerProof\*(C'\fR, \f(CW\*(C`Daemonize\*(C'\fR, \f(CW\*(C`DisplayDotFiles\*(C'\fR,
\&\f(CW\*(C`DontResolve\*(C'\fR, \f(CW\*(C`IPV4Only\*(C'\fR, \f(CW\*(C`IPV6Only\*(C'\fR, \f(CW\*(C`KeepAllFiles\*(C'\fR, \f(CW\*(C`LogPID\*(C'\fR,
\&\f(CW\*(C`NATmode\*(C'\fR, \f(CW\*(C`NoAnonymous\*(C'\fR, \f(CW\*(C`NoChmod\*(C'\fR, \f(CW\*(C`NoRename\*(C'\fR, \f(CW\*(C`NoTruncate\*(C'\fR,
\&\f(CW\*(C`PAMAuthentication\*(C'\fR, \f(CW\*(C`ProhibitDotFilesRead\*(C'\fR, \f(CW\*(C`ProhibitDotFilesWrite\*(C'\fR,
\&\f(CW\*(C`UnixAuthentication\*(C'\fR and \f(CW\*(C`VerboseLog\*(C'\fR.
.SS "Numerical values"
.IX Subsection "Numerical values"
There are several types of numerical values (one number, two numbers,
one or two numbers, two octal numbers).
.IP "One number" 4
.IX Item "One number"
\&\f(CW\*(C`MaxClientsNumber\*(C'\fR, \f(CW\*(C`MaxClientsPerIP\*(C'\fR, \f(CW\*(C`MaxDiskUsage\*(C'\fR, \f(CW\*(C`MaxIdleTime\*(C'\fR,
\&\f(CW\*(C`MaxLoad\*(C'\fR, \f(CW\*(C`MinUID\*(C'\fR, \f(CW\*(C`TLS\*(C'\fR, \f(CW\*(C`TrustedGID\*(C'\fR.
.IP "Two numbers" 4
.IX Item "Two numbers"
\&\f(CW\*(C`AnonymousRatio\*(C'\fR, \f(CW\*(C`LimitRecursion\*(C'\fR, \f(CW\*(C`PassivePortRange\*(C'\fR, 
\&\f(CW\*(C`PerUserLimits\*(C'\fR, \f(CW\*(C`Quota\*(C'\fR, \f(CW\*(C`UserRatio\*(C'\fR.
.IP "Two numbers (with unlimited value)" 4
.IX Item "Two numbers (with unlimited value)"
This allows \-1 in addition to positive numbers indicating an unlimited
values.
.Sp
\&\f(CW\*(C`LimitRecursion\*(C'\fR.
.IP "One or two numbers" 4
.IX Item "One or two numbers"
\&\f(CW\*(C`AnonymousBandwidth\*(C'\fR, \f(CW\*(C`UserBandwidth\*(C'\fR.
.IP "Two octal numbers" 4
.IX Item "Two octal numbers"
\&\f(CW\*(C`Umask\*(C'\fR.
.SS "String values"
.IX Subsection "String values"
.IP "Arbritrary strings" 4
.IX Item "Arbritrary strings"
\&\f(CW\*(C`AltLog\*(C'\fR, \f(CW\*(C`Bind\*(C'\fR, \f(CW\*(C`ForcePassiveIP\*(C'\fR.
.IP "Words" 4
.IX Item "Words"
\&\f(CW\*(C`SyslogFacility\*(C'\fR.
.SS "Character Sets"
.IX Subsection "Character Sets"
\&\f(CW\*(C`FSCharset\*(C'\fR, \f(CW\*(C`ClientCharset\*(C'\fR.
.SS "\s-1IP\s0 values"
.IX Subsection "IP values"
\&\f(CW\*(C`TrustedIP\*(C'\fR.
.SS "File values"
.IX Subsection "File values"
These values designate an existing file or socket.
.IP "File" 4
.IX Item "File"
\&\f(CW\*(C`FortunesFile\*(C'\fR, \f(CW\*(C`LDAPConfigFile\*(C'\fR, \f(CW\*(C`MySQLConfigFile\*(C'\fR, \f(CW\*(C`PGSQLConfigFile\*(C'\fR, \f(CW\*(C`PureDB\*(C'\fR.
.IP "Socket" 4
.IX Item "Socket"
\&\f(CW\*(C`ExtAuth\*(C'\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
This manual page was written by Stefan Hornburg (Racke) <racke@linuxia.de>
for the Debian GNU/Linux system.