1AFPD(8) Netatalk 2.1 AFPD(8)
2
6 afpd - Apple Filing Protocol daemon
7
9 afpd [-duptDTI] [-f defaultvolumes] [-s systemvolumes] [-n nbpname]
10 [-c maxconnections] [-g guest] [-P pidfile] [-S port]
11 [-L message] [-F configfile] [-U uams] [-m umask]
12 afpd -v | -V | -h
13
15 afpd provides an Apple Filing Protocol (AFP) interface to the Unix file
16 system. It is normally started at boot time from /etc/rc.
17 /etc/netatalk//afpd.conf is the configuration file used by afpd to
19 determine the behavior and configuration of the different virtual file
20 servers that it provides.
21 The list of volumes offered to the user is generated from
23 /etc/netatalk//AppleVolumes.system and one of
24 /etc/netatalk//AppleVolumes.default, ~/AppleVolumes, ~/.AppleVolumes,
25 ~/applevolumes, or ~/.applevolumes. The AppleVolumes files is used to
26 specify volumes to mount and file name extension mappings.
27
29 -d
30 Specifies that the daemon should not fork. If netatalk has been
31 configured with --enable-debug1, a trace of all AFP commands will
32 be written to stdout.
33 -p
35 Prevents clients from saving their passwords. (Equivalent to
36 -nosavepasswd in afpd.conf.)
37 -t
39 Allows clients to change their passwords. (Equivalent to -setpasswd
40 in afpd.conf.)
41 -D
43 Use DDP (AppleTalk) as transport protocol. (Equivalent to -ddp in
44 afpd.cond.)
45 -T
47 Use TCP/IP as transport protocol. (Equivalent to -tcp in
48 afpd.conf.)
49 -v
51 Print version information and exit.
52 -V
54 Print verbose information and exit.
55 -h
57 Print help and exit.
58 -I
60 Use a platform specific icon. (Equivalent to -icon in afpd.conf.)
61 (Recent Mac OS don´t display it.)
62 -f defaultvolumes
64 Specifies that defaultvolumes should be read for a list of default
65 volumes to offer, instead of /etc/netatalk//AppleVolumes.default.
66 -s systemvolumes
68 Specifies that systemvolumes should be read for a list of volume
69 that all users will be offered, instead of
70 /etc/netatalk//AppleVolumes.system.
71 -u
73 Read the user´s AppleVolumes file first. This option causes volume
74 names in the user´s AppleVolumes file to override volume names in
75 the system´s AppleVolumes file. The default is to read the system
76 AppleVolumes file first. Note that this option doesn´t effect the
77 precendence of filename extension mappings: the user´s AppleVolumes
78 file always has precedence.
79 -n nbpname
81 Specifies that nbpname should be used for NBP registration, instead
82 of the first component of the hostname in the local zone.
83 -c maxconnections
85 Specifies the maximum number of connections to allow for this afpd.
86 The default is 20.
87 -g guest
89 Specifies the name of the guest account. The default is ´nobody´.
90 -P pidfile
92 Specifies the file in which afpd stores its process id.
93 -S port
95 Specifies the port to register with when doing AFPoverTCP. Defaults
96 to 548. (Equivalent to -port in afpd.conf.)
97 -L message
99 Specifies the login message that will be sent to clients.
100 (Equivalent to -loginmsg in afpd.conf.)
101 -F configfile
103 Specifies the configuration file to use. (Defaults to
104 /etc/netatalk//netatalk/afpd.conf.)
105 -U uams
107 Comma-separated list of UAMs to use for the authentication process.
108 (Equivalent to -uamlist in afpd.conf.)
109 -m umask
111 Use this umask for the creation of folders in Netatalk.
112
114 Signals that are sent to the main afpd process are propagated to the
115 children, so all will be affected.
116 SIGHUP
118 Sending a SIGHUP to afpd will cause it to reload its configuration
119 files.
120 SIGINT
122 Sending a SIGINT to a child afpd enables max_debug logging for this
123 process. The log is sent to fhe file /tmp/afpd.PID.XXXXXX. Sending
124 another SIGINT will terminate the process.
125 SIGUSR1
127 The afpd process will send the message "The server is going down
128 for maintenance." to the client and shut itself down in 5 minutes.
129 New connections are not allowed. If this is sent to a child afpd,
130 the other children are not affected. However, the main process will
131 still exit, disabling all new connections.
132 SIGUSR2
134 The afpd process will look in the message directory configured at
135 build time for a file named message.pid. For each one found, a the
136 contents will be sent as a message to the associated AFP client.
137 The file is removed after the message is sent. This should only be
138 sent to a child afpd.
139 To shut down a user´s afpd process it is recommended that SIGKILL
141 (-9) NOT be used, except as a last resort, as this may leave the
142 CNID database in an inconsistent state. The safe way to terminate
143 an afpd is to send it a SIGTERM (-15) signal and wait for it to die
144 on its own.
145
147 /etc/netatalk//afpd.conf
148 configuration file used by afpd
149 /etc/netatalk//AppleVolumes.default
151 list of default volumes to mount
152 /etc/netatalk//AppleVolumes.system
154 list of volumes to offer all users
155 ~/AppleVolumes, ~/.AppleVolumes, ~/applevolumes, ~/.applevolumes
157 user´s list of volumes to mount
158 /etc/netatalk//afp_signature.conf
160 list of server signature
161 /etc/netatalk//netatalk/msg/message.pid
163 contains messages to be sent to users.
164
167 hosts_access(5), afpd.conf(5), AppleVolumes.default(5),
168 afp_signature.conf(5), dbd(1).
169Netatalk 2.1 21 Apr 2010 AFPD(8)