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
100 # -closevol After an AppleVolumes change, disconnect immediatly
105 # -authprintdir <path> Specifies the path to be used (per server) to
106 # store the files required to do CAP-style
107 # print authentication which papd will examine
108 # to determine if a print job should be allowed.
109 # These files are created at login and if they
110 # are to be properly removed, this directory
111 # probably needs to be umode 1777
112 # -guestname "user" Specifies the user name for the guest login
113 # (default "nobody", same as -g on command line)
114 # -loginmesg "Message" Client will display "Message" upon logging in
115 # (no default, same as -l "Message" on commandline)
116 # -nodebug Switch off debugging
117 # -client_polling With this switch enabled, afpd won't advertise
118 # that it is capable of server notifications, so that
119 # connected clients poll the server every 10 seconds
120 # to detect changes in opened server windows.
121 # Note: Depending on the number of simultaneously
122 # connected clients and the network's speed, this can
123 # lead to a significant higher load on your network!
124 # -sleep <number> AFP 3.x wait number hours before disconnecting
125 # clients in sleep mode. Default 10 hours
126 # -tickleval <number> Specify the tickle timeout interval (in seconds).
127 # Note, this defaults to 30 seconds, and really
128 # shouldn't be changed. If you want to control
129 # the server idle timeout, use the -timeout option.
130 # -timeout <number> Specify the number of tickles to send before
131 # timing out a connection. The default is 4, therefore
132 # a connection will timeout in 2 minutes.
133 # -icon Use the platform-specific icon.
134 # -volnamelen <number>
135 # Max length of UTF8-MAC volume name for Mac OS X.
136 # Note that Hangul is especially sensitive to this.
138 # 80: limit of generic Mac OS X (default)
139 # 73: limit of Mac OS X 10.1, if >= 74
140 # Finder crashed and restart repeatedly.
141 # Mac OS 9 and earlier is not influenced by this,
142 # Maccharset volume names are always limitted to 27.
143 # -[un]setuplog "<logtype> <loglevel> [<filename>]"
144 # Specify that any message of a loglevel up to the given loglevel
145 # should be logged to the given file. If the filename is ommited the
146 # loglevel applies to messages passed to syslog.
148 # By default (no explicit -setuplog and no buildtime configure flag
149 # --with-logfile) afpd logs to syslog with a default
150 # logging setup equivalent to "-setuplog default log_note".
152 # If build with --with-logfile[=somefile] (default logfile
153 # /var/log/netatalk.log) afpd defaults to a setup that is equivalent
154 # to "-setuplog default log_note [netatalk.log|somefile]"
156 # logtypes: Default, AFPDaemon, Logger, UAMSDaemon
157 # loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG,
158 # LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
160 # Example: Useful default config
161 # -setuplog "default log_info /var/log/afpd.log"
164 # -setuplog "default log_maxdebug /var/log/afpd.log"
166 # -signature { user:<text> | host }
167 # Specify a server signature. This option is useful while
168 # running multiple independent instances of afpd on one
169 # machine (eg. in clustered environments, to provide fault
170 # isolation etc.). "host" signature type allows afpd generating
171 # signature automatically (based on machine primary IP address).
172 # "user" signature type allows administrator to set up a signature
173 # string manually. Examples: three servers running on one machine:
174 # first -signature user:USERS
175 # second -signature user:USERS
176 # third -signature user:ADMINS
177 # First two servers will act as one logical AFP service - if user logs in to
178 # first one and then connects to second one, session will be automatically
179 # redirected to the first one. But if client connects to first and then to third,
180 # will be asked for password twice and will see resources of both servers.
181 # Traditional method of signature generation causes two independent afpd instances
182 # to have the same signature and thus cause clients to be redirected automatically
183 # to server (s)he logged in first.
184 # -k5service <service>
186 # These are required if the server supports Kerberos 5 authentication
189 # -unixcodepage <CODEPAGE> Specifies the servers unix codepage, e.g. "ISO-8859-15" or "UTF8".
190 # This is used to convert strings to/from the systems locale, e.g.
191 # for authenthication. Defaults to LOCALE if your system supports it,
192 # otherwise ASCII will be used.
194 # -maccodepage <CODEPAGE> Specifies the mac clients codepage, e.g. "MAC_ROMAN".
195 # This is used to convert strings to the systems locale, e.g.
196 # for authenthication and SIGUSR2 messaging. This will also be
197 # the default for volumes maccharset.
199 # CNID related options:
200 # -cnidserver ipaddress:port Specifies the IP address and port of a cnid_metad server.
207 # The simplest case is to not have an afpd.conf.
209 # 4 servers w/ names server1-3 and one w/ the hostname. servers
210 # 1-3 get routed to different ports with server 3 being bound
211 # specifically to address 192.168.1.3
213 # server1 -port 12000
214 # server2 -port 12001
215 # server3 -port 12002 -ipaddr 192.168.1.3
217 # a dedicated guest server, a user server, and a special
219 # "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
220 # "User Volume" -uamlist uams_clrtxt.so -port 12000
221 # "special" -notcp -defaultvol <path> -systemvol <path>
224 # - -transall -uamlist uams_clrtxt.so,uams_dhx.so -nosavepassword