1 .TH AFPD 8 "23 Feb 1999" "netatalk 1.4b2/asun 2.1.3"
4 afpd \- AppleTalk Filing Protocol daemon
56 provides an AppleTalk Filing Protocol (AFP)
57 interface to the Unix file system. It is normally started at boot time
60 The list of volumes offered to the user is generated from
61 .B :ETCDIR:/AppleVolumes.system
63 .BR :ETCDIR:/AppleVolumes.default ,
70 files is used to specify volumes to mount and file name extension mappings.
71 It is formatted as follows, one specification per line:
90 is unspecified, the last component of
92 is used. No two volumes may have the same name. If
100 is used. The extension
102 sets the default creator and type for otherwise untyped Unix files.
103 Blank lines and lines beginning with `#' are ignored.
107 Specifies that the daemon not fork, and that a trace of all AFP
108 commands be written to stdout.
110 .BI \-f " defaultvolumes"
113 should be read for a list of default volumes to offer, instead of
114 .BR :ETCDIR:/AppleVolumes.default .
116 .BI \-s " systemvolumes"
119 should be read for a list of volume that all users will be offered,
121 .BR :ETCDIR:/AppleVolumes.system .
126 file first. This option causes volume names in the user's
128 file to override volume names in the system's
130 file. The default is to read the system
132 file first. Note that this option doesn't effect the precendence of
133 filename extension mappings: the user's AppleVolumes file always has
139 should be used for NBP registration, instead of the first component of
140 the hostname in the local zone.
142 .BI \-c " maxconnections"
143 Specifies the maximum number of connections to allow for this
148 Specifies the name of the guest account. The default is ``nobody''.
151 Specifies the file in which
153 stores its process id.
156 Prevents clients from saving their passwords. (Equivalent to
162 Allows clients to change their passwords. (Equivalent to
168 Use DDP (AppleTalk) as transport protocol. (Equivalent to
174 Use TCP/IP as transport protocol. (Equivalent to
180 Specifies the port to register with when doing AFPoverTCP. Defaults to
188 Specifies the login message that will be sent to clients. (Equivalent to
194 Specifies the configuration file to use. (Defaults to
195 .IR :ETCDIR:/afpd.conf .)
198 Comma-separated list of UAMs to use for the authentication process.
205 Use a platform specific icon. (Equivalent to
211 Use this umask for the creation of folders in Netatalk.
214 Print version information and exit.
217 currently understands three User Authentication Methods (UAMs):
227 s/he will only be offered default volumes to mount, and will only be able
228 to read and write files that are permitted to the guest user. The
238 offers the user all volumes listed in
240 The user may also read and write all files that s/he normally could.
242 is not recommended for AFS use.
244 is recommended for AFS use.
245 A forth, depricated UAM is also included in the distribution,
250 Directory IDs are only fixed for the duration of a session. This means
251 that Mac aliases won't work correctly in all cases.
253 If a user renames a folder that has an application as its progeny, the
255 mapping for the application will not longer be available. This implies
256 that double-clicking on one of the application's documents will no
257 longer launch the application. The
259 mapping will be rebuilt by the mac, the next time the Finder see the
264 is configured to downcase Macintosh filenames, Unix filenames with
265 mixed case will be unavailable.
267 If carriage return/line feed translation is enabled, it is not
268 safe to copy Unix binaries to a Macintosh.
270 It is not possible to move directories between devices.
272 When mounting the parent of an existing volume, the desktop database of
273 the existing volume will not be available to the parent volume. The
275 mappings and icons of applications with the
277 bit set will be generated in the parent volume as the applications are
282 so that his home directory is no longer offered, he will no longer be able
287 Unix files beginning with `.' are not accessible from the mac.
293 file does not exist, the volume will not be offered in the Chooser.
297 documents do not get carriage return/line feed translation. This is
298 because MS Word uses a type other than
300 while writing the document, then changes the type to
302 To allow users to edit their
305 parses the files with either end of line character.
307 Unix filenames that are longer than 31 characters are inaccessible from
311 Signals that are sent to the main
313 process are propagated to the children, so all will be affected.
318 process will send the message "The server is going down for maintenance."
319 to the client and shut itself down in 5 minutes. New connections are not
320 allowed. If this is sent to a child
322 the other children are not affected. However, the main process will still
323 exit, disabling all new connections.
327 .B --with-message-dir
328 configure option was used, the
332 option and redirect the messages to
333 .RI /var/tmp/afpd-debug- pid .
334 This should only be sent to a child
338 .B --with-message-dir
339 option was not used, this will kill the
347 process will look in the
349 directory for a file named
351 For each one found, a the contents will be sent as a message to the
352 associated AFP client. The file is removed after the message is sent.
356 .B :ETCDIR:/AppleVolumes.default
357 list of default volumes to mount
359 .B :ETCDIR:/AppleVolumes.system
360 list of volumes to offer all users
363 user's list of volumes to mount
365 .BI :ETCDIR:/msg/message. pid
366 contains messages to be sent to users.
368 .BI /var/tmp/afpd-debug- pid
369 contains debug output, if triggered.
371 A few calls from the AFP specification are not implemented, because the
372 Macintosh does not use them.