#
-# CONFIGURATION FOR AFPD
+# CONFIGURATION FOR AFPD (Netatalk 2.x)
#
-# Each line defines a virtual server that should be available.
+# Each single line defines a virtual server that should be available.
+# Though, using "\" character, newline escaping is supported.
# Empty lines and lines beginning with `#' are ignored.
# Options in this file will override both compiled-in defaults
# and command line options.
#
# Format:
-# - [options] to specify options for the default server
+# - [options] to specify options for the default server
# "Server name" [options] to specify an additional server
#
# -transall Make both available
#
# Transport Options:
-# -ipaddr <w.x.y.z> Specifies the IP address the server should respond
-# to (default is the first IP address of the system)
-# This option also allows one machine to advertise
-# TCP/IP for another machine.
+# -ipaddr <ipaddress> Specifies the IP address that the server should
+# advertise and listens to. The default is advertise
+# the first IP address of the system, but to listen
+# for any incoming request. The network address may
+# be specified either in dotted-decimal format for
+# IPv4 or in hexadecimal format for IPv6.
+# This option also allows to use one machine to
+# advertise the AFP-over-TCP/IP settings of another
+# machine via NBP when used together with the -proxy
+# option.
# -server_quantum <number>
# Specifies the DSI server quantum. The minimum
# value is 1MB. The max value is 0xFFFFFFFF. If you
# port). this gets discarded if the server can't
# resolve it. this is not honored by appleshare
# clients <= 3.8.3 (default: none)
+# -hostname <name> Use this instead of the result from calling
+# hostname for dertermening which IP address to
+# advertise, therfore the hostname is resolved to
+# an IP which is the advertised. This is NOT used for
+# listening and it is also overwritten by -ipaddr.
# -proxy Run an AppleTalk proxy server for specified
# AFP/TCP server (if address/port aren't given,
# then first IP address of the system/548 will
# if you don't want the proxy server to act as
# a ddp server as well, set -uamlist to an empty
# string.
+# -dsireadbuf [number]
+# Scale factor that determines the size of the
+# DSI/TCP readahead buffer, default is 12. This is
+# multiplies with the DSI server quantum (default
+# ~300k) to give the size of the buffer. Increasing
+# this value might increase throughput in fast local
+# networks for volume to volume copies. Note: This
+# buffer is allocated per afpd child process, so
+# specifying large values will eat up large amount of
+# memory (buffer size * number of clients).
+# -tcprcvbuf [number]
+# Try to set TCP receive buffer using setsockpt().
+# Often OSes impose restrictions on the applications
+# ability to set this value.
+# -tcpsndbuf [number]
+# Try to set TCP send buffer using setsockpt().
+# Often OSes impose restrictions on the applications
+# ability to set this value.
# -slp Register this server with the Service Location
-# Protocol.
+# Protocol (if SLP support was compiled in).
+# -nozeroconf Don't register this server with the Multicats
+# DNS Protocol.
+# -advertise_ssh Allows Mac OS X clients (10.3.3-10.4) to
+# automagically establish a tunneled AFP connection
+# through SSH. This option is not so significant
+# for the recent Mac OS X. See the Netatalk Manual
+# in detail.
#
#
# Authentication Methods:
# timing out a connection.
# The default is 4, therefore a connection will
# timeout in 2 minutes.
-# -icon Use the platform-specific icon.
+# -[no]icon [Don't] Use the platform-specific icon. Recent
+# Mac OS don't display it any longer.
# -volnamelen <number>
# Max length of UTF8-MAC volume name for Mac OS X.
# Note that Hangul is especially sensitive to this.
# "user" signature type allows administrator to
# set up a signature string manually.
# Examples: three servers running on one machine:
-# first -signature user:USERS
-# second -signature user:USERS
-# third -signature user:ADMINS
-# First two servers will act as one logical AFP service.
-# If user logs in to first one and then connects to second
-# one, session will be automatically redirected to the first
-# one. But if client connects to first and then to third,
-# will be asked for password twice and will see resources of
-# both servers.
-# 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.
+# first -signature user:USERS
+# second -signature user:USERS
+# third -signature user:ADMINS
+# First two servers will act as one logical AFP
+# service. If user logs in to first one and then
+# connects to second one, session will be
+# automatically redirected to the first one. But if
+# client connects to first and then to third,
+# will be asked for password twice and will see
+# resources of both servers.
+# 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.
+# -k5keytab <path>
# -k5service <service>
# -k5realm <realm>
-# These are required if the server supports Kerberos 5
-# authentication
+# These are required if the server supports
+# Kerberos 5 authentication
+# -ntdomain
+# -ntseparator
+# Use for eg. winbind authentication, prepends
+# both strings before the username from login and
+# then tries to authenticate with the result
+# through the availabel and active UAM authentication
+# modules.
+# -dircachesize entries
+# Maximum possible entries in the directory cache.
+# The cache stores directories and files. It is used
+# to cache the full path to directories and CNIDs
+# which considerably speeds up directory enumeration.
+# Default size is 8192, maximum size is 131072. Given
+# value is rounded up to nearest power of 2. Each
+# entry takes about 100 bytes, which is not much, but
+# remember that every afpd child process for every
+# connected user has its cache.
+# -fcelistener host[:port]
+# Enables sending FCE events to the specified host,
+# default port is 12250 if not specified. Specifying
+# mutliple listeners is done by having this option
+# once for each of them.
+# -fceevents fmod,fdel,ddel,fcre,dcre,tmsz
+# Speficies which FCE events are active, default is
+# fmod,fdel,ddel,fcre,dcre.
+# -fcecoalesce all|delete|create
+# Coalesce FCE events.
+# -fceholdfmod seconds
+# This determines the time delay in seconds which is
+# always waited if another file modification for the
+# same file is done by a client before sending an FCE
+# file modification event (fmod). For example saving
+# a file in Photoshop would generate multiple events
+# by itself because the application is opening,
+# modifying and closing a file mutliple times for
+# every "save". Defautl: 60 seconds.
+# -keepsessions Enable "Continuous AFP Service". This means the
+# ability to stop the master afpd process with a
+# SIGQUIT signal, possibly install an afpd update and
+# start the afpd process. Existing AFP sessions afpd
+# processes will remain unaffected. Technically they
+# will be notified of the master afpd shutdown, sleep
+# 15-20 seconds and then try to reconnect their IPC
+# channel to the master afpd process. If this
+# reconnect fails, the sessions are in an undefined
+# state. Therefor it's absolutely critical to restart
+# the master process in time!
+# -noacl2maccess Don't map filesystem ACLs to effective permissions.
#
# Codepage Options:
# -unixcodepage <CODEPAGE> Specifies the servers unix codepage,
# Defaults to LOCALE if your system supports it,
# otherwise ASCII will be used.
#
-# -maccodepage <CODEPAGE> Specifies the mac clients codepage,
-# e.g. "MAC_ROMAN".
+# -maccodepage <CODEPAGE> Specifies the legacy clients (<= Mac OS 9)
+# 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.
+# -cnidserver <ipaddress:port>
+# Specifies the IP address and port of a
+# cnid_metad server, required for CNID dbd
+# backend. Defaults to localhost:4700.
+# The network address may be specified either
+# in dotted-decimal format for IPv4 or in
+# hexadecimal format for IPv6.
+#
+# Avahi (Bonjour) related options:
+# -mimicmodel <model>
+# Specifies the icon model that appears on
+# clients. Defaults to off. Examples: RackMac
+# (same as Xserve), PowerBook, PowerMac, Macmini,
+# iMac, MacBook, MacBookPro, MacBookAir, MacPro,
+# AppleTV1,1, AirPort
#
# 4 servers w/ names server1-3 and one w/ the hostname. servers
# 1-3 get routed to different ports with server 3 being bound
# specifically to address 192.168.1.3
+#
# -
# server1 -port 12000
# server2 -port 12001
# server3 -port 12002 -ipaddr 192.168.1.3
#
# a dedicated guest server, a user server, and a special
-# ddp-only server:
-# "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
-# "User Volume" -uamlist uams_clrtxt.so -port 12000
-# "special" -notcp -defaultvol <path> -systemvol <path>
+# AppleTalk-only server:
+#
+# "Guest Server" -uamlist uams_guest.so \
+# -loginmesg "Welcome guest! I'm a public server."
+# "User Server" -uamlist uams_dhx2.so -port 12000
+# "special" -ddp -notcp -defaultvol <path> -systemvol <path>
#
# default:
-# - -tcp -noddp -uamlist uams_dhx.so,uams_dhx2.so -nosavepassword
+# - -tcp -noddp -uamlist uams_dhx.so,uams_dhx2.so