]> git.ipfire.org Git - thirdparty/postfix.git/commitdiff
postfix-3.9-20240125
authorWietse Venema <wietse@porcupine.org>
Thu, 25 Jan 2024 05:00:00 +0000 (00:00 -0500)
committerViktor Dukhovni <ietf-dane@dukhovni.org>
Thu, 25 Jan 2024 19:28:10 +0000 (14:28 -0500)
52 files changed:
postfix/HISTORY
postfix/conf/aliases
postfix/conf/canonical
postfix/conf/generic
postfix/conf/header_checks
postfix/conf/relocated
postfix/html/aliases.5.html
postfix/html/canonical.5.html
postfix/html/dnsblog.8.html
postfix/html/generic.5.html
postfix/html/header_checks.5.html
postfix/html/mailq.1.html
postfix/html/newaliases.1.html
postfix/html/postdrop.1.html
postfix/html/postkick.1.html
postfix/html/postlock.1.html
postfix/html/postsuper.1.html
postfix/html/qmgr.8.html
postfix/html/qmqpd.8.html
postfix/html/relocated.5.html
postfix/html/sendmail.1.html
postfix/html/trivial-rewrite.8.html
postfix/man/man1/postdrop.1
postfix/man/man1/postkick.1
postfix/man/man1/postlock.1
postfix/man/man1/postsuper.1
postfix/man/man1/sendmail.1
postfix/man/man5/aliases.5
postfix/man/man5/canonical.5
postfix/man/man5/generic.5
postfix/man/man5/header_checks.5
postfix/man/man5/relocated.5
postfix/man/man8/dnsblog.8
postfix/man/man8/qmgr.8
postfix/man/man8/qmqpd.8
postfix/man/man8/trivial-rewrite.8
postfix/proto/aliases
postfix/proto/canonical
postfix/proto/generic
postfix/proto/header_checks
postfix/proto/relocated
postfix/src/dnsblog/dnsblog.c
postfix/src/global/mail_version.h
postfix/src/postdrop/postdrop.c
postfix/src/postkick/postkick.c
postfix/src/postlock/postlock.c
postfix/src/postsuper/postsuper.c
postfix/src/qmgr/qmgr.c
postfix/src/qmqpd/qmqpd.c
postfix/src/sendmail/sendmail.c
postfix/src/tlsmgr/tlsmgr.c
postfix/src/trivial-rewrite/trivial-rewrite.c

index 76ae1c079c870980f6cc44b31f69a0a67712e213..c1da099b3064f985788890c8a5dd50f30c696bf8 100644 (file)
@@ -27760,3 +27760,15 @@ Apologies for any names omitted.
        is readable, then it says that the socket has unread data,
        and then it says that read returns EOF, causing Postfix to
        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.
index 6849e7e1d5142173c16db226abcb3d486dca74ec..280c3d256c2689dbc9ac2d5f78442c230405449d 100644 (file)
@@ -200,9 +200,9 @@ decode:             root
 # 
 #        alias_maps (see 'postconf -d' output)
 #               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.
+#               to   local(8)   recipients;  this  is  unlike  vir-
+#               tual_alias_maps  that  apply  to  all   recipients:
+#               local(8), virtual, and remote.
 # 
 #        allow_mail_to_commands (alias, forward)
 #               Restrict  local(8)  mail  delivery to external com-
index 4957fcc4fc1b2e1de914d571bf5a6ffadf96a452..894fd5bcdcdf8955aa076270f466a6cf80cdd714 100644 (file)
 #        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.
 # 
 #        local_header_rewrite_clients (permit_inet_interfaces)
-#               Rewrite message header addresses in mail from these
-#               clients  and  update  incomplete addresses with the
-#               domain name in $myorigin or $mydomain; either don't
-#               rewrite  message headers from other clients at all,
-#               or rewrite message headers  and  update  incomplete
-#               addresses   with   the   domain  specified  in  the
-#               remote_header_rewrite_domain parameter.
+#               Rewrite or add message headers in mail  from  these
+#               clients,  updating  incomplete  addresses  with the
+#               domain name in $myorigin or $mydomain,  and  adding
+#               missing headers.
 # 
 #        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.
 # 
-#        masquerade_classes    (envelope_sender,     header_sender,
+#        masquerade_classes     (envelope_sender,    header_sender,
 #        header_recipient)
 #               What addresses are subject to address masquerading.
 # 
 #        masquerade_domains (empty)
-#               Optional  list of domains whose subdomain structure
+#               Optional list of domains whose subdomain  structure
 #               will be stripped off in email addresses.
 # 
 #        masquerade_exceptions (empty)
-#               Optional list of user names that are not  subjected
-#               to  address masquerading, even when their addresses
+#               Optional  list of user names that are not subjected
+#               to address masquerading, even when their  addresses
 #               match $masquerade_domains.
 # 
 #        mydestination  ($myhostname,  localhost.$mydomain,  local-
 #        host)
-#               The list of domains  that  are  delivered  via  the
+#               The  list  of  domains  that  are delivered via the
 #               $local_transport mail delivery transport.
 # 
 #        myorigin ($myhostname)
 #               The domain name that locally-posted mail appears to
-#               come from, and that locally posted mail  is  deliv-
+#               come  from,  and that locally posted mail is deliv-
 #               ered to.
 # 
 #        owner_request_special (yes)
 #               Enable special treatment for owner-listname entries
 #               in the aliases(5) file, and don't split owner-list-
-#               name  and  listname-request address localparts when
+#               name and listname-request address  localparts  when
 #               the recipient_delimiter is set to "-".
 # 
 #        remote_header_rewrite_domain (empty)
-#               Don't rewrite message headers from  remote  clients
-#               at all when this parameter is empty; otherwise, re-
-#               write message  headers  and  append  the  specified
-#               domain name to incomplete addresses.
+#               Rewrite  or add message headers in mail from remote
+#               clients if the remote_header_rewrite_domain parame-
+#               ter   value   is   non-empty,  updating  incomplete
+#               addresses  with  the  domain   specified   in   the
+#               remote_header_rewrite_domain  parameter, and adding
+#               missing headers.
 # 
 # SEE ALSO
 #        cleanup(8), canonicalize and enqueue mail
 #        virtual(5), virtual aliasing
 # 
 # README FILES
-#        Use  "postconf  readme_directory" or "postconf html_direc-
+#        Use "postconf readme_directory" or  "postconf  html_direc-
 #        tory" to locate this information.
 #        DATABASE_README, Postfix lookup table overview
 #        ADDRESS_REWRITING_README, address rewriting guide
 # 
 # LICENSE
-#        The Secure Mailer license must be  distributed  with  this
+#        The  Secure  Mailer  license must be distributed with this
 #        software.
 # 
 # AUTHOR(S)
index f371eb9a5c9ffe38a9590f779c9473d342982e31..508e44a42cb3bf3d23c580d1d5cb3775c591ec95 100644 (file)
 #        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.
 # 
 #        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.
 # 
 #        mydestination  ($myhostname,  localhost.$mydomain,  local-
 #        host)
index bcd96a97a0ba891c749f102f9f58d7c03282476a..db295d022e708953cb812f675ee516b297a0cf6c 100644 (file)
 #        tent-Length:, Return-Path:.
 # 
 # CONFIGURATION PARAMETERS
-#        body_checks
-#               Lookup tables with content filter rules for message
-#               body lines.  These filters see one physical line at
-#               a  time,  in  chunks  of at most $line_length_limit
-#               bytes.
-# 
-#        body_checks_size_limit
-#               The amount of  content  per  message  body  segment
-#               (attachment) that is subjected to $body_checks fil-
-#               tering.
-# 
-#        header_checks
-# 
-#        mime_header_checks (default: $header_checks)
-# 
-#        nested_header_checks (default: $header_checks)
-#               Lookup tables with content filter rules for message
-#               header  lines:  respectively,  these are applied to
-#               the initial message  headers  (not  including  MIME
-#               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
-#               at a time, even when a message header spans  multi-
-#               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.
+#        body_checks (empty)
+#               Optional  lookup  tables  for content inspection as
+#               specified in the body_checks(5) manual page.
+# 
+#        body_checks_size_limit (51200)
+#               How much text in a message body segment (or attach-
+#               ment,  if you prefer to use that term) is subjected
+#               to body_checks inspection.
+# 
+#        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 ($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 ($header_checks)
+#               Optional lookup tables for  content  inspection  of
+#               non-MIME  message  headers in attached messages, as
+#               described in the header_checks(5) manual page.
+# 
+#        disable_mime_input_processing (no)
+#               Turn off MIME processing while receiving mail.
 # 
 # EXAMPLES
 #        Header pattern to block attachments  with  bad  file  name
index 90f63ecf20954516d7107390ca8c24ead668ea64..5c432667243285fb507ef3110a1729bbf4c5106c 100644 (file)
 #        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)
 #               ered 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
 #        trivial-rewrite(8), address resolver
index 5df15e06948ff696fd74f44631f7b9fc9559c434..79d01b4834ecd41cef92f92aa6970e102300e17e 100644 (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>
               Optional lookup tables with aliases that apply only to  <a href="local.8.html"><b>local</b>(8)</a>
-              delivery,  unlike  <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a>  that  apply  to all email
-              deliveries: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote.
+              recipients;  this is unlike <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> that apply to all
+              recipients: <a href="local.8.html"><b>local</b>(8)</a>, virtual, and remote.
 
        <b><a href="postconf.5.html#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.
index 75c25f16691e7b185bd7f1baca8311e9a6668a40..d0512977ca707ea25794bad739810c07a4a0a8c7 100644 (file)
@@ -211,20 +211,18 @@ CANONICAL(5)                                                      CANONICAL(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#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
-              update incomplete addresses with the domain name in $<a href="postconf.5.html#myorigin">myorigin</a> or
-              $<a href="postconf.5.html#mydomain">mydomain</a>; either  don't  rewrite  message  headers  from  other
-              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.
+              Rewrite or add message  headers  in  mail  from  these  clients,
+              updating  incomplete addresses with the domain name in $<a href="postconf.5.html#myorigin">myorigin</a>
+              or $<a href="postconf.5.html#mydomain">mydomain</a>, and adding missing headers.
 
        <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><a href="postconf.5.html#masquerade_classes">masquerade_classes</a> (envelope_sender, header_sender, header_recipient)</b>
               What addresses are subject to address masquerading.
@@ -253,9 +251,11 @@ CANONICAL(5)                                                      CANONICAL(5)
               set to "-".
 
        <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
-              this  parameter is empty; otherwise, rewrite message headers and
-              append the specified domain name to incomplete addresses.
+              Rewrite or add message headers in mail from  remote  clients  if
+              the  <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a>  parameter value is non-empty,
+              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>
        <a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail
index 250b046bf4b77acaec6c530249b049ee887b5e2f..2028fa167790174a92f07d77973679aaa7867941 100644 (file)
@@ -49,8 +49,8 @@ DNSBLOG(8)                                                          DNSBLOG(8)
               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>
-              Optional list of DNS allow/denylist domains, filters and  weight
-              factors.
+              Optional list of patterns with DNS allow/denylist domains,  fil-
+              ters and weight factors.
 
        <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
               The  time  limit  for  sending  or receiving information over an
index 813d47e82fa2aa6a1c429bdceb9564999c17291d..c1a8a30e4db4d34d7299b02f2bfd5e25602dbf32 100644 (file)
@@ -182,25 +182,26 @@ GENERIC(5)                                                          GENERIC(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#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><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>
               mail delivery transport.
 
        <b><a href="postconf.5.html#myorigin">myorigin</a> ($<a href="postconf.5.html#myhostname">myhostname</a>)</b>
-              The  domain  name that locally-posted mail appears to come from,
+              The domain name that locally-posted mail appears to  come  from,
               and that locally posted mail is delivered to.
 
        <b><a href="postconf.5.html#owner_request_special">owner_request_special</a> (yes)</b>
-              Enable special  treatment  for  owner-<i>listname</i>  entries  in  the
+              Enable  special  treatment  for  owner-<i>listname</i>  entries  in the
               <a href="aliases.5.html"><b>aliases</b>(5)</a>  file,  and  don't  split  owner-<i>listname</i>  and  <i>list-</i>
-              <i>name</i>-request address localparts when the <a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a>  is
+              <i>name</i>-request  address localparts when the <a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> is
               set to "-".
 
 <b>SEE ALSO</b>
index 6bb114a1fb4fa42c5c29cd44c7478c46686e86d3..c1c8b17cc1b6aecdfa047d8dc4441adc026bd3a8 100644 (file)
@@ -392,40 +392,31 @@ HEADER_CHECKS(5)                                              HEADER_CHECKS(5)
        <b>Return-Path:</b>.
 
 <b>CONFIGURATION PARAMETERS</b>
-       <b><a href="postconf.5.html#body_checks">body_checks</a></b>
-              Lookup  tables with content filter rules for message body lines.
-              These filters see one physical line at a time, in chunks  of  at
-              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>
-              The amount of content per message body segment (attachment) that
-              is subjected to <b>$<a href="postconf.5.html#body_checks">body_checks</a></b> filtering.
-
-       <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></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></b> (default: <b>$<a href="postconf.5.html#header_checks">header_checks</a></b>)
-              Lookup tables with  content  filter  rules  for  message  header
-              lines:  respectively,  these  are applied to the initial message
-              headers (not including MIME headers), to the MIME  headers  any-
-              where  in  the  message,  and to the initial headers of attached
-              messages.
-
-              Note: these filters see one logical message header  at  a  time,
-              even when a message header spans multiple lines. Message headers
-              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><a href="postconf.5.html#body_checks">body_checks</a> (empty)</b>
+              Optional  lookup  tables  for content inspection as specified in
+              the <a href="header_checks.5.html"><b>body_checks</b>(5)</a> manual page.
+
+       <b><a href="postconf.5.html#body_checks_size_limit">body_checks_size_limit</a> (51200)</b>
+              How much text in a message body segment (or attachment,  if  you
+              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> (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> ($<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> ($<a href="postconf.5.html#header_checks">header_checks</a>)</b>
+              Optional lookup tables for content inspection of  non-MIME  mes-
+              sage   headers   in  attached  messages,  as  described  in  the
+              <a href="header_checks.5.html"><b>header_checks</b>(5)</a> manual page.
+
+       <b><a href="postconf.5.html#disable_mime_input_processing">disable_mime_input_processing</a> (no)</b>
+              Turn off MIME processing while receiving mail.
 
 <b>EXAMPLES</b>
        Header pattern to block attachments with bad file name extensions.  For
index bebc17b3f8a4b6bb52a9c873516f24067696eaac..bf6051d2c18991ddbffe86b7f24d46b84723987d 100644 (file)
@@ -455,9 +455,11 @@ SENDMAIL(1)                                                        SENDMAIL(1)
               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>
-              Don't rewrite message headers from remote clients  at  all  when
-              this  parameter is empty; otherwise, rewrite message headers and
-              append the specified domain name to incomplete addresses.
+              Rewrite or add message headers in mail from  remote  clients  if
+              the  <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a>  parameter value is non-empty,
+              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>
               The syslog facility of Postfix logging.
index bebc17b3f8a4b6bb52a9c873516f24067696eaac..bf6051d2c18991ddbffe86b7f24d46b84723987d 100644 (file)
@@ -455,9 +455,11 @@ SENDMAIL(1)                                                        SENDMAIL(1)
               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>
-              Don't rewrite message headers from remote clients  at  all  when
-              this  parameter is empty; otherwise, rewrite message headers and
-              append the specified domain name to incomplete addresses.
+              Rewrite or add message headers in mail from  remote  clients  if
+              the  <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a>  parameter value is non-empty,
+              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>
               The syslog facility of Postfix logging.
index 72a4abfc259332bf769a19cdb84f55de94d61a5e..bc4293a375118bc6327114a8b2947ab275256d77 100644 (file)
@@ -70,7 +70,7 @@ POSTDROP(1)                                                        POSTDROP(1)
               figuration files.
 
        <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
               name=value environment overrides.
 
index 3156fc4a03b160e55c616a72c7790f1214037174..9ca7c59f15f543c6f2fed494ac2fe897e7953145 100644 (file)
@@ -63,7 +63,7 @@ POSTKICK(1)                                                        POSTKICK(1)
               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>
-              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 environment overrides.
 
index 0ca0b57ccaee34b7d20d474cf1158746237d51c9..9750f9bc7bc88c044129559a0c00f34916227dca 100644 (file)
@@ -93,7 +93,7 @@ POSTLOCK(1)                                                        POSTLOCK(1)
               figuration files.
 
        <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
               name=value environment overrides.
 
index 30a524a4d540cf859682e4790e6ed40cd80b92a0..cf0681adf74ef014dc5401b7d90ee4a1450b0e1f 100644 (file)
@@ -275,7 +275,7 @@ POSTSUPER(1)                                                      POSTSUPER(1)
               subdirectory levels.
 
        <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
               name=value environment overrides.
 
index bfaa05fdba005f65c58f20f653aaa612987a3138..068b25673a0d3c78eb510447c6575f054555b265 100644 (file)
@@ -232,8 +232,8 @@ QMGR(8)                                                                QMGR(8)
               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>
-              The  default  per-transport  maximum  delay  between  recipients
-              refills.
+              The default per-transport maximum delay between refilling recip-
+              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>
               A    transport-specific   override   for   the   <a href="postconf.5.html#default_recipient_refill_delay">default_recipi</a>-
index 9506cfa44eb1c6960cf1c2219c02d841cc1a9d44..55cbcdcda51b83efbab9d942d76db14acf7e85ea 100644 (file)
@@ -61,7 +61,7 @@ QMQPD(8)                                                              QMQPD(8)
 
        <b><a href="postconf.5.html#smtputf8_enable">smtputf8_enable</a> (yes)</b>
               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>
               Detect  that  a message requires SMTPUTF8 support for the speci-
index efd2f53adc51d0670447cdc2d9d19744cca0f9c9..62a580a612d9bc8861679208c04cd3da3148dbc0 100644 (file)
@@ -125,8 +125,8 @@ RELOCATED(5)                                                      RELOCATED(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>
@@ -137,8 +137,9 @@ RELOCATED(5)                                                      RELOCATED(5)
               and that locally posted mail is delivered 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="trivial-rewrite.8.html">trivial-rewrite(8)</a>, address resolver
index bebc17b3f8a4b6bb52a9c873516f24067696eaac..bf6051d2c18991ddbffe86b7f24d46b84723987d 100644 (file)
@@ -455,9 +455,11 @@ SENDMAIL(1)                                                        SENDMAIL(1)
               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>
-              Don't rewrite message headers from remote clients  at  all  when
-              this  parameter is empty; otherwise, rewrite message headers and
-              append the specified domain name to incomplete addresses.
+              Rewrite or add message headers in mail from  remote  clients  if
+              the  <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a>  parameter value is non-empty,
+              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>
               The syslog facility of Postfix logging.
index 1bcd8e7d5235675ddf526b6d3e721d30a64a134e..7b1e3e3559d8ede5e93d95f27d00de57b0b7e4d9 100644 (file)
@@ -134,9 +134,11 @@ TRIVIAL-REWRITE(8)                                          TRIVIAL-REWRITE(8)
        Available in Postfix 2.2 and later:
 
        <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
-              this parameter is empty; otherwise, rewrite message headers  and
-              append the specified domain name to incomplete addresses.
+              Rewrite  or  add  message headers in mail from remote clients if
+              the <a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> parameter value  is  non-empty,
+              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>
        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>
               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>
               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>,
-              $<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#virtual_mailbox_domains">box_domains</a>, or $<a href="postconf.5.html#relay_domains">relay_domains</a>.
+              the  default  domain  class: recipient domains that do not match
+              $<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_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>
               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.
 
        <b><a href="postconf.5.html#relayhost">relayhost</a> (empty)</b>
-              The  next-hop  destination(s)  for  non-local  mail;   overrides
-              non-<a href="ADDRESS_CLASS_README.html#local_domain_class">local domains</a> in recipient addresses.
+              The next-hop destination(s) for non-local mail; takes precedence
+              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>
               Optional  lookup  tables with mappings from recipient address to
index 23d60124aa28902e7abbebdb7e1385ebab0e5f15..9dffd688e4bf2e9ceaaee96b40452e8284ffa581 100644 (file)
@@ -78,7 +78,7 @@ environment parameter.
 The default location of the Postfix main.cf and master.cf
 configuration files.
 .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
 environment overrides.
 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index 6cd0ef655c42c77a73c2cc37fe9e46cba8ee1a31..779a35344e9983186ad23400518f9e2c06c20f37 100644 (file)
@@ -66,7 +66,7 @@ configuration files.
 How long the \fBpostkick\fR(1) command waits for a request to enter the
 Postfix daemon process input buffer before giving up.
 .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
 environment overrides.
 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index cd468e7c2399a493c3463a16dc15bfebeb0ccec2..6c07319bf852d4daa692c1b3c4d4af33e5e4e65c 100644 (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
 configuration files.
 .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
 environment overrides.
 .SH "SEE ALSO"
index 885330f1dc4f51316c0e47acc3fe1eb846e7b793..8c5da034d4d5918ba47f204185bf2a3b9349556b 100644 (file)
@@ -46,7 +46,7 @@ from standard input. For example, to delete all mail
 with exactly one recipient \fBuser@example.com\fR:
 .sp
 .nf
-postqueue \-j | jq -r '
+postqueue \-j | jq \-r '
     # See JSON OBJECT FORMAT section in the postqueue(1) manpage
     select(.recipients[0].address == "user@example.com")
     | select(.recipients[1].address == null)
@@ -54,7 +54,7 @@ postqueue \-j | jq -r '
  ' | postsuper \-d \-
 .fi
 .sp
-(note the "jq -r" option), or the historical form:
+(note the "jq \-r" option), or the historical form:
 .sp
 .nf
 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
 subdirectory levels.
 .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
 environment overrides.
 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index 22affe63752119cb96d79a66ef1c7a5d340a7596..e3bc7a639eb5dd456f94b31ee2b4f8ad87237d18 100644 (file)
@@ -440,9 +440,10 @@ daemon processes.
 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
 The location of the Postfix top\-level queue directory.
 .IP "\fBremote_header_rewrite_domain (empty)\fR"
-Don't rewrite message headers from remote clients at all when
-this parameter is empty; otherwise, rewrite message headers and
-append the specified domain name to incomplete addresses.
+Rewrite or add message headers in mail from remote clients if
+the remote_header_rewrite_domain parameter value is non\-empty,
+updating incomplete addresses with the domain specified in the
+remote_header_rewrite_domain parameter, and adding missing headers.
 .IP "\fBsyslog_facility (mail)\fR"
 The syslog facility of Postfix logging.
 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
index 46c47420c02b3f139a0523509ba06a6d1bdd54ac..ed6a10fd17e3124e935ef391f0ad3750eb75d893 100644 (file)
@@ -170,8 +170,8 @@ 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"
 Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
-delivery, unlike virtual_alias_maps that apply to all email deliveries:
-\fBlocal\fR(8), virtual, and remote.
+recipients; this is unlike virtual_alias_maps that apply to all
+recipients: \fBlocal\fR(8), virtual, and remote.
 .IP "\fBallow_mail_to_commands (alias, forward)\fR"
 Restrict \fBlocal\fR(8) mail delivery to external commands.
 .IP "\fBallow_mail_to_files (alias, forward)\fR"
index e9876643b4a55510948caef8dae20511b588762a..8776f3b7d0a81ff8106871815616f3435d4d3cc2 100644 (file)
@@ -231,17 +231,14 @@ key to the lookup result.
 .PP
 Other parameters of interest:
 .IP "\fBinet_interfaces (all)\fR"
-The network interface addresses that this mail system receives
-mail on.
+The local network interface addresses that this mail system
+receives mail on.
 .IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR"
-Rewrite message header addresses in mail from these clients and
-update incomplete addresses with the domain name in $myorigin or
-$mydomain; either don't rewrite message headers from other clients
-at all, or rewrite message headers and update incomplete addresses
-with the domain specified in the remote_header_rewrite_domain
-parameter.
+Rewrite or add message headers in mail from these clients,
+updating incomplete addresses with the domain name in $myorigin or
+$mydomain, and adding missing headers.
 .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.
 .IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR"
 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
 is set to "\-".
 .IP "\fBremote_header_rewrite_domain (empty)\fR"
-Don't rewrite message headers from remote clients at all when
-this parameter is empty; otherwise, rewrite message headers and
-append the specified domain name to incomplete addresses.
+Rewrite or add message headers in mail from remote clients if
+the remote_header_rewrite_domain parameter value is non\-empty,
+updating incomplete addresses with the domain specified in the
+remote_header_rewrite_domain parameter, and adding missing headers.
 .SH "SEE ALSO"
 .na
 .nf
index 6e891eb84b575248d0dd0a97e409585b6b5fffa9..b474530315819b176c8ad574b224dd29cfe16086 100644 (file)
@@ -214,10 +214,10 @@ key to the lookup result.
 .PP
 Other parameters of interest:
 .IP "\fBinet_interfaces (all)\fR"
-The network interface addresses that this mail system receives
-mail on.
+The local network interface addresses that this mail system
+receives mail on.
 .IP "\fBproxy_interfaces (empty)\fR"
-The 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.
 .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 The list of domains that are delivered via the $local_transport
index 31ac7dcaf69433f14178e13c4b0f05612fed5c05..92c1de95ed5900648dd4540fd4780e64c13a359f 100644 (file)
@@ -417,34 +417,24 @@ be examined before they are deleted. Examples are: \fBBcc:\fR,
 .nf
 .ad
 .fi
-.IP \fBbody_checks\fR
-Lookup tables with content filter rules for message body lines.
-These filters see one physical line at a time, in chunks of
-at most \fB$line_length_limit\fR bytes.
-.IP \fBbody_checks_size_limit\fP
-The amount of content per message body segment (attachment) that is
-subjected to \fB$body_checks\fR filtering.
-.IP \fBheader_checks\fR
-.IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)"
-.IP "\fBnested_header_checks\fR (default: \fB$header_checks\fR)"
-Lookup tables with content filter rules for message header lines:
-respectively, these are applied to the initial message headers
-(not including MIME headers), to the MIME headers anywhere in
-the message, and to the initial headers of attached messages.
-.sp
-Note: these filters see one logical message header at a time, even
-when a message header spans multiple lines. Message headers that
-are longer than \fB$header_size_limit\fR characters are truncated.
-.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.
+.IP "\fBbody_checks (empty)\fR"
+Optional lookup tables for content inspection as specified in
+the \fBbody_checks\fR(5) manual page.
+.IP "\fBbody_checks_size_limit (51200)\fR"
+How much text in a message body segment (or attachment, if you
+prefer to use that term) is subjected to body_checks inspection.
+.IP "\fBheader_checks (empty)\fR"
+Optional lookup tables for content inspection of primary non\-MIME
+message headers, as specified in the \fBheader_checks\fR(5) manual page.
+.IP "\fBmime_header_checks ($header_checks)\fR"
+Optional lookup tables for content inspection of MIME related
+message headers, as described in the \fBheader_checks\fR(5) manual page.
+.IP "\fBnested_header_checks ($header_checks)\fR"
+Optional lookup tables for content inspection of non\-MIME message
+headers in attached messages, as described in the \fBheader_checks\fR(5)
+manual page.
+.IP "\fBdisable_mime_input_processing (no)\fR"
+Turn off MIME processing while receiving mail.
 .SH "EXAMPLES"
 .na
 .nf
index fbc85a3918f006304543785e3de117d9510e4154..e1d7863b478c9497654b09a5bffc31317527c52d 100644 (file)
@@ -147,8 +147,8 @@ domains that no longer exist.
 .PP
 Other parameters of interest:
 .IP "\fBinet_interfaces (all)\fR"
-The network interface addresses that this mail system receives
-mail on.
+The local network interface addresses that this mail system
+receives mail on.
 .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 The list of domains that are delivered via the $local_transport
 mail delivery transport.
@@ -156,7 +156,7 @@ mail delivery transport.
 The domain name that locally\-posted mail appears to come
 from, and that locally posted mail is delivered 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
index bf555489eea96adba8c3509c72b2b14fba9f01f1..6c6cef3ddaf476b2c51cbfd5724026c9fb68c095 100644 (file)
@@ -55,7 +55,8 @@ configuration files.
 How much time a Postfix daemon process may take to handle a
 request before it is terminated by a built\-in watchdog timer.
 .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.
 .IP "\fBipc_timeout (3600s)\fR"
 The time limit for sending or receiving information over an internal
index a24af71960372fd5b206a5a91aedfe03a704c2c3..ca1fd4c797b4be11d7933c9c7f336eb53649b886 100644 (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
 the message delivery transport.
 .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"
 A transport\-specific override for the default_recipient_refill_delay
 parameter value, where \fItransport\fR is the master.cf name of
index 9ee62675f59ec3e221e37594f82b830fb1092fe1..0f0a82bc7a826e53279a5c4afb41b1c18e992a1d 100644 (file)
@@ -75,7 +75,7 @@ filtering, or address mapping.
 Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
 .IP "\fBsmtputf8_enable (yes)\fR"
 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"
 Detect that a message requires SMTPUTF8 support for the specified
 mail origin classes.
index e41da7190b84f08f6c86d8378e9895d3d472d3ab..f2c39fb801db53614871950408867baa764bdfe6 100644 (file)
@@ -142,9 +142,10 @@ Enable the rewriting of "site!user" into "user@site".
 .PP
 Available in Postfix 2.2 and later:
 .IP "\fBremote_header_rewrite_domain (empty)\fR"
-Don't rewrite message headers from remote clients at all when
-this parameter is empty; otherwise, rewrite message headers and
-append the specified domain name to incomplete addresses.
+Rewrite or add message headers in mail from remote clients if
+the remote_header_rewrite_domain parameter value is non\-empty,
+updating incomplete addresses with the domain specified in the
+remote_header_rewrite_domain parameter, and adding missing headers.
 .SH "ROUTING CONTROLS"
 .na
 .nf
@@ -163,10 +164,12 @@ The default mail delivery transport and next\-hop destination for
 final delivery to domains listed with $virtual_mailbox_domains.
 .IP "\fBrelay_transport (relay)\fR"
 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"
 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,
 or $relay_domains.
 .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,
 instead of requiring an explicit ".example.com" pattern.
 .IP "\fBrelayhost (empty)\fR"
-The next\-hop destination(s) for non\-local mail; overrides non\-local
-domains in recipient addresses.
+The next\-hop destination(s) for non\-local mail; takes precedence
+over non\-local domains in recipient addresses.
 .IP "\fBtransport_maps (empty)\fR"
 Optional lookup tables with mappings from recipient address to
 (message delivery transport, next\-hop destination).
index 1f6a0ed29e4979fd0991f5a4c882e605c5df40dd..f48a00b1ef46f5734ca00ec9197b5603c1dd9bd9 100644 (file)
 #      "\fBnewaliases\fR" or with "\fBsendmail -bi\fR".
 # .IP "\fBalias_maps (see 'postconf -d' output)\fR"
 #      Optional lookup tables with aliases that apply only to \fBlocal\fR(8)
-#      delivery, unlike virtual_alias_maps that apply to all email deliveries:
-#      \fBlocal\fR(8), virtual, and remote.
+#      recipients; this is unlike virtual_alias_maps that apply to all
+#      recipients: \fBlocal\fR(8), virtual, and remote.
 # .IP "\fBallow_mail_to_commands (alias, forward)\fR"
 #      Restrict \fBlocal\fR(8) mail delivery to external commands.
 # .IP "\fBallow_mail_to_files (alias, forward)\fR"
index 6364d3e1dae5968cdebcfc170f07a5671eb472a4..5ffc8d1810ffc9171af6f6f5aff3818d290c0797 100644 (file)
 # .PP
 #      Other parameters of interest:
 # .IP "\fBinet_interfaces (all)\fR"
-#      The network interface addresses that this mail system receives
-#      mail on.
+#      The local network interface addresses that this mail system
+#      receives mail on.
 # .IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR"
-#      Rewrite message header addresses in mail from these clients and
-#      update incomplete addresses with the domain name in $myorigin or
-#      $mydomain; either don't rewrite message headers from other clients
-#      at all, or rewrite message headers and update incomplete addresses
-#      with the domain specified in the remote_header_rewrite_domain
-#      parameter.
+#      Rewrite or add message headers in mail from these clients,
+#      updating incomplete addresses with the domain name in $myorigin or
+#      $mydomain, and adding missing headers.
 # .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.
 # .IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR"
 #      What addresses are subject to address masquerading.
 #      \fIlistname\fR-request address localparts when the recipient_delimiter
 #      is set to "-".
 # .IP "\fBremote_header_rewrite_domain (empty)\fR"
-#      Don't rewrite message headers from remote clients at all when
-#      this parameter is empty; otherwise, rewrite message headers and
-#      append the specified domain name to incomplete addresses.
+#      Rewrite or add message headers in mail from remote clients if
+#      the remote_header_rewrite_domain parameter value is non-empty,
+#      updating incomplete addresses with the domain specified in the
+#      remote_header_rewrite_domain parameter, and adding missing headers.
 # SEE ALSO
 #      cleanup(8), canonicalize and enqueue mail
 #      postmap(1), Postfix lookup table manager
index fdeb1eac56a8d3736d07ec35408589569811e300..dc0ad417723583ecd0359b13415ab190376890d5 100644 (file)
 # .PP
 #      Other parameters of interest:
 # .IP "\fBinet_interfaces (all)\fR"
-#      The network interface addresses that this mail system receives
-#      mail on.
+#      The local network interface addresses that this mail system
+#      receives mail on.
 # .IP "\fBproxy_interfaces (empty)\fR"
-#      The 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.
 # .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 #      The list of domains that are delivered via the $local_transport
index 1aa6f5a712fd21a165a59f55270226184ddf5d61..9a6b55c8b1764eff41c807942dae078c7c78a1eb 100644 (file)
 # CONFIGURATION PARAMETERS
 # .ad
 # .fi
-# .IP \fBbody_checks\fR
-#      Lookup tables with content filter rules for message body lines.
-#      These filters see one physical line at a time, in chunks of
-#      at most \fB$line_length_limit\fR bytes.
-# .IP \fBbody_checks_size_limit\fP
-#      The amount of content per message body segment (attachment) that is
-#      subjected to \fB$body_checks\fR filtering.
-# .IP \fBheader_checks\fR
-# .IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)"
-# .IP "\fBnested_header_checks\fR (default: \fB$header_checks\fR)"
-#      Lookup tables with content filter rules for message header lines:
-#      respectively, these are applied to the initial message headers
-#      (not including MIME headers), to the MIME headers anywhere in
-#      the message, and to the initial headers of attached messages.
-# .sp
-#      Note: these filters see one logical message header at a time, even
-#      when a message header spans multiple lines. Message headers that
-#      are longer than \fB$header_size_limit\fR characters are truncated.
-# .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.
+# .IP "\fBbody_checks (empty)\fR"
+#      Optional lookup tables for content inspection as specified in
+#      the \fBbody_checks\fR(5) manual page.
+# .IP "\fBbody_checks_size_limit (51200)\fR"
+#      How much text in a message body segment (or attachment, if you
+#      prefer to use that term) is subjected to body_checks inspection.
+# .IP "\fBheader_checks (empty)\fR"
+#      Optional lookup tables for content inspection of primary non-MIME
+#      message headers, as specified in the \fBheader_checks\fR(5) manual page.
+# .IP "\fBmime_header_checks ($header_checks)\fR"
+#      Optional lookup tables for content inspection of MIME related
+#      message headers, as described in the \fBheader_checks\fR(5) manual page.
+# .IP "\fBnested_header_checks ($header_checks)\fR"
+#      Optional lookup tables for content inspection of non-MIME message
+#      headers in attached messages, as described in the \fBheader_checks\fR(5)
+#      manual page.
+# .IP "\fBdisable_mime_input_processing (no)\fR"
+#      Turn off MIME processing while receiving mail.
 # EXAMPLES
 # .ad
 # .fi
index a0a54cadf1ddfed1050b0e84aeb2406530b9faf2..b517b354fdf8a3377cfb920c239b5ae7136d66fe 100644 (file)
 # .PP
 #      Other parameters of interest:
 # .IP "\fBinet_interfaces (all)\fR"
-#      The network interface addresses that this mail system receives
-#      mail on.
+#      The local network interface addresses that this mail system
+#      receives mail on.
 # .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
 #      The list of domains that are delivered via the $local_transport
 #      mail delivery transport.
 #      The domain name that locally-posted mail appears to come
 #      from, and that locally posted mail is delivered 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
 #      trivial-rewrite(8), address resolver
index bc87c4b5948eee0a8854b5bd99981cc892bf2c5c..7a4a4460fd5d595e5732884007c32f2e87775c97 100644 (file)
@@ -43,7 +43,8 @@
 /*     How much time a Postfix daemon process may take to handle a
 /*     request before it is terminated by a built-in watchdog timer.
 /* .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.
 /* .IP "\fBipc_timeout (3600s)\fR"
 /*     The time limit for sending or receiving information over an internal
index 82ffec7387a8662249d6852d9a0b8974acd91b80..63d89a72305d4b2c6c8a9c4346af5606d84365be 100644 (file)
@@ -20,7 +20,7 @@
   * Patches change both the patchlevel and the release date. Snapshots have no
   * patchlevel; they change the release date only.
   */
-#define MAIL_RELEASE_DATE      "20240124"
+#define MAIL_RELEASE_DATE      "20240125"
 #define MAIL_VERSION_NUMBER    "3.9"
 
 #ifdef SNAPSHOT
index e9335e99a9153356cd639b94092b2ad7f1f87669..66c9ea58528f613df37617889a42e9fcffee96ee 100644 (file)
@@ -64,7 +64,7 @@
 /*     The default location of the Postfix main.cf and master.cf
 /*     configuration files.
 /* .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
 /*     environment overrides.
 /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index 6bf924552154b6a22d014daa6d621fa011cb9aa0..a1ce55c709d32809c72c3d007de3a6d770a4256f 100644 (file)
@@ -54,7 +54,7 @@
 /*     How long the \fBpostkick\fR(1) command waits for a request to enter the
 /*     Postfix daemon process input buffer before giving up.
 /* .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
 /*     environment overrides.
 /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index a05d11ed6c1ac2e7832f6707ca0af86bd49831bb..972577be1ff062770c4cff699c05016cdeb98282 100644 (file)
@@ -79,7 +79,7 @@
 /*     The default location of the Postfix main.cf and master.cf
 /*     configuration files.
 /* .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
 /*     environment overrides.
 /* SEE ALSO
index d3f2d5bcddd54794dc0cdc8ccaa51be87c1944fb..c9b8e38c67710a0db37df6e598db284671bd2280 100644 (file)
 /*     The names of queue directories that are split across multiple
 /*     subdirectory levels.
 /* .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
 /*     environment overrides.
 /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
index 9d90a6ec9d6741d45603d210b189b6427007c318..25168e482c7d63cc9b66790640ed24bf7ac15db0 100644 (file)
 /*     parameter value, where \fItransport\fR is the master.cf name of
 /*     the message delivery transport.
 /* .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"
 /*     A transport-specific override for the default_recipient_refill_delay
 /*     parameter value, where \fItransport\fR is the master.cf name of
index d94d33dc7c70d40cd2d5ce21324635c9d18710e2..138ac64c930824b0de3471a55b325cccf8d5c0d5 100644 (file)
@@ -57,7 +57,7 @@
 /*     Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
 /* .IP "\fBsmtputf8_enable (yes)\fR"
 /*     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"
 /*     Detect that a message requires SMTPUTF8 support for the specified
 /*     mail origin classes.
index 27b3543457dd09e6e45aa7e40018425a4ef445de..df052c5b0e701e41fc15460d78409b610433314b 100644 (file)
 /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
 /*     The location of the Postfix top-level queue directory.
 /* .IP "\fBremote_header_rewrite_domain (empty)\fR"
-/*     Don't rewrite message headers from remote clients at all when
-/*     this parameter is empty; otherwise, rewrite message headers and
-/*     append the specified domain name to incomplete addresses.
+/*     Rewrite or add message headers in mail from remote clients if
+/*     the remote_header_rewrite_domain parameter value is non-empty,
+/*     updating incomplete addresses with the domain specified in the
+/*     remote_header_rewrite_domain parameter, and adding missing headers.
 /* .IP "\fBsyslog_facility (mail)\fR"
 /*     The syslog facility of Postfix logging.
 /* .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
index b586368360972cb3bcd187f7bc69a114ea768db7..d32e63d4b9d3f42423403457e28213f18b178d17 100644 (file)
@@ -819,19 +819,9 @@ static void tlsmgr_service(VSTREAM *client_stream, char *unused_service,
     }
 
     /*
-     * Protocol error.
-     */
-    else {
-       attr_print(client_stream, ATTR_FLAG_NONE,
-                  SEND_ATTR_INT(MAIL_ATTR_STATUS, TLS_MGR_STAT_FAIL),
-                  ATTR_TYPE_END);
-    }
-    vstream_fflush(client_stream);
-
-    /*
-     * Reportedly, some OS lies under load; it tells the Postfix event
+     * 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 pending data, and then it tells vstring_get_null() 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.
@@ -839,9 +829,21 @@ static void tlsmgr_service(VSTREAM *client_stream, char *unused_service,
      * 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))
+    else if (vstream_ferror(client_stream) || vstream_feof(client_stream)) {
        multi_server_disconnect(client_stream);
-    /* Note: client_stream is now a dangling pointer. */
+       return;
+       /* Note: client_stream is now a dangling pointer. */
+    }
+
+    /*
+     * Protocol error.
+     */
+    else {
+       attr_print(client_stream, ATTR_FLAG_NONE,
+                  SEND_ATTR_INT(MAIL_ATTR_STATUS, TLS_MGR_STAT_FAIL),
+                  ATTR_TYPE_END);
+    }
+    vstream_fflush(client_stream);
 }
 
 /* tlsmgr_pre_init - pre-jail initialization */
index 675af80f8f088b0e7f7ab6d37d5346d3162d0330..bb8da091d7f9756e6873207fa6cce5bbc7e12c5a 100644 (file)
 /* .PP
 /*     Available in Postfix 2.2 and later:
 /* .IP "\fBremote_header_rewrite_domain (empty)\fR"
-/*     Don't rewrite message headers from remote clients at all when
-/*     this parameter is empty; otherwise, rewrite message headers and
-/*     append the specified domain name to incomplete addresses.
+/*     Rewrite or add message headers in mail from remote clients if
+/*     the remote_header_rewrite_domain parameter value is non-empty,
+/*     updating incomplete addresses with the domain specified in the
+/*     remote_header_rewrite_domain parameter, and adding missing headers.
 /* ROUTING CONTROLS
 /* .ad
 /* .fi
 /*     final delivery to domains listed with $virtual_mailbox_domains.
 /* .IP "\fBrelay_transport (relay)\fR"
 /*     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"
 /*     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,
 /*     or $relay_domains.
 /* .IP "\fBparent_domain_matches_subdomains (see 'postconf -d' output)\fR"
 /*     matches subdomains of example.com,
 /*     instead of requiring an explicit ".example.com" pattern.
 /* .IP "\fBrelayhost (empty)\fR"
-/*     The next-hop destination(s) for non-local mail; overrides non-local
-/*     domains in recipient addresses.
+/*     The next-hop destination(s) for non-local mail; takes precedence
+/*     over non-local domains in recipient addresses.
 /* .IP "\fBtransport_maps (empty)\fR"
 /*     Optional lookup tables with mappings from recipient address to
 /*     (message delivery transport, next-hop destination).