config/AppleVolumes.default.tmpl

   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.
   4 #
   5 # volume format:
   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]
  11 #
  12 #
  13 # name:      volume name. it can't include the ':' character and is limited
  14 #            to 27 characters in length.
  15 #
  16 # variable substitutions:
  17 # you can use variables for both <path> and <name> now. here are the
  18 # rules:
  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.
  22 #
  23 # the variables:
  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)
  28 # $g   -> group
  29 # $h   -> hostname
  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)
  35 # $$   -> $
  36 #
  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
  42 #
  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
  55 #
  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"
  61 #
  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
  71 #                        specified.
  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
  85 #                        invisible.
  86 # limitsize           -> limit disk size reporting to 2GB. this is
  87 #                        here for older macintoshes using newer
  88 #                        appleshare clients. yucko.
  89 # nofileid            -> don't advertise createfileid, resolveid, deleteid
  90 #                        calls
  91 # root_preexec_close  -> a non-zero return code from root_preexec close the
  92 #                        volume being mounted.
  93 # preexec_close       -> a non-zero return code from preexec close the
  94 #                        volume being mounted.
  95 # nostat              -> don't stat volume path when enumerating volumes list
  96 # upriv               -> use unix privilege.
  97 # perm                -> default permission value OR with the client requested perm
  98 #
  99 #
 100 # dbpath:path         -> store the database stuff in the following path.
 101 # password:password   -> set a volume password (8 characters max)
 102 # cnidscheme:scheme   -> set the cnid scheme for the volume, default is [:DEFAULT_CNID_SCHEME:]
 103 #                        available schemes: [:COMPILED_BACKENDS:]
 104 #
 105 # The "~" below indicates that Home directories are visible by default.
 106 # If you do not wish to have people accessing their Home directories,
 107 # please put a pound sign in front of the tilde or delete it.
 108 ~