1<?xml version="1.0" encoding="UTF-8"?> 2<chapter id="upgrade"> 3 <chapterinfo> 4 <date>7.29.2013</date> 5 6 <author> 7 <firstname>Frank</firstname> 8 9 <surname>Lahm</surname> 10 </author> 11 12 <pubdate>29 Jul, 2013</pubdate> 13 </chapterinfo> 14 15 <title>Upgrading from Netatalk 2</title> 16 17 <sect1> 18 <title>Overview</title> 19 20 <para>There are two major changes in Netatalk:<orderedlist> 21 <listitem> 22 <para>New configuration file <filename><link 23 linkend="afp.conf.5">afp.conf</link></filename>, obsoleting all 24 previous configuration files</para> 25 </listitem> 26 27 <listitem> 28 <para>New AppleDouble backend "<option>appledouble = ea</option>" 29 which stores Mac metadata and resource forks in extended attributes 30 of the filesystem</para> 31 </listitem> 32 </orderedlist></para> 33 34 <sect2> 35 <title>New configuration</title> 36 37 <para><itemizedlist> 38 <listitem> 39 <para>ini style syntax (like Samba���s smb.conf)</para> 40 </listitem> 41 42 <listitem> 43 <para>one to rule them all: configure AFP settings and volumes in 44 one file</para> 45 </listitem> 46 47 <listitem> 48 <para>obsoletes <filename>afpd.conf</filename>, 49 <filename>netatalk.conf</filename>, 50 <filename>AppleVolumes.default</filename> and 51 <filename>afp_ldap.conf</filename></para> 52 </listitem> 53 </itemizedlist><warning> 54 <para>most option names have changed, read the full manpage <link 55 linkend="afp.conf.5">afp.conf</link> for details</para> 56 </warning></para> 57 </sect2> 58 59 <sect2> 60 <title>New AppleDouble backend</title> 61 62 <para>New AppleDouble backend "<option>appledouble = ea</option>" which 63 stores Mac metadata and resource forks in extended attributes of the 64 filesystem.<itemizedlist> 65 <listitem> 66 <para>default backend (!)</para> 67 </listitem> 68 69 <listitem> 70 <para>requires a filesystem with Extended Attributes, fallback is 71 "<option>appledouble = v2</option>"</para> 72 </listitem> 73 74 <listitem> 75 <para>converts filesystems from "<option>appledouble = v2</option>" 76 to "<option>appledouble = ea</option>" on the fly when accessed 77 (can be disabled)</para> 78 </listitem> 79 80 <listitem> 81 <para><command><link linkend="dbd.1">dbd</link></command> can be 82 used to do conversion in one shot</para> 83 </listitem> 84 </itemizedlist></para> 85 86 <para>Implementation details:<itemizedlist> 87 <listitem> 88 <para>stores Mac Metadata (eg FinderInfo, AFP Flags, Comment, 89 CNID) in an Extended Attributed named 90 ���<filename>org.netatalk.Metadata</filename>���</para> 91 </listitem> 92 93 <listitem> 94 <para>stores Mac ResourceFork either in<itemizedlist> 95 <listitem> 96 <para>an Extended Attribute named 97 ���<filename>org.netatalk.ResourceFork</filename>��� 98 on Solaris w. ZFS, or in</para> 99 </listitem> 100 101 <listitem> 102 <para>an extra AppleDouble file named ���<filename>._file</filename>��� for a file 103 named ���<filename>file</filename>���</para> 104 </listitem> 105 </itemizedlist></para> 106 </listitem> 107 108 <listitem> 109 <para>the format of the ._ file is exactly as the Mac���s CIFS 110 client expects it when accessing the same filesystem via a CIFS 111 server (Samba), thus you can have parallel access from Macs to the 112 same dataset via AFP and CIFS without the risk of loosing data 113 (resources or metadata). Accessing the same dataset with CIFS 114 from Windows clients will still break the coupling of 115 ���<filename>file</filename>��� and ���<filename>._file</filename>��� 116 on non ZFS filesystems (see above), so for this we still 117 need an enhanced Samba VFS module (in the works).</para> 118 </listitem> 119 </itemizedlist></para> 120 121 <para>As these days the only applications making use of Resource Forks 122 are Adobe Photoshop (image preview) and Postscript Type 1 fonts, even on 123 eg Linux you���ll get rid of 99% of any extra Netatalk AppleDouble files 124 (and folders).</para> 125 </sect2> 126 127 <sect2> 128 <title>Other major changes</title> 129 130 <para><itemizedlist> 131 <listitem> 132 <para>New service controller daemon <link 133 linkend="netatalk.8">netatalk</link> which is responsible for 134 starting and restarting the AFP and CNID daemons. All bundled 135 start scripts have been updated, make sure to update yours!</para> 136 </listitem> 137 138 <listitem> 139 <para>The CNID databases are now stored under 140 <filename>/var/netatalk/CNID/</filename> 141 by default. You can use configure --localstatedir=PATH at 142 compile time to change the location.</para> 143 </listitem> 144 145 <listitem> 146 <para>Netatalk 2.x volume options ���usedots��� and ���upriv��� now 147 enabled by default</para> 148 </listitem> 149 150 <listitem> 151 <para>Removed SLP and AFP proxy support</para> 152 </listitem> 153 154 <listitem> 155 <para>Removed type/creator extension mapping 156 support</para> 157 </listitem> 158 </itemizedlist></para> 159 </sect2> 160 </sect1> 161 162 <sect1> 163 <title>Upgrading</title> 164 165 <para><orderedlist> 166 <listitem> 167 <para>Stop Netatalk 2.x</para> 168 </listitem> 169 170 <listitem> 171 <para>Install Netatalk 3</para> 172 </listitem> 173 174 <listitem> 175 <para>Manually recreate configuration in 176 <option>afp.conf</option> and <option>extmap.conf</option></para> 177 </listitem> 178 179 <listitem> 180 <para>Update your Netatalk start script (SMF, systemd, whatever...) 181 to only start <link linkend="netatalk.8">netatalk</link></para> 182 </listitem> 183 184 <listitem> 185 <para>Move <filename>afp_voluuid.conf</filename> and 186 <filename>afp_signature.conf</filename> to the localstate directory (default 187 <filename>/var/netatalk/</filename>), you can use <command>afpd -v</command> 188 in order to find the correct path</para> 189 </listitem> 190 191 <listitem> 192 <para>Start Netatalk 3</para> 193 </listitem> 194 </orderedlist></para> 195 </sect1> 196 197 <sect1> 198 <title>Table with old and new configuration file names</title> 199 <para><table frame="all"> 200 <title>old and new configuration file names</title> 201 <tgroup cols="3"> 202 <colspec colname="c1" colnum="1" colwidth="1.0*"/> 203 <colspec colname="c2" colnum="2" colwidth="1.0*"/> 204 <colspec colname="c3" colnum="3" colwidth="1.0*"/> 205 <thead> 206 <row> 207 <entry>Old File Name</entry> 208 <entry>New File Name</entry> 209 <entry>Description</entry> 210 </row> 211 </thead> 212 <tbody> 213 <row> 214 <entry>-</entry> 215 <entry><filename>etc/afp.conf</filename></entry> 216 <entry>new ini-style format</entry> 217 </row> 218 <row> 219 <entry>-</entry> 220 <entry><filename>etc/extmap.conf</filename></entry> 221 <entry>starting with netatalk 3.0.2</entry> 222 </row> 223 <row> 224 <entry><filename>etc/netatalk/afp_signature.conf</filename></entry> 225 <entry><filename>var/netatalk/afp_signature.conf</filename></entry> 226 <entry>moved to $localstatedir</entry> 227 </row> 228 <row> 229 <entry><filename>etc/netatalk/afp_voluuid.conf</filename></entry> 230 <entry><filename>var/netatalk/afp_voluuid.conf</filename></entry> 231 <entry>moved to $localstatedir</entry> 232 </row> 233 <row> 234 <entry><filename>etc/netatalk/netatalk.conf</filename> 235 (<filename>/etc/default/netatalk</filename>)</entry> 236 <entry>-</entry> 237 <entry>obsolete</entry> 238 </row> 239 <row> 240 <entry><filename>etc/netatalk/afpd.conf</filename></entry> 241 <entry>-</entry> 242 <entry>obsolete</entry> 243 </row> 244 <row> 245 <entry><filename>etc/netatalk/afp_ldap.conf</filename></entry> 246 <entry>-</entry> 247 <entry>obsolete</entry> 248 </row> 249 <row> 250 <entry><filename>etc/netatalk/AppleVolumes.default</filename></entry> 251 <entry>-</entry> 252 <entry>obsolete</entry> 253 </row> 254 <row> 255 <entry><filename>etc/netatalk/AppleVolumes.system</filename></entry> 256 <entry>-</entry> 257 <entry>obsolete</entry> 258 </row> 259 <row> 260 <entry><filename>~/.AppleVolumes</filename></entry> 261 <entry>-</entry> 262 <entry>obsolete</entry> 263 </row> 264 </tbody> 265 </tgroup> 266 </table></para> 267 </sect1> 268 269 <sect1> 270 <title>Table with old and new option names</title> 271 <para><table frame="all"> 272 <title>from netatalk.conf (/etc/default/netatalk) to afp.conf</title> 273 <tgroup cols="6"> 274 <colspec colname="c1" colnum="1" colwidth="1.0*"/> 275 <colspec colname="c2" colnum="2" colwidth="1.0*"/> 276 <colspec colname="c3" colnum="3" colwidth="1.0*"/> 277 <colspec colname="c4" colnum="4" colwidth="1.0*"/> 278 <colspec colname="c5" colnum="5" colwidth="1.0*"/> 279 <colspec colname="c6" colnum="6" colwidth="1.0*"/> 280 <thead> 281 <row> 282 <entry>Old netatalk.conf</entry> 283 <entry>New afp.conf</entry> 284 <entry>Old Default Value</entry> 285 <entry>New Default Value</entry> 286 <entry>Section</entry> 287 <entry>Description</entry> 288 </row> 289 </thead> 290 <tbody> 291 <row> 292 <entry>ATALK_NAME</entry> 293 <entry>hostname</entry> 294 <entry>-</entry> 295 <entry>-</entry> 296 <entry>(G)</entry> 297 <entry>use gethostname() by default</entry> 298 </row> 299 <row> 300 <entry>ATALK_UNIX_CHARSET</entry> 301 <entry>unix charset</entry> 302 <entry><emphasis role="bold">LOCALE</emphasis></entry> 303 <entry><emphasis role="bold">UTF8</emphasis></entry> 304 <entry>(G)</entry> 305 <entry>-</entry> 306 </row> 307 <row> 308 <entry>ATALK_MAC_CHARSET</entry> 309 <entry>mac charset</entry> 310 <entry>MAC_ROMAN</entry> 311 <entry>MAC_ROMAN</entry> 312 <entry>(G)/(V)</entry> 313 <entry>-</entry> 314 </row> 315 <row> 316 <entry>CNID_METAD_RUN</entry> 317 <entry>-</entry> 318 <entry>yes</entry> 319 <entry>-</entry> 320 <entry>-</entry> 321 <entry>controlled by netatalk(8)</entry> 322 </row> 323 <row> 324 <entry>AFPD_RUN</entry> 325 <entry>-</entry> 326 <entry>yes</entry> 327 <entry>-</entry> 328 <entry>-</entry> 329 <entry>controlled by netatalk(8)</entry> 330 </row> 331 <row> 332 <entry>AFPD_MAX_CLIENTS</entry> 333 <entry>max connections</entry> 334 <entry><emphasis role="bold">20</emphasis></entry> 335 <entry><emphasis role="bold">200</emphasis></entry> 336 <entry>(G)</entry> 337 <entry>-</entry> 338 </row> 339 <row> 340 <entry>AFPD_UAMLIST</entry> 341 <entry>uam list</entry> 342 <entry>-U uams_dhx.so,uams_dhx2.so</entry> 343 <entry>uams_dhx.so uams_dhx2.so</entry> 344 <entry>(G)</entry> 345 <entry>-</entry> 346 </row> 347 <row> 348 <entry>AFPD_GUEST</entry> 349 <entry>guest account</entry> 350 <entry>nobody</entry> 351 <entry>nobody</entry> 352 <entry>(G)</entry> 353 <entry>-</entry> 354 </row> 355 <row> 356 <entry>CNID_CONFIG</entry> 357 <entry>log level</entry> 358 <entry>-l log_note</entry> 359 <entry>cnid:note</entry> 360 <entry>(G)</entry> 361 <entry>-</entry> 362 </row> 363 <row> 364 <entry>CNID_CONFIG</entry> 365 <entry>log file</entry> 366 <entry>-</entry> 367 <entry>-</entry> 368 <entry>(G)</entry> 369 <entry>-</entry> 370 </row> 371 <row> 372 <entry>ATALKD_RUN</entry> 373 <entry>-</entry> 374 <entry>no</entry> 375 <entry>-</entry> 376 <entry>-</entry> 377 <entry>AppleTalk is obsoleted</entry> 378 </row> 379 <row> 380 <entry>PAPD_RUN</entry> 381 <entry>-</entry> 382 <entry>no</entry> 383 <entry>-</entry> 384 <entry>-</entry> 385 <entry>AppleTalk is obsoleted</entry> 386 </row> 387 <row> 388 <entry>TIMELORD_RUN</entry> 389 <entry>-</entry> 390 <entry>no</entry> 391 <entry>-</entry> 392 <entry>-</entry> 393 <entry>AppleTalk is obsoleted</entry> 394 </row> 395 <row> 396 <entry>A2BOOT_RUN</entry> 397 <entry>-</entry> 398 <entry>no</entry> 399 <entry>-</entry> 400 <entry>-</entry> 401 <entry>AppleTalk is obsoleted</entry> 402 </row> 403 <row> 404 <entry>ATALK_BGROUND</entry> 405 <entry>-</entry> 406 <entry>no</entry> 407 <entry>-</entry> 408 <entry>-</entry> 409 <entry>AppleTalk is obsoleted</entry> 410 </row> 411 <row> 412 <entry>ATALK_ZONE</entry> 413 <entry>-</entry> 414 <entry>no</entry> 415 <entry>-</entry> 416 <entry>-</entry> 417 <entry>AppleTalk is obsoleted</entry> 418 </row> 419 </tbody> 420 </tgroup> 421 </table><table frame="all"> 422 <title>from afpd.conf to afp.conf</title> 423 <tgroup cols="6"> 424 <colspec colname="c1" colnum="1" colwidth="1.0*"/> 425 <colspec colname="c2" colnum="2" colwidth="1.0*"/> 426 <colspec colname="c3" colnum="3" colwidth="1.0*"/> 427 <colspec colname="c4" colnum="4" colwidth="1.0*"/> 428 <colspec colname="c5" colnum="5" colwidth="1.0*"/> 429 <colspec colname="c6" colnum="6" colwidth="1.0*"/> 430 <thead> 431 <row> 432 <entry>Old afpd.conf</entry> 433 <entry>New afp.conf</entry> 434 <entry>Old Default Value</entry> 435 <entry>New Default Value</entry> 436 <entry>Section</entry> 437 <entry>Description</entry> 438 </row> 439 </thead> 440 <tbody> 441 <row> 442 <entry>1st field ("-" or "server name")</entry> 443 <entry>hostname</entry> 444 <entry>-</entry> 445 <entry>-</entry> 446 <entry>(G)</entry> 447 <entry>use gethostname() by default</entry> 448 </row> 449 <row> 450 <entry>-uamlist</entry> 451 <entry>uam list</entry> 452 <entry>-U uams_dhx.so,uams_dhx2.so</entry> 453 <entry>uams_dhx.so uams_dhx2.so</entry> 454 <entry>(G)</entry> 455 <entry>-</entry> 456 </row> 457 <row> 458 <entry>-nozeroconf</entry> 459 <entry>zeroconf</entry> 460 <entry>-</entry> 461 <entry>yes (if supported)</entry> 462 <entry>(G)</entry> 463 <entry>-</entry> 464 </row> 465 <row> 466 <entry>-advertise_ssh</entry> 467 <entry>advertise ssh</entry> 468 <entry>-</entry> 469 <entry>no</entry> 470 <entry>(G)</entry> 471 <entry>-</entry> 472 </row> 473 <row> 474 <entry>-[no]savepassword</entry> 475 <entry>save password</entry> 476 <entry>-savepassword</entry> 477 <entry>yes</entry> 478 <entry>(G)</entry> 479 <entry>-</entry> 480 </row> 481 <row> 482 <entry>-[no]setpassword</entry> 483 <entry>set password</entry> 484 <entry>-nosetpassword</entry> 485 <entry>no</entry> 486 <entry>(G)</entry> 487 <entry>-</entry> 488 </row> 489 <row> 490 <entry>-client_polling</entry> 491 <entry>client polling</entry> 492 <entry>-</entry> 493 <entry>no</entry> 494 <entry>(G)</entry> 495 <entry>-</entry> 496 </row> 497 <row> 498 <entry>-hostname</entry> 499 <entry>hostname</entry> 500 <entry>-</entry> 501 <entry>-</entry> 502 <entry>(G)</entry> 503 <entry>use gethostname() by default</entry> 504 </row> 505 <row> 506 <entry>-loginmesg</entry> 507 <entry>login message</entry> 508 <entry>-</entry> 509 <entry>-</entry> 510 <entry>(G)/(V)</entry> 511 <entry>-</entry> 512 </row> 513 <row> 514 <entry>-guestname</entry> 515 <entry>guest account</entry> 516 <entry>nobody</entry> 517 <entry>nobody</entry> 518 <entry>(G)</entry> 519 <entry>-</entry> 520 </row> 521 <row> 522 <entry>-passwdfile</entry> 523 <entry>passwd file</entry> 524 <entry>afppasswd</entry> 525 <entry>afppasswd</entry> 526 <entry>(G)</entry> 527 <entry>-</entry> 528 </row> 529 <row> 530 <entry>-passwdminlen</entry> 531 <entry>passwd minlen</entry> 532 <entry>-</entry> 533 <entry>-</entry> 534 <entry>(G)</entry> 535 <entry>-</entry> 536 </row> 537 <row> 538 <entry>-tickleval</entry> 539 <entry>tickleval</entry> 540 <entry>30</entry> 541 <entry>30</entry> 542 <entry>(G)</entry> 543 <entry>-</entry> 544 </row> 545 <row> 546 <entry>-timeout</entry> 547 <entry>timeout</entry> 548 <entry>4</entry> 549 <entry>4</entry> 550 <entry>(G)</entry> 551 <entry>-</entry> 552 </row> 553 <row> 554 <entry>-sleep</entry> 555 <entry>sleep time</entry> 556 <entry>10</entry> 557 <entry>10</entry> 558 <entry>(G)</entry> 559 <entry>-</entry> 560 </row> 561 <row> 562 <entry>-dsireadbuf</entry> 563 <entry>dsireadbuf</entry> 564 <entry>12</entry> 565 <entry>12</entry> 566 <entry>(G)</entry> 567 <entry>-</entry> 568 </row> 569 <row> 570 <entry>-server_quantum</entry> 571 <entry>server quantum</entry> 572 <entry>303840</entry> 573 <entry>303840</entry> 574 <entry>(G)</entry> 575 <entry>-</entry> 576 </row> 577 <row> 578 <entry>-volnamelen</entry> 579 <entry>volnamelen</entry> 580 <entry>80</entry> 581 <entry>80</entry> 582 <entry>(G)</entry> 583 <entry>-</entry> 584 </row> 585 <row> 586 <entry>-setuplog</entry> 587 <entry>log level</entry> 588 <entry>default log_note</entry> 589 <entry>default:note</entry> 590 <entry>(G)</entry> 591 <entry>-</entry> 592 </row> 593 <row> 594 <entry>-setuplog</entry> 595 <entry>log file</entry> 596 <entry>-</entry> 597 <entry>-</entry> 598 <entry>(G)</entry> 599 <entry>-</entry> 600 </row> 601 <row> 602 <entry>-admingroup</entry> 603 <entry>admingroup</entry> 604 <entry>-</entry> 605 <entry>-</entry> 606 <entry>(G)</entry> 607 <entry>-</entry> 608 </row> 609 <row> 610 <entry>-k5service</entry> 611 <entry>k5 service</entry> 612 <entry>-</entry> 613 <entry>-</entry> 614 <entry>(G)</entry> 615 <entry>-</entry> 616 </row> 617 <row> 618 <entry>-k5realm</entry> 619 <entry>k5 realm</entry> 620 <entry>-</entry> 621 <entry>-</entry> 622 <entry>(G)</entry> 623 <entry>-</entry> 624 </row> 625 <row> 626 <entry>-k5keytab</entry> 627 <entry>k5 keytab</entry> 628 <entry>-</entry> 629 <entry>-</entry> 630 <entry>(G)</entry> 631 <entry>-</entry> 632 </row> 633 <row> 634 <entry>-uampath</entry> 635 <entry>uam path</entry> 636 <entry><emphasis role="bold">etc/netatalk/uams/</emphasis></entry> 637 <entry><emphasis role="bold">lib/netatalk/</emphasis></entry> 638 <entry>(G)</entry> 639 <entry>moved to $libdir</entry> 640 </row> 641 <row> 642 <entry>-ipaddr</entry> 643 <entry>afp listen</entry> 644 <entry>-</entry> 645 <entry>-</entry> 646 <entry>(G)</entry> 647 <entry>-</entry> 648 </row> 649 <row> 650 <entry>-cnidserver</entry> 651 <entry>cnid server</entry> 652 <entry>localhost:4700</entry> 653 <entry>localhost:4700</entry> 654 <entry>(G)/(V)</entry> 655 <entry>-</entry> 656 </row> 657 <row> 658 <entry>-port</entry> 659 <entry>port</entry> 660 <entry>548</entry> 661 <entry>548</entry> 662 <entry>(G)</entry> 663 <entry>-</entry> 664 </row> 665 <row> 666 <entry>-signature</entry> 667 <entry>signature</entry> 668 <entry>auto</entry> 669 <entry>-</entry> 670 <entry>(G)</entry> 671 <entry>-</entry> 672 </row> 673 <row> 674 <entry>-fqdn</entry> 675 <entry>fqdn</entry> 676 <entry>-</entry> 677 <entry>-</entry> 678 <entry>(G)</entry> 679 <entry>-</entry> 680 </row> 681 <row> 682 <entry>-unixcodepage</entry> 683 <entry>unix charset</entry> 684 <entry><emphasis role="bold">LOCALE</emphasis></entry> 685 <entry><emphasis role="bold">UTF8</emphasis></entry> 686 <entry>(G)</entry> 687 <entry>-</entry> 688 </row> 689 <row> 690 <entry>-maccodepage</entry> 691 <entry>mac charset</entry> 692 <entry>MAC_ROMAN</entry> 693 <entry>MAC_ROMAN</entry> 694 <entry>(G)/(V)</entry> 695 <entry>-</entry> 696 </row> 697 <row> 698 <entry>-closevol</entry> 699 <entry>close vol</entry> 700 <entry>-</entry> 701 <entry>no</entry> 702 <entry>(G)</entry> 703 <entry>-</entry> 704 </row> 705 <row> 706 <entry>-ntdomain</entry> 707 <entry>nt domain</entry> 708 <entry>-</entry> 709 <entry>-</entry> 710 <entry>(G)</entry> 711 <entry>-</entry> 712 </row> 713 <row> 714 <entry>-ntseparator</entry> 715 <entry>nt separator</entry> 716 <entry>-</entry> 717 <entry>-</entry> 718 <entry>(G)</entry> 719 <entry>-</entry> 720 </row> 721 <row> 722 <entry>-dircachesize</entry> 723 <entry>dircachesize</entry> 724 <entry>8192</entry> 725 <entry>8192</entry> 726 <entry>(G)</entry> 727 <entry>-</entry> 728 </row> 729 <row> 730 <entry>-tcpsndbuf</entry> 731 <entry>tcpsndbuf</entry> 732 <entry>-</entry> 733 <entry>-</entry> 734 <entry>(G)</entry> 735 <entry>OS default</entry> 736 </row> 737 <row> 738 <entry>-tcprcvbuf</entry> 739 <entry>tcprcvbuf</entry> 740 <entry>-</entry> 741 <entry>-</entry> 742 <entry>(G)</entry> 743 <entry>OS default</entry> 744 </row> 745 <row> 746 <entry>-fcelistener</entry> 747 <entry>fce listener</entry> 748 <entry>-</entry> 749 <entry>-</entry> 750 <entry>(G)</entry> 751 <entry>-</entry> 752 </row> 753 <row> 754 <entry>-fcecoalesce</entry> 755 <entry>fce coalesce</entry> 756 <entry>-</entry> 757 <entry>-</entry> 758 <entry>(G)</entry> 759 <entry>-</entry> 760 </row> 761 <row> 762 <entry>-fceevents</entry> 763 <entry>fce events</entry> 764 <entry>-</entry> 765 <entry>-</entry> 766 <entry>(G)</entry> 767 <entry>-</entry> 768 </row> 769 <row> 770 <entry>-fceholdfmod</entry> 771 <entry>fce holdfmod</entry> 772 <entry>60</entry> 773 <entry>60</entry> 774 <entry>(G)</entry> 775 <entry>-</entry> 776 </row> 777 <row> 778 <entry>-mimicmodel</entry> 779 <entry>mimic model</entry> 780 <entry>-</entry> 781 <entry>-</entry> 782 <entry>(G)</entry> 783 <entry>-</entry> 784 </row> 785 <row> 786 <entry>-adminauthuser</entry> 787 <entry>admin auth user</entry> 788 <entry>-</entry> 789 <entry>-</entry> 790 <entry>(G)</entry> 791 <entry>-</entry> 792 </row> 793 <row> 794 <entry>-noacl2maccess</entry> 795 <entry>map acls</entry> 796 <entry>-</entry> 797 <entry>rights</entry> 798 <entry>(G)</entry> 799 <entry>-</entry> 800 </row> 801 <row> 802 <entry>-[no]tcp</entry> 803 <entry>-</entry> 804 <entry>-tcp</entry> 805 <entry>-</entry> 806 <entry>-</entry> 807 <entry>always TCP only</entry> 808 </row> 809 <row> 810 <entry>-[no]ddp</entry> 811 <entry>-</entry> 812 <entry>-noddp</entry> 813 <entry>-</entry> 814 <entry>-</entry> 815 <entry>AppleTalk is obsoleted</entry> 816 </row> 817 <row> 818 <entry>-[no]transall</entry> 819 <entry>-</entry> 820 <entry>-tcp -noddp</entry> 821 <entry>-</entry> 822 <entry>-</entry> 823 <entry>always TCP only</entry> 824 </row> 825 <row> 826 <entry>-nodebug</entry> 827 <entry>-</entry> 828 <entry>-</entry> 829 <entry>-</entry> 830 <entry>-</entry> 831 <entry>obsolete</entry> 832 </row> 833 <row> 834 <entry>-[no]slp</entry> 835 <entry>-</entry> 836 <entry>-noslp</entry> 837 <entry>-</entry> 838 <entry>-</entry> 839 <entry>SLP support is obsoleted</entry> 840 </row> 841 <row> 842 <entry>-[no]uservolfirst</entry> 843 <entry>-</entry> 844 <entry>-nouservolfirst</entry> 845 <entry>-</entry> 846 <entry>-</entry> 847 <entry>uservol is obsoleted</entry> 848 </row> 849 <row> 850 <entry>-[no]uservol</entry> 851 <entry>-</entry> 852 <entry>-uservol</entry> 853 <entry>-</entry> 854 <entry>-</entry> 855 <entry>uservol is obsoleted</entry> 856 </row> 857 <row> 858 <entry>-proxy</entry> 859 <entry>-</entry> 860 <entry>-</entry> 861 <entry>-</entry> 862 <entry>-</entry> 863 <entry>AppleTalk is obsoleted</entry> 864 </row> 865 <row> 866 <entry>-defaultvol</entry> 867 <entry>-</entry> 868 <entry>AppleVolumes.default</entry> 869 <entry>-</entry> 870 <entry>-</entry> 871 <entry>afp.conf only</entry> 872 </row> 873 <row> 874 <entry>-systemvol</entry> 875 <entry>-</entry> 876 <entry>AppleVolumes.system</entry> 877 <entry>-</entry> 878 <entry>-</entry> 879 <entry>afp.conf only</entry> 880 </row> 881 <row> 882 <entry>-loginmaxfail</entry> 883 <entry>-</entry> 884 <entry>-</entry> 885 <entry>-</entry> 886 <entry>-</entry> 887 <entry>not supported from the biginning</entry> 888 </row> 889 <row> 890 <entry>-unsetuplog</entry> 891 <entry>-</entry> 892 <entry>-</entry> 893 <entry>-</entry> 894 <entry>-</entry> 895 <entry>obsolete</entry> 896 </row> 897 <row> 898 <entry>-authprintdir</entry> 899 <entry>-</entry> 900 <entry>-</entry> 901 <entry>-</entry> 902 <entry>-</entry> 903 <entry>AppleTalk is obsoleted</entry> 904 </row> 905 <row> 906 <entry>-ddpaddr</entry> 907 <entry>-</entry> 908 <entry>-</entry> 909 <entry>-</entry> 910 <entry>-</entry> 911 <entry>AppleTalk is obsoleted</entry> 912 </row> 913 <row> 914 <entry>-[no]icon</entry> 915 <entry>-</entry> 916 <entry>-noicon</entry> 917 <entry></entry> 918 <entry>-</entry> 919 <entry>obsolete</entry> 920 </row> 921 <row> 922 <entry>-keepsessions</entry> 923 <entry>-</entry> 924 <entry>-</entry> 925 <entry>-</entry> 926 <entry>-</entry> 927 <entry>obsolete. Use kill -HUP.</entry> 928 </row> 929 </tbody> 930 </tgroup> 931 </table><table frame="all"> 932 <title>from afp_ldap.conf to afp.conf</title> 933 <tgroup cols="6"> 934 <colspec colname="c1" colnum="1" colwidth="1.0*"/> 935 <colspec colname="c2" colnum="2" colwidth="1.0*"/> 936 <colspec colname="c3" colnum="3" colwidth="1.0*"/> 937 <colspec colname="c4" colnum="4" colwidth="1.0*"/> 938 <colspec colname="c5" colnum="5" colwidth="1.0*"/> 939 <colspec colname="c6" colnum="6" colwidth="1.0*"/> 940 <thead> 941 <row> 942 <entry>Old afp_ldap.conf</entry> 943 <entry>New afp.conf</entry> 944 <entry>Old Default Value</entry> 945 <entry>New Defalut Value</entry> 946 <entry>Section</entry> 947 <entry>Description</entry> 948 </row> 949 </thead> 950 <tbody> 951 <row> 952 <entry>ldap_server</entry> 953 <entry>ldap server</entry> 954 <entry>-</entry> 955 <entry>-</entry> 956 <entry>(G)</entry> 957 <entry>-</entry> 958 </row> 959 <row> 960 <entry>ldap_auth_method</entry> 961 <entry>ldap auth method</entry> 962 <entry>-</entry> 963 <entry>-</entry> 964 <entry>(G)</entry> 965 <entry>-</entry> 966 </row> 967 <row> 968 <entry>ldap_auth_dn</entry> 969 <entry>ldap auth dn</entry> 970 <entry>-</entry> 971 <entry>-</entry> 972 <entry>(G)</entry> 973 <entry>-</entry> 974 </row> 975 <row> 976 <entry>ldap_auth_pw</entry> 977 <entry>ldap auth pw</entry> 978 <entry>-</entry> 979 <entry>-</entry> 980 <entry>(G)</entry> 981 <entry>-</entry> 982 </row> 983 <row> 984 <entry>ldap_userbase</entry> 985 <entry>ldap userbase</entry> 986 <entry>-</entry> 987 <entry>-</entry> 988 <entry>(G)</entry> 989 <entry>-</entry> 990 </row> 991 <row> 992 <entry>ldap_userscope</entry> 993 <entry>ldap userscope</entry> 994 <entry>-</entry> 995 <entry>-</entry> 996 <entry>(G)</entry> 997 <entry>-</entry> 998 </row> 999 <row> 1000 <entry>ldap_groupbase</entry> 1001 <entry>ldap groupbase</entry> 1002 <entry>-</entry> 1003 <entry>-</entry> 1004 <entry>(G)</entry> 1005 <entry>-</entry> 1006 </row> 1007 <row> 1008 <entry>ldap_groupscope</entry> 1009 <entry>ldap groupscope</entry> 1010 <entry>-</entry> 1011 <entry>-</entry> 1012 <entry>(G)</entry> 1013 <entry>-</entry> 1014 </row> 1015 <row> 1016 <entry>ldap_uuid_attr</entry> 1017 <entry>ldap uuid attr</entry> 1018 <entry>-</entry> 1019 <entry>-</entry> 1020 <entry>(G)</entry> 1021 <entry>-</entry> 1022 </row> 1023 <row> 1024 <entry>ldap_uuid_string</entry> 1025 <entry>ldap uuid string</entry> 1026 <entry>-</entry> 1027 <entry>-</entry> 1028 <entry>(G)</entry> 1029 <entry>-</entry> 1030 </row> 1031 <row> 1032 <entry>ldap_name_attr</entry> 1033 <entry>ldap name attr</entry> 1034 <entry>-</entry> 1035 <entry>-</entry> 1036 <entry>(G)</entry> 1037 <entry>-</entry> 1038 </row> 1039 <row> 1040 <entry> ldap_group_attr</entry> 1041 <entry>ldap group attr</entry> 1042 <entry>-</entry> 1043 <entry>-</entry> 1044 <entry>(G)</entry> 1045 <entry>-</entry> 1046 </row> 1047 </tbody> 1048 </tgroup> 1049 </table><table frame="all"> 1050 <title>from AppleVolumes.* to afp.conf</title> 1051 <tgroup cols="6"> 1052 <colspec colname="c1" colnum="1" colwidth="1.0*"/> 1053 <colspec colname="c2" colnum="2" colwidth="1.0*"/> 1054 <colspec colname="c3" colnum="3" colwidth="1.0*"/> 1055 <colspec colname="c4" colnum="4" colwidth="1.0*"/> 1056 <colspec colname="c5" colnum="5" colwidth="1.0*"/> 1057 <colspec colname="c6" colnum="6" colwidth="1.0*"/> 1058 <thead> 1059 <row> 1060 <entry>Old AppleVolumes.*</entry> 1061 <entry>New afp.conf</entry> 1062 <entry>Old Default Value</entry> 1063 <entry>New Defalut Value</entry> 1064 <entry>Section</entry> 1065 <entry>Description</entry> 1066 </row> 1067 </thead> 1068 <tbody> 1069 <row> 1070 <entry>(leading-dot lines)</entry> 1071 <entry>-</entry> 1072 <entry>-</entry> 1073 <entry>-</entry> 1074 <entry>-</entry> 1075 <entry>move to extmap.conf</entry> 1076 </row> 1077 <row> 1078 <entry>:DEFAULT:</entry> 1079 <entry>-</entry> 1080 <entry>options:upriv,usedots</entry> 1081 <entry>-</entry> 1082 <entry>-</entry> 1083 <entry>use "vol preset ="</entry> 1084 </row> 1085 <row> 1086 <entry>1st field ("~")</entry> 1087 <entry>-</entry> 1088 <entry>-</entry> 1089 <entry>-</entry> 1090 <entry>-</entry> 1091 <entry>use [Homes] section</entry> 1092 </row> 1093 <row> 1094 <entry>1st field ("/path")</entry> 1095 <entry>path</entry> 1096 <entry>-</entry> 1097 <entry>-</entry> 1098 <entry>(V)</entry> 1099 <entry>-</entry> 1100 </row> 1101 <row> 1102 <entry>2nd field</entry> 1103 <entry>-</entry> 1104 <entry>-</entry> 1105 <entry>-</entry> 1106 <entry>-</entry> 1107 <entry>use section name</entry> 1108 </row> 1109 <row> 1110 <entry>allow:</entry> 1111 <entry>valid users</entry> 1112 <entry>-</entry> 1113 <entry>-</entry> 1114 <entry>(V)</entry> 1115 <entry>-</entry> 1116 </row> 1117 <row> 1118 <entry>deny:</entry> 1119 <entry>invalid users</entry> 1120 <entry>-</entry> 1121 <entry>-</entry> 1122 <entry>(V)</entry> 1123 <entry>-</entry> 1124 </row> 1125 <row> 1126 <entry>rwlist:</entry> 1127 <entry>rwlist</entry> 1128 <entry>-</entry> 1129 <entry>-</entry> 1130 <entry>(V)</entry> 1131 <entry>-</entry> 1132 </row> 1133 <row> 1134 <entry>rolist:</entry> 1135 <entry>rolist</entry> 1136 <entry>-</entry> 1137 <entry>-</entry> 1138 <entry>(V)</entry> 1139 <entry>-</entry> 1140 </row> 1141 <row> 1142 <entry>volcharset:</entry> 1143 <entry>vol charset</entry> 1144 <entry><emphasis role="bold">UTF8</emphasis></entry> 1145 <entry><emphasis role="bold">(same as unix charset)</emphasis></entry> 1146 <entry>(G)/(V)</entry> 1147 <entry>-</entry> 1148 </row> 1149 <row> 1150 <entry>maccharset:</entry> 1151 <entry>mac charset</entry> 1152 <entry>MAC_ROMAN</entry> 1153 <entry>MAC_ROMAN</entry> 1154 <entry>(G)/(V)</entry> 1155 <entry>-</entry> 1156 </row> 1157 <row> 1158 <entry>veto:</entry> 1159 <entry>veto files</entry> 1160 <entry>-</entry> 1161 <entry>-</entry> 1162 <entry>(V)</entry> 1163 <entry>-</entry> 1164 </row> 1165 <row> 1166 <entry>cnidscheme:</entry> 1167 <entry>cnid scheme</entry> 1168 <entry>dbd</entry> 1169 <entry>dbd</entry> 1170 <entry>(V)</entry> 1171 <entry>-</entry> 1172 </row> 1173 <row> 1174 <entry>casefold:</entry> 1175 <entry>casefold</entry> 1176 <entry>-</entry> 1177 <entry>-</entry> 1178 <entry>(V)</entry> 1179 <entry>-</entry> 1180 </row> 1181 <row> 1182 <entry>adouble:</entry> 1183 <entry>appledouble</entry> 1184 <entry><emphasis role="bold">v2</emphasis></entry> 1185 <entry><emphasis role="bold">ea</emphasis></entry> 1186 <entry>(V)</entry> 1187 <entry>v1, osx and sfm are obsoleted</entry> 1188 </row> 1189 <row> 1190 <entry>cnidserver:</entry> 1191 <entry>cnid server</entry> 1192 <entry>localhost:4700</entry> 1193 <entry>localhost:4700</entry> 1194 <entry>(G)/(V)</entry> 1195 <entry>-</entry> 1196 </row> 1197 <row> 1198 <entry>dbpath:</entry> 1199 <entry>vol dbpath</entry> 1200 <entry><emphasis role="bold">(volume directory)</emphasis></entry> 1201 <entry><emphasis role="bold">var/netatalk/CNID/</emphasis></entry> 1202 <entry>(G)</entry> 1203 <entry>moved to $localstatedir</entry> 1204 </row> 1205 <row> 1206 <entry>umask:</entry> 1207 <entry>umask</entry> 1208 <entry>0000</entry> 1209 <entry>0000</entry> 1210 <entry>(V)</entry> 1211 <entry>-</entry> 1212 </row> 1213 <row> 1214 <entry>dperm:</entry> 1215 <entry>directory perm</entry> 1216 <entry>0000</entry> 1217 <entry>0000</entry> 1218 <entry>(V)</entry> 1219 <entry>-</entry> 1220 </row> 1221 <row> 1222 <entry>fperm:</entry> 1223 <entry>file perm</entry> 1224 <entry>0000</entry> 1225 <entry>0000</entry> 1226 <entry>(V)</entry> 1227 <entry>-</entry> 1228 </row> 1229 <row> 1230 <entry>password:</entry> 1231 <entry>password</entry> 1232 <entry>-</entry> 1233 <entry>-</entry> 1234 <entry>(V)</entry> 1235 <entry>-</entry> 1236 </row> 1237 <row> 1238 <entry>root_preexec:</entry> 1239 <entry>root preexec</entry> 1240 <entry>-</entry> 1241 <entry>-</entry> 1242 <entry>(V)</entry> 1243 <entry>-</entry> 1244 </row> 1245 <row> 1246 <entry>preexec:</entry> 1247 <entry>preexec</entry> 1248 <entry>-</entry> 1249 <entry>-</entry> 1250 <entry>(V)</entry> 1251 <entry>-</entry> 1252 </row> 1253 <row> 1254 <entry>root_postexec:</entry> 1255 <entry>root postexec</entry> 1256 <entry>-</entry> 1257 <entry>-</entry> 1258 <entry>(V)</entry> 1259 <entry>-</entry> 1260 </row> 1261 <row> 1262 <entry>postexec:</entry> 1263 <entry>postexec</entry> 1264 <entry>-</entry> 1265 <entry>-</entry> 1266 <entry>(V)</entry> 1267 <entry>-</entry> 1268 </row> 1269 <row> 1270 <entry>allowed_hosts:</entry> 1271 <entry>hosts allow</entry> 1272 <entry>-</entry> 1273 <entry>-</entry> 1274 <entry>(V)</entry> 1275 <entry>-</entry> 1276 </row> 1277 <row> 1278 <entry>denied_hosts:</entry> 1279 <entry>hosts deny</entry> 1280 <entry>-</entry> 1281 <entry>-</entry> 1282 <entry>(V)</entry> 1283 <entry>-</entry> 1284 </row> 1285 <row> 1286 <entry>ea:</entry> 1287 <entry>ea</entry> 1288 <entry>auto</entry> 1289 <entry>auto</entry> 1290 <entry>(V)</entry> 1291 <entry>-</entry> 1292 </row> 1293 <row> 1294 <entry>volsizelimit:</entry> 1295 <entry>vol size limit</entry> 1296 <entry>-</entry> 1297 <entry>-</entry> 1298 <entry>(V)</entry> 1299 <entry>-</entry> 1300 </row> 1301 <row> 1302 <entry>perm:</entry> 1303 <entry>-</entry> 1304 <entry>-</entry> 1305 <entry>-</entry> 1306 <entry>-</entry> 1307 <entry>Use "directory perm" and "file perm"</entry> 1308 </row> 1309 <row> 1310 <entry>forceuid:</entry> 1311 <entry>-</entry> 1312 <entry>-</entry> 1313 <entry>-</entry> 1314 <entry>-</entry> 1315 <entry>obsolete</entry> 1316 </row> 1317 <row> 1318 <entry>forcegid:</entry> 1319 <entry>-</entry> 1320 <entry>-</entry> 1321 <entry>-</entry> 1322 <entry>-</entry> 1323 <entry>obsolete</entry> 1324 </row> 1325 <row> 1326 <entry>options:ro</entry> 1327 <entry>read only</entry> 1328 <entry>-</entry> 1329 <entry>no</entry> 1330 <entry>(V)</entry> 1331 <entry>-</entry> 1332 </row> 1333 <row> 1334 <entry>options:invisibledots</entry> 1335 <entry>invisible dots</entry> 1336 <entry>-</entry> 1337 <entry>no</entry> 1338 <entry>(V)</entry> 1339 <entry>-</entry> 1340 </row> 1341 <row> 1342 <entry>options:nostat</entry> 1343 <entry>stat vol</entry> 1344 <entry>-</entry> 1345 <entry>yes</entry> 1346 <entry>(V)</entry> 1347 <entry>-</entry> 1348 </row> 1349 <row> 1350 <entry>options:preexec_close</entry> 1351 <entry>preexec close</entry> 1352 <entry>-</entry> 1353 <entry>no</entry> 1354 <entry>(V)</entry> 1355 <entry>-</entry> 1356 </row> 1357 <row> 1358 <entry>options:root_preexec_close</entry> 1359 <entry>root preexec close</entry> 1360 <entry>-</entry> 1361 <entry>no</entry> 1362 <entry>(V)</entry> 1363 <entry>-</entry> 1364 </row> 1365 <row> 1366 <entry>options:upriv</entry> 1367 <entry>unix priv</entry> 1368 <entry>-</entry> 1369 <entry><emphasis role="bold">yes</emphasis></entry> 1370 <entry>(V)</entry> 1371 <entry>-</entry> 1372 </row> 1373 <row> 1374 <entry>options:nodev</entry> 1375 <entry>cnid dev</entry> 1376 <entry>-</entry> 1377 <entry>yes</entry> 1378 <entry>(V)</entry> 1379 <entry>-</entry> 1380 </row> 1381 <row> 1382 <entry>options:illegalseq</entry> 1383 <entry>illegal seq</entry> 1384 <entry>-</entry> 1385 <entry>no</entry> 1386 <entry>(V)</entry> 1387 <entry>-</entry> 1388 </row> 1389 <row> 1390 <entry>options:tm</entry> 1391 <entry>time machine</entry> 1392 <entry>-</entry> 1393 <entry>no</entry> 1394 <entry>(V)</entry> 1395 <entry>-</entry> 1396 </row> 1397 <row> 1398 <entry>options:searchdb</entry> 1399 <entry>search db</entry> 1400 <entry>-</entry> 1401 <entry>no</entry> 1402 <entry>(V)</entry> 1403 <entry>-</entry> 1404 </row> 1405 <row> 1406 <entry>options:nonetids</entry> 1407 <entry>network ids</entry> 1408 <entry>-</entry> 1409 <entry>yes</entry> 1410 <entry>(V)</entry> 1411 <entry>-</entry> 1412 </row> 1413 <row> 1414 <entry>options:noacls</entry> 1415 <entry>acls</entry> 1416 <entry>-</entry> 1417 <entry>yes</entry> 1418 <entry>(V)</entry> 1419 <entry>-</entry> 1420 </row> 1421 <row> 1422 <entry>options:followsymlinks</entry> 1423 <entry>follow symlinks</entry> 1424 <entry>-</entry> 1425 <entry>no</entry> 1426 <entry>(V)</entry> 1427 <entry>-</entry> 1428 </row> 1429 <row> 1430 <entry>options:nohex</entry> 1431 <entry>-</entry> 1432 <entry>-</entry> 1433 <entry>-</entry> 1434 <entry>-</entry> 1435 <entry>auto-convert from ":2f" to ":"</entry> 1436 </row> 1437 <row> 1438 <entry>options:usedots</entry> 1439 <entry>-</entry> 1440 <entry>-</entry> 1441 <entry>-</entry> 1442 <entry>-</entry> 1443 <entry>auto-convert from ":2e" to "."</entry> 1444 </row> 1445 <row> 1446 <entry>options:nofileid</entry> 1447 <entry>-</entry> 1448 <entry>-</entry> 1449 <entry>-</entry> 1450 <entry>-</entry> 1451 <entry>obsolete</entry> 1452 </row> 1453 <row> 1454 <entry>options:prodos</entry> 1455 <entry>-</entry> 1456 <entry>-</entry> 1457 <entry>-</entry> 1458 <entry>-</entry> 1459 <entry>obsolete</entry> 1460 </row> 1461 <row> 1462 <entry>options:mswindows</entry> 1463 <entry>-</entry> 1464 <entry>-</entry> 1465 <entry>-</entry> 1466 <entry>-</entry> 1467 <entry>obsolete</entry> 1468 </row> 1469 <row> 1470 <entry>options:crlf</entry> 1471 <entry>-</entry> 1472 <entry>-</entry> 1473 <entry>-</entry> 1474 <entry>-</entry> 1475 <entry>obsolete</entry> 1476 </row> 1477 <row> 1478 <entry>options:noadouble</entry> 1479 <entry>-</entry> 1480 <entry>-</entry> 1481 <entry>-</entry> 1482 <entry>-</entry> 1483 <entry>obsolete</entry> 1484 </row> 1485 <row> 1486 <entry>options:limitsize</entry> 1487 <entry>-</entry> 1488 <entry>-</entry> 1489 <entry>-</entry> 1490 <entry>-</entry> 1491 <entry>obsolete</entry> 1492 </row> 1493 <row> 1494 <entry>options:dropbox</entry> 1495 <entry>-</entry> 1496 <entry>-</entry> 1497 <entry>-</entry> 1498 <entry>-</entry> 1499 <entry>obsolete</entry> 1500 </row> 1501 <row> 1502 <entry>options:dropkludge</entry> 1503 <entry>-</entry> 1504 <entry>-</entry> 1505 <entry>-</entry> 1506 <entry>-</entry> 1507 <entry>obsolete</entry> 1508 </row> 1509 <row> 1510 <entry>options:nocnidcache</entry> 1511 <entry>-</entry> 1512 <entry>-</entry> 1513 <entry>-</entry> 1514 <entry>-</entry> 1515 <entry>obsolete</entry> 1516 </row> 1517 <row> 1518 <entry>options:caseinsensitive</entry> 1519 <entry>-</entry> 1520 <entry>-</entry> 1521 <entry>-</entry> 1522 <entry>-</entry> 1523 <entry>obsolete</entry> 1524 </row> 1525 </tbody> 1526 </tgroup> 1527 </table></para> 1528 </sect1> 1529 1530 <sect1> 1531 <title>To Do</title> 1532 1533 <para><itemizedlist> 1534 <listitem> 1535 <para>test <command>ad</command> utils with <option>appledouble = 1536 ea</option></para> 1537 </listitem> 1538 </itemizedlist></para> 1539 </sect1> 1540</chapter> 1541