From 38cb735342f38f0b58948919a8833b883d988002 Mon Sep 17 00:00:00 2001
From: Wietse Venema /etc/postfix/sasl/,
cyrus_sasl_config_path and/or the distribution-specific
documentation to determine the expected location.
Some Debian-based Postfix distributions patch Postfix to
+hardcode a non-default search path, making it impossible to set an
+alternate search path via the "cyrus_sasl_config_path" parameter. This
+is likely to be the case when the distribution documents a
+Postfix-specific path (e.g. /etc/postfix/sasl/) that is
+different from the default value of "cyrus_sasl_config_path" (which
+then is likely to be empty).
diff --git a/postfix/html/SMTPD_POLICY_README.html b/postfix/html/SMTPD_POLICY_README.html index aaa5218ed..ba73f0058 100644 --- a/postfix/html/SMTPD_POLICY_README.html +++ b/postfix/html/SMTPD_POLICY_README.html @@ -118,6 +118,7 @@ server_address=10.3.2.1 server_port=54321 Postfix version 3.8 and later: compatibility_level=major.minor.patch +mail_version=3.8.0 [empty line]@@ -220,6 +221,12 @@ server_port=54321 major.minor.patch where minor and patch may be absent. +
The "mail_version" attribute corresponds to the + mail_version parameter value. It has the form + major.minor.patch for stable releases, and + major.minor-yyyymmdd for unstable releases. +
+The following is specific to SMTPD delegated policy requests: diff --git a/postfix/html/aliases.5.html b/postfix/html/aliases.5.html index e7d5b663b..68aa58a51 100644 --- a/postfix/html/aliases.5.html +++ b/postfix/html/aliases.5.html @@ -67,38 +67,41 @@ ALIASES(5) ALIASES(5) 822 standard. /file/name - Mail is appended to /file/name. See local(8) for details of - delivery to file. Delivery is not limited to regular files. - For example, to dispose of unwanted mail, deflect it to - /dev/null. + Mail is appended to /file/name. For details on how a file is + written see the sections "EXTERNAL FILE DELIVERY" and "DELIVERY + RIGHTS" in the local(8) documentation. Delivery is not limited + to regular files. For example, to dispose of unwanted mail, + deflect it to /dev/null. |command - Mail is piped into command. Commands that contain special char- - acters, such as whitespace, should be enclosed between double - quotes. See local(8) for details of delivery to command. - - When the command fails, a limited amount of command output is - mailed back to the sender. The file /usr/include/sysexits.h - defines the expected exit status codes. For example, use "|exit - 67" to simulate a "user unknown" error, and "|exit 0" to imple- + Mail is piped into command. Commands that contain special char- + acters, such as whitespace, should be enclosed between double + quotes. For details on how a command is executed see "EXTERNAL + COMMAND DELIVERY" and "DELIVERY RIGHTS" in the local(8) documen- + tation. + + When the command fails, a limited amount of command output is + mailed back to the sender. The file /usr/include/sysexits.h + defines the expected exit status codes. For example, use "|exit + 67" to simulate a "user unknown" error, and "|exit 0" to imple- ment an expensive black hole. :include:/file/name - Mail is sent to the destinations listed in the named file. - Lines in :include: files have the same syntax as the right-hand + Mail is sent to the destinations listed in the named file. + Lines in :include: files have the same syntax as the right-hand side of alias entries. - A destination can be any destination that is described in this - manual page. However, delivery to "|command" and /file/name is - disallowed by default. To enable, edit the allow_mail_to_com- + A destination can be any destination that is described in this + manual page. However, delivery to "|command" and /file/name is + disallowed by default. To enable, edit the allow_mail_to_com- mands and allow_mail_to_files configuration parameters. ADDRESS EXTENSION - When alias database search fails, and the recipient localpart contains - the optional recipient delimiter (e.g., user+foo), the search is + When alias database search fails, and the recipient localpart contains + the optional recipient delimiter (e.g., user+foo), the search is repeated for the unextended address (e.g., user). - The propagate_unmatched_extensions parameter controls whether an + The propagate_unmatched_extensions parameter controls whether an unmatched address extension (+foo) is propagated to the result of table lookup. @@ -107,9 +110,9 @@ ALIASES(5) ALIASES(5) before database lookup. REGULAR EXPRESSION TABLES - 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, see regexp_table(5) or pcre_table(5). + 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, see regexp_table(5) or pcre_table(5). NOTE: these formats do not use ":" at the end of a pattern. Each regular expression is applied to the entire search string. Thus, a @@ -122,21 +125,21 @@ ALIASES(5) ALIASES(5) reasons there is no support for $1, $2 etc. substring interpolation. SECURITY - The local(8) delivery agent disallows regular expression substitution + The local(8) delivery agent disallows regular expression substitution of $1 etc. in alias_maps, because that would open a security hole. - The local(8) delivery agent will silently ignore requests to use the - proxymap(8) server within alias_maps. Instead it will open the table + The local(8) delivery agent will silently ignore requests to use the + proxymap(8) server within alias_maps. Instead it will open the table directly. Before Postfix version 2.2, the local(8) delivery agent will terminate with a fatal error. CONFIGURATION PARAMETERS - The following main.cf parameters are especially relevant. The text - below provides only a parameter summary. See postconf(5) for more + The following main.cf parameters are especially relevant. The text + below provides only a parameter summary. See postconf(5) for more details including examples. alias_database (see 'postconf -d' output) - The alias databases for local(8) delivery that are updated with + The alias databases for local(8) delivery that are updated with "newaliases" or with "sendmail -bi". alias_maps (see 'postconf -d' output) @@ -149,30 +152,30 @@ ALIASES(5) ALIASES(5) Restrict local(8) mail delivery to external files. expand_owner_alias (no) - When delivering to an alias "aliasname" that has an + When delivering to an alias "aliasname" that has an "owner-aliasname" companion alias, set the envelope sender address to the expansion of the "owner-aliasname" alias. propagate_unmatched_extensions (canonical, virtual) - What address lookup tables copy an address extension from the + What address lookup tables copy an address extension from the lookup key to the lookup result. owner_request_special (yes) - Enable special treatment for owner-listname entries in the + Enable special treatment for owner-listname entries in the aliases(5) file, and don't split owner-listname and list- - name-request address localparts when the recipient_delimiter is + name-request address localparts when the recipient_delimiter is set to "-". recipient_delimiter (empty) - The set of characters that can separate an email address local- + The set of characters that can separate an email address local- part, user name, or a .forward file name from its extension. Available in Postfix version 2.3 and later: frozen_delivered_to (yes) - Update the local(8) delivery agent's idea of the Delivered-To: - address (see prepend_delivered_header) only once, at the start - of a delivery attempt; do not update the Delivered-To: address + Update the local(8) delivery agent's idea of the Delivered-To: + address (see prepend_delivered_header) only once, at the start + of a delivery attempt; do not update the Delivered-To: address while expanding aliases or .forward files. STANDARDS diff --git a/postfix/html/postconf.5.html b/postfix/html/postconf.5.html index 4d9b705fe..03f0ddba9 100644 --- a/postfix/html/postconf.5.html +++ b/postfix/html/postconf.5.html @@ -8609,13 +8609,16 @@ the file is read).
Optional list of DNS allow/denylist domains, filters and weight +
Optional list of patterns with DNS allow/denylist domains, filters +and weight factors. When the list is non-empty, the dnsblog(8) daemon will -query these domains with the IP addresses of remote SMTP clients, +query these domains with the reversed IP addresses of remote SMTP +clients, and postscreen(8) will update an SMTP client's DNSBL score with -each non-error reply.
+each non-error reply as described below. -Caution: when postscreen rejects mail, it replies with the DNSBL +
Caution: when postscreen rejects mail, its SMTP response contains +the DNSBL domain name. Use the postscreen_dnsbl_reply_map feature to hide "password" information in DNSBL domain names.
@@ -8623,26 +8626,25 @@ domain name. Use the postsc specified with postscreen_dnsbl_threshold, postscreen(8) can drop the connection with the remote SMTP client. -Specify a list of domain=filter*weight entries, separated by +
Specify a list of domain=filter*weight patterns, separated by comma or whitespace.
When no "=filter" is specified, postscreen(8) will use any -non-error DNSBL reply. Otherwise, postscreen(8) uses only DNSBL -replies that match the filter. The filter has the form d.d.d.d, +
When a pattern specifies no "=filter", postscreen(8) will +use any non-error DNSBL query result. Otherwise, postscreen(8) +will use only DNSBL +query results that match the filter. The filter has the form d.d.d.d, where each d is a number, or a pattern inside [] that contains one or more ";"-separated numbers or number..number ranges.
-When no "*weight" is specified, postscreen(8) increments -the remote SMTP client's DNSBL score by 1. Otherwise, the weight must be -an integral number, and postscreen(8) adds the specified weight to -the remote SMTP client's DNSBL score. Specify a negative number for -allowlisting.
+When a pattern specifies no "*weight", the weight of the +pattern is 1. Otherwise, the weight must be an integral number. +Specify a negative number for allowlisting.
-When one postscreen_dnsbl_sites entry produces multiple -DNSBL responses, postscreen(8) applies the weight at most once. -
+When a pattern matches one or more DNSBL query results, +postscreen(8) adds that pattern's weight once to the remote SMTP +client's DNSBL score.
/etc/postfix/sasl/,
cyrus_sasl_config_path and/or the distribution-specific
documentation to determine the expected location. Some Debian-based Postfix distributions patch Postfix to
+hardcode a non-default search path, making it impossible to set an
+alternate search path via the "cyrus_sasl_config_path" parameter. This
+is likely to be the case when the distribution documents a
+Postfix-specific path (e.g. /etc/postfix/sasl/) that is
+different from the default value of "cyrus_sasl_config_path" (which
+then is likely to be empty).
diff --git a/postfix/proto/SMTPD_POLICY_README.html b/postfix/proto/SMTPD_POLICY_README.html index 189fb08dd..dd0a5494a 100644 --- a/postfix/proto/SMTPD_POLICY_README.html +++ b/postfix/proto/SMTPD_POLICY_README.html @@ -118,6 +118,7 @@ server_address=10.3.2.1 server_port=54321 Postfix version 3.8 and later: compatibility_level=major.minor.patch +mail_version=3.8.0 [empty line]@@ -220,6 +221,12 @@ compatibility_level=major.minor.patch major.minor.patch where minor and patch may be absent. +
The "mail_version" attribute corresponds to the + mail_version parameter value. It has the form + major.minor.patch for stable releases, and + major.minor-yyyymmdd for unstable releases. +
+The following is specific to SMTPD delegated policy requests: diff --git a/postfix/proto/aliases b/postfix/proto/aliases index ed01ec0c9..d2d3f19b5 100644 --- a/postfix/proto/aliases +++ b/postfix/proto/aliases @@ -65,14 +65,17 @@ # Mail is forwarded to \fIaddress\fR, which is compatible # with the RFC 822 standard. # .IP \fI/file/name\fR -# Mail is appended to \fI/file/name\fR. See \fBlocal\fR(8) -# for details of delivery to file. +# Mail is appended to \fI/file/name\fR. For details on how a +# file is written see the sections "EXTERNAL FILE DELIVERY" +# and "DELIVERY RIGHTS" in the \fBlocal\fR(8) documentation. # Delivery is not limited to regular files. For example, to dispose # of unwanted mail, deflect it to \fB/dev/null\fR. # .IP "|\fIcommand\fR" -# Mail is piped into \fIcommand\fR. Commands that contain special -# characters, such as whitespace, should be enclosed between double -# quotes. See \fBlocal\fR(8) for details of delivery to command. +# Mail is piped into \fIcommand\fR. Commands that contain +# special characters, such as whitespace, should be enclosed +# between double quotes. For details on how a command is +# executed see "EXTERNAL COMMAND DELIVERY" and "DELIVERY +# RIGHTS" in the \fBlocal\fR(8) documentation. # .sp # When the command fails, a limited amount of command output is # mailed back to the sender. The file \fB/usr/include/sysexits.h\fR diff --git a/postfix/proto/postconf.proto b/postfix/proto/postconf.proto index 76919f0ca..0f335eea9 100644 --- a/postfix/proto/postconf.proto +++ b/postfix/proto/postconf.proto @@ -14354,13 +14354,16 @@ The default time unit is s (seconds).
%PARAM postscreen_dnsbl_sites -Optional list of DNS allow/denylist domains, filters and weight +
Optional list of patterns with DNS allow/denylist domains, filters +and weight factors. When the list is non-empty, the dnsblog(8) daemon will -query these domains with the IP addresses of remote SMTP clients, +query these domains with the reversed IP addresses of remote SMTP +clients, and postscreen(8) will update an SMTP client's DNSBL score with -each non-error reply.
+each non-error reply as described below. -Caution: when postscreen rejects mail, it replies with the DNSBL +
Caution: when postscreen rejects mail, its SMTP response contains +the DNSBL domain name. Use the postscreen_dnsbl_reply_map feature to hide "password" information in DNSBL domain names.
@@ -14368,26 +14371,25 @@ domain name. Use the postscreen_dnsbl_reply_map feature to hide specified with postscreen_dnsbl_threshold, postscreen(8) can drop the connection with the remote SMTP client. -Specify a list of domain=filter*weight entries, separated by +
Specify a list of domain=filter*weight patterns, separated by comma or whitespace.
When no "=filter" is specified, postscreen(8) will use any -non-error DNSBL reply. Otherwise, postscreen(8) uses only DNSBL -replies that match the filter. The filter has the form d.d.d.d, +
When a pattern specifies no "=filter", postscreen(8) will +use any non-error DNSBL query result. Otherwise, postscreen(8) +will use only DNSBL +query results that match the filter. The filter has the form d.d.d.d, where each d is a number, or a pattern inside [] that contains one or more ";"-separated numbers or number..number ranges.
-When no "*weight" is specified, postscreen(8) increments -the remote SMTP client's DNSBL score by 1. Otherwise, the weight must be -an integral number, and postscreen(8) adds the specified weight to -the remote SMTP client's DNSBL score. Specify a negative number for -allowlisting.
+When a pattern specifies no "*weight", the weight of the +pattern is 1. Otherwise, the weight must be an integral number. +Specify a negative number for allowlisting.
-When one postscreen_dnsbl_sites entry produces multiple -DNSBL responses, postscreen(8) applies the weight at most once. -
+When a pattern matches one or more DNSBL query results, +postscreen(8) adds that pattern's weight once to the remote SMTP +client's DNSBL score.