]> arthur.barton.de Git - netatalk.git/commitdiff
document the cnidscheme: parameter
authorbfernhomberg <bfernhomberg>
Fri, 26 Sep 2003 23:54:29 +0000 (23:54 +0000)
committerbfernhomberg <bfernhomberg>
Fri, 26 Sep 2003 23:54:29 +0000 (23:54 +0000)
config/AppleVolumes.default.tmpl [new file with mode: 0644]
config/Makefile.am

diff --git a/config/AppleVolumes.default.tmpl b/config/AppleVolumes.default.tmpl
new file mode 100644 (file)
index 0000000..cf59796
--- /dev/null
@@ -0,0 +1,102 @@
+# This file looks empty when viewed with "vi".  In fact, there is one
+# '~', so users with no AppleVolumes file in their home directory get
+# their home directory by default.
+# 
+# volume format:
+# :DEFAULT: [all of the default options except volume name]
+# path [name] [casefold:x] [options:z,l,j] \
+#   [allow:a,@b,c,d] [deny:a,@b,c,d] [dbpath:path] [password:p] \
+#   [rwlist:a,@b,c,d] [rolist:a,@b,c,d] [limitsize:value in bytes]\
+#   [preexec:cmd] [root_preexec:cmd] [postexec:cmd]  [root_postexec:cmd] 
+#
+#
+# name:      volume name. it can't include the ':' character and is limited
+#            to 27 characters in length.
+#
+# variable substitutions:
+# you can use variables for both <path> and <name> now. here are the
+# rules:
+#     1) if you specify an unknown variable, it will not get converted. 
+#     2) if you specify a known variable, but that variable doesn't have
+#        a value, it will get ignored.
+#
+# the variables:
+# $b   -> basename of path
+# $c   -> client's ip or appletalk address
+# $d   -> volume pathname on server    
+# $f   -> full name (whatever's in the gecos field)
+# $g   -> group
+# $h   -> hostname 
+# $s   -> server name (can be the hostname)
+# $u   -> username (if guest, it's whatever user guest is running as)
+# $v   -> volume name (either ADEID_NAME or basename of path)
+# $z   -> zone (may not exist)
+# $$   -> $
+#
+# casefold options [syntax: casefold:option]:
+# tolower    -> lowercases names in both directions
+# toupper    -> uppercases names in both directions
+# xlatelower -> client sees lowercase, server sees uppercase
+# xlateupper -> client sees uppercase, server sees lowercase
+#
+# allow/deny/rwlist/rolist format [syntax: allow:user1,@group]:
+# user1,@group,user2  -> allows/denies access from listed users/groups
+#                        rwlist/rolist control whether or not the
+#                       volume is ro for those users.
+# preexec             -> command to be run when the volume is mounted,
+#                        ignore for user defined volumes
+# root_preexec        -> command to be run as root when the volume is mounted,
+#                        ignore for user defined volumes
+# postexec             -> command to be run when the volume is closed,
+#                        ignore for user defined volumes
+# root_postexec        -> command to be run as root when the volume is closed,
+#                        ignore for user defined volumes
+#
+# codepage options [syntax: options:charsetname]
+# volcharset           -> specifies the charset to be used as the volume codepage
+#                         e.g. "UTF8", "UTF8-MAC", "ISO-8859-15"
+# maccharset           -> specifies the charset to be used as the mac client codepage
+#                         e.g. "MAC_ROMAN", "MAC_CYRILLIC"
+#
+# miscellaneous options [syntax: options:option1,option2]:
+# prodos              -> make compatible with appleII clients.
+# crlf                -> enable crlf translation for TEXT files.
+# noadouble           -> don't create .AppleDouble unless a resource
+#                        fork needs to be created.
+# ro                  -> mount the volume as read-only.
+# mswindows           -> enforce filename restrictions imposed by MS
+#                        Windows. this will also invoke a default
+#                       codepage (iso8859-1) if one isn't already 
+#                       specified.
+# nohex                      -> don't do :hex translations for anything
+#                       except dot files. specify usedots as well if
+#                       you want that turned off. note: this option
+#                       makes the / character illegal.
+# usedots             -> don't do :hex translation for dot files. note: when 
+#                        this option gets set, certain file names
+#                       become illegal. these are .Parent and
+#                       anything that starts with .Apple. also, dot
+#                       files created on the unix side are marked
+#                       invisible. 
+# limitsize           -> limit disk size reporting to 2GB. this is
+#                        here for older macintoshes using newer
+#                        appleshare clients. yucko.
+# nofileid            -> don't advertise createfileid, resolveid, deleteid 
+#                        calls
+# root_preexec_close  -> a non-zero return code from root_preexec close the 
+#                        volume being mounted.
+# preexec_close       -> a non-zero return code from preexec close the 
+#                        volume being mounted.
+# nostat              -> don't stat volume path when enumerating volumes list
+# upriv               -> use unix privilege.  
+#
+#
+# dbpath:path         -> store the database stuff in the following path.
+# password:password   -> set a volume password (8 characters max)
+# cnidscheme:scheme   -> set the cnid scheme for the volume, default is [:DEFAULT_CNID_SCHEME:]
+#                        available schemes: [:COMPILED_BACKENDS:]
+#
+# The "~" below indicates that Home directories are visible by default.
+# If you do not wish to have people accessing their Home directories,
+# please put a pound sign in front of the tilde or delete it.
+~
index 9a62b83bf930132b0f91c25443785e6715180199..d1c372805f6dd86b6f067c48eedd9bc17b66dbc7 100644 (file)
@@ -2,9 +2,9 @@
 
 SUFFIXES = .tmpl .
 
-GENFILES = afpd.conf
+GENFILES = afpd.conf AppleVolumes.default
 TMPLFILES = $(foreach file,$(GENFILES),$(file).tmpl)
-CONFFILES = AppleVolumes.default AppleVolumes.system \
+CONFFILES = AppleVolumes.system \
        atalkd.conf netatalk.conf papd.conf
 PAMFILES = netatalk.pamd
 OVERWRITE_CONFIG = @OVERWRITE_CONFIG@
@@ -22,6 +22,8 @@ pkgconfdir = @PKGCONFDIR@
 .tmpl:
        sed -e s@:UAMS_PATH:@${UAMS_PATH}@ \
            -e s@:ETCDIR:@${pkgconfdir}@ \
+           -e s@:COMPILED_BACKENDS:@"$(compiled_backends)"@ \
+           -e s@:DEFAULT_CNID_SCHEME:@$(DEFAULT_CNID_SCHEME)@ \
            <$< >$@
 
 #