@@ -7736,22 +7736,29 @@ See [[link,mail_cache]] for details and for the list of fields.`
77367736
77377737 mail_nfs_index : {
77387738 default : 'no' ,
7739- seealso : [ 'mail_fsync' ] ,
7739+ seealso : [ 'mail_nfs_storage' , ' mail_fsync' ] ,
77407740 values : setting_types . BOOLEAN ,
77417741 text : `
7742- When mail-index files exist in NFS storage and you're running a
7743- multi-server setup that you wish to flush NFS caches, this can be set
7744- to \`yes\` (in this case, make sure also to use [[setting,mmap_disable,yes]]
7745- and [[setting,mail_fsync,optimized]]).`
7742+ This setting attempts to flush NFS caches when accessing index files. The
7743+ intention was that it would allow accessing the same user's index files in
7744+ multiple servers at the same time. However, this couldn't be made to work
7745+ perfectly due to the way Linux and BSD kernels work internally. The setting
7746+ exists for now, but it is not a supported way of running Dovecot.
7747+
7748+ When using this setting, be sure also to use [[setting,mmap_disable,yes]]
7749+ and [[setting,mail_fsync,optimized]].`
77467750 } ,
77477751
77487752 mail_nfs_storage : {
77497753 default : 'no' ,
7754+ seealso : [ 'mail_nfs_index' ] ,
77507755 values : setting_types . BOOLEAN ,
77517756 text : `
7752- Flush NFS caches whenever it is necessary to do so.
7753-
7754- This setting should only be enabled if you are using multiple servers on NFS.`
7757+ This setting attempts to flush NFS caches when accessing mail storage. The
7758+ intention was that it would allow accessing the same user's index files in
7759+ multiple servers at the same time. However, this couldn't be made to work
7760+ perfectly due to the way Linux and BSD kernels work internally. The setting
7761+ exists for now, but it is not a supported way of running Dovecot.`
77557762 } ,
77567763
77577764 mail_plugin_dir : {
0 commit comments