X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=config%2Fafpd.conf.tmpl;h=325ce6a6f3d1ed23c847a33ab33944037dfec679;hb=751630e5eeb504472091c7ae0768a6705b0721ca;hp=7db6dbe50d2f97140975867ae1c331adc3b666a1;hpb=f6a596fc1dcb60c6ebe9766d64b9c43347bd7232;p=netatalk.git diff --git a/config/afpd.conf.tmpl b/config/afpd.conf.tmpl index 7db6dbe5..325ce6a6 100644 --- a/config/afpd.conf.tmpl +++ b/config/afpd.conf.tmpl @@ -1,7 +1,8 @@ # -# 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. @@ -10,7 +11,7 @@ # # 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 # @@ -26,10 +27,16 @@ # -transall Make both available # # Transport Options: -# -ipaddr 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 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 # Specifies the DSI server quantum. The minimum # value is 1MB. The max value is 0xFFFFFFFF. If you @@ -49,6 +56,11 @@ # port). this gets discarded if the server can't # resolve it. this is not honored by appleshare # clients <= 3.8.3 (default: none) +# -hostname 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 @@ -56,8 +68,33 @@ # 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: @@ -142,7 +179,8 @@ # 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 # Max length of UTF8-MAC volume name for Mac OS X. # Note that Hangul is especially sensitive to this. @@ -194,23 +232,73 @@ # "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 # -k5service # -k5realm -# 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 Specifies the servers unix codepage, @@ -220,16 +308,29 @@ # Defaults to LOCALE if your system supports it, # otherwise ASCII will be used. # -# -maccodepage Specifies the mac clients codepage, -# e.g. "MAC_ROMAN". +# -maccodepage 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 +# 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 +# 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 # @@ -241,16 +342,19 @@ # 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 -systemvol +# 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 -systemvol #