afpd(8) Netatalk afpd(8)
afpd - AppleTalk Filing Protocol daemon
afpd [-duptDTvI] [-f defaultvolumes] [-s systemvolumes] [-n nbpname]
[-c maxconnections] [-g guest] [-P pidfile] [-S port] [-L message] [-F
config] [-U uamsv] [-m umask]
afpd provides an AppleTalk Filing Protocol (AFP) interface to the Unix
file system. It is normally started at boot time from /etc/rc.
The list of volumes offered to the user is generated from
/etc/atalk//AppleVolumes.system and one of /etc/atalk//AppleVol-
umes.default, ~/AppleVolumes, or ~/.AppleVolumes. The AppleVolumes
files is used to specify volumes to mount and file name extension map-
pings. It is formatted as follows, one specification per line: pathname
[ volumename ] .extension [ type [ creator ] ] If volumename is unspec-
ified, the last component of pathname is used. No two volumes may have
the same name. If type is unspecified ’????’ is used. If creator is
unspecified ’UNIX’ is used. The extension ’.’ sets the default creator
and type for otherwise untyped Unix files. Blank lines and lines begin-
ning with ‘#’ are ignored.
-d Specifies that the daemon should not fork. If netatalk has been
configured with --enable-debug1, a trace of all AFP commands
will be written to stdout.
-p Prevents clients from saving their passwords. (Equivalent to
-nosavepasswd in afpd.conf.)
-t Allows clients to change their passwords. (Equivalent to -set-
passwd in afpd.conf.)
-D Use DDP (AppleTalk) as transport protocol. (Equivalent to -ddp
-T Use TCP/IP as transport protocol. (Equivalent to -tcp in
-v Print version information and exit.
-I Use a platform specific icon. (Equivalent to -icon in
Specifies that defaultvolumes should be read for a list of
default volumes to offer, instead of /etc/atalk//AppleVol-
Specifies that systemvolumes should be read for a list of volume
that all users will be offered, instead of /etc/atalk//AppleVol-
-u Read the user’s AppleVolumes file first. This option causes vol-
ume names in the user’s AppleVolumes file to override volume
names in the system’s AppleVolumes file. The default is to read
the system AppleVolumes file first. Note that this option
doesn’t effect the precendence of filename extension mappings:
the user’s AppleVolumes file always has precedence.
Specifies that nbpname should be used for NBP registration,
instead of the first component of the hostname in the local
Specifies the maximum number of connections to allow for this
afpd. The default is 20.
Specifies the name of the guest account. The default is
Specifies the file in which afpd stores its process id.
Specifies the port to register with when doing AFPoverTCP.
Defaults to 548. (Equivalent to -port in afpd.conf.)
Specifies the login message that will be sent to clients.
(Equivalent to -loginmsg in afpd.conf.)
Specifies the configuration file to use. (Defaults to
Comma-separated list of UAMs to use for the authentication pro-
cess. (Equivalent to -uamlist in afpd.conf.)
Use this umask for the creation of folders in Netatalk.
Signals that are sent to the main afpd process are propagated to the
children, so all will be affected.
SIGHUP Sending a SIGHUP to afpd will cause it to reload its configura-
The afpd process will send the message "The server is going down
for maintenance." to the client and shut itself down in 5 min-
utes. 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.
The afpd 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 afpd. Warning: If the
--with-message-dir option was not used, this will kill the afpd
To shut down a user’s afpd process it is recommended that
SIGKILL (-9) NOT be used, except as a last resort, as this may
leave the CNID database in an inconsistent state. The safe way
to terminate an afpd is to send it a SIGTERM (-15) signal and
wait for it to die on its own.
list of default volumes to mount
list of volumes to offer all users
user’s list of volumes to mount
contains messages to be sent to users.
hosts_access(5), afpd.conf(5), AppleVolumes.default(5), AppleVol-
2.0.2 06 Jan 2004 afpd(8)
Man(1) output converted with