1afpd(8) Netatalk afpd(8)
2
6 afpd - AppleTalk Filing Protocol daemon
7
9 afpd [-duptDTvI] [-f defaultvolumes] [-s systemvolumes] [-n nbpname]
10 [-c maxconnections] [-g guest] [-P pidfile] [-S port] [-L message] [-F
11 config] [-U uamsv] [-m umask]
12
14 afpd provides an AppleTalk Filing Protocol (AFP) interface to the Unix
15 file system. It is normally started at boot time from /etc/rc.
16 The list of volumes offered to the user is generated from
18 /etc/atalk//AppleVolumes.system and one of /etc/atalk//AppleVol‐
19 umes.default, ~/AppleVolumes, or ~/.AppleVolumes. The AppleVolumes
20 files is used to specify volumes to mount and file name extension map‐
21 pings. It is formatted as follows, one specification per line: pathname
22 [ volumename ] .extension [ type [ creator ] ] If volumename is unspec‐
23 ified, the last component of pathname is used. No two volumes may have
24 the same name. If type is unspecified '????' is used. If creator is
25 unspecified 'UNIX' is used. The extension '.' sets the default creator
26 and type for otherwise untyped Unix files. Blank lines and lines begin‐
27 ning with `#' are ignored.
28
30 -d Specifies that the daemon should not fork. If netatalk has been
31 configured with --enable-debug1, a trace of all AFP commands
32 will be written to stdout.
33 -p Prevents clients from saving their passwords. (Equivalent to
35 -nosavepasswd in afpd.conf.)
36 -t Allows clients to change their passwords. (Equivalent to -set‐
38 passwd in afpd.conf.)
39 -D Use DDP (AppleTalk) as transport protocol. (Equivalent to -ddp
41 in afpd.cond.)
42 -T Use TCP/IP as transport protocol. (Equivalent to -tcp in
44 afpd.conf.)
45 -v Print version information and exit.
47 -I Use a platform specific icon. (Equivalent to -icon in
49 afpd.conf.)
50 -f defaultvolumes
52 Specifies that defaultvolumes should be read for a list of
53 default volumes to offer, instead of /etc/atalk//AppleVol‐
54 umes.default.
55 -s systemvolumes
57 Specifies that systemvolumes should be read for a list of volume
58 that all users will be offered, instead of /etc/atalk//AppleVol‐
59 umes.system.
60 -u Read the user's AppleVolumes file first. This option causes vol‐
62 ume names in the user's AppleVolumes file to override volume
63 names in the system's AppleVolumes file. The default is to read
64 the system AppleVolumes file first. Note that this option
65 doesn't effect the precendence of filename extension mappings:
66 the user's AppleVolumes file always has precedence.
67 -n nbpname
69 Specifies that nbpname should be used for NBP registration,
70 instead of the first component of the hostname in the local
71 zone.
72 -c maxconnections
74 Specifies the maximum number of connections to allow for this
75 afpd. The default is 20.
76 -g guest
78 Specifies the name of the guest account. The default is
79 'nobody'.
80 -P pidfile
82 Specifies the file in which afpd stores its process id.
83 -S port
85 Specifies the port to register with when doing AFPoverTCP.
86 Defaults to 548. (Equivalent to -port in afpd.conf.)
87 -L message
89 Specifies the login message that will be sent to clients.
90 (Equivalent to -loginmsg in afpd.conf.)
91 -F configfile
93 Specifies the configuration file to use. (Defaults to
94 /etc/atalk//netatalk/afpd.conf.)
95 -U uams
97 Comma-separated list of UAMs to use for the authentication
98 process. (Equivalent to -uamlist in afpd.conf.)
99 -m umask
101 Use this umask for the creation of folders in Netatalk.
102
104 Signals that are sent to the main afpd process are propagated to the
105 children, so all will be affected.
106 SIGHUP Sending a SIGHUP to afpd will cause it to reload its configura‐
108 tion files.
109 SIGUSR1
111 The afpd process will send the message "The server is going down
112 for maintenance." to the client and shut itself down in 5 min‐
113 utes. New connections are not allowed. If this is sent to a
114 child afpd, the other children are not affected. However, the
115 main process will still exit, disabling all new connections.
116 SIGUSR2
118 The afpd process will look in the message directory configured
119 at build time for a file named message.pid. For each one found,
120 a the contents will be sent as a message to the associated AFP
121 client. The file is removed after the message is sent. This
122 should only be sent to a child afpd. Warning: If the
123 --with-message-dir option was not used, this will kill the afpd
124 process
125 To shut down a user's afpd process it is recommended that
127 SIGKILL (-9) NOT be used, except as a last resort, as this may
128 leave the CNID database in an inconsistent state. The safe way
129 to terminate an afpd is to send it a SIGTERM (-15) signal and
130 wait for it to die on its own.
131
133 /etc/atalk//AppleVolumes.default
134 list of default volumes to mount
135 /etc/atalk//AppleVolumes.system
137 list of volumes to offer all users
138 ~/AppleVolumes
140 user's list of volumes to mount
141 /etc/atalk//netatalk/msg/message.pid
143 contains messages to be sent to users.
144
147 hosts_access(5), afpd.conf(5), AppleVolumes.default(5), AppleVol‐
148 umes.system(5).
1492.0.3 06 Jan 2004 afpd(8)