3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
6 .\" Manual: Netatalk 2.2
7 .\" Source: Netatalk 2.2
10 .TH "AFPD" "8" "08 Mar 2011" "Netatalk 2.2" "Netatalk 2.2"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 afpd \- Apple Filing Protocol daemon
24 .HP \w'\fBafpd\fR\fB\fR\fBafpd\fR\fB\fR\ 'u
25 \fBafpd\fR\fB\fR [\-duptDTI] [\-f\ \fIdefaultvolumes\fR] [\-s\ \fIsystemvolumes\fR] [\-n\ \fInbpname\fR] [\-c\ \fImaxconnections\fR] [\-g\ \fIguest\fR] [\-P\ \fIpidfile\fR] [\-S\ \fIport\fR] [\-L\ \fImessage\fR] [\-F\ \fIconfigfile\fR] [\-U\ \fIuams\fR] [\-m\ \fIumask\fR]
27 \fBafpd\fR\fB\fR \-v | \-V | \-h
31 provides an Apple Filing Protocol (AFP) interface to the Unix file system\&. It is normally started at boot time from /etc/rc\&.
34 is the configuration file used by
36 to determine the behavior and configuration of the different virtual file servers that it provides\&.
38 The list of volumes offered to the user is generated from
39 :ETCDIR:/AppleVolumes\&.system
41 :ETCDIR:/AppleVolumes\&.default,
45 ~/\&.applevolumes\&. The
47 files is used to specify volumes to mount and file name extension mappings\&.
53 Specifies that the daemon should not fork\&. If netatalk has been configured with
54 \fI\-\-enable\-debug1\fR, a trace of all AFP commands will be written to stdout\&.
59 Prevents clients from saving their passwords\&. (Equivalent to \-\fBnosavepasswd\fR
66 Allows clients to change their passwords\&. (Equivalent to
74 Use DDP (AppleTalk) as transport protocol\&. (Equivalent to
82 Use TCP/IP as transport protocol\&. (Equivalent to
90 Print version information and exit\&.
95 Print verbose information and exit\&.
100 Print help and exit\&.
105 Use a platform specific icon\&. (Equivalent to
108 afpd\&.conf\&.) (Recent Mac OS don\'t display it\&.)
111 \-f \fIdefaultvolumes\fR
115 should be read for a list of default volumes to offer, instead of
116 :ETCDIR:/AppleVolumes\&.default\&.
119 \-s \fIsystemvolumes\fR
123 should be read for a list of volume that all users will be offered, instead of
124 :ETCDIR:/AppleVolumes\&.system\&.
131 file first\&. This option causes volume names in the user\'s
133 file to override volume names in the system\'s
135 file\&. The default is to read the system
137 file first\&. Note that this option doesn\'t effect the precendence of filename extension mappings: the user\'s
139 file always has precedence\&.
146 should be used for NBP registration, instead of the first component of the hostname in the local zone\&.
149 \-c \fImaxconnections\fR
151 Specifies the maximum number of connections to allow for this
152 \fBafpd\fR\&. The default is 20\&.
157 Specifies the name of the guest account\&. The default is \'\fInobody\fR\'\&.
162 Specifies the file in which
164 stores its process id\&.
169 Specifies the port to register with when doing AFPoverTCP\&. Defaults to 548\&. (Equivalent to
176 Specifies the login message that will be sent to clients\&. (Equivalent to
184 Specifies the configuration file to use\&. (Defaults to
185 :ETCDIR:/netatalk/afpd\&.conf\&.)
190 Comma\-separated list of UAMs to use for the authentication process\&. (Equivalent to
200 for the creation of folders in Netatalk\&.
204 To shut down a user\'s
206 process it is recommended that
209 be used, except as a last resort, as this may leave the CNID database in an inconsistent state\&. The safe way to terminate an
213 signal and wait for it to die on its own\&.
215 SIGTERM and SIGUSR1 signals that are sent to the main
217 process are propagated to the children, so all will be affected\&.
221 Clean exit\&. Propagates from master to childs\&.
226 Send this to the master
227 \fBafpd\fR, it will exit leaving all children running! Can be used to implement AFP service without downtime\&.
234 to afpd will cause it to reload its configuration files\&.
245 logging for this process\&. The log is sent to fhe file
246 /tmp/afpd\&.PID\&.XXXXXX\&. Sending another
248 will revert to the original log settings\&.
255 process will send the message "The server is going down for maintenance\&." to the client and shut itself down in 5 minutes\&. New connections are not allowed\&. If this is sent to a child afpd, the other children are not affected\&. However, the main process will still exit, disabling all new connections\&.
262 process will look in the message directory configured at build time for a file named message\&.pid\&. For each one found, a the contents will be sent as a message to the associated AFP client\&. The file is removed after the message is sent\&. This should only be sent to a child
269 configuration file used by afpd
272 :ETCDIR:/AppleVolumes\&.default
274 list of default volumes to mount
277 :ETCDIR:/AppleVolumes\&.system
279 list of volumes to offer all users
282 ~/AppleVolumes, ~/\&.AppleVolumes, ~/applevolumes, ~/\&.applevolumes
284 user\'s list of volumes to mount
287 :ETCDIR:/afp_signature\&.conf
289 list of server signature
292 :ETCDIR:/afp_voluuid\&.conf
294 list of UUID for Time Machine volume
297 :ETCDIR:/afp_ldap\&.conf
299 configuration file for LDAP and ACL support
302 :ETCDIR:/msg/message\&.pid
304 contains messages to be sent to users\&.
310 \fBhosts_access\fR(5),
312 \fBAppleVolumes.default\fR(5),
313 \fBafp_signature.conf\fR(5),
314 \fBafp_voluuid.conf\fR(5),
315 \fBafp_ldap.conf\fR(5),