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