Mercurial > dovecot > original-hg > dovecot-1.2
changeset 3021:b987319c7ce3 HEAD
Updated mail_cache_fields and mail_never_cache_fields comments.
author | Timo Sirainen <tss@iki.fi> |
---|---|
date | Tue, 28 Dec 2004 17:57:13 +0200 |
parents | d81d15553644 |
children | f2d7d6dcedd7 |
files | dovecot-example.conf |
diffstat | 1 files changed, 19 insertions(+), 24 deletions(-) [+] |
line wrap: on
line diff
--- a/dovecot-example.conf Tue Dec 28 17:42:14 2004 +0200 +++ b/dovecot-example.conf Tue Dec 28 17:57:13 2004 +0200 @@ -224,34 +224,29 @@ #hidden = yes #} -# Space-separated list of fields to cache for all mails. Currently these -# fields are allowed followed by a list of commands they speed up: +# Space-separated list of fields to initially save into cache file. Currently +# these fields are allowed: # -# Envelope - FETCH ENVELOPE and SEARCH FROM, TO, CC, BCC, SUBJECT, -# SENTBEFORE, SENTON, SENTSINCE, HEADER MESSAGE-ID, -# HEADER IN-REPLY-TO -# Body - FETCH BODY -# Bodystructure - FETCH BODY, BODYSTRUCTURE -# MessagePart - FETCH BODY[1.2.3] (ie. body parts), RFC822.SIZE, -# SEARCH SMALLER, LARGER, also speeds up BODY/BODYSTRUCTURE -# generation. This is always set with mbox mailboxes, and -# also default with Maildir. +# flags, date.sent, date.received, size.virtual, size.physical +# mime.parts, imap.body, imap.bodystructure +# +# Different IMAP clients work in different ways, so they benefit from +# different cached fields. Some do not benefit from them at all. Caching more +# than necessary generates useless disk I/O, so you don't want to do that +# either. # -# Different IMAP clients work in different ways, that's why Dovecot by default -# only caches MessagePart which speeds up most operations. Whenever client -# does something where caching could be used, the field is automatically marked -# to be cached later. For example after FETCH BODY the BODY will be cached -# for all new messages. Normally you should leave this alone, unless you know -# what most of your IMAP clients are. Caching more fields than needed makes -# the index files larger and generate useless I/O. +# Dovecot attempts to automatically figure out what client wants and it keeps +# only that. However the first few times a mailbox is opened, Dovecot hasn't +# yet figured out what client needs, so it may not perform optimally. If you +# know what fields the majority of your clients need, it may be useful to set +# these fields by hand. If client doesn't actually use them, Dovecot will +# eventually drop them. # -# With maildir there's one extra optimization - if nothing is cached, indexing -# the maildir becomes much faster since it's not opening any of the mail files. -# This could be useful if your IMAP clients access only new mails. +# Usually you should just leave this field alone. The potential benefits are +# typically unnoticeable. +#mail_cache_fields = -#mail_cache_fields = MessagePart - -# Space-separated list of fields that Dovecot should never set to be cached. +# Space-separated list of fields that Dovecot should never save to cache file. # Useful if you want to save disk space at the cost of more I/O when the fields # needed. #mail_never_cache_fields =