1 .\" $Id: AppleVolumes.default.5.tmpl,v 1.1 2000-09-22 15:18:44 arichard Exp $
2 .TH AppleVolumes.default 5 "20 September 2000" "netatalk 1.5"
5 AppleVolumes.default \- Configuration file used by \fBafpd\fR(8)
6 to determine the shares made available through Appletalk
9 \fB:ETCDIR:/AppleVolumes.default\fR is the configuration file used
10 by afpd to determine what portions of the file system will be shared via
11 Appletalk, as well as their behaviors.
13 Any line not prefixed with \fB#\fR is interpreted. The configuration lines
27 The path name must be a fully qualified path name, or a path name using
28 either the \fB~\fR shell shorthand or any of the substitution variables,
29 which are listed below.
31 The chooser name is the name that appears in the Chooser on Macintoshes
32 to represent the appropriate share. If there are spaces in the name, it
33 should be in quotes (i.e. \fB"File Share"\fR). The chooser name may not
34 exceed 27 characters in length, and cannot contain the \fB:\fR character.
36 The possible options and their meanings are:
39 .B allow:[users/groups]
40 The allow option allows the users and groups that access a share to
41 be specified. Users and groups are specified, delimited by commas. Groups
42 are designated by a \fB@\fR prefix.
44 \fIExample:\fR \fBallow:user1,user2,@group\fR
48 The casefold option handles how casenames should be mangled. The available
51 \fBtolower\fR - Lowercases names in both directions.
53 \fBtoupper\fR - Uppercases names in both directions.
55 \fBxlatelower\fR - Client sees lowercase, server sees uppercase.
57 \fBxlateupper\fR - Client sees uppercase, server sees lowercase.
60 .B codepage:[nls file]
61 The codepage option loads a specific codepage from the nls directory.
65 Sets the database information to be stored in \fBpath\fR.
68 .B deny:[users/groups]
69 The deny option specifies users and groups who are not allowed access
70 to the share. It follows the same format as the \fBallow\fR option.
74 This allows multiple options to be specified in a comma delimited format.
75 The available options are:
77 \fBcrlf\fR - Enables crlf translation for TEXT files.
79 \fBlimitsize\fR - Hack for older Macintoshes using newer Appleshare
80 clients to limit the disk size reporting to 2 GB.
82 \fBmswindows\fR - Forces filename restrictions imposed by MS WinXX, and
83 invokes the MS default codepage (iso8859-1) if one is not already
86 \fBnoadouble\fR - Forces afpd to not create .AppleDouble unless a resource
87 fork needs to be created.
89 \fBnohex\fR - Disables :hex translations for anything except dot files.
90 This option makes the \fB/\fR character illegal.
92 \fBprodos\fR - Provides compatibility with Apple II clients.
94 \fBro\fR - Specifies the share as being read only for all users.
96 \fBusedots\fR - Don't do :hex translation for dot files. This makes all
97 files such as .Parent, .Apple* illegal. Dot files created on the server
98 side will be invisible to the client.
101 .B password:[password]
102 This option allows you to set a volume password, which can be a maximum
103 of 8 characters long.
106 .B rolist:[users/groups]
107 Allows certain users and groups to have read-only access to a share.
108 This follows the \fBallow\fR option format.
111 .B rwlist:[users/groups]
112 Allows certain users and groups to have read/write access to a share.
113 This follows the \fBallow\fR option format.
116 The variables which can be used for subsitutions are:
120 client's ip or appletalk address
124 full name (contents of the gecos field in the passwd file)
136 server name (this can be the hostname)
140 user name (if guest, it is the user that guest is running as)
144 volume name (either ADEID_NAME or basename of path)
148 appletalk zone (may not exist)
152 prints dollar sign (\fb$\fR)