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.
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
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:
#
# 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
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
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
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:
<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
<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>
<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.
<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>
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
(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.
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
<b>postmap -q - /etc/postfix/virtual</b> <<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.
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-
.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.
.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
.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
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
.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.
.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.
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.
.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"
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.
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
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
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
<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>
%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.
<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>
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
%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.
# \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.
/* .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"
* 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
/* 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.
/* 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