X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=config%2Fafpd.conf.tmpl;h=c2830c1450f2a96762881fb56b8b75c346fbca40;hb=refs%2Ftags%2Fbranch-dircache-rewrite-commit;hp=fd07efe403b13a2a136b0e9577122f5add49388a;hpb=77168f597be39a1aac5b792580751279c133796b;p=netatalk.git diff --git a/config/afpd.conf.tmpl b/config/afpd.conf.tmpl index fd07efe4..c2830c14 100644 --- a/config/afpd.conf.tmpl +++ b/config/afpd.conf.tmpl @@ -12,12 +12,12 @@ # # The following options are available: # Transport Protocols: -# -[no]tcp Make AFP-over-TCP [not] available -# -[no]ddp Make AFP over AppleTalk [not] available. if you -# have -proxy specified, specify -uamlist "" to +# -[no]tcp Make "AFP over TCP" [not] available +# -[no]ddp Make "AFP over AppleTalk" [not] available. +# If you have -proxy specified, specify -uamlist "" to # prevent ddp connections from working. # -# -transall Make both available (default) +# -transall Make both available # # Transport Options: # -ipaddr Specifies the IP address the server should respond @@ -49,7 +49,7 @@ # if you don't want the proxy server to act as # a ddp server as well, set -uamlist to an # empty string. -# -noslp Don't register this server with the Service +# -slp Register this server with the Service # Location Protocol. # # @@ -57,7 +57,7 @@ # -uampath Use this path to look for User Authentication Modules. # (default: :UAMS_PATH:) # -uamlist Comma-separated list of UAMs. (default: -# uams_guest.so,uams_clrtxt.so,uams_dhx.so) +# uams_dhx.so,uams_dhx2.so) # # some commonly available UAMs: # uams_guest.so: Allow guest logins @@ -74,6 +74,10 @@ # Allow Diffie-Hellman eXchange # (DHX) for authentication. # +# uams_dhx2.so: (uams_dhx2_pam.so or uams_dhx2_passwd.so) +# Allow Diffie-Hellman eXchange 2 +# (DHX2) for authentication. +# # Password Options: # -[no]savepassword [Don't] Allow clients to save password locally # -passwdfile Use this path to store Randnum @@ -97,9 +101,8 @@ # :ETCDIR:/AppleVolumes.default # (same as -u on command line) # -[no]uservol [Don't] Read the user's volume file -# -# -nlspath Prepend this path to each code page filename -# in volume options (default: :NLS_PATH:). +# -closevol Immediately unmount volumes removed from AppleVolumes +# files on SIGHUP sent to the afp master process. # # Miscellaneous: # -authprintdir Specifies the path to be used (per server) to @@ -121,6 +124,8 @@ # Note: Depending on the number of simultaneously # connected clients and the network's speed, this can # lead to a significant higher load on your network! +# -sleep AFP 3.x wait number hours before disconnecting +# clients in sleep mode. Default 10 hours # -tickleval Specify the tickle timeout interval (in seconds). # Note, this defaults to 30 seconds, and really # shouldn't be changed. If you want to control @@ -129,26 +134,37 @@ # timing out a connection. The default is 4, therefore # a connection will timeout in 2 minutes. # -icon Use the platform-specific icon. +# -volnamelen +# Max length of UTF8-MAC volume name for Mac OS X. +# Note that Hangul is especially sensitive to this. +# 255: limit of spec +# 80: limit of generic Mac OS X (default) +# 73: limit of Mac OS X 10.1, if >= 74 +# Finder crashed and restart repeatedly. +# Mac OS 9 and earlier is not influenced by this, +# Maccharset volume names are always limitted to 27. # -[un]setuplog " []" -# 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. +# +# By default (no explicit -setuplog and no buildtime configure flag +# --with-logfile) afpd logs to syslog with a default +# logging setup equivalent to "-setuplog default log_info". +# +# If build with --with-logfile[=somefile] (default logfile +# /var/log/netatalk.log) afpd defaults to a setup that is equivalent +# to "-setuplog default log_info [netatalk.log|somefile]" +# +# logtypes: Default, AFPDaemon, Logger, UAMSDaemon +# loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG, +# LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG +# +# Example: Useful default config +# -setuplog "default log_info /var/log/afpd.log" +# +# Debugging config +# -setuplog "default log_maxdebug /var/log/afpd.log" # # -signature { user: | host } # Specify a server signature. This option is useful while @@ -168,6 +184,25 @@ # Traditional method of signature generation causes two independent afpd instances # to have the same signature and thus cause clients to be redirected automatically # to server (s)he logged in first. +# -k5service +# -k5realm +# These are required if the server supports Kerberos 5 authentication +# +# Codepage Options: +# -unixcodepage Specifies the servers unix codepage, e.g. "ISO-8859-15" or "UTF8". +# This is used to convert strings to/from the systems locale, e.g. +# for authenthication. Defaults to LOCALE if your system supports it, +# otherwise ASCII will be used. +# +# -maccodepage Specifies the mac clients codepage, e.g. "MAC_ROMAN". +# This is used to convert strings to the systems locale, e.g. +# for authenthication and SIGUSR2 messaging. This will also be +# the default for volumes maccharset. +# +# CNID related options: +# -cnidserver ipaddress:port Specifies the IP address and port of a cnid_metad server. +# + # # Some examples: @@ -188,5 +223,6 @@ # "User Volume" -uamlist uams_clrtxt.so -port 12000 # "special" -notcp -defaultvol -systemvol # + # default: -# - -transall -uamlist uams_clrtxt.so,uams_dhx.so -nosavepassword +# - -tcp -noddp -uamlist uams_dhx.so,uams_dhx2.so -nosavepassword