From: Stephan Bosch <stephan.bosch@dovecot.fi>
Date: Fri, 19 Oct 2018 15:39:36 +0000 (+0200)
Subject: doc: example-config: Document the new submission_backend_capabilities setting.
X-Git-Tag: 2.3.9~1136
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6a7a98339e836ba7bded6ce6e68388ff512a9f38;p=thirdparty%2Fdovecot%2Fcore.git

doc: example-config: Document the new submission_backend_capabilities setting.
---

diff --git a/doc/example-config/conf.d/20-submission.conf b/doc/example-config/conf.d/20-submission.conf
index 078faf128b..390089c31d 100644
--- a/doc/example-config/conf.d/20-submission.conf
+++ b/doc/example-config/conf.d/20-submission.conf
@@ -77,6 +77,29 @@
 
 # BURL is configured implicitly by IMAP URLAUTH
 
+# Part of the SMTP capabilities that the submission service can offer to the
+# client (as listed in the EHLO reply) depend on those capabilities also being
+# provided by the relay server. These capabilities currently are:
+#
+#   - 8BITMIME
+#   - BINARYMIME
+#   - DSN
+#   - VRFY (always returns 252 without support)
+#
+# By default, the submission service first connects to the relay server to
+# determine the support for such capabilities before sending the initial EHLO
+# reply to the client. If the list of capabilities returned by the relay server
+# is somehow unreliable or it is undesirable to start the connection to the
+# relay server before the first mail transaction is started, the backend
+# capabilities can be configured explicitly using the
+# submission_backend_capabilities setting. This is a space-separated list of
+# SMTP capability names. This setting is only relevant for capabilities that
+# depend on support from the relay server: including (or omitting) capabilities
+# that are not listed above has no effect. When this setting is explicitly set
+# to the empty string, none of the capabilities is enabled. To achieve the
+# default behavior, this setting must be left unconfigured.
+#submission_backend_capabilities =
+
 protocol submission {
   # Space-separated list of plugins to load (default is global mail_plugins).
   #mail_plugins = $mail_plugins