diff options
| author | perry <perry@NetBSD.org> | 2003-03-08 19:05:29 +0000 |
|---|---|---|
| committer | perry <perry@NetBSD.org> | 2003-03-08 19:05:29 +0000 |
| commit | 59d07125ee9d00ca396be52e21c9cfcc7db032f2 (patch) | |
| tree | bd4ba6a0c04d1edc518df392bfb13e0b19f8e340 /gnu/dist/postfix/html | |
| parent | 004ae0051408e939340fba68fbf53639cc2d625c (diff) | |
import postfix 2.0.6
Diffstat (limited to 'gnu/dist/postfix/html')
| -rw-r--r-- | gnu/dist/postfix/html/Makefile.in | 7 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/access.5.html | 27 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/backstage.html | 8 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/defer.8.html | 94 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/faq.html | 72 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/mailq.1.html | 345 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/newaliases.1.html | 345 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/postconf.1.html | 54 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/postqueue.1.html | 17 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/postsuper.1.html | 118 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/proxymap.8.html | 132 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/regexp_table.5.html | 4 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/sendmail.1.html | 4 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/transport.5.html | 4 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/trivial-rewrite.8.html | 76 | ||||
| -rw-r--r-- | gnu/dist/postfix/html/virtual.8.html | 81 |
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> |
