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

--HG--
branch : HEAD

diff --git a/dovecot-master-example.conf b/dovecot-master-example.conf
index 167a848b965ac65cd21cbbb07be4d83b2d474724..becf84dbb94fe138239f9f0c465e719b370912fc 100644 (file)
--- a/dovecot-master-example.conf
+++ b/dovecot-master-example.conf
@@ -1,3 +1,6 @@
+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 auth-worker {
 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
-  vsz_limit = 64
   client_limit = 1
+  # If you increase client_limit, you probably need to grow this.
+  vsz_limit = 64
+  # 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 {