]> git.ipfire.org Git - thirdparty/postfix.git/commitdiff
postfix-3.9-20230508
authorWietse Venema <wietse@porcupine.org>
Mon, 8 May 2023 05:00:00 +0000 (00:00 -0500)
committerViktor Dukhovni <postfix-users@dukhovni.org>
Tue, 9 May 2023 03:24:22 +0000 (23:24 -0400)
21 files changed:
postfix/HISTORY
postfix/README_FILES/ADDRESS_REWRITING_README
postfix/conf/virtual
postfix/html/ADDRESS_REWRITING_README.html
postfix/html/cleanup.8.html
postfix/html/local.8.html
postfix/html/postconf.5.html
postfix/html/smtpd.8.html
postfix/html/virtual.5.html
postfix/man/man5/postconf.5
postfix/man/man5/virtual.5
postfix/man/man8/cleanup.8
postfix/man/man8/local.8
postfix/man/man8/smtpd.8
postfix/proto/ADDRESS_REWRITING_README.html
postfix/proto/postconf.proto
postfix/proto/virtual
postfix/src/cleanup/cleanup.c
postfix/src/global/mail_version.h
postfix/src/local/local.c
postfix/src/smtpd/smtpd.c

index f7c730fc7548fc74d87ff7d116c8a3dfc095e7ce..6948b8a2b251a4484774b94f6e344ad50f290047 100644 (file)
@@ -27150,3 +27150,10 @@ Apologies for any names omitted.
        Documentation: fine tuning of text about local aliasing
        versus virtual aliasing. Files: proto/postconf.proto,
        proto/aliases, proto/virtual, proto/ADDRESS_REWRITING_README.html.
+
+20230508
+
+       Documentation: more fine tuning of text about local aliasing
+       versus virtual aliasing, and inet_interfaces. Files:
+       proto/postconf.proto, proto/aliases, proto/virtual,
+       proto/ADDRESS_REWRITING_README.html.
index 6ffa3b6432362bb65fbff09ac4734baba568a7f1..4c2428762e6e6106903517025c618e06683424a7 100644 (file)
@@ -489,9 +489,9 @@ transform " Firstname.Lastname " back into UNIX login names, although it seems
 that local aliases may be a more appropriate vehicle. See the VIRTUAL_README
 document for an overview of methods to host virtual domains with Postfix.
 
-Note: virtual aliasing (virtual_alias_maps) applies to all email deliveries:
-local(8), virtual, and remote. This is unlike local aliasing (alias_maps) which
-applies only to local(8) delivery.
+Note: virtual aliasing (virtual_alias_maps) applies to all recipients: local
+(8), virtual, and remote.  This is unlike local aliasing (alias_maps) which
+applies only to local(8) recipients.
 
 Virtual aliasing is disabled by default. To enable, edit the virtual_alias_maps
 parameter in the main.cf file and specify one or more lookup tables, separated
@@ -707,9 +707,9 @@ implement distribution lists, or to direct mail for standard aliases such as
 postmaster to real people. The table can also be used to map
 "Firstname.Lastname" addresses to login names.
 
-Note: local aliasing (alias_maps) applies only to local(8) delivery. This is
-unlike virtual aliasing (virtual_alias_maps) which applies to all email
-deliveries: local(8), virtual, and remote.
+Note: local aliasing (alias_maps) applies only to local(8) recipients. This is
+unlike virtual aliasing (virtual_alias_maps) which applies to all recipients:
+local(8), virtual, and remote.
 
 Alias lookups are enabled by default. The default configuration depends on the
 operating system environment, but it is typically one of the following:
index 2a764c4d0359f352db08d6ed2a91f015fff0f8bd..8200ca49bb647560da588b806128344831c6edaa 100644 (file)
 # 
 # DESCRIPTION
 #        The  optional  virtual(5) alias table (virtual_alias_maps)
-#        rewrites all recipients: local(8),  virtual,  and  remote.
+#        applies to all recipients: local(8), virtual, and  remote.
 #        This feature is implemented in the Postfix cleanup(8) dae-
 #        mon before mail is queued.
 # 
-#        This is unlike the aliases(5) table (alias_maps) which  is
-#        used only for local(8) delivery.
+#        This is unlike the  aliases(5)  table  (alias_maps)  which
+#        applies only to local(8) recipients.
 # 
 #        Virtual  aliasing is recursive; to terminate recursion for
 #        a specific address, alias that address to itself.
 # 
 #        virtual_alias_maps ($virtual_maps)
 #               Optional lookup tables with aliases that  apply  to
-#               all   email   deliveries:  local(8),  virtual,  and
-#               remote,  unlike  alias_maps  that  apply  only   to
-#               local(8) delivery.
+#               all recipients: local(8), virtual, and remote; this
+#               is unlike alias_maps that apply  only  to  local(8)
+#               recipients.
 # 
 #        virtual_alias_domains ($virtual_alias_maps)
 #               Postfix  is the final destination for the specified
index 6377f3c60ec736e36ab07ca84f4a37c210cd036b..c92a314bdb1e7574f0becb7bc4ed7ee2386da722 100644 (file)
@@ -771,9 +771,10 @@ may be a more appropriate vehicle. See the <a href="VIRTUAL_README.html">VIRTUAL
 for an overview of methods to host virtual domains with Postfix.
 </p>
 
-<p> Note: <a href="ADDRESS_REWRITING_README.html#virtual">virtual aliasing</a> (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>) applies to all email
-deliveries: <a href="local.8.html">local(8)</a>, virtual, and remote. This is unlike local
-aliasing (<a href="postconf.5.html#alias_maps">alias_maps</a>) which applies only to <a href="local.8.html">local(8)</a> delivery.  </p>
+<p> Note: <a href="ADDRESS_REWRITING_README.html#virtual">virtual aliasing</a> (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>) applies to all
+recipients: <a href="local.8.html">local(8)</a>, virtual, and remote.  <!-- wrap filler -->
+This is unlike <a href="ADDRESS_REWRITING_README.html#aliases">local aliasing</a> (<a href="postconf.5.html#alias_maps">alias_maps</a>) which applies only to
+<a href="local.8.html">local(8)</a> recipients. </p>
 
 <p> Virtual aliasing is disabled by default. To enable, edit the
 <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> parameter in the <a href="postconf.5.html">main.cf</a> file and
@@ -1061,8 +1062,8 @@ The table can also be used to map "Firstname.Lastname" addresses
 to login names. </p>
 
 <p> Note: <a href="ADDRESS_REWRITING_README.html#aliases">local aliasing</a> (<a href="postconf.5.html#alias_maps">alias_maps</a>) applies only to <a href="local.8.html">local(8)</a>
-delivery. This is  unlike <a href="ADDRESS_REWRITING_README.html#virtual">virtual aliasing</a> (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>)
-which applies to all email deliveries: <a href="local.8.html">local(8)</a>, virtual, and remote.
+recipients. This is  unlike <a href="ADDRESS_REWRITING_README.html#virtual">virtual aliasing</a> (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>)
+which applies to all recipients: <a href="local.8.html">local(8)</a>, virtual, and remote.
 </p>
 
 <p> Alias lookups are enabled by default. The default configuration
index 05f32cd4e313691cb9d4e323cebc2e3b82a81ef8..6ee8804e463c855753972d44441ec9b6a083b6c1 100644 (file)
@@ -343,9 +343,9 @@ CLEANUP(8)                                                          CLEANUP(8)
        Available in Postfix version 2.0 and later:
 
        <b><a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> ($<a href="postconf.5.html#virtual_maps">virtual_maps</a>)</b>
-              Optional  lookup  tables  with  aliases  that apply to all email
-              deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual,  and  remote,  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
-              that apply only to <a href="local.8.html"><b>local</b>(8)</a> delivery.
+              Optional  lookup  tables  with aliases that apply to all recipi-
+              ents: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote; this is  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
+              that apply only to <a href="local.8.html"><b>local</b>(8)</a> recipients.
 
        Available in Postfix version 2.2 and later:
 
index 4c3d4a9f9f24cb5b48b01c30f94e40cde27dab28..2c80b0e675ff87381717dc2bb358efe6f2a0aa0c 100644 (file)
@@ -383,8 +383,8 @@ LOCAL(8)                                                              LOCAL(8)
 
        <b><a href="postconf.5.html#alias_maps">alias_maps</a> (see 'postconf -d' output)</b>
               Optional  lookup tables with aliases that apply only to <a href="local.8.html"><b>local</b>(8)</a>
-              delivery, unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>  that  apply  to  all  email
-              deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote.
+              recipients; this is unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> that apply to  all
+              recipients: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote.
 
        <b><a href="postconf.5.html#forward_path">forward_path</a> (see 'postconf -d' output)</b>
               The  <a href="local.8.html"><b>local</b>(8)</a>  delivery agent search list for finding a .forward
index af20b7679102057e028ab28bd2ea164f1b46073a..4426f727b9bcaac3eb03d2a61301a89728ea5bac 100644 (file)
@@ -613,8 +613,8 @@ Examples:
 
 <p>
 Optional lookup tables with aliases that apply only to <a href="local.8.html">local(8)</a>
-delivery, unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> that apply to all email deliveries:
-<a href="local.8.html">local(8)</a>, virtual, and remote.
+recipients; this is unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> that apply to all
+recipients: <a href="local.8.html">local(8)</a>, virtual, and remote.
 The table format and lookups are documented in <a href="aliases.5.html">aliases(5)</a>. For an
 overview of Postfix address manipulations see the <a href="ADDRESS_REWRITING_README.html">ADDRESS_REWRITING_README</a>
 document. </p>
@@ -4134,14 +4134,17 @@ Specify 0 to disable the feature. Valid delays are 0..10.
 <DT><b><a name="inet_interfaces">inet_interfaces</a>
 (default: all)</b></DT><DD>
 
-<p> The local network interface addresses that this mail system receives
-mail on. Specify "all" to receive mail on all network
-interfaces (default), and "loopback-only" to receive mail
-on loopback network interfaces only (Postfix version 2.2 and later).  The
-parameter also controls delivery of mail to <tt>user@[ip.address]</tt>.
-Specify an empty value if Postfix does not receive mail over the network,
-or if all network listeners have an explicit IP address in <a href="master.5.html">master.cf</a>.
-</p>
+<p> The local network interface addresses that this mail system
+receives mail on. Specify "all" to receive mail on all network
+interfaces (default), "loopback-only" to receive mail on loopback
+network interfaces only (Postfix version 2.2 and later), or zero
+or more IPv4 or IPv6 addresses (IPv6 is supported in Postfix version
+2.2 and later). The parameter also controls whether Postfix will
+accept mail for <tt>user@[ip.address]</tt>, and prevents Postfix
+from delivering mail to a host that has equal or larger MX preference.
+Specify an empty value if Postfix does not receive mail over the
+network, or if all network listeners have an explicit IP address
+in <a href="master.5.html">master.cf</a>. </p>
 
 <p>
 Note 1: you need to stop and start Postfix when this parameter changes.
@@ -4152,7 +4155,13 @@ but this form is not required here. </p>
 
 <p> When <a href="postconf.5.html#smtp_bind_address">smtp_bind_address</a> and/or <a href="postconf.5.html#smtp_bind_address6">smtp_bind_address6</a> are not
 specified, the <a href="postconf.5.html#inet_interfaces">inet_interfaces</a> setting may constrain the source IP
-address for an outbound SMTP or LMTP connection. </p>
+address for an outbound SMTP or LMTP connection as described below.
+</p>
+
+<p> The following text is specific to SMTP and IPv4. The same
+reasoning applies to the IPv6 protocol, and to the Postfix LMTP
+client. To disable IPv4 or IPv6 support in the Postfix SMTP and
+LMTP client, use <a href="postconf.5.html#inet_protocols">inet_protocols</a>. </p>
 
 <ul>
 
@@ -4167,10 +4176,6 @@ where it specifies <b>all</b>, or where it contains no IPv4 address,
 one IPv4 address that is a loopback address, or multiple IPv4
 addresses.  </p>
 
-<li> <p> The same reasoning as above applies to the IPv6 protocol,
-and to the Postfix LMTP client. To disable IPv4 or IPv6 support in
-the Postfix SMTP and LMTP client, use <a href="postconf.5.html#inet_protocols">inet_protocols</a>. </p>
-
 </ul>
 
 <p> A Postfix SMTP client may fail to reach some remote SMTP servers
@@ -21620,9 +21625,9 @@ This feature is available in Postfix 2.1 and later.
 (default: $<a href="postconf.5.html#virtual_maps">virtual_maps</a>)</b></DT><DD>
 
 <p>
-Optional lookup tables with aliases that apply to all email deliveries:
-<a href="local.8.html">local(8)</a>, virtual, and remote, unlike <a href="postconf.5.html#alias_maps">alias_maps</a> that apply only
-to <a href="local.8.html">local(8)</a> delivery.
+Optional lookup tables with aliases that apply to all recipients:
+<a href="local.8.html">local(8)</a>, virtual, and remote; this is unlike <a href="postconf.5.html#alias_maps">alias_maps</a> that apply
+only to <a href="local.8.html">local(8)</a> recipients.
 The table format and lookups
 are documented in <a href="virtual.5.html">virtual(5)</a>. For an overview of Postfix address
 manipulations see the <a href="ADDRESS_REWRITING_README.html">ADDRESS_REWRITING_README</a> document.
index 87fa7e115f6d0f639209ded233dc5aac3813d5ad..b8a03a0a3de6b48beb434d79332f8c4064e18f3c 100644 (file)
@@ -831,9 +831,9 @@ SMTPD(8)                                                              SMTPD(8)
               aliased to addresses in other local or remote domains.
 
        <b><a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> ($<a href="postconf.5.html#virtual_maps">virtual_maps</a>)</b>
-              Optional  lookup  tables  with  aliases  that apply to all email
-              deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual,  and  remote,  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
-              that apply only to <a href="local.8.html"><b>local</b>(8)</a> delivery.
+              Optional  lookup  tables  with aliases that apply to all recipi-
+              ents: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote; this is  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
+              that apply only to <a href="local.8.html"><b>local</b>(8)</a> recipients.
 
        <b><a href="postconf.5.html#unknown_virtual_alias_reject_code">unknown_virtual_alias_reject_code</a> (550)</b>
               The  Postfix  SMTP  server  reply  code when a recipient address
index 35a82f91c7646b9ecbcbad1bb5c026126d61ada9..c1c6eceaf92aec9ee96053e107eccecf82c2658b 100644 (file)
@@ -18,12 +18,12 @@ VIRTUAL(5)                                                          VIRTUAL(5)
        <b>postmap -q - /etc/postfix/virtual</b> &lt;<i>inputfile</i>
 
 <b>DESCRIPTION</b>
-       The  optional  <a href="virtual.5.html"><b>virtual</b>(5)</a> alias table (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>) rewrites all
+       The optional <a href="virtual.5.html"><b>virtual</b>(5)</a> alias table (<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>) applies to all
        recipients: <a href="local.8.html">local(8)</a>, virtual, and remote.  This feature is implemented
        in the Postfix <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon before mail is queued.
 
-       This is unlike the <a href="aliases.5.html"><b>aliases</b>(5)</a> table (<a href="postconf.5.html#alias_maps">alias_maps</a>) which is used only for
-       <a href="local.8.html"><b>local</b>(8)</a> delivery.
+       This  is unlike the <a href="aliases.5.html"><b>aliases</b>(5)</a> table (<a href="postconf.5.html#alias_maps">alias_maps</a>) which applies only to
+       <a href="local.8.html"><b>local</b>(8)</a> recipients.
 
        Virtual aliasing is recursive; to terminate recursion  for  a  specific
        address, alias that address to itself.
@@ -231,9 +231,9 @@ VIRTUAL(5)                                                          VIRTUAL(5)
        Use the "<b>postfix reload</b>" command after a configuration change.
 
        <b><a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> ($<a href="postconf.5.html#virtual_maps">virtual_maps</a>)</b>
-              Optional  lookup  tables  with  aliases  that apply to all email
-              deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual,  and  remote,  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
-              that apply only to <a href="local.8.html"><b>local</b>(8)</a> delivery.
+              Optional  lookup  tables  with aliases that apply to all recipi-
+              ents: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote; this is  unlike  <a href="postconf.5.html#alias_maps">alias_maps</a>
+              that apply only to <a href="local.8.html"><b>local</b>(8)</a> recipients.
 
        <b><a href="postconf.5.html#virtual_alias_domains">virtual_alias_domains</a> ($<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>)</b>
               Postfix  is the final destination for the specified list of vir-
index 282f9a1d8325c5466594bb6c60250d108a0409cc..bc0822bc011407f6a113106003cf3203ef8cc128 100644 (file)
@@ -359,8 +359,8 @@ alias_database = hash:/etc/mail/aliases
 .ft R
 .SH alias_maps (default: see "postconf \-d" output)
 Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
-delivery, unlike virtual_alias_maps that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote.
+recipients; this is unlike virtual_alias_maps that apply to all
+recipients: \fBlocal\fR(8), virtual, and remote.
 The table format and lookups are documented in \fBaliases\fR(5). For an
 overview of Postfix address manipulations see the ADDRESS_REWRITING_README
 document.
@@ -2613,13 +2613,17 @@ number of messages delivered per second.
 .PP
 Specify 0 to disable the feature. Valid delays are 0..10.
 .SH inet_interfaces (default: all)
-The local network interface addresses that this mail system receives
-mail on. Specify "all" to receive mail on all network
-interfaces (default), and "loopback\-only" to receive mail
-on loopback network interfaces only (Postfix version 2.2 and later).  The
-parameter also controls delivery of mail to user@[ip.address].
-Specify an empty value if Postfix does not receive mail over the network,
-or if all network listeners have an explicit IP address in master.cf.
+The local network interface addresses that this mail system
+receives mail on. Specify "all" to receive mail on all network
+interfaces (default), "loopback\-only" to receive mail on loopback
+network interfaces only (Postfix version 2.2 and later), or zero
+or more IPv4 or IPv6 addresses (IPv6 is supported in Postfix version
+2.2 and later). The parameter also controls whether Postfix will
+accept mail for user@[ip.address], and prevents Postfix
+from delivering mail to a host that has equal or larger MX preference.
+Specify an empty value if Postfix does not receive mail over the
+network, or if all network listeners have an explicit IP address
+in master.cf.
 .PP
 Note 1: you need to stop and start Postfix when this parameter changes.
 .PP
@@ -2628,7 +2632,12 @@ but this form is not required here.
 .PP
 When smtp_bind_address and/or smtp_bind_address6 are not
 specified, the inet_interfaces setting may constrain the source IP
-address for an outbound SMTP or LMTP connection.
+address for an outbound SMTP or LMTP connection as described below.
+.PP
+The following text is specific to SMTP and IPv4. The same
+reasoning applies to the IPv6 protocol, and to the Postfix LMTP
+client. To disable IPv4 or IPv6 support in the Postfix SMTP and
+LMTP client, use inet_protocols.
 .IP \(bu
 When inet_interfaces specifies one IPv4 address, and that
 is not a loopback address, the Postfix SMTP client uses that as the
@@ -2640,10 +2649,6 @@ address. This includes the cases where inet_interfaces is empty,
 where it specifies \fBall\fR, or where it contains no IPv4 address,
 one IPv4 address that is a loopback address, or multiple IPv4
 addresses.
-.IP \(bu
-The same reasoning as above applies to the IPv6 protocol,
-and to the Postfix LMTP client. To disable IPv4 or IPv6 support in
-the Postfix SMTP and LMTP client, use inet_protocols.
 .br
 .PP
 A Postfix SMTP client may fail to reach some remote SMTP servers
@@ -15229,9 +15234,9 @@ from each original recipient.
 .PP
 This feature is available in Postfix 2.1 and later.
 .SH virtual_alias_maps (default: $virtual_maps)
-Optional lookup tables with aliases that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-to \fBlocal\fR(8) delivery.
+Optional lookup tables with aliases that apply to all recipients:
+\fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+only to \fBlocal\fR(8) recipients.
 The table format and lookups
 are documented in \fBvirtual\fR(5). For an overview of Postfix address
 manipulations see the ADDRESS_REWRITING_README document.
index d7c08f00e4701c8a8e07194e30276fcc388028db..e03a500082847bea43cccb75f8a3f6c96e17772a 100644 (file)
@@ -17,12 +17,12 @@ Postfix virtual alias table format
 .ad
 .fi
 The optional \fBvirtual\fR(5) alias table (virtual_alias_maps)
-rewrites all recipients: local(8), virtual, and remote.
+applies to all recipients: local(8), virtual, and remote.
 This feature is implemented
 in the Postfix \fBcleanup\fR(8) daemon before mail is queued.
 
 This is unlike the \fBaliases\fR(5) table (alias_maps) which
-is used only for \fBlocal\fR(8) delivery.
+applies only to \fBlocal\fR(8) recipients.
 
 Virtual aliasing is recursive; to terminate recursion for
 a specific address, alias that address to itself.
@@ -271,9 +271,9 @@ this topic. See the Postfix \fBmain.cf\fR file for syntax details
 and for default values. Use the "\fBpostfix reload\fR" command after
 a configuration change.
 .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-Optional lookup tables with aliases that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-to \fBlocal\fR(8) delivery.
+Optional lookup tables with aliases that apply to all recipients:
+\fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+only to \fBlocal\fR(8) recipients.
 .IP "\fBvirtual_alias_domains ($virtual_alias_maps)\fR"
 Postfix is the final destination for the specified list of virtual
 alias domains, that is, domains for which all addresses are aliased
@@ -284,8 +284,8 @@ key to the lookup result.
 .PP
 Other parameters of interest:
 .IP "\fBinet_interfaces (all)\fR"
-The local network interface addresses that this mail system receives
-mail on.
+The local network interface addresses that this mail system
+receives mail on.
 .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 The list of domains that are delivered via the $local_transport
 mail delivery transport.
index 253c142b05b8b8d9e8ff172d53a7d46d5d527ff0..a6bec00c03eb54ad0f8c165b9cbf8a61c01f206c 100644 (file)
@@ -321,9 +321,9 @@ remote domains.
 .PP
 Available in Postfix version 2.0 and later:
 .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-Optional lookup tables with aliases that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-to \fBlocal\fR(8) delivery.
+Optional lookup tables with aliases that apply to all recipients:
+\fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+only to \fBlocal\fR(8) recipients.
 .PP
 Available in Postfix version 2.2 and later:
 .IP "\fBcanonical_classes (envelope_sender, envelope_recipient, header_sender, header_recipient)\fR"
index 91bceea3e299022d822abf778bc41dab0b8ed0fa..7bba0300b5a5b7aa9048f3d262167918080fcb79 100644 (file)
@@ -450,8 +450,8 @@ home_mailbox, mail_spool_directory, fallback_transport_maps,
 fallback_transport, and luser_relay.
 .IP "\fBalias_maps (see 'postconf -d' output)\fR"
 Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
-delivery, unlike virtual_alias_maps that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote.
+recipients; this is unlike virtual_alias_maps that apply to all
+recipients: \fBlocal\fR(8), virtual, and remote.
 .IP "\fBforward_path (see 'postconf -d' output)\fR"
 The \fBlocal\fR(8) delivery agent search list for finding a .forward
 file with user\-specified delivery methods.
index e7c23911422eb05296733ce3e662831365bb66b5..ea070e1efbf6d5421bc9f708d0005ca080d6fef1 100644 (file)
@@ -699,8 +699,8 @@ Parameters concerning known/unknown local recipients:
 The list of domains that are delivered via the $local_transport
 mail delivery transport.
 .IP "\fBinet_interfaces (all)\fR"
-The local network interface addresses that this mail system receives
-mail on.
+The local network interface addresses that this mail system
+receives mail on.
 .IP "\fBproxy_interfaces (empty)\fR"
 The remote network interface addresses that this mail system receives mail
 on by way of a proxy or network address translation unit.
@@ -735,9 +735,9 @@ Postfix is the final destination for the specified list of virtual
 alias domains, that is, domains for which all addresses are aliased
 to addresses in other local or remote domains.
 .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-Optional lookup tables with aliases that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-to \fBlocal\fR(8) delivery.
+Optional lookup tables with aliases that apply to all recipients:
+\fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+only to \fBlocal\fR(8) recipients.
 .IP "\fBunknown_virtual_alias_reject_code (550)\fR"
 The Postfix SMTP server reply code when a recipient address matches
 $virtual_alias_domains, and $virtual_alias_maps specifies a list
index eaeb24973815eaf541f636e68056e77db41a3163..631a7d3c62bd628aa92eda880cfabc02fa657b65 100644 (file)
@@ -771,9 +771,10 @@ may be a more appropriate vehicle. See the VIRTUAL_README document
 for an overview of methods to host virtual domains with Postfix.
 </p>
 
-<p> Note: virtual aliasing (virtual_alias_maps) applies to all email
-deliveries: local(8), virtual, and remote. This is unlike local
-aliasing (alias_maps) which applies only to local(8) delivery.  </p>
+<p> Note: virtual aliasing (virtual_alias_maps) applies to all
+recipients: local(8), virtual, and remote.  <!-- wrap filler -->
+This is unlike local aliasing (alias_maps) which applies only to
+local(8) recipients. </p>
 
 <p> Virtual aliasing is disabled by default. To enable, edit the
 virtual_alias_maps parameter in the main.cf file and
@@ -1061,8 +1062,8 @@ The table can also be used to map "Firstname.Lastname" addresses
 to login names. </p>
 
 <p> Note: local aliasing (alias_maps) applies only to local(8)
-delivery. This is  unlike virtual aliasing (virtual_alias_maps)
-which applies to all email deliveries: local(8), virtual, and remote.
+recipients. This is  unlike virtual aliasing (virtual_alias_maps)
+which applies to all recipients: local(8), virtual, and remote.
 </p>
 
 <p> Alias lookups are enabled by default. The default configuration
index 9d03bcb6588e279316d5204dcec0329eb3c2e57d..0604d24136db7d7ee1f076cfe49781c8424cb69c 100644 (file)
@@ -490,8 +490,8 @@ alias_database = hash:/etc/mail/aliases
 
 <p>
 Optional lookup tables with aliases that apply only to local(8)
-delivery, unlike virtual_alias_maps that apply to all email deliveries:
-local(8), virtual, and remote.
+recipients; this is unlike virtual_alias_maps that apply to all
+recipients: local(8), virtual, and remote.
 The table format and lookups are documented in aliases(5). For an
 overview of Postfix address manipulations see the ADDRESS_REWRITING_README
 document. </p>
@@ -2013,14 +2013,17 @@ Specify 0 to disable the feature. Valid delays are 0..10.
 
 %PARAM inet_interfaces all
 
-<p> The local network interface addresses that this mail system receives
-mail on. Specify "all" to receive mail on all network
-interfaces (default), and "loopback-only" to receive mail
-on loopback network interfaces only (Postfix version 2.2 and later).  The
-parameter also controls delivery of mail to <tt>user@[ip.address]</tt>.
-Specify an empty value if Postfix does not receive mail over the network,
-or if all network listeners have an explicit IP address in master.cf.
-</p>
+<p> The local network interface addresses that this mail system
+receives mail on. Specify "all" to receive mail on all network
+interfaces (default), "loopback-only" to receive mail on loopback
+network interfaces only (Postfix version 2.2 and later), or zero
+or more IPv4 or IPv6 addresses (IPv6 is supported in Postfix version
+2.2 and later). The parameter also controls whether Postfix will
+accept mail for <tt>user@[ip.address]</tt>, and prevents Postfix
+from delivering mail to a host that has equal or larger MX preference.
+Specify an empty value if Postfix does not receive mail over the
+network, or if all network listeners have an explicit IP address
+in master.cf. </p>
 
 <p>
 Note 1: you need to stop and start Postfix when this parameter changes.
@@ -2031,7 +2034,13 @@ but this form is not required here. </p>
 
 <p> When smtp_bind_address and/or smtp_bind_address6 are not
 specified, the inet_interfaces setting may constrain the source IP
-address for an outbound SMTP or LMTP connection. </p>
+address for an outbound SMTP or LMTP connection as described below.
+</p>
+
+<p> The following text is specific to SMTP and IPv4. The same
+reasoning applies to the IPv6 protocol, and to the Postfix LMTP
+client. To disable IPv4 or IPv6 support in the Postfix SMTP and
+LMTP client, use inet_protocols. </p>
 
 <ul>
 
@@ -2046,10 +2055,6 @@ where it specifies <b>all</b>, or where it contains no IPv4 address,
 one IPv4 address that is a loopback address, or multiple IPv4
 addresses.  </p>
 
-<li> <p> The same reasoning as above applies to the IPv6 protocol,
-and to the Postfix LMTP client. To disable IPv4 or IPv6 support in
-the Postfix SMTP and LMTP client, use inet_protocols. </p>
-
 </ul>
 
 <p> A Postfix SMTP client may fail to reach some remote SMTP servers
@@ -7285,9 +7290,9 @@ This feature is available in Postfix 2.1 and later.
 %PARAM virtual_alias_maps $virtual_maps
 
 <p>
-Optional lookup tables with aliases that apply to all email deliveries:
-local(8), virtual, and remote, unlike alias_maps that apply only
-to local(8) delivery.
+Optional lookup tables with aliases that apply to all recipients:
+local(8), virtual, and remote; this is unlike alias_maps that apply
+only to local(8) recipients.
 The table format and lookups
 are documented in virtual(5). For an overview of Postfix address
 manipulations see the ADDRESS_REWRITING_README document.
index 670f570e0212e37d3b4ac424040b5f82c8548043..e1935f00be05efc8d7ece9b7ce07dd4cdfce1ba7 100644 (file)
 #      \fBpostmap -q - /etc/postfix/virtual <\fIinputfile\fR
 # DESCRIPTION
 #      The optional \fBvirtual\fR(5) alias table (virtual_alias_maps)
-#      rewrites all recipients: local(8), virtual, and remote.
+#      applies to all recipients: local(8), virtual, and remote.
 #      This feature is implemented
 #      in the Postfix \fBcleanup\fR(8) daemon before mail is queued.
 #
 #      This is unlike the \fBaliases\fR(5) table (alias_maps) which
-#      is used only for \fBlocal\fR(8) delivery.
+#      applies only to \fBlocal\fR(8) recipients.
 #
 #      Virtual aliasing is recursive; to terminate recursion for
 #      a specific address, alias that address to itself.
 #      and for default values. Use the "\fBpostfix reload\fR" command after
 #      a configuration change.
 # .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-#      Optional lookup tables with aliases that apply to all email deliveries:
-#      \fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-#      to \fBlocal\fR(8) delivery.
+#      Optional lookup tables with aliases that apply to all recipients:
+#      \fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+#      only to \fBlocal\fR(8) recipients.
 # .IP "\fBvirtual_alias_domains ($virtual_alias_maps)\fR"
 #      Postfix is the final destination for the specified list of virtual
 #      alias domains, that is, domains for which all addresses are aliased
 # .PP
 #      Other parameters of interest:
 # .IP "\fBinet_interfaces (all)\fR"
-#      The local network interface addresses that this mail system receives
-#      mail on.
+#      The local network interface addresses that this mail system
+#      receives mail on.
 # .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 #      The list of domains that are delivered via the $local_transport
 #      mail delivery transport.
index 6346c4fad9b7e95265bdff1b44e8e687fb50e0e4..b1f475dccc8d62121d3b662ac4d51f3d135c40a4 100644 (file)
 /* .PP
 /*     Available in Postfix version 2.0 and later:
 /* .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-/*     Optional lookup tables with aliases that apply to all email deliveries:
-/*     \fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-/*     to \fBlocal\fR(8) delivery.
+/*     Optional lookup tables with aliases that apply to all recipients:
+/*     \fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+/*     only to \fBlocal\fR(8) recipients.
 /* .PP
 /*     Available in Postfix version 2.2 and later:
 /* .IP "\fBcanonical_classes (envelope_sender, envelope_recipient, header_sender, header_recipient)\fR"
index 1fd879e897d885b491cf40258570c1f698e38d68..aadda27714957cb0cd46f5aff6f86c1eb4392652 100644 (file)
@@ -20,7 +20,7 @@
   * Patches change both the patchlevel and the release date. Snapshots have no
   * patchlevel; they change the release date only.
   */
-#define MAIL_RELEASE_DATE      "20230507"
+#define MAIL_RELEASE_DATE      "20230508"
 #define MAIL_VERSION_NUMBER    "3.9"
 
 #ifdef SNAPSHOT
index ca03e8086550781e3f18ec4bfffaabefa9192d4b..6fa211ed7794c15fd0f88022dad98c7aecb8ca75 100644 (file)
 /*     fallback_transport, and luser_relay.
 /* .IP "\fBalias_maps (see 'postconf -d' output)\fR"
 /*     Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
-/*     delivery, unlike virtual_alias_maps that apply to all email deliveries:
-/*     \fBlocal\fR(8), virtual, and remote.
+/*     recipients; this is unlike virtual_alias_maps that apply to all
+/*     recipients: \fBlocal\fR(8), virtual, and remote.
 /* .IP "\fBforward_path (see 'postconf -d' output)\fR"
 /*     The \fBlocal\fR(8) delivery agent search list for finding a .forward
 /*     file with user-specified delivery methods.
index 44c3694f366cb7623cb1edaa86c8f82bddf31e9b..d498e38333b352051698a039cdf79952c0b95281 100644 (file)
 /*     The list of domains that are delivered via the $local_transport
 /*     mail delivery transport.
 /* .IP "\fBinet_interfaces (all)\fR"
-/*     The local network interface addresses that this mail system receives
-/*     mail on.
+/*     The local network interface addresses that this mail system
+/*     receives mail on.
 /* .IP "\fBproxy_interfaces (empty)\fR"
 /*     The remote network interface addresses that this mail system receives mail
 /*     on by way of a proxy or network address translation unit.
 /*     alias domains, that is, domains for which all addresses are aliased
 /*     to addresses in other local or remote domains.
 /* .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
-/*     Optional lookup tables with aliases that apply to all email deliveries:
-/*     \fBlocal\fR(8), virtual, and remote, unlike alias_maps that apply only
-/*     to \fBlocal\fR(8) delivery.
+/*     Optional lookup tables with aliases that apply to all recipients:
+/*     \fBlocal\fR(8), virtual, and remote; this is unlike alias_maps that apply
+/*     only to \fBlocal\fR(8) recipients.
 /* .IP "\fBunknown_virtual_alias_reject_code (550)\fR"
 /*     The Postfix SMTP server reply code when a recipient address matches
 /*     $virtual_alias_domains, and $virtual_alias_maps specifies a list