2 # CONFIGURATION FOR AFPD
4 # Each line defines a virtual server that should be available.
5 # Empty lines and lines beginning with `#' are ignored.
6 # Options in this file will override both compiled-in defaults
7 # and command line options.
10 # - [options] to specify options for the default server
11 # "Server name" [options] to specify an additional server
13 # The following options are available:
14 # Transport Protocols:
15 # -[no]tcp Make AFP-over-TCP [not] available
16 # -[no]ddp Make AFP over AppleTalk [not] available. if you
17 # have -proxy specified, specify -uamlist "" to
18 # prevent ddp connections from working.
20 # -transall Make both available (default)
23 # -ipaddr <w.x.y.z> Specifies the IP address the server should respond
24 # to (default is the first IP address of the system)
25 # This option also allows one machine to advertise
26 # TCP/IP for another machine.
27 # -server_quantum <number>
28 # Specifies the DSI server quantum. The minimum
29 # value is 1MB. The max value is 0xFFFFFFFF. If you
30 # specify a value that is out of range, you'll get
31 # the default value (currently the minimum).
32 # -admingroup <groupname>
33 # Specifies the group of administrators who should all
34 # be seen as the superuser when they log in. Default
36 # -ddpaddr x.y Specifies the DDP address of the server. the
37 # default is to auto-assign an address
38 # (0.0). this is only useful if you're running
39 # on a multihomed host.
40 # -port <number> Specifies the TCP port the server should respond
42 # -fqdn <name:port> specify a fully-qualified domain name (+
43 # optional port). this gets discarded if the
44 # server can't resolve it. this is not honored
45 # by appleshare clients <= 3.8.3 (default: none)
46 # -proxy Run an AppleTalk proxy server for specified AFP/TCP
47 # server (if address/port aren't given, then
48 # first IP address of the system/548 will be used).
49 # if you don't want the proxy server to act as
50 # a ddp server as well, set -uamlist to an
52 # -noslp Don't register this server with the Service
56 # Authentication Methods:
57 # -uampath <path> Use this path to look for User Authentication Modules.
58 # (default: :UAMS_PATH:)
59 # -uamlist <a,b,c> Comma-separated list of UAMs. (default:
60 # uams_guest.so,uams_clrtxt.so,uams_dhx.so)
62 # some commonly available UAMs:
63 # uams_guest.so: Allow guest logins
65 # uams_clrtxt.so: (uams_pam.so or uams_passwd.so)
66 # Allow logins with passwords
67 # transmitted in the clear.
69 # uams_randnum.so: Allow Random Number and Two-Way
70 # Random Number exchange for
73 # uams_dhx.so: (uams_dhx_pam.so or uams_dhx_passwd.so)
74 # Allow Diffie-Hellman eXchange
75 # (DHX) for authentication.
78 # -[no]savepassword [Don't] Allow clients to save password locally
79 # -passwdfile <path> Use this path to store Randnum
80 # passwords. (Default: :ETCDIR:/afppasswd. The only
81 # other useful value is ~/.passwd. See 'man afppasswd'
83 # -passwdminlen <#> minimum password length. may be ignored.
84 # -[no]setpassword [Don't] Allow clients to change their passwords.
85 # -loginmaxfail <#> maximum number of failed logins. this may be
86 # ignored if the uam can't handle it.
89 # -defaultvol <path> Specifies path to AppleVolumes.default file
90 # (default :ETCDIR:/AppleVolumes.default,
91 # same as -f on command line)
92 # -systemvol <path> Specifies path to AppleVolumes.system file
93 # (default :ETCDIR:/AppleVolumes.system,
94 # same as -s on command line)
95 # -[no]uservolfirst [Don't] read the user's ~/AppleVolumes or
96 # ~/.AppleVolumes before reading
97 # :ETCDIR:/AppleVolumes.default
98 # (same as -u on command line)
99 # -[no]uservol [Don't] Read the user's volume file
103 # -authprintdir <path> Specifies the path to be used (per server) to
104 # store the files required to do CAP-style
105 # print authentication which papd will examine
106 # to determine if a print job should be allowed.
107 # These files are created at login and if they
108 # are to be properly removed, this directory
109 # probably needs to be umode 1777
110 # -guestname "user" Specifies the user name for the guest login
111 # (default "nobody", same as -g on command line)
112 # -loginmesg "Message" Client will display "Message" upon logging in
113 # (no default, same as -l "Message" on commandline)
114 # -nodebug Switch off debugging
115 # -client_polling With this switch enabled, afpd won't advertise
116 # that it is capable of server notifications, so that
117 # connected clients poll the server every 10 seconds
118 # to detect changes in opened server windows.
119 # Note: Depending on the number of simultaneously
120 # connected clients and the network's speed, this can
121 # lead to a significant higher load on your network!
122 # -sleep <number> AFP 3.x wait number hours before disconnecting
123 # clients in sleep mode. Default 10 hours
124 # -tickleval <number> Specify the tickle timeout interval (in seconds).
125 # Note, this defaults to 30 seconds, and really
126 # shouldn't be changed. If you want to control
127 # the server idle timeout, use the -timeout option.
128 # -timeout <number> Specify the number of tickles to send before
129 # timing out a connection. The default is 4, therefore
130 # a connection will timeout in 2 minutes.
131 # -icon Use the platform-specific icon.
132 # -[un]setuplog "<logtype> <loglevel> [<filename>]"
133 # Specify that the given loglevel should be applied
134 # to log messages of the given logtype and that
135 # these messages should be logged to the given file.
136 # If the filename is ommited the loglevel applies to
137 # messages passed to syslog.
138 # Each logtype may have a loglevel applied to syslog
139 # and a loglevel applied to a single file. Latter
140 # -setuplog settings will override earlier ones of
141 # the same logtype (file or syslog).
142 # logtypes: Default, Core, Logger, CNID, AFPDaemon
143 # loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE,
144 # LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7,
145 # LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
148 # -setuplog "logger log_maxdebug /var/log/netatalk-logger.log"
149 # -setuplog "afpdaemon log_maxdebug /var/log/netatalk-afp.log"
150 # -unsetuplog "default level file"
151 # -setuplog "default log_maxdebug"
153 # -signature { user:<text> | host }
154 # Specify a server signature. This option is useful while
155 # running multiple independent instances of afpd on one
156 # machine (eg. in clustered environments, to provide fault
157 # isolation etc.). "host" signature type allows afpd generating
158 # signature automatically (based on machine primary IP address).
159 # "user" signature type allows administrator to set up a signature
160 # string manually. Examples: three servers running on one machine:
161 # first -signature user:USERS
162 # second -signature user:USERS
163 # third -signature user:ADMINS
164 # First two servers will act as one logical AFP service - if user logs in to
165 # first one and then connects to second one, session will be automatically
166 # redirected to the first one. But if client connects to first and then to third,
167 # will be asked for password twice and will see resources of both servers.
168 # Traditional method of signature generation causes two independent afpd instances
169 # to have the same signature and thus cause clients to be redirected automatically
170 # to server (s)he logged in first.
171 # -k5service <service>
173 # These are required if the server supports Kerberos 5 authentication
176 # -unixcodepage <CODEPAGE> Specifies the servers unix codepage, e.g. "ISO-8859-15" or "UTF8".
177 # This is used to convert strings to/from the systems locale, e.g.
178 # for authenthication. Defaults to LOCALE if your system supports it,
179 # otherwise ASCII will be used.
181 # -maccodepage <CODEPAGE> Specifies the mac clients codepage, e.g. "MAC_ROMAN".
182 # This is used to convert strings to the systems locale, e.g.
183 # for authenthication and SIGUSR2 messaging. This will also be
184 # the default for volumes maccharset.
186 # CNID related options:
187 # -cnidserver ipaddress:port Specifies the IP address and port of a cnid_metad server.
194 # The simplest case is to not have an afpd.conf.
196 # 4 servers w/ names server1-3 and one w/ the hostname. servers
197 # 1-3 get routed to different ports with server 3 being bound
198 # specifically to address 192.168.1.3
200 # server1 -port 12000
201 # server2 -port 12001
202 # server3 -port 12002 -ipaddr 192.168.1.3
204 # a dedicated guest server, a user server, and a special
206 # "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
207 # "User Volume" -uamlist uams_clrtxt.so -port 12000
208 # "special" -notcp -defaultvol <path> -systemvol <path>
211 # - -transall -uamlist uams_clrtxt.so,uams_dhx.so -nosavepassword