dovecot-2.0: dovecot-master-example.conf: Added some comments.

[dovecot at dovecot.org]

details:   http://hg.dovecot.org/dovecot-2.0/rev/4bd18ca73175
changeset: 9835:4bd18ca73175
user:      Timo Sirainen <tss at iki.fi>
date:      Mon Aug 31 13:00:12 2009 -0400
description:
dovecot-master-example.conf: Added some comments.

diffstat:

1 file changed, 21 insertions(+), 3 deletions(-)
dovecot-master-example.conf |   24 +++++++++++++++++++++---

diffs (70 lines):

diff -r 3f4d796db5fd -r 4bd18ca73175 dovecot-master-example.conf
--- a/dovecot-master-example.conf	Mon Aug 31 12:43:23 2009 -0400
+++ b/dovecot-master-example.conf	Mon Aug 31 13:00:12 2009 -0400
@@ -1,3 +1,6 @@ service config {
+default_process_limit = 100
+default_client_limit = 1000
+
 service config {
   type = config
   executable = config
@@ -33,6 +36,7 @@ service auth {
 
   # default
   unix_listener {
+    # The path must match the auth section name
     path = login/default
     mode = 0666
   }
@@ -62,6 +66,7 @@ service imap-login {
 service imap-login {
   type = auth-source
   executable = imap-login
+  auth_dest_service = imap
 
   inet_listener {
     address = *, ::
@@ -74,19 +79,33 @@ service imap-login {
   }
 
   user = dovecot
+  client_limit = 1
+  # If you increase client_limit, you probably need to grow this.
   vsz_limit = 64
-  client_limit = 1
+  # The only reason not to chroot login process is if you wish to run the
+  # whole Dovecot without roots. <doc/wiki/Rootless.txt>
   chroot = login
-  auth_dest_service = imap
 }
 
 service imap {
+  # This would write rawlogs into user's ~/dovecot.rawlog/, if it exists:
+  #   executable = rawlog /usr/libexec/dovecot/imap
+  # <doc/wiki/Debugging/Rawlog>
+  #
+  # This would attach gdb into the imap process and write backtraces into
+  # /tmp/gdbhelper.* files:
+  #   executable = gdbhelper /usr/libexec/dovecot/imap
   executable = imap
+
+  # Most of the memory goes to mmap()ing files. You may need to increase this
+  # limit if you have huge mailboxes.
+  #vsz_limit = 256
 }
 
 service pop3-login {
   type = auth-source
   executable = pop3-login
+  auth_dest_service = pop3
 
   inet_listener {
     address = *, ::
@@ -102,7 +121,6 @@ service pop3-login {
   vsz_limit = 64
   client_limit = 1
   chroot = login
-  auth_dest_service = pop3
 }
 
 service pop3 {