]> arthur.barton.de Git - netatalk.git/blob - man/man5/netatalk.conf.5
New man pages (section 5) for config files, initial import
[netatalk.git] / man / man5 / netatalk.conf.5
1 .\" $Id: netatalk.conf.5,v 1.1 2000-09-20 19:24:22 rufustfirefly Exp $
2 .TH NETATALK.CONF 5 "18 September 2000" "netatalk 1.5"
3 .UC 4
4 .SH NAME
5 netatalk.conf \- Configuration file used by \fBafpd\fR(8),
6 \fBpapd\fR(8) and \fBatalkd\fR(8) as part of netatalk.
7
8 .SH DESCRIPTION
9 \fB/etc/atalk/netatalk.conf\fR is the main configuration file for netatalk.
10 It consists of a series of bash-style assignments. The possible variables
11 and their meanings are:
12
13 .TP
14 .B ATALK_NAME
15 This is the machines' Appletalk name. Note that spaces in this name may cause
16 problems due to passing in the shell scripts. The default value of
17 \fB`echo ${HOSTNAME}|cut -d. -f1`\fR produces a name based on the host name
18 of the machine (example: \fBmybox.foo.com\fR becomes \fBmybox\fR).
19
20 .TP
21 .B ATALK_ZONE
22 The Appletalk "zone" that the server should be visible in, preceded with
23 the "@" (example: \fBATALK_ZONE=@Donuts\fR). If omitted, it will automatically
24 detect the current zone.
25
26 .TP
27 .B AFPD_GUEST
28 This is the user account that guest runs as. The default should be set to 
29 \fBnobody\fR or another unpriviledged account on the system.
30
31 .TP
32 .B AFPD_MAX_CLIENTS
33 This should be set to the maximum number of clients you want to be able to
34 connect to the \fBafpd\fR daemon concurrently. If you are having problems
35 with connections being refused during high load, you should probably increase
36 this number (example: \fBAFPD_MAX_CLIENTS=50\fR).
37
38 .TP
39 .B AFPD_UAMLIST
40 AFPD_UAMLIST contains the list of the UAMs that should be forced to be
41 loaded, prefixed by a "-U", delimited by commas 
42 (example: \fBAFPD_UAMLIST="-U uams_guest.so,uams_randnum.so"\fR would load
43 the Randnum and Guest authentication modules). If this is omitted, the
44 default modules will load.
45
46 .TP
47 .B ATALK_BGROUND
48 This controls whether the daemons are started in the background or in the
49 foreground. It is recommended that the daemons be started in the foreground
50 so that any dependent programs will load properly. The options are \fByes\fR
51 and \fBno\fR (example: \fBATALK_BGROUND=no\fR).
52
53 .TP
54 .B ATALKD_RUN
55 \fBatalkd\fR is the master Appletalk daemon. This should always be set to
56 \fBon\fR. The options are \fByes\fR and \fBno\fR.
57
58 .TP
59 .B AFPD_RUN
60 \fBafpd\fR is the Appletalk file server daemon. This should be enabled if you
61 are planning on using netatalk to serve files over Appletalk. The options are
62 \fByes\fR and \fBno\fR.
63
64 .TP
65 .B PAPD_RUN
66 \fBpapd\fR is the Appletalk printing daemon. This should be enabled if you
67 wish to serve printers using Appletalk. The options are \fByes\fR and \fBno\fR.
68
69 .P
70 The options in this file control the behavior of the init script(s) for
71 netatalk, which vary by distribution.
72
73 .SH SEE ALSO
74 afpd(8), atalkd(8), papd(8)