man/man5/AppleVolumes.default.5.tmpl

   1 '\" t
   2 .\"     Title: AppleVolumes.default
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 27 Dez 2012
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "APPLEVOLUMES\&.DEFAU" "5" "27 Dez 2012" "Netatalk 3.0" "Netatalk 3.0"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 AppleVolumes.default, AppleVolumes.system, AppleVolumes \- Configuration file used by \fBafpd\fR(8) to determine the shares made available through AFP and specify file name extension mappings\&.
  32 .SH "SYNOPSIS"
  33 .HP \w'\fB:ETCDIR:/AppleVolumes\&.default\fR\fB\fR\fB:ETCDIR:/AppleVolumes\&.system\fR\fB\fR\fB~/AppleVolumes\fR\fB\fR\fB~/\&.AppleVolumes\fR\fB\fR\fB~/applevolumes\fR\fB\fR\fB~/\&.applevolumes\fR\fB\fR\ 'u
  34 \fB:ETCDIR:/AppleVolumes\&.default\fR\fB\fR
  35 .br
  36 \fB:ETCDIR:/AppleVolumes\&.system\fR\fB\fR
  37 .br
  38 \fB~/AppleVolumes\fR\fB\fR
  39 .br
  40 \fB~/\&.AppleVolumes\fR\fB\fR
  41 .br
  42 \fB~/applevolumes\fR\fB\fR
  43 .br
  44 \fB~/\&.applevolumes\fR\fB\fR
  45 .SH "DESCRIPTION"
  46 .PP
  47
  48 :ETCDIR:/AppleVolumes\&.system
  49 and one of
  50 :ETCDIR:/AppleVolumes\&.default,
  51 ~/AppleVolumes,
  52 ~/\&.AppleVolumes,
  53 ~/applevolumes, or
  54 ~/\&.applevolumes
  55 are the configuration files used by
  56 \fBafpd\fR
  57 to determine what portions of the file system will be shared via Apple Filing Protocol, as well as their behaviour\&.
  58 .PP
  59 Any line not prefixed with # is interpreted\&. Newline escaping is supported\&. The configuration lines are composed like:
  60 .PP
  61 path
  62 \fI[ volume name ] [ options ]\fR
  63 .PP
  64 \&.extension
  65 \fI[ type [ creator ] ]\fR
  66 .PP
  67 The path name must be a fully qualified path name, or a path name using either the ~ shell shorthand or any of the substitution variables, which are listed below\&.
  68 .PP
  69 The volume name is the name that appears in the Chooser ot the "connect to server" dialog on Macintoshes to represent the appropriate share\&. If volumename is unspecified, the last component of pathname is used\&. No two volumes may have the same name\&. If there are spaces in the name, it should be in quotes (i\&.e\&. "File Share")\&. The volume name cannot contain the
  70 \*(Aq:\*(Aq
  71 character\&. The volume name is mangled if it is very long\&. Mac codepage volume name is limited to 27 characters\&. UTF8\-MAC volume name is limited to \-volnamelen parameter in afpd\&.conf
  72 .if n \{\
  73 .sp
  74 .\}
  75 .RS 4
  76 .it 1 an-trap
  77 .nr an-no-space-flag 1
  78 .nr an-break-flag 1
  79 .br
  80 .ps +1
  81 \fBNote\fR
  82 .ps -1
  83 .br
  84 .PP
  85 Each volume has to be configured on a
  86 \fBsingle\fR
  87 line\&. Though newline escaping is supported\&.
  88 .sp .5v
  89 .RE
  90 .PP
  91 The leading\-dot lines specify file name extension mappings\&. The extension \*(Aq\&.\*(Aq sets the default creator and type for otherwise untyped Unix files\&.
  92 .if n \{\
  93 .sp
  94 .\}
  95 .RS 4
  96 .it 1 an-trap
  97 .nr an-no-space-flag 1
  98 .nr an-break-flag 1
  99 .br
 100 .ps +1
 101 \fBNote\fR
 102 .ps -1
 103 .br
 104 .PP
 105 File name extension mapping is useful for Mac OS 9 and earlier\&. But it should not use for Mac OS X\&.
 106 .sp .5v
 107 .RE
 108 .PP
 109 It is possible to specify default options for all volumes with a
 110 \fI:DEFAULT: \fRline preceeding these volume definitions:
 111 .PP
 112 \fBExample.\ \&:DEFAULT: configuration line\fR
 113 .sp
 114 .if n \{\
 115 .RS 4
 116 .\}
 117 .nf
 118 :DEFAULT: options:upriv,usedots dbpath:/var/dbd/AppleDB/$v dperm:0775 fperm:0664
 119 .fi
 120 .if n \{\
 121 .RE
 122 .\}
 123 .PP
 124 The possible options and their meanings are:
 125 .PP
 126 adouble:\fI[v1|v2|osx]\fR
 127 .RS 4
 128 Specify the format of the metadata files, which are used for saving Mac resource fork as well\&. Earlier versions used AppleDouble V1, the new default format is V2\&. Starting with Netatalk 2\&.0, the scheme MacOS X 10\&.3\&.x uses, is also supported\&.
 129 .if n \{\
 130 .sp
 131 .\}
 132 .RS 4
 133 .it 1 an-trap
 134 .nr an-no-space-flag 1
 135 .nr an-break-flag 1
 136 .br
 137 .ps +1
 138 \fBNote\fR
 139 .ps -1
 140 .br
 141 \fBadouble:osx\fR
 142 \fBcannot\fR
 143 be treated normally any longer\&. Its only aim was to temporarely share eg\&. FAT32 formatted FireWire harddrives written on a Macintosh with afpd\&. Apple\*(Aqs metadata scheme lacks several essential features, so using it on the server\*(Aqs side will break both CNIDs and MacOS 9 compatibility\&. AppleDouble file of Mac OS X 10\&.6 is incompatible to V1 and V2\&.
 144 .sp .5v
 145 .RE
 146 .RE
 147 .PP
 148 volsizelimit:\fIsize in MiB\fR
 149 .RS 4
 150 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\&.
 151 \fBIMPORTANT: \fR
 152 This is an approximated calculation taking into accout the contents of TM sparsebundle images\&. Therefor you MUST NOT use this volume to store other content when using this option, because it would NOT be accounted\&. The calculation works by reading the band size from the Info\&.plist XML file of the sparsebundle, reading the bands/ directory counting the number of band files, and then multiplying one with the other\&.
 153 .RE
 154 .PP
 155 allow:\fI[users/groups]\fR
 156 .RS 4
 157 The allow option allows the users and groups that access a share to be specified\&. Users and groups are specified, delimited by commas\&. Groups are designated by a @ prefix\&. Example: allow:user1,user2,@group
 158 .RE
 159 .PP
 160 deny:\fI[users/groups]\fR
 161 .RS 4
 162 The deny option specifies users and groups who are not allowed access to the share\&. It follows the same format as the allow option\&.
 163 .RE
 164 .PP
 165 allowed_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&. ]]\fR
 166 .RS 4
 167 Only listed hosts and networks are allowed, all others are rejected\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.
 168 .sp
 169 Example: allowed_hosts:10\&.1\&.0\&.0/16,10\&.2\&.1\&.100,2001:0db8:1234::/48
 170 .RE
 171 .PP
 172 denied_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&.]]\fR
 173 .RS 4
 174 Listed hosts and nets are rejected, all others are allowed\&.
 175 .sp
 176 Example: denied_hosts: 192\&.168\&.100/24,10\&.1\&.1\&.1,2001:db8::1428:57ab
 177 .RE
 178 .PP
 179 cnidscheme:\fI[backend]\fR
 180 .RS 4
 181 set the CNID backend to be used for the volume, default is [:DEFAULT_CNID_SCHEME:] available schemes: [:COMPILED_BACKENDS:]
 182 .RE
 183 .PP
 184 dbpath:\fI[path]\fR
 185 .RS 4
 186 Sets the database information to be stored in path\&. You have to specifiy a writable location, even if the volume is read only\&.
 187 .RE
 188 .PP
 189 cnidserver:\fI[fqdn|IP[:port]]\fR
 190 .RS 4
 191 Query this servername or IP address (default:\fIlocalhost\fR) and port (default:
 192 \fI4700\fR) for CNIDs\&. Only used with CNID backend "\fIdbd\fR"\&. This option here overrides any setting from
 193 afpd\&.conf:\fBcnidserver\fR\&.
 194 .RE
 195 .PP
 196 ea:\fI[none|auto|sys|ad]\fR
 197 .RS 4
 198 Specify how Extended Attributes
 199 are stored\&.
 200 \fBauto\fR
 201 is the default\&.
 202 .PP
 203 auto
 204 .RS 4
 205 Try
 206 \fBsys\fR
 207 (by setting an EA on the shared directory itself), fallback to
 208 \fBad\fR\&. Requires writeable volume for perfoming test\&.
 209 \fBoptions:ro\fR
 210 overwrites
 211 \fBauto\fR
 212 with
 213 \fBnone\fR\&. Use explicit
 214 \fBea:sys|ad\fR
 215 for read\-only volumes where appropiate\&.
 216 .RE
 217 .PP
 218 sys
 219 .RS 4
 220 Use filesystem Extended Attributes\&.
 221 .RE
 222 .PP
 223 ad
 224 .RS 4
 225 Use files in
 226 \fI\&.AppleDouble\fR
 227 directories\&.
 228 .RE
 229 .PP
 230 none
 231 .RS 4
 232 No Extended Attributes support\&.
 233 .RE
 234 .RE
 235 .PP
 236 maccharset:\fI[charset]\fR
 237 .RS 4
 238 specifies the mac client codepage for this Volume, e\&.g\&. "MAC_ROMAN", "MAC_CYRILLIC"\&. If not specified the setting from
 239 afpd\&.conf
 240 is inherited\&. This setting is only required if you need volumes, where the mac codepage differs from the one globally set in
 241 afpd\&.conf\&.
 242 .RE
 243 .PP
 244 options:\fI[option]\fR
 245 .RS 4
 246 This allows multiple options to be specified in a comma delimited format\&. The available options are:
 247 .PP
 248 searchdb
 249 .RS 4
 250 Use fast CNID database namesearch instead of slow recursive filesystem search\&. Relies on a consistent CNID database, ie Samba or local filesystem access lead to inaccurate or wrong results\&. Works only for "dbd" CNID db volumes\&.
 251 .RE
 252 .PP
 253 tm
 254 .RS 4
 255 Enable Time Machine suport for this volume\&.
 256 .RE
 257 .PP
 258 invisibledots
 259 .RS 4
 260 Use with
 261 \fBusedots\fR: make dot files invisible\&.
 262 .RE
 263 .PP
 264 nonetids
 265 .RS 4
 266 Try to force ACL unawareness on the client\&.
 267 .RE
 268 .PP
 269 limitsize
 270 .RS 4
 271 Limit disk size reporting to 2GB\&. This can be used for older Macintoshes using newer Appleshare clients\&.
 272 .RE
 273 .PP
 274 preexec_close
 275 .RS 4
 276 a non\-zero return code from preexec close the volume being immediately, preventing clients to mount/see the volume in question\&.
 277 .RE
 278 .PP
 279 ro
 280 .RS 4
 281 Specifies the share as being read only for all users\&. The \&.AppleDB directory has to be writeable, you can use the
 282 \fB\-dbpath\fR
 283 option to relocate it\&. Overwrites
 284 \fBea:auto\fR
 285 with
 286 \fBea:none\fR
 287 .RE
 288 .PP
 289 root_preexec_close
 290 .RS 4
 291 a non\-zero return code from root_preexec closes the volume immediately, preventing clients to mount/see the volume in question\&.
 292 .RE
 293 .PP
 294 upriv
 295 .RS 4
 296 use AFP3 unix privileges\&. This should be set for OS X clients\&. Starting with Netatalk 2\&.1 it\*(Aqs part of the default config :DEFAULT: line\&. See also:
 297 \fBperm|fperm|dperm\fR\&.
 298 .RE
 299 .PP
 300 usedots
 301 .RS 4
 302 Don\*(Aqt 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\&. See also
 303 \fBinvisibledots\fR\&.
 304 .RE
 305 .PP
 306 followsymlinks
 307 .RS 4
 308 Follow symlinks on the server\&.
 309 .RE
 310 .RE
 311 .PP
 312 password:\fI[password]\fR
 313 .RS 4
 314 This option allows you to set a volume password, which can be a maximum of 8 characters long (using ASCII strongly recommended at the time of this writing)\&.
 315 .RE
 316 .PP
 317 perm|fperm|dperm:\fI[mode]\fR
 318 .RS 4
 319 Add(or) with the client requested permissions:
 320 \fBperm\fR
 321 affects files and directories,
 322 \fBfperm\fR
 323 is for files only,
 324 \fBdperm\fR
 325 is for directories only\&. Use with
 326 \fBoptions:upriv\fR\&.
 327 .PP
 328 \fBExample.\ \&Volume for a collaborative workgroup\fR
 329 .sp
 330 .if n \{\
 331 .RS 4
 332 .\}
 333 .nf
 334 /path/to/volume "Workgroup" options:upriv dperm:0770 fperm:0660
 335 .fi
 336 .if n \{\
 337 .RE
 338 .\}
 339 .RE
 340 .PP
 341 umask:\fI[mode]\fR
 342 .RS 4
 343 set perm mask\&. Use with
 344 \fBoptions:upriv\fR\&.
 345 .RE
 346 .PP
 347 preexec:\fI[command]\fR
 348 .RS 4
 349 command to be run when the volume is mounted, ignored for user defined volumes
 350 .RE
 351 .PP
 352 postexec:\fI[command]\fR
 353 .RS 4
 354 command to be run when the volume is closed, ignored for user defined volumes
 355 .RE
 356 .PP
 357 root_preexec:\fI[command]\fR
 358 .RS 4
 359 command to be run as root when the volume is mounted, ignored for user defined volumes
 360 .RE
 361 .PP
 362 root_postexec:\fI[command]\fR
 363 .RS 4
 364 command to be run as root when the volume is closed, ignored for user defined volumes
 365 .RE
 366 .PP
 367 rolist:[\fBusers/groups\fR]
 368 .RS 4
 369 Allows certain users and groups to have read\-only access to a share\&. This follows the allow option format\&.
 370 .RE
 371 .PP
 372 rwlist:\fI[users/groups]\fR
 373 .RS 4
 374 Allows certain users and groups to have read/write access to a share\&. This follows the allow option format\&.
 375 .RE
 376 .PP
 377 veto:\fI[vetoed names]\fR
 378 .RS 4
 379 hide files and directories,where the path matches one of the \*(Aq/\*(Aq delimited vetoed names\&. The veto string must always be terminated with a \*(Aq/\*(Aq, eg\&. "veto1/", "veto1/veto2/"\&.
 380 .RE
 381 .PP
 382 volcharset:\fI[charset]\fR
 383 .RS 4
 384 specifies the volume codepage, e\&.g\&. "UTF8", "UTF8\-MAC", "ISO\-8859\-15"\&. Defaults to "UTF8"\&.
 385 .RE
 386 .SH "VARIABLE SUBSTITUTIONS"
 387 .PP
 388 You can use variables in both volume path and volume name\&.
 389 .sp
 390 .RS 4
 391 .ie n \{\
 392 \h'-04' 1.\h'+01'\c
 393 .\}
 394 .el \{\
 395 .sp -1
 396 .IP "  1." 4.2
 397 .\}
 398 if you specify an unknown variable, it will not get converted\&.
 399 .RE
 400 .sp
 401 .RS 4
 402 .ie n \{\
 403 \h'-04' 2.\h'+01'\c
 404 .\}
 405 .el \{\
 406 .sp -1
 407 .IP "  2." 4.2
 408 .\}
 409 if you specify a known variable, but that variable doesn\*(Aqt have a value, it will get ignored\&.
 410 .RE
 411 .PP
 412 The variables which can be used for substitutions are:
 413 .PP
 414 $b
 415 .RS 4
 416 basename
 417 .RE
 418 .PP
 419 $c
 420 .RS 4
 421 client\*(Aqs ip or appletalk address
 422 .RE
 423 .PP
 424 $d
 425 .RS 4
 426 volume pathname on server
 427 .RE
 428 .PP
 429 $f
 430 .RS 4
 431 full name (contents of the gecos field in the passwd file)
 432 .RE
 433 .PP
 434 $g
 435 .RS 4
 436 group name
 437 .RE
 438 .PP
 439 $h
 440 .RS 4
 441 hostname
 442 .RE
 443 .PP
 444 $i
 445 .RS 4
 446 client\*(Aqs ip, without port
 447 .RE
 448 .PP
 449 $s
 450 .RS 4
 451 server name (this can be the hostname)
 452 .RE
 453 .PP
 454 $u
 455 .RS 4
 456 user name (if guest, it is the user that guest is running as)
 457 .RE
 458 .PP
 459 $v
 460 .RS 4
 461 volume name (either ADEID_NAME or basename of path)
 462 .RE
 463 .PP
 464 $z
 465 .RS 4
 466 appletalk zone (may not exist)
 467 .RE
 468 .PP
 469 $$
 470 .RS 4
 471 prints dollar sign ($)
 472 .RE
 473 .PP
 474 \fBExample.\ \&Using variable substitution when defining volumes\fR
 475 .PP
 476 .if n \{\
 477 .RS 4
 478 .\}
 479 .nf
 480 /home/groups/$g "Groupdir for $g"
 481 ~ "$f is the best one"
 482 .fi
 483 .if n \{\
 484 .RE
 485 .\}
 486 .sp
 487 We define "groupdirs" for each primary group and use a personalized server name for homedir shares\&.
 488 .SH "CNID BACKENDS"
 489 .PP
 490 The AFP protocol mostly refers to files and directories by ID and not by name\&. Netatalk needs a way to store these ID\*(Aqs in a persistent way, to achieve this several different CNID backends are available\&. The CNID Databases are by default located in the
 491 \&.AppleDB
 492 folder in the volume root\&.
 493 .PP
 494 cdb
 495 .RS 4
 496 "Concurrent database", backend is based on Sleepycat\*(Aqs Berkely DB\&. With this backend several
 497 \fBafpd\fR
 498 deamons access the CNID database directly\&. Berkeley DB locking is used to synchronize access, if more than one
 499 \fBafpd\fR
 500 process is active for a volume\&. The drawback is, that the crash of a single
 501 \fBafpd\fR
 502 process might corrupt the database\&.
 503 .RE
 504 .PP
 505 dbd
 506 .RS 4
 507 Access to the CNID database is restricted to the
 508 \fBcnid_metad\fR
 509 daemon process\&.
 510 \fBafpd\fR
 511 processes communicate with the daemon for database reads and updates\&. If built with Berkeley DB transactions the probability for database corruption is practically zero, but performance can be slower than with
 512 \fBcdb\fR
 513 .RE
 514 .PP
 515 last
 516 .RS 4
 517 This backend is an exception, in terms of ID persistency\&. ID\*(Aqs are only valid for the current session\&. This is basically what
 518 \fBafpd\fR
 519 did in the 1\&.5 (and 1\&.6) versions\&. This backend is still available, as it is useful for e\&.g\&. sharing cdroms\&.
 520 .sp
 521 \fBWarning\fR: It is
 522 \fINOT\fR
 523 recommended to use this backend for volumes anymore, as
 524 \fBafpd\fR
 525 now relies heavily on a persistent ID database\&. Aliases will likely not work and filename mangling is not supported\&.
 526 .RE
 527 .PP
 528 Even though
 529 \fB\&./configure \-\-help\fR
 530 might show that there are other CNID backends available, be warned those are likely broken or mainly used for testing\&. Don\*(Aqt use them unless you know what you\*(Aqre doing, they may be removed without further notice from future versions\&.
 531 .SH "CHARSET OPTIONS"
 532 .PP
 533 With OS X Apple introduced the AFP3 protocol\&. One of the most important changes was that AFP3 uses unicode names encoded as UTF\-8 decomposed\&. Previous AFP/OS versions used codepages, like MacRoman, MacCentralEurope, etc\&.
 534 .PP
 535 \fBafpd\fR
 536 needs a way to preserve extended macintosh characters, or characters illegal in unix filenames, when saving files on a unix filesystem\&. Earlier versions used the the so called CAP encoding\&. An extended character (>0x7F) would be converted to a :xx sequence, e\&.g\&. the Apple Logo (MacRoman: 0XF0) was saved as
 537 :f0\&. Some special characters will be converted as to :xx notation as well\&. \*(Aq/\*(Aq will be encoded to
 538 :2f, if
 539 \fBusedots\fR
 540 is not specified, a leading dot \*(Aq\&.\*(Aq will be encoded as
 541 :2e\&.
 542 .PP
 543 This version now uses UTF\-8 as the default encoding for names\&. Special characters, like \*(Aq/\*(Aq and a leading \*(Aq\&.\*(Aq will still be CAP style encoded \&.
 544 .PP
 545 The
 546 \fB\-volcharset\fR
 547 option will allow you to select another volume encoding\&. E\&.g\&. for western users another useful setting could be \-volcharset ISO\-8859\-15\&.
 548 \fBapfd\fR
 549 will accept any
 550 \fBiconv\fR(1)
 551 provided charset\&. If a character cannot be converted from the mac codepage to the selected volcharset, afpd will save it as a CAP encoded character\&. For AFP3 clients,
 552 \fBafpd\fR
 553 will convert the UTF\-8
 554 character to
 555 \fB\-maccharset\fR
 556 first\&. If this conversion fails, you\*(Aqll receive a \-50 error on the mac\&.
 557 .PP
 558 \fINote\fR: Whenever you can, please stick with the default UTF\-8 volume format\&.
 559 .SH "COMPATIBILITY WITH EARLIER VERSIONS"
 560 .PP
 561 To use a volume created with an earlier
 562 \fBafpd\fR
 563 version, you\*(Aqll have to specify the following options:
 564 .PP
 565 \fBExample.\ \&use a 1.x style volume\fR
 566 .sp
 567 .if n \{\
 568 .RS 4
 569 .\}
 570 .nf
 571 /path/to/volume "Volname" adouble:v1 volcharset:ASCII
 572 .fi
 573 .if n \{\
 574 .RE
 575 .\}
 576 .PP
 577 In case you used an NLS you could try using a compatible iconv charset for
 578 \fB\-volcharset\fR\&.
 579 .PP
 580 \fBExample.\ \&use a 1.x style volume, created with maccode.iso8859-1\fR
 581 .sp
 582 .if n \{\
 583 .RS 4
 584 .\}
 585 .nf
 586 /path/to/volume "Volname" adouble:v1 volcharset:ISO\-8859\-1
 587 .fi
 588 .if n \{\
 589 .RE
 590 .\}
 591 .PP
 592 You should consider converting old style volumes to the new UTF\-8/AD2 format\&. The safest way to do this, is to create a new volume with the default options and copy the files between this volumes with a mac\&.
 593 .PP
 594 \fINote\fR: Using above example options will allow you to downgrade to 1\&.x netatalk again\&.
 595 .PP
 596 \fINote\fR: Some 1\&.x NLS files used non standard mappings, e\&.g\&.
 597 maccode\&.iso8859\-1\&.adapted\&. Three 1\&.x CAP double\-byte maccharsets are incompatible to netatalk 2\&.x; "MAC_CHINESE_TRAD", "MAC_JAPANESE" and "MAC_KOREAN"\&. These are not supported anymore\&. You\*(Aqll have to copy the contents of those volumes files to a Mac and then back to the netatalk server, preferably to an UTF\-8 volume\&.
 598 .SH "ADVANCED OPTIONS"
 599 .PP
 600 The following options should only be used after serious consideration\&. Be sure you fully understood the, sometimes complex, consequences, before using them\&.
 601 .PP
 602 casefold:\fB[option]\fR
 603 .RS 4
 604 The casefold option handles, if the case of filenames should be changed\&. The available options are:
 605 .sp
 606 \fBtolower\fR
 607 \- Lowercases names in both directions\&.
 608 .sp
 609 \fBtoupper\fR
 610 \- Uppercases names in both directions\&.
 611 .sp
 612 \fBxlatelower\fR
 613 \- Client sees lowercase, server sees uppercase\&.
 614 .sp
 615 \fBxlateupper\fR
 616 \- Client sees uppercase, server sees lowercase\&.
 617 .RE
 618 .PP
 619 options:[\fBoption\fR]
 620 .RS 4
 621 This allows multiple options to be specified in a comma delimited format\&. The available options are:
 622 .PP
 623 caseinsensitive
 624 .RS 4
 625 The underlying filesystem is case insensitive (only tested with JFS in OS2 mode)\&.
 626 .RE
 627 .PP
 628 crlf
 629 .RS 4
 630 Enables crlf translation for TEXT files, automatically converting macintosh line breaks into Unix ones\&. Use of this option might be dangerous since some older programs store binary data files as type "TEXT" when saving and switch the filetype in a second step\&.
 631 \fBAfpd\fR
 632 will potentially destroy such files when "erroneously" changing bytes in order to do line break translation\&.
 633 .RE
 634 .PP
 635 dropbox
 636 .RS 4
 637 Allows a volume to be declared as being a "dropbox\&." Note that netatalk must be compiled with dropkludge support for this to function\&.
 638 \fIWarning\fR: This option is deprecated and might not work as expected\&.
 639 .RE
 640 .PP
 641 dropkludge
 642 .RS 4
 643 same as "dropbox"\&.
 644 .RE
 645 .PP
 646 mswindows
 647 .RS 4
 648 Forces filename restrictions imposed by MS WinXX\&.
 649 \fIWarning\fR: This is
 650 \fINOT\fR
 651 recommened for volumes mainly used by Macs\&. Please make sure you fully understand this option before using it\&.
 652 .if n \{\
 653 .sp
 654 .\}
 655 .RS 4
 656 .it 1 an-trap
 657 .nr an-no-space-flag 1
 658 .nr an-break-flag 1
 659 .br
 660 .ps +1
 661 \fBWarning\fR
 662 .ps -1
 663 .br
 664 This option breaks direct saving to netatalk volumes from some applications, i\&.e\&. OfficeX\&.
 665 .sp .5v
 666 .RE
 667 .RE
 668 .PP
 669 noadouble
 670 .RS 4
 671 Forces
 672 \fBafpd\fR
 673 to not create \&.AppleDouble directories unless macintosh metadata needs to be written\&. This option is only useful if you want to share files mostly used NOT by macs, causing
 674 \fBafpd\fR
 675 to not automatically create \&.AppleDouble subdirs containing AD header files in every directory it enters (which will it do by default)\&.
 676 .sp
 677 In case, you save or change files from mac clients, AD metadata files have to be written even in case you set this option\&. So you can\*(Aqt avoid the creation of \&.AppleDouble directories and its contents when you give macs write access to a share and they make use of it\&.
 678 .sp
 679 Try to avoid
 680 \fBnoadouble\fR
 681 whenever possible\&.
 682 .RE
 683 .PP
 684 nocnidcache
 685 .RS 4
 686 If set
 687 \fBafpd\fR
 688 doesn\*(Aqt store the ID information in AppleDouble V2 header files\&. As these IDs are used for caching and as a database backup, this option normally shouldn\*(Aqt be set\&.
 689 .RE
 690 .PP
 691 nodev
 692 .RS 4
 693 always use 0 for device number, helps when the device number is not constant across a reboot, cluster, \&.\&.\&.
 694 .RE
 695 .PP
 696 nofileid
 697 .RS 4
 698 don\*(Aqt advertise createfileid, resolveid, deleteid calls\&.
 699 .RE
 700 .PP
 701 nohex
 702 .RS 4
 703 Disables :hex translations for anything except dot files\&. This option makes the
 704 \*(Aq/\*(Aq character illegal\&.
 705 .RE
 706 .PP
 707 nostat
 708 .RS 4
 709 don\*(Aqt stat volume path when enumerating volumes list, useful for automounting or volumes created by a preexec script\&.
 710 .RE
 711 .PP
 712 prodos
 713 .RS 4
 714 Provides compatibility with Apple II clients\&. (legacy)
 715 .RE
 716 .RE
 717 .SH "FILE NAME EXTENSION MAPPINGS"
 718 .PP
 719 \fBExample.\ \&Extension is jpg. Type is "JPEG". Creator is "ogle".\fR
 720 .sp
 721 .if n \{\
 722 .RS 4
 723 .\}
 724 .nf
 725 \&.jpg "JPEG" "ogle"
 726 .fi
 727 .if n \{\
 728 .RE
 729 .\}
 730 .PP
 731 \fBExample.\ \&Extension is lzh. Type is "LHA ". Creator is not defined.\fR
 732 .sp
 733 .if n \{\
 734 .RS 4
 735 .\}
 736 .nf
 737 \&.lzh "LHA "
 738 .fi
 739 .if n \{\
 740 .RE
 741 .\}
 742 .SH "SEE ALSO"
 743 .PP
 744 \fBafpd.conf\fR(5),
 745 \fBafpd\fR(8),
 746 \fBcnid_metad\fR(8)