summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html
diff options
context:
space:
mode:
authorperry <perry@NetBSD.org>2002-02-02 23:10:24 +0000
committerperry <perry@NetBSD.org>2002-02-02 23:10:24 +0000
commit6f59dc7aebbf705da79e61ef3fd24b48ed99d327 (patch)
treec6e9fd356c8aac78b966a9dd53f5d0d14d5e62cd /gnu/dist/postfix/html
parentecf43984517b4cfb837e78958769cc8207ea5288 (diff)
Postfix 1.1.2
(Postfix releases are now numbered -- 1.1.2 means 1.1, patchlevel 2.) Lots of new features, same great security.
Diffstat (limited to 'gnu/dist/postfix/html')
-rw-r--r--gnu/dist/postfix/html/Makefile.in124
-rw-r--r--gnu/dist/postfix/html/access.5.html147
-rw-r--r--gnu/dist/postfix/html/aliases.5.html63
-rw-r--r--gnu/dist/postfix/html/backstage.html3
-rw-r--r--gnu/dist/postfix/html/bounce.8.html41
-rw-r--r--gnu/dist/postfix/html/canonical.5.html143
-rw-r--r--gnu/dist/postfix/html/cleanup.8.html96
-rw-r--r--gnu/dist/postfix/html/commands.html10
-rw-r--r--gnu/dist/postfix/html/error.8.html59
-rw-r--r--gnu/dist/postfix/html/faq.html329
-rw-r--r--gnu/dist/postfix/html/flush.8.html65
-rw-r--r--gnu/dist/postfix/html/lmtp.8.html68
-rw-r--r--gnu/dist/postfix/html/local.8.html269
-rw-r--r--gnu/dist/postfix/html/master.8.html46
-rw-r--r--gnu/dist/postfix/html/nqmgr.8.html343
-rw-r--r--gnu/dist/postfix/html/pcre_table.5.html103
-rw-r--r--gnu/dist/postfix/html/pickup.8.html93
-rw-r--r--gnu/dist/postfix/html/pipe.8.html204
-rw-r--r--gnu/dist/postfix/html/postalias.1.html102
-rw-r--r--gnu/dist/postfix/html/postcat.1.html30
-rw-r--r--gnu/dist/postfix/html/postconf.1.html72
-rw-r--r--gnu/dist/postfix/html/postdrop.1.html106
-rw-r--r--gnu/dist/postfix/html/postfix.1.html173
-rw-r--r--gnu/dist/postfix/html/postkick.1.html58
-rw-r--r--gnu/dist/postfix/html/postlock.1.html31
-rw-r--r--gnu/dist/postfix/html/postlog.1.html7
-rw-r--r--gnu/dist/postfix/html/postmap.1.html100
-rw-r--r--gnu/dist/postfix/html/postqueue.1.html115
-rw-r--r--gnu/dist/postfix/html/postsuper.1.html192
-rw-r--r--gnu/dist/postfix/html/qmgr.8.html108
-rw-r--r--gnu/dist/postfix/html/qmqpd.8.html122
-rw-r--r--gnu/dist/postfix/html/receiving.html13
-rw-r--r--gnu/dist/postfix/html/regexp_table.5.html92
-rw-r--r--gnu/dist/postfix/html/relocated.5.html111
-rw-r--r--gnu/dist/postfix/html/rewrite.html28
-rw-r--r--gnu/dist/postfix/html/security.html17
-rw-r--r--gnu/dist/postfix/html/sendmail.1.html228
-rw-r--r--gnu/dist/postfix/html/showq.8.html12
-rw-r--r--gnu/dist/postfix/html/smtp.8.html123
-rw-r--r--gnu/dist/postfix/html/smtpd.8.html220
-rw-r--r--gnu/dist/postfix/html/spawn.8.html33
-rw-r--r--gnu/dist/postfix/html/transport.5.html136
-rw-r--r--gnu/dist/postfix/html/trivial-rewrite.8.html64
-rw-r--r--gnu/dist/postfix/html/uce.html210
-rw-r--r--gnu/dist/postfix/html/virtual.5.html102
-rw-r--r--gnu/dist/postfix/html/virtual.8.html228
46 files changed, 2396 insertions, 2643 deletions
diff --git a/gnu/dist/postfix/html/Makefile.in b/gnu/dist/postfix/html/Makefile.in
index 8f7e91ac162..ca3515cb256 100644
--- a/gnu/dist/postfix/html/Makefile.in
+++ b/gnu/dist/postfix/html/Makefile.in
@@ -5,14 +5,16 @@ SHELL = /bin/sh
DAEMONS = bounce.8.html cleanup.8.html defer.8.html error.8.html local.8.html \
lmtp.8.html master.8.html pickup.8.html pipe.8.html qmgr.8.html \
showq.8.html smtp.8.html smtpd.8.html trivial-rewrite.8.html \
- spawn.8.html flush.8.html # nqmgr.8.html virtual.8.html
+ nqmgr.8.html spawn.8.html flush.8.html virtual.8.html qmqpd.8.html
COMMANDS= mailq.1.html newaliases.1.html postalias.1.html postcat.1.html \
postconf.1.html postfix.1.html postkick.1.html postlock.1.html \
postlog.1.html postdrop.1.html postmap.1.html sendmail.1.html \
- postsuper.1.html
+ postqueue.1.html postsuper.1.html
CONFIG = access.5.html aliases.5.html canonical.5.html relocated.5.html \
transport.5.html virtual.5.html pcre_table.5.html regexp_table.5.html
+AWK = awk '{ print; if (NR == 1) print ".pl 9999" }'
+
update: $(DAEMONS) $(COMMANDS) $(CONFIG)
Makefile: Makefile.in
@@ -27,124 +29,170 @@ clobber:
rm -f $(DAEMONS) $(COMMANDS) $(CONFIG)
bounce.8.html: ../src/bounce/bounce.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
defer.8.html: bounce.8.html
rm -f $@
ln -s $? $@
error.8.html: ../src/error/error.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
flush.8.html: ../src/flush/flush.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
cleanup.8.html: ../src/cleanup/cleanup.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
lmtp.8.html: ../src/lmtp/lmtp.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
local.8.html: ../src/local/local.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
master.8.html: ../src/master/master.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
nqmgr.8.html: ../src/nqmgr/qmgr.c
+ PATH=../mantools:$$PATH; \
srctoman $? | sed -e 's/qmgr[^_]/n&/' \
-e 's/qmgr$$/n&/' \
-e 's/QMGR[^_]/N&/' | \
- nroff -man | man2html | postlink >$@
+ $(AWK) | nroff -man | uniq | man2html | postlink >$@
pickup.8.html: ../src/pickup/pickup.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
pipe.8.html: ../src/pipe/pipe.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
qmgr.8.html: ../src/qmgr/qmgr.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
+
+qmqpd.8.html: ../src/qmqpd/qmqpd.c
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
showq.8.html: ../src/showq/showq.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
spawn.8.html: ../src/spawn/spawn.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
smtp.8.html: ../src/smtp/smtp.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
smtpd.8.html: ../src/smtpd/smtpd.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
virtual.8.html: ../src/virtual/virtual.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
trivial-rewrite.8.html: ../src/trivial-rewrite/trivial-rewrite.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postalias.1.html: ../src/postalias/postalias.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postcat.1.html: ../src/postcat/postcat.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postconf.1.html: ../src/postconf/postconf.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postdrop.1.html: ../src/postdrop/postdrop.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postfix.1.html: ../src/postfix/postfix.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postkick.1.html: ../src/postkick/postkick.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postlock.1.html: ../src/postlock/postlock.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postlog.1.html: ../src/postlog/postlog.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postmap.1.html: ../src/postmap/postmap.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
+
+postqueue.1.html: ../src/postqueue/postqueue.c
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
postsuper.1.html: ../src/postsuper/postsuper.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
sendmail.1.html: ../src/sendmail/sendmail.c
- srctoman $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
mailq.1.html: sendmail.1.html
+ PATH=../mantools:$$PATH; \
rm -f $@
ln -s $? $@
newaliases.1.html: sendmail.1.html
+ PATH=../mantools:$$PATH; \
rm -f $@
ln -s $? $@
access.5.html: ../proto/access
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
aliases.5.html: ../proto/aliases
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
canonical.5.html: ../proto/canonical
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
pcre_table.5.html: ../proto/pcre_table
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
regexp_table.5.html: ../proto/regexp_table
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
relocated.5.html: ../proto/relocated
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
transport.5.html: ../proto/transport
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
virtual.5.html: ../proto/virtual
- srctoman - $? | nroff -man | man2html | postlink >$@
+ PATH=../mantools:$$PATH; \
+ srctoman - $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
diff --git a/gnu/dist/postfix/html/access.5.html b/gnu/dist/postfix/html/access.5.html
index 89db2dcb3a7..ce041680ba5 100644
--- a/gnu/dist/postfix/html/access.5.html
+++ b/gnu/dist/postfix/html/access.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
ACCESS(5) ACCESS(5)
-
<b>NAME</b>
access - format of Postfix access table
@@ -13,9 +10,9 @@ ACCESS(5) ACCESS(5)
<b>DESCRIPTION</b>
The optional <b>access</b> table directs the Postfix SMTP server
- to selectively reject or accept mail from or to specific
- hosts, domains, networks, host addresses or mail
- addresses.
+ to selectively reject or accept mail. Access can be
+ allowed or denied for specific host names, domain names,
+ networks, host network addresses or mail addresses.
Normally, the <b>access</b> table is specified as a text file
that serves as input to the <a href="postmap.1.html"><b>postmap</b>(1)</a> command. The
@@ -36,45 +33,68 @@ ACCESS(5) ACCESS(5)
<b>TABLE</b> <b>FORMAT</b>
The format of the access table is as follows:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the pre-
- vious line.
-
<i>pattern</i> <i>action</i>
When <i>pattern</i> matches a mail address, domain or host
address, perform the corresponding <i>action</i>.
-<b>PATTERNS</b>
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
+
+<b>EMAIL</b> <b>ADDRESS</b> <b>PATTERNS</b>
With lookups from indexed files such as DB or DBM, or from
- networked tables such as NIS, LDAP or SQL, patterns are
- tried in the order as listed below:
+ networked tables such as NIS, LDAP or SQL, the following
+ lookup patterns are examined in the order as listed:
<i>user</i>@<i>domain</i>
Matches the specified mail address.
<i>domain.name</i>
- Matches the <i>domain.name</i> itself and any subdomain
- thereof, either in hostnames or in mail addresses.
-
-
-
- 1
-
+ Matches <i>domain.name</i> as the domain part of an email
+ address.
+ The pattern <i>domain.name</i> also matches subdomains,
+ but only when the string <b>smtpd</b><i>_</i><b>access</b><i>_</i><b>maps</b> is
+ listed in the Postfix <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdo-</b>
+ <b>mains</b> configuration setting. Otherwise, specify
+ <i>.domain.name</i> (note the initial dot) in order to
+ match subdomains.
+ <i>user</i>@ Matches all mail addresses with the specified user
+ part.
+ Note: lookup of the null sender address may not be possi-
+ ble with all supported types of lookup table. A workaround
+ is to specify <b>smtpd</b><i>_</i><b>null</b><i>_</i><b>access</b><i>_</i><b>lookup</b><i>_</i><b>key</b> <b>=</b> &lt;&gt; in the
+ Postfix <b>main.cf</b> file, and to specify &lt;&gt; as the left-hand
+ field in the access table.
-ACCESS(5) ACCESS(5)
+<b>ADDRESS</b> <b>EXTENSION</b>
+ When a mail address localpart contains the optional recip-
+ ient delimiter (e.g., <i>user+foo</i>@<i>domain</i>), the lookup order
+ becomes: <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>domain</i>, <i>user+foo</i>@,
+ and <i>user</i>@.
+<b>HOST</b> <b>NAME/ADDRESS</b> <b>PATTERNS</b>
+ With lookups from indexed files such as DB or DBM, or from
+ networked tables such as NIS, LDAP or SQL, the following
+ lookup patterns are examined in the order as listed:
- Top-level domains will never be matched.
+ <i>domain.name</i>
+ Matches <i>domain.name</i>.
- <i>user</i>@ Matches all mail addresses with the specified user
- part.
+ The pattern <i>domain.name</i> also matches subdomains,
+ but only when the string <b>smtpd</b><i>_</i><b>access</b><i>_</i><b>maps</b> is
+ listed in the Postfix <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdo-</b>
+ <b>mains</b> configuration setting. Otherwise, specify
+ <i>.domain.name</i> (note the initial dot) in order to
+ match subdomains.
<i>net.work.addr.ess</i>
@@ -110,33 +130,22 @@ ACCESS(5) ACCESS(5)
the entire string being looked up. Depending on the appli-
cation, that string is an entire client hostname, an
entire client IP address, or an entire mail address. Thus,
- no parent domain or parent network search is done, and
+ no parent domain or parent network search is done,
<i>user@domain</i> mail addresses are not broken up into their
- <i>user@</i> and <i>domain</i> constituent parts.
+ <i>user@</i> and <i>domain</i> constituent parts, nor is <i>user+foo</i> broken
+ up into <i>user</i> and <i>foo</i>.
- Patterns are applied in the order as specified in the
- table, until a pattern is found that matches the search
+ Patterns are applied in the order as specified in the
+ table, until a pattern is found that matches the search
string.
- Actions are the same as with normal indexed file lookups,
- with the additional feature that parenthesized substrings
- from the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
+ Actions are the same as with indexed file lookups, with
+ the additional feature that parenthesized substrings from
+ the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
<b>BUGS</b>
The table format does not understand quoting conventions.
-
-
-
- 2
-
-
-
-
-
-ACCESS(5) ACCESS(5)
-
-
<b>SEE</b> <b>ALSO</b>
<a href="postmap.1.html">postmap(1)</a> create mapping table
<a href="smtpd.8.html">smtpd(8)</a> smtp server
@@ -153,48 +162,6 @@ ACCESS(5) ACCESS(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/aliases.5.html b/gnu/dist/postfix/html/aliases.5.html
index 50b5aaa3f91..2992fc0c4de 100644
--- a/gnu/dist/postfix/html/aliases.5.html
+++ b/gnu/dist/postfix/html/aliases.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
ALIASES(5) ALIASES(5)
-
<b>NAME</b>
aliases - format of the Postfix alias database
@@ -38,11 +35,13 @@ ALIASES(5) ALIASES(5)
<i>name</i>: <i>value1</i>, <i>value2</i>, <i>...</i>
- <b>o</b> Lines that begin with whitespace continue the pre-
- vious line.
+ <b>o</b> Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
- <b>o</b> Blank lines are ignored, as are lines beginning
- with `#'.
+ <b>o</b> A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
The <i>name</i> is a local address (no domain part). Use double
quotes when the name contains any special characters such
@@ -59,18 +58,6 @@ ALIASES(5) ALIASES(5)
The <i>value</i> contains one or more of the following:
-
-
-
- 1
-
-
-
-
-
-ALIASES(5) ALIASES(5)
-
-
<i>address</i>
Mail is forwarded to <i>address</i>, which is compatible
with the <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> standard.
@@ -124,19 +111,6 @@ ALIASES(5) ALIASES(5)
Restrict the usage of mail delivery to external
command.
-
-
-
-
- 2
-
-
-
-
-
-ALIASES(5) ALIASES(5)
-
-
<b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>files</b>
Restrict the usage of mail delivery to external
file.
@@ -172,29 +146,6 @@ ALIASES(5) ALIASES(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/backstage.html b/gnu/dist/postfix/html/backstage.html
index 577a3c0323f..5ee7aeef834 100644
--- a/gnu/dist/postfix/html/backstage.html
+++ b/gnu/dist/postfix/html/backstage.html
@@ -62,8 +62,7 @@ href="mailq.1.html">mailq</a> command.
<li>The <a href="flush.8.html">flush</a> daemon improves the
performance of the SMTP <b>ETRN</b> request, and of its command-line
equivalent, <b>sendmail -qR</b><i>destination</i>, for selected
-destinations. For other destinations, Postfix silently falls
-back to the equivalent of <b>sendmail -q</b>.
+destinations.
<p>
diff --git a/gnu/dist/postfix/html/bounce.8.html b/gnu/dist/postfix/html/bounce.8.html
index 63e760535e6..76cde51963f 100644
--- a/gnu/dist/postfix/html/bounce.8.html
+++ b/gnu/dist/postfix/html/bounce.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
BOUNCE(8) BOUNCE(8)
-
<b>NAME</b>
bounce - Postfix message bounce or defer daemon
@@ -59,18 +56,6 @@ BOUNCE(8) BOUNCE(8)
<b>bounce</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
The recipient of single bounce postmaster notices.
-
-
-
- 1
-
-
-
-
-
-BOUNCE(8) BOUNCE(8)
-
-
<b>2bounce</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
The recipient of double bounce postmaster notices.
@@ -105,30 +90,6 @@ BOUNCE(8) BOUNCE(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/canonical.5.html b/gnu/dist/postfix/html/canonical.5.html
index aedf505260f..2ec7403ca72 100644
--- a/gnu/dist/postfix/html/canonical.5.html
+++ b/gnu/dist/postfix/html/canonical.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
CANONICAL(5) CANONICAL(5)
-
<b>NAME</b>
canonical - format of Postfix canonical table
@@ -51,30 +48,20 @@ CANONICAL(5) CANONICAL(5)
<b>TABLE</b> <b>FORMAT</b>
The format of the <b>canonical</b> table is as follows:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the pre-
- vious line.
-
-
-
-
- 1
-
-
-
-
-
-CANONICAL(5) CANONICAL(5)
-
-
<i>pattern</i> <i>result</i>
When <i>pattern</i> matches a mail address, replace it by
the corresponding <i>result</i>.
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
+
With lookups from indexed files such as DB or DBM, or from
networked tables such as NIS, LDAP or SQL, patterns are
tried in the order as listed below:
@@ -104,13 +91,11 @@ CANONICAL(5) CANONICAL(5)
<i>domain</i>, the result is the same user in <i>otherdomain</i>.
<b>ADDRESS</b> <b>EXTENSION</b>
- When table lookup fails, and the address localpart con-
- tains the optional recipient delimiter (e.g.,
- <i>user+foo</i>@<i>domain</i>), the search is repeated for the unex-
- tended address (e.g. <i>user</i>@<i>domain</i>), and the unmatched
- extension is propagated to the result of table lookup. The
- matching order is: <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>user+foo</i>,
- <i>user</i>, and @<i>domain</i>.
+ When a mail address localpart contains the optional recip-
+ ient delimiter (e.g., <i>user+foo</i>@<i>domain</i>), the lookup order
+ becomes: <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>user+foo</i>, <i>user</i>, and
+ @<i>domain</i>. An unmatched address extension (<i>+foo</i>) is propa-
+ gated to the result of table lookup.
<b>REGULAR</b> <b>EXPRESSION</b> <b>TABLES</b>
This section describes how the table lookups change when
@@ -125,32 +110,20 @@ CANONICAL(5) CANONICAL(5)
<i>foo</i>.
Patterns are applied in the order as specified in the
-
-
-
- 2
-
-
-
-
-
-CANONICAL(5) CANONICAL(5)
-
-
table, until a pattern is found that matches the search
string.
- Results are the same as with normal indexed file lookups,
- with the additional feature that parenthesized substrings
- from the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
+ Results are the same as with indexed file lookups, with
+ the additional feature that parenthesized substrings from
+ the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
<b>BUGS</b>
- The table format does not understand quoting conventions.
+ The table format does not understand quoting conventions.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this topic. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this topic. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>canonical</b><i>_</i><b>maps</b>
@@ -167,19 +140,24 @@ CANONICAL(5) CANONICAL(5)
Other parameters of interest:
<b>inet</b><i>_</i><b>interfaces</b>
- The network interface addresses that this system
+ The network interface addresses that this system
receives mail on.
+ <b>masquerade</b><i>_</i><b>classes</b>
+ List of address classes subject to masquerading:
+ zero or more of <b>envelope</b><i>_</i><b>sender</b>, <b>envelope</b><i>_</i><b>recipi-</b>
+ <b>ent</b>, <b>header</b><i>_</i><b>sender</b>, <b>header</b><i>_</i><b>recipient</b>.
+
<b>masquerade</b><i>_</i><b>domains</b>
- List of domains that hide their subdomain struc-
+ List of domains that hide their subdomain struc-
ture.
<b>masquerade</b><i>_</i><b>exceptions</b>
- List of user names that are not subject to address
+ List of user names that are not subject to address
masquerading.
<b>mydestination</b>
- List of domains that this mail system considers
+ List of domains that this mail system considers
local.
<b>myorigin</b>
@@ -191,25 +169,13 @@ CANONICAL(5) CANONICAL(5)
<b>SEE</b> <b>ALSO</b>
<a href="cleanup.8.html">cleanup(8)</a> canonicalize and enqueue mail
-
-
-
- 3
-
-
-
-
-
-CANONICAL(5) CANONICAL(5)
-
-
<a href="postmap.1.html">postmap(1)</a> create mapping table
<a href="virtual.5.html">virtual(5)</a> virtual domain mapping
<a href="pcre_table.5.html">pcre_table(5)</a> format of PCRE tables
<a href="regexp_table.5.html">regexp_table(5)</a> format of POSIX regular expression tables
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -218,49 +184,6 @@ CANONICAL(5) CANONICAL(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/cleanup.8.html b/gnu/dist/postfix/html/cleanup.8.html
index 2c1722d5c27..f1ce6052662 100644
--- a/gnu/dist/postfix/html/cleanup.8.html
+++ b/gnu/dist/postfix/html/cleanup.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
CLEANUP(8) CLEANUP(8)
-
<b>NAME</b>
cleanup - canonicalize and enqueue Postfix message
@@ -43,62 +40,51 @@ CLEANUP(8) CLEANUP(8)
and message header addresses (i.e. strip host or
domain information below all domains listed in the
<b>masquerade</b><i>_</i><b>domains</b> parameter, except for user names
- listed in <b>masquerade</b><i>_</i><b>exceptions</b>). Address mas-
- querading does not affect envelope recipients.
+ listed in <b>masquerade</b><i>_</i><b>exceptions</b>). By default,
+ address masquerading does not affect envelope
+ recipients.
<b>o</b> Optionally, expand envelope recipients according to
- information found in the <a href="virtual.5.html"><b>virtual</b>(5)</a> lookup tables.
+ information found in the <a href="virtual.5.html"><b>virtual</b>(5)</a> lookup tables.
- The <b>cleanup</b> daemon performs sanity checks on the content
- of each message. When it finds a problem, by default it
- returns a diagnostic status to the client, and leaves it
- up to the client to deal with the problem. Alternatively,
- the client can request the <b>cleanup</b> daemon to bounce the
+ The <b>cleanup</b> daemon performs sanity checks on the content
+ of each message. When it finds a problem, by default it
+ returns a diagnostic status to the client, and leaves it
+ up to the client to deal with the problem. Alternatively,
+ the client can request the <b>cleanup</b> daemon to bounce the
message back to the sender in case of trouble.
<b>STANDARDS</b>
<a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> (ARPA Internet Text Messages)
-
-
-
- 1
-
-
-
-
-
-CLEANUP(8) CLEANUP(8)
-
-
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8).
<b>BUGS</b>
- Table-driven rewriting rules make it hard to express <b>if</b>
+ Table-driven rewriting rules make it hard to express <b>if</b>
<b>then</b> <b>else</b> and other logical relationships.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this program. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>Content</b> <b>filtering</b>
<b>body</b><i>_</i><b>checks</b>
Lookup tables with content filters for message body
- lines. These filters see physical lines one at a
+ lines. These filters see physical lines one at a
time, in chunks of at most line_length_limit bytes.
<b>header</b><i>_</i><b>checks</b>
- Lookup tables with content filters for message
- header lines. These filters see logical headers
+ Lookup tables with content filters for message
+ header lines. These filters see logical headers
one at a time, including headers that span multiple
lines.
<b>Miscellaneous</b>
<b>always</b><i>_</i><b>bcc</b>
- Address to send a copy of each message that enters
+ Address to send a copy of each message that enters
the system.
<b>hopcount</b><i>_</i><b>limit</b>
@@ -111,8 +97,8 @@ CLEANUP(8) CLEANUP(8)
<b>Address</b> <b>transformations</b>
<b>empty</b><i>_</i><b>address</b><i>_</i><b>recipient</b>
- The destination for undeliverable mail from &lt;&gt;.
- This substitution is done before all other address
+ The destination for undeliverable mail from &lt;&gt;.
+ This substitution is done before all other address
rewriting.
<b>canonical</b><i>_</i><b>maps</b>
@@ -125,26 +111,19 @@ CLEANUP(8) CLEANUP(8)
<b>sender</b><i>_</i><b>canonical</b><i>_</i><b>maps</b>
Address mapping lookup table for envelope and
-
-
-
- 2
-
-
-
-
-
-CLEANUP(8) CLEANUP(8)
-
-
header sender addresses.
+ <b>masquerade</b><i>_</i><b>classes</b>
+ List of address classes subject to masquerading:
+ zero or more of <b>envelope</b><i>_</i><b>sender</b>, <b>envelope</b><i>_</i><b>recipi-</b>
+ <b>ent</b>, <b>header</b><i>_</i><b>sender</b>, <b>header</b><i>_</i><b>recipient</b>.
+
<b>masquerade</b><i>_</i><b>domains</b>
- List of domains that hide their subdomain struc-
+ List of domains that hide their subdomain struc-
ture.
<b>masquerade</b><i>_</i><b>exceptions</b>
- List of user names that are not subject to address
+ List of user names that are not subject to address
masquerading.
<b>virtual</b><i>_</i><b>maps</b>
@@ -153,15 +132,20 @@ CLEANUP(8) CLEANUP(8)
<b>Resource</b> <b>controls</b>
<b>duplicate</b><i>_</i><b>filter</b><i>_</i><b>limit</b>
- Limit the number of envelope recipients that are
+ Limit the number of envelope recipients that are
remembered.
<b>header</b><i>_</i><b>size</b><i>_</i><b>limit</b>
Limit the amount of memory in bytes used to process
a message header.
+ <b>in</b><i>_</i><b>flow</b><i>_</i><b>delay</b>
+ Amount of time to pause before accepting a message,
+ when the message arrival rate exceeds the message
+ delivery rate.
+
<b>extract</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
- Limit the amount of recipients extracted from mes-
+ Limit the amount of recipients extracted from mes-
sage headers.
<b>SEE</b> <b>ALSO</b>
@@ -176,7 +160,7 @@ CLEANUP(8) CLEANUP(8)
/etc/postfix/virtual*, virtual mapping table
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -185,16 +169,6 @@ CLEANUP(8) CLEANUP(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/commands.html b/gnu/dist/postfix/html/commands.html
index 0b1e5ce63e9..e4bb9d57b76 100644
--- a/gnu/dist/postfix/html/commands.html
+++ b/gnu/dist/postfix/html/commands.html
@@ -61,8 +61,8 @@ something more powerful that can not only list but also edit the
<p>
<li>The <a href="postdrop.1.html">postdrop</a> command is the mail
-posting agent that is run by the <a href="sendmail.1.html">sendmail</a>
-command on systems that have no world-writable <b>maildrop</b> queue
+posting utility that is run by the <a href="sendmail.1.html">sendmail</a>
+command in order to deposit mail into the <b>maildrop</b> queue
directory.
<p>
@@ -91,6 +91,12 @@ the UNIX <b>makemap</b> command.
<p>
+<li>The <a href="postqueue.1.html">postqueue</a> command is the
+utility that is run by the <a href="sendmail.1.html">sendmail</a>
+command in order to flush or list the mail queue.
+
+<p>
+
<li>The <a href="postsuper.1.html">postsuper</a> command maintains
the Postfix queue. It removes old temporary files, and moves queue
files into the right directory after a change in the hashing depth
diff --git a/gnu/dist/postfix/html/error.8.html b/gnu/dist/postfix/html/error.8.html
index d36ab9919bd..a96801b3250 100644
--- a/gnu/dist/postfix/html/error.8.html
+++ b/gnu/dist/postfix/html/error.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
ERROR(8) ERROR(8)
-
<b>NAME</b>
error - Postfix error mailer
@@ -59,18 +56,6 @@ ERROR(8) ERROR(8)
mail to the postmaster with with the headers of the
bounced mail.
-
-
-
- 1
-
-
-
-
-
-ERROR(8) ERROR(8)
-
-
<b>SEE</b> <b>ALSO</b>
<a href="bounce.8.html">bounce(8)</a> non-delivery status reports
<a href="master.8.html">master(8)</a> process manager
@@ -87,48 +72,6 @@ ERROR(8) ERROR(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/faq.html b/gnu/dist/postfix/html/faq.html
index 425304fddb9..85f8cb644e4 100644
--- a/gnu/dist/postfix/html/faq.html
+++ b/gnu/dist/postfix/html/faq.html
@@ -94,6 +94,12 @@ domains with "relay access denied"</a>
<li><a href="#broken_transport">Mail delivery fails with: "unknown
mail transport error"</a>
+<li><a href="#msql_limit">Too many connections</a>
+
+<li><a href="#reiser_bugs">write queue file: No such file or directory</a>
+
+<li><a href="#reiser_bugs">write queue file: Unknown error 4294967289</a>
+
</ul>
<p>
@@ -153,6 +159,10 @@ distribution list</a>
<li><a href="#moby-linux">Running hundreds of Postfix processes on Linux</a>
+<li><a href="#moby-sun">Running hundreds of Postfix processes on Solaris</a>
+
+<li><a href="#moby-postfix">Running thousands of Postfix delivery agents</a>
+
</ul>
@@ -286,6 +296,9 @@ domains with "relay access denied"</a>
<li><a href="#domain_mailbox">Receiving a virtual domain in a
mailbox</a>
+<li><a href="#virtual_logging">Postfix logs delivery to virtual
+address with the wrong name</a>
+
</ul>
<a name="address_rewriting"><h3>Address rewriting</h3>
@@ -308,6 +321,8 @@ mailbox</a>
<ul>
+<li><a href="#uucp-tcp">Using UUCP over TCP</a>
+
<li><a href="#internet-uucp">Setting up an Internet to UUCP gateway</a>
<li><a href="#uucp-only">Using UUCP as the default transport</a>
@@ -394,7 +409,7 @@ implements its own private mail database system. Not for beginners.
<p>
<li><a href="http://www.inter7.com/courierimap/">Courier-Imap</a>
-provides POP3, IMAP, POP3 and IMAP, and supports access over SSL.
+provides POP3 and IMAP, and supports access over SSL.
This software supports the maildir-style mailbox format only
(one message per file, same format as qmail).
@@ -656,6 +671,7 @@ to send mail only to <i>user@domain.com</i>.
transport_maps = hash:/etc/postfix/transport
mynetworks = 12.34.56.0/24
smtpd_recipient_restrictions = permit_mynetworks reject_unauth_destination
+ local_transport = error:local mail delivery is disabled on this machine
/etc/postfix/transport:
domain.com smtp:inside-gateway.domain.com (forwards user@domain)
@@ -1120,36 +1136,43 @@ run out of file handles; after that, it will run out of sockets.
<p>
-To set kernel parameters at boot time, add the following lines to
-the <b>/boot/loader.conf</b> file (this is specific to FreeBSD 4.x):
+To set the following kernel parameters at boot time, add the
+following lines to the <b>/boot/loader.conf</b> file (this is
+verified with FreeBSD 4.4):
<p>
<blockquote>
<pre>
kern.ipc.maxsockets="5000"
+kern.ipc.nmbclusters="65536"
+kern.maxproc="2048"
kern.maxfiles="16384"
kern.maxfilesperproc="16384"
-kern.ipc.nmbclusters="65536"
</pre>
</blockquote>
<p>
-To set kernel parameters at run time execute the following commands
-as root (this is specific to FreeBSD 4.x):
+With FreeBSD 4.2, the last three parameters cannot be set from
+<b>/boot/loader.conf</b>. To set the open file limits, execute the
+following commands as root:
<p>
<blockquote>
<pre>
-# sysctl -w kern.ipc.maxsockets=5000
# sysctl -w kern.maxfiles=16384
# sysctl -w kern.maxfilesperproc=16384
-# sysctl -w kern.ipc.nmbclusters=65536
</pre>
</blockquote>
+<p>
+
+With FreeBSD 4.2, <b>kern.maxproc</b> can be set only by recompiling
+the kernel with a different <b>maxusers</b> setting in the kernel
+configuration file.
+
<hr>
<a name="moby-linux"><h3>Running hundreds of Postfix processes on Linux</h3></a>
@@ -1192,6 +1215,42 @@ commands as <b>root</b>:
<hr>
+<a name="moby-sun"><h3>Running hundreds of Postfix processes on Solaris</h3></a>
+
+In order to run hundreds of processes you may have to adjust the
+per-process open file limit. According to the <a
+href="http://www.science.uva.nl/pub/solaris/solaris2.html#q3.45">Solaris
+FAQ</a>, add the following lines to /etc/system on Solaris 2.4 and later:
+
+<p>
+<blockquote>
+<pre>
+* set hard limit on file descriptors
+set rlim_fd_max = 4096
+* set soft limit on file descriptors
+set rlim_fd_cur = 2048
+</pre>
+</blockquote>
+
+<hr>
+
+<a name="moby-postfix"><h3>Running thousands of Postfix delivery agents</h3></a>
+
+In order to run Postfix with more than a thousand delivery agents you
+need to recompile the software with an appropriate value of the
+<b>FD_SETSIZE</b> constant.
+
+<p>
+<blockquote>
+<pre>
+% make tidy
+% make makefiles "CCARGS=-DFD_SETSIZE=2048"
+% make
+</pre>
+</blockquote>
+
+<hr>
+
<a name="incoming"><h3>Mail stays queued in the incoming queue</h3></a>
<blockquote>
@@ -1456,7 +1515,11 @@ href="uce.html#reject_unauth_destination">reject_unauth_destination</a>:
reject when the destination is not local.
<li> <a href="uce.html#permit_mx_backup">permit_mx_backup</a>:
-reject when the destination is not local.
+permit if the local system is listed as MX host for the recipient
+domain. Use the optional <a
+href="#permit_mx_backup_networks">permit_mx_backup_networks</a>
+parameter to also require that the primary MX hosts match a list
+of network blocks (Postfix versions 20011008 and later).
<li> Other UCE restrictions (e.g., SMTPD access maps) are not aware
of sender-provided routing information.
@@ -1809,9 +1872,9 @@ like:
A little background is in order. With the SMTP protocol, the HELO,
MAIL FROM and RCPT TO commands and responses are relatively short.
-When you're talking to sendmail, every command and every response
-is sent as a separate packet, because sendmail cannot implement
-ESMTP command pipelining.
+When you're talking to old versions of sendmail, every command and
+every response is sent as a separate packet, because sendmail didn't
+implement ESMTP command pipelining until recently.
<p>
@@ -2599,7 +2662,9 @@ that the mail was sent to.
Answer: I hope we all agree that delivering a domain to a mailbox
is disgusting practice. Forwarding mail via SMTP or UUCP would be
a much better choice. Unfortunately, neither SMTP nor UUCP are a
-usable alternative for legions of windows users.
+usable alternative for legions of windows users. However, if this
+is an option for you see the <a href="#uucp-tcp">UUCP over TCP</a>
+guide below.
<p>
@@ -2652,6 +2717,44 @@ your system supports, use the command <b>postconf -m</b>.
<hr>
+<a name="virtual_logging"><h3>Postfix logs delivery to virtual
+address with the wrong name</h3></a>
+
+When Postfix delivers mail for a virtual address <i>vuser@vdomain.name</i>
+that is aliased to a local user, then Postfix logs the local username
+instead of the virtual one.
+
+<p>
+
+Changing this requires non-trivial changes, because Postfix only
+remembers the address that it delivers to, not the address that
+was original specified in, for example, the SMTP MAIL FROM command.
+
+<p>
+
+A workaround exists. It uses regular expressions. This
+can be expensive if you have many virtual domains.
+
+<p>
+<blockquote>
+<pre>
+/etc/postfix/main.cf:
+ virtual_maps = regexp:/etc/postfix/virtual_regexp
+ recipient_delimiter = +
+
+/etc/postfix/virtual_regexp:
+ /^vdomain\.name$/ whatever
+ /(.*)@vdomain\.name$/ localuser+$1=vdomain.name
+</pre>
+</blockquote>
+
+<p>
+
+This delivers the mail as
+<i>localuser+vuser=vdomain.name@your.domain</i>.
+
+<hr>
+
<a name="masquerade"><h3>Address masquerading with exceptions</h3></a>
For people outside your organization it can be desirable to only
@@ -2784,6 +2887,28 @@ See examples in <b>master.cf</b>.
<hr>
+<a name="uucp-tcp"><h3>Using UUCP over TCP</h3>
+
+This subject comes up whenever someone asks about a "domain in
+a mailbox" solution. For first-hand information, see the guides
+listed below.
+
+<ul>
+
+<li>Jim Seymour's guide for using <a
+href="http://jimsun.LinxNet.com/jdp/uucp_over_tcp/index.html"> UUCP
+over TCP</a>.
+
+<p>
+
+<li>Craig Sanders's guide for using <a
+href="http://taz.net.au/postfix/uucp/"> SSL-encrypted UUCP over
+tcp using stunnel</a>.
+
+</ul>
+
+<hr>
+
<a name="internet-uucp"><h3>Setting up an Internet to UUCP gateway</h3> </a>
Here is how to set up a machine that sits on the Internet and that
@@ -2889,7 +3014,7 @@ changes effective.
Here is how to relay all your mail over a UUCP link. See the <a
href="#internet-uucp">Internet to UUCP</a> FAQ entry for setting
-up a machine that gateways between UUCP and SMTP.
+up a machine that gateways between UUCP and SMTP.
<p>
@@ -2988,41 +3113,59 @@ Note: be sure to not advertise <b>fax.your.domain</b> in the DNS :-)
<a name="deleting"><h3>Deleting a message from the Postfix queue</h3></a>
-To delete ONE message with queue id ABCDEF (e.g., from <b>mailq</b>
-output) from the Postfix queue, it is not necessary to stop Postfix.
+As of Postfix version 20010502, the <b>postsuper</b> command
+has an option to delete Postfix message queue files. To delete
+the message with queue id ABCDEF, perhaps obtained from <b>mailq</b>
+output, one would use:
<p>
+<blockquote>
<pre>
- # cd /var/spool/postfix
- # find incoming active deferred -name ABCDEF -print | sed 1q | xargs rm
+# postsuper -d ABCDEF
</pre>
+</blockquote>
<p>
-The above command is safe because it deletes at most one file.
-There is no risk of deleting newly arrived mail that happens to get
-the same queue file name.
+To delete a large number of files one would use:
<p>
-If you have to delete a large amount of mail, you must stop Postfix
-first.
-
-<p>
+<blockquote>
<pre>
- # postfix stop
- # cd /var/spool/postfix
- # find incoming active deferred defer -type f -print |
- fgrep -xf /file/with/queue-ids | xargs rm
- # postfix start
+# postsuper -d - < <i>filename-with-queue-ids</i>
</pre>
+</blockquote>
<p>
-Do not use the above <b>find</b> command on a running Postfix
-system, because it can delete files that belong to new mail that
-arrives while you are deleting queue files.
+It is usually safe to do this while the Postfix system is running.
+However, there is a small chance of deleting the wrong queue
+file. The scenario goes like this:
+
+<p>
+
+<ul>
+
+<li>The Postfix queue manager deletes the file that <b>postsuper</b>
+was supposed to delete, because Postfix was finished with the
+message.
+
+<p>
+
+<li>New mail arrives, and the new message is given the same queue
+ID as the message that <b>postsuper</b> was supposed to delete.
+The probability for reusing a deleted queue ID is about 1 in
+2<sup>15</sup> (the number of different microsecond values that
+the system clock can distinguish).
+
+<p>
+
+<li><b>postsuper</b> deletes the new message file, instead of the
+old file that should have been deleted.
+
+</ul>
<hr>
@@ -3045,35 +3188,110 @@ that the file name will collide with another queue file.
<p>
-To avoid queue file name collisions when copying queue files,
-restore the incoming, active and deferred queue files under the
-maildrop directory instead.
+The text below describes two different procedures to restore
+queue files from another machine or from backup.
+
+<h4> Procedure 1: Your Postfix queue is empty, and you run Postfix
+release 20010525 or later</h4>
+
+<ul>
+
+<li> Stop Postfix, if it was running.
+
+<blockquote>
+<pre>
+# postfix stop
+</pre>
+</blockquote>
+
+<p>
+
+<li> Execute the <b>mailq</b> command. If there is any output, do
+not complete this procedure, but use <b>procedure 2</b> instead.
+
+<blockquote>
+<pre>
+# mailq
+</pre>
+</blockquote>
+
+<p>
+
+<li> Copy or restore the queue to the usual place.
+
+<blockquote>
+<pre>
+# cd /var/spool/postfix
+<i>...restore maildrop, incoming, active, deferred, defer, bounce here...</i>
+</pre>
+</blockquote>
+
+<p>
+
+<li> Run the <b>postsuper</b> command. This command will rename
+queue files so that the file names match their message file inode
+numbers.
+
+<blockquote>
+<pre>
+# postsuper
+</pre>
+</blockquote>
+
+</ul>
+
+<h4> Procedure 2: Your Postfix queue is not empty, or you are
+running a Postfix release prior to 20010525</h4>
+
+<ul>
+
+<li>Stop Postfix, if it was running.
+
+<blockquote>
+<pre>
+# postfix stop
+</pre>
+</blockquote>
+
+<p>
+
+<li> To avoid queue file name collisions when restoring queue files,
+copy or restore the incoming, active and deferred queue files under
+the maildrop directory instead.
+
+<blockquote>
+<pre>
+# cd /var/spool/postfix/maildrop
+<i>...restore incoming, active, deferred here...</i>
+</pre>
+</blockquote>
+
+<p>
+
+<li>While the next step is going on, don't submit new mail locally,
+because that could collide with the files you are restoring under
+the maildrop directory.
<p>
-As of late 2000, Postfix queues are all hashed (for example, file
+<li>As of late 2000, Postfix queues are all hashed (for example, file
ABCDEF is stored as A/B/ABCDEF), so you need an additional step to
move files down from their subdirectories.
<p>
<pre>
- # postfix stop
- # cd /var/spool/postfix/maildrop
- ... restore incoming/active/deferred queue files under the maildrop directory...
# find incoming active deferred -type f -exec mv '{}' . ';'
# rm -rf incoming active deferred
# postfix start
</pre>
-While all this is going on, don't submit new mail locally, because
-that could collide with the files you are restoring under the
-maildrop directory.
-
<p>
-When Postfix is started, it will pick up queue files from the
+<li>When Postfix is started, it will pick up queue files from the
maildrop directory and will give them proper queue file names.
+</ul>
+
<hr>
<a name="bind"><h3>Undefined symbols: ___dn_expand, ___res_init etc.</h3></a>
@@ -3208,6 +3426,27 @@ files, and to mount the Postfix queue file system with the
<hr>
+<a name="msql_limit"><h3>Too many connections</h3></a>
+
+This message is produced by the MYQSL server. You need to increase
+the number of connections that it can handle. Things to bear in
+mind: the <b>virtual</b> and <b>canonical</b> maps are accessed by
+every <b>smtpd</b> and <b>cleanup</b> process.
+
+<hr>
+
+<a name="reiser_bugs"><h3>write queue file: No such file or directory</h3></a>
+
+<h3>write queue file: Unknown error 4294967289</h3>
+
+Reiserfs reports the wrong error code when a message exceeds the
+<b>message_size_limit</b> setting. As a result, the Postfix SMTP
+server reports a "queue file write error" to the SMTP client, rather
+than reporting a "file too large" condition. The client will keep
+sending the same email again and again until the mail is too old.
+
+<hr>
+
<a href="index.html">Up one level</a> | Postfix FAQ
</body>
diff --git a/gnu/dist/postfix/html/flush.8.html b/gnu/dist/postfix/html/flush.8.html
index c9b6185883a..93223e406a7 100644
--- a/gnu/dist/postfix/html/flush.8.html
+++ b/gnu/dist/postfix/html/flush.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
FLUSH(8) FLUSH(8)
-
<b>NAME</b>
flush - Postfix fast flush server
@@ -47,8 +44,8 @@ FLUSH(8) FLUSH(8)
undeliverable it will be added back to the logfile.
If the destination is not eligible for a fast flush
- logfile, this request triggers delivery of all
- queued mail.
+ logfile, this request is rejected (see below for
+ status codes).
<b>TRIGGER</b><i>_</i><b>REQ</b><i>_</i><b>WAKEUP</b>
This wakeup request from the master is an alterna-
@@ -60,17 +57,6 @@ FLUSH(8) FLUSH(8)
simulating send requests (see above) for the corre-
sponding destinations.
-
-
- 1
-
-
-
-
-
-FLUSH(8) FLUSH(8)
-
-
Delete empty per-destination logfiles that were not
updated in <b>fast</b><i>_</i><b>flush</b><i>_</i><b>purge</b><i>_</i><b>time</b> days.
@@ -96,6 +82,11 @@ FLUSH(8) FLUSH(8)
<b>FLUSH</b><i>_</i><b>STAT</b><i>_</i><b>FAIL</b>
The request failed.
+ <b>FLUSH</b><i>_</i><b>STAT</b><i>_</i><b>DENY</b>
+ The request was denied because the destination
+ domain is not eligible for fast flush service, or
+ because the fast flush service is disabled.
+
<b>SECURITY</b>
The fast flush server is not security-sensitive. It does
not talk to the network, and it does not talk to local
@@ -125,18 +116,6 @@ FLUSH(8) FLUSH(8)
<b>FILES</b>
/var/spool/postfix/flush, location of "fast flush" logfiles.
-
-
-
- 2
-
-
-
-
-
-FLUSH(8) FLUSH(8)
-
-
<b>CONFIGURATION</b> <b>PARAMETERS</b>
See the Postfix <b>main.cf</b> file for syntax details and for
default values. Use the <b>postfix</b> <b>reload</b> command after a
@@ -157,6 +136,11 @@ FLUSH(8) FLUSH(8)
updated in this amount of time (default time unit:
days).
+ <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdomains</b>
+ List of Postfix features that use <i>domain.name</i> pat-
+ terns to match <i>sub.domain.name</i> (as opposed to
+ requiring <i>.domain.name</i> patterns).
+
<b>SEE</b> <b>ALSO</b>
<a href="smtpd.8.html">smtpd(8)</a> Postfix SMTP server
<a href="qmgr.8.html">qmgr(8)</a> Postfix queue manager
@@ -172,29 +156,6 @@ FLUSH(8) FLUSH(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/lmtp.8.html b/gnu/dist/postfix/html/lmtp.8.html
index 653d5d8e40c..a4428fa0be6 100644
--- a/gnu/dist/postfix/html/lmtp.8.html
+++ b/gnu/dist/postfix/html/lmtp.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
LMTP(8) LMTP(8)
-
<b>NAME</b>
lmtp - Postfix local delivery via LMTP
@@ -59,22 +56,11 @@ LMTP(8) LMTP(8)
<b>STANDARDS</b>
<a href="http://www.faqs.org/rfcs/rfc821.html">RFC 821</a> (SMTP protocol)
<a href="http://www.faqs.org/rfcs/rfc1651.html">RFC 1651</a> (SMTP service extensions)
-
-
-
- 1
-
-
-
-
-
-LMTP(8) LMTP(8)
-
-
<a href="http://www.faqs.org/rfcs/rfc1870.html">RFC 1870</a> (Message Size Declaration)
<a href="http://www.faqs.org/rfcs/rfc2033.html">RFC 2033</a> (LMTP protocol)
<a href="http://www.faqs.org/rfcs/rfc2197.html">RFC 2197</a> (Pipelining)
<a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a> (AUTH command)
+ <a href="http://www.faqs.org/rfcs/rfc2821.html">RFC 2821</a> (SMTP protocol)
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8). Cor-
@@ -122,21 +108,9 @@ LMTP(8) LMTP(8)
found in <b>services</b>(4).
<b>Authentication</b> <b>controls</b>
- <b>lmtp</b><i>_</i><b>enable</b><i>_</i><b>sasl</b><i>_</i><b>auth</b>
+ <b>lmtp</b><i>_</i><b>sasl</b><i>_</i><b>auth</b><i>_</i><b>enable</b>
Enable per-session authentication as per <a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a>
(SASL). By default, Postfix is built without SASL
-
-
-
- 2
-
-
-
-
-
-LMTP(8) LMTP(8)
-
-
support.
<b>lmtp</b><i>_</i><b>sasl</b><i>_</i><b>password</b><i>_</i><b>maps</b>
@@ -191,18 +165,6 @@ LMTP(8) LMTP(8)
<i>transport_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
Limit the number of parallel deliveries to the same
destination via this mail delivery transport.
-
-
-
- 3
-
-
-
-
-
-LMTP(8) LMTP(8)
-
-
<i>transport</i> is the name of the service as specified
in the <b>master.cf</b> file. The default limit is taken
from the <b>default</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
@@ -256,19 +218,6 @@ LMTP(8) LMTP(8)
Timeout for sending the <b>DATA</b> command, and for
receiving the server response.
-
-
-
-
- 4
-
-
-
-
-
-LMTP(8) LMTP(8)
-
-
<b>lmtp</b><i>_</i><b>data</b><i>_</i><b>xfer</b><i>_</i><b>timeout</b>
Timeout for sending the message content.
@@ -316,17 +265,6 @@ LMTP(8) LMTP(8)
P.O. Box 830688, MC34
Richardson, TX 75083, USA
-
-
-
-
-
-
-
-
-
-
- 5
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/local.8.html b/gnu/dist/postfix/html/local.8.html
index e909eaa2848..d08a2ffa530 100644
--- a/gnu/dist/postfix/html/local.8.html
+++ b/gnu/dist/postfix/html/local.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
LOCAL(8) LOCAL(8)
-
<b>NAME</b>
local - Postfix local mail delivery
@@ -59,18 +56,6 @@ LOCAL(8) LOCAL(8)
When an address is found in its own alias expansion,
delivery is made to the user instead. When a user is
listed in the user's own ~/.<b>forward</b> file, delivery is made
-
-
-
- 1
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
to the user's mailbox instead. An empty ~/.<b>forward</b> file
means do not forward mail.
@@ -99,78 +84,67 @@ LOCAL(8) LOCAL(8)
The default per-user mailbox is a file in the UNIX mail
spool directory (<b>/var/mail/</b><i>user</i> or <b>/var/spool/mail/</b><i>user</i>);
the location can be specified with the <b>mail</b><i>_</i><b>spool</b><i>_</i><b>direc-</b>
- <b>tory</b> configuration parameter.
+ <b>tory</b> configuration parameter. Specify a name ending in <b>/</b>
+ for <b>qmail</b>-compatible <b>maildir</b> delivery.
- Alternatively, the per-user mailbox can be a file in the
- user's home directory with a name specified via the
- <b>home</b><i>_</i><b>mailbox</b> configuration parameter. Specify a relative
+ Alternatively, the per-user mailbox can be a file in the
+ user's home directory with a name specified via the
+ <b>home</b><i>_</i><b>mailbox</b> configuration parameter. Specify a relative
path name. Specify a name ending in <b>/</b> for <b>qmail</b>-compatible
<b>maildir</b> delivery.
- Mailbox delivery can be delegated to an external command
- specified with the <b>mailbox</b><i>_</i><b>command</b> configuration parame-
- ter. The command executes with the privileges of the
- recipient user (exception: in case of delivery as root,
- the command executes with the privileges of
+ Mailbox delivery can be delegated to an external command
+ specified with the <b>mailbox</b><i>_</i><b>command</b> configuration parame-
+ ter. The command executes with the privileges of the
+ recipient user (exception: in case of delivery as root,
+ the command executes with the privileges of
<b>default</b><i>_</i><b>privs</b>).
- Mailbox delivery can be delegated to alternative message
- transports specified in the <b>master.cf</b> file. The <b>mail-</b>
- <b>box</b><i>_</i><b>transport</b> configuration parameter specifies a message
- transport that is to be used for all local recipients,
- regardless of whether they are found in the UNIX passwd
- database. The <b>fallback</b><i>_</i><b>transport</b> parameter specifies a
+ Mailbox delivery can be delegated to alternative message
+ transports specified in the <b>master.cf</b> file. The <b>mail-</b>
+ <b>box</b><i>_</i><b>transport</b> configuration parameter specifies a message
+ transport that is to be used for all local recipients,
+ regardless of whether they are found in the UNIX passwd
+ database. The <b>fallback</b><i>_</i><b>transport</b> parameter specifies a
message transport for recipients that are not found in the
UNIX passwd database.
In the case of UNIX-style mailbox delivery, the <b>local</b> dae-
mon prepends a "<b>From</b> <i>sender</i> <i>time_stamp</i>" envelope header to
-
-
-
- 2
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
- each message, prepends an optional <b>Delivered-To:</b> header
- with the envelope recipient address, prepends a <b>Return-</b>
- <b>Path:</b> header with the envelope sender address, prepends a
- &gt; character to lines beginning with "<b>From</b> ", and appends
+ each message, prepends an optional <b>Delivered-To:</b> header
+ with the envelope recipient address, prepends a <b>Return-</b>
+ <b>Path:</b> header with the envelope sender address, prepends a
+ &gt; character to lines beginning with "<b>From</b> ", and appends
an empty line. The mailbox is locked for exclusive access
- while delivery is in progress. In case of problems, an
- attempt is made to truncate the mailbox to its original
+ while delivery is in progress. In case of problems, an
+ attempt is made to truncate the mailbox to its original
length.
In the case of <b>maildir</b> delivery, the local daemon prepends
an optional <b>Delivered-To:</b> header with the envelope recipi-
- ent address and prepends a <b>Return-Path:</b> header with the
+ ent address and prepends a <b>Return-Path:</b> header with the
envelope sender address.
<b>EXTERNAL</b> <b>COMMAND</b> <b>DELIVERY</b>
- The <b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>commands</b> configuration parameter
- restricts delivery to external commands. The default set-
- ting (<b>alias,</b> <b>forward</b>) forbids command destinations in
+ The <b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>commands</b> configuration parameter
+ restricts delivery to external commands. The default set-
+ ting (<b>alias,</b> <b>forward</b>) forbids command destinations in
<b>:include:</b> files.
- The command is executed directly where possible. Assis-
- tance by the shell (<b>/bin/sh</b> on UNIX systems) is used only
- when the command contains shell magic characters, or when
+ The command is executed directly where possible. Assis-
+ tance by the shell (<b>/bin/sh</b> on UNIX systems) is used only
+ when the command contains shell magic characters, or when
the command invokes a shell built-in command.
- A limited amount of command output (standard output and
- standard error) is captured for inclusion with non-deliv-
- ery status reports. A command is forcibly terminated if
- it does not complete within <b>command</b><i>_</i><b>time</b><i>_</i><b>limit</b> seconds.
- Command exit status codes are expected to follow the con-
+ A limited amount of command output (standard output and
+ standard error) is captured for inclusion with non-deliv-
+ ery status reports. A command is forcibly terminated if
+ it does not complete within <b>command</b><i>_</i><b>time</b><i>_</i><b>limit</b> seconds.
+ Command exit status codes are expected to follow the con-
ventions defined in &lt;<b>sysexits.h</b>&gt;.
- A limited amount of message context is exported via envi-
- ronment variables. Characters that may have special mean-
+ A limited amount of message context is exported via envi-
+ ronment variables. Characters that may have special mean-
ing to the shell are replaced by underscores. The list of
acceptable characters is specified with the <b>command</b><i>_</i><b>expan-</b>
<b>sion</b><i>_</i><b>filter</b> configuration parameter.
@@ -192,17 +166,6 @@ LOCAL(8) LOCAL(8)
<b>LOCAL</b> The entire recipient address localpart (text to the
left of the rightmost @ character).
-
-
- 3
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
<b>RECIPIENT</b>
The entire recipient address.
@@ -213,28 +176,31 @@ LOCAL(8) LOCAL(8)
The current working directory is the mail queue directory.
The <b>local</b> daemon prepends a "<b>From</b> <i>sender</i> <i>time_stamp</i>" enve-
- lope header to each message, prepends an optional <b>Deliv-</b>
+ lope header to each message, prepends an optional <b>Deliv-</b>
<b>ered-To:</b> header with the recipient envelope address,
- prepends a <b>Return-Path:</b> header with the sender envelope
+ prepends a <b>Return-Path:</b> header with the sender envelope
address, and appends no empty line.
<b>EXTERNAL</b> <b>FILE</b> <b>DELIVERY</b>
+ The delivery format depends on the destination filename
+ syntax. The default is to use UNIX-style mailbox format.
+ Specify a name ending in <b>/</b> for <b>qmail</b>-compatible <b>maildir</b>
+ delivery.
+
The <b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>files</b> configuration parameter restricts
delivery to external files. The default setting (<b>alias,</b>
- <b>forward</b>) forbids file destinations in <b>:include:</b> files.
- Specify a pathname ending in <b>/</b> for <b>qmail</b>-compatible
- <b>maildir</b> delivery.
+ <b>forward</b>) forbids file destinations in <b>:include:</b> files.
- The <b>local</b> daemon prepends a "<b>From</b> <i>sender</i> <i>time_stamp</i>" enve-
- lope header to each message, prepends an optional <b>Deliv-</b>
- <b>ered-To:</b> header with the recipient envelope address,
- prepends a &gt; character to lines beginning with "<b>From</b> ",
- and appends an empty line. The envelope sender address is
- available in the <b>Return-Path:</b> header. When the destina-
- tion is a regular file, it is locked for exclusive access
- while delivery is in progress. In case of problems, an
- attempt is made to truncate a regular file to its original
- length.
+ In the case of UNIX-style mailbox delivery, the <b>local</b> dae-
+ mon prepends a "<b>From</b> <i>sender</i> <i>time_stamp</i>" envelope header to
+ each message, prepends an optional <b>Delivered-To:</b> header
+ with the recipient envelope address, prepends a &gt; charac-
+ ter to lines beginning with "<b>From</b> ", and appends an empty
+ line. The envelope sender address is available in the
+ <b>Return-Path:</b> header. When the destination is a regular
+ file, it is locked for exclusive access while delivery is
+ in progress. In case of problems, an attempt is made to
+ truncate a regular file to its original length.
In the case of <b>maildir</b> delivery, the local daemon prepends
an optional <b>Delivered-To:</b> header with the envelope recipi-
@@ -257,18 +223,6 @@ LOCAL(8) LOCAL(8)
<b>DELIVERY</b> <b>RIGHTS</b>
Deliveries to external files and external commands are
-
-
-
- 4
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
made with the rights of the receiving user on whose behalf
the delivery is made. In the absence of a user context,
the <b>local</b> daemon uses the owner rights of the <b>:include:</b>
@@ -322,19 +276,6 @@ LOCAL(8) LOCAL(8)
List of names of environment parameters that can be
exported to non-Postfix processes.
-
-
-
-
- 5
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
<b>forward</b><i>_</i><b>path</b>
Search list for .forward files. The names are sub-
ject to <i>$name</i> expansion.
@@ -383,120 +324,103 @@ LOCAL(8) LOCAL(8)
<b>mail</b><i>_</i><b>spool</b><i>_</i><b>directory</b>
Directory with UNIX-style mailboxes. The default
- pathname is system dependent.
+ pathname is system dependent. Specify a path end-
+ ing in <b>/</b> for maildir-style delivery.
<b>mailbox</b><i>_</i><b>command</b>
- External command to use for mailbox delivery. The
+ External command to use for mailbox delivery. The
command executes with the recipient privileges
- (exception: root). The string is subject to $name
-
-
-
- 6
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
+ (exception: root). The string is subject to $name
expansions.
+ <b>mailbox</b><i>_</i><b>command</b><i>_</i><b>maps</b>
+ Lookup tables with per-recipient external commands
+ to use for mailbox delivery. Behavior is as with
+ <b>mailbox</b><i>_</i><b>command</b>.
+
<b>mailbox</b><i>_</i><b>transport</b>
- Message transport to use for mailbox delivery to
+ Message transport to use for mailbox delivery to
all local recipients, whether or not they are found
- in the UNIX passwd database. This parameter over-
- rides all other configuration parameters that con-
+ in the UNIX passwd database. This parameter over-
+ rides all other configuration parameters that con-
trol mailbox delivery, including <b>luser</b><i>_</i><b>relay</b>.
<b>Locking</b> <b>controls</b>
<b>deliver</b><i>_</i><b>lock</b><i>_</i><b>attempts</b>
- Limit the number of attempts to acquire an exclu-
+ Limit the number of attempts to acquire an exclu-
sive lock on a mailbox or external file.
<b>deliver</b><i>_</i><b>lock</b><i>_</i><b>delay</b>
- Time in seconds between successive attempts to
+ Time in seconds between successive attempts to
acquire an exclusive lock.
<b>stale</b><i>_</i><b>lock</b><i>_</i><b>time</b>
Limit the time after which a stale lock is removed.
<b>mailbox</b><i>_</i><b>delivery</b><i>_</i><b>lock</b>
- What file locking method(s) to use when delivering
- to a UNIX-style mailbox. The default setting is
- system dependent. For a list of available file
+ What file locking method(s) to use when delivering
+ to a UNIX-style mailbox. The default setting is
+ system dependent. For a list of available file
locking methods, use the <b>postconf</b> <b>-l</b> command.
<b>Resource</b> <b>controls</b>
<b>command</b><i>_</i><b>time</b><i>_</i><b>limit</b>
- Limit the amount of time for delivery to external
+ Limit the amount of time for delivery to external
command.
<b>duplicate</b><i>_</i><b>filter</b><i>_</i><b>limit</b>
- Limit the size of the duplicate filter for results
+ Limit the size of the duplicate filter for results
from alias etc. expansion.
<b>line</b><i>_</i><b>length</b><i>_</i><b>limit</b>
- Limit the amount of memory used for processing a
+ Limit the amount of memory used for processing a
partial input line.
<b>local</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
Limit the number of parallel deliveries to the same
- user. The default limit is taken from the
+ user. The default limit is taken from the
<b>default</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b> parameter.
<b>local</b><i>_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
- Limit the number of recipients per message deliv-
- ery. The default limit is taken from the
+ Limit the number of recipients per message deliv-
+ ery. The default limit is taken from the
<b>default</b><i>_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b> parameter.
<b>mailbox</b><i>_</i><b>size</b><i>_</i><b>limit</b>
- Limit the size of a mailbox etc. file (any file
- that is written to upon delivery). Set to zero to
+ Limit the size of a mailbox etc. file (any file
+ that is written to upon delivery). Set to zero to
disable the limit.
-
-
- 7
-
-
-
-
-
-LOCAL(8) LOCAL(8)
-
-
<b>Security</b> <b>controls</b>
<b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>commands</b>
- Restrict the usage of mail delivery to external
- command. Specify zero or more of: <b>alias</b>, <b>forward</b>,
+ Restrict the usage of mail delivery to external
+ command. Specify zero or more of: <b>alias</b>, <b>forward</b>,
<b>include</b>.
<b>allow</b><i>_</i><b>mail</b><i>_</i><b>to</b><i>_</i><b>files</b>
- Restrict the usage of mail delivery to external
- file. Specify zero or more of: <b>alias</b>, <b>forward</b>,
+ Restrict the usage of mail delivery to external
+ file. Specify zero or more of: <b>alias</b>, <b>forward</b>,
<b>include</b>.
<b>command</b><i>_</i><b>expansion</b><i>_</i><b>filter</b>
- What characters are allowed to appear in $name
- expansions of mailbox_command. Illegal characters
+ What characters are allowed to appear in $name
+ expansions of mailbox_command. Illegal characters
are replaced by underscores.
<b>default</b><i>_</i><b>privs</b>
- Default rights for delivery to external file or
+ Default rights for delivery to external file or
command.
<b>forward</b><i>_</i><b>expansion</b><i>_</i><b>filter</b>
- What characters are allowed to appear in $name
- expansions of forward_path. Illegal characters are
+ What characters are allowed to appear in $name
+ expansions of forward_path. Illegal characters are
replaced by underscores.
<b>HISTORY</b>
- The <b>Delivered-To:</b> header appears in the <b>qmail</b> system by
+ The <b>Delivered-To:</b> header appears in the <b>qmail</b> system by
Daniel Bernstein.
- The <i>maildir</i> structure appears in the <b>qmail</b> system by
+ The <i>maildir</i> structure appears in the <b>qmail</b> system by
Daniel Bernstein.
<b>SEE</b> <b>ALSO</b>
@@ -507,7 +431,7 @@ LOCAL(8) LOCAL(8)
<a href="qmgr.8.html">qmgr(8)</a> queue manager
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -516,15 +440,6 @@ LOCAL(8) LOCAL(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
- 8
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/master.8.html b/gnu/dist/postfix/html/master.8.html
index c767d6dc307..82c09b5545c 100644
--- a/gnu/dist/postfix/html/master.8.html
+++ b/gnu/dist/postfix/html/master.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
MASTER(8) MASTER(8)
-
<b>NAME</b>
master - Postfix master process
@@ -59,18 +56,6 @@ MASTER(8) MASTER(8)
Signals:
<b>SIGHUP</b> Upon receipt of a <b>HUP</b> signal (e.g., after <b>postfix</b>
-
-
-
- 1
-
-
-
-
-
-MASTER(8) MASTER(8)
-
-
<b>reload</b>), the master process re-reads its configura-
tion files. If a service has been removed from the
<b>master.cf</b> file, its running processes are termi-
@@ -124,19 +109,6 @@ MASTER(8) MASTER(8)
<b>daemon</b><i>_</i><b>directory</b>
Directory with Postfix daemon programs.
-
-
-
-
- 2
-
-
-
-
-
-MASTER(8) MASTER(8)
-
-
<b>queue</b><i>_</i><b>directory</b>
Top-level directory of the Postfix queue. This is
also the root directory of Postfix daemons that run
@@ -179,22 +151,6 @@ MASTER(8) MASTER(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/nqmgr.8.html b/gnu/dist/postfix/html/nqmgr.8.html
new file mode 100644
index 00000000000..405e14d2ff9
--- /dev/null
+++ b/gnu/dist/postfix/html/nqmgr.8.html
@@ -0,0 +1,343 @@
+<html> <head> </head> <body> <pre>
+
+NQMGR(8) NQMGR(8)
+
+<b>NAME</b>
+ nqmgr - Postfix queue manager
+
+<b>SYNOPSIS</b>
+ <b>nqmgr</b> [generic Postfix daemon options]
+
+<b>DESCRIPTION</b>
+ The <b>nqmgr</b> daemon awaits the arrival of incoming mail and
+ arranges for its delivery via Postfix delivery processes.
+ The actual mail routing strategy is delegated to the <a href="trivial-rewrite.8.html"><b>triv-</b></a>
+ <a href="trivial-rewrite.8.html"><b>ial-rewrite</b>(8)</a> daemon. This program expects to be run
+ from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
+
+ Mail addressed to the local <b>double-bounce</b> address is
+ silently discarded. This stops potential loops caused by
+ undeliverable bounce notifications.
+
+ Mail addressed to a user listed in the optional <b>relocated</b>
+ database is bounced with a "user has moved to <i>new_loca-</i>
+ <i>tion</i>" message. See <a href="relocated.5.html"><b>relocated</b>(5)</a> for a precise description.
+
+<b>MAIL</b> <b>QUEUES</b>
+ The <b>nqmgr</b> daemon maintains the following queues:
+
+ <b>incoming</b>
+ Inbound mail from the network, or mail picked up by
+ the local <b>pickup</b> agent from the <b>maildrop</b> directory.
+
+ <b>active</b> Messages that the queue manager has opened for
+ delivery. Only a limited number of messages is
+ allowed to enter the <b>active</b> queue (leaky bucket
+ strategy, for a fixed delivery rate).
+
+ <b>deferred</b>
+ Mail that could not be delivered upon the first
+ attempt. The queue manager implements exponential
+ backoff by doubling the time between delivery
+ attempts.
+
+ <b>corrupt</b>
+ Unreadable or damaged queue files are moved here
+ for inspection.
+
+<b>DELIVERY</b> <b>STATUS</b> <b>REPORTS</b>
+ The <b>nqmgr</b> daemon keeps an eye on per-message delivery sta-
+ tus reports in the following directories. Each status
+ report file has the same name as the corresponding message
+ file:
+
+ <b>bounce</b> Per-recipient status information about why mail is
+ bounced. These files are maintained by the
+ <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon.
+
+ <b>defer</b> Per-recipient status information about why mail is
+ delayed. These files are maintained by the
+ <a href="defer.8.html"><b>defer</b>(8)</a> daemon.
+
+ The <b>nqmgr</b> daemon is responsible for asking the <a href="bounce.8.html"><b>bounce</b>(8)</a>
+ or <a href="defer.8.html"><b>defer</b>(8)</a> daemons to send non-delivery reports.
+
+<b>STRATEGIES</b>
+ The queue manager implements a variety of strategies for
+ either opening queue files (input) or for message delivery
+ (output).
+
+ <b>leaky</b> <b>bucket</b>
+ This strategy limits the number of messages in the
+ <b>active</b> queue and prevents the queue manager from
+ running out of memory under heavy load.
+
+ <b>fairness</b>
+ When the <b>active</b> queue has room, the queue manager
+ takes one message from the <b>incoming</b> queue and one
+ from the <b>deferred</b> queue. This prevents a large mail
+ backlog from blocking the delivery of new mail.
+
+ <b>slow</b> <b>start</b>
+ This strategy eliminates "thundering herd" problems
+ by slowly adjusting the number of parallel deliver-
+ ies to the same destination.
+
+ <b>round</b> <b>robin</b>
+ The queue manager sorts delivery requests by desti-
+ nation. Round-robin selection prevents one desti-
+ nation from dominating deliveries to other destina-
+ tions.
+
+ <b>exponential</b> <b>backoff</b>
+ Mail that cannot be delivered upon the first
+ attempt is deferred. The time interval between
+ delivery attempts is doubled after each attempt.
+
+ <b>destination</b> <b>status</b> <b>cache</b>
+ The queue manager avoids unnecessary delivery
+ attempts by maintaining a short-term, in-memory
+ list of unreachable destinations.
+
+ <b>preemptive</b> <b>message</b> <b>scheduling</b>
+ The queue manager attempts to minimize the average
+ per-recipient delay while still preserving the cor-
+ rect per-message delays, using a sophisticated pre-
+ emptive message scheduling.
+
+<b>TRIGGERS</b>
+ On an idle system, the queue manager waits for the arrival
+ of trigger events, or it waits for a timer to go off. A
+ trigger is a one-byte message. Depending on the message
+ received, the queue manager performs one of the following
+ actions (the message is followed by the symbolic constant
+ used internally by the software):
+
+ <b>D</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>SCAN</b><i>_</i><b>DEFERRED)</b>
+ Start a deferred queue scan. If a deferred queue
+ scan is already in progress, that scan will be
+ restarted as soon as it finishes.
+
+ <b>I</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>SCAN</b><i>_</i><b>INCOMING)</b>
+ Start an incoming queue scan. If an incoming queue
+ scan is already in progress, that scan will be
+ restarted as soon as it finishes.
+
+ <b>A</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>SCAN</b><i>_</i><b>ALL)</b>
+ Ignore deferred queue file time stamps. The request
+ affects the next deferred queue scan.
+
+ <b>F</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>FLUSH</b><i>_</i><b>DEAD)</b>
+ Purge all information about dead transports and
+ destinations.
+
+ <b>W</b> <b>(TRIGGER</b><i>_</i><b>REQ</b><i>_</i><b>WAKEUP)</b>
+ Wakeup call, This is used by the master server to
+ instantiate servers that should not go away for-
+ ever. The action is to start an incoming queue
+ scan.
+
+ The <b>nqmgr</b> daemon reads an entire buffer worth of triggers.
+ Multiple identical trigger requests are collapsed into
+ one, and trigger requests are sorted so that <b>A</b> and <b>F</b> pre-
+ cede <b>D</b> and <b>I</b>. Thus, in order to force a deferred queue
+ run, one would request <b>A</b> <b>F</b> <b>D</b>; in order to notify the queue
+ manager of the arrival of new mail one would request <b>I</b>.
+
+<b>STANDARDS</b>
+ None. The <b>nqmgr</b> daemon does not interact with the outside
+ world.
+
+<b>SECURITY</b>
+ The <b>nqmgr</b> daemon is not security sensitive. It reads sin-
+ gle-character messages from untrusted local users, and
+ thus may be susceptible to denial of service attacks. The
+ <b>nqmgr</b> daemon does not talk to the outside world, and it
+ can be run at fixed low privilege in a chrooted environ-
+ ment.
+
+<b>DIAGNOSTICS</b>
+ Problems and transactions are logged to the syslog daemon.
+ Corrupted message files are saved to the <b>corrupt</b> queue for
+ further inspection.
+
+ Depending on the setting of the <b>notify</b><i>_</i><b>classes</b> parameter,
+ the postmaster is notified of bounces and of other trou-
+ ble.
+
+<b>BUGS</b>
+ A single queue manager process has to compete for disk
+ access with multiple front-end processes such as <b>smtpd</b>. A
+ sudden burst of inbound mail can negatively impact out-
+ bound delivery rates.
+
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
+ command after a configuration change.
+
+<b>Miscellaneous</b>
+ <b>allow</b><i>_</i><b>min</b><i>_</i><b>user</b>
+ Do not bounce recipient addresses that begin with
+ '-'.
+
+ <b>relocated</b><i>_</i><b>maps</b>
+ Tables with contact information for users, hosts or
+ domains that no longer exist. See <a href="relocated.5.html"><b>relocated</b>(5)</a>.
+
+ <b>queue</b><i>_</i><b>directory</b>
+ Top-level directory of the Postfix queue.
+
+<b>Active</b> <b>queue</b> <b>controls</b>
+ In the text below, <i>transport</i> is the first field in a <b>mas-</b>
+ <b>ter.cf</b> entry.
+
+ <b>qmgr</b><i>_</i><b>message</b><i>_</i><b>active</b><i>_</i><b>limit</b>
+ Limit the number of messages in the active queue.
+
+ <b>qmgr</b><i>_</i><b>message</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Limit the number of in-memory recipients.
+
+ This parameter also limits the size of the short-
+ term, in-memory destination cache.
+
+ <b>qmgr</b><i>_</i><b>message</b><i>_</i><b>recipient</b><i>_</i><b>minimum</b>
+ Per message minimum of in-memory recipients.
+
+ <b>default</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Default limit on the number of in-memory recipients
+ per transport.
+
+ <i>transport_</i><b>recipient</b><i>_</i><b>limit</b>
+ Limit on the number of in-memory recipients, for
+ the named message <i>transport</i>.
+
+ <b>default</b><i>_</i><b>extra</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Default limit on the total number of per transport
+ in-memory recipients that the preempting messages
+ can have.
+
+ <i>transport_</i><b>extra</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Limit on the number of in-memory recipients which
+ all preempting messages delivered by the transport
+ <i>transport</i> can have.
+
+<b>Timing</b> <b>controls</b>
+ <b>min</b><i>_</i><b>backoff</b>
+ Minimal time in seconds between delivery attempts
+ of a deferred message.
+
+ This parameter also limits the time an unreachable
+ destination is kept in the short-term, in-memory
+ destination status cache.
+
+ <b>max</b><i>_</i><b>backoff</b>
+ Maximal time in seconds between delivery attempts
+ of a deferred message.
+
+ <b>maximal</b><i>_</i><b>queue</b><i>_</i><b>lifetime</b>
+ Maximal time in days a message is queued before it
+ is sent back as undeliverable.
+
+ <b>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b>
+ Time in seconds between deferred queue scans. Queue
+ scans do not overlap.
+
+ <b>transport</b><i>_</i><b>retry</b><i>_</i><b>time</b>
+ Time in seconds between attempts to contact a bro-
+ ken delivery transport.
+
+<b>Concurrency</b> <b>controls</b>
+ <b>initial</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b>
+ Initial per-destination concurrency level for par-
+ allel delivery to the same destination.
+
+ <b>default</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
+ Default limit on the number of parallel deliveries
+ to the same destination.
+
+ <i>transport_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
+ Limit on the number of parallel deliveries to the
+ same destination, for delivery via the named mes-
+ sage <i>transport</i>.
+
+<b>Recipient</b> <b>controls</b>
+ <b>default</b><i>_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Default limit on the number of recipients per mes-
+ sage transfer.
+
+ <i>transport_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Limit on the number of recipients per message
+ transfer, for the named message <i>transport</i>.
+
+<b>Message</b> <b>scheduling</b>
+ <i>transport_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>cost</b> (valid range: 0,2,3...)
+ This parameter basically controls how often a mes-
+ sage delivered by <i>transport</i> can be preempted by
+ another message. An internal per-message/transport
+ counter is incremented by one for each <i>trans-</i>
+ <i>port_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>cost</b> deliveries handled by
+ <i>transport</i>. This counter represents the number of
+ "available delivery slots" for use by other mes-
+ sages. Current message can be preempted by another
+ message when that other message can be delivered
+ using less <i>transport</i> agents than the value of the
+ "available delivery slots" counter.
+
+ Value equal to 0 disables the message preemption
+ for <i>transport</i>.
+
+ <i>transport_</i><b>minimum</b><i>_</i><b>delivery</b><i>_</i><b>slots</b>
+ Message preemption is not attempted at all whenever
+ a message that can't ever accumulate at least
+ <i>transport_</i><b>minimum</b><i>_</i><b>delivery</b><i>_</i><b>slots</b> available delivery
+ slots is being delivered by <i>transport</i>.
+
+ <i>transport_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>discount</b> (valid range: 0..100)
+
+ <i>transport_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>loan</b>
+ These parameters speed up the moment when a message
+ preemption can happen. Instead of waiting until
+ the full amount of delivery slots required is
+ available, the preemption can happen when <i>trans-</i>
+ <i>port_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>discount</b> percent of the required
+ amount plus <i>transport_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>loan</b> still
+ remains to be accumulated. Note that the full
+ amount will still have to be accumulated before
+ another preemption can take place later.
+
+ <b>default</b><i>_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>cost</b>
+
+ <b>default</b><i>_</i><b>minimum</b><i>_</i><b>delivery</b><i>_</i><b>slots</b>
+
+ <b>default</b><i>_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>discount</b>
+
+ <b>default</b><i>_</i><b>delivery</b><i>_</i><b>slot</b><i>_</i><b>loan</b>
+ Default values for the transport specific parame-
+ ters described above.
+
+<b>SEE</b> <b>ALSO</b>
+ <a href="master.8.html">master(8)</a>, process manager
+ <a href="relocated.5.html">relocated(5)</a>, format of the "user has moved" table
+ syslogd(8) system logging
+ <a href="trivial-rewrite.8.html">trivial-rewrite(8)</a>, address routing
+
+<b>LICENSE</b>
+ The Secure Mailer license must be distributed with this
+ software.
+
+<b>AUTHOR(S)</b>
+ Wietse Venema
+ IBM T.J. Watson Research
+ P.O. Box 704
+ Yorktown Heights, NY 10598, USA
+
+ Scheduler enhancements:
+ Patrik Rak
+ Modra 6
+ 155 00, Prague, Czech Republic
+
+ 1
+
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/pcre_table.5.html b/gnu/dist/postfix/html/pcre_table.5.html
index b04bc607b74..55d1e714830 100644
--- a/gnu/dist/postfix/html/pcre_table.5.html
+++ b/gnu/dist/postfix/html/pcre_table.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
PCRE_TABLE(5) PCRE_TABLE(5)
-
<b>NAME</b>
pcre_table - format of Postfix PCRE tables
@@ -22,75 +19,68 @@ PCRE_TABLE(5) PCRE_TABLE(5)
The general form of a PCRE table is:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the pre-
- vious line.
-
<i>pattern</i> <i>result</i>
When <i>pattern</i> matches a search string, use the cor-
- responding <i>result</i>. A line that starts with white
- space continues the preceding line.
+ responding <i>result</i>.
+
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
Each pattern is a perl-like regular expression. The
- expression delimiter can be any character, except whites-
- pace or characters that have special meaning (tradition-
- ally the forward slash is used). The regular expression
+ expression delimiter can be any character, except whites-
+ pace or characters that have special meaning (tradition-
+ ally the forward slash is used). The regular expression
can contain whitespace.
By default, matching is case-insensitive, although follow-
- ing the second slash with an `i' flag will reverse this.
- Other flags are supported, but the only other useful one
+ ing the second slash with an `i' flag will reverse this.
+ Other flags are supported, but the only other useful one
is `U', which makes matching ungreedy (see PCRE documenta-
tion and source for more info).
- Each pattern is applied to the entire lookup key string.
- Depending on the application, that string is an entire
+ Each pattern is applied to the entire lookup key string.
+ Depending on the application, that string is an entire
client hostname, an entire client IP address, or an entire
- mail address. Thus, no parent domain or parent network
- search is done, and <i>user@domain</i> mail addresses are not
- broken up into their <i>user</i> and <i>domain</i> constituent parts,
+ mail address. Thus, no parent domain or parent network
+ search is done, and <i>user@domain</i> mail addresses are not
+ broken up into their <i>user</i> and <i>domain</i> constituent parts,
nor is <i>user+foo</i> broken up into <i>user</i> and <i>foo</i>.
- Patterns are applied in the order as specified in the
- table, until a pattern is found that matches the search
+ Patterns are applied in the order as specified in the
+ table, until a pattern is found that matches the search
string.
-
-
-
- 1
-
-
-
-
-
-PCRE_TABLE(5) PCRE_TABLE(5)
-
-
- Substitution of substrings from the matched expression
- into the result string is possible using the conventional
- perl syntax ($1, $2, etc.). The macros in the result
- string may need to be written as ${n} or $(n) if they
+ Substitution of substrings from the matched expression
+ into the result string is possible using the conventional
+ perl syntax ($1, $2, etc.). The macros in the result
+ string may need to be written as ${n} or $(n) if they
aren't followed by whitespace.
-<b>EXAMPLES</b>
+<b>EXAMPLE</b> <b>SMTPD</b> <b>ACCESS</b> <b>MAP</b>
# Protect your outgoing majordomo exploders
- /^(?!owner-)(.*)-outgoing@(my.domain)$/ 550 Use ${1}@${2} instead
+ /^(?!owner-)(.*)-outgoing@/ 550 Use ${1}@${2} instead
# Bounce friend@whatever, except when whatever is our domain (you would
# be better just bouncing all friend@ mail - this is just an example).
- /^friend@(?!my.domain).*$/ 550 Stick this in your pipe $0
+ /^friend@(?!my\.domain)/ 550 Stick this in your pipe $0
# A multi-line entry. The text is sent as one line.
#
- /^noddy@connect.com.au$/
+ /^noddy@my\.domain$/
550 This user is a funny one. You really don't want to send mail to
them as it only makes their head spin.
+<b>EXAMPLE</b> <b>HEADER</b> <b>FILTER</b> <b>MAP</b>
+ /^Subject: make money fast/ REJECT
+ /^To: friend@public\.com/ REJECT
+
<b>SEE</b> <b>ALSO</b>
<a href="regexp_table.5.html">regexp_table(5)</a> format of POSIX regular expression tables
@@ -108,27 +98,6 @@ PCRE_TABLE(5) PCRE_TABLE(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/pickup.8.html b/gnu/dist/postfix/html/pickup.8.html
index b70e54e765a..428f0e187f1 100644
--- a/gnu/dist/postfix/html/pickup.8.html
+++ b/gnu/dist/postfix/html/pickup.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
PICKUP(8) PICKUP(8)
-
<b>NAME</b>
pickup - Postfix local mail pickup
@@ -13,66 +10,55 @@ PICKUP(8) PICKUP(8)
<b>DESCRIPTION</b>
The <b>pickup</b> daemon waits for hints that new mail has been
- dropped into the world-writable <b>maildrop</b> directory, and
- feeds it into the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon. Ill-formatted files
- are deleted without notifying the originator. This pro-
- gram expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
+ dropped into the <b>maildrop</b> directory, and feeds it into the
+ <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon. Ill-formatted files are deleted with-
+ out notifying the originator. This program expects to be
+ run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
<b>STANDARDS</b>
None. The <b>pickup</b> daemon does not interact with the outside
world.
<b>SECURITY</b>
- The <b>pickup</b> daemon runs with superuser privileges so that
+ The <b>pickup</b> daemon runs with superuser privileges so that
it 1) can open a queue file with the rights of the submit-
- ting user and 2) can access the Postfix private IPC chan-
+ ting user and 2) can access the Postfix private IPC chan-
nels. On the positive side, the program can run chrooted,
opens no files for writing, is careful about what files it
- opens for reading, and does not actually touch any data
+ opens for reading, and does not actually touch any data
that is sent to its public service endpoint.
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8).
<b>BUGS</b>
- The <b>pickup</b> daemon copies mail from file to the <a href="cleanup.8.html"><b>cleanup</b>(8)</a>
- daemon. It could avoid message copying overhead by send-
- ing a file descriptor instead of file data, but then the
- already complex <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon would have to deal with
+ The <b>pickup</b> daemon copies mail from file to the <a href="cleanup.8.html"><b>cleanup</b>(8)</a>
+ daemon. It could avoid message copying overhead by send-
+ ing a file descriptor instead of file data, but then the
+ already complex <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon would have to deal with
unfiltered user data.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this program. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>Content</b> <b>inspection</b> <b>controls</b>
<b>content</b><i>_</i><b>filter</b>
- The name of a mail delivery transport that filters
+ The name of a mail delivery transport that filters
mail and that either bounces mail or re-injects the
- result back into Postfix. This parameter uses the
- same syntax as the right-hand side of a Postfix
+ result back into Postfix. This parameter uses the
+ same syntax as the right-hand side of a Postfix
transport table.
<b>Miscellaneous</b>
<b>always</b><i>_</i><b>bcc</b>
- Address to send a copy of each message that enters
+ Address to send a copy of each message that enters
the system.
-
-
- 1
-
-
-
-
-
-PICKUP(8) PICKUP(8)
-
-
<b>mail</b><i>_</i><b>owner</b>
- The process privileges used while not opening a
+ The process privileges used while not opening a
<b>maildrop</b> file.
<b>queue</b><i>_</i><b>directory</b>
@@ -81,10 +67,11 @@ PICKUP(8) PICKUP(8)
<b>SEE</b> <b>ALSO</b>
<a href="cleanup.8.html">cleanup(8)</a> message canonicalization
<a href="master.8.html">master(8)</a> process manager
+ <a href="sendmail.1.html">sendmail(1)</a>, postdrop(8) mail posting agent
syslogd(8) system logging
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -93,42 +80,6 @@ PICKUP(8) PICKUP(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/pipe.8.html b/gnu/dist/postfix/html/pipe.8.html
index 4c79983a037..372fce1b6f2 100644
--- a/gnu/dist/postfix/html/pipe.8.html
+++ b/gnu/dist/postfix/html/pipe.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
PIPE(8) PIPE(8)
-
<b>NAME</b>
pipe - Postfix delivery to external command
@@ -17,23 +14,28 @@ PIPE(8) PIPE(8)
program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process man-
ager.
- The <b>pipe</b> daemon updates queue files and marks recipients
+ Message attributes such as sender address, recipient
+ address and next-hop host name can be specified as com-
+ mand-line macros that are expanded before the external
+ command is executed.
+
+ The <b>pipe</b> daemon updates queue files and marks recipients
as finished, or it informs the queue manager that delivery
- should be tried again at a later time. Delivery problem
- reports are sent to the <a href="bounce.8.html"><b>bounce</b>(8)</a> or <a href="defer.8.html"><b>defer</b>(8)</a> daemon as
+ should be tried again at a later time. Delivery problem
+ reports are sent to the <a href="bounce.8.html"><b>bounce</b>(8)</a> or <a href="defer.8.html"><b>defer</b>(8)</a> daemon as
appropriate.
<b>SINGLE-RECIPIENT</b> <b>DELIVERY</b>
Some external commands cannot handle more than one recipi-
- ent per delivery request. Examples of such transports are
+ ent per delivery request. Examples of such transports are
pagers, fax machines, and so on.
- To prevent Postfix from sending multiple recipients per
+ To prevent Postfix from sending multiple recipients per
delivery request, specify
<i>transport_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b> <b>=</b> <b>1</b>
- in the Postfix <b>main.cf</b> file, where <i>transport</i> is the name
+ in the Postfix <b>main.cf</b> file, where <i>transport</i> is the name
in the first column of the Postfix <b>master.cf</b> entry for the
pipe-based delivery transport.
@@ -42,38 +44,52 @@ PIPE(8) PIPE(8)
file at the end of a service definition. The syntax is as
follows:
- <b>flags=BFR.</b>&gt; (optional)
- Optional message processing flags. By default, a
+ <b>flags=BFRhqu.</b>&gt; (optional)
+ Optional message processing flags. By default, a
message is copied unchanged.
- <b>B</b> Append a blank line at the end of each mes-
- sage. This is required by some mail user
- agents that recognize "<b>From</b> " lines only
+ <b>B</b> Append a blank line at the end of each mes-
+ sage. This is required by some mail user
+ agents that recognize "<b>From</b> " lines only
when preceded by a blank line.
- <b>F</b> Prepend a "<b>From</b> <i>sender</i> <i>time_stamp</i>" envelope
- header to the message content. This is
+ <b>F</b> Prepend a "<b>From</b> <i>sender</i> <i>time_stamp</i>" envelope
+ header to the message content. This is
expected by, for example, <b>UUCP</b> software.
- <b>R</b> Prepend a <b>Return-Path:</b> message header with
+ <b>R</b> Prepend a <b>Return-Path:</b> message header with
the envelope sender address.
- <b>.</b> Prepend <b>.</b> to lines starting with "<b>.</b>". This
-
-
-
- 1
-
-
-
-
-
-PIPE(8) PIPE(8)
-
-
+ <b>h</b> Fold the command-line <b>$recipient</b> domain name
+ and <b>$nexthop</b> host name to lower case. This
+ is recommended for delivery via <b>UUCP</b>.
+
+ <b>q</b> Quote white space and other special charac-
+ ters in the command-line <b>$sender</b> and <b>$recip-</b>
+ <b>ient</b> address localparts (text to the left of
+ the right-most <b>@</b> character), according to an
+ 8-bit transparent version of <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a>. This
+ is recommended for delivery via <b>UUCP</b> or
+ <b>BSMTP</b>.
+
+ The result is compatible with the address
+ parsing of command-line recipients by the
+ Postfix <b>sendmail</b> mail submission command.
+
+ The <b>q</b> flag affects only entire addresses,
+ not the partial address information from the
+ <b>$user</b>, <b>$extension</b> or <b>$mailbox</b> command-line
+ macros.
+
+ <b>u</b> Fold the command-line <b>$recipient</b> address
+ localpart (text to the left of the right-
+ most <b>@</b> character) to lower case. This is
+ recommended for delivery via <b>UUCP</b>.
+
+ <b>.</b> Prepend <b>.</b> to lines starting with "<b>.</b>". This
is needed by, for example, <b>BSMTP</b> software.
- &gt; Prepend &gt; to lines starting with "<b>From</b> ".
+ &gt; Prepend &gt; to lines starting with "<b>From</b> ".
This is expected by, for example, <b>UUCP</b> soft-
ware.
@@ -81,16 +97,16 @@ PIPE(8) PIPE(8)
<b>user</b>=<i>username</i>:<i>groupname</i>
The external command is executed with the rights of
- the specified <i>username</i>. The software refuses to
- execute commands with root privileges, or with the
- privileges of the mail system owner. If <i>groupname</i>
- is specified, the corresponding group ID is used
+ the specified <i>username</i>. The software refuses to
+ execute commands with root privileges, or with the
+ privileges of the mail system owner. If <i>groupname</i>
+ is specified, the corresponding group ID is used
instead of the group ID of <i>username</i>.
<b>eol=string</b> (default: <b>\n</b>)
- The output record delimiter. Typically one would
- use either <b>\r\n</b> or <b>\n</b>. The usual C-style backslash
- escape sequences are recognized: <b>\a</b> <b>\b</b> <b>\f</b> <b>\n</b> <b>\r</b> <b>\t</b>
+ The output record delimiter. Typically one would
+ use either <b>\r\n</b> or <b>\n</b>. The usual C-style backslash
+ escape sequences are recognized: <b>\a</b> <b>\b</b> <b>\f</b> <b>\n</b> <b>\r</b> <b>\t</b>
<b>\v</b> <b>\</b><i>octal</i> and <b>\\</b>.
<b>size</b>=<i>size_limit</i> (optional)
@@ -98,52 +114,49 @@ PIPE(8) PIPE(8)
will be bounced back to the sender.
<b>argv</b>=<i>command</i>... (required)
- The command to be executed. This must be specified
+ The command to be executed. This must be specified
as the last command attribute. The command is exe-
cuted directly, i.e. without interpretation of
- shell meta characters by a shell command inter-
+ shell meta characters by a shell command inter-
preter.
In the command argument vector, the following
macros are recognized and replaced with correspond-
- ing information from the Postfix queue manager
+ ing information from the Postfix queue manager
delivery request:
<b>${extension</b>}
- This macro expands to the extension part of
- a recipient address. For example, with an
+ This macro expands to the extension part of
+ a recipient address. For example, with an
address <i>user+foo@domain</i> the extension is
<i>foo</i>.
- A command-line argument that contains
- <b>${extension</b>} expands into as many command-
+ A command-line argument that contains
+ <b>${extension</b>} expands into as many command-
line arguments as there are recipients.
+ This information is modified by the <b>u</b> flag
+ for case folding.
+
<b>${mailbox</b>}
This macro expands to the complete local
part of a recipient address. For example,
with an address <i>user+foo@domain</i> the mailbox
is <i>user+foo</i>.
-
-
-
- 2
-
-
-
-
-
-PIPE(8) PIPE(8)
-
-
A command-line argument that contains
<b>${mailbox</b>} expands into as many command-line
arguments as there are recipients.
+ This information is modified by the <b>u</b> flag
+ for case folding.
+
<b>${nexthop</b>}
This macro expands to the next-hop hostname.
+ This information is modified by the <b>h</b> flag
+ for case folding.
+
<b>${recipient</b>}
This macro expands to the complete recipient
address.
@@ -152,10 +165,16 @@ PIPE(8) PIPE(8)
<b>${recipient</b>} expands into as many command-
line arguments as there are recipients.
+ This information is modified by the <b>hqu</b>
+ flags for quoting and case folding.
+
<b>${sender</b>}
- This macro expands to the envelope sender
+ This macro expands to the envelope sender
address.
+ This information is modified by the <b>q</b> flag
+ for quoting.
+
<b>${size</b>}
This macro expands to Postfix's idea of the
message size, which is an approximation of
@@ -171,40 +190,31 @@ PIPE(8) PIPE(8)
<b>${user</b>} expands into as many command-line
arguments as there are recipients.
- In addition to the form ${<i>name</i>}, the forms $<i>name</i> and
- $(<i>name</i>) are also recognized. Specify <b>$$</b> where a single <b>$</b>
+ This information is modified by the <b>u</b> flag
+ for case folding.
+
+ In addition to the form ${<i>name</i>}, the forms $<i>name</i> and
+ $(<i>name</i>) are also recognized. Specify <b>$$</b> where a single <b>$</b>
is wanted.
<b>DIAGNOSTICS</b>
- Command exit status codes are expected to follow the con-
+ Command exit status codes are expected to follow the con-
ventions defined in &lt;<b>sysexits.h</b>&gt;.
- Problems and transactions are logged to <b>syslogd</b>(8). Cor-
- rupted message files are marked so that the queue manager
+ Problems and transactions are logged to <b>syslogd</b>(8). Cor-
+ rupted message files are marked so that the queue manager
can move them to the <b>corrupt</b> queue for further inspection.
<b>SECURITY</b>
- This program needs a dual personality 1) to access the
- private Postfix queue and IPC mechanisms, and 2) to exe-
+ This program needs a dual personality 1) to access the
+ private Postfix queue and IPC mechanisms, and 2) to exe-
cute external commands as the specified user. It is there-
fore security sensitive.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
-
-
-
- 3
-
-
-
-
-
-PIPE(8) PIPE(8)
-
-
- to this program. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>Miscellaneous</b>
@@ -213,32 +223,32 @@ PIPE(8) PIPE(8)
exported to non-Postfix processes.
<b>mail</b><i>_</i><b>owner</b>
- The process privileges used while not running an
+ The process privileges used while not running an
external command.
<b>Resource</b> <b>controls</b>
- In the text below, <i>transport</i> is the first field in a <b>mas-</b>
+ In the text below, <i>transport</i> is the first field in a <b>mas-</b>
<b>ter.cf</b> entry.
<i>transport_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
Limit the number of parallel deliveries to the same
- destination, for delivery via the named <i>transport</i>.
- The default limit is taken from the <b>default</b><i>_</i><b>desti-</b>
- <b>nation</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b> parameter. The limit is
+ destination, for delivery via the named <i>transport</i>.
+ The default limit is taken from the <b>default</b><i>_</i><b>desti-</b>
+ <b>nation</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b> parameter. The limit is
enforced by the Postfix queue manager.
<i>transport_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
- Limit the number of recipients per message deliv-
- ery, for delivery via the named <i>transport</i>. The
- default limit is taken from the <b>default</b><i>_</i><b>destina-</b>
- <b>tion</b><i>_</i><b>recipient</b><i>_</i><b>limit</b> parameter. The limit is
+ Limit the number of recipients per message deliv-
+ ery, for delivery via the named <i>transport</i>. The
+ default limit is taken from the <b>default</b><i>_</i><b>destina-</b>
+ <b>tion</b><i>_</i><b>recipient</b><i>_</i><b>limit</b> parameter. The limit is
enforced by the Postfix queue manager.
<i>transport_</i><b>time</b><i>_</i><b>limit</b>
- Limit the time for delivery to external command,
- for delivery via the named <b>transport</b>. The default
- limit is taken from the <b>command</b><i>_</i><b>time</b><i>_</i><b>limit</b> parame-
- ter. The limit is enforced by the Postfix queue
+ Limit the time for delivery to external command,
+ for delivery via the named <b>transport</b>. The default
+ limit is taken from the <b>command</b><i>_</i><b>time</b><i>_</i><b>limit</b> parame-
+ ter. The limit is enforced by the Postfix queue
manager.
<b>SEE</b> <b>ALSO</b>
@@ -248,7 +258,7 @@ PIPE(8) PIPE(8)
syslogd(8) system logging
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -257,10 +267,6 @@ PIPE(8) PIPE(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
- 4
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postalias.1.html b/gnu/dist/postfix/html/postalias.1.html
index 4d6e097bb92..75168f09ff9 100644
--- a/gnu/dist/postfix/html/postalias.1.html
+++ b/gnu/dist/postfix/html/postalias.1.html
@@ -1,15 +1,12 @@
<html> <head> </head> <body> <pre>
-
-
POSTALIAS(1) POSTALIAS(1)
-
<b>NAME</b>
postalias - Postfix alias database maintenance
<b>SYNOPSIS</b>
- <b>postalias</b> [<b>-Ninrvw</b>] [<b>-c</b> <i>config_dir</i>] [<b>-d</b> <i>key</i>] [<b>-q</b> <i>key</i>]
+ <b>postalias</b> [<b>-Nfinrvw</b>] [<b>-c</b> <i>config_dir</i>] [<b>-d</b> <i>key</i>] [<b>-q</b> <i>key</i>]
[<i>file_type</i>:]<i>file_name</i> ...
<b>DESCRIPTION</b>
@@ -37,8 +34,16 @@ POSTALIAS(1) POSTALIAS(1)
directory.
<b>-d</b> <i>key</i> Search the specified maps for <i>key</i> and remove one
- entry per map. The exit status is non-zero if the
- requested information was not found.
+ entry per map. The exit status is zero when the
+ requested information was found.
+
+ If a key value of <b>-</b> is specified, the program reads
+ key values from the standard input stream. The exit
+ status is zero when at least one of the requested
+ keys was found.
+
+ <b>-f</b> Do not fold the lookup key to lower case while cre-
+ ating or querying a map.
<b>-i</b> Incremental mode. Read entries from standard input
and do not truncate an existing database. By
@@ -52,26 +57,20 @@ POSTALIAS(1) POSTALIAS(1)
<b>-q</b> <i>key</i> Search the specified maps for <i>key</i> and print the
first value found on the standard output stream.
- The exit status is non-zero if the requested infor-
- mation was not found.
+ The exit status is zero when the requested informa-
+ tion was found.
+
+ If a key value of <b>-</b> is specified, the program reads
+ key values from the standard input stream and
+ prints one line of <i>key:</i> <i>value</i> output for each key
+ that was found. The exit status is zero when at
+ least one of the requested keys was found.
<b>-r</b> When updating a table, do not warn about duplicate
entries; silently replace them.
- <b>-v</b> Enable verbose logging for debugging purposes.
-
-
-
- 1
-
-
-
-
-
-POSTALIAS(1) POSTALIAS(1)
-
-
- Multiple <b>-v</b> options make the software increasingly
+ <b>-v</b> Enable verbose logging for debugging purposes. Mul-
+ tiple <b>-v</b> options make the software increasingly
verbose.
<b>-w</b> When updating a table, do not warn about duplicate
@@ -113,10 +112,6 @@ POSTALIAS(1) POSTALIAS(1)
cess (including successful <b>postmap</b> <b>-q</b> lookup) and termi-
nates with non-zero exit status in case of failure.
-<b>BUGS</b>
- The "delete key" support is limited to one delete opera-
- tion per command invocation.
-
<b>ENVIRONMENT</b>
<b>MAIL</b><i>_</i><b>CONFIG</b>
Directory with Postfix configuration files.
@@ -124,26 +119,13 @@ POSTALIAS(1) POSTALIAS(1)
<b>MAIL</b><i>_</i><b>VERBOSE</b>
Enable verbose logging for debugging purposes.
-
-
-
-
- 2
-
-
-
-
-
-POSTALIAS(1) POSTALIAS(1)
-
-
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this program. See the Postfix <b>main.cf</b> file for syntax
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
details and for default values.
<b>database</b><i>_</i><b>type</b>
- Default alias database type. On many UNIX systems,
+ Default alias database type. On many UNIX systems,
the default type is either <b>dbm</b> or <b>hash</b>.
<b>STANDARDS</b>
@@ -154,7 +136,7 @@ POSTALIAS(1) POSTALIAS(1)
<a href="sendmail.1.html">sendmail(1)</a> mail posting and compatibility interface.
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -163,38 +145,6 @@ POSTALIAS(1) POSTALIAS(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postcat.1.html b/gnu/dist/postfix/html/postcat.1.html
index 57d03a854cd..a2b89ddf466 100644
--- a/gnu/dist/postfix/html/postcat.1.html
+++ b/gnu/dist/postfix/html/postcat.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTCAT(1) POSTCAT(1)
-
<b>NAME</b>
postcat - show Postfix queue file contents
@@ -36,33 +33,6 @@ POSTCAT(1) POSTCAT(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
1
-
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postconf.1.html b/gnu/dist/postfix/html/postconf.1.html
index 1e8e55cb908..d43547e4527 100644
--- a/gnu/dist/postfix/html/postconf.1.html
+++ b/gnu/dist/postfix/html/postconf.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTCONF(1) POSTCONF(1)
-
<b>NAME</b>
postconf - Postfix configuration utility
@@ -59,76 +56,9 @@ POSTCONF(1) POSTCONF(1)
<b>AUTHOR(S)</b>
Wietse Venema
IBM T.J. Watson Research
-
-
-
- 1
-
-
-
-
-
-POSTCONF(1) POSTCONF(1)
-
-
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postdrop.1.html b/gnu/dist/postfix/html/postdrop.1.html
index 372b037a392..b1dd861d5da 100644
--- a/gnu/dist/postfix/html/postdrop.1.html
+++ b/gnu/dist/postfix/html/postdrop.1.html
@@ -1,37 +1,38 @@
<html> <head> </head> <body> <pre>
-
-
POSTDROP(1) POSTDROP(1)
-
<b>NAME</b>
- postdrop - Postfix mail posting agent
+ postdrop - Postfix mail posting utility
<b>SYNOPSIS</b>
- <b>postdrop</b> [<i>option</i> <i>...</i>]
+ <b>postdrop</b> [<b>-rv</b>] [<b>-c</b> <i>config_dir</i>]
<b>DESCRIPTION</b>
The <b>postdrop</b> command creates a file in the <b>maildrop</b> direc-
tory and copies its standard input to the file.
- The command is designed to run with set-gid privileges,
- and with group write permission to the <b>maildrop</b> queue
- directory.
+ Options:
- The <b>postdrop</b> command is automatically invoked by the <a href="sendmail.1.html"><b>send-</b></a>
- <a href="sendmail.1.html"><b>mail</b>(1)</a> mail posting agent when the <b>maildrop</b> queue direc-
- tory is not world-writable.
+ <b>-c</b> The <b>main.cf</b> configuration file is in the named
+ directory instead of the default configuration
+ directory. See also the MAIL_CONFIG environment
+ setting below.
- Options:
+ <b>-r</b> Use a Postfix-internal protocol for reading the
+ message from standard input, and for reporting sta-
+ tus information on standard output. This is cur-
+ rently the only supported method.
<b>-v</b> Enable verbose logging for debugging purposes. Mul-
tiple <b>-v</b> options make the software increasingly
verbose.
<b>SECURITY</b>
- This program is designed so that it can run with set-user
- (or group) id privileges.
+ The command is designed to run with set-group ID privi-
+ leges, so that it can write to the <b>maildrop</b> queue direc-
+ tory and so that it can connect to Postfix daemon pro-
+ cesses.
<b>DIAGNOSTICS</b>
Fatal errors: malformed input, I/O error, out of memory.
@@ -41,16 +42,26 @@ POSTDROP(1) POSTDROP(1)
queue file is deleted.
<b>ENVIRONMENT</b>
- The program deletes all environment information, because
- the C library can't be trusted.
+ MAIL_CONFIG
+ Directory with the <b>main.cf</b> file. In order to avoid
+ exploitation of set-group ID privileges, it is not
+ possible to specify arbitrary directory names.
+
+ A non-standard directory is allowed only if the
+ name is listed in the standard <b>main.cf</b> file, in the
+ <b>alternate</b><i>_</i><b>config</b><i>_</i><b>directories</b> configuration parame-
+ ter value.
+
+ Only the super-user is allowed to specify arbitrary
+ directory names.
<b>FILES</b>
/var/spool/postfix, mail queue
/etc/postfix, configuration files
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- See the Postfix <b>main.cf</b> file for syntax details and for
- default values. Use the <b>postfix</b> <b>reload</b> command after a
+ See the Postfix <b>main.cf</b> file for syntax details and for
+ default values. Use the <b>postfix</b> <b>reload</b> command after a
configuration change.
<b>import</b><i>_</i><b>environment</b>
@@ -58,19 +69,7 @@ POSTDROP(1) POSTDROP(1)
imported from non-Postfix processes.
<b>queue</b><i>_</i><b>directory</b>
- Top-level directory of the Postfix queue. This is
-
-
-
- 1
-
-
-
-
-
-POSTDROP(1) POSTDROP(1)
-
-
+ Top-level directory of the Postfix queue. This is
also the root directory of Postfix daemons that run
chrooted.
@@ -79,7 +78,7 @@ POSTDROP(1) POSTDROP(1)
syslogd(8) system logging
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -88,47 +87,6 @@ POSTDROP(1) POSTDROP(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postfix.1.html b/gnu/dist/postfix/html/postfix.1.html
index 8db5ad60250..39b37cbdec6 100644
--- a/gnu/dist/postfix/html/postfix.1.html
+++ b/gnu/dist/postfix/html/postfix.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTFIX(1) POSTFIX(1)
-
<b>NAME</b>
postfix - Postfix control program
@@ -12,36 +9,41 @@ POSTFIX(1) POSTFIX(1)
<b>postfix</b> [<b>-c</b> <i>config_dir</i>] [<b>-D</b>] [<b>-v</b>] <i>command</i>
<b>DESCRIPTION</b>
- The <b>postfix</b> command controls the operation of the Postfix
- mail system: start or stop the <b>master</b> daemon, do a health
- check, and other maintenance. The command sets up a stan-
- dardized environment and runs the <b>postfix-script</b> shell
- script to do the actual work.
+ This command is reserved for the super-user. To submit
+ mail, use the Postfix <b>sendmail</b> command.
+
+ The <b>postfix</b> command controls the operation of the Postfix
+ mail system: start or stop the <b>master</b> daemon, do a health
+ check, and other maintenance.
+
+ The <b>postfix</b> command sets up a standardized environment and
+ runs the <b>postfix-script</b> shell script to do the actual
+ work.
The following commands are implemented:
- <b>check</b> Validate the Postfix mail system configuration.
- Warn about bad directory/file ownership or permis-
+ <b>check</b> Validate the Postfix mail system configuration.
+ Warn about bad directory/file ownership or permis-
sions, and create missing directories.
- <b>start</b> Start the Postfix mail system. This also runs the
+ <b>start</b> Start the Postfix mail system. This also runs the
configuration check described above.
<b>stop</b> Stop the Postfix mail system in an orderly fashion.
Running processes are allowed to terminate at their
earliest convenience.
- Note: in order to refresh the Postfix mail system
- after a configuration change, do not use the <b>start</b>
- and <b>stop</b> commands in succession. Use the <b>reload</b>
+ Note: in order to refresh the Postfix mail system
+ after a configuration change, do not use the <b>start</b>
+ and <b>stop</b> commands in succession. Use the <b>reload</b>
command instead.
<b>abort</b> Stop the Postfix mail system abruptly. Running pro-
cesses are signaled to stop immediately.
<b>flush</b> Force delivery: attempt to deliver every message in
- the deferred mail queue. Normally, attempts to
- deliver delayed mail happen at regular intervals,
+ the deferred mail queue. Normally, attempts to
+ deliver delayed mail happen at regular intervals,
the interval doubling after each failed attempt.
<b>reload</b> Re-read configuration files. Running processes ter-
@@ -50,35 +52,23 @@ POSTFIX(1) POSTFIX(1)
The following options are implemented:
<b>-c</b> <i>config_dir</i>
- Read the <b>main.cf</b> and <b>master.cf</b> configuration files
- in the named directory instead of the default con-
+ Read the <b>main.cf</b> and <b>master.cf</b> configuration files
+ in the named directory instead of the default con-
figuration directory. Use this to distinguish
- between multiple Postfix instances on the same
+ between multiple Postfix instances on the same
host.
<b>-D</b> (with <b>postfix</b> <b>start</b> only)
Run each Postfix daemon under control of a debugger
as specified via the <b>debugger</b><i>_</i><b>command</b> configuration
-
-
-
- 1
-
-
-
-
-
-POSTFIX(1) POSTFIX(1)
-
-
parameter.
<b>-v</b> Enable verbose logging for debugging purposes. Mul-
- tiple <b>-v</b> options make the software increasingly
+ tiple <b>-v</b> options make the software increasingly
verbose.
<b>ENVIRONMENT</b>
- The <b>postfix</b> command sets the following environment vari-
+ The <b>postfix</b> command sets the following environment vari-
ables:
<b>MAIL</b><i>_</i><b>CONFIG</b>
@@ -92,50 +82,71 @@ POSTFIX(1) POSTFIX(1)
This is set when the -D command-line option is pre-
sent.
- The following configuration parameters are made available
- as process environment variables with the same names:
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ The following <b>main.cf</b> configuration parameters are made
+ available as process environment variables with the same
+ names:
<b>command</b><i>_</i><b>directory</b>
- Directory with Postfix support commands (default:
- <b>$program</b><i>_</i><b>directory</b>).
+ Directory with Postfix administrative commands.
<b>daemon</b><i>_</i><b>directory</b>
- Directory with Postfix daemon programs (default:
- <b>$program</b><i>_</i><b>directory</b>).
+ Directory with Postfix daemon programs.
<b>config</b><i>_</i><b>directory</b>
Directory with Postfix configuration files and with
administrative shell scripts.
<b>queue</b><i>_</i><b>directory</b>
- The directory with the Postfix queue directory (and
- with some files needed for programs running in a
- chrooted environment).
+ The directory with Postfix queue files, with local
+ inter-process communication endpoints, and with
+ files needed for daemon programs that run in the
+ optional chrooted environment.
<b>mail</b><i>_</i><b>owner</b>
- The owner of the Postfix queue and of most Postfix
- processes.
+ The owner of Postfix queue files and of most Post-
+ fix processes.
-<b>FILES</b>
- $<b>config</b><i>_</i><b>directory/postfix-script</b>, administrative commands
-
-<b>SEE</b> <b>ALSO</b>
- <a href="master.8.html">master(8)</a> Postfix master program
+ <b>setgid</b><i>_</i><b>group</b>
+ The group for mail submission and queue management
+ commands.
-<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
- software.
+ <b>sendmail</b><i>_</i><b>path</b>
+ The full pathname for the Postfix sendmail command.
+ <b>newaliases</b><i>_</i><b>path</b>
+ The full pathname for the Postfix newaliases com-
+ mand.
+ <b>mailq</b><i>_</i><b>path</b>
+ The full pathname for the Postfix mailq command.
- 2
+ <b>manpage</b><i>_</i><b>directory</b>
+ The directory for the Postfix on-line manual pages.
+ <b>sample</b><i>_</i><b>directory</b>
+ The directory for the Postfix sample configuration
+ files.
+ <b>readme</b><i>_</i><b>directory</b>
+ The directory for the Postfix README files.
+<b>Other</b> <b>configuration</b> <b>parameters</b>
+ <b>import</b><i>_</i><b>environment</b>
+ List of names of environment parameters that can be
+ imported from non-Postfix processes.
+<b>FILES</b>
+ $<b>config</b><i>_</i><b>directory/postfix-script</b>, administrative commands
+ $<b>config</b><i>_</i><b>directory/main.cf</b>, configuration parameters
+ $<b>config</b><i>_</i><b>directory/master.cf</b>, Postfix daemon processes
-POSTFIX(1) POSTFIX(1)
+<b>SEE</b> <b>ALSO</b>
+ <a href="master.8.html">master(8)</a> Postfix master program
+<b>LICENSE</b>
+ The Secure Mailer license must be distributed with this
+ software.
<b>AUTHOR(S)</b>
Wietse Venema
@@ -143,58 +154,6 @@ POSTFIX(1) POSTFIX(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postkick.1.html b/gnu/dist/postfix/html/postkick.1.html
index 0a5a5a3a9a8..e4890bd6fd0 100644
--- a/gnu/dist/postfix/html/postkick.1.html
+++ b/gnu/dist/postfix/html/postkick.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTKICK(1) POSTKICK(1)
-
<b>NAME</b>
postkick - kick a Postfix service
@@ -58,19 +55,6 @@ POSTKICK(1) POSTKICK(1)
to this program. See the Postfix <b>main.cf</b> file for syntax
details and for default values.
-
-
-
-
- 1
-
-
-
-
-
-POSTKICK(1) POSTKICK(1)
-
-
<b>queue</b><i>_</i><b>directory</b>
Location of the Postfix queue, and of the local IPC
communication endpoints.
@@ -89,46 +73,6 @@ POSTKICK(1) POSTKICK(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postlock.1.html b/gnu/dist/postfix/html/postlock.1.html
index 8cc19092f14..fe78acdf17c 100644
--- a/gnu/dist/postfix/html/postlock.1.html
+++ b/gnu/dist/postfix/html/postlock.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTLOCK(1) POSTLOCK(1)
-
<b>NAME</b>
postlock - lock mail folder and execute command
@@ -58,19 +55,6 @@ POSTLOCK(1) POSTLOCK(1)
<b>MAIL</b><i>_</i><b>CONFIG</b>
Directory with Postfix configuration files.
-
-
-
-
- 1
-
-
-
-
-
-POSTLOCK(1) POSTLOCK(1)
-
-
<b>MAIL</b><i>_</i><b>VERBOSE</b>
Enable verbose logging for debugging purposes.
@@ -116,19 +100,6 @@ POSTLOCK(1) POSTLOCK(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postlog.1.html b/gnu/dist/postfix/html/postlog.1.html
index c6d6247a839..a4fd0bcfe3f 100644
--- a/gnu/dist/postfix/html/postlog.1.html
+++ b/gnu/dist/postfix/html/postlog.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
POSTLOG(1) POSTLOG(1)
-
<b>NAME</b>
postlog - Postfix-compatible logging utility
@@ -59,10 +56,6 @@ POSTLOG(1) POSTLOG(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
1
-
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postmap.1.html b/gnu/dist/postfix/html/postmap.1.html
index 77833681c9d..92581834245 100644
--- a/gnu/dist/postfix/html/postmap.1.html
+++ b/gnu/dist/postfix/html/postmap.1.html
@@ -1,15 +1,12 @@
<html> <head> </head> <body> <pre>
-
-
POSTMAP(1) POSTMAP(1)
-
<b>NAME</b>
postmap - Postfix lookup table management
<b>SYNOPSIS</b>
- <b>postmap</b> [<b>-Ninrvw</b>] [<b>-c</b> <i>config_dir</i>] [<b>-d</b> <i>key</i>] [<b>-q</b> <i>key</i>]
+ <b>postmap</b> [<b>-Nfinrvw</b>] [<b>-c</b> <i>config_dir</i>] [<b>-d</b> <i>key</i>] [<b>-q</b> <i>key</i>]
[<i>file_type</i>:]<i>file_name</i> ...
<b>DESCRIPTION</b>
@@ -19,6 +16,10 @@ POSTMAP(1) POSTMAP(1)
<b>makemap</b> <i>file_type</i> <i>file_name</i> &lt; <i>file_name</i>
+ If the result files do not exist they will be created with
+ the same group and other read permissions as the source
+ file.
+
While the table update is in progress, signal delivery is
postponed, and an exclusive, advisory, lock is placed on
the entire table, in order to avoid surprises in spectator
@@ -26,15 +27,17 @@ POSTMAP(1) POSTMAP(1)
The format of a lookup table input file is as follows:
- <b>o</b> Blank lines are ignored. So are lines beginning
- with `#'.
-
<b>o</b> A table entry has the form
<i>key</i> whitespace <i>value</i>
- <b>o</b> A line that starts with whitespace continues the
- preceding line.
+ <b>o</b> Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ <b>o</b> A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
The <i>key</i> and <i>value</i> are processed as is, except that sur-
rounding white space is stripped off. Unlike with Postfix
@@ -56,20 +59,16 @@ POSTMAP(1) POSTMAP(1)
directory.
<b>-d</b> <i>key</i> Search the specified maps for <i>key</i> and remove one
- entry per map. The exit status is non-zero if the
- requested information was not found.
-
-
-
-
- 1
-
-
-
+ entry per map. The exit status is zero when the
+ requested information was found.
+ If a key value of <b>-</b> is specified, the program reads
+ key values from the standard input stream. The exit
+ status is zero when at least one of the requested
+ keys was found.
-POSTMAP(1) POSTMAP(1)
-
+ <b>-f</b> Do not fold the lookup key to lower case while cre-
+ ating or querying a map.
<b>-i</b> Incremental mode. Read entries from standard input
and do not truncate an existing database. By
@@ -83,8 +82,14 @@ POSTMAP(1) POSTMAP(1)
<b>-q</b> <i>key</i> Search the specified maps for <i>key</i> and print the
first value found on the standard output stream.
- The exit status is non-zero if the requested infor-
- mation was not found.
+ The exit status is zero when the requested informa-
+ tion was found.
+
+ If a key value of <b>-</b> is specified, the program reads
+ key values from the standard input stream and
+ prints one line of <i>key</i> <i>value</i> output for each key
+ that was found. The exit status is zero when at
+ least one of the requested keys was found.
<b>-r</b> When updating a table, do not warn about duplicate
entries; silently replace them.
@@ -125,28 +130,12 @@ POSTMAP(1) POSTMAP(1)
<b>DIAGNOSTICS</b>
Problems and transactions are logged to the standard error
stream. No output means no problems. Duplicate entries are
-
-
-
- 2
-
-
-
-
-
-POSTMAP(1) POSTMAP(1)
-
-
skipped and are flagged with a warning.
<b>postmap</b> terminates with zero exit status in case of suc-
cess (including successful <b>postmap</b> <b>-q</b> lookup) and termi-
nates with non-zero exit status in case of failure.
-<b>BUGS</b>
- The "delete key" support is limited to one delete opera-
- tion per command invocation.
-
<b>ENVIRONMENT</b>
<b>MAIL</b><i>_</i><b>CONFIG</b>
Directory with Postfix configuration files.
@@ -156,12 +145,12 @@ POSTMAP(1) POSTMAP(1)
<b>CONFIGURATION</b> <b>PARAMETERS</b>
<b>database</b><i>_</i><b>type</b>
- Default output database type. On many UNIX sys-
- tems, the default database type is either <b>hash</b> or
+ Default output database type. On many UNIX sys-
+ tems, the default database type is either <b>hash</b> or
<b>dbm</b>.
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -170,31 +159,6 @@ POSTMAP(1) POSTMAP(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postqueue.1.html b/gnu/dist/postfix/html/postqueue.1.html
new file mode 100644
index 00000000000..64b005a4567
--- /dev/null
+++ b/gnu/dist/postfix/html/postqueue.1.html
@@ -0,0 +1,115 @@
+<html> <head> </head> <body> <pre>
+
+POSTQUEUE(1) POSTQUEUE(1)
+
+<b>NAME</b>
+ postqueue - Postfix queue control
+
+<b>SYNOPSIS</b>
+ <b>postqueue</b> [<b>-c</b> <i>config_dir</i>] <b>-f</b>
+ <b>postqueue</b> [<b>-c</b> <i>config_dir</i>] <b>-p</b>
+ <b>postqueue</b> [<b>-c</b> <i>config_dir</i>] <b>-s</b> <i>site</i>
+
+<b>DESCRIPTION</b>
+ The <b>postqueue</b> program implements the Postfix user inter-
+ face for queue management. It implements all the opera-
+ tions that are traditionally available via the <a href="sendmail.1.html"><b>sendmail</b>(1)</a>
+ command.
+
+ The following options are recognized:
+
+ <b>-c</b> <i>config_dir</i>
+ The <b>main.cf</b> configuration file is in the named
+ directory instead of the default configuration
+ directory. See also the MAIL_CONFIG environment
+ setting below.
+
+ <b>-f</b> Flush the queue: attempt to deliver all queued
+ mail.
+
+ This option implements the traditional <b>sendmail</b> <b>-q</b>
+ command, by contacting the Postfix <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon.
+
+ <b>-p</b> Produce a traditional sendmail-style queue listing.
+
+ This option implements the traditional <b>mailq</b> com-
+ mand, by contacting the Postfix <a href="showq.8.html"><b>showq</b>(8)</a> daemon.
+
+ <b>-s</b> <i>site</i>
+ Schedule immediate delivery of all mail that is
+ queued for the named <i>site</i>. The site must be eligi-
+ ble for the "fast flush" service. See <a href="flushd.8.html"><b>flush</b>(8)</a> for
+ more information about the "fast flush" service.
+
+ This option implements the traditional <b>sendmail</b>
+ <b>-qR</b><i>site</i> command, by contacting the Postfix <a href="flushd.8.html"><b>flush</b>(8)</a>
+ daemon.
+
+ <b>-v</b> Enable verbose logging for debugging purposes. Mul-
+ tiple <b>-v</b> options make the software increasingly
+ verbose.
+
+<b>SECURITY</b>
+ This program is designed to run with set-group ID privi-
+ leges, so that it can connect to Postfix daemon processes.
+
+<b>DIAGNOSTICS</b>
+ Problems are logged to <b>syslogd</b>(8) and to the standard
+ error stream.
+
+<b>ENVIRONMENT</b>
+ MAIL_CONFIG
+ Directory with the <b>main.cf</b> file.
+
+ In order to avoid exploitation of set-group ID
+ privileges, it is not possible to specify arbitrary
+ directory names.
+
+ A non-standard directory is allowed only if the
+ name is listed in the standard <b>main.cf</b> file, in the
+ <b>alternate</b><i>_</i><b>config</b><i>_</i><b>directories</b> configuration parame-
+ ter value.
+
+ Only the super-user is allowed to specify arbitrary
+ directory names.
+
+<b>FILES</b>
+ /var/spool/postfix, mail queue
+ /etc/postfix, configuration files
+
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ <b>import</b><i>_</i><b>environment</b>
+ List of names of environment parameters that can be
+ imported from non-Postfix processes.
+
+ <b>queue</b><i>_</i><b>directory</b>
+ Top-level directory of the Postfix queue. This is
+ also the root directory of Postfix daemons that run
+ chrooted.
+
+ <b>fast</b><i>_</i><b>flush</b><i>_</i><b>domains</b>
+ List of domains that will receive "fast flush" ser-
+ vice (default: all domains that this system is
+ willing to relay mail to). This list specifies the
+ domains that Postfix accepts in the SMTP <b>ETRN</b>
+ request and in the <b>sendmail</b> <b>-qR</b> command.
+
+<b>SEE</b> <b>ALSO</b>
+ sendmail(8) sendmail-compatible user interface
+ <a href="qmgr.8.html">qmgr(8)</a> queue manager
+ <a href="showq.8.html">showq(8)</a> list mail queue
+ <a href="flushd.8.html">flush(8)</a> fast flush service
+
+<b>LICENSE</b>
+ The Secure Mailer license must be distributed with this
+ software.
+
+<b>AUTHOR(S)</b>
+ Wietse Venema
+ IBM T.J. Watson Research
+ P.O. Box 704
+ Yorktown Heights, NY 10598, USA
+
+ 1
+
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postsuper.1.html b/gnu/dist/postfix/html/postsuper.1.html
index 15aa92cc5de..d4dbb09a55d 100644
--- a/gnu/dist/postfix/html/postsuper.1.html
+++ b/gnu/dist/postfix/html/postsuper.1.html
@@ -1,134 +1,140 @@
<html> <head> </head> <body> <pre>
-
-
POSTSUPER(1) POSTSUPER(1)
-
<b>NAME</b>
- postsuper - Postfix super intendent
+ postsuper - Postfix superintendent
<b>SYNOPSIS</b>
- <b>postsuper</b> [<b>-p</b>] [<b>-s</b>] [<b>-v</b>] [<i>directory</i> <i>...</i>]
+ <b>postsuper</b> [<b>-psv</b>] [<b>-d</b> <i>queue_id</i>] [<b>-r</b> <i>queue_id</i>] [<i>directory</i>
+ <i>...</i>]
<b>DESCRIPTION</b>
- The <b>postsuper</b> command does small maintenance jobs on the
- named Postfix queue directories (default: all). Directory
- names are relative to the Postfix top-level queue direc-
- tory.
+ The <b>postsuper</b> command does maintenance jobs on the Postfix
+ queue. Use of the command is restricted to the super-user.
By default, <b>postsuper</b> performs the operations requested
- with the <b>-s</b> and <b>-p</b> command-line options. <b>postsuper</b> always
- tries to remove objects that are neither files nor direc-
- tories. Use of this command is restricted to the super-
- user.
+ with the <b>-s</b> and <b>-p</b> command-line options on all Postfix
+ queue directories - this includes the <b>incoming</b>, <b>active</b> and
+ <b>deferred</b> directories with mail files and the <b>bounce</b>, <b>defer</b>
+ and <b>flush</b> directories with log files.
Options:
- <b>-s</b> Structure check. Move queue files that are in the
- wrong place in the file system hierarchy and remove
- subdirectories that are no longer needed. File
- rearrangements are necessary after a change in the
- <b>hash</b><i>_</i><b>queue</b><i>_</i><b>names</b> and/or <b>hash</b><i>_</i><b>queue</b><i>_</i><b>depth</b> configura-
- tion parameters. It is highly recommended to run
- this check once before Postfix startup.
-
- <b>-p</b> Purge stale files (files that are left over after
- system or software crashes).
+ <b>-d</b> <i>queue_id</i>
+ Delete one message with the named queue ID from the
+ named mail queue(s) (default: <b>incoming</b>, <b>active</b> and
+ <b>deferred</b>). If a <i>queue_id</i> of <b>-</b> is specified, the
+ program reads queue IDs from standard input.
+
+ Specify <b>-d</b> <b>ALL</b> to remove all messages; for example,
+ specify <b>-d</b> <b>ALL</b> <b>deferred</b> to delete mail in the
+ <b>deferred</b> queue. As a safety measure, the word <b>ALL</b>
+ must be specified in upper case.
+
+ <b>Postfix</b> <b>queue</b> <b>IDs</b> <b>are</b> <b>reused.</b> <b>There</b> <b>is</b> <b>a</b> <b>very</b>
+ <b>small</b> <b>possibility</b> <b>that</b> <b>postsuper</b> <b>deletes</b> <b>the</b> <b>wrong</b>
+ <b>message</b> <b>file</b> <b>when</b> <b>it</b> <b>is</b> <b>executed</b> <b>while</b> <b>the</b> <b>Postfix</b>
+ <b>mail</b> <b>system</b> <b>is</b> <b>running.</b>
+
+ The scenario is as follows:
+
+ 1) The Postfix queue manager deletes the mes-
+ sage that <b>postsuper</b> is supposed to delete,
+ because Postfix is finished with the mes-
+ sage.
+
+ 2) New mail arrives, and the new message is
+ given the same queue ID as the message that
+ <b>postsuper</b> is supposed to delete. The proba-
+ bility for reusing a deleted queue ID is
+ about 1 in 2**15 (the number of different
+ microsecond values that the system clock can
+ distinguish within a second).
+
+ 3) <b>postsuper</b> deletes the new message, instead
+ of the old message that it should have
+ deleted.
+
+ <b>-p</b> Purge old temporary files that are left over after
+ system or software crashes.
+
+ <b>-r</b> <i>queue_id</i>
+ Requeue the message with the named queue ID from
+ the named mail queue(s) (default: <b>incoming</b>, <b>active</b>
+ and <b>deferred</b>). To requeue multiple messages, spec-
+ ify multiple <b>-r</b> command-line options. Alterna-
+ tively, if a <i>queue_id</i> of <b>-</b> is specified, the pro-
+ gram reads queue IDs from standard input.
+
+ Specify <b>-r</b> <b>ALL</b> to requeue all messages. As a safety
+ measure, the word <b>ALL</b> must be specified in upper
+ case.
+
+ A requeued message is moved to the <b>maildrop</b> queue,
+ from where it is copied by the pickup daemon to a
+ new file whose name is guaranteed to match the new
+ queue file inode number. The new queue file is sub-
+ jected again to mail address rewriting and substi-
+ tution. This is useful when rewriting rules or vir-
+ tual mappings have changed.
+
+ Postfix queue IDs are reused. There is a very
+ small possibility that <b>postsuper</b> requeues the wrong
+ message file when it is executed while the Postfix
+ mail system is running, but no harm should be done.
+
+ <b>-s</b> Structure check and structure repair. It is highly
+ recommended to perform this operation once before
+ Postfix startup.
+
+ <b>o</b> Rename files whose name does not match the
+ message file inode number. This operation is
+ necessary after restoring a mail queue from
+ a different machine, or from backup media.
+
+ <b>o</b> Move queue files that are in the wrong place
+ in the file system hierarchy and remove sub-
+ directories that are no longer needed. File
+ position rearrangements are necessary after
+ a change in the <b>hash</b><i>_</i><b>queue</b><i>_</i><b>names</b> and/or
+ <b>hash</b><i>_</i><b>queue</b><i>_</i><b>depth</b> configuration parameters.
<b>-v</b> Enable verbose logging for debugging purposes. Mul-
- tiple <b>-v</b> options make the software increasingly
+ tiple <b>-v</b> options make the software increasingly
verbose.
<b>DIAGNOSTICS</b>
- Problems are reported to the standard error stream and to
+ Problems are reported to the standard error stream and to
<b>syslogd</b>.
+ <b>postsuper</b> reports the number of messages deleted with <b>-d</b>,
+ the number of messages requeued with <b>-r</b>, and the number of
+ messages whose queue file name was fixed with <b>-s</b>. The
+ report is written to the standard error stream and to <b>sys-</b>
+ <b>logd</b>.
+
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- See the Postfix <b>main.cf</b> file for syntax details and for
+ See the Postfix <b>main.cf</b> file for syntax details and for
default values.
<b>hash</b><i>_</i><b>queue</b><i>_</i><b>depth</b>
Number of subdirectory levels for hashed queues.
<b>hash</b><i>_</i><b>queue</b><i>_</i><b>names</b>
- The names of queues that are organized into multi-
+ The names of queues that are organized into multi-
ple levels of subdirectories.
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
-
-
-
- 1
-
-
-
-
-
-POSTSUPER(1) POSTSUPER(1)
-
-
<b>AUTHOR(S)</b>
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/qmgr.8.html b/gnu/dist/postfix/html/qmgr.8.html
index 032e6dfdbc6..6cc03ee15ae 100644
--- a/gnu/dist/postfix/html/qmgr.8.html
+++ b/gnu/dist/postfix/html/qmgr.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
QMGR(8) QMGR(8)
-
<b>NAME</b>
qmgr - Postfix queue manager
@@ -59,18 +56,6 @@ QMGR(8) QMGR(8)
<a href="bounce.8.html"><b>bounce</b>(8)</a> daemon.
<b>defer</b> Per-recipient status information about why mail is
-
-
-
- 1
-
-
-
-
-
-QMGR(8) QMGR(8)
-
-
delayed. These files are maintained by the
<a href="defer.8.html"><b>defer</b>(8)</a> daemon.
@@ -125,18 +110,6 @@ QMGR(8) QMGR(8)
<b>D</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>SCAN</b><i>_</i><b>DEFERRED)</b>
Start a deferred queue scan. If a deferred queue
scan is already in progress, that scan will be
-
-
-
- 2
-
-
-
-
-
-QMGR(8) QMGR(8)
-
-
restarted as soon as it finishes.
<b>I</b> <b>(QMGR</b><i>_</i><b>REQ</b><i>_</i><b>SCAN</b><i>_</i><b>INCOMING)</b>
@@ -191,18 +164,6 @@ QMGR(8) QMGR(8)
sudden burst of inbound mail can negatively impact out-
bound delivery rates.
-
-
-
- 3
-
-
-
-
-
-QMGR(8) QMGR(8)
-
-
<b>CONFIGURATION</b> <b>PARAMETERS</b>
The following <b>main.cf</b> parameters are especially relevant
to this program. See the Postfix <b>main.cf</b> file for syntax
@@ -256,19 +217,6 @@ QMGR(8) QMGR(8)
Time in seconds between attempts to contact a bro-
ken delivery transport.
-
-
-
-
- 4
-
-
-
-
-
-QMGR(8) QMGR(8)
-
-
<b>Concurrency</b> <b>controls</b>
In the text below, <i>transport</i> is the first field in a <b>mas-</b>
<b>ter.cf</b> entry.
@@ -323,18 +271,6 @@ QMGR(8) QMGR(8)
Limit on the number of recipients per message
transfer, for the named message <i>transport</i>.
-
-
-
- 5
-
-
-
-
-
-QMGR(8) QMGR(8)
-
-
<b>SEE</b> <b>ALSO</b>
<a href="master.8.html">master(8)</a>, process manager
<a href="relocated.5.html">relocated(5)</a>, format of the "user has moved" table
@@ -351,48 +287,6 @@ QMGR(8) QMGR(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 6
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/qmqpd.8.html b/gnu/dist/postfix/html/qmqpd.8.html
new file mode 100644
index 00000000000..5d5792ef300
--- /dev/null
+++ b/gnu/dist/postfix/html/qmqpd.8.html
@@ -0,0 +1,122 @@
+<html> <head> </head> <body> <pre>
+
+QMQPD(8) QMQPD(8)
+
+<b>NAME</b>
+ qmqpd - Postfix QMQP server
+
+<b>SYNOPSIS</b>
+ <b>qmqpd</b> [generic Postfix daemon options]
+
+<b>DESCRIPTION</b>
+ The Postfix QMQP server receives one message per connec-
+ tion. Each message is piped through the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> dae-
+ mon, and is placed into the <b>incoming</b> queue as one single
+ queue file. The program expects to be run from the <a href="master.8.html"><b>mas-</b></a>
+ <a href="master.8.html"><b>ter</b>(8)</a> process manager.
+
+ The QMQP server implements one access policy: only explic-
+ itly authorized client hosts are allowed to use the ser-
+ vice.
+
+<b>SECURITY</b>
+ The QMQP server is moderately security-sensitive. It talks
+ to QMQP clients and to DNS servers on the network. The
+ QMQP server can be run chrooted at fixed low privilege.
+
+<b>DIAGNOSTICS</b>
+ Problems and transactions are logged to <b>syslogd</b>(8).
+
+<b>BUGS</b>
+ The QMQP protocol provides only one server reply per mes-
+ sage delivery. It is therefore not possible to reject
+ individual recipients.
+
+ The QMQP protocol requires the server to receive the
+ entire message before replying. If a message is malformed,
+ or if any netstring component is longer than acceptable,
+ Postfix replies immediately and closes the connection. It
+ is left up to the client to handle the situation.
+
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
+ command after a configuration change.
+
+<b>Miscellaneous</b>
+ <b>always</b><i>_</i><b>bcc</b>
+ Address to send a copy of each message that enters
+ the system.
+
+ <b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b>
+ Increment in verbose logging level when a remote
+ host matches a pattern in the <b>debug</b><i>_</i><b>peer</b><i>_</i><b>list</b>
+ parameter.
+
+ <b>debug</b><i>_</i><b>peer</b><i>_</i><b>list</b>
+ List of domain or network patterns. When a remote
+ host matches a pattern, increase the verbose log-
+ ging level by the amount specified in the
+ <b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b> parameter.
+
+ <b>hopcount</b><i>_</i><b>limit</b>
+ Limit the number of <b>Received:</b> message headers.
+
+ <b>qmqpd</b><i>_</i><b>authorized</b><i>_</i><b>clients</b>
+ A list of domain or network patterns that specifies
+ what clients are allowed to use the service.
+
+ <b>qmqpd</b><i>_</i><b>timeout</b>
+ Limit the time to send a server response and to
+ receive a client request.
+
+ <b>soft</b><i>_</i><b>bounce</b>
+ Change hard (D) reject responses into soft (Z)
+ reject responses. This can be useful for testing
+ purposes.
+
+<b>Content</b> <b>inspection</b> <b>controls</b>
+ <b>content</b><i>_</i><b>filter</b>
+ The name of a mail delivery transport that filters
+ mail and that either bounces mail or re-injects the
+ result back into Postfix. This parameter uses the
+ same syntax as the right-hand side of a Postfix
+ transport table.
+
+<b>Resource</b> <b>controls</b>
+ <b>line</b><i>_</i><b>length</b><i>_</i><b>limit</b>
+ Limit the amount of memory in bytes used for the
+ handling of partial input lines, and the length of
+ sender and recipient addresses that are received
+ from client.
+
+ <b>message</b><i>_</i><b>size</b><i>_</i><b>limit</b>
+ Limit the total size in bytes of a message, includ-
+ ing on-disk storage for sender and recipient
+ address information.
+
+<b>Tarpitting</b>
+ <b>qmqpd</b><i>_</i><b>error</b><i>_</i><b>sleep</b><i>_</i><b>time</b>
+ Time to wait in seconds before informing the client
+ of a problem. This slows down run-away errors.
+
+<b>SEE</b> <b>ALSO</b>
+ <a href="http://cr.yp.to/proto/qmqp.html">http://cr.yp.to/proto/qmqp.html</a>, QMQP protocol
+ <a href="cleanup.8.html">cleanup(8)</a> message canonicalization
+ <a href="master.8.html">master(8)</a> process manager
+ syslogd(8) system logging
+
+<b>LICENSE</b>
+ The Secure Mailer license must be distributed with this
+ software.
+
+<b>AUTHOR(S)</b>
+ Wietse Venema
+ IBM T.J. Watson Research
+ P.O. Box 704
+ Yorktown Heights, NY 10598, USA
+
+ 1
+
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/receiving.html b/gnu/dist/postfix/html/receiving.html
index 5168e643448..62318562ef2 100644
--- a/gnu/dist/postfix/html/receiving.html
+++ b/gnu/dist/postfix/html/receiving.html
@@ -39,13 +39,12 @@ left-hand corner of this page.
<ul>
<li>Mail is posted locally. The Postfix <a
-href="sendmail.1.html">sendmail</a> program deposits the message
-into the world-writable <b>maildrop</b> directory, where the message
-is picked up by the <a href="pickup.8.html">pickup</a> daemon.
-This daemon does some sanity checks, in order to protect the rest
-of the Postfix system. In order to avoid accidents, the directory
-permissions on the <b>maildrop</b> directory must be such that a
-user cannot delete someone elses mail.
+href="sendmail.1.html">sendmail</a> program invokes the privileged
+<a href="postdrop.1.html">postdrop</a> program which deposits the
+message into the <b>maildrop</b> directory, where the message is
+picked up by the <a href="pickup.8.html">pickup</a> daemon. This
+daemon does some sanity checks, in order to protect the rest of
+the Postfix system.
<p>
diff --git a/gnu/dist/postfix/html/regexp_table.5.html b/gnu/dist/postfix/html/regexp_table.5.html
index 3487c922c6b..704b8abc3d4 100644
--- a/gnu/dist/postfix/html/regexp_table.5.html
+++ b/gnu/dist/postfix/html/regexp_table.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
REGEXP_TABLE(5) REGEXP_TABLE(5)
-
<b>NAME</b>
regexp_table - format of Postfix regular expression tables
@@ -22,18 +19,19 @@ REGEXP_TABLE(5) REGEXP_TABLE(5)
The general form of a Postfix regular expression table is:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the pre-
- vious line.
-
<i>pattern</i> <i>result</i>
When <i>pattern</i> matches a search string, use the cor-
- responding <i>result</i>. A line that starts with white
- space continues the preceding line.
+ responding <i>result</i>.
+
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
<i>pattern1!pattern2</i> <i>result</i>
Matches <i>pattern1</i> but not <i>pattern2</i>.
@@ -41,55 +39,48 @@ REGEXP_TABLE(5) REGEXP_TABLE(5)
Each pattern is a regular expression enclosed by a pair of
delimiters. The regular expression syntax is described in
<i>re_format</i>(7). The expression delimiter can be any charac-
- ter, except whitespace or characters that have special
- meaning (traditionally the forward slash is used). The
+ ter, except whitespace or characters that have special
+ meaning (traditionally the forward slash is used). The
regular expression can contain whitespace.
By default, matching is case-insensitive, although follow-
- ing the second slash with an `i' flag will reverse this.
- Other flags are `x' (disable extended expression syntax),
+ ing the second slash with an `i' flag will reverse this.
+ Other flags are `x' (disable extended expression syntax),
and `m' (enable multi-line mode).
- Each pattern is applied to the entire lookup key string.
- Depending on the application, that string is an entire
+ Each pattern is applied to the entire lookup key string.
+ Depending on the application, that string is an entire
client hostname, an entire client IP address, or an entire
- mail address. Thus, no parent domain or parent network
- search is done, and <i>user@domain</i> mail addresses are not
- broken up into their <i>user</i> and <i>domain</i> constituent parts,
+ mail address. Thus, no parent domain or parent network
+ search is done, and <i>user@domain</i> mail addresses are not
+ broken up into their <i>user</i> and <i>domain</i> constituent parts,
nor is <i>user+foo</i> broken up into <i>user</i> and <i>foo</i>.
- Patterns are applied in the order as specified in the
-
-
-
- 1
-
-
-
-
-
-REGEXP_TABLE(5) REGEXP_TABLE(5)
-
-
- table, until a pattern is found that matches the search
+ Patterns are applied in the order as specified in the
+ table, until a pattern is found that matches the search
string.
- Substitution of substrings from the matched expression
+ Substitution of substrings from the matched expression
into the result string is possible using $1, $2, etc.. The
macros in the result string may need to be written as ${n}
or $(n) if they aren't followed by whitespace.
-<b>EXAMPLES</b>
+<b>EXAMPLE</b> <b>SMTPD</b> <b>ACCESS</b> <b>MAP</b>
# Disallow sender-specified routing. This is a must if you relay mail
# for other domains.
- /[%!@].*[%!@]/ 550 Sender-specified routing rejected
+ /[%!@].*[%!@]/ 550 Sender-specified routing rejected
# Postmaster is OK, that way they can talk to us about how to fix
# their problem.
- /^postmaster@.*$/ OK
+ /^postmaster@/ OK
# Protect your outgoing majordomo exploders
- /^(.*)-outgoing@(.*)$/!/^owner-.*/ 550 Use ${1}@${2} instead
+ /^(.*)-outgoing@(.*)$/!/^owner-/ 550 Use ${1}@${2} instead
+
+<b>EXAMPLE</b> <b>HEADER</b> <b>FILTER</b> <b>MAP</b>
+ # These were once common in junk mail.
+ /^Subject: make money fast/ REJECT
+ /^To: friend@public\.com/ REJECT
<b>SEE</b> <b>ALSO</b>
<a href="pcre_table.5.html">pcre_table(5)</a> format of PCRE tables
@@ -112,23 +103,6 @@ REGEXP_TABLE(5) REGEXP_TABLE(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/relocated.5.html b/gnu/dist/postfix/html/relocated.5.html
index d25a045978e..5ad6c76fcb7 100644
--- a/gnu/dist/postfix/html/relocated.5.html
+++ b/gnu/dist/postfix/html/relocated.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
RELOCATED(5) RELOCATED(5)
-
<b>NAME</b>
relocated - format of Postfix relocated table
@@ -37,18 +34,20 @@ RELOCATED(5) RELOCATED(5)
<b>TABLE</b> <b>FORMAT</b>
The format of the table is as follows:
- <b>o</b> Blank lines are ignored, as are lines beginning
- with `#'.
-
- <b>o</b> Lines that begin with whitespace continue the pre-
- vious line.
-
<b>o</b> An entry has one of the following form:
<i>key</i> <i>new_location</i>
Where <i>new_location</i> specifies contact information
such as an email address, or perhaps a street
address or telephone number.
+ <b>o</b> Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ <b>o</b> A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
+
With lookups from indexed files such as DB or DBM, or from
networked tables such as NIS, LDAP or SQL, the <i>key</i> field
is one of the following:
@@ -59,18 +58,6 @@ RELOCATED(5) RELOCATED(5)
<i>user</i> Matches <i>user</i>@<i>site</i> when <i>site</i> is $<b>myorigin</b>, when <i>site</i>
is listed in $<b>mydestination</b>, or when <i>site</i> is listed
-
-
-
- 1
-
-
-
-
-
-RELOCATED(5) RELOCATED(5)
-
-
in $<b>inet</b><i>_</i><b>interfaces</b>.
@<i>domain</i>
@@ -78,10 +65,10 @@ RELOCATED(5) RELOCATED(5)
lowest precedence.
<b>ADDRESS</b> <b>EXTENSION</b>
- When the search fails, and the address localpart contains
- the optional recipient delimiter (e.g., <i>user+foo</i>@<i>domain</i>),
- the search is repeated for the unextended address (e.g.
- <i>user</i>@<i>domain</i>).
+ When a mail address localpart contains the optional recip-
+ ient delimiter (e.g., <i>user+foo</i>@<i>domain</i>), the lookup order
+ becomes: <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>user+foo</i>, <i>user</i>, and
+ @<i>domain</i>.
<b>REGULAR</b> <b>EXPRESSION</b> <b>TABLES</b>
This section describes how the table lookups change when
@@ -99,17 +86,17 @@ RELOCATED(5) RELOCATED(5)
table, until a pattern is found that matches the search
string.
- Results are the same as with normal indexed file lookups,
- with the additional feature that parenthesized substrings
- from the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
+ Results are the same as with indexed file lookups, with
+ the additional feature that parenthesized substrings from
+ the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
<b>BUGS</b>
- The table format does not understand quoting conventions.
+ The table format does not understand quoting conventions.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this topic. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this topic. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>relocated</b><i>_</i><b>maps</b>
@@ -118,25 +105,13 @@ RELOCATED(5) RELOCATED(5)
Other parameters of interest:
<b>inet</b><i>_</i><b>interfaces</b>
- The network interface addresses that this system
+ The network interface addresses that this system
receives mail on.
<b>mydestination</b>
- List of domains that this mail system considers
+ List of domains that this mail system considers
local.
-
-
-
- 2
-
-
-
-
-
-RELOCATED(5) RELOCATED(5)
-
-
<b>myorigin</b>
The domain that is appended to locally-posted mail.
@@ -146,7 +121,7 @@ RELOCATED(5) RELOCATED(5)
<a href="regexp_table.5.html">regexp_table(5)</a> format of POSIX regular expression tables
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -155,46 +130,6 @@ RELOCATED(5) RELOCATED(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/rewrite.html b/gnu/dist/postfix/html/rewrite.html
index fae9e4a48e3..0d87a8a5a4e 100644
--- a/gnu/dist/postfix/html/rewrite.html
+++ b/gnu/dist/postfix/html/rewrite.html
@@ -226,7 +226,7 @@ send mail to the those ugly address without creating a mailer loop.
<a name="masquerade"> <h2> Address masquerading</h2>
-Address masquerading is a method to hide all hosts below a domain
+Address masquerading is a method to hide all hosts inside a domain
behind their mail gateway, and to make it appear as if the mail
comes from the gateway itself, instead of from individual machines.
@@ -263,12 +263,32 @@ For example,
<p>
-
By default, Postfix makes no exceptions.
+
+<p>
+
+Subtle point: by default, address masquerading is applied only to
+message headers and to envelope sender addresses, but not to envelope
+recipients. This allows you to use address masquerading on a mail
+gateway machine, while still being able to forward mail from outside
+to users on individual machines.
+
+<p>
+
+In order to subject envelope recipient addresses to masquerading,
+too, specify (only available with Postfix versions after 20010802):
+
+<dl>
+
+<dd><b>masquerade_classes = envelope_sender, envelope_recipient,
+header_sender, header_recipient</b>
+
+</dl>
+
<p>
-Subtle point: address masquerading is applied only to message
-headers and envelope sender addresses, not to envelope recipients.
+If you do this, Postfix will no longer be able to send mail to
+individual machines.
<a name="virtual"> <h2> Virtual address mapping</h2>
diff --git a/gnu/dist/postfix/html/security.html b/gnu/dist/postfix/html/security.html
index 0619ef51e7c..c3264f175fe 100644
--- a/gnu/dist/postfix/html/security.html
+++ b/gnu/dist/postfix/html/security.html
@@ -79,11 +79,11 @@ per-process file system name spaces.
<p>
-By default, the <b>maildrop</b> queue directory is world-writable,
-so that local processes can submit mail without assistance from a
-set-uid or set-gid command or from a mail daemon process. The
-maildrop directory is not used for mail coming in via the network,
-and queue files are not readable for other users.
+Initially, the <b>maildrop</b> queue directory was world-writable,
+so that local processes could submit mail without assistance from
+a set-uid or set-gid command or from a mail daemon process. The
+maildrop directory was not used for mail coming in via the network,
+and its queue files were not readable for unprivileged users.
<p>
@@ -99,10 +99,9 @@ Postfix queue file.
<p>
-If a world-writable <b>maildrop</b> directory is not acceptable,
-sites can revoke world write permission, and enable <b>set-gid</b>
-privileges for a small helper program that is provided for this
-purpose.
+Because of the potential for misbehavior, Postfix has abandoned
+the world-writable <b>maildrop</b> directory, and uses a small
+set-gid <b>postdrop</b> helper program for mail submission.
<h2>Trust</h2>
diff --git a/gnu/dist/postfix/html/sendmail.1.html b/gnu/dist/postfix/html/sendmail.1.html
index 43b48ba1426..fba1afd8fa0 100644
--- a/gnu/dist/postfix/html/sendmail.1.html
+++ b/gnu/dist/postfix/html/sendmail.1.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
SENDMAIL(1) SENDMAIL(1)
-
<b>NAME</b>
sendmail - Postfix to Sendmail compatibility interface
@@ -25,11 +22,9 @@ SENDMAIL(1) SENDMAIL(1)
By default, <b>sendmail</b> reads a message from standard input
until EOF or until it reads a line with only a <b>.</b> charac-
- ter, and arranges for delivery. <b>sendmail</b> attempts to cre-
- ate a queue file in the <b>maildrop</b> directory. If that direc-
- tory is not world-writable, the message is piped through
- the <a href="postdrop.1.html"><b>postdrop</b>(1)</a> command, which is expected to execute with
- suitable privileges.
+ ter, and arranges for delivery. <b>sendmail</b> relies on the
+ <a href="postdrop.1.html"><b>postdrop</b>(1)</a> command to create a queue file in the <b>maildrop</b>
+ directory.
Specific command aliases are provided for other common
modes of operation:
@@ -39,18 +34,18 @@ SENDMAIL(1) SENDMAIL(1)
the recipients that still need to be delivered. If
mail could not be delivered upon the last attempt,
the reason for failure is shown. This mode of oper-
- ation is implemented by connecting to the <a href="showq.8.html"><b>showq</b>(8)</a>
- daemon.
+ ation is implemented by executing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a>
+ command.
<b>newaliases</b>
- Initialize the alias database. If no alias database
- type is specified, the program uses the type speci-
- fied in the <b>database</b><i>_</i><b>type</b> configuration parameter;
- if no input file is specified, the program pro-
- cesses the file(s) specified with the
- <b>alias</b><i>_</i><b>database</b> configuration parameter. This mode
- of operation is implemented by running the <b>postal-</b>
- <b>ias</b>(1) command.
+ Initialize the alias database. If no input file is
+ specified (with the <b>-oA</b> option, see below), the
+ program processes the file(s) specified with the
+ <b>alias</b><i>_</i><b>database</b> configuration parameter. If no
+ alias database type is specified, the program uses
+ the type specified with the <b>database</b><i>_</i><b>type</b> configu-
+ ration parameter. This mode of operation is imple-
+ mented by running the <a href="postalias.1.html"><b>postalias</b>(1)</a> command.
Note: it may take a minute or so before an alias
database update becomes visible. Use the <b>postfix</b>
@@ -58,20 +53,8 @@ SENDMAIL(1) SENDMAIL(1)
These and other features can be selected by specifying the
appropriate combination of command-line options. Some fea-
- tures are controlled by parameters in the <b>main.cf</b>
-
-
-
- 1
-
-
-
-
-
-SENDMAIL(1) SENDMAIL(1)
-
-
- configuration file.
+ tures are controlled by parameters in the <b>main.cf</b> configu-
+ ration file.
The following options are recognized:
@@ -94,60 +77,68 @@ SENDMAIL(1) SENDMAIL(1)
<b>-I</b> Initialize alias database. See the <b>newaliases</b> com-
mand above.
+ <b>-L</b> <i>label</i> (ignored)
+ The logging label. Use the <b>syslog</b><i>_</i><b>name</b> configura-
+ tion parameter instead.
+
<b>-N</b> <i>dsn</i> (ignored)
- Delivery status notification control. Currently,
+ Delivery status notification control. Currently,
Postfix does not implement <b>DSN</b>.
<b>-R</b> <i>return_limit</i> (ignored)
- Limit the size of bounced mail. Use the
- <b>bounce</b><i>_</i><b>size</b><i>_</i><b>limit</b> configuration parameter instead.
+ Limit the size of bounced mail. Use the
+ <b>bounce</b><i>_</i><b>size</b><i>_</i><b>limit</b> configuration parameter instead.
<b>-X</b> <i>log_file</i> (ignored)
- Log mailer traffic. Use the <b>debug</b><i>_</i><b>peer</b><i>_</i><b>list</b> and
- <b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b> configuration parameters instead.
+ Log mailer traffic. Use the <b>debug</b><i>_</i><b>peer</b><i>_</i><b>list</b> and
+ <b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b> configuration parameters instead.
<b>-U</b> (ignored)
Initial user submission.
- <b>-bd</b> Go into daemon mode. This mode of operation is
+ <b>-V</b> Variable Envelope Return Path. Given an envelope
+ sender address of the form <i>owner-listname</i>@<i>origin</i>,
+ each recipient <i>user</i>@<i>domain</i> receives mail with a
+ personalized envelope sender address.
+
+ By default, the personalized envelope sender
+ address is <i>owner-listname</i><b>+</b><i>user</i><b>=</b><i>domain</i>@<i>origin</i>. The
+ default <b>+</b> and <b>=</b> characters are configurable with
+ the <b>default</b><i>_</i><b>verp</b><i>_</i><b>delimiters</b> configuration parame-
+ ter.
+
+ <b>-V</b><i>xy</i> As <b>-V</b>, but uses <i>x</i> and <i>y</i> as the VERP delimiter char-
+ acters, instead of the characters specified with
+ the <b>default</b><i>_</i><b>verp</b><i>_</i><b>delimiters</b> configuration parame-
+ ter.
+
+ <b>-bd</b> Go into daemon mode. This mode of operation is
implemented by executing the <b>postfix</b> <b>start</b> command.
- <b>-bi</b> Initialize alias database. See the <b>newaliases</b> com-
+ <b>-bi</b> Initialize alias database. See the <b>newaliases</b> com-
mand above.
- <b>-bm</b> Read mail from standard input and arrange for
+ <b>-bm</b> Read mail from standard input and arrange for
delivery. This is the default mode of operation.
<b>-bp</b> List the mail queue. See the <b>mailq</b> command above.
- <b>-bs</b> Stand-alone SMTP server mode. Read SMTP commands
- from standard input, and write responses to stan-
+ <b>-bs</b> Stand-alone SMTP server mode. Read SMTP commands
+ from standard input, and write responses to stan-
dard output. This mode of operation is implemented
by running the <a href="smtpd.8.html"><b>smtpd</b>(8)</a> daemon.
-
-
-
- 2
-
-
-
-
-
-SENDMAIL(1) SENDMAIL(1)
-
-
<b>-f</b> <i>sender</i>
Set the envelope sender address. This is the
address where delivery problems are sent to, unless
- the message contains an <b>Errors-To:</b> message header.
+ the message contains an <b>Errors-To:</b> message header.
<b>-h</b> <i>hop_count</i> (ignored)
- Hop count limit. Use the <b>hopcount</b><i>_</i><b>limit</b> configura-
+ Hop count limit. Use the <b>hopcount</b><i>_</i><b>limit</b> configura-
tion parameter instead.
- <b>-i</b> When reading a message from standard input, don't
- treat a line with only a <b>.</b> character as the end of
+ <b>-i</b> When reading a message from standard input, don't
+ treat a line with only a <b>.</b> character as the end of
input.
<b>-m</b> (ignored)
@@ -157,60 +148,46 @@ SENDMAIL(1) SENDMAIL(1)
Backwards compatibility.
<b>-oA</b><i>alias_database</i>
- Non-default alias database. Specify <i>pathname</i> or
+ Non-default alias database. Specify <i>pathname</i> or
<i>type</i>:<i>pathname</i>. See <a href="postalias.1.html"><b>postalias</b>(1)</a> for details.
<b>-o7</b> (ignored)
<b>-o8</b> (ignored)
- The message body type. Currently, Postfix imple-
+ The message body type. Currently, Postfix imple-
ments <b>just-send-eight</b>.
- <b>-oi</b> When reading a message from standard input, don't
- treat a line with only a <b>.</b> character as the end of
+ <b>-oi</b> When reading a message from standard input, don't
+ treat a line with only a <b>.</b> character as the end of
input.
<b>-om</b> (ignored)
- The sender is never eliminated from alias etc.
+ The sender is never eliminated from alias etc.
expansions.
<b>-o</b> <i>x</i> <i>value</i> (ignored)
- Set option <i>x</i> to <i>value</i>. Use the equivalent configu-
+ Set option <i>x</i> to <i>value</i>. Use the equivalent configu-
ration parameter in <b>main.cf</b> instead.
<b>-r</b> <i>sender</i>
Set the envelope sender address. This is the
address where delivery problems are sent to, unless
- the message contains an <b>Errors-To:</b> message header.
+ the message contains an <b>Errors-To:</b> message header.
- <b>-q</b> Attempt to deliver all queued mail. This is imple-
- mented by kicking the <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon.
+ <b>-q</b> Attempt to deliver all queued mail. This is imple-
+ mented by executing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.
<b>-q</b><i>interval</i> (ignored)
- The interval between queue runs. Use the
+ The interval between queue runs. Use the
<b>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b> configuration parameter instead.
-
-
-
-
- 3
-
-
-
-
-
-SENDMAIL(1) SENDMAIL(1)
-
-
<b>-qR</b><i>site</i>
- Schedule immediate delivery of all mail that is
- queued for the named <i>site</i>. Depending on the desti-
- nation, this uses "fast flush" service, or it has
- the same effect as <b>sendmail</b> <b>-q</b>. This is imple-
- mented by connecting to the local SMTP server. See
- <a href="smtpd.8.html"><b>smtpd</b>(8)</a> for more information about the "fast
- flush" service.
+ Schedule immediate delivery of all mail that is
+ queued for the named <i>site</i>. This option accepts only
+ <i>site</i> names that are eligible for the "fast flush"
+ service, and is implemented by executing the
+ <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command. See <a href="flushd.8.html"><b>flush</b>(8)</a> for more infor-
+ mation about the "fast flush" service.
<b>-qS</b><i>site</i>
This command is not implemented. Use the slower
@@ -257,18 +234,6 @@ SENDMAIL(1) SENDMAIL(1)
<b>alias</b><i>_</i><b>database</b>
Default alias database(s) for <b>newaliases</b>. The
-
-
-
- 4
-
-
-
-
-
-SENDMAIL(1) SENDMAIL(1)
-
-
default value for this parameter is system-spe-
cific.
@@ -295,14 +260,17 @@ SENDMAIL(1) SENDMAIL(1)
ging level by the amount specified in the
<b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b> parameter.
+ <b>default</b><i>_</i><b>verp</b><i>_</i><b>delimiters</b>
+ The VERP delimiter characters that are used when
+ the <b>-V</b> command line option is specified without
+ delimiter characters.
+
<b>fast</b><i>_</i><b>flush</b><i>_</i><b>domains</b>
List of domains that will receive "fast flush" ser-
vice (default: all domains that this system is
- willing to relay mail to). This greatly improves
- the performance of the SMTP <b>ETRN</b> request, and of
- the <b>sendmail</b> <b>-qR</b> command. For domains not in the
- list, Postfix simply attempts to deliver all queued
- mail.
+ willing to relay mail to). This list specifies the
+ domains that Postfix accepts in the SMTP <b>ETRN</b>
+ request and in the <b>sendmail</b> <b>-qR</b> command.
<b>fork</b><i>_</i><b>attempts</b>
Number of attempts to <b>fork</b>() a process before giv-
@@ -323,18 +291,6 @@ SENDMAIL(1) SENDMAIL(1)
Directory with Postfix support commands (default:
<b>$program</b><i>_</i><b>directory</b>).
-
-
-
- 5
-
-
-
-
-
-SENDMAIL(1) SENDMAIL(1)
-
-
<b>daemon</b><i>_</i><b>directory</b>
Directory with Postfix daemon programs (default:
<b>$program</b><i>_</i><b>directory</b>).
@@ -348,20 +304,23 @@ SENDMAIL(1) SENDMAIL(1)
The time between successive scans of the deferred
queue.
+ <b>verp</b><i>_</i><b>delimiter</b><i>_</i><b>filter</b>
+ The characters that Postfix accepts as VERP delim-
+ iter characters.
+
<b>SEE</b> <b>ALSO</b>
<a href="pickup.8.html">pickup(8)</a> mail pickup daemon
<a href="postalias.1.html">postalias(1)</a> maintain alias database
- <a href="postdrop.1.html">postdrop(1)</a> privileged posting agent
+ <a href="postdrop.1.html">postdrop(1)</a> mail posting utility
<a href="postfix.1.html">postfix(1)</a> mail system control
- <a href="postkick.1.html">postkick(1)</a> kick a Postfix daemon
+ <a href="postqueue.1.html">postqueue(1)</a> mail queue control
<a href="qmgr.8.html">qmgr(8)</a> queue manager
- <a href="showq.8.html">showq(8)</a> list mail queue
<a href="smtpd.8.html">smtpd(8)</a> SMTP server
- flushd(8) fast flush service
+ <a href="flushd.8.html">flush(8)</a> fast flush service
syslogd(8) system logging
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -370,29 +329,6 @@ SENDMAIL(1) SENDMAIL(1)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 6
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/showq.8.html b/gnu/dist/postfix/html/showq.8.html
index 5b266e7c2f6..cec8cf9f1b8 100644
--- a/gnu/dist/postfix/html/showq.8.html
+++ b/gnu/dist/postfix/html/showq.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
SHOWQ(8) SHOWQ(8)
-
<b>NAME</b>
showq - list the Postfix mail queue
@@ -54,15 +51,6 @@ SHOWQ(8) SHOWQ(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
1
-
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/smtp.8.html b/gnu/dist/postfix/html/smtp.8.html
index b493e7090e4..0e166ab1b5a 100644
--- a/gnu/dist/postfix/html/smtp.8.html
+++ b/gnu/dist/postfix/html/smtp.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
SMTP(8) SMTP(8)
-
<b>NAME</b>
smtp - Postfix remote delivery via SMTP
@@ -50,6 +47,7 @@ SMTP(8) SMTP(8)
<a href="http://www.faqs.org/rfcs/rfc1870.html">RFC 1870</a> (Message Size Declaration)
<a href="http://www.faqs.org/rfcs/rfc2197.html">RFC 2197</a> (Pipelining)
<a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a> (AUTH command)
+ <a href="http://www.faqs.org/rfcs/rfc2821.html">RFC 2821</a> (SMTP protocol)
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8). Cor-
@@ -60,17 +58,6 @@ SMTP(8) SMTP(8)
the postmaster is notified of bounces, protocol problems,
and of other trouble.
-
-
- 1
-
-
-
-
-
-SMTP(8) SMTP(8)
-
-
<b>BUGS</b>
<b>CONFIGURATION</b> <b>PARAMETERS</b>
The following <b>main.cf</b> parameters are especially relevant
@@ -124,38 +111,40 @@ SMTP(8) SMTP(8)
send mail to the postmaster with transcripts of
SMTP sessions with protocol errors.
-
-
-
-
- 2
-
-
-
-
-
-SMTP(8) SMTP(8)
-
-
<b>smtp</b><i>_</i><b>always</b><i>_</i><b>send</b><i>_</i><b>ehlo</b>
Always send EHLO at the start of a connection.
<b>smtp</b><i>_</i><b>never</b><i>_</i><b>send</b><i>_</i><b>ehlo</b>
Never send EHLO at the start of a connection.
+ <b>smtp</b><i>_</i><b>bind</b><i>_</i><b>address</b>
+ Numerical source network address to bind to when
+ making a connection.
+
+ <b>smtp</b><i>_</i><b>break</b><i>_</i><b>lines</b>
+ Break lines &gt; <b>$line</b><i>_</i><b>length</b><i>_</i><b>limit</b> into multiple
+ shorter lines. Some SMTP servers misbehave on long
+ lines.
+
<b>smtp</b><i>_</i><b>skip</b><i>_</i><b>4xx</b><i>_</i><b>greeting</b>
- Skip servers that greet us with a 4xx status code.
+ Skip servers that greet us with a 4xx status code.
<b>smtp</b><i>_</i><b>skip</b><i>_</i><b>5xx</b><i>_</i><b>greeting</b>
- Skip servers that greet us with a 5xx status code.
+ Skip servers that greet us with a 5xx status code.
<b>smtp</b><i>_</i><b>skip</b><i>_</i><b>quit</b><i>_</i><b>response</b>
- Do not wait for the server response after sending
+ Do not wait for the server response after sending
QUIT.
- <b>smtp</b><i>_</i><b>bind</b><i>_</i><b>address</b>
- Numerical network address to bind to when making a
- connection.
+ <b>smtp</b><i>_</i><b>pix</b><i>_</i><b>workaround</b><i>_</i><b>delay</b><i>_</i><b>time</b>
+ The time to pause before sending .&lt;CR&gt;&lt;LF&gt;, while
+ working around the CISCO PIX firewall
+ &lt;CR&gt;&lt;LF&gt;.&lt;CR&gt;&lt;LF&gt; bug.
+
+ <b>smtp</b><i>_</i><b>pix</b><i>_</i><b>workaround</b><i>_</i><b>threshold</b><i>_</i><b>time</b>
+ The time a message must be queued before the CISCO
+ PIX firewall &lt;CR&gt;&lt;LF&gt;.&lt;CR&gt;&lt;LF&gt; bug workaround is
+ turned on.
<b>Authentication</b> <b>controls</b>
<b>smtp</b><i>_</i><b>enable</b><i>_</i><b>sasl</b><i>_</i><b>auth</b>
@@ -192,17 +181,6 @@ SMTP(8) SMTP(8)
destination. The default limit is taken from the
<b>default</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b> parameter.
-
-
- 3
-
-
-
-
-
-SMTP(8) SMTP(8)
-
-
<b>smtp</b><i>_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
Limit the number of recipients per message deliv-
ery. The default limit is taken from the
@@ -256,19 +234,6 @@ SMTP(8) SMTP(8)
Timeout for sending the <b>QUIT</b> command, and for
receiving the server response.
-
-
-
-
- 4
-
-
-
-
-
-SMTP(8) SMTP(8)
-
-
<b>SEE</b> <b>ALSO</b>
<a href="bounce.8.html">bounce(8)</a> non-delivery status reports
<a href="master.8.html">master(8)</a> process manager
@@ -285,48 +250,6 @@ SMTP(8) SMTP(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 5
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/smtpd.8.html b/gnu/dist/postfix/html/smtpd.8.html
index 0e96e6860a5..a579778b107 100644
--- a/gnu/dist/postfix/html/smtpd.8.html
+++ b/gnu/dist/postfix/html/smtpd.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
SMTPD(8) SMTPD(8)
-
<b>NAME</b>
smtpd - Postfix SMTP server
@@ -38,12 +35,13 @@ SMTPD(8) SMTPD(8)
<b>STANDARDS</b>
<a href="http://www.faqs.org/rfcs/rfc821.html">RFC 821</a> (SMTP protocol)
<a href="http://www.faqs.org/rfcs/rfc1123.html">RFC 1123</a> (Host requirements)
- <a href="http://www.faqs.org/rfcs/rfc1651.html">RFC 1651</a> (SMTP service extensions)
<a href="http://www.faqs.org/rfcs/rfc1652.html">RFC 1652</a> (8bit-MIME transport)
+ <a href="http://www.faqs.org/rfcs/rfc1869.html">RFC 1869</a> (SMTP service extensions)
<a href="http://www.faqs.org/rfcs/rfc1854.html">RFC 1854</a> (SMTP Pipelining)
<a href="http://www.faqs.org/rfcs/rfc1870.html">RFC 1870</a> (Message Size Declaration)
<a href="http://www.faqs.org/rfcs/rfc1985.html">RFC 1985</a> (ETRN command)
<a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a> (AUTH command)
+ <a href="http://www.faqs.org/rfcs/rfc2821.html">RFC 2821</a> (SMTP protocol)
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8).
@@ -58,42 +56,35 @@ SMTPD(8) SMTPD(8)
details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
-
-
-
-
- 1
-
-
-
-
-
-SMTPD(8) SMTPD(8)
-
-
<b>Compatibility</b> <b>controls</b>
<b>strict</b><i>_</i><b>rfc821</b><i>_</i><b>envelopes</b>
- Disallow non-<a href="http://www.faqs.org/rfcs/rfc821.html">RFC 821</a> style addresses in envelopes.
- For example, allow <a href="http://www.faqs.org/rfcs/rfc822.html">RFC822</a>-style address forms with
- comments, like Sendmail does.
+ Disallow non-<a href="http://www.faqs.org/rfcs/rfc821.html">RFC 821</a> style addresses in SMTP com-
+ mands. For example, the RFC822-style address forms
+ with comments that Sendmail allows.
<b>broken</b><i>_</i><b>sasl</b><i>_</i><b>auth</b><i>_</i><b>clients</b>
Support older Microsoft clients that mis-implement
the AUTH protocol, and that expect an EHLO response
of "250 AUTH=list" instead of "250 AUTH list".
+ <b>smtpd</b><i>_</i><b>noop</b><i>_</i><b>commands</b>
+ List of commands that are treated as NOOP (no oper-
+ ation) commands, without any parameter syntax
+ checking and without any state change. This list
+ overrides built-in command definitions.
+
<b>Content</b> <b>inspection</b> <b>controls</b>
<b>content</b><i>_</i><b>filter</b>
- The name of a mail delivery transport that filters
+ The name of a mail delivery transport that filters
mail and that either bounces mail or re-injects the
- result back into Postfix. This parameter uses the
- same syntax as the right-hand side of a Postfix
+ result back into Postfix. This parameter uses the
+ same syntax as the right-hand side of a Postfix
transport table.
<b>Authentication</b> <b>controls</b>
<b>enable</b><i>_</i><b>sasl</b><i>_</i><b>authentication</b>
- Enable per-session authentication as per <a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a>
- (SASL). This functionality is available only when
+ Enable per-session authentication as per <a href="http://www.faqs.org/rfcs/rfc2554.html">RFC 2554</a>
+ (SASL). This functionality is available only when
explicitly selected at program build time and
explicitly enabled at runtime.
@@ -118,6 +109,12 @@ SMTPD(8) SMTPD(8)
<b>noanonymous</b>
Disallow anonymous logins.
+ <b>smtpd</b><i>_</i><b>sender</b><i>_</i><b>login</b><i>_</i><b>maps</b>
+ Maps that specify the SASL login name that owns a
+ MAIL FROM sender address. Used by the
+ <b>reject</b><i>_</i><b>sender</b><i>_</i><b>login</b><i>_</i><b>mismatch</b> sender anti-spoofing
+ restriction.
+
<b>Miscellaneous</b>
<b>always</b><i>_</i><b>bcc</b>
Address to send a copy of each message that enters
@@ -125,18 +122,6 @@ SMTPD(8) SMTPD(8)
<b>command</b><i>_</i><b>directory</b>
Location of Postfix support commands (default:
-
-
-
- 2
-
-
-
-
-
-SMTPD(8) SMTPD(8)
-
-
<b>$program</b><i>_</i><b>directory</b>).
<b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b>
@@ -150,6 +135,11 @@ SMTPD(8) SMTPD(8)
ging level by the amount specified in the
<b>debug</b><i>_</i><b>peer</b><i>_</i><b>level</b> parameter.
+ <b>default</b><i>_</i><b>verp</b><i>_</i><b>delimiters</b>
+ The default VERP delimiter characters that are used
+ when the XVERP command is specified without
+ explicit delimiters.
+
<b>error</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
Recipient of protocol/policy/resource/software
error notices.
@@ -191,23 +181,15 @@ SMTPD(8) SMTPD(8)
<b>soft</b><i>_</i><b>bounce</b>
Change hard (5xx) reject responses into soft (4xx)
reject responses. This can be useful for testing
-
-
-
- 3
-
-
-
-
-
-SMTPD(8) SMTPD(8)
-
-
purposes.
+ <b>verp</b><i>_</i><b>delimiter</b><i>_</i><b>filter</b>
+ The characters that Postfix accepts as VERP delim-
+ iter characters.
+
<b>Resource</b> <b>controls</b>
<b>line</b><i>_</i><b>length</b><i>_</i><b>limit</b>
- Limit the amount of memory in bytes used for the
+ Limit the amount of memory in bytes used for the
handling of partial input lines.
<b>message</b><i>_</i><b>size</b><i>_</i><b>limit</b>
@@ -215,10 +197,15 @@ SMTPD(8) SMTPD(8)
ing on-disk storage for envelope information.
<b>queue</b><i>_</i><b>minfree</b>
- Minimal amount of free space in bytes in the queue
- file system for the SMTP server to accept any mail
+ Minimal amount of free space in bytes in the queue
+ file system for the SMTP server to accept any mail
at all.
+ <b>smtpd</b><i>_</i><b>history</b><i>_</i><b>flush</b><i>_</i><b>threshold</b>
+ Flush the command history to postmaster after
+ receipt of RSET etc. only if the number of history
+ lines exceeds the given threshold.
+
<b>Tarpitting</b>
<b>smtpd</b><i>_</i><b>error</b><i>_</i><b>sleep</b><i>_</i><b>time</b>
Time to wait in seconds before sending a 4xx or 5xx
@@ -226,51 +213,43 @@ SMTPD(8) SMTPD(8)
<b>smtpd</b><i>_</i><b>soft</b><i>_</i><b>error</b><i>_</i><b>limit</b>
When an SMTP client has made this number of errors,
- wait <i>error_count</i> seconds before responding to any
+ wait <i>error_count</i> seconds before responding to any
client request.
<b>smtpd</b><i>_</i><b>hard</b><i>_</i><b>error</b><i>_</i><b>limit</b>
- Disconnect after a client has made this number of
+ Disconnect after a client has made this number of
errors.
<b>smtpd</b><i>_</i><b>junk</b><i>_</i><b>command</b><i>_</i><b>limit</b>
Limit the number of times a client can issue a junk
- command such as NOOP, VRFY, ETRN or RSET in one
- SMTP session before it is penalized with tarpit
+ command such as NOOP, VRFY, ETRN or RSET in one
+ SMTP session before it is penalized with tarpit
delays.
<b>UCE</b> <b>control</b> <b>restrictions</b>
+ <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdomains</b>
+ List of Postfix features that use <i>domain.name</i> pat-
+ terns to match <i>sub.domain.name</i> (as opposed to
+ requiring <i>.domain.name</i> patterns).
+
<b>smtpd</b><i>_</i><b>client</b><i>_</i><b>restrictions</b>
Restrict what clients may connect to this mail sys-
tem.
<b>smtpd</b><i>_</i><b>helo</b><i>_</i><b>required</b>
- Require that clients introduce themselves at the
+ Require that clients introduce themselves at the
beginning of an SMTP session.
<b>smtpd</b><i>_</i><b>helo</b><i>_</i><b>restrictions</b>
- Restrict what client hostnames are allowed in <b>HELO</b>
+ Restrict what client hostnames are allowed in <b>HELO</b>
and <b>EHLO</b> commands.
<b>smtpd</b><i>_</i><b>sender</b><i>_</i><b>restrictions</b>
- Restrict what sender addresses are allowed in <b>MAIL</b>
+ Restrict what sender addresses are allowed in <b>MAIL</b>
<b>FROM</b> commands.
-
-
-
-
- 4
-
-
-
-
-
-SMTPD(8) SMTPD(8)
-
-
<b>smtpd</b><i>_</i><b>recipient</b><i>_</i><b>restrictions</b>
- Restrict what recipient addresses are allowed in
+ Restrict what recipient addresses are allowed in
<b>RCPT</b> <b>TO</b> commands.
<b>smtpd</b><i>_</i><b>etrn</b><i>_</i><b>restrictions</b>
@@ -278,70 +257,67 @@ SMTPD(8) SMTPD(8)
mands, and what clients may issue <b>ETRN</b> commands.
<b>allow</b><i>_</i><b>untrusted</b><i>_</i><b>routing</b>
- Allow untrusted clients to specify addresses with
- sender-specified routing. Enabling this opens up
- nasty relay loopholes involving trusted backup MX
+ Allow untrusted clients to specify addresses with
+ sender-specified routing. Enabling this opens up
+ nasty relay loopholes involving trusted backup MX
hosts.
<b>smtpd</b><i>_</i><b>restriction</b><i>_</i><b>classes</b>
- Declares the name of zero or more parameters that
- contain a list of UCE restrictions. The names of
- these parameters can then be used instead of the
+ Declares the name of zero or more parameters that
+ contain a list of UCE restrictions. The names of
+ these parameters can then be used instead of the
restriction lists that they represent.
+ <b>smtpd</b><i>_</i><b>null</b><i>_</i><b>access</b><i>_</i><b>lookup</b><i>_</i><b>key</b>
+ The lookup key to be used in SMTPD access tables
+ instead of the null sender address. A null sender
+ address cannot be looked up.
+
<b>maps</b><i>_</i><b>rbl</b><i>_</i><b>domains</b>
- List of DNS domains that publish the addresses of
+ List of DNS domains that publish the addresses of
blacklisted hosts.
+ <b>permit</b><i>_</i><b>mx</b><i>_</i><b>backup</b><i>_</i><b>networks</b>
+ Only domains whose primary MX hosts match the
+ listed networks are eligible for the <b>per-</b>
+ <b>mit</b><i>_</i><b>mx</b><i>_</i><b>backup</b> feature.
+
<b>relay</b><i>_</i><b>domains</b>
- Restrict what domains or networks this mail system
+ Restrict what domains or networks this mail system
will relay mail from or to.
<b>UCE</b> <b>control</b> <b>responses</b>
<b>access</b><i>_</i><b>map</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client violates an access
+ Server response when a client violates an access
database restriction.
<b>invalid</b><i>_</i><b>hostname</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client violates the
+ Server response when a client violates the
<b>reject</b><i>_</i><b>invalid</b><i>_</i><b>hostname</b> restriction.
<b>maps</b><i>_</i><b>rbl</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client violates the
+ Server response when a client violates the
<b>maps</b><i>_</i><b>rbl</b><i>_</i><b>domains</b> restriction.
<b>reject</b><i>_</i><b>code</b>
- Response code when the client matches a <b>reject</b>
+ Response code when the client matches a <b>reject</b>
restriction.
<b>relay</b><i>_</i><b>domains</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client attempts to violate
+ Server response when a client attempts to violate
the mail relay policy.
<b>unknown</b><i>_</i><b>address</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client violates the
+ Server response when a client violates the
<b>reject</b><i>_</i><b>unknown</b><i>_</i><b>address</b> restriction.
-
-
-
-
- 5
-
-
-
-
-
-SMTPD(8) SMTPD(8)
-
-
<b>unknown</b><i>_</i><b>client</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client without address to
- name mapping violates the <b>reject</b><i>_</i><b>unknown</b><i>_</i><b>clients</b>
+ Server response when a client without address to
+ name mapping violates the <b>reject</b><i>_</i><b>unknown</b><i>_</i><b>clients</b>
restriction.
<b>unknown</b><i>_</i><b>hostname</b><i>_</i><b>reject</b><i>_</i><b>code</b>
- Server response when a client violates the
+ Server response when a client violates the
<b>reject</b><i>_</i><b>unknown</b><i>_</i><b>hostname</b> restriction.
<b>SEE</b> <b>ALSO</b>
@@ -350,7 +326,7 @@ SMTPD(8) SMTPD(8)
syslogd(8) system logging
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -359,40 +335,6 @@ SMTPD(8) SMTPD(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 6
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/spawn.8.html b/gnu/dist/postfix/html/spawn.8.html
index b844abf3ac3..34b3427981f 100644
--- a/gnu/dist/postfix/html/spawn.8.html
+++ b/gnu/dist/postfix/html/spawn.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
SPAWN(8) SPAWN(8)
-
<b>NAME</b>
spawn - Postfix external command spawner
@@ -59,18 +56,6 @@ SPAWN(8) SPAWN(8)
<b>SECURITY</b>
This program needs root privilege in order to execute
-
-
-
- 1
-
-
-
-
-
-SPAWN(8) SPAWN(8)
-
-
external commands as the specified user. It is therefore
security sensitive. However the <b>spawn</b> daemon does not
talk to the external command and thus is not vulnerable to
@@ -113,22 +98,6 @@ SPAWN(8) SPAWN(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/transport.5.html b/gnu/dist/postfix/html/transport.5.html
index c384739dde4..737c09c1e78 100644
--- a/gnu/dist/postfix/html/transport.5.html
+++ b/gnu/dist/postfix/html/transport.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
TRANSPORT(5) TRANSPORT(5)
-
<b>NAME</b>
transport - format of Postfix transport table
@@ -36,18 +33,20 @@ TRANSPORT(5) TRANSPORT(5)
<b>TABLE</b> <b>FORMAT</b>
The format of the transport table is as follows:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the pre-
- vious line.
-
<i>pattern</i> <i>result</i>
When <i>pattern</i> matches the domain, use the corre-
sponding <i>result</i>.
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
+
With lookups from indexed files such as DB or DBM, or from
networked tables such as NIS, LDAP or SQL, patterns are
tried in the order as listed below:
@@ -58,18 +57,11 @@ TRANSPORT(5) TRANSPORT(5)
<i>.domain</i> <i>transport</i>:<i>nexthop</i>
Mail for any subdomain of <i>domain</i> is delivered
- through <i>transport</i> to <i>nexthop</i>.
-
-
-
- 1
-
-
-
-
-
-TRANSPORT(5) TRANSPORT(5)
-
+ through <i>transport</i> to <i>nexthop</i>. This applies only
+ when the string <b>transport</b><i>_</i><b>maps</b> is not listed in the
+ <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdomains</b> configuration set-
+ ting. Otherwise, a domain name matches itself and
+ its subdomains.
Note: transport map entries take precedence over domains
specified in the <b>mydestination</b> parameter. If you use the
@@ -125,18 +117,6 @@ TRANSPORT(5) TRANSPORT(5)
used. Specify [] around the hostname in order to disable
MX lookups.
-
-
-
- 2
-
-
-
-
-
-TRANSPORT(5) TRANSPORT(5)
-
-
The error mailer can be used to bounce mail:
<b>.foo.org</b> <b>error:mail</b> <b>for</b> <b>*.foo.org</b> <b>is</b> <b>not</b> <b>deliv-</b>
@@ -159,23 +139,28 @@ TRANSPORT(5) TRANSPORT(5)
table, until a pattern is found that matches the search
string.
- Results are the same as with normal indexed file lookups,
- with the additional feature that parenthesized substrings
- from the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
+ Results are the same as with indexed file lookups, with
+ the additional feature that parenthesized substrings from
+ the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this topic. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this topic. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
+ <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdomains</b>
+ List of Postfix features that use <i>domain.name</i> pat-
+ terns to match <i>sub.domain.name</i> (as opposed to
+ requiring <i>.domain.name</i> patterns).
+
<b>transport</b><i>_</i><b>maps</b>
List of transport lookup tables.
Other parameters of interest:
<b>default</b><i>_</i><b>transport</b>
- The transport to use when no transport is explic-
+ The transport to use when no transport is explic-
itly specified.
<b>relayhost</b>
@@ -189,78 +174,15 @@ TRANSPORT(5) TRANSPORT(5)
<a href="regexp_table.5.html">regexp_table(5)</a> format of POSIX regular expression tables
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
-
-
- 3
-
-
-
-
-
-TRANSPORT(5) TRANSPORT(5)
-
-
<b>AUTHOR(S)</b>
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/trivial-rewrite.8.html b/gnu/dist/postfix/html/trivial-rewrite.8.html
index f2412581479..92f478d06ae 100644
--- a/gnu/dist/postfix/html/trivial-rewrite.8.html
+++ b/gnu/dist/postfix/html/trivial-rewrite.8.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
-
<b>NAME</b>
trivial-rewrite - Postfix address rewriting and resolving
daemon
@@ -59,18 +56,6 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
users. It can run at a fixed low privilege in a chrooted
environment.
-
-
-
- 1
-
-
-
-
-
-TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
-
-
<b>DIAGNOSTICS</b>
Problems and transactions are logged to <b>syslogd</b>(8).
@@ -125,17 +110,10 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
Syntax is <i>transport</i>:<i>nexthop</i>; see <a href="transport.5.html"><b>transport</b>(5)</a> for
details. The :<i>nexthop</i> part is optional.
-
-
-
- 2
-
-
-
-
-
-TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
-
+ <b>parent</b><i>_</i><b>domain</b><i>_</i><b>matches</b><i>_</i><b>subdomains</b>
+ List of Postfix features that use <i>domain.name</i> pat-
+ terns to match <i>sub.domain.name</i> (as opposed to
+ requiring <i>.domain.name</i> patterns).
<b>relayhost</b>
The default host to send non-local mail to when no
@@ -163,38 +141,6 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/uce.html b/gnu/dist/postfix/html/uce.html
index b756a43be30..7ea7a14e9df 100644
--- a/gnu/dist/postfix/html/uce.html
+++ b/gnu/dist/postfix/html/uce.html
@@ -109,8 +109,22 @@ is allowed in message headers.
<dt>Syntax:
<dd>Specify a list of zero or more lookup tables. Whenever a header
-matches a table, a REJECT result means reject the message, and an
-IGNORE result means delete the header from the message.
+matches a table, the action depends on the lookup result:
+
+<p>
+
+<dl>
+
+<dt>REJECT <dd> Reject the message, and log the header.
+
+<dt>REJECT text... <dd> As above, and also send the text to
+the originator.
+
+<dt>IGNORE <dd> Delete the header from the message.
+
+<dt>WARN <dd> Log (but do not reject) the header with a warning.
+
+</dl>
<p>
@@ -133,7 +147,7 @@ mail still to be rejected.</i>
<dt>Example (header_checks):
-<dd> /^to: *friend@public\.com$/ REJECT
+<dd> <tt>/^to: *friend@public\.com$/ REJECT</tt>
<p>
@@ -146,6 +160,14 @@ clients this system accepts SMTP connections from.
<p>
+By default, this restriction is applied when the client sends the
+RCPT TO command. In order to have the restriction take effect
+as soon as possible, specify <b>smtpd_delay_reject = no</b> in
+the Postfix <b>main.cf</b> configuration file. Doing so may cause
+unexpected results with poorly implemented client software.
+
+<p>
+
<dl>
<dt>Default:
@@ -229,6 +251,8 @@ rejected requests (default: <b>554</b>).
<dt> <b><a href="#reject">reject</a></b>
+<dt> <b><a href="#warn_if_reject">warn_if_reject</a></b>
+
<dt> <b><a href="#reject_unauth_pipelining">reject_unauth_pipelining</a></b>
<dd> See generic restrictions.
@@ -280,6 +304,14 @@ The <b>smtpd_helo_restrictions</b> parameter restricts what hostnames
clients may send with the <b>HELO</b> (<b>EHLO</b>) command. Some
UCE software can be stopped by being strict here.
+<p>
+
+By default, this restriction is applied when the client sends the
+RCPT TO command. In order to have the restriction take effect
+as soon as possible, specify <b>smtpd_delay_reject = yes</b> in
+the Postfix <b>main.cf</b> configuration file. Doing so may cause
+unexpected results with poorly implemented client software.
+
<dl>
<dt>Default:
@@ -390,6 +422,8 @@ the response code for <b>REJECT</b> results (default: <b>554</b>).
<dt> <b><a href="#reject">reject</a></b>
+<dt> <b><a href="#warn_if_reject">warn_if_reject</a></b>
+
<dt> <b><a href="#reject_unauth_pipelining">reject_unauth_pipelining</a></b>
<dd> See generic restrictions.
@@ -443,6 +477,14 @@ addresses this system accepts in MAIL FROM commands.
<p>
+By default, this restriction is applied when the client sends the
+RCPT TO command. In order to have the restriction take effect
+as soon as possible, specify <b>smtpd_delay_reject = yes</b> in
+the Postfix <b>main.cf</b> configuration file. Doing so may cause
+unexpected results with poorly implemented client software.
+
+<p>
+
<dl>
<dt> Default:
@@ -516,6 +558,19 @@ response code to rejected requests (default: <b>504</b>).
<p>
+<a name="reject_sender_login_mismatch">
+
+<dt> <b>reject_sender_login_mismatch</b>
+
+<dd> Reject the request when <a href="#smtpd_sender_login_maps">
+$smtpd_sender_owner_maps</a> specifies an owner for the MAIL FROM
+address, but the client is not (SASL) logged in as that MAIL FROM
+address owner; or when the client is (SASL) logged in, but the
+client login name doesn't own the MAIL FROM address according to
+<a href="#smtpd_sender_login_maps"> $smtpd_sender_login_maps</a>.
+
+<p>
+
<dt> <b><a href="#permit_naked_ip_address">permit_naked_ip_address</a></b>
<dt> <b><a href="#reject_invalid_hostname">reject_invalid_hostname</a></b>
@@ -546,6 +601,8 @@ response code to rejected requests (default: <b>504</b>).
<dt> <b><a href="#reject">reject</a></b>
+<dt> <b><a href="#warn_if_reject">warn_if_reject</a></b>
+
<dt> <b><a href="#reject_unauth_pipelining">reject_unauth_pipelining</a></b>
<dd> See generic restrictions.
@@ -722,17 +779,24 @@ code for rejected requests (default: <b>554</b>).
<a name="permit_mx_backup">
<dt> <b>permit_mx_backup</b> <dd> Permit the request when the local
-mail system is MX host for the resolved destination. This includes
-the case that the local mail system is the final destination.
-However, the SMTP server will not forward mail with addresses that
-have sender-specified routing information (example:
+mail system is MX host for the resolved destination.
+This includes the case that the local mail system is the final
+destination. However, the SMTP server will not forward mail with
+addresses that have sender-specified routing information (example:
<i>user@elsewhere@domain</i>),
<p>
-Relevant configuration parameters: <a href="basic.html#mydestination">
-$mydestination</a>, <a href="basic.html#inet_interfaces">
-$inet_interfaces</a>.
+Use the optional <a href="#permit_mx_backup_networks">
+permit_mx_backup_networks</a> parameter to also require that the
+primary MX hosts match a list of network blocks.
+
+<p>
+
+Relevant configuration parameters: <a
+href="#permit_mx_backup_networks">permit_mx_backup_networks</a>,
+<a href="basic.html#mydestination"> $mydestination</a>, <a
+href="basic.html#inet_interfaces"> $inet_interfaces</a>.
<p>
@@ -774,6 +838,9 @@ response code to rejected requests (default: <b>504</b>).
<dt> <b><a href="#check_sender_access">check_sender_access</a></b> <i>maptype</i>:<i>mapname</i>
+<dt> <b><a href="#reject_sender_login_mismatch">reject_sender_login_mismatch
+</a></b>
+
<dd> See sender address restrictions.
<p>
@@ -808,6 +875,8 @@ response code to rejected requests (default: <b>504</b>).
<dt> <b><a href="#reject">reject</a></b>
+<dt> <b><a href="#warn_if_reject">warn_if_reject</a></b>
+
<dt> <b><a href="#reject_unauth_pipelining">reject_unauth_pipelining</a></b>
<dd> See generic restrictions.
@@ -906,6 +975,8 @@ the result code for rejected requests (default: <b>554</b>).
<dt> <b><a href="#reject">reject</a></b>
+<dt> <b><a href="#warn_if_reject">warn_if_reject</a></b>
+
<dt> <b><a href="#reject_unauth_pipelining">reject_unauth_pipelining</a></b>
<dd> See generic restrictions.
@@ -948,6 +1019,17 @@ specifies the response code to rejected requests (default:
<p>
+<a name="warn_if_reject">
+
+<dt> <b>warn_if_reject</b>
+<dd> Change the meaning of the next restriction, so that it logs
+a warning instead of rejecting a request (look for logfile records
+that contain "reject_warning"). This is useful for testing new
+restrictions in a "live" environment without risking unnecessary
+loss of mail.
+
+<p>
+
<a name="reject_unauth_pipelining">
<dt> <b>reject_unauth_pipelining</b> <dd> Reject the request when
@@ -966,6 +1048,52 @@ to speed up deliveries.
<dl>
+<a name="permit_mx_backup_networks">
+
+<dt> <b>permit_mx_backup_networks</b>
+
+<dd>Restrict the use of the <a href="#permit_mx_backup">
+permit_mx_backup</a> relay control feature to destinations whose
+primary MX hosts match a list of network blocks.
+
+<p>
+
+<dl>
+
+<dt>Default:
+
+<dd><b>permit_mx_backup_networks = </b>
+
+<p>
+
+That is, all networks are authorized by default.
+
+<p>
+
+<dt>Syntax:
+
+<dd> Specify a list of network
+blocks in CIDR (network/mask) notation, for example:
+
+<p>
+
+<dl>
+
+<dd> <b>permit_mx_backup_networks = 168.100.0.0/16</b>
+
+</dl>
+
+<p>
+
+You can also specify the absolute pathname of a pattern file instead
+of listing the patterns in the <b>main.cf</b> file.
+
+</dl>
+
+</dl>
+
+<dl>
+
<a name="maps_rbl_domains">
<dt> <b>maps_rbl_domains</b>
@@ -1060,6 +1188,68 @@ tables listed in <b>$relay_domains.</b>
</dl>
+<dl>
+
+<a name="smtpd_sender_login_maps">
+
+<dt> <b>smtpd_sender_login_maps</b>
+
+<dd>This parameter specifies ownership of MAIL FROM addresses, as
+used by the <a href="#reject_sender_login_mismatch">
+reject_sender_login_mismatch</a> sender address restriction.
+
+<p>
+
+<dl>
+
+<dt>Default:
+
+<dd><b>smtpd_sender_login_maps = </b>
+
+<p>
+
+<dt>Syntax:
+
+<dd> Specify zero or more type:name lookup tables, separated by
+whitespace and/or commas. The maps are searched in the
+specified order. Regexp tables are allowed.
+
+<p>
+
+Each map entry specifies a sender address and the login name that
+owns the address. The search order is:
+
+<p>
+
+<dl>
+
+<dt><i>user@domain owner</i>
+
+<dd>This form has the highest precedence.
+
+<p>
+
+<dt><i>user owner</i>
+
+<dd>This matches <i>user@site</i> when <i>site</i> is equal to <a
+href="basic.html#myorigin"> $myorigin</a>, when <i>site</i> is
+listed in <a href="basic.html#mydestination"> $mydestination</a>,
+or when it is listed in <a href="basic.html#inet_interfaces">
+$inet_interfaces</a>.
+
+<p>
+
+<dt><i>@domain owner</i>
+
+<dd>This matches every address in the specified domain, and has
+the lowest precedence.
+
+</dl>
+
+</dl>
+
+</dl>
+
<hr>
<a href="index.html">Up one level</a> | <a href="basic.html">Basic
diff --git a/gnu/dist/postfix/html/virtual.5.html b/gnu/dist/postfix/html/virtual.5.html
index 720d763b6ae..4e716c41e43 100644
--- a/gnu/dist/postfix/html/virtual.5.html
+++ b/gnu/dist/postfix/html/virtual.5.html
@@ -1,10 +1,7 @@
<html> <head> </head> <body> <pre>
-
-
VIRTUAL(5) VIRTUAL(5)
-
<b>NAME</b>
virtual - format of Postfix virtual table
@@ -58,20 +55,8 @@ VIRTUAL(5) VIRTUAL(5)
<i>user1@virtual.domain</i> <i>address1</i>
<i>user2@virtual.domain</i> <i>address2,</i> <i>address3</i>
- The <i>virtual.domain</i> <i>anything</i> entry is required for a
-
-
-
- 1
-
-
-
-
-
-VIRTUAL(5) VIRTUAL(5)
-
-
- Postfix-style virtual domain.
+ The <i>virtual.domain</i> <i>anything</i> entry is required for a Post-
+ fix-style virtual domain.
Do not list a Postfix-style virtual domain in the <b>main.cf</b>
<b>mydestination</b> configuration parameter. Such an entry is
@@ -105,7 +90,7 @@ VIRTUAL(5) VIRTUAL(5)
The <b>main.cf</b> <b>mydestination</b> entry is required for a Send-
mail-style virtual domain.
- Do not specify a <i>virtual.domain</i> <i>whatever</i> virtual map entry
+ Do not specify a <i>virtual.domain</i> <i>anything</i> virtual map entry
for a Sendmail-style virtual domain. Such an entry is
required only with a Postfix-style virtual domain.
@@ -119,30 +104,20 @@ VIRTUAL(5) VIRTUAL(5)
The format of the virtual table is as follows, mappings
being tried in the order as listed in this manual page:
- blanks and comments
- Blank lines are ignored, as are lines beginning
- with `#'.
-
- leading whitespace
- Lines that begin with whitespace continue the
-
-
-
- 2
-
-
-
-
-
-VIRTUAL(5) VIRTUAL(5)
-
-
- previous line.
-
<i>pattern</i> <i>result</i>
When <i>pattern</i> matches a mail address, replace it by
the corresponding <i>result</i>.
+ blank lines and comments
+ Empty lines and whitespace-only lines are ignored,
+ as are lines whose first non-whitespace character
+ is a `#'.
+
+ multi-line text
+ A logical line starts with non-whitespace text. A
+ line that starts with whitespace continues a logi-
+ cal line.
+
With lookups from indexed files such as DB or DBM, or from
networked tables such as NIS, LDAP or SQL, patterns are
tried in the order as listed below:
@@ -171,12 +146,11 @@ VIRTUAL(5) VIRTUAL(5)
works for the first address in the expansion only.
<b>ADDRESS</b> <b>EXTENSION</b>
- When the search fails, and the address localpart contains
- the optional recipient delimiter (e.g., <i>user+foo</i>@<i>domain</i>),
- the search is repeated for the unextended address (e.g.
- <i>user</i>@<i>domain</i>), and the unmatched address extension is prop-
- agated to the result of expansion. The matching order is:
- <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>user+foo</i>, <i>user</i>, and @<i>domain</i>.
+ When a mail address localpart contains the optional recip-
+ ient delimiter (e.g., <i>user+foo</i>@<i>domain</i>), the lookup order
+ becomes: <i>user+foo</i>@<i>domain</i>, <i>user</i>@<i>domain</i>, <i>user+foo</i>, <i>user</i>, and
+ @<i>domain</i>. An unmatched address extension (<i>+foo</i>) is propa-
+ gated to the result of table lookup.
<b>REGULAR</b> <b>EXPRESSION</b> <b>TABLES</b>
This section describes how the table lookups change when
@@ -191,32 +165,20 @@ VIRTUAL(5) VIRTUAL(5)
<i>foo</i>.
Patterns are applied in the order as specified in the
-
-
-
- 3
-
-
-
-
-
-VIRTUAL(5) VIRTUAL(5)
-
-
table, until a pattern is found that matches the search
string.
- Results are the same as with normal indexed file lookups,
- with the additional feature that parenthesized substrings
- from the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
+ Results are the same as with indexed file lookups, with
+ the additional feature that parenthesized substrings from
+ the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
<b>BUGS</b>
- The table format does not understand quoting conventions.
+ The table format does not understand quoting conventions.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
- The following <b>main.cf</b> parameters are especially relevant
- to this topic. See the Postfix <b>main.cf</b> file for syntax
- details and for default values. Use the <b>postfix</b> <b>reload</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this topic. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
command after a configuration change.
<b>virtual</b><i>_</i><b>maps</b>
@@ -225,11 +187,11 @@ VIRTUAL(5) VIRTUAL(5)
Other parameters of interest:
<b>inet</b><i>_</i><b>interfaces</b>
- The network interface addresses that this system
+ The network interface addresses that this system
receives mail on.
<b>mydestination</b>
- List of domains that this mail system considers
+ List of domains that this mail system considers
local.
<b>myorigin</b>
@@ -246,7 +208,7 @@ VIRTUAL(5) VIRTUAL(5)
<a href="regexp_table.5.html">regexp_table(5)</a> format of POSIX regular expression tables
<b>LICENSE</b>
- The Secure Mailer license must be distributed with this
+ The Secure Mailer license must be distributed with this
software.
<b>AUTHOR(S)</b>
@@ -255,12 +217,6 @@ VIRTUAL(5) VIRTUAL(5)
P.O. Box 704
Yorktown Heights, NY 10598, USA
-
-
-
-
-
- 4
-
+ 1
</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/virtual.8.html b/gnu/dist/postfix/html/virtual.8.html
new file mode 100644
index 00000000000..a3f3571b5d1
--- /dev/null
+++ b/gnu/dist/postfix/html/virtual.8.html
@@ -0,0 +1,228 @@
+<html> <head> </head> <body> <pre>
+
+VIRTUAL(8) VIRTUAL(8)
+
+<b>NAME</b>
+ virtual - Postfix virtual domain mail delivery agent
+
+<b>SYNOPSIS</b>
+ <b>virtual</b> [generic Postfix daemon options]
+
+<b>DESCRIPTION</b>
+ The <b>virtual</b> delivery agent is designed for virtual mail
+ hosting services. Originally based on the Postfix local
+ delivery agent, this agent looks up recipients with map
+ lookups of their full recipient address, instead of using
+ hard-coded unix password file lookups of the address local
+ part only.
+
+ This delivery agent only delivers mail. Other features
+ such as mail forwarding, out-of-office notifications,
+ etc., must be configured via virtual maps or via similar
+ lookup mechanisms.
+
+<b>MAILBOX</b> <b>LOCATION</b>
+ The mailbox location is controlled by the <b>virtual</b><i>_</i><b>mail-</b>
+ <b>box</b><i>_</i><b>base</b> and <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>maps</b> configuration parameters
+ (see below). The <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>maps</b> table is indexed by
+ the full recipient address.
+
+ The mailbox pathname is constructed as follows:
+
+ <b>$virtual</b><i>_</i><b>mailbox</b><i>_</i><b>base/$virtual</b><i>_</i><b>mailbox</b><i>_</i><b>maps(</b><i>recipient</i><b>)</b>
+
+ where <i>recipient</i> is the full recipient address.
+
+<b>UNIX</b> <b>MAILBOX</b> <b>FORMAT</b>
+ When the mailbox location does not end in <b>/</b>, the message
+ is delivered in UNIX mailbox format. This format stores
+ multiple messages in one textfile.
+
+ The <b>virtual</b> delivery agent prepends a "<b>From</b> <i>sender</i>
+ <i>time_stamp</i>" envelope header to each message, prepends a
+ <b>Delivered-To:</b> message header with the envelope recipient
+ address, prepends a <b>Return-Path:</b> message header with the
+ envelope sender address, prepends a &gt; character to lines
+ beginning with "<b>From</b> ", and appends an empty line.
+
+ The mailbox is locked for exclusive access while delivery
+ is in progress. In case of problems, an attempt is made to
+ truncate the mailbox to its original length.
+
+<b>QMAIL</b> <b>MAILDIR</b> <b>FORMAT</b>
+ When the mailbox location ends in <b>/</b>, the message is deliv-
+ ered in qmail <b>maildir</b> format. This format stores one mes-
+ sage per file.
+
+ The <b>virtual</b> delivery agent daemon prepends a <b>Delivered-To:</b>
+ message header with the envelope recipient address and
+ prepends a <b>Return-Path:</b> message header with the envelope
+ sender address.
+
+ By definition, <b>maildir</b> format does not require file lock-
+ ing during mail delivery or retrieval.
+
+<b>MAILBOX</b> <b>OWNERSHIP</b>
+ Mailbox ownership is controlled by the <b>virtual</b><i>_</i><b>uid</b><i>_</i><b>maps</b>
+ and <b>virtual</b><i>_</i><b>gid</b><i>_</i><b>maps</b> lookup tables, which are indexed with
+ the full recipient address. Each table provides a string
+ with the numerical user and group ID, respectively.
+
+ The <b>virtual</b><i>_</i><b>minimum</b><i>_</i><b>uid</b> parameter imposes a lower bound on
+ numerical user ID values that may be specified in any <b>vir-</b>
+ <b>tual</b><i>_</i><b>owner</b><i>_</i><b>maps</b> or <b>virtual</b><i>_</i><b>uid</b><i>_</i><b>maps</b>.
+
+<b>SECURITY</b>
+ The virtual delivery agent is not security sensitive, pro-
+ vided that the lookup tables with recipient user/group ID
+ information are adequately protected. This program is not
+ designed to run chrooted.
+
+<b>STANDARDS</b>
+ <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> (ARPA Internet Text Messages)
+
+<b>DIAGNOSTICS</b>
+ Mail bounces when the recipient has no mailbox or when the
+ recipient is over disk quota. In all other cases, mail for
+ an existing recipient is deferred and a warning is logged.
+
+ Problems and transactions are logged to <b>syslogd</b>(8). Cor-
+ rupted message files are marked so that the queue manager
+ can move them to the <b>corrupt</b> queue afterwards.
+
+ Depending on the setting of the <b>notify</b><i>_</i><b>classes</b> parameter,
+ the postmaster is notified of bounces and of other trou-
+ ble.
+
+<b>BUGS</b>
+ This delivery agent silently ignores address extensions.
+
+ Postfix should have lookup tables that can return multiple
+ result attributes. In order to avoid the inconvenience of
+ maintaining three tables, use an LDAP or MYSQL database.
+
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ The following <b>main.cf</b> parameters are especially relevant
+ to this program. See the Postfix <b>main.cf</b> file for syntax
+ details and for default values. Use the <b>postfix</b> <b>reload</b>
+ command after a configuration change.
+
+<b>Mailbox</b> <b>delivery</b>
+ <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>base</b>
+ Specifies a path that is prepended to all mailbox
+ or maildir paths. This is a safety measure to
+ ensure that an out of control map in <b>virtual</b><i>_</i><b>mail-</b>
+ <b>box</b><i>_</i><b>maps</b> doesn't litter the filesystem with mail-
+ boxes. While it could be set to "/", this setting
+ isn't recommended.
+
+ <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>maps</b> (regexp maps disallowed)
+ Recipients are looked up in these maps to determine
+ the path to their mailbox or maildir. If the
+ returned path ends in a slash ("/"), maildir-style
+ delivery is carried out, otherwise the path is
+ assumed to specify a UNIX-style mailbox file.
+
+ Note that <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>base</b> is unconditionally
+ prepended to this path.
+
+ <b>virtual</b><i>_</i><b>minimum</b><i>_</i><b>uid</b>
+ Specifies a minimum uid that will be accepted as a
+ return from a <b>virtual</b><i>_</i><b>owner</b><i>_</i><b>maps</b> or <b>vir-</b>
+ <b>tual</b><i>_</i><b>uid</b><i>_</i><b>maps</b> lookup. Returned values less than
+ this will be rejected, and the message will be
+ deferred.
+
+ <b>virtual</b><i>_</i><b>uid</b><i>_</i><b>maps</b> (regexp maps disallowed)
+ Recipients are looked up in these maps to determine
+ the user ID to be used when writing to the target
+ mailbox.
+
+ <b>virtual</b><i>_</i><b>gid</b><i>_</i><b>maps</b> (regexp maps disallowed)
+ Recipients are looked up in these maps to determine
+ the group ID to be used when writing to the target
+ mailbox.
+
+<b>Locking</b> <b>controls</b>
+ <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>lock</b>
+ How to lock UNIX-style mailboxes: one or more of
+ <b>flock</b>, <b>fcntl</b> or <b>dotlock</b>. The <b>dotlock</b> method
+ requires that the recipient UID or GID has write
+ access to the parent directory of the mailbox file.
+
+ This setting is ignored with <b>maildir</b> style deliv-
+ ery, because such deliveries are safe without
+ explicit locks.
+
+ Use the command <b>postconf</b> <b>-l</b> to find out what lock-
+ ing methods are available on your system.
+
+ <b>deliver</b><i>_</i><b>lock</b><i>_</i><b>attempts</b>
+ Limit the number of attempts to acquire an exclu-
+ sive lock on a UNIX-style mailbox file.
+
+ <b>deliver</b><i>_</i><b>lock</b><i>_</i><b>delay</b>
+ Time (default: seconds) between successive attempts
+ to acquire an exclusive lock on a UNIX-style mail-
+ box file. The actual delay is slightly randomized.
+
+ <b>stale</b><i>_</i><b>lock</b><i>_</i><b>time</b>
+ Limit the time after which a stale lockfile is
+ removed (applicable to UNIX-style mailboxes only).
+
+<b>Resource</b> <b>controls</b>
+ <b>virtual</b><i>_</i><b>destination</b><i>_</i><b>concurrency</b><i>_</i><b>limit</b>
+ Limit the number of parallel deliveries to the same
+ domain via the <b>virtual</b> delivery agent. The default
+ limit is taken from the <b>default</b><i>_</i><b>destination</b><i>_</i><b>concur-</b>
+ <b>rency</b><i>_</i><b>limit</b> parameter. The limit is enforced by
+ the Postfix queue manager.
+
+ <b>virtual</b><i>_</i><b>destination</b><i>_</i><b>recipient</b><i>_</i><b>limit</b>
+ Limit the number of recipients per message delivery
+ via the <b>virtual</b> delivery agent. The default limit
+ is taken from the <b>default</b><i>_</i><b>destination</b><i>_</i><b>recipi-</b>
+ <b>ent</b><i>_</i><b>limit</b> parameter. The limit is enforced by the
+ Postfix queue manager.
+
+ <b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>limit</b>
+ The maximal size in bytes of a mailbox or maildir
+ file. Set to zero to disable the limit.
+
+<b>HISTORY</b>
+ This agent was originally based on the Postfix local
+ delivery agent. Modifications mainly consisted of removing
+ code that either was not applicable or that was not safe
+ in this context: aliases, ~user/.forward files, delivery
+ to "|command" or to /file/name.
+
+ The <b>Delivered-To:</b> header appears in the <b>qmail</b> system by
+ Daniel Bernstein.
+
+ The <b>maildir</b> structure appears in the <b>qmail</b> system by
+ Daniel Bernstein.
+
+<b>SEE</b> <b>ALSO</b>
+ <a href="bounce.8.html">bounce(8)</a> non-delivery status reports
+ syslogd(8) system logging
+ <a href="qmgr.8.html">qmgr(8)</a> queue manager
+
+<b>LICENSE</b>
+ The Secure Mailer license must be distributed with this
+ software.
+
+<b>AUTHOR(S)</b>
+ Wietse Venema
+ IBM T.J. Watson Research
+ P.O. Box 704
+ Yorktown Heights, NY 10598, USA
+
+ Andrew McNamara
+ andrewm@connect.com.au
+ connect.com.au Pty. Ltd.
+ Level 3, 213 Miller St
+ North Sydney 2060, NSW, Australia
+
+ 1
+
+</pre> </body> </html>