mir/postfix
2
0
Fork 0
mirror of https://github.com/vdukhovni/postfix synced 2025-08-22 18:07:41 +00:00
Code Issues Releases Wiki Activity

postfix-3.9-20230507

Browse Source
This commit is contained in:
Wietse Venema 2023-05-07 00:00:00 -05:00 committed by Viktor Dukhovni
parent a80705f3d5
commit 571c79482d
36 changed files with 407 additions and 340 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
postfix/HISTORY
View File

@ -27133,3 +27133,20 @@ Apologies for any names omitted.
Usability: improved error message when master.cf specifies
a wild-card network listener (like "smtp inet ... smtpd")
while `inet_interfaces is empty. File: master/master_ent.c.
More documentation updates for local aliasing versus virtual
aliasing. Files: proto/aliases, proto/virtual, postfix/postfix.c.
20230506
Cleanup: simplified the master code to handle an empty
inet_interfaces setting. it is now closer to the original
code. Also documented what *_inet_addr_list() functions can
return an empty list. Files: master/master_ent.c,
global/own_inet_addr_list.c.
20230507
Documentation: fine tuning of text about local aliasing
versus virtual aliasing. Files: proto/postconf.proto,
proto/aliases, proto/virtual, proto/ADDRESS_REWRITING_README.html.

10
postfix/README_FILES/ADDRESS_REWRITING_README
View File

@ -489,8 +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,
unlike local aliasing (alias_maps) which applies only to local(8) delivery.
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.
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
@ -706,8 +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, unlike
virtual aliasing (virtual_alias_maps) which applies to all email deliveries.
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.
Alias lookups are enabled by default. The default configuration depends on the
operating system environment, but it is typically one of the following:

2
postfix/README_FILES/DATABASE_README
View File

@ -28,7 +28,7 @@ Examples of lookup tables that appear often in the Postfix documentation:
alias_maps = hash:/etc/postfix/aliases (local aliasing)
header_checks = regexp:/etc/postfix/header_checks (content filtering)
transport_maps = hash:/etc/postfix/transport (routing table)
virtual_alias_maps = hash:/etc/postfix/virtual (address rewriting)
virtual_alias_maps = hash:/etc/postfix/virtual (virtual aliasing)
All Postfix lookup tables store information as (key, value) pairs. This
interface may seem simplistic at first, but it turns out to be very powerful.

16
postfix/conf/aliases
View File

@ -45,9 +45,13 @@ decode: root
# newaliases
#
# DESCRIPTION
# The aliases(5) table provides a system-wide mechanism to
# redirect mail for local recipients. The redirections are
# processed by the Postfix local(8) delivery agent.
# The optional aliases(5) table (alias_maps) redirects mail
# for local recipients. The redirections are processed by
# the Postfix local(8) delivery agent.
#
# This is unlike virtual(5) aliasing (virtual_alias_maps)
# which applies to all recipients: local(8), virtual, and
# remote, and which is implemented by the cleanup(8) daemon.
#
# Normally, the aliases(5) table is specified as a text file
# that serves as input to the postalias(1) command. The
@ -195,8 +199,10 @@ decode: root
# updated with "newaliases" or with "sendmail -bi".
#
# alias_maps (see 'postconf -d' output)
# The alias databases that are used for local(8)
# delivery.
# Optional lookup tables with aliases that apply only
# to local(8) delivery, unlike virtual_alias_maps
# that apply to all email deliveries: local(8), vir-
# tual, and remote.
#
# allow_mail_to_commands (alias, forward)
# Restrict local(8) mail delivery to external com-

30
postfix/conf/virtual
View File

@ -11,12 +11,13 @@
# postmap -q - /etc/postfix/virtual <inputfile
#
# DESCRIPTION
# The optional virtual(5) alias table rewrites recipient
# addresses for all local, all virtual, and all remote mail
# destinations. This is unlike the aliases(5) table which
# is used only for local(8) delivery. This feature is imple-
# mented in the Postfix cleanup(8) daemon before mail is
# queued.
# The optional virtual(5) alias table (virtual_alias_maps)
# rewrites 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.
#
# Virtual aliasing is recursive; to terminate recursion for
# a specific address, alias that address to itself.
@ -255,9 +256,10 @@
# command after a configuration change.
#
# virtual_alias_maps ($virtual_maps)
# Optional lookup tables that alias specific mail
# addresses or domains to other local or remote
# addresses.
# 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.
#
# virtual_alias_domains ($virtual_alias_maps)
# Postfix is the final destination for the specified
@ -272,8 +274,8 @@
# Other parameters of interest:
#
# inet_interfaces (all)
# The network interface addresses that this mail sys-
# tem receives mail on.
# The local network interface addresses that this
# mail system receives mail on.
#
# mydestination ($myhostname, localhost.$mydomain, local-
# host)
@ -292,9 +294,9 @@
# the recipient_delimiter is set to "-".
#
# proxy_interfaces (empty)
# The network interface addresses that this mail sys-
# tem receives mail on by way of a proxy or network
# address translation unit.
# The remote network interface addresses that this
# mail system receives mail on by way of a proxy or
# network address translation unit.
#
# SEE ALSO
# cleanup(8), canonicalize and enqueue mail

9
postfix/html/ADDRESS_REWRITING_README.html
View File

@ -772,8 +772,8 @@ 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, 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> delivery. </p>
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> 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 +1061,9 @@ 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, 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. </p>
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.
</p>
<p> Alias lookups are enabled by default. The default configuration
depends on the operating system environment, but it is typically

2
postfix/html/DATABASE_README.html
View File

@ -59,7 +59,7 @@ documentation: </p>
<a href="postconf.5.html#alias_maps">alias_maps</a> = <a href="DATABASE_README.html#types">hash</a>:/etc/postfix/aliases (<a href="ADDRESS_REWRITING_README.html#aliases">local aliasing</a>)
<a href="postconf.5.html#header_checks">header_checks</a> = <a href="regexp_table.5.html">regexp</a>:/etc/postfix/header_checks (content filtering)
<a href="postconf.5.html#transport_maps">transport_maps</a> = <a href="DATABASE_README.html#types">hash</a>:/etc/postfix/transport (routing table)
<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> = <a href="DATABASE_README.html#types">hash</a>:/etc/postfix/virtual (address rewriting)
<a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> = <a href="DATABASE_README.html#types">hash</a>:/etc/postfix/virtual (<a href="ADDRESS_REWRITING_README.html#virtual">virtual aliasing</a>)
</pre>
</blockquote>

14
postfix/html/aliases.5.html
View File

@ -14,9 +14,13 @@ ALIASES(5) ALIASES(5)
<b>newaliases</b>
<b>DESCRIPTION</b>
The <a href="aliases.5.html"><b>aliases</b>(5)</a> table provides a system-wide mechanism to redirect mail
for local recipients. The redirections are processed by the Postfix
<a href="local.8.html"><b>local</b>(8)</a> delivery agent.
The optional <a href="aliases.5.html"><b>aliases</b>(5)</a> table (<a href="postconf.5.html#alias_maps">alias_maps</a>) redirects mail for local
recipients. The redirections are processed by the Postfix <a href="local.8.html"><b>local</b>(8)</a>
delivery agent.
This is unlike <a href="virtual.5.html"><b>virtual</b>(5)</a> aliasing (<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, and which is imple-
mented by the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon.
Normally, the <a href="aliases.5.html"><b>aliases</b>(5)</a> table is specified as a text file that serves
as input to the <a href="postalias.1.html"><b>postalias</b>(1)</a> command. The result, an indexed file in
@ -144,7 +148,9 @@ ALIASES(5) ALIASES(5)
"<b>newaliases</b>" or with "<b>sendmail -bi</b>".
<b><a href="postconf.5.html#alias_maps">alias_maps</a> (see 'postconf -d' output)</b>
The alias databases that are used for <a href="local.8.html"><b>local</b>(8)</a> delivery.
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.
<b><a href="postconf.5.html#allow_mail_to_commands">allow_mail_to_commands</a> (alias, forward)</b>
Restrict <a href="local.8.html"><b>local</b>(8)</a> mail delivery to external commands.

4
postfix/html/cleanup.8.html
View File

@ -344,8 +344,8 @@ CLEANUP(8) CLEANUP(8)
<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, 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> deliv-
ery.
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.
Available in Postfix version 2.2 and later:

2
postfix/html/local.8.html
View File

@ -384,7 +384,7 @@ 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.
deliveries: <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

8
postfix/html/postconf.5.html
View File

@ -613,7 +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.
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.
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>
@ -21619,8 +21620,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,
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 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.
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.

2
postfix/html/postfix-manuals.html
View File

@ -135,7 +135,7 @@ the following convention: </p>
<li> <a href="access.5.html">access(5)</a>, Postfix SMTP access control table
<li> <a href="aliases.5.html">aliases(5)</a>, Postfix alias database
<li> <a href="aliases.5.html">aliases(5)</a>, Postfix <a href="ADDRESS_REWRITING_README.html#aliases">local aliasing</a>
<li> <a href="canonical.5.html">canonical(5)</a>, Postfix input address rewriting

2
postfix/html/postfix.1.html
View File

@ -346,7 +346,7 @@ POSTFIX(1) POSTFIX(1)
Table-driven mechanisms:
<a href="access.5.html">access(5)</a>, Postfix SMTP access control table
<a href="aliases.5.html">aliases(5)</a>, Postfix alias database
<a href="aliases.5.html">aliases(5)</a>, Postfix <a href="ADDRESS_REWRITING_README.html#aliases">local aliasing</a>
<a href="canonical.5.html">canonical(5)</a>, Postfix input address rewriting
<a href="generic.5.html">generic(5)</a>, Postfix output address rewriting
<a href="header_checks.5.html">header_checks(5)</a>, <a href="header_checks.5.html">body_checks(5)</a>, Postfix content inspection

4
postfix/html/smtpd.8.html
View File

@ -832,8 +832,8 @@ SMTPD(8) SMTPD(8)
<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, 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> deliv-
ery.
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.
<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

29
postfix/html/virtual.5.html
View File

@ -18,11 +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 rewrites recipient addresses for
all local, all virtual, and all remote mail destinations. This is
unlike the <a href="aliases.5.html"><b>aliases</b>(5)</a> table which is used only for <a href="local.8.html"><b>local</b>(8)</a> delivery.
This feature is implemented in the Postfix <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon before
mail is queued.
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
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.
Virtual aliasing is recursive; to terminate recursion for a specific
address, alias that address to itself.
@ -149,12 +150,12 @@ VIRTUAL(5) VIRTUAL(5)
<b>VIRTUAL ALIAS DOMAINS</b>
Besides virtual aliases, the virtual alias table can also be used to
implement virtual alias domains. With a <a href="ADDRESS_CLASS_README.html#virtual_alias_class">virtual alias domain</a>, all
implement <a href="ADDRESS_CLASS_README.html#virtual_alias_class">virtual alias domains</a>. With a virtual alias domain, all
recipient addresses are aliased to addresses in other domains.
Virtual alias domains are not to be confused with the virtual mailbox
domains that are implemented with the Postfix <a href="virtual.8.html"><b>virtual</b>(8)</a> mail delivery
agent. With <a href="ADDRESS_CLASS_README.html#virtual_mailbox_class">virtual mailbox domains</a>, each recipient address can have
agent. With virtual mailbox domains, each recipient address can have
its own mailbox.
With a <a href="ADDRESS_CLASS_README.html#virtual_alias_class">virtual alias domain</a>, the virtual domain has its own user name
@ -230,8 +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 that alias specific mail addresses or
domains to other local or remote addresses.
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.
<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-
@ -245,8 +247,8 @@ VIRTUAL(5) VIRTUAL(5)
Other parameters of interest:
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b>
The network interface addresses that this mail system receives
mail on.
The local network interface addresses that this mail system
receives mail on.
<b><a href="postconf.5.html#mydestination">mydestination</a> ($<a href="postconf.5.html#myhostname">myhostname</a>, localhost.$<a href="postconf.5.html#mydomain">mydomain</a>, localhost)</b>
The list of domains that are delivered via the $<a href="postconf.5.html#local_transport">local_transport</a>
@ -263,8 +265,9 @@ VIRTUAL(5) VIRTUAL(5)
set to "-".
<b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b>
The network interface addresses that this mail system receives
mail on by way of a proxy or network address translation unit.
The remote network interface addresses that this mail system
receives mail on by way of a proxy or network address transla-
tion unit.
<b>SEE ALSO</b>
<a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail

2
postfix/man/man1/postfix.1
View File

@ -317,7 +317,7 @@ postfix\-wrapper(5), Postfix multi\-instance API
Table\-driven mechanisms:
access(5), Postfix SMTP access control table
aliases(5), Postfix alias database
aliases(5), Postfix local aliasing
canonical(5), Postfix input address rewriting
generic(5), Postfix output address rewriting
header_checks(5), body_checks(5), Postfix content inspection

14
postfix/man/man5/aliases.5
View File

@ -13,9 +13,13 @@ Postfix local alias database format
.SH DESCRIPTION
.ad
.fi
The \fBaliases\fR(5) table provides a system\-wide mechanism to
redirect mail for local recipients. The redirections are
processed by the Postfix \fBlocal\fR(8) delivery agent.
The optional \fBaliases\fR(5) table (alias_maps) redirects
mail for local recipients. The redirections are processed
by the Postfix \fBlocal\fR(8) delivery agent.
This is unlike \fBvirtual\fR(5) aliasing (virtual_alias_maps)
which applies to all recipients: local(8), virtual, and remote,
and which is implemented by the \fBcleanup\fR(8) daemon.
Normally, the \fBaliases\fR(5) table is specified as a text file
that serves as input to the \fBpostalias\fR(1) command. The
@ -165,7 +169,9 @@ The text below provides only a parameter summary. See
The alias databases for \fBlocal\fR(8) delivery that are updated with
"\fBnewaliases\fR" or with "\fBsendmail \-bi\fR".
.IP "\fBalias_maps (see 'postconf -d' output)\fR"
The alias databases that are used for \fBlocal\fR(8) delivery.
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.
.IP "\fBallow_mail_to_commands (alias, forward)\fR"
Restrict \fBlocal\fR(8) mail delivery to external commands.
.IP "\fBallow_mail_to_files (alias, forward)\fR"

8
postfix/man/man5/postconf.5
View File

@ -359,7 +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.
delivery, unlike virtual_alias_maps that apply to all email deliveries:
\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.
@ -15228,8 +15229,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,
unlike alias_maps that apply only to \fBlocal\fR(8) delivery.
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.
The table format and lookups
are documented in \fBvirtual\fR(5). For an overview of Postfix address
manipulations see the ADDRESS_REWRITING_README document.

20
postfix/man/man5/virtual.5
View File

@ -16,13 +16,14 @@ Postfix virtual alias table format
.SH DESCRIPTION
.ad
.fi
The optional \fBvirtual\fR(5) alias table rewrites recipient
addresses for all local, all virtual, and all remote mail
destinations.
This is unlike the \fBaliases\fR(5) table which is used
only for \fBlocal\fR(8) delivery. This feature is implemented
The optional \fBvirtual\fR(5) alias table (virtual_alias_maps)
rewrites 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.
Virtual aliasing is recursive; to terminate recursion for
a specific address, alias that address to itself.
@ -270,8 +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 that alias specific mail addresses or domains
to other local or remote addresses.
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.
.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
@ -282,7 +284,7 @@ key to the lookup result.
.PP
Other parameters of interest:
.IP "\fBinet_interfaces (all)\fR"
The network interface addresses that this mail system receives
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
@ -296,7 +298,7 @@ Enable special treatment for owner\-\fIlistname\fR entries in the
\fIlistname\fR\-request address localparts when the recipient_delimiter
is set to "\-".
.IP "\fBproxy_interfaces (empty)\fR"
The network interface addresses that this mail system receives mail
The remote network interface addresses that this mail system receives mail
on by way of a proxy or network address translation unit.
.SH "SEE ALSO"
.na

5
postfix/man/man8/cleanup.8
View File

@ -321,8 +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,
unlike alias_maps that apply only to \fBlocal\fR(8) delivery.
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.
.PP
Available in Postfix version 2.2 and later:
.IP "\fBcanonical_classes (envelope_sender, envelope_recipient, header_sender, header_recipient)\fR"

3
postfix/man/man8/local.8
View File

@ -450,7 +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.
delivery, unlike virtual_alias_maps that apply to all email deliveries:
\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.

5
postfix/man/man8/smtpd.8
View File

@ -735,8 +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,
unlike alias_maps that apply only to \fBlocal\fR(8) delivery.
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.
.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

9
postfix/proto/ADDRESS_REWRITING_README.html
View File

@ -772,8 +772,8 @@ for an overview of methods to host virtual domains with Postfix.
</p>
<p> Note: virtual aliasing (virtual_alias_maps) applies to all email
deliveries, unlike local aliasing (alias_maps) which applies only
to local(8) delivery. </p>
deliveries: local(8), virtual, and remote. This is unlike local
aliasing (alias_maps) which applies only to local(8) delivery. </p>
<p> Virtual aliasing is disabled by default. To enable, edit the
virtual_alias_maps parameter in the main.cf file and
@ -1061,8 +1061,9 @@ 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, unlike virtual aliasing (virtual_alias_maps) which applies
to all email deliveries. </p>
delivery. This is unlike virtual aliasing (virtual_alias_maps)
which applies to all email deliveries: local(8), virtual, and remote.
</p>
<p> Alias lookups are enabled by default. The default configuration
depends on the operating system environment, but it is typically

2
postfix/proto/DATABASE_README.html
View File

@ -59,7 +59,7 @@ documentation: </p>
alias_maps = hash:/etc/postfix/aliases (local aliasing)
header_checks = regexp:/etc/postfix/header_checks (content filtering)
transport_maps = hash:/etc/postfix/transport (routing table)
virtual_alias_maps = hash:/etc/postfix/virtual (address rewriting)
virtual_alias_maps = hash:/etc/postfix/virtual (virtual aliasing)
</pre>
</blockquote>

14
postfix/proto/aliases
View File

@ -7,9 +7,13 @@
# .fi
# \fBnewaliases\fR
# DESCRIPTION
# The \fBaliases\fR(5) table provides a system-wide mechanism to
# redirect mail for local recipients. The redirections are
# processed by the Postfix \fBlocal\fR(8) delivery agent.
# The optional \fBaliases\fR(5) table (alias_maps) redirects
# mail for local recipients. The redirections are processed
# by the Postfix \fBlocal\fR(8) delivery agent.
#
# This is unlike \fBvirtual\fR(5) aliasing (virtual_alias_maps)
# which applies to all recipients: local(8), virtual, and remote,
# and which is implemented by the \fBcleanup\fR(8) daemon.
#
# Normally, the \fBaliases\fR(5) table is specified as a text file
# that serves as input to the \fBpostalias\fR(1) command. The
@ -149,7 +153,9 @@
# The alias databases for \fBlocal\fR(8) delivery that are updated with
# "\fBnewaliases\fR" or with "\fBsendmail -bi\fR".
# .IP "\fBalias_maps (see 'postconf -d' output)\fR"
# The alias databases that are used for \fBlocal\fR(8) delivery.
# 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.
# .IP "\fBallow_mail_to_commands (alias, forward)\fR"
# Restrict \fBlocal\fR(8) mail delivery to external commands.
# .IP "\fBallow_mail_to_files (alias, forward)\fR"

8
postfix/proto/postconf.proto
View File

@ -490,7 +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.
delivery, unlike virtual_alias_maps that apply to all email deliveries:
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>
@ -7284,8 +7285,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,
unlike alias_maps that apply only to local(8) delivery.
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.
The table format and lookups
are documented in virtual(5). For an overview of Postfix address
manipulations see the ADDRESS_REWRITING_README document.

3
postfix/proto/stop.double-history
View File

@ -45,3 +45,6 @@ proto proto ADDRESS_REWRITING_README html
cleanup cleanup c local local c smtpd smtpd c
cleanup cleanup c local local c smtpd smtpd c
cleanup cleanup c local local c smtpd smtpd c
postfix postfix c
aliasing Files proto aliases proto virtual postfix postfix c
proto proto aliases proto virtual proto ADDRESS_REWRITING_README html

1
postfix/proto/stop.double-proto-html
View File

@ -246,3 +246,4 @@ dt dt b name value b Postfix ge 3 0 dt
parametername stress something something Other
p Note on OpenBSD systems specify dev dev arandom when dev dev urandom
user3 example net smtp smtp relay example net submission
virtual_alias_maps hash etc postfix virtual virtual aliasing

20
postfix/proto/virtual
View File

@ -10,13 +10,14 @@
#
# \fBpostmap -q - /etc/postfix/virtual <\fIinputfile\fR
# DESCRIPTION
# The optional \fBvirtual\fR(5) alias table rewrites recipient
# addresses for all local, all virtual, and all remote mail
# destinations.
# This is unlike the \fBaliases\fR(5) table which is used
# only for \fBlocal\fR(8) delivery. This feature is implemented
# The optional \fBvirtual\fR(5) alias table (virtual_alias_maps)
# rewrites 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.
#
# Virtual aliasing is recursive; to terminate recursion for
# a specific address, alias that address to itself.
#
@ -244,8 +245,9 @@
# and for default values. Use the "\fBpostfix reload\fR" command after
# a configuration change.
# .IP "\fBvirtual_alias_maps ($virtual_maps)\fR"
# Optional lookup tables that alias specific mail addresses or domains
# to other local or remote addresses.
# 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.
# .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
@ -256,7 +258,7 @@
# .PP
# Other parameters of interest:
# .IP "\fBinet_interfaces (all)\fR"
# The network interface addresses that this mail system receives
# 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
@ -270,7 +272,7 @@
# \fIlistname\fR-request address localparts when the recipient_delimiter
# is set to "-".
# .IP "\fBproxy_interfaces (empty)\fR"
# The network interface addresses that this mail system receives mail
# The remote network interface addresses that this mail system receives mail
# on by way of a proxy or network address translation unit.
# SEE ALSO
# cleanup(8), canonicalize and enqueue mail

5
postfix/src/cleanup/cleanup.c
View File

@ -295,8 +295,9 @@
/* .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,
/* unlike alias_maps that apply only to \fBlocal\fR(8) delivery.
/* 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.
/* .PP
/* Available in Postfix version 2.2 and later:
/* .IP "\fBcanonical_classes (envelope_sender, envelope_recipient, header_sender, header_recipient)\fR"

2
postfix/src/global/mail_version.h
View 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 "20230505"
#define MAIL_RELEASE_DATE "20230507"
#define MAIL_VERSION_NUMBER "3.9"
#ifdef SNAPSHOT

2
postfix/src/global/wildcard_inet_addr.c
View File

@ -11,7 +11,7 @@
/* wildcard_inet_addr() determines all wild-card addresses
/* for all supported address families.
/* DIAGNOSTICS
/* Fatal errors: out of memory.
/* Fatal errors: out of memory; no wildcard addresses.
/* SEE ALSO
/* inet_addr_list(3) address list management
/* LICENSE

3
postfix/src/local/local.c
View File

@ -414,7 +414,8 @@
/* 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.
/* delivery, unlike virtual_alias_maps that apply to all email deliveries:
/* \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.

11
postfix/src/master/master_ent.c
View File

@ -367,17 +367,14 @@ MASTER_SERV *get_master_ent()
inet_addr_list_uniq(MASTER_INET_ADDRLIST(serv));
serv->listen_fd_count = MASTER_INET_ADDRLIST(serv)->used;
} else {
if (strcasecmp(saved_interfaces, INET_INTERFACES_ALL) == 0) {
MASTER_INET_ADDRLIST(serv) = wildcard_inet_addr_list();
/* Errors, and no interface found, are fatal. */
} else {
MASTER_INET_ADDRLIST(serv) = own_inet_addr_list();
/* Errors are fatal, but inet_interfaces can be empty. */
MASTER_INET_ADDRLIST(serv) =
strcasecmp(saved_interfaces, INET_INTERFACES_ALL) ?
own_inet_addr_list() : /* result can be empty */
wildcard_inet_addr_list(); /* result can't be empty */
if (MASTER_INET_ADDRLIST(serv)->used == 0)
fatal_with_context("service definition requires valid"
" host name or address, or non-empty"
" %s setting", VAR_INET_INTERFACES);
}
inet_addr_list_uniq(MASTER_INET_ADDRLIST(serv));
serv->listen_fd_count = MASTER_INET_ADDRLIST(serv)->used;
}

2
postfix/src/postfix/postfix.c
View File

@ -303,7 +303,7 @@
/*
/* Table-driven mechanisms:
/* access(5), Postfix SMTP access control table
/* aliases(5), Postfix alias database
/* aliases(5), Postfix local aliasing
/* canonical(5), Postfix input address rewriting
/* generic(5), Postfix output address rewriting
/* header_checks(5), body_checks(5), Postfix content inspection

5
postfix/src/smtpd/smtpd.c
View File

@ -691,8 +691,9 @@
/* 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,
/* unlike alias_maps that apply only to \fBlocal\fR(8) delivery.
/* 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.
/* .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