From: Timo Sirainen <timo.sirainen@dovecot.fi>
Date: Sun, 19 Feb 2017 23:00:05 +0000 (+0200)
Subject: example-config: Add imap_fetch_failure setting.
X-Git-Tag: 2.3.0.rc1~2050
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=263e4212e599da3e9aa8f6090112de889f81c021;p=thirdparty%2Fdovecot%2Fcore.git

example-config: Add imap_fetch_failure setting.
---

diff --git a/doc/example-config/conf.d/20-imap.conf b/doc/example-config/conf.d/20-imap.conf
index dfae29d19c..29f7224665 100644
--- a/doc/example-config/conf.d/20-imap.conf
+++ b/doc/example-config/conf.d/20-imap.conf
@@ -71,6 +71,19 @@
 # Enable IMAP LITERAL- extension (replaces LITERAL+)
 #imap_literal_minus = no
 
+# What happens when FETCH fails due to some internal error:
+#   disconnect-immediately:
+#     The FETCH is aborted immediately and the IMAP client is disconnected.
+#   disconnect-after:
+#     The FETCH runs for all the requested mails returning as much data as
+#     possible. The client is finally disconnected without a tagged reply.
+#   no-after:
+#     Same as disconnect-after, but tagged NO reply is sent instead of
+#     disconnecting the client. If the client attempts to FETCH the same failed
+#     mail more than once, the client is disconnected. This is to avoid clients
+#     from going into infinite loops trying to FETCH a broken mail.
+#imap_fetch_failure = disconnect-immediately
+
 protocol imap {
   # Space separated list of plugins to load (default is global mail_plugins).
   #mail_plugins = $mail_plugins