summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html
diff options
context:
space:
mode:
authorperry <perry@NetBSD.org>2003-03-08 19:05:29 +0000
committerperry <perry@NetBSD.org>2003-03-08 19:05:29 +0000
commit59d07125ee9d00ca396be52e21c9cfcc7db032f2 (patch)
treebd4ba6a0c04d1edc518df392bfb13e0b19f8e340 /gnu/dist/postfix/html
parent004ae0051408e939340fba68fbf53639cc2d625c (diff)
import postfix 2.0.6
Diffstat (limited to 'gnu/dist/postfix/html')
-rw-r--r--gnu/dist/postfix/html/Makefile.in7
-rw-r--r--gnu/dist/postfix/html/access.5.html27
-rw-r--r--gnu/dist/postfix/html/backstage.html8
-rw-r--r--gnu/dist/postfix/html/defer.8.html94
-rw-r--r--gnu/dist/postfix/html/faq.html72
-rw-r--r--gnu/dist/postfix/html/mailq.1.html345
-rw-r--r--gnu/dist/postfix/html/newaliases.1.html345
-rw-r--r--gnu/dist/postfix/html/postconf.1.html54
-rw-r--r--gnu/dist/postfix/html/postqueue.1.html17
-rw-r--r--gnu/dist/postfix/html/postsuper.1.html118
-rw-r--r--gnu/dist/postfix/html/proxymap.8.html132
-rw-r--r--gnu/dist/postfix/html/regexp_table.5.html4
-rw-r--r--gnu/dist/postfix/html/sendmail.1.html4
-rw-r--r--gnu/dist/postfix/html/transport.5.html4
-rw-r--r--gnu/dist/postfix/html/trivial-rewrite.8.html76
-rw-r--r--gnu/dist/postfix/html/virtual.8.html81
16 files changed, 1190 insertions, 198 deletions
diff --git a/gnu/dist/postfix/html/Makefile.in b/gnu/dist/postfix/html/Makefile.in
index ca3515cb256..1cc44b246fd 100644
--- a/gnu/dist/postfix/html/Makefile.in
+++ b/gnu/dist/postfix/html/Makefile.in
@@ -5,7 +5,8 @@ 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 \
- nqmgr.8.html spawn.8.html flush.8.html virtual.8.html qmqpd.8.html
+ nqmgr.8.html spawn.8.html flush.8.html virtual.8.html qmqpd.8.html \
+ proxymap.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 \
@@ -75,6 +76,10 @@ pipe.8.html: ../src/pipe/pipe.c
PATH=../mantools:$$PATH; \
srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
+proxymap.8.html: ../src/proxymap/proxymap.c
+ PATH=../mantools:$$PATH; \
+ srctoman $? | $(AWK) | nroff -man | uniq | man2html | postlink >$@
+
qmgr.8.html: ../src/qmgr/qmgr.c
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 5158b390c80..aed7ff3f734 100644
--- a/gnu/dist/postfix/html/access.5.html
+++ b/gnu/dist/postfix/html/access.5.html
@@ -165,38 +165,39 @@ ACCESS(5) ACCESS(5)
about content filters is in the Postfix FIL-
TER_README file.
- Note: this action currently affects all recipients
- of the message.
+ Note: this action overrides the <b>main.cf</b> <b>con-</b>
+ <b>tent</b><i>_</i><b>filter</b> setting, and currently affects all
+ recipients of the message.
<i>restriction...</i>
Apply the named UCE restriction(s) (<b>permit</b>, <b>reject</b>,
<b>reject</b><i>_</i><b>unauth</b><i>_</i><b>destination</b>, and so on).
<b>REGULAR</b> <b>EXPRESSION</b> <b>TABLES</b>
- This section describes how the table lookups change when
+ This section describes how the table lookups change when
the table is given in the form of regular expressions. For
- a description of regular expression lookup table syntax,
+ a description of regular expression lookup table syntax,
see <a href="regexp_table.5.html"><b>regexp</b><i>_</i><b>table</b>(5)</a> or <a href="pcre_table.5.html"><b>pcre</b><i>_</i><b>table</b>(5)</a>.
- Each pattern is a regular expression that is applied to
+ Each pattern is a regular expression that is applied to
the entire string being looked up. Depending on the appli-
- cation, that string is an entire client hostname, an
+ 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,
- <i>user@domain</i> mail addresses are not broken up into their
+ <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.
- Actions are the same as with indexed file lookups, with
- the additional feature that parenthesized substrings from
+ 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.
+ The table format does not understand quoting conventions.
<b>SEE</b> <b>ALSO</b>
<a href="postmap.1.html">postmap(1)</a> create mapping table
@@ -205,7 +206,7 @@ ACCESS(5) ACCESS(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>
diff --git a/gnu/dist/postfix/html/backstage.html b/gnu/dist/postfix/html/backstage.html
index 5ee7aeef834..c269efab850 100644
--- a/gnu/dist/postfix/html/backstage.html
+++ b/gnu/dist/postfix/html/backstage.html
@@ -66,6 +66,14 @@ destinations.
<p>
+<li>The <a href="proxymap.8.html">proxymap</a> daemon provides
+read-only lookup service to Postfix client processes. The purpose
+is to overcome chroot restrictions, and to consolidate the number
+of open lookup tables by sharing one open table among multiple
+processes.
+
+<p>
+
<li>The <a href="spawn.8.html">spawn</a> daemon listens on a TCP
port, UNIX-domain socket or FIFO, and runs non-Postfix commands on
request, with the socket or FIFO connected to the standard input,
diff --git a/gnu/dist/postfix/html/defer.8.html b/gnu/dist/postfix/html/defer.8.html
new file mode 100644
index 00000000000..548369f7184
--- /dev/null
+++ b/gnu/dist/postfix/html/defer.8.html
@@ -0,0 +1,94 @@
+<html> <head> </head> <body> <pre>
+BOUNCE(8) BOUNCE(8)
+
+<b>NAME</b>
+ bounce - Postfix message bounce or defer daemon
+
+<b>SYNOPSIS</b>
+ <b>bounce</b> [generic Postfix daemon options]
+
+<b>DESCRIPTION</b>
+ The <b>bounce</b> daemon maintains per-message log files with
+ non-delivery status information. Each log file is named
+ after the queue file that it corresponds to, and is kept
+ in a queue subdirectory named after the service name in
+ the <b>master.cf</b> file (either <b>bounce</b> or <b>defer</b>). This program
+ expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
+
+ The <b>bounce</b> daemon processes two types of service requests:
+
+ <b>o</b> Append a recipient status record to a per-message
+ log file.
+
+ <b>o</b> Post a bounce message, with a copy of a log file
+ and of the corresponding message. When the bounce
+ is posted successfully, the log file is deleted.
+
+ The software does a best effort to notify the sender that
+ there was a problem. A notification is sent even when the
+ log file or original message cannot be read.
+
+ Optionally, a client can request that the per-message log
+ file be deleted when the requested operation fails. This
+ is used by clients that cannot retry transactions by them-
+ selves, and that depend on retry logic in their own
+ client.
+
+<b>STANDARDS</b>
+ <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> (ARPA Internet Text Messages)
+ <a href="http://www.faqs.org/rfcs/rfc1894.html">RFC 1894</a> (Delivery Status Notifications)
+ <a href="http://www.faqs.org/rfcs/rfc2045.html">RFC 2045</a> (Format of Internet Message Bodies)
+
+<b>DIAGNOSTICS</b>
+ Problems and transactions are logged to <b>syslogd</b>(8).
+
+<b>BUGS</b>
+ The log files use an ad-hoc, unstructured format. This
+ will have to change in order to easily support standard
+ delivery status notifications.
+
+<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>bounce</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
+ The recipient of single bounce postmaster notices.
+
+ <b>2bounce</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
+ The recipient of double bounce postmaster notices.
+
+ <b>delay</b><i>_</i><b>notice</b><i>_</i><b>recipient</b>
+ The recipient of "delayed mail" postmaster notices.
+
+ <b>bounce</b><i>_</i><b>size</b><i>_</i><b>limit</b>
+ Limit the amount of original message context that
+ is sent in a non-delivery notification.
+
+ <b>mail</b><i>_</i><b>name</b>
+ Use this mail system name in the introductory text
+ at the start of a bounce message.
+
+ <b>notify</b><i>_</i><b>classes</b>
+ Notify the postmaster of bounced mail when this
+ parameter includes the <b>bounce</b> class. For privacy
+ reasons, the message body is not included.
+
+<b>SEE</b> <b>ALSO</b>
+ <a href="master.8.html">master(8)</a> process manager
+ <a href="qmgr.8.html">qmgr(8)</a> queue 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
+
+ BOUNCE(8)
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/faq.html b/gnu/dist/postfix/html/faq.html
index edb261f92fd..dba261f2ac0 100644
--- a/gnu/dist/postfix/html/faq.html
+++ b/gnu/dist/postfix/html/faq.html
@@ -674,7 +674,7 @@ to send mail only to <i>user@domain.com</i>.
Specify what recipients exist (so that your queue does not fill up
with undeliverable mail from spammers).
-<p.
+<p>
Specify <tt>local_recipient_maps =</tt> if maintaining recipient
information is not practical.
@@ -2015,7 +2015,7 @@ systems for performance and/or security reasons.
<p>
-The Postfix warning message means that new mail notificiation failed
+The Postfix warning message means that new mail notification failed
because the <b>comsat</b> network service is turned off.
<p>
@@ -2034,7 +2034,7 @@ specify:
Note: recent versions of <b>procmail</b> also produce <b>biff</b>
notifications. To silence <b>biff</b> completely you may also have
-to updte <b>procmail</b> configuration files.
+to update <b>procmail</b> configuration files.
<p>
@@ -2090,11 +2090,17 @@ you use the default Postfix local delivery agent:
<pre>
/etc/postfix/main.cf:
- local_recipient_maps = $alias_maps, unix:passwd.byname
+ local_recipient_maps = $alias_maps, proxy:unix:passwd.byname
</pre>
<p>
+You need the <b>proxy:</b> part only if <b>master.cf</b> specifies
+that the Postfix SMTP server runs chrooted. As distributed by the
+author, Postfix runs no daemons chrooted.
+
+<p>
+
The local recipients tables are searched by the recipient address
(user@domain) and by the recipient name (the address minus the
domain). Postfix does not care what the lookup result looks like,
@@ -2107,10 +2113,12 @@ To stop Postfix from rejecting local mail incorrectly:
<ul>
-<li> If you run the Postfix SMTP server chrooted, it may be necessary
-to place a copy of the passwd file inside the chroot jail (typically:
-in <b>/var/spool/postfix/etc</b>). This is system dependent. The
-only way to find out is to try.
+<li> If you run the Postfix SMTP server chrooted, you need to access
+the system password database through the Postfix <a href="proxymap.8.html">
+proxymap</a> service, as shown in the above example. The alternative
+is simply not practical: placing a copy of the passwd file inside
+the chroot jail (typically: in <b>/var/spool/postfix/etc</b>)
+together with a list of system dependent files.
<p>
@@ -2313,21 +2321,30 @@ database" mean?</h3></a>
This message is logged when, for example, the Postfix SMTP server
is unable to access the UNIX password database.
+<p>
+
<ul>
<li> If you're running the Postfix SMTP server chrooted (see
-<b>master.cf</b>) then you may have to copy the password file and
-perhaps a bunch of other files into Postfix queue directory; a
-typical destination would be <b>/var/spool/postfix/etc</b>. See also
-the chroot setup scripts in the <b>examples</b> directory of the
-Postfix source code distribution.
+<b>master.cf</b>) then you need to access the system password
+database through the Postfix <a href="proxymap.8.html">proxymap</a>
+service. The alternative is not practical: copying the password
+file and perhaps a bunch of other system dependent files into the
+Postfix queue directory.
<p>
-<li> Be sure that you have world execute permissions on directories
-and world read permission on the passwd file and any auxiliary
-files that may be needed (such as <b>/etc/nsswitch.conf</b> and
-<b>libnss*.so*</b> files referenced by <b>/etc/nsswitch.conf</b>).
+<pre>
+ /etc/postfix/main.cf:
+ local_recipient_maps = proxy:unix:passwd.byname $alias_maps ...
+</pre>
+
+<p>
+
+<li> Chrooted or not, be sure that you have world execute permissions
+on directories and world read permission on the passwd file and
+any auxiliary files that may be needed (such as <b>/etc/nsswitch.conf</b>
+and <b>libnss*.so*</b> files referenced by <b>/etc/nsswitch.conf</b>).
</ul>
@@ -2638,19 +2655,19 @@ destinations don't work in virtual domains</h3>
<p>
-Quick answer: set up a transport map entry that gives the mail to
-the Postfix local delivery agent:
+Quick answer: set up "punch through" virtual aliases that redirect
+the mail to local Postfix aliases:
<p>
<pre>
/etc/postfix/main.cf:
- transport_maps = hash:/etc/postfix/transport
+ virtual_alias_maps = hash:/etc/postfix/virtual
- /etc/postfix/transport:
- listname@virtual.tld local:
- owner-listname@virtual.tld local:
- listname-request@virtual.tld local:
+ /etc/postfix/virtual:
+ listname@virtual.tld listname
+ owner-listname@virtual.tld owner-listname
+ listname-request@virtual.tld listname-request
/etc/aliases:
listname: "|whatever"
@@ -2660,6 +2677,13 @@ the Postfix local delivery agent:
<p>
+This redirects mail for virtual address <i>listname@virtual.tld</i>
+etc. to local address <i>listname@your.domain.tld</i> etc.. Mail
+for these local aliases is then delivered to external commands or
+files etc. by the Postfix local delivery agent.
+
+<p>
+
Long answer:
<p>
diff --git a/gnu/dist/postfix/html/mailq.1.html b/gnu/dist/postfix/html/mailq.1.html
new file mode 100644
index 00000000000..42d8ecf42e2
--- /dev/null
+++ b/gnu/dist/postfix/html/mailq.1.html
@@ -0,0 +1,345 @@
+<html> <head> </head> <body> <pre>
+SENDMAIL(1) SENDMAIL(1)
+
+<b>NAME</b>
+ sendmail - Postfix to Sendmail compatibility interface
+
+<b>SYNOPSIS</b>
+ <b>sendmail</b> [<i>option</i> <i>...</i>] [<i>recipient</i> <i>...</i>]
+
+ <b>mailq</b>
+ <b>sendmail</b> <b>-bp</b>
+
+ <b>newaliases</b>
+ <b>sendmail</b> <b>-I</b>
+
+<b>DESCRIPTION</b>
+ The <b>sendmail</b> program implements the Postfix to Sendmail
+ compatibility interface. For the sake of compatibility
+ with existing applications, some Sendmail command-line
+ options are recognized but silently ignored.
+
+ 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> 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:
+
+ <b>mailq</b> List the mail queue. Each entry shows the queue
+ file ID, message size, arrival time, sender, and
+ 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 executing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a>
+ command.
+
+ <b>newaliases</b>
+ 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>default</b><i>_</i><b>database</b><i>_</i><b>type</b>
+ configuration parameter. This mode of operation is
+ implemented 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>
+ <b>reload</b> command to eliminate this delay.
+
+ 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> configu-
+ ration file.
+
+ The following options are recognized:
+
+ <b>-Am</b> (ignored)
+
+ <b>-Ac</b> (ignored)
+ Postfix sendmail uses the same configuration file
+ regardless of whether or not a message is an ini-
+ tial submission.
+
+ <b>-B</b> <i>body_type</i>
+ The message body MIME type: <b>7BIT</b> or <b>8BITMIME</b>.
+
+ <b>-C</b> <i>config_file</i> (ignored :-)
+ The path name of the <b>sendmail.cf</b> file. Postfix con-
+ figuration files are kept in <b>/etc/postfix</b>.
+
+ <b>-F</b> <i>full_name</i>
+ Set the sender full name. This is used only with
+ messages that have no <b>From:</b> message header.
+
+ <b>-G</b> (ignored)
+ Gateway (relay) submission, as opposed to initial
+ user submission.
+
+ <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,
+ 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.
+
+ <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.
+
+ <b>-U</b> (ignored)
+ Initial user submission.
+
+ <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-
+ mand above.
+
+ <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-
+ dard output. In stand-alone SMTP server mode, UCE
+ restrictions and access controls are disabled by
+ default. To enable them, run the process as the
+ <b>mail</b><i>_</i><b>owner</b> user.
+
+ This mode of operation is implemented by running
+ the <a href="smtpd.8.html"><b>smtpd</b>(8)</a> daemon.
+
+ <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.
+
+ <b>-h</b> <i>hop_count</i> (ignored)
+ 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
+ input.
+
+ <b>-m</b> (ignored)
+ Backwards compatibility.
+
+ <b>-n</b> (ignored)
+ Backwards compatibility.
+
+ <b>-oA</b><i>alias_database</i>
+ 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)
+ To send 8-bit or binary content, use an appropriate
+ MIME encapsulation and specify the appropriate <b>-B</b>
+ command-line option.
+
+ <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.
+ expansions.
+
+ <b>-o</b> <i>x</i> <i>value</i> (ignored)
+ 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.
+
+ <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
+ <b>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b> configuration parameter instead.
+
+ <b>-qR</b><i>site</i>
+ 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="flush.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
+ <b>sendmail</b> <b>-q</b> command instead.
+
+ <b>-t</b> Extract recipients from message headers. This
+ requires that no recipients be specified on the
+ command line.
+
+ <b>-v</b> Enable verbose logging for debugging purposes. Mul-
+ tiple <b>-v</b> options make the software increasingly
+ verbose. For compatibility with mailx and other
+ mail submission software, a single <b>-v</b> option pro-
+ duces no output.
+
+<b>SECURITY</b>
+ By design, this program is not set-user (or group) id.
+ However, it must handle data from untrusted users or
+ untrusted machines. Thus, the usual precautions need to
+ be taken against malicious inputs.
+
+<b>DIAGNOSTICS</b>
+ Problems are logged to <b>syslogd</b>(8) and to the standard
+ error stream.
+
+<b>ENVIRONMENT</b>
+ <b>MAIL</b><i>_</i><b>CONFIG</b>
+ Directory with Postfix configuration files.
+
+ <b>MAIL</b><i>_</i><b>VERBOSE</b>
+ Enable verbose logging for debugging purposes.
+
+ <b>MAIL</b><i>_</i><b>DEBUG</b>
+ Enable debugging with an external command, as spec-
+ ified with the <b>debugger</b><i>_</i><b>command</b> configuration
+ parameter.
+
+<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
+ configuration change.
+
+ <b>alias</b><i>_</i><b>database</b>
+ Default alias database(s) for <b>newaliases</b>. The
+ default value for this parameter is system-spe-
+ cific.
+
+ <b>bounce</b><i>_</i><b>size</b><i>_</i><b>limit</b>
+ The amount of original message context that is sent
+ along with a non-delivery notification.
+
+ <b>default</b><i>_</i><b>database</b><i>_</i><b>type</b>
+ Default alias etc. database type. On many UNIX sys-
+ tems the default type is either <b>dbm</b> or <b>hash</b>.
+
+ <b>debugger</b><i>_</i><b>command</b>
+ Command that is executed after a Postfix daemon has
+ initialized.
+
+ <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>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 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-
+ ing up.
+
+ <b>fork</b><i>_</i><b>delay</b>
+ Delay in seconds between successive <b>fork</b>()
+ attempts.
+
+ <b>hopcount</b><i>_</i><b>limit</b>
+ Limit the number of <b>Received:</b> message headers.
+
+ <b>mail</b><i>_</i><b>owner</b>
+ The owner of the mail queue and of most Postfix
+ processes.
+
+ <b>command</b><i>_</i><b>directory</b>
+ Directory with Postfix support commands.
+
+ <b>daemon</b><i>_</i><b>directory</b>
+ Directory with Postfix daemon programs.
+
+ <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>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b>
+ 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="postsuper.1.html">postsuper(1)</a> queue maintenance
+ <a href="postalias.1.html">postalias(1)</a> maintain alias database
+ <a href="postdrop.1.html">postdrop(1)</a> mail posting utility
+ <a href="postfix.1.html">postfix(1)</a> mail system control
+ <a href="postqueue.1.html">postqueue(1)</a> mail queue control
+ <a href="qmgr.8.html">qmgr(8)</a> queue manager
+ <a href="smtpd.8.html">smtpd(8)</a> SMTP server
+ <a href="flush.8.html">flush(8)</a> fast flush service
+ 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
+
+ SENDMAIL(1)
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/newaliases.1.html b/gnu/dist/postfix/html/newaliases.1.html
new file mode 100644
index 00000000000..42d8ecf42e2
--- /dev/null
+++ b/gnu/dist/postfix/html/newaliases.1.html
@@ -0,0 +1,345 @@
+<html> <head> </head> <body> <pre>
+SENDMAIL(1) SENDMAIL(1)
+
+<b>NAME</b>
+ sendmail - Postfix to Sendmail compatibility interface
+
+<b>SYNOPSIS</b>
+ <b>sendmail</b> [<i>option</i> <i>...</i>] [<i>recipient</i> <i>...</i>]
+
+ <b>mailq</b>
+ <b>sendmail</b> <b>-bp</b>
+
+ <b>newaliases</b>
+ <b>sendmail</b> <b>-I</b>
+
+<b>DESCRIPTION</b>
+ The <b>sendmail</b> program implements the Postfix to Sendmail
+ compatibility interface. For the sake of compatibility
+ with existing applications, some Sendmail command-line
+ options are recognized but silently ignored.
+
+ 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> 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:
+
+ <b>mailq</b> List the mail queue. Each entry shows the queue
+ file ID, message size, arrival time, sender, and
+ 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 executing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a>
+ command.
+
+ <b>newaliases</b>
+ 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>default</b><i>_</i><b>database</b><i>_</i><b>type</b>
+ configuration parameter. This mode of operation is
+ implemented 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>
+ <b>reload</b> command to eliminate this delay.
+
+ 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> configu-
+ ration file.
+
+ The following options are recognized:
+
+ <b>-Am</b> (ignored)
+
+ <b>-Ac</b> (ignored)
+ Postfix sendmail uses the same configuration file
+ regardless of whether or not a message is an ini-
+ tial submission.
+
+ <b>-B</b> <i>body_type</i>
+ The message body MIME type: <b>7BIT</b> or <b>8BITMIME</b>.
+
+ <b>-C</b> <i>config_file</i> (ignored :-)
+ The path name of the <b>sendmail.cf</b> file. Postfix con-
+ figuration files are kept in <b>/etc/postfix</b>.
+
+ <b>-F</b> <i>full_name</i>
+ Set the sender full name. This is used only with
+ messages that have no <b>From:</b> message header.
+
+ <b>-G</b> (ignored)
+ Gateway (relay) submission, as opposed to initial
+ user submission.
+
+ <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,
+ 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.
+
+ <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.
+
+ <b>-U</b> (ignored)
+ Initial user submission.
+
+ <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-
+ mand above.
+
+ <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-
+ dard output. In stand-alone SMTP server mode, UCE
+ restrictions and access controls are disabled by
+ default. To enable them, run the process as the
+ <b>mail</b><i>_</i><b>owner</b> user.
+
+ This mode of operation is implemented by running
+ the <a href="smtpd.8.html"><b>smtpd</b>(8)</a> daemon.
+
+ <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.
+
+ <b>-h</b> <i>hop_count</i> (ignored)
+ 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
+ input.
+
+ <b>-m</b> (ignored)
+ Backwards compatibility.
+
+ <b>-n</b> (ignored)
+ Backwards compatibility.
+
+ <b>-oA</b><i>alias_database</i>
+ 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)
+ To send 8-bit or binary content, use an appropriate
+ MIME encapsulation and specify the appropriate <b>-B</b>
+ command-line option.
+
+ <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.
+ expansions.
+
+ <b>-o</b> <i>x</i> <i>value</i> (ignored)
+ 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.
+
+ <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
+ <b>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b> configuration parameter instead.
+
+ <b>-qR</b><i>site</i>
+ 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="flush.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
+ <b>sendmail</b> <b>-q</b> command instead.
+
+ <b>-t</b> Extract recipients from message headers. This
+ requires that no recipients be specified on the
+ command line.
+
+ <b>-v</b> Enable verbose logging for debugging purposes. Mul-
+ tiple <b>-v</b> options make the software increasingly
+ verbose. For compatibility with mailx and other
+ mail submission software, a single <b>-v</b> option pro-
+ duces no output.
+
+<b>SECURITY</b>
+ By design, this program is not set-user (or group) id.
+ However, it must handle data from untrusted users or
+ untrusted machines. Thus, the usual precautions need to
+ be taken against malicious inputs.
+
+<b>DIAGNOSTICS</b>
+ Problems are logged to <b>syslogd</b>(8) and to the standard
+ error stream.
+
+<b>ENVIRONMENT</b>
+ <b>MAIL</b><i>_</i><b>CONFIG</b>
+ Directory with Postfix configuration files.
+
+ <b>MAIL</b><i>_</i><b>VERBOSE</b>
+ Enable verbose logging for debugging purposes.
+
+ <b>MAIL</b><i>_</i><b>DEBUG</b>
+ Enable debugging with an external command, as spec-
+ ified with the <b>debugger</b><i>_</i><b>command</b> configuration
+ parameter.
+
+<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
+ configuration change.
+
+ <b>alias</b><i>_</i><b>database</b>
+ Default alias database(s) for <b>newaliases</b>. The
+ default value for this parameter is system-spe-
+ cific.
+
+ <b>bounce</b><i>_</i><b>size</b><i>_</i><b>limit</b>
+ The amount of original message context that is sent
+ along with a non-delivery notification.
+
+ <b>default</b><i>_</i><b>database</b><i>_</i><b>type</b>
+ Default alias etc. database type. On many UNIX sys-
+ tems the default type is either <b>dbm</b> or <b>hash</b>.
+
+ <b>debugger</b><i>_</i><b>command</b>
+ Command that is executed after a Postfix daemon has
+ initialized.
+
+ <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>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 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-
+ ing up.
+
+ <b>fork</b><i>_</i><b>delay</b>
+ Delay in seconds between successive <b>fork</b>()
+ attempts.
+
+ <b>hopcount</b><i>_</i><b>limit</b>
+ Limit the number of <b>Received:</b> message headers.
+
+ <b>mail</b><i>_</i><b>owner</b>
+ The owner of the mail queue and of most Postfix
+ processes.
+
+ <b>command</b><i>_</i><b>directory</b>
+ Directory with Postfix support commands.
+
+ <b>daemon</b><i>_</i><b>directory</b>
+ Directory with Postfix daemon programs.
+
+ <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>queue</b><i>_</i><b>run</b><i>_</i><b>delay</b>
+ 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="postsuper.1.html">postsuper(1)</a> queue maintenance
+ <a href="postalias.1.html">postalias(1)</a> maintain alias database
+ <a href="postdrop.1.html">postdrop(1)</a> mail posting utility
+ <a href="postfix.1.html">postfix(1)</a> mail system control
+ <a href="postqueue.1.html">postqueue(1)</a> mail queue control
+ <a href="qmgr.8.html">qmgr(8)</a> queue manager
+ <a href="smtpd.8.html">smtpd(8)</a> SMTP server
+ <a href="flush.8.html">flush(8)</a> fast flush service
+ 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
+
+ SENDMAIL(1)
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/postconf.1.html b/gnu/dist/postfix/html/postconf.1.html
index 0367e4f510c..4289928bfe2 100644
--- a/gnu/dist/postfix/html/postconf.1.html
+++ b/gnu/dist/postfix/html/postconf.1.html
@@ -54,73 +54,81 @@ POSTCONF(1) POSTCONF(1)
were left behind after abnormal termination.
<b>-m</b> List the names of all supported lookup table types.
+ Postfix lookup tables are specified as <i>type</i><b>:</b><i>name</i>,
+ where <i>type</i> is one of the types listed below. The
+ table <i>name</i> syntax depends on the lookup table type.
- <b>btree</b> A sorted, balanced tree structure. This is
- available only on systems with support for
+ <b>btree</b> A sorted, balanced tree structure. This is
+ available only on systems with support for
Berkeley DB databases.
<b>dbm</b> An indexed file type based on hashing. This
- is available only on systems with support
+ is available only on systems with support
for DBM databases.
<b>environ</b>
The UNIX process environment array. The
- lookup key is the variable name. Originally
- implemented for testing, someone may find
+ lookup key is the variable name. Originally
+ implemented for testing, someone may find
this useful someday.
<b>hash</b> An indexed file type based on hashing. This
- is available only on systems with support
+ is available only on systems with support
for Berkeley DB databases.
<b>ldap</b> (read-only)
- Perform lookups using the LDAP protocol.
+ Perform lookups using the LDAP protocol.
This is described in an LDAP_README file.
<b>mysql</b> (read-only)
- Perform lookups using the MYSQL protocol.
+ Perform lookups using the MYSQL protocol.
This is described in a MYSQL_README file.
<b>pcre</b> (read-only)
A lookup table based on Perl Compatible Reg-
- ular Expressions. The file format is
+ ular Expressions. The file format is
described in <a href="pcre_table.5.html"><b>pcre</b><i>_</i><b>table</b>(5)</a>.
+ <b>proxy</b> (read-only)
+ A lookup table that is implemented via the
+ Postfix <a href="proxymap.8.html"><b>proxymap</b>(8)</a> service. The table name
+ syntax is <i>type</i><b>:</b><i>name</i>.
+
<b>regexp</b> (read-only)
A lookup table based on regular expressions.
- The file format is described in <a href="regexp_table.5.html"><b>reg-</b>
+ The file format is described in <a href="regexp_table.5.html"><b>reg-</b>
<b>exp</b><i>_</i><b>table</b>(5)</a>.
<b>static</b> (read-only)
- A table that always returns its name as
- lookup result. For example, <b>static:foobar</b>
- always returns the string <b>foobar</b> as lookup
+ A table that always returns its name as
+ lookup result. For example, <b>static:foobar</b>
+ always returns the string <b>foobar</b> as lookup
result.
<b>unix</b> (read-only)
- A limited way to query the UNIX authentica-
+ A limited way to query the UNIX authentica-
tion database. The following tables are
implemented:
<b>unix:passwd.byname</b>
- The table is the UNIX password
- database. The key is a login name.
- The result is a password file entry
+ The table is the UNIX password
+ database. The key is a login name.
+ The result is a password file entry
in passwd(5) format.
<b>unix:group.byname</b>
- The table is the UNIX group
- database. The key is a group name.
- The result is a group file entry in
+ The table is the UNIX group
+ database. The key is a group name.
+ The result is a group file entry in
group(5) format.
- Other table types may exist depending on how Postfix was
+ Other table types may exist depending on how Postfix was
built.
<b>-n</b> Print non-default parameter settings only.
<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>
@@ -131,7 +139,7 @@ POSTCONF(1) POSTCONF(1)
Directory with Postfix configuration files.
<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>
diff --git a/gnu/dist/postfix/html/postqueue.1.html b/gnu/dist/postfix/html/postqueue.1.html
index ccc74d664b3..bbe42bd9e99 100644
--- a/gnu/dist/postfix/html/postqueue.1.html
+++ b/gnu/dist/postfix/html/postqueue.1.html
@@ -11,9 +11,11 @@ POSTQUEUE(1) POSTQUEUE(1)
<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.
+ face for queue management. It implements operations that
+ are traditionally available via the <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command.
+ See the <a href="postsuper.1.html"><b>postsuper</b>(1)</a> command for queue operations that
+ require super-user privileges such as deleting a message
+ from the queue or changing the status of a message.
The following options are recognized:
@@ -52,11 +54,11 @@ POSTQUEUE(1) POSTQUEUE(1)
<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
+ ble for the "fast flush" service. See <a href="flush.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>
+ <b>-qR</b><i>site</i> command, by contacting the Postfix <a href="flush.8.html"><b>flush</b>(8)</a>
daemon.
<b>-v</b> Enable verbose logging for debugging purposes. Mul-
@@ -109,10 +111,11 @@ POSTQUEUE(1) POSTQUEUE(1)
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="sendmail.1.html">sendmail(1)</a> sendmail-compatible user interface
+ <a href="postsuper.1.html">postsuper(1)</a> privileged queue operations
<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
+ <a href="flush.8.html">flush(8)</a> fast flush service
<b>LICENSE</b>
The Secure Mailer license must be distributed with this
diff --git a/gnu/dist/postfix/html/postsuper.1.html b/gnu/dist/postfix/html/postsuper.1.html
index 2eb68f224d9..124ba8d9b51 100644
--- a/gnu/dist/postfix/html/postsuper.1.html
+++ b/gnu/dist/postfix/html/postsuper.1.html
@@ -11,9 +11,11 @@ POSTSUPER(1) POSTSUPER(1)
<b>DESCRIPTION</b>
The <b>postsuper</b> command does maintenance jobs on the Postfix
queue. Use of the command is restricted to the superuser.
+ See the <b>postqueue</b> command for unprivileged queue opera-
+ tions such as listing or flushing the mail queue.
- By default, <b>postsuper</b> performs the operations requested
- with the <b>-s</b> and <b>-p</b> command-line options on all Postfix
+ By default, <b>postsuper</b> performs the operations requested
+ 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.
@@ -21,17 +23,17 @@ POSTSUPER(1) POSTSUPER(1)
Options:
<b>-c</b> <i>config_dir</i>
- The <b>main.cf</b> configuration file is in the named
+ The <b>main.cf</b> configuration file is in the named
directory instead of the default configuration
- directory. See also the MAIL_CONFIG environment
+ directory. See also the MAIL_CONFIG environment
setting below.
<b>-d</b> <i>queue_id</i>
Delete one message with the named queue ID from the
- named mail queue(s) (default: <b>hold</b>, <b>incoming</b>,
+ named mail queue(s) (default: <b>hold</b>, <b>incoming</b>,
<b>active</b> and <b>deferred</b>). If a <i>queue_id</i> of <b>-</b> is speci-
- fied, the program reads queue IDs from standard
- input. For example, to delete all mail from or to
+ fied, the program reads queue IDs from standard
+ input. For example, to delete all mail from or to
<b>user@example.com</b>:
mailq | tail +2 | awk 'BEGIN { RS = "" } \
@@ -39,117 +41,117 @@ POSTSUPER(1) POSTSUPER(1)
' | tr -d '*!' | postsuper -d -
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>
+ 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>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-
+ 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
+ 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
+ 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
+ 3) <b>postsuper</b> deletes the new message, instead
+ of the old message that it should have
deleted.
<b>-h</b> <i>queue_id</i>
- Put mail "on hold" so that no attempt is made to
- deliver it. Move one message with the named queue
+ Put mail "on hold" so that no attempt is made to
+ deliver it. Move one message with the named queue
ID from the named mail queue(s) (default: <b>incoming</b>,
- <b>active</b> and <b>deferred</b>) to the <b>hold</b> queue. If a
+ <b>active</b> and <b>deferred</b>) to the <b>hold</b> queue. If a
<i>queue_id</i> of <b>-</b> is specified, the program reads queue
IDs from standard input.
- Specify <b>-h</b> <b>ALL</b> to hold all messages; for example,
+ Specify <b>-h</b> <b>ALL</b> to hold all messages; for example,
specify <b>-h</b> <b>ALL</b> <b>deferred</b> to hold mail in the
- <b>deferred</b> queue. As a safety measure, the word <b>ALL</b>
+ <b>deferred</b> queue. As a safety measure, the word <b>ALL</b>
must be specified in upper case.
- Note: mail that is put "on hold" will not expire
- when its time in the queue exceeds the <b>maxi-</b>
+ Note: mail that is put "on hold" will not expire
+ when its time in the queue exceeds the <b>maxi-</b>
<b>mal</b><i>_</i><b>queue</b><i>_</i><b>lifetime</b> setting.
<b>-H</b> <i>queue_id</i>
Release mail that was put "on hold". Move one mes-
- sage with the named queue ID from the named mail
+ sage with the named queue ID from the named mail
queue(s) (default: <b>hold</b>) to the <b>deferred</b> queue. If
- a <i>queue_id</i> of <b>-</b> is specified, the program reads
+ a <i>queue_id</i> of <b>-</b> is specified, the program reads
queue IDs from standard input.
- Specify <b>-H</b> <b>ALL</b> to release all mail that is "on
- hold". As a safety measure, the word <b>ALL</b> must be
+ Specify <b>-H</b> <b>ALL</b> to release all mail that is "on
+ hold". As a safety measure, the word <b>ALL</b> must be
specified in upper case.
- <b>-p</b> Purge old temporary files that are left over after
+ <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>hold</b>, <b>incoming</b>,
- <b>active</b> and <b>deferred</b>). To requeue multiple mes-
- sages, specify multiple <b>-r</b> command-line options.
+ Requeue the message with the named queue ID from
+ the named mail queue(s) (default: <b>hold</b>, <b>incoming</b>,
+ <b>active</b> and <b>deferred</b>). To requeue multiple mes-
+ sages, specify multiple <b>-r</b> command-line options.
Alternatively, if a <i>queue_id</i> of <b>-</b> is specified, the
program 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
+ 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
+ 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-
+ 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
+ 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
+ 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
+ recommended to perform this operation once before
Postfix startup.
- <b>o</b> Rename files whose name does not match the
+ <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
+ 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
+ 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>,
+ <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
+ 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>.
@@ -158,22 +160,26 @@ POSTSUPER(1) POSTSUPER(1)
Directory with the <b>main.cf</b> file.
<b>BUGS</b>
- Mail that is not sanitized by Postfix (i.e. mail in the
+ Mail that is not sanitized by Postfix (i.e. mail in the
<b>maildrop</b> queue) cannot be placed "on hold".
<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>SEE</b> <b>ALSO</b>
+ <a href="sendmail.1.html">sendmail(1)</a> sendmail-compatible user interface
+ <a href="postqueue.1.html">postqueue(1)</a> unprivileged queue operations
+
<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>
diff --git a/gnu/dist/postfix/html/proxymap.8.html b/gnu/dist/postfix/html/proxymap.8.html
new file mode 100644
index 00000000000..4ea05c09603
--- /dev/null
+++ b/gnu/dist/postfix/html/proxymap.8.html
@@ -0,0 +1,132 @@
+<html> <head> </head> <body> <pre>
+PROXYMAP(8) PROXYMAP(8)
+
+<b>NAME</b>
+ proxymap - Postfix lookup table proxy server
+
+<b>SYNOPSIS</b>
+ <b>proxymap</b> [generic Postfix daemon options]
+
+<b>DESCRIPTION</b>
+ The <b>proxymap</b> server provides read-only table lookup ser-
+ vice to Postfix client processes. The purpose of the ser-
+ vice is:
+
+ <b>o</b> To overcome chroot restrictions. For example, a
+ chrooted SMTP server needs access to the system
+ passwd file in order to reject mail for non-exis-
+ tent local addresses, but it is not practical to
+ maintain a copy of the passwd file in the chroot
+ jail. The solution:
+
+ local_recipient_maps =
+ proxy:unix:passwd.byname $alias_maps
+
+ <b>o</b> To consolidate the number of open lookup tables by
+ sharing one open table among multiple processes.
+ For example, making mysql connections from every
+ Postfix daemon process results in "too many connec-
+ tions" errors. The solution:
+
+ virtual_alias_maps =
+ proxy:mysql:/etc/postfix/virtual_alias.cf
+
+ The total number of connections is limited by the
+ number of proxymap server processes.
+
+ The proxymap server implements the following requests:
+
+ <b>PROXY</b><i>_</i><b>REQ</b><i>_</i><b>OPEN</b> <i>maptype:mapname</i> <i>flags</i>
+ Open the table with type <i>maptype</i> and name <i>mapname</i>,
+ as controlled by <i>flags</i>. The reply is the request
+ completion status code (below) and the map type
+ dependent flags.
+
+ <b>PROXY</b><i>_</i><b>REQ</b><i>_</i><b>LOOKUP</b> <i>maptype:mapname</i> <i>flags</i> <i>key</i>
+ Look up the data stored under the requested key.
+ The reply is the request completion status code
+ (below) and the lookup result value. The <i>map-</i>
+ <i>type:mapname</i> and <i>flags</i> are the same as with the
+ <b>PROXY</b><i>_</i><b>REQ</b><i>_</i><b>OPEN</b> request.
+
+ There is no close command, nor are tables implicitly
+ closed when a client disconnects. One of the purposes of
+ the proxymap server is to share tables among multiple
+ client processes.
+
+ The request completion status code is one of:
+
+ <b>PROXY</b><i>_</i><b>STAT</b><i>_</i><b>OK</b>
+ The specified table was opened, or the requested
+ entry was found.
+
+ <b>PROXY</b><i>_</i><b>STAT</b><i>_</i><b>NOKEY</b>
+ The requested table entry was not found.
+
+ <b>PROXY</b><i>_</i><b>STAT</b><i>_</i><b>BAD</b>
+ The request was rejected (bad request parameter
+ value).
+
+ <b>PROXY</b><i>_</i><b>STAT</b><i>_</i><b>RETRY</b>
+ The lookup request could not be completed.
+
+ <b>PROXY</b><i>_</i><b>STAT</b><i>_</i><b>DENY</b>
+ The specified table was not approved for access via
+ the proxymap service.
+
+<b>SERVER</b> <b>PROCESS</b> <b>MANAGEMENT</b>
+ The proxymap servers run under control by the Postfix mas-
+ ter server. Each server can handle multiple simultaneous
+ connections. When all servers are busy while a client
+ connects, the master creates a new proxymap server pro-
+ cess, provided that the proxymap server process limit is
+ not exceeded. Each proxymap server terminates after serv-
+ ing at least <b>$max</b><i>_</i><b>use</b> clients or after <b>$max</b><i>_</i><b>idle</b> seconds
+ of idle time.
+
+<b>SECURITY</b>
+ The proxymap server opens only tables that are approved
+ via the <b>proxy</b><i>_</i><b>read</b><i>_</i><b>maps</b> configuration parameter, does not
+ talk to users, and can run at fixed low privilege,
+ chrooted or not.
+
+ The proxymap server is not a trusted daemon process, and
+ must not be used to look up sensitive information such as
+ user or group IDs, mailbox file/directory names or exter-
+ nal commands.
+
+<b>DIAGNOSTICS</b>
+ Problems and transactions are logged to <b>syslogd</b>(8).
+
+<b>BUGS</b>
+ The proxymap server provides service to multiple clients,
+ and must therefore not be used for tables that have high-
+ latency lookups.
+
+<b>CONFIGURATION</b> <b>PARAMETERS</b>
+ The following main.cf parameters are especially relevant
+ to this program. Use the <b>postfix</b> <b>reload</b> command after a
+ configuration change.
+
+ <b>proxy</b><i>_</i><b>read</b><i>_</i><b>maps</b>
+ A list of zero or more parameter values that may
+ contain references to Postfix lookup tables. Only
+ table references that begin with <b>proxy:</b> are
+ approved for read-only access via the proxymap
+ server.
+
+<b>SEE</b> <b>ALSO</b>
+ dict_proxy(3) proxy map client
+
+<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
+
+ PROXYMAP(8)
+</pre> </body> </html>
diff --git a/gnu/dist/postfix/html/regexp_table.5.html b/gnu/dist/postfix/html/regexp_table.5.html
index a4e957ef850..624820adbc4 100644
--- a/gnu/dist/postfix/html/regexp_table.5.html
+++ b/gnu/dist/postfix/html/regexp_table.5.html
@@ -90,7 +90,9 @@ REGEXP_TABLE(5) REGEXP_TABLE(5)
/^postmaster@/ OK
# Protect your outgoing majordomo exploders
- /^(.*)-outgoing@(.*)$/!/^owner-/ 550 Use ${1}@${2} instead
+ if !/^owner-/
+ /^(.*)-outgoing@(.*)$/ 550 Use ${1}@${2} instead
+ endif
<b>EXAMPLE</b> <b>HEADER</b> <b>FILTER</b> <b>MAP</b>
# These were once common in junk mail.
diff --git a/gnu/dist/postfix/html/sendmail.1.html b/gnu/dist/postfix/html/sendmail.1.html
index b96c79529d8..42d8ecf42e2 100644
--- a/gnu/dist/postfix/html/sendmail.1.html
+++ b/gnu/dist/postfix/html/sendmail.1.html
@@ -197,7 +197,7 @@ SENDMAIL(1) SENDMAIL(1)
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-
+ <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command. See <a href="flush.8.html"><b>flush</b>(8)</a> for more infor-
mation about the "fast flush" service.
<b>-qS</b><i>site</i>
@@ -328,7 +328,7 @@ SENDMAIL(1) SENDMAIL(1)
<a href="postqueue.1.html">postqueue(1)</a> mail queue control
<a href="qmgr.8.html">qmgr(8)</a> queue manager
<a href="smtpd.8.html">smtpd(8)</a> SMTP server
- <a href="flushd.8.html">flush(8)</a> fast flush service
+ <a href="flush.8.html">flush(8)</a> fast flush service
syslogd(8) system logging
<b>LICENSE</b>
diff --git a/gnu/dist/postfix/html/transport.5.html b/gnu/dist/postfix/html/transport.5.html
index 774c557f5d1..3d63496b841 100644
--- a/gnu/dist/postfix/html/transport.5.html
+++ b/gnu/dist/postfix/html/transport.5.html
@@ -102,8 +102,8 @@ TRANSPORT(5) TRANSPORT(5)
dependent. In the case of SMTP, specify <i>host</i>:<i>service</i> for a
non-default server port, and use [<i>host</i>] or [<i>host</i>]:<i>port</i> in
order to disable MX (mail exchanger) DNS lookups. The []
- form can also be used with IP addresses instead of host-
- names.
+ form is required when you specify an IP address instead of
+ a hostname.
A null <i>transport</i> and null <i>nexthop</i> result means "do not
change": use the delivery transport and nexthop informa-
diff --git a/gnu/dist/postfix/html/trivial-rewrite.8.html b/gnu/dist/postfix/html/trivial-rewrite.8.html
index fcb9f67eaeb..bc7f10c9957 100644
--- a/gnu/dist/postfix/html/trivial-rewrite.8.html
+++ b/gnu/dist/postfix/html/trivial-rewrite.8.html
@@ -75,14 +75,24 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b>$relayhost</b>. The default nexthop is the recipient
domain.
+<b>SERVER</b> <b>PROCESS</b> <b>MANAGEMENT</b>
+ The trivial-rewrite servers run under control by the Post-
+ fix master server. Each server can handle multiple simul-
+ taneous connections. When all servers are busy while a
+ client connects, the master creates a new server process,
+ provided that the trivial-rewrite server process limit is
+ not exceeded. Each trivial-rewrite server terminates
+ after serving at least <b>$max</b><i>_</i><b>use</b> clients of after <b>$max</b><i>_</i><b>idle</b>
+ seconds of idle time.
+
<b>STANDARDS</b>
- None. The command does not interact with the outside
+ None. The command does not interact with the outside
world.
<b>SECURITY</b>
- The <b>trivial-rewrite</b> daemon is not security sensitive. By
- default, this daemon does not talk to remote or local
- users. It can run at a fixed low privilege in a chrooted
+ The <b>trivial-rewrite</b> daemon is not security sensitive. By
+ default, this daemon does not talk to remote or local
+ users. It can run at a fixed low privilege in a chrooted
environment.
<b>DIAGNOSTICS</b>
@@ -90,21 +100,21 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b>BUGS</b>
<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>Miscellaneous</b>
<b>empty</b><i>_</i><b>address</b><i>_</i><b>recipient</b>
- The recipient that is substituted for the null
+ The recipient that is substituted for the null
address.
<b>inet</b><i>_</i><b>interfaces</b>
- The network interfaces that this mail system
- receives mail on. This information is used to
- determine if <i>user</i>@[<i>net.work.addr.ess</i>] is local or
- remote. Mail for local users is given to the
+ The network interfaces that this mail system
+ receives mail on. This information is used to
+ determine if <i>user</i>@[<i>net.work.addr.ess</i>] is local or
+ remote. Mail for local users is given to the
<b>$local</b><i>_</i><b>transport</b>.
<b>mydestination</b>
@@ -113,7 +123,7 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b>virtual</b><i>_</i><b>alias</b><i>_</i><b>domains</b>
List of simulated virtual domains (domains with all
- recipients aliased to some other local or remote
+ recipients aliased to some other local or remote
domain).
<b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>domains</b>
@@ -126,10 +136,10 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b>resolve</b><i>_</i><b>unquoted</b><i>_</i><b>address</b>
When resolving an address, do not quote the address
- localpart as per <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a>, so that additional <b>@</b>, <b>%</b>
- or <b>!</b> characters remain visible. This is techni-
+ localpart as per <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a>, so that additional <b>@</b>, <b>%</b>
+ or <b>!</b> characters remain visible. This is techni-
cally incorrect, but allows us to stop relay
- attacks when forwarding mail to a Sendmail primary
+ attacks when forwarding mail to a Sendmail primary
MX host.
<b>relocated</b><i>_</i><b>maps</b>
@@ -155,50 +165,50 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b>Routing</b>
<b>local</b><i>_</i><b>transport</b>
- Where to deliver mail for destinations that match
- <b>$mydestination</b> or <b>$inet</b><i>_</i><b>interfaces</b>. The default
+ Where to deliver mail for destinations that match
+ <b>$mydestination</b> or <b>$inet</b><i>_</i><b>interfaces</b>. The default
transport is <b>local:$myhostname</b>.
- Syntax is <i>transport</i>:<i>nexthop</i>; see <a href="transport.5.html"><b>transport</b>(5)</a> for
+ 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.
<b>virtual</b><i>_</i><b>transport</b>
- Where to deliver mail for non-local domains that
+ Where to deliver mail for non-local domains that
match <b>$virtual</b><i>_</i><b>mailbox</b><i>_</i><b>domains</b>. The default trans-
port is <b>virtual</b>.
- Syntax is <i>transport</i>:<i>nexthop</i>; see <a href="transport.5.html"><b>transport</b>(5)</a> for
+ 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.
<b>relay</b><i>_</i><b>transport</b>
- Where to deliver mail for non-local domains that
- match <b>$relay</b><i>_</i><b>domains</b>. The default transport is
+ Where to deliver mail for non-local domains that
+ match <b>$relay</b><i>_</i><b>domains</b>. The default transport is
<b>relay</b> (which normally is a clone of the <b>smtp</b> trans-
port).
- Syntax is <i>transport</i>:<i>nexthop</i>; see <a href="transport.5.html"><b>transport</b>(5)</a> for
+ 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.
<b>default</b><i>_</i><b>transport</b>
- Where to deliver all other non-local mail. The
+ Where to deliver all other non-local mail. The
default transport is <b>smtp</b>.
- Syntax is <i>transport</i>:<i>nexthop</i>; see <a href="transport.5.html"><b>transport</b>(5)</a> for
+ 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.
<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.tld</i> pat-
- terns to match <i>sub.domain.tld</i> (as opposed to
+ List of Postfix features that use <i>domain.tld</i> pat-
+ terns to match <i>sub.domain.tld</i> (as opposed to
requiring <i>.domain.tld</i> patterns).
<b>relayhost</b>
- The default host to send non-local mail to when no
- host is specified with <b>$relay</b><i>_</i><b>transport</b> or
- <b>$default</b><i>_</i><b>transport</b>, and when the recipient address
+ The default host to send non-local mail to when no
+ host is specified with <b>$relay</b><i>_</i><b>transport</b> or
+ <b>$default</b><i>_</i><b>transport</b>, and when the recipient address
does not match the optional the <a href="transport.5.html"><b>transport</b>(5)</a> table.
<b>transport</b><i>_</i><b>maps</b>
- List of tables with <i>recipient</i> or <i>domain</i> to (<i>trans-</i>
+ List of tables with <i>recipient</i> or <i>domain</i> to (<i>trans-</i>
<i>port,</i> <i>nexthop</i>) mappings.
<b>SEE</b> <b>ALSO</b>
@@ -208,7 +218,7 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<a href="relocated.5.html">relocated(5)</a> format of the "user has moved" 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>
diff --git a/gnu/dist/postfix/html/virtual.8.html b/gnu/dist/postfix/html/virtual.8.html
index 925526715c2..c36f4e3137d 100644
--- a/gnu/dist/postfix/html/virtual.8.html
+++ b/gnu/dist/postfix/html/virtual.8.html
@@ -17,8 +17,8 @@ VIRTUAL(8) VIRTUAL(8)
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.
+ etc., must be configured via virtual_alias 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>
@@ -141,37 +141,43 @@ VIRTUAL(8) VIRTUAL(8)
etc. is disallowed, because that would open a secu-
rity hole.
+ For security reasons, proxied table lookup is not
+ allowed, because that would open a security hole.
+
<b>virtual</b><i>_</i><b>mailbox</b><i>_</i><b>domains</b>
- The list of domains that should be delivered via
- the Postfix virtual delivery agent. This uses the
+ The list of domains that should be delivered via
+ the Postfix virtual delivery agent. This uses the
same syntax as the <b>mydestination</b> configuration
parameter.
<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
+ 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>
Recipients are looked up in these maps to determine
- the user ID to be used when writing to the target
+ the user ID to be used when writing to the target
mailbox.
- While searching a lookup table, an address exten-
+ While searching a lookup table, an address exten-
sion (<i>user+foo@domain.tld</i>) is ignored.
- In a lookup table, specify a left-hand side of
- <i>@domain.tld</i> to match any user in the specified
- domain that does not have a specific
+ In a lookup table, specify a left-hand side of
+ <i>@domain.tld</i> to match any user in the specified
+ domain that does not have a specific
<i>user@domain.tld</i> entry.
- For security reasons, regular expression maps are
- allowed but regular expression substitution of $1
+ For security reasons, regular expression maps are
+ allowed but regular expression substitution of $1
etc. is disallowed, because that would open a secu-
rity hole.
+ For security reasons, proxied table lookup is not
+ allowed, because that would open a security hole.
+
<b>virtual</b><i>_</i><b>gid</b><i>_</i><b>maps</b>
Recipients are looked up in these maps to determine
the group ID to be used when writing to the target
@@ -190,63 +196,66 @@ VIRTUAL(8) VIRTUAL(8)
etc. is disallowed, because that would open a secu-
rity hole.
+ For security reasons, proxied table lookup is not
+ allowed, because that would open a security hole.
+
<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
+ 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-
+ 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-
+ 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-
+ 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.
+ 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).
+ 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
+ <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
+ 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
+ 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
+ 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
+ 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
+ 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
+ The <b>maildir</b> structure appears in the <b>qmail</b> system by
Daniel Bernstein.
<b>SEE</b> <b>ALSO</b>
@@ -257,7 +266,7 @@ VIRTUAL(8) VIRTUAL(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>