Skip to content

Commit f29c563

Browse files
sirainencmouse
authored andcommitted
data/settings: Clarify mail_nfs_* settings are not supported
1 parent bad9b4f commit f29c563

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

data/settings.js

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)