changeset 21596:d99ff372361f

lib-storage: Clarify what MAIL_LOOKUP_ABORT_READ_MAIL means. It should maybe even be renamed to something clearer.
author Timo Sirainen <timo.sirainen@dovecot.fi>
date Fri, 17 Feb 2017 16:14:39 +0200
parents b6b3381b9660
children 47ab3e3483be
files src/lib-storage/mail-storage.h
diffstat 1 files changed, 4 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/src/lib-storage/mail-storage.h	Sun Feb 19 01:44:21 2017 +0200
+++ b/src/lib-storage/mail-storage.h	Fri Feb 17 16:14:39 2017 +0200
@@ -364,7 +364,10 @@
 enum mail_lookup_abort {
 	/* Perform everything no matter what it takes */
 	MAIL_LOOKUP_ABORT_NEVER = 0,
-	/* Abort if the operation would require reading message header/body */
+	/* Abort if the operation would require reading message header/body or
+	   otherwise opening the mail file (e.g. with dbox metadata is read by
+	   opening and reading the file). This still allows somewhat fast
+	   operations to be performed, such as stat()ing a file. */
 	MAIL_LOOKUP_ABORT_READ_MAIL,
 	/* Abort if the operation can't be done fully using cache file */
 	MAIL_LOOKUP_ABORT_NOT_IN_CACHE