X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=config%2FAppleVolumes.default.tmpl;h=945672cc3d7880723e2781fbd397c3adb40bfc92;hb=154c130f7a3a407e686eda99a6658773e137b05f;hp=3ca2506baaf6010edeebd257255381f586c17162;hpb=a86b4806370009090b93d1b78b042a73f93b5b00;p=netatalk.git diff --git a/config/AppleVolumes.default.tmpl b/config/AppleVolumes.default.tmpl index 3ca2506b..945672cc 100644 --- a/config/AppleVolumes.default.tmpl +++ b/config/AppleVolumes.default.tmpl @@ -1,7 +1,8 @@ # 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] \ @@ -10,10 +11,11 @@ # [preexec:cmd] [root_preexec:cmd] [postexec:cmd] [root_postexec:cmd] \ # [allowed_hosts:IPv4 address[/IPv4 netmask bits]] \ # [denied_hosts:IPv4 address[/IPv4 netmask bits]] \ +# ... more, see below ... # -# -# # name: volume name. it can't include the ':' character +# + # # variable substitutions: # you can use variables for both and now. here are the @@ -35,6 +37,8 @@ # $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 @@ -56,24 +60,70 @@ # 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, +# 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, +# root_postexec -> command to be run as root when the volume is closed, # ignore for user defined volumes +# veto -> hide files and directories,where the path matches +# one of the "/" delimited vetoed names. Matches are +# partial, e.g. path is /abc/def/file and veto:/abc/ +# will hide the file. +# adouble -> specify the format of the metadata files. +# default is "v2". netatalk 1.x used "v1". +# "osx" cannot be treated normally any longer. +# volsizelimit -> size in MiB. Useful for TimeMachine: limits the +# reported volume size, thus preventing TM from using +# the whole real disk space for backup. +# Example: "volsizelimit:1000" would limit the +# reported disk space to 1 GB. + + # # 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" +# 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" +# +# perm -> default permission value +# OR with the client requested perm +# Use with options:upriv +# dperm -> default permission value for directories +# OR with the client requested perm +# Use with options:upriv +# fperm -> default permission value for files +# OR with the client requested perm +# Use with options:upriv +# umask -> set perm mask +# Use with options:upriv +# dbpath:path -> store the database stuff in the following path. +# cnidserver:server[:port] +# -> Query this servername or IP address +# (default:localhost) and port (default: 4700) +# for CNIDs. Only used with CNID backend "dbd". +# This option here overrides any setting from +# afpd.conf:cnidserver. +# 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:] +# ea -> none|auto|sys|ad +# Specify how Extended Attributes are stores. default +# is auto. +# auto: try "sys" (by setting an EA on the shared +# directory itself), fallback to "ad". Requires +# writable volume for performing the test. +# Note: options:ro overwrites "auto" with "none." +# sys: Use filesystem EAs +# ad: Use files in AppleDouble directories +# none: No EA support # -# perm -> default permission value OR with the client requested perm -# dperm -> default permission value for directories OR with the client -# requested perm -# fperm -> default permission value for filesOR with the client -# requested perm + # # miscellaneous options [syntax: options:option1,option2]: +# tm -> enable TimeMachine support # prodos -> make compatible with appleII clients. # crlf -> enable crlf translation for TEXT files. # noadouble -> don't create .AppleDouble unless a resource @@ -81,21 +131,21 @@ # 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. +# 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. +# become illegal. these are .Parent and +# anything that starts with .Apple. # invisibledots -> 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. +# 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. @@ -107,21 +157,30 @@ # volume being mounted. # nostat -> don't stat volume path when enumerating volumes list # upriv -> use unix privilege. -# illegalseq -> encode illegal sequence in filename asis, ex "\217-", which is not -# a valid SHIFT-JIS char, is encoded as U\217 - -# acls -> Enable ACLs on this volume. Requires a NFSv4 ACLs -# compatible filesystem (e.g. ZFS) and an ACL API -# compatible to *Solaris. In other words: this requires -# Solaris, Opensolaris or a derived distribution. - -# -# -# 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:] +# illegalseq -> encode illegal sequence in filename asis, +# ex "\217-", which is not a valid SHIFT-JIS char, +# is encoded as U\217 - +# nocnidcache -> Don't store and read CNID to/from AppleDouble file. +# This should not be used as it also prevents a CNID +# database rebuild with `dbd`! +# caseinsensitive -> The underlying FS is case insensitive (only +# test with JFS in OS2 mode) +# dropbox -> Allows a volume to be declared as being a "dropbox." +# Note that netatalk must be compiled with dropkludge +# support for this to function. Warning: This option +# is deprecated and might not work as expected. +# dropkludge -> same as "dropbox" +# nodev -> always use 0 for device number, helps when the +# device number is not constant across a reboot, +# cluster, ... # + +# The line below sets some DEFAULT, starting with Netatalk 2.1. +:DEFAULT: options:upriv,usedots + # 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. ~ + +# End of File