1
.\" $Id: afpd.conf.5.tmpl,v 1.3 2002/05/03 22:51:34 jmarcus Exp $
2
.TH afpd.conf 5 "28 September 2000" "netatalk 1.5"
5
afpd.conf \- Configuration file used by \fBafpd\fR(8)
6
to determine the setup of its file sharing services
9
\fB:ETCDIR:/afpd.conf\fR is the configuration file used
10
by afpd to determine the behavior and configuration of the different
11
virtual file servers that it provides.
13
Any line not prefixed with \fB#\fR is interpreted. The configuration lines
25
If a \fB-\fR is used instead of a server name, the default server is
26
specified. Server names must be quoted if they contain spaces.
28
The path name must be a fully qualified path name, or a path name using
29
either the \fB~\fR shell shorthand or any of the substitution variables,
30
which are listed below.
32
The possible options and their meanings are:
39
Specifies path to AppleVolumes.default file (default is
40
\fB:ETCDIR:/AppleVolumes.default\fR).
44
Specifies the path to the code pages (default is \fB:ETCDIR:/nls\fR).
48
Specifies path to AppleVolumes.system file (default is
49
\fB:ETCDIR:/AppleVolumes.system\fR).
53
Enables or disables reading of the users' individual volumes file
58
Enables or disables reading of the users' individual volumes file
59
before processing the global \fBAppleVolumes.default\fR file.
62
.I Authentication Methods
65
.B -uamlist [uams list]
66
Comma separated list of UAMs. (The default is
67
\fBuams_guest.so,uams_passwd.so,uams_dhx_passwd.so\fR).
68
The most commonly used UAMs are:
70
\fBuams_dhx_passwd.so or uams_dhx_pam.so\fR - allows logins
71
using Diffie-Hellman eXchange (DHX)
73
\fBuams_guest.so\fR - allows guest logins
75
\fBuams_passwd.so or uams_pam.so\fR - allows logins with clear
78
\fBuams_randum.so\fR - allows Random Number and Two-Way Random
79
Number Exchange for authentication (requires \fB:ETCDIR:/afppaswd\fR
84
Sets the default path for UAMs for this server (default is
91
.B -loginmaxmail [number]
92
Sets the maximum number of failed logins, if supported by the UAM
96
Sets the path to the Randnum passwd file for this server (default is
97
\fB:ETCDIR:/afppasswd\fR).
100
.B -passwdminlen [number]
101
Sets the minimum password length, if supported by the UAM
105
Enables or disables the ability of clients to save passwords locally
109
Enables or disables the ability of clients to change their passwords
113
.I Transport Protocols
117
Enables or disables AFP-over-Appletalk. If \fB-proxy\fR is specified, you must
118
instead use \fB-uamlist ""\fR to prevent DDP connections from working.
122
Enables or disables AFP-over-TCP
128
.B -admingroup [group]
129
Allows users of a certain group to be seen as the superuser when they
130
log in. This option is disabled, by default.
133
.B -ddpaddr [ddp address]
134
Specifies the DDP address of the server. The default is to auto-assign an
135
address (0.0). This is only useful if you are running on a multihomed host.
139
Specifies a fully-qualified domain name, with an optional port. This is
140
discarded if the server cannot resolve it. This option is not honored by
141
AppleShare clients <= 3.8.3. This option is disabled by default.
144
.B -ipaddr [ip address]
145
Specifies the IP that the server should respond to (the default is the
146
first IP address of the system). This option also allows one machine to
147
advertise TCP/IP for another machine.
150
.B -port [port number]
151
Allows a different TCP port to be specified for AFP-over-TCP. The default
156
Runs an AppleTalk proxy server for the specified AFP-over-TCP server. If
157
the address and port aren't given, then the first IP address of the system
158
and port 548 will be used. If you don't want the proxy server to act as a
159
DDP server as well, set \fB-uamlist ""\fR.
162
.B -server_quantum [number]
163
This specifoes the DSI server quantum. The minimum value is 1 MB. The
164
maximum value is 0xFFFFFFFFF. If you specify a value that is out of
165
range, the default value will be set (which is the minimum).
169
Do not register this server using the Service Location Protocol (if SLP
170
support was compiled in). This is useful if you are running multiple
171
servers and want one to be hidden, perhaps because it is advertised elsewhere.
174
.I Miscellaneous Options
178
Specifies the user that guests should use (default is \fB"nobody"\fR). The
179
name should be quoted.
183
Use the platform-specific icon
186
.B -loginmsg [message]
187
Sets a message to be displayed when clients logon to the server. The
188
message should be quoted.
195
.B -tickleval [number]
196
Sets the tickle timeout interval (in seconds).
199
afpd(8), AppleVolumes.default(5)