summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJeremy Harris <jgh146exb@wizmail.org>2019-08-01 19:31:36 +0100
committerJeremy Harris <jgh146exb@wizmail.org>2019-08-10 19:27:02 +0100
commitdbbf21a75d225871cb7a44878ece42c5d79a1a2c (patch)
tree3e96a3cdce26cee348aac179eb1e56ea11f5f203 /doc
parent30afa09ebdb98fdb50fc60f0ce0cb4974bde1225 (diff)
Routers: make retry_use_local_part default true when any non-domain condition is present. Bug 2408
Diffstat (limited to 'doc')
-rw-r--r--doc/doc-docbook/spec.xfpt15
-rw-r--r--doc/doc-txt/ChangeLog6
2 files changed, 20 insertions, 1 deletions
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index 736ac0fe4..aa3996505 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -18884,11 +18884,24 @@ latter kind.
This option controls whether the local part is used to form the key for retry
hints for addresses that suffer temporary errors while being handled by this
-router. The default value is true for any router that has &%check_local_user%&
+.new
+router. The default value is true for any router that has any of
+&%check_local_user%&,
+&%local_parts%&,
+&%condition%&,
+&%local_part_prefix%&,
+&%local_part_suffix%&,
+&%senders%& or
+&%require_files%&
+.wen
set, and false otherwise. Note that this option does not apply to hints keys
for transport delays; they are controlled by a generic transport option of the
same name.
+Failing to set this option when it is needed
+(because a remote router handles only some of the local-parts for a domain)
+can result in incorrect error messages being generated.
+
The setting of &%retry_use_local_part%& applies only to the router on which it
appears. If the router generates child addresses, they are routed
independently; this setting does not become attached to them.
diff --git a/doc/doc-txt/ChangeLog b/doc/doc-txt/ChangeLog
index 7fca99b62..6d1b2631b 100644
--- a/doc/doc-txt/ChangeLog
+++ b/doc/doc-txt/ChangeLog
@@ -164,6 +164,12 @@ JH/34 Fix crash after TLS shutdown. When the TCP/SMTP channel was left open,
JH/35 Bug 2409: filter out-of-spec chars from callout response before using
them in our smtp response.
+JH/35 Have the general router option retry_use_local_part default to true when
+ any of the restrictive preconditions are set (to anything). Previously it
+ was only for check_local user. The change removes one item of manual
+ configuration which is required for proper retries when a remote router
+ handles a subset of addresses for a domain.
+
Exim version 4.92
-----------------