diff options
| author | perry <perry@NetBSD.org> | 2002-02-02 23:10:24 +0000 |
|---|---|---|
| committer | perry <perry@NetBSD.org> | 2002-02-02 23:10:24 +0000 |
| commit | 6f59dc7aebbf705da79e61ef3fd24b48ed99d327 (patch) | |
| tree | c6e9fd356c8aac78b966a9dd53f5d0d14d5e62cd /gnu/dist/postfix/html | |
| parent | ecf43984517b4cfb837e78958769cc8207ea5288 (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')
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> <> in the + Postfix <b>main.cf</b> file, and to specify <> 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 <>. - This substitution is done before all other address + The destination for undeliverable mail from <>. + 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 - > 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 + > 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 <<b>sysexits.h</b>>. - 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 > 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 > 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>> (optional) - Optional message processing flags. By default, a + <b>flags=BFRhqu.</b>> (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. - > Prepend > to lines starting with "<b>From</b> ". + > Prepend > 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 <<b>sysexits.h</b>>. - 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> < <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 > <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 .<CR><LF>, while + working around the CISCO PIX firewall + <CR><LF>.<CR><LF> 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 <CR><LF>.<CR><LF> 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 > 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> |
