Volname mangling. Fixes bug #2611981, from HAT. Also add new logger doc to afpd.conf...

[netatalk.git] / config / afpd.conf.tmpl

diff --git a/config/afpd.conf.tmpl b/config/afpd.conf.tmpl
index 08e32ac56ef7720c48a4714d54529731e0c11884..0364b891871b779bc4532a2f6fbbe2b0677ec545 100644 (file)
--- a/config/afpd.conf.tmpl
+++ b/config/afpd.conf.tmpl
@@ -131,26 +131,35 @@
 #                         timing out a connection.  The default is 4, therefore
 #                         a connection will timeout in 2 minutes.
 #     -icon               Use the platform-specific icon.
+#     -volnamelen <number>
+#                         Max length of UTF8-MAC volume name for Mac OS X.
+#                         Note that Hangul is especially sensitive to this.
+#                           31:  conservative default
+#                           80:  limit for Mac OS X 10.5
+#                           255: limit of spec
+#                         Mac OS 9 and earlier are not influenced by this,
+#                         Maccharset volume name is always 27 limit.
 #     -[un]setuplog "<logtype> <loglevel> [<filename>]"
-#                         Specify that the given loglevel should be applied
-#                         to log messages of the given logtype and that 
-#                         these messages should be logged to the given file.
-#                         If the filename is ommited the loglevel applies to 
-#                         messages passed to syslog.  
-#                         Each logtype may have a loglevel applied to syslog 
-#                         and a loglevel applied to a single file.  Latter
-#                         -setuplog settings will override earlier ones of
-#                         the same logtype (file or syslog).
-#                         logtypes:  Default, Core, Logger, CNID, AFPDaemon
-#                         loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE,
-#                                    LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, 
-#                                    LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
-#
-#                         for example:
-#                    -setuplog "logger log_maxdebug /var/log/netatalk-logger.log"
-#                    -setuplog "afpdaemon log_maxdebug /var/log/netatalk-afp.log"
-#                    -unsetuplog "default level file" 
-#                    -setuplog "default log_maxdebug"
+#                         Specify that any message of a loglevel up to the given loglevel
+#                         should be logged to the given file. If the filename is ommited the
+#                         loglevel applies to messages passed to syslog. Latter -setuplog
+#                         settings will override earlier ones of the same logtype (file or
+#                         syslog).
+#               
+#                         By default (no explicit -setuplog and no buildtime configure flag
+#                         --with-logfile) all netatalk daemons log to syslog with a default
+#                         logging setup equivalent to "-setuplog default log_debug".
+#               
+#                         If build with --with-logfile (default logfile
+#                         /var/log/netatalk.log) or --with-logfile=somefile all daemons
+#                         default to a setup that is equivalent to "-setuplog default
+#                         log_info [netatalk.log|somefile]"
+#
+#                Example: Useful default config
+#                         -setuplog "default log_info /var/log/afpd.log"
+#
+#                         Debugging config
+#                         -setuplog "default log_maxdebug /var/log/afpd.log"
 #
 #     -signature { user:<text> | host }
 #                         Specify a server signature. This option is useful while