1 # This file looks empty when viewed with "vi". In fact, there is one
2 # '~', so users with no AppleVolumes file in their home directory get
3 # their home directory by default.
6 # :DEFAULT: [all of the default options except volume name]
7 # path [name] [casefold:x] [options:z,l,j] \
8 # [allow:a,@b,c,d] [deny:a,@b,c,d] [dbpath:path] [password:p] \
9 # [rwlist:a,@b,c,d] [rolist:a,@b,c,d] [limitsize:value in bytes]\
10 # [preexec:cmd] [root_preexec:cmd] [postexec:cmd] [root_postexec:cmd]
13 # name: volume name. it can't include the ':' character and is limited
14 # to 27 characters in length.
16 # variable substitutions:
17 # you can use variables for both <path> and <name> now. here are the
19 # 1) if you specify an unknown variable, it will not get converted.
20 # 2) if you specify a known variable, but that variable doesn't have
21 # a value, it will get ignored.
24 # $b -> basename of path
25 # $c -> client's ip or appletalk address
26 # $d -> volume pathname on server
27 # $f -> full name (whatever's in the gecos field)
30 # $i -> client ip without tcp port or appletalk network
31 # $s -> server name (can be the hostname)
32 # $u -> username (if guest, it's whatever user guest is running as)
33 # $v -> volume name (either ADEID_NAME or basename of path)
34 # $z -> zone (may not exist)
37 # casefold options [syntax: casefold:option]:
38 # tolower -> lowercases names in both directions
39 # toupper -> uppercases names in both directions
40 # xlatelower -> client sees lowercase, server sees uppercase
41 # xlateupper -> client sees uppercase, server sees lowercase
43 # allow/deny/rwlist/rolist format [syntax: allow:user1,@group]:
44 # user1,@group,user2 -> allows/denies access from listed users/groups
45 # rwlist/rolist control whether or not the
46 # volume is ro for those users.
47 # preexec -> command to be run when the volume is mounted,
48 # ignore for user defined volumes
49 # root_preexec -> command to be run as root when the volume is mounted,
50 # ignore for user defined volumes
51 # postexec -> command to be run when the volume is closed,
52 # ignore for user defined volumes
53 # root_postexec -> command to be run as root when the volume is closed,
54 # ignore for user defined volumes
56 # codepage options [syntax: options:charsetname]
57 # volcharset -> specifies the charset to be used as the volume codepage
58 # e.g. "UTF8", "UTF8-MAC", "ISO-8859-15"
59 # maccharset -> specifies the charset to be used as the mac client codepage
60 # e.g. "MAC_ROMAN", "MAC_CYRILLIC"
62 # miscellaneous options [syntax: options:option1,option2]:
63 # prodos -> make compatible with appleII clients.
64 # crlf -> enable crlf translation for TEXT files.
65 # noadouble -> don't create .AppleDouble unless a resource
66 # fork needs to be created.
67 # ro -> mount the volume as read-only.
68 # mswindows -> enforce filename restrictions imposed by MS
69 # Windows. this will also invoke a default
70 # codepage (iso8859-1) if one isn't already
72 # nohex -> don't do :hex translations for anything
73 # except dot files. specify usedots as well if
74 # you want that turned off. note: this option
75 # makes the / character illegal.
76 # usedots -> don't do :hex translation for dot files. note: when
77 # this option gets set, certain file names
78 # become illegal. these are .Parent and
79 # anything that starts with .Apple.
80 # invisibledots -> don't do :hex translation for dot files. note: when
81 # this option gets set, certain file names
82 # become illegal. these are .Parent and
83 # anything that starts with .Apple. also, dot
84 # files created on the unix side are marked invisible.
85 # limitsize -> limit disk size reporting to 2GB. this is
86 # here for older macintoshes using newer
87 # appleshare clients. yucko.
88 # nofileid -> don't advertise createfileid, resolveid, deleteid
90 # root_preexec_close -> a non-zero return code from root_preexec close the
91 # volume being mounted.
92 # preexec_close -> a non-zero return code from preexec close the
93 # volume being mounted.
94 # nostat -> don't stat volume path when enumerating volumes list
95 # upriv -> use unix privilege.
96 # perm -> default permission value OR with the client requested perm
99 # dbpath:path -> store the database stuff in the following path.
100 # password:password -> set a volume password (8 characters max)
101 # cnidscheme:scheme -> set the cnid scheme for the volume, default is [:DEFAULT_CNID_SCHEME:]
102 # available schemes: [:COMPILED_BACKENDS:]
104 # The "~" below indicates that Home directories are visible by default.
105 # If you do not wish to have people accessing their Home directories,
106 # please put a pound sign in front of the tilde or delete it.