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-20240125

Browse Source
This commit is contained in:
Wietse Venema 2024-01-25 00:00:00 -05:00 committed by Viktor Dukhovni
parent 0ed6849716
commit 261ef16d2f
52 changed files with 291 additions and 304 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
postfix/HISTORY
View File

@ -27760,3 +27760,15 @@ Apologies for any names omitted.
is readable, then it says that the socket has unread data, is readable, then it says that the socket has unread data,
and then it says that read returns EOF, causing Postfix to and then it says that read returns EOF, causing Postfix to
spam the log with a warning message. File: tlsmgr/tlsmgr.c. spam the log with a warning message. File: tlsmgr/tlsmgr.c.
20240125
Cleanup: tlsmgr.c fix 20240124. File: tlsmgr/tlsmgr.c.
Documentation: updated obsolete "CONFIGURATION PARAMETERS"
summaries in Postfix manpages, with current text from the
postconf(5) manpage. Files: proto/generic, proto/header_checks,
proto/aliases, proto/canonical, proto/relocated,
postdrop/postdrop.c, postsuper/postsuper.c, sendmail/sendmail.c,
dnsblog/dnsblog.c, postkick/postkick.c, postlock/postlock.c,
qmgr/qmgr.c, qmqpd/qmqpd.c, trivial-rewrite/trivial-rewrite.c.

6
postfix/conf/aliases
View File

@ -200,9 +200,9 @@ decode: root
# #
# alias_maps (see 'postconf -d' output) # alias_maps (see 'postconf -d' output)
# Optional lookup tables with aliases that apply only # Optional lookup tables with aliases that apply only
# to local(8) delivery, unlike virtual_alias_maps # to local(8) recipients; this is unlike vir-
# that apply to all email deliveries: local(8), vir- # tual_alias_maps that apply to all recipients:
# tual, and remote. # local(8), virtual, and remote.
# #
# allow_mail_to_commands (alias, forward) # allow_mail_to_commands (alias, forward)
# Restrict local(8) mail delivery to external com- # Restrict local(8) mail delivery to external com-

31
postfix/conf/canonical
View File

@ -225,22 +225,19 @@
# Other parameters of interest: # Other parameters of interest:
# #
# inet_interfaces (all) # inet_interfaces (all)
# The network interface addresses that this mail sys- # The local network interface addresses that this
# tem receives mail on. # mail system receives mail on.
# #
# local_header_rewrite_clients (permit_inet_interfaces) # local_header_rewrite_clients (permit_inet_interfaces)
# Rewrite message header addresses in mail from these # Rewrite or add message headers in mail from these
# clients and update incomplete addresses with the # clients, updating incomplete addresses with the
# domain name in $myorigin or $mydomain; either don't # domain name in $myorigin or $mydomain, and adding
# rewrite message headers from other clients at all, # missing headers.
# or rewrite message headers and update incomplete
# addresses with the domain specified in the
# remote_header_rewrite_domain parameter.
# #
# proxy_interfaces (empty) # proxy_interfaces (empty)
# The network interface addresses that this mail sys- # The remote network interface addresses that this
# tem receives mail on by way of a proxy or network # mail system receives mail on by way of a proxy or
# address translation unit. # network address translation unit.
# #
# masquerade_classes (envelope_sender, header_sender, # masquerade_classes (envelope_sender, header_sender,
# header_recipient) # header_recipient)
@ -272,10 +269,12 @@
# the recipient_delimiter is set to "-". # the recipient_delimiter is set to "-".
# #
# remote_header_rewrite_domain (empty) # remote_header_rewrite_domain (empty)
# Don't rewrite message headers from remote clients # Rewrite or add message headers in mail from remote
# at all when this parameter is empty; otherwise, re- # clients if the remote_header_rewrite_domain parame-
# write message headers and append the specified # ter value is non-empty, updating incomplete
# domain name to incomplete addresses. # addresses with the domain specified in the
# remote_header_rewrite_domain parameter, and adding
# missing headers.
# #
# SEE ALSO # SEE ALSO
# cleanup(8), canonicalize and enqueue mail # cleanup(8), canonicalize and enqueue mail

10
postfix/conf/generic
View File

@ -193,13 +193,13 @@
# Other parameters of interest: # Other parameters of interest:
# #
# inet_interfaces (all) # inet_interfaces (all)
# The network interface addresses that this mail sys- # The local network interface addresses that this
# tem receives mail on. # mail system receives mail on.
# #
# proxy_interfaces (empty) # proxy_interfaces (empty)
# The network interface addresses that this mail sys- # The remote network interface addresses that this
# tem receives mail on by way of a proxy or network # mail system receives mail on by way of a proxy or
# address translation unit. # network address translation unit.
# #
# mydestination ($myhostname, localhost.$mydomain, local- # mydestination ($myhostname, localhost.$mydomain, local-
# host) # host)

56
postfix/conf/header_checks
View File

@ -440,46 +440,32 @@
# tent-Length:, Return-Path:. # tent-Length:, Return-Path:.
# #
# CONFIGURATION PARAMETERS # CONFIGURATION PARAMETERS
# body_checks # body_checks (empty)
# Lookup tables with content filter rules for message # Optional lookup tables for content inspection as
# body lines. These filters see one physical line at # specified in the body_checks(5) manual page.
# a time, in chunks of at most $line_length_limit
# bytes.
# #
# body_checks_size_limit # body_checks_size_limit (51200)
# The amount of content per message body segment # How much text in a message body segment (or attach-
# (attachment) that is subjected to $body_checks fil- # ment, if you prefer to use that term) is subjected
# tering. # to body_checks inspection.
# #
# header_checks # header_checks (empty)
# Optional lookup tables for content inspection of
# primary non-MIME message headers, as specified in
# the header_checks(5) manual page.
# #
# mime_header_checks (default: $header_checks) # mime_header_checks ($header_checks)
# Optional lookup tables for content inspection of
# MIME related message headers, as described in the
# header_checks(5) manual page.
# #
# nested_header_checks (default: $header_checks) # nested_header_checks ($header_checks)
# Lookup tables with content filter rules for message # Optional lookup tables for content inspection of
# header lines: respectively, these are applied to # non-MIME message headers in attached messages, as
# the initial message headers (not including MIME # described in the header_checks(5) manual page.
# headers), to the MIME headers anywhere in the mes-
# sage, and to the initial headers of attached mes-
# sages.
# #
# Note: these filters see one logical message header # disable_mime_input_processing (no)
# at a time, even when a message header spans multi- # Turn off MIME processing while receiving mail.
# ple lines. Message headers that are longer than
# $header_size_limit characters are truncated.
#
# disable_mime_input_processing
# While receiving mail, give no special treatment to
# MIME related message headers; all text after the
# initial message headers is considered to be part of
# the message body. This means that header_checks is
# applied to all the initial message headers, and
# that body_checks is applied to the remainder of the
# message.
#
# Note: when used in this manner, body_checks will
# process a multi-line message header one line at a
# time.
# #
# EXAMPLES # EXAMPLES
# Header pattern to block attachments with bad file name # Header pattern to block attachments with bad file name

10
postfix/conf/relocated
View File

@ -131,8 +131,8 @@
# Other parameters of interest: # Other parameters of interest:
# #
# inet_interfaces (all) # inet_interfaces (all)
# The network interface addresses that this mail sys- # The local network interface addresses that this
# tem receives mail on. # mail system receives mail on.
# #
# mydestination ($myhostname, localhost.$mydomain, local- # mydestination ($myhostname, localhost.$mydomain, local-
# host) # host)
@ -145,9 +145,9 @@
# ered to. # ered to.
# #
# proxy_interfaces (empty) # proxy_interfaces (empty)
# The network interface addresses that this mail sys- # The remote network interface addresses that this
# tem receives mail on by way of a proxy or network # mail system receives mail on by way of a proxy or
# address translation unit. # network address translation unit.
# #
# SEE ALSO # SEE ALSO
# trivial-rewrite(8), address resolver # trivial-rewrite(8), address resolver

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

@ -149,8 +149,8 @@ ALIASES(5) ALIASES(5)
<b><a href="postconf.5.html#alias_maps">alias_maps</a> (see 'postconf -d' output)</b> <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> 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 recipients; this is unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> that apply to all
deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote. recipients: <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> <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. Restrict <a href="local.8.html"><b>local</b>(8)</a> mail delivery to external commands.

26
postfix/html/canonical.5.html
View File

@ -211,20 +211,18 @@ CANONICAL(5) CANONICAL(5)
Other parameters of interest: Other parameters of interest:
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b> <b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b>
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. receives mail on.
<b><a href="postconf.5.html#local_header_rewrite_clients">local_header_rewrite_clients</a> (<a href="postconf.5.html#permit_inet_interfaces">permit_inet_interfaces</a>)</b> <b><a href="postconf.5.html#local_header_rewrite_clients">local_header_rewrite_clients</a> (<a href="postconf.5.html#permit_inet_interfaces">permit_inet_interfaces</a>)</b>
Rewrite message header addresses in mail from these clients and Rewrite or add message headers in mail from these clients,
update incomplete addresses with the domain name in $<a href="postconf.5.html#myorigin">myorigin</a> or updating incomplete addresses with the domain name in $<a href="postconf.5.html#myorigin">myorigin</a>
$<a href="postconf.5.html#mydomain">mydomain</a>; either don't rewrite message headers from other or $<a href="postconf.5.html#mydomain">mydomain</a>, and adding missing headers.
clients at all, or rewrite message headers and update incomplete
addresses with the domain specified in the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_re</a>-
<a href="postconf.5.html#remote_header_rewrite_domain">write_domain</a> parameter.
<b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b> <b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b>
The network interface addresses that this mail system receives The remote network interface addresses that this mail system
mail on by way of a proxy or network address translation unit. receives mail on by way of a proxy or network address transla-
tion unit.
<b><a href="postconf.5.html#masquerade_classes">masquerade_classes</a> (envelope_sender, header_sender, header_recipient)</b> <b><a href="postconf.5.html#masquerade_classes">masquerade_classes</a> (envelope_sender, header_sender, header_recipient)</b>
What addresses are subject to address masquerading. What addresses are subject to address masquerading.
@ -253,9 +251,11 @@ CANONICAL(5) CANONICAL(5)
set to "-". set to "-".
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value is non-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter, and adding missing head-
ers.
<b>SEE ALSO</b> <b>SEE ALSO</b>
<a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail <a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail

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

@ -49,8 +49,8 @@ DNSBLOG(8) DNSBLOG(8)
request before it is terminated by a built-in watchdog timer. request before it is terminated by a built-in watchdog timer.
<b><a href="postconf.5.html#postscreen_dnsbl_sites">postscreen_dnsbl_sites</a> (empty)</b> <b><a href="postconf.5.html#postscreen_dnsbl_sites">postscreen_dnsbl_sites</a> (empty)</b>
Optional list of DNS allow/denylist domains, filters and weight Optional list of patterns with DNS allow/denylist domains, fil-
factors. ters and weight factors.
<b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
The time limit for sending or receiving information over an The time limit for sending or receiving information over an

9
postfix/html/generic.5.html
View File

@ -182,12 +182,13 @@ GENERIC(5) GENERIC(5)
Other parameters of interest: Other parameters of interest:
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b> <b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b>
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. receives mail on.
<b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b> <b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b>
The network interface addresses that this mail system receives The remote network interface addresses that this mail system
mail on by way of a proxy or network address translation unit. receives mail on by way of a proxy or network address transla-
tion unit.
<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> <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> The list of domains that are delivered via the $<a href="postconf.5.html#local_transport">local_transport</a>

49
postfix/html/header_checks.5.html
View File

@ -392,40 +392,31 @@ HEADER_CHECKS(5) HEADER_CHECKS(5)
<b>Return-Path:</b>. <b>Return-Path:</b>.
<b>CONFIGURATION PARAMETERS</b> <b>CONFIGURATION PARAMETERS</b>
<b><a href="postconf.5.html#body_checks">body_checks</a></b> <b><a href="postconf.5.html#body_checks">body_checks</a> (empty)</b>
Lookup tables with content filter rules for message body lines. Optional lookup tables for content inspection as specified in
These filters see one physical line at a time, in chunks of at the <a href="header_checks.5.html"><b>body_checks</b>(5)</a> manual page.
most <b>$<a href="postconf.5.html#line_length_limit">line_length_limit</a></b> bytes.
<b><a href="postconf.5.html#body_checks_size_limit">body_checks_size_limit</a></b> <b><a href="postconf.5.html#body_checks_size_limit">body_checks_size_limit</a> (51200)</b>
The amount of content per message body segment (attachment) that How much text in a message body segment (or attachment, if you
is subjected to <b>$<a href="postconf.5.html#body_checks">body_checks</a></b> filtering. prefer to use that term) is subjected to <a href="postconf.5.html#body_checks">body_checks</a> inspection.
<b><a href="postconf.5.html#header_checks">header_checks</a></b> <b><a href="postconf.5.html#header_checks">header_checks</a> (empty)</b>
Optional lookup tables for content inspection of primary
non-MIME message headers, as specified in the <a href="header_checks.5.html"><b>header_checks</b>(5)</a>
manual page.
<b><a href="postconf.5.html#mime_header_checks">mime_header_checks</a></b> (default: <b>$<a href="postconf.5.html#header_checks">header_checks</a></b>) <b><a href="postconf.5.html#mime_header_checks">mime_header_checks</a> ($<a href="postconf.5.html#header_checks">header_checks</a>)</b>
Optional lookup tables for content inspection of MIME related
message headers, as described in the <a href="header_checks.5.html"><b>header_checks</b>(5)</a> manual
page.
<b><a href="postconf.5.html#nested_header_checks">nested_header_checks</a></b> (default: <b>$<a href="postconf.5.html#header_checks">header_checks</a></b>) <b><a href="postconf.5.html#nested_header_checks">nested_header_checks</a> ($<a href="postconf.5.html#header_checks">header_checks</a>)</b>
Lookup tables with content filter rules for message header Optional lookup tables for content inspection of non-MIME mes-
lines: respectively, these are applied to the initial message sage headers in attached messages, as described in the
headers (not including MIME headers), to the MIME headers any- <a href="header_checks.5.html"><b>header_checks</b>(5)</a> manual page.
where in the message, and to the initial headers of attached
messages.
Note: these filters see one logical message header at a time, <b><a href="postconf.5.html#disable_mime_input_processing">disable_mime_input_processing</a> (no)</b>
even when a message header spans multiple lines. Message headers Turn off MIME processing while receiving mail.
that are longer than <b>$<a href="postconf.5.html#header_size_limit">header_size_limit</a></b> characters are trun-
cated.
<b><a href="postconf.5.html#disable_mime_input_processing">disable_mime_input_processing</a></b>
While receiving mail, give no special treatment to MIME related
message headers; all text after the initial message headers is
considered to be part of the message body. This means that
<b><a href="postconf.5.html#header_checks">header_checks</a></b> is applied to all the initial message headers, and
that <b><a href="postconf.5.html#body_checks">body_checks</a></b> is applied to the remainder of the message.
Note: when used in this manner, <b><a href="postconf.5.html#body_checks">body_checks</a></b> will process a
multi-line message header one line at a time.
<b>EXAMPLES</b> <b>EXAMPLES</b>
Header pattern to block attachments with bad file name extensions. For Header pattern to block attachments with bad file name extensions. For

8
postfix/html/mailq.1.html
View File

@ -455,9 +455,11 @@ SENDMAIL(1) SENDMAIL(1)
The location of the Postfix top-level queue directory. The location of the Postfix top-level queue directory.
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value is non-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter, and adding missing head-
ers.
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
The syslog facility of Postfix logging. The syslog facility of Postfix logging.

8
postfix/html/newaliases.1.html
View File

@ -455,9 +455,11 @@ SENDMAIL(1) SENDMAIL(1)
The location of the Postfix top-level queue directory. The location of the Postfix top-level queue directory.
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value is non-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter, and adding missing head-
ers.
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
The syslog facility of Postfix logging. The syslog facility of Postfix logging.

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

@ -70,7 +70,7 @@ POSTDROP(1) POSTDROP(1)
figuration files. figuration files.
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non-Postfix parent process, or process will import from a non-Postfix parent process, or
name=value environment overrides. name=value environment overrides.

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

@ -63,7 +63,7 @@ POSTKICK(1) POSTKICK(1)
the Postfix daemon process input buffer before giving up. the Postfix daemon process input buffer before giving up.
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non-Postfix parent process, or process will import from a non-Postfix parent process, or
name=value environment overrides. name=value environment overrides.

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

@ -93,7 +93,7 @@ POSTLOCK(1) POSTLOCK(1)
figuration files. figuration files.
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non-Postfix parent process, or process will import from a non-Postfix parent process, or
name=value environment overrides. name=value environment overrides.

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

@ -275,7 +275,7 @@ POSTSUPER(1) POSTSUPER(1)
subdirectory levels. subdirectory levels.
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non-Postfix parent process, or process will import from a non-Postfix parent process, or
name=value environment overrides. name=value environment overrides.

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

@ -232,8 +232,8 @@ QMGR(8) QMGR(8)
ter.cf</a> name of the message delivery transport. ter.cf</a> name of the message delivery transport.
<b><a href="postconf.5.html#default_recipient_refill_delay">default_recipient_refill_delay</a> (5s)</b> <b><a href="postconf.5.html#default_recipient_refill_delay">default_recipient_refill_delay</a> (5s)</b>
The default per-transport maximum delay between recipients The default per-transport maximum delay between refilling recip-
refills. ients.
<b><a href="postconf.5.html#transport_recipient_refill_delay">transport_recipient_refill_delay</a> ($<a href="postconf.5.html#default_recipient_refill_delay">default_recipient_refill_delay</a>)</b> <b><a href="postconf.5.html#transport_recipient_refill_delay">transport_recipient_refill_delay</a> ($<a href="postconf.5.html#default_recipient_refill_delay">default_recipient_refill_delay</a>)</b>
A transport-specific override for the <a href="postconf.5.html#default_recipient_refill_delay">default_recipi</a>- A transport-specific override for the <a href="postconf.5.html#default_recipient_refill_delay">default_recipi</a>-

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

@ -61,7 +61,7 @@ QMQPD(8) QMQPD(8)
<b><a href="postconf.5.html#smtputf8_enable">smtputf8_enable</a> (yes)</b> <b><a href="postconf.5.html#smtputf8_enable">smtputf8_enable</a> (yes)</b>
Enable preliminary SMTPUTF8 support for the protocols described Enable preliminary SMTPUTF8 support for the protocols described
in <a href="https://tools.ietf.org/html/rfc6531">RFC 6531</a>..6533. in <a href="https://tools.ietf.org/html/rfc6531">RFC 6531</a>, <a href="https://tools.ietf.org/html/rfc6532">RFC 6532</a>, and <a href="https://tools.ietf.org/html/rfc6533">RFC 6533</a>.
<b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b> <b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b>
Detect that a message requires SMTPUTF8 support for the speci- Detect that a message requires SMTPUTF8 support for the speci-

9
postfix/html/relocated.5.html
View File

@ -125,8 +125,8 @@ RELOCATED(5) RELOCATED(5)
Other parameters of interest: Other parameters of interest:
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b> <b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> (all)</b>
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. 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> <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> The list of domains that are delivered via the $<a href="postconf.5.html#local_transport">local_transport</a>
@ -137,8 +137,9 @@ RELOCATED(5) RELOCATED(5)
and that locally posted mail is delivered to. and that locally posted mail is delivered to.
<b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b> <b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> (empty)</b>
The network interface addresses that this mail system receives The remote network interface addresses that this mail system
mail on by way of a proxy or network address translation unit. receives mail on by way of a proxy or network address transla-
tion unit.
<b>SEE ALSO</b> <b>SEE ALSO</b>
<a href="trivial-rewrite.8.html">trivial-rewrite(8)</a>, address resolver <a href="trivial-rewrite.8.html">trivial-rewrite(8)</a>, address resolver

8
postfix/html/sendmail.1.html
View File

@ -455,9 +455,11 @@ SENDMAIL(1) SENDMAIL(1)
The location of the Postfix top-level queue directory. The location of the Postfix top-level queue directory.
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value is non-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter, and adding missing head-
ers.
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
The syslog facility of Postfix logging. The syslog facility of Postfix logging.

21
postfix/html/trivial-rewrite.8.html
View File

@ -134,9 +134,11 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
Available in Postfix 2.2 and later: Available in Postfix 2.2 and later:
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value is non-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter, and adding missing head-
ers.
<b>ROUTING CONTROLS</b> <b>ROUTING CONTROLS</b>
The following is applicable to Postfix version 2.0 and later. Earlier The following is applicable to Postfix version 2.0 and later. Earlier
@ -155,13 +157,14 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
<b><a href="postconf.5.html#relay_transport">relay_transport</a> (relay)</b> <b><a href="postconf.5.html#relay_transport">relay_transport</a> (relay)</b>
The default mail delivery transport and next-hop destination for The default mail delivery transport and next-hop destination for
remote delivery to domains listed with $<a href="postconf.5.html#relay_domains">relay_domains</a>. the relay domain address class: recipient domains that match
$<a href="postconf.5.html#relay_domains">relay_domains</a>.
<b><a href="postconf.5.html#default_transport">default_transport</a> (smtp)</b> <b><a href="postconf.5.html#default_transport">default_transport</a> (smtp)</b>
The default mail delivery transport and next-hop destination for The default mail delivery transport and next-hop destination for
destinations that do not match $<a href="postconf.5.html#mydestination">mydestination</a>, $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a>, the default domain class: recipient domains that do not match
$<a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>, $<a href="postconf.5.html#virtual_alias_domains">virtual_alias_domains</a>, $<a href="postconf.5.html#virtual_mailbox_domains">virtual_mail</a>- $<a href="postconf.5.html#mydestination">mydestination</a>, $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a>, $<a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>, $<a href="postconf.5.html#virtual_alias_domains">vir</a>-
<a href="postconf.5.html#virtual_mailbox_domains">box_domains</a>, or $<a href="postconf.5.html#relay_domains">relay_domains</a>. <a href="postconf.5.html#virtual_alias_domains">tual_alias_domains</a>, $<a href="postconf.5.html#virtual_mailbox_domains">virtual_mailbox_domains</a>, or $<a href="postconf.5.html#relay_domains">relay_domains</a>.
<b><a href="postconf.5.html#parent_domain_matches_subdomains">parent_domain_matches_subdomains</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#parent_domain_matches_subdomains">parent_domain_matches_subdomains</a> (see 'postconf -d' output)</b>
A list of Postfix features where the pattern "example.com" also A list of Postfix features where the pattern "example.com" also
@ -169,8 +172,8 @@ TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
explicit ".example.com" pattern. explicit ".example.com" pattern.
<b><a href="postconf.5.html#relayhost">relayhost</a> (empty)</b> <b><a href="postconf.5.html#relayhost">relayhost</a> (empty)</b>
The next-hop destination(s) for non-local mail; overrides The next-hop destination(s) for non-local mail; takes precedence
non-<a href="ADDRESS_CLASS_README.html#local_domain_class">local domains</a> in recipient addresses. over non-<a href="ADDRESS_CLASS_README.html#local_domain_class">local domains</a> in recipient addresses.
<b><a href="postconf.5.html#transport_maps">transport_maps</a> (empty)</b> <b><a href="postconf.5.html#transport_maps">transport_maps</a> (empty)</b>
Optional lookup tables with mappings from recipient address to Optional lookup tables with mappings from recipient address to

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

@ -78,7 +78,7 @@ environment parameter.
The default location of the Postfix main.cf and master.cf The default location of the Postfix main.cf and master.cf
configuration files. configuration files.
.IP "\fBimport_environment (see 'postconf -d' output)\fR" .IP "\fBimport_environment (see 'postconf -d' output)\fR"
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non\-Postfix parent process, or name=value process will import from a non\-Postfix parent process, or name=value
environment overrides. environment overrides.
.IP "\fBqueue_directory (see 'postconf -d' output)\fR" .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

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

@ -66,7 +66,7 @@ configuration files.
How long the \fBpostkick\fR(1) command waits for a request to enter the How long the \fBpostkick\fR(1) command waits for a request to enter the
Postfix daemon process input buffer before giving up. Postfix daemon process input buffer before giving up.
.IP "\fBimport_environment (see 'postconf -d' output)\fR" .IP "\fBimport_environment (see 'postconf -d' output)\fR"
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non\-Postfix parent process, or name=value process will import from a non\-Postfix parent process, or name=value
environment overrides. environment overrides.
.IP "\fBqueue_directory (see 'postconf -d' output)\fR" .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

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

@ -99,7 +99,7 @@ The delay between attempts to fork() a child process.
The default location of the Postfix main.cf and master.cf The default location of the Postfix main.cf and master.cf
configuration files. configuration files.
.IP "\fBimport_environment (see 'postconf -d' output)\fR" .IP "\fBimport_environment (see 'postconf -d' output)\fR"
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non\-Postfix parent process, or name=value process will import from a non\-Postfix parent process, or name=value
environment overrides. environment overrides.
.SH "SEE ALSO" .SH "SEE ALSO"

6
postfix/man/man1/postsuper.1
View File

@ -46,7 +46,7 @@ from standard input. For example, to delete all mail
with exactly one recipient \fBuser@example.com\fR: with exactly one recipient \fBuser@example.com\fR:
.sp .sp
.nf .nf
postqueue \-j | jq -r ' postqueue \-j | jq \-r '
# See JSON OBJECT FORMAT section in the postqueue(1) manpage # See JSON OBJECT FORMAT section in the postqueue(1) manpage
select(.recipients[0].address == "user@example.com") select(.recipients[0].address == "user@example.com")
| select(.recipients[1].address == null) | select(.recipients[1].address == null)
@ -54,7 +54,7 @@ postqueue \-j | jq -r '
' | postsuper \-d \- ' | postsuper \-d \-
.fi .fi
.sp .sp
(note the "jq -r" option), or the historical form: (note the "jq \-r" option), or the historical form:
.sp .sp
.nf .nf
mailq | tail \-n +2 | grep \-v '^ *(' | awk 'BEGIN { RS = "" } mailq | tail \-n +2 | grep \-v '^ *(' | awk 'BEGIN { RS = "" }
@ -302,7 +302,7 @@ the hash_queue_names parameter.
The names of queue directories that are split across multiple The names of queue directories that are split across multiple
subdirectory levels. subdirectory levels.
.IP "\fBimport_environment (see 'postconf -d' output)\fR" .IP "\fBimport_environment (see 'postconf -d' output)\fR"
The list of environment parameters that a privileged Postfix The list of environment variables that a privileged Postfix
process will import from a non\-Postfix parent process, or name=value process will import from a non\-Postfix parent process, or name=value
environment overrides. environment overrides.
.IP "\fBqueue_directory (see 'postconf -d' output)\fR" .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

7
postfix/man/man1/sendmail.1
View File

@ -440,9 +440,10 @@ daemon processes.
.IP "\fBqueue_directory (see 'postconf -d' output)\fR" .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
The location of the Postfix top\-level queue directory. The location of the Postfix top\-level queue directory.
.IP "\fBremote_header_rewrite_domain (empty)\fR" .IP "\fBremote_header_rewrite_domain (empty)\fR"
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the remote_header_rewrite_domain parameter value is non\-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
remote_header_rewrite_domain parameter, and adding missing headers.
.IP "\fBsyslog_facility (mail)\fR" .IP "\fBsyslog_facility (mail)\fR"
The syslog facility of Postfix logging. The syslog facility of Postfix logging.
.IP "\fBsyslog_name (see 'postconf -d' output)\fR" .IP "\fBsyslog_name (see 'postconf -d' output)\fR"

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

@ -170,8 +170,8 @@ The alias databases for \fBlocal\fR(8) delivery that are updated with
"\fBnewaliases\fR" or with "\fBsendmail \-bi\fR". "\fBnewaliases\fR" or with "\fBsendmail \-bi\fR".
.IP "\fBalias_maps (see 'postconf -d' output)\fR" .IP "\fBalias_maps (see 'postconf -d' output)\fR"
Optional lookup tables with aliases that apply only to \fBlocal\fR(8) Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
delivery, unlike virtual_alias_maps that apply to all email deliveries: recipients; this is unlike virtual_alias_maps that apply to all
\fBlocal\fR(8), virtual, and remote. recipients: \fBlocal\fR(8), virtual, and remote.
.IP "\fBallow_mail_to_commands (alias, forward)\fR" .IP "\fBallow_mail_to_commands (alias, forward)\fR"
Restrict \fBlocal\fR(8) mail delivery to external commands. Restrict \fBlocal\fR(8) mail delivery to external commands.
.IP "\fBallow_mail_to_files (alias, forward)\fR" .IP "\fBallow_mail_to_files (alias, forward)\fR"

22
postfix/man/man5/canonical.5
View File

@ -231,17 +231,14 @@ key to the lookup result.
.PP .PP
Other parameters of interest: Other parameters of interest:
.IP "\fBinet_interfaces (all)\fR" .IP "\fBinet_interfaces (all)\fR"
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. receives mail on.
.IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR" .IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR"
Rewrite message header addresses in mail from these clients and Rewrite or add message headers in mail from these clients,
update incomplete addresses with the domain name in $myorigin or updating incomplete addresses with the domain name in $myorigin or
$mydomain; either don't rewrite message headers from other clients $mydomain, and adding missing headers.
at all, or rewrite message headers and update incomplete addresses
with the domain specified in the remote_header_rewrite_domain
parameter.
.IP "\fBproxy_interfaces (empty)\fR" .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. on by way of a proxy or network address translation unit.
.IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR" .IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR"
What addresses are subject to address masquerading. What addresses are subject to address masquerading.
@ -263,9 +260,10 @@ Enable special treatment for owner\-\fIlistname\fR entries in the
\fIlistname\fR\-request address localparts when the recipient_delimiter \fIlistname\fR\-request address localparts when the recipient_delimiter
is set to "\-". is set to "\-".
.IP "\fBremote_header_rewrite_domain (empty)\fR" .IP "\fBremote_header_rewrite_domain (empty)\fR"
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the remote_header_rewrite_domain parameter value is non\-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
remote_header_rewrite_domain parameter, and adding missing headers.
.SH "SEE ALSO" .SH "SEE ALSO"
.na .na
.nf .nf

6
postfix/man/man5/generic.5
View File

@ -214,10 +214,10 @@ key to the lookup result.
.PP .PP
Other parameters of interest: Other parameters of interest:
.IP "\fBinet_interfaces (all)\fR" .IP "\fBinet_interfaces (all)\fR"
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. receives mail on.
.IP "\fBproxy_interfaces (empty)\fR" .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. on by way of a proxy or network address translation unit.
.IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR" .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
The list of domains that are delivered via the $local_transport The list of domains that are delivered via the $local_transport

46
postfix/man/man5/header_checks.5
View File

@ -417,34 +417,24 @@ be examined before they are deleted. Examples are: \fBBcc:\fR,
.nf .nf
.ad .ad
.fi .fi
.IP \fBbody_checks\fR .IP "\fBbody_checks (empty)\fR"
Lookup tables with content filter rules for message body lines. Optional lookup tables for content inspection as specified in
These filters see one physical line at a time, in chunks of the \fBbody_checks\fR(5) manual page.
at most \fB$line_length_limit\fR bytes. .IP "\fBbody_checks_size_limit (51200)\fR"
.IP \fBbody_checks_size_limit\fP How much text in a message body segment (or attachment, if you
The amount of content per message body segment (attachment) that is prefer to use that term) is subjected to body_checks inspection.
subjected to \fB$body_checks\fR filtering. .IP "\fBheader_checks (empty)\fR"
.IP \fBheader_checks\fR Optional lookup tables for content inspection of primary non\-MIME
.IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)" message headers, as specified in the \fBheader_checks\fR(5) manual page.
.IP "\fBnested_header_checks\fR (default: \fB$header_checks\fR)" .IP "\fBmime_header_checks ($header_checks)\fR"
Lookup tables with content filter rules for message header lines: Optional lookup tables for content inspection of MIME related
respectively, these are applied to the initial message headers message headers, as described in the \fBheader_checks\fR(5) manual page.
(not including MIME headers), to the MIME headers anywhere in .IP "\fBnested_header_checks ($header_checks)\fR"
the message, and to the initial headers of attached messages. Optional lookup tables for content inspection of non\-MIME message
.sp headers in attached messages, as described in the \fBheader_checks\fR(5)
Note: these filters see one logical message header at a time, even manual page.
when a message header spans multiple lines. Message headers that .IP "\fBdisable_mime_input_processing (no)\fR"
are longer than \fB$header_size_limit\fR characters are truncated. Turn off MIME processing while receiving mail.
.IP \fBdisable_mime_input_processing\fR
While receiving mail, give no special treatment to MIME related
message headers; all text after the initial message headers is
considered to be part of the message body. This means that
\fBheader_checks\fR is applied to all the initial message headers,
and that \fBbody_checks\fR is applied to the remainder of the
message.
.sp
Note: when used in this manner, \fBbody_checks\fR will process
a multi\-line message header one line at a time.
.SH "EXAMPLES" .SH "EXAMPLES"
.na .na
.nf .nf

6
postfix/man/man5/relocated.5
View File

@ -147,8 +147,8 @@ domains that no longer exist.
.PP .PP
Other parameters of interest: Other parameters of interest:
.IP "\fBinet_interfaces (all)\fR" .IP "\fBinet_interfaces (all)\fR"
The network interface addresses that this mail system receives The local network interface addresses that this mail system
mail on. receives mail on.
.IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR" .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
The list of domains that are delivered via the $local_transport The list of domains that are delivered via the $local_transport
mail delivery transport. mail delivery transport.
@ -156,7 +156,7 @@ mail delivery transport.
The domain name that locally\-posted mail appears to come The domain name that locally\-posted mail appears to come
from, and that locally posted mail is delivered to. from, and that locally posted mail is delivered to.
.IP "\fBproxy_interfaces (empty)\fR" .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. on by way of a proxy or network address translation unit.
.SH "SEE ALSO" .SH "SEE ALSO"
.na .na

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

@ -55,7 +55,8 @@ configuration files.
How much time a Postfix daemon process may take to handle a How much time a Postfix daemon process may take to handle a
request before it is terminated by a built\-in watchdog timer. request before it is terminated by a built\-in watchdog timer.
.IP "\fBpostscreen_dnsbl_sites (empty)\fR" .IP "\fBpostscreen_dnsbl_sites (empty)\fR"
Optional list of DNS allow/denylist domains, filters and weight Optional list of patterns with DNS allow/denylist domains, filters
and weight
factors. factors.
.IP "\fBipc_timeout (3600s)\fR" .IP "\fBipc_timeout (3600s)\fR"
The time limit for sending or receiving information over an internal The time limit for sending or receiving information over an internal

2
postfix/man/man8/qmgr.8
View File

@ -234,7 +234,7 @@ A transport\-specific override for the default_recipient_refill_limit
parameter value, where \fItransport\fR is the master.cf name of parameter value, where \fItransport\fR is the master.cf name of
the message delivery transport. the message delivery transport.
.IP "\fBdefault_recipient_refill_delay (5s)\fR" .IP "\fBdefault_recipient_refill_delay (5s)\fR"
The default per\-transport maximum delay between recipients refills. The default per\-transport maximum delay between refilling recipients.
.IP "\fBtransport_recipient_refill_delay ($default_recipient_refill_delay)\fR" .IP "\fBtransport_recipient_refill_delay ($default_recipient_refill_delay)\fR"
A transport\-specific override for the default_recipient_refill_delay A transport\-specific override for the default_recipient_refill_delay
parameter value, where \fItransport\fR is the master.cf name of parameter value, where \fItransport\fR is the master.cf name of

2
postfix/man/man8/qmqpd.8
View File

@ -75,7 +75,7 @@ filtering, or address mapping.
Preliminary SMTPUTF8 support is introduced with Postfix 3.0. Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
.IP "\fBsmtputf8_enable (yes)\fR" .IP "\fBsmtputf8_enable (yes)\fR"
Enable preliminary SMTPUTF8 support for the protocols described Enable preliminary SMTPUTF8 support for the protocols described
in RFC 6531..6533. in RFC 6531, RFC 6532, and RFC 6533.
.IP "\fBsmtputf8_autodetect_classes (sendmail, verify)\fR" .IP "\fBsmtputf8_autodetect_classes (sendmail, verify)\fR"
Detect that a message requires SMTPUTF8 support for the specified Detect that a message requires SMTPUTF8 support for the specified
mail origin classes. mail origin classes.

17
postfix/man/man8/trivial-rewrite.8
View File

@ -142,9 +142,10 @@ Enable the rewriting of "site!user" into "user@site".
.PP .PP
Available in Postfix 2.2 and later: Available in Postfix 2.2 and later:
.IP "\fBremote_header_rewrite_domain (empty)\fR" .IP "\fBremote_header_rewrite_domain (empty)\fR"
Don't rewrite message headers from remote clients at all when Rewrite or add message headers in mail from remote clients if
this parameter is empty; otherwise, rewrite message headers and the remote_header_rewrite_domain parameter value is non\-empty,
append the specified domain name to incomplete addresses. updating incomplete addresses with the domain specified in the
remote_header_rewrite_domain parameter, and adding missing headers.
.SH "ROUTING CONTROLS" .SH "ROUTING CONTROLS"
.na .na
.nf .nf
@ -163,10 +164,12 @@ The default mail delivery transport and next\-hop destination for
final delivery to domains listed with $virtual_mailbox_domains. final delivery to domains listed with $virtual_mailbox_domains.
.IP "\fBrelay_transport (relay)\fR" .IP "\fBrelay_transport (relay)\fR"
The default mail delivery transport and next\-hop destination for The default mail delivery transport and next\-hop destination for
remote delivery to domains listed with $relay_domains. the relay domain address class: recipient domains that match
$relay_domains.
.IP "\fBdefault_transport (smtp)\fR" .IP "\fBdefault_transport (smtp)\fR"
The default mail delivery transport and next\-hop destination for The default mail delivery transport and next\-hop destination for
destinations that do not match $mydestination, $inet_interfaces, the default domain class: recipient domains that do not match
$mydestination, $inet_interfaces,
$proxy_interfaces, $virtual_alias_domains, $virtual_mailbox_domains, $proxy_interfaces, $virtual_alias_domains, $virtual_mailbox_domains,
or $relay_domains. or $relay_domains.
.IP "\fBparent_domain_matches_subdomains (see 'postconf -d' output)\fR" .IP "\fBparent_domain_matches_subdomains (see 'postconf -d' output)\fR"
@ -174,8 +177,8 @@ A list of Postfix features where the pattern "example.com" also
matches subdomains of example.com, matches subdomains of example.com,
instead of requiring an explicit ".example.com" pattern. instead of requiring an explicit ".example.com" pattern.
.IP "\fBrelayhost (empty)\fR" .IP "\fBrelayhost (empty)\fR"
The next\-hop destination(s) for non\-local mail; overrides non\-local The next\-hop destination(s) for non\-local mail; takes precedence
domains in recipient addresses. over non\-local domains in recipient addresses.
.IP "\fBtransport_maps (empty)\fR" .IP "\fBtransport_maps (empty)\fR"
Optional lookup tables with mappings from recipient address to Optional lookup tables with mappings from recipient address to
(message delivery transport, next\-hop destination). (message delivery transport, next\-hop destination).

4
postfix/proto/aliases
View File

@ -154,8 +154,8 @@
# "\fBnewaliases\fR" or with "\fBsendmail -bi\fR". # "\fBnewaliases\fR" or with "\fBsendmail -bi\fR".
# .IP "\fBalias_maps (see 'postconf -d' output)\fR" # .IP "\fBalias_maps (see 'postconf -d' output)\fR"
# Optional lookup tables with aliases that apply only to \fBlocal\fR(8) # Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
# delivery, unlike virtual_alias_maps that apply to all email deliveries: # recipients; this is unlike virtual_alias_maps that apply to all
# \fBlocal\fR(8), virtual, and remote. # recipients: \fBlocal\fR(8), virtual, and remote.
# .IP "\fBallow_mail_to_commands (alias, forward)\fR" # .IP "\fBallow_mail_to_commands (alias, forward)\fR"
# Restrict \fBlocal\fR(8) mail delivery to external commands. # Restrict \fBlocal\fR(8) mail delivery to external commands.
# .IP "\fBallow_mail_to_files (alias, forward)\fR" # .IP "\fBallow_mail_to_files (alias, forward)\fR"

22
postfix/proto/canonical
View File

@ -207,17 +207,14 @@
# .PP # .PP
# Other parameters of interest: # Other parameters of interest:
# .IP "\fBinet_interfaces (all)\fR" # .IP "\fBinet_interfaces (all)\fR"
# The network interface addresses that this mail system receives # The local network interface addresses that this mail system
# mail on. # receives mail on.
# .IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR" # .IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR"
# Rewrite message header addresses in mail from these clients and # Rewrite or add message headers in mail from these clients,
# update incomplete addresses with the domain name in $myorigin or # updating incomplete addresses with the domain name in $myorigin or
# $mydomain; either don't rewrite message headers from other clients # $mydomain, and adding missing headers.
# at all, or rewrite message headers and update incomplete addresses
# with the domain specified in the remote_header_rewrite_domain
# parameter.
# .IP "\fBproxy_interfaces (empty)\fR" # .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. # on by way of a proxy or network address translation unit.
# .IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR" # .IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR"
# What addresses are subject to address masquerading. # What addresses are subject to address masquerading.
@ -239,9 +236,10 @@
# \fIlistname\fR-request address localparts when the recipient_delimiter # \fIlistname\fR-request address localparts when the recipient_delimiter
# is set to "-". # is set to "-".
# .IP "\fBremote_header_rewrite_domain (empty)\fR" # .IP "\fBremote_header_rewrite_domain (empty)\fR"
# Don't rewrite message headers from remote clients at all when # Rewrite or add message headers in mail from remote clients if
# this parameter is empty; otherwise, rewrite message headers and # the remote_header_rewrite_domain parameter value is non-empty,
# append the specified domain name to incomplete addresses. # updating incomplete addresses with the domain specified in the
# remote_header_rewrite_domain parameter, and adding missing headers.
# SEE ALSO # SEE ALSO
# cleanup(8), canonicalize and enqueue mail # cleanup(8), canonicalize and enqueue mail
# postmap(1), Postfix lookup table manager # postmap(1), Postfix lookup table manager

6
postfix/proto/generic
View File

@ -188,10 +188,10 @@
# .PP # .PP
# Other parameters of interest: # Other parameters of interest:
# .IP "\fBinet_interfaces (all)\fR" # .IP "\fBinet_interfaces (all)\fR"
# The network interface addresses that this mail system receives # The local network interface addresses that this mail system
# mail on. # receives mail on.
# .IP "\fBproxy_interfaces (empty)\fR" # .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. # on by way of a proxy or network address translation unit.
# .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR" # .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
# The list of domains that are delivered via the $local_transport # The list of domains that are delivered via the $local_transport

46
postfix/proto/header_checks
View File

@ -418,34 +418,24 @@
# CONFIGURATION PARAMETERS # CONFIGURATION PARAMETERS
# .ad # .ad
# .fi # .fi
# .IP \fBbody_checks\fR # .IP "\fBbody_checks (empty)\fR"
# Lookup tables with content filter rules for message body lines. # Optional lookup tables for content inspection as specified in
# These filters see one physical line at a time, in chunks of # the \fBbody_checks\fR(5) manual page.
# at most \fB$line_length_limit\fR bytes. # .IP "\fBbody_checks_size_limit (51200)\fR"
# .IP \fBbody_checks_size_limit\fP # How much text in a message body segment (or attachment, if you
# The amount of content per message body segment (attachment) that is # prefer to use that term) is subjected to body_checks inspection.
# subjected to \fB$body_checks\fR filtering. # .IP "\fBheader_checks (empty)\fR"
# .IP \fBheader_checks\fR # Optional lookup tables for content inspection of primary non-MIME
# .IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)" # message headers, as specified in the \fBheader_checks\fR(5) manual page.
# .IP "\fBnested_header_checks\fR (default: \fB$header_checks\fR)" # .IP "\fBmime_header_checks ($header_checks)\fR"
# Lookup tables with content filter rules for message header lines: # Optional lookup tables for content inspection of MIME related
# respectively, these are applied to the initial message headers # message headers, as described in the \fBheader_checks\fR(5) manual page.
# (not including MIME headers), to the MIME headers anywhere in # .IP "\fBnested_header_checks ($header_checks)\fR"
# the message, and to the initial headers of attached messages. # Optional lookup tables for content inspection of non-MIME message
# .sp # headers in attached messages, as described in the \fBheader_checks\fR(5)
# Note: these filters see one logical message header at a time, even # manual page.
# when a message header spans multiple lines. Message headers that # .IP "\fBdisable_mime_input_processing (no)\fR"
# are longer than \fB$header_size_limit\fR characters are truncated. # Turn off MIME processing while receiving mail.
# .IP \fBdisable_mime_input_processing\fR
# While receiving mail, give no special treatment to MIME related
# message headers; all text after the initial message headers is
# considered to be part of the message body. This means that
# \fBheader_checks\fR is applied to all the initial message headers,
# and that \fBbody_checks\fR is applied to the remainder of the
# message.
# .sp
# Note: when used in this manner, \fBbody_checks\fR will process
# a multi-line message header one line at a time.
# EXAMPLES # EXAMPLES
# .ad # .ad
# .fi # .fi

6
postfix/proto/relocated
View File

@ -125,8 +125,8 @@
# .PP # .PP
# Other parameters of interest: # Other parameters of interest:
# .IP "\fBinet_interfaces (all)\fR" # .IP "\fBinet_interfaces (all)\fR"
# The network interface addresses that this mail system receives # The local network interface addresses that this mail system
# mail on. # receives mail on.
# .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR" # .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
# The list of domains that are delivered via the $local_transport # The list of domains that are delivered via the $local_transport
# mail delivery transport. # mail delivery transport.
@ -134,7 +134,7 @@
# The domain name that locally-posted mail appears to come # The domain name that locally-posted mail appears to come
# from, and that locally posted mail is delivered to. # from, and that locally posted mail is delivered to.
# .IP "\fBproxy_interfaces (empty)\fR" # .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. # on by way of a proxy or network address translation unit.
# SEE ALSO # SEE ALSO
# trivial-rewrite(8), address resolver # trivial-rewrite(8), address resolver

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

@ -43,7 +43,8 @@
/* How much time a Postfix daemon process may take to handle a /* How much time a Postfix daemon process may take to handle a
/* request before it is terminated by a built-in watchdog timer. /* request before it is terminated by a built-in watchdog timer.
/* .IP "\fBpostscreen_dnsbl_sites (empty)\fR" /* .IP "\fBpostscreen_dnsbl_sites (empty)\fR"
/* Optional list of DNS allow/denylist domains, filters and weight /* Optional list of patterns with DNS allow/denylist domains, filters
/* and weight
/* factors. /* factors.
/* .IP "\fBipc_timeout (3600s)\fR" /* .IP "\fBipc_timeout (3600s)\fR"
/* The time limit for sending or receiving information over an internal /* The time limit for sending or receiving information over an internal

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 * Patches change both the patchlevel and the release date. Snapshots have no
* patchlevel; they change the release date only. * patchlevel; they change the release date only.
*/ */
#define MAIL_RELEASE_DATE "20240124" #define MAIL_RELEASE_DATE "20240125"
#define MAIL_VERSION_NUMBER "3.9" #define MAIL_VERSION_NUMBER "3.9"
#ifdef SNAPSHOT #ifdef SNAPSHOT

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

@ -64,7 +64,7 @@
/* The default location of the Postfix main.cf and master.cf /* The default location of the Postfix main.cf and master.cf
/* configuration files. /* configuration files.
/* .IP "\fBimport_environment (see 'postconf -d' output)\fR" /* .IP "\fBimport_environment (see 'postconf -d' output)\fR"
/* The list of environment parameters that a privileged Postfix /* The list of environment variables that a privileged Postfix
/* process will import from a non-Postfix parent process, or name=value /* process will import from a non-Postfix parent process, or name=value
/* environment overrides. /* environment overrides.
/* .IP "\fBqueue_directory (see 'postconf -d' output)\fR" /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

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

@ -54,7 +54,7 @@
/* How long the \fBpostkick\fR(1) command waits for a request to enter the /* How long the \fBpostkick\fR(1) command waits for a request to enter the
/* Postfix daemon process input buffer before giving up. /* Postfix daemon process input buffer before giving up.
/* .IP "\fBimport_environment (see 'postconf -d' output)\fR" /* .IP "\fBimport_environment (see 'postconf -d' output)\fR"
/* The list of environment parameters that a privileged Postfix /* The list of environment variables that a privileged Postfix
/* process will import from a non-Postfix parent process, or name=value /* process will import from a non-Postfix parent process, or name=value
/* environment overrides. /* environment overrides.
/* .IP "\fBqueue_directory (see 'postconf -d' output)\fR" /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

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

@ -79,7 +79,7 @@
/* The default location of the Postfix main.cf and master.cf /* The default location of the Postfix main.cf and master.cf
/* configuration files. /* configuration files.
/* .IP "\fBimport_environment (see 'postconf -d' output)\fR" /* .IP "\fBimport_environment (see 'postconf -d' output)\fR"
/* The list of environment parameters that a privileged Postfix /* The list of environment variables that a privileged Postfix
/* process will import from a non-Postfix parent process, or name=value /* process will import from a non-Postfix parent process, or name=value
/* environment overrides. /* environment overrides.
/* SEE ALSO /* SEE ALSO

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

@ -288,7 +288,7 @@
/* The names of queue directories that are split across multiple /* The names of queue directories that are split across multiple
/* subdirectory levels. /* subdirectory levels.
/* .IP "\fBimport_environment (see 'postconf -d' output)\fR" /* .IP "\fBimport_environment (see 'postconf -d' output)\fR"
/* The list of environment parameters that a privileged Postfix /* The list of environment variables that a privileged Postfix
/* process will import from a non-Postfix parent process, or name=value /* process will import from a non-Postfix parent process, or name=value
/* environment overrides. /* environment overrides.
/* .IP "\fBqueue_directory (see 'postconf -d' output)\fR" /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"

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

@ -206,7 +206,7 @@
/* parameter value, where \fItransport\fR is the master.cf name of /* parameter value, where \fItransport\fR is the master.cf name of
/* the message delivery transport. /* the message delivery transport.
/* .IP "\fBdefault_recipient_refill_delay (5s)\fR" /* .IP "\fBdefault_recipient_refill_delay (5s)\fR"
/* The default per-transport maximum delay between recipients refills. /* The default per-transport maximum delay between refilling recipients.
/* .IP "\fBtransport_recipient_refill_delay ($default_recipient_refill_delay)\fR" /* .IP "\fBtransport_recipient_refill_delay ($default_recipient_refill_delay)\fR"
/* A transport-specific override for the default_recipient_refill_delay /* A transport-specific override for the default_recipient_refill_delay
/* parameter value, where \fItransport\fR is the master.cf name of /* parameter value, where \fItransport\fR is the master.cf name of

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

@ -57,7 +57,7 @@
/* Preliminary SMTPUTF8 support is introduced with Postfix 3.0. /* Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
/* .IP "\fBsmtputf8_enable (yes)\fR" /* .IP "\fBsmtputf8_enable (yes)\fR"
/* Enable preliminary SMTPUTF8 support for the protocols described /* Enable preliminary SMTPUTF8 support for the protocols described
/* in RFC 6531..6533. /* in RFC 6531, RFC 6532, and RFC 6533.
/* .IP "\fBsmtputf8_autodetect_classes (sendmail, verify)\fR" /* .IP "\fBsmtputf8_autodetect_classes (sendmail, verify)\fR"
/* Detect that a message requires SMTPUTF8 support for the specified /* Detect that a message requires SMTPUTF8 support for the specified
/* mail origin classes. /* mail origin classes.

7
postfix/src/sendmail/sendmail.c
View File

@ -412,9 +412,10 @@
/* .IP "\fBqueue_directory (see 'postconf -d' output)\fR" /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
/* The location of the Postfix top-level queue directory. /* The location of the Postfix top-level queue directory.
/* .IP "\fBremote_header_rewrite_domain (empty)\fR" /* .IP "\fBremote_header_rewrite_domain (empty)\fR"
/* Don't rewrite message headers from remote clients at all when /* Rewrite or add message headers in mail from remote clients if
/* this parameter is empty; otherwise, rewrite message headers and /* the remote_header_rewrite_domain parameter value is non-empty,
/* append the specified domain name to incomplete addresses. /* updating incomplete addresses with the domain specified in the
/* remote_header_rewrite_domain parameter, and adding missing headers.
/* .IP "\fBsyslog_facility (mail)\fR" /* .IP "\fBsyslog_facility (mail)\fR"
/* The syslog facility of Postfix logging. /* The syslog facility of Postfix logging.
/* .IP "\fBsyslog_name (see 'postconf -d' output)\fR" /* .IP "\fBsyslog_name (see 'postconf -d' output)\fR"

32
postfix/src/tlsmgr/tlsmgr.c
View File

@ -818,6 +818,23 @@ static void tlsmgr_service(VSTREAM *client_stream, char *unused_service,
} }
} }
/*
* Workaround: some OS lies under load. It tells the Postfix event
* handler that a server socket is readable, then it tells peekfd() that
* the socket has unread data, and then it tells vstring_get_null() that
* there is none, causing Postfix to spam the log with warning messages.
* Close the stream to stop such nonsense; the client can reconnect if it
* still wants to talk to us.
*
* XXX Why is this problem not reported for the other five
* multi_server-based Postfix services?
*/
else if (vstream_ferror(client_stream) || vstream_feof(client_stream)) {
multi_server_disconnect(client_stream);
return;
/* Note: client_stream is now a dangling pointer. */
}
/* /*
* Protocol error. * Protocol error.
*/ */
@ -827,21 +844,6 @@ static void tlsmgr_service(VSTREAM *client_stream, char *unused_service,
ATTR_TYPE_END); ATTR_TYPE_END);
} }
vstream_fflush(client_stream); vstream_fflush(client_stream);
/*
* Reportedly, some OS lies under load; it tells the Postfix event
* handler that a server socket is readable, then it tells peekfd() that
* the socket has pending data, and then it tells vstring_get_null() that
* there is none, causing Postfix to spam the log with warning messages.
* Close the stream to stop such nonsense; the client can reconnect if it
* still wants to talk to us.
*
* XXX Why is this problem not reported for the other five
* multi_server-based Postfix services?
*/
if (vstream_ferror(client_stream) || vstream_feof(client_stream))
multi_server_disconnect(client_stream);
/* Note: client_stream is now a dangling pointer. */
} }
/* tlsmgr_pre_init - pre-jail initialization */ /* tlsmgr_pre_init - pre-jail initialization */

17
postfix/src/trivial-rewrite/trivial-rewrite.c
View File

@ -122,9 +122,10 @@
/* .PP /* .PP
/* Available in Postfix 2.2 and later: /* Available in Postfix 2.2 and later:
/* .IP "\fBremote_header_rewrite_domain (empty)\fR" /* .IP "\fBremote_header_rewrite_domain (empty)\fR"
/* Don't rewrite message headers from remote clients at all when /* Rewrite or add message headers in mail from remote clients if
/* this parameter is empty; otherwise, rewrite message headers and /* the remote_header_rewrite_domain parameter value is non-empty,
/* append the specified domain name to incomplete addresses. /* updating incomplete addresses with the domain specified in the
/* remote_header_rewrite_domain parameter, and adding missing headers.
/* ROUTING CONTROLS /* ROUTING CONTROLS
/* .ad /* .ad
/* .fi /* .fi
@ -141,10 +142,12 @@
/* final delivery to domains listed with $virtual_mailbox_domains. /* final delivery to domains listed with $virtual_mailbox_domains.
/* .IP "\fBrelay_transport (relay)\fR" /* .IP "\fBrelay_transport (relay)\fR"
/* The default mail delivery transport and next-hop destination for /* The default mail delivery transport and next-hop destination for
/* remote delivery to domains listed with $relay_domains. /* the relay domain address class: recipient domains that match
/* $relay_domains.
/* .IP "\fBdefault_transport (smtp)\fR" /* .IP "\fBdefault_transport (smtp)\fR"
/* The default mail delivery transport and next-hop destination for /* The default mail delivery transport and next-hop destination for
/* destinations that do not match $mydestination, $inet_interfaces, /* the default domain class: recipient domains that do not match
/* $mydestination, $inet_interfaces,
/* $proxy_interfaces, $virtual_alias_domains, $virtual_mailbox_domains, /* $proxy_interfaces, $virtual_alias_domains, $virtual_mailbox_domains,
/* or $relay_domains. /* or $relay_domains.
/* .IP "\fBparent_domain_matches_subdomains (see 'postconf -d' output)\fR" /* .IP "\fBparent_domain_matches_subdomains (see 'postconf -d' output)\fR"
@ -152,8 +155,8 @@
/* matches subdomains of example.com, /* matches subdomains of example.com,
/* instead of requiring an explicit ".example.com" pattern. /* instead of requiring an explicit ".example.com" pattern.
/* .IP "\fBrelayhost (empty)\fR" /* .IP "\fBrelayhost (empty)\fR"
/* The next-hop destination(s) for non-local mail; overrides non-local /* The next-hop destination(s) for non-local mail; takes precedence
/* domains in recipient addresses. /* over non-local domains in recipient addresses.
/* .IP "\fBtransport_maps (empty)\fR" /* .IP "\fBtransport_maps (empty)\fR"
/* Optional lookup tables with mappings from recipient address to /* Optional lookup tables with mappings from recipient address to
/* (message delivery transport, next-hop destination). /* (message delivery transport, next-hop destination).