Netatalk 2.0 Manual 3rd January 2005 2.0.2 Legal Notice This documentation is distributed under the GNU General Public License (GPL) version 2. A copy of the license is included in this documentation, as well as within the Netatalk source distribution. An on-line copy can be found at <http://www.fsf.org/licenses/gpl.txt> iii Contents 1 Introduction to Netatalk 1 2 Installation 3 2.1 How to obtain Netatalk . 3 2.1.1 Binary packages . 3 2.1.2 Source packages . 3 2.1.2.1 Tarballs . 3 2.1.2.2 Anonymous CVS . 3 2.2 Compiling Netatalk . 4 2.2.1 Prerequisites . 4 2.2.1.1 System requirements . 4 2.2.1.2 Required third party software . 5 2.2.1.3 Optional third party software . 5 2.2.2 Compiling Netatalk . 6 2.2.2.1 Configuring the build . 6 2.2.3 Compiling a new Berkeley DB for Netatalk . 7 2.2.3.1 Using a statically linked Berkeley DB . 7 2.2.3.2 Using a dynamically linked Berkeley DB . 7 3 Setting up Netatalk 9 3.1 Appletalk . 9 3.1.1 To use AppleTalk or not . 9 3.1.2 No AppleTalk routing . 9 3.1.3 atalkd acting as an AppleTalk router . 11 3.2 File Services . 13 3.2.1 Setting up the AFP file server . 13 3.2.1.1 afpd.conf . 14 3.2.1.2 AppleVolumes.default . 14 3.2.2 CNID backends . 14 3.2.2.1 cdb . 15 3.2.2.2 dbd . 15 3.2.2.3 last . 15 3.2.3 Charsets/Unicode . 16 3.2.3.1 Why Unicode? . 16 3.2.3.2 character sets used by Apple . 16 3.2.3.3 afpd and character sets . 17 3.2.4 Authentication . 18 3.2.4.1 AFP authentication basics . 18 3.2.4.2 UAMs supported by Netatalk . 18 3.2.4.3 Which UAMs to activate? . 19 3.2.4.4 Using different authentication sources with specific UAMs . 19 3.2.4.5 Netatalk UAM overview table . 20 3.2.4.6 SSH tunneling . 21 3.3 Printing . 22 3.3.1 Setting up the PAP print server . 22 3.3.1.1 Integrating papd with SysV lpd . 22 3.3.1.2 Using pipes with papd . 22 v vi 3.3.1.3 Using direct CUPS support . 23 3.3.2 Using AppleTalk printers . 23 3.4 Time Services . 24 3.4.1 Using Netatalk as a time server for Macintoshes . 24 3.5 Starting and stopping Netatalk . 24 4 Upgrading from a previous version of Netatalk 25 4.1 Overview . 25 4.2 Volumes and filenames . 25 4.2.1 How to upgrade a volume to 2.0 . 26 4.2.2 How to use a 1.x CAP encoded volume with 2.0 . 26 4.2.3 How to use a 1.x NLS volume with 2.0 . 27 4.3 Choosing a CNID storage scheme . 27 4.3.1 How to upgrade if no persistent CNID storage was used . 28 4.3.2 How to upgrade if a persistent CNID storage scheme was used . 29 4.3.3 How to upgrade if a persistent CNID storage scheme was used, the brute force approach . 30 4.4 Setting up a test server on the same machine . 30 4.4.1 Setting up an empty test share . 30 4.4.2 Duplicating an already existing share . 30 4.4.3 Configuring and running the test afpd . 31 5 Manual Pages 33 5.1 achfile . 33 5.2 acleandir . 34 5.3 aecho . 35 5.4 afile....................................................... 36 5.5 afpd....................................................... 37 5.6 afpd.conf . 39 5.7 afppasswd . 46 5.8 AppleVolumes.default . 47 5.9 apple_cp . 53 5.10 apple_mv . 54 5.11 apple_rm . 55 5.12 asip-status.pl . 55 5.13 atalk . 57 5.14 atalkd . 58 5.15 atalkd.conf . 59 5.16 atalk_aton . 60 5.17 cnid_dbd . 61 5.18 cnid_index . 63 5.19 cnid_metad . 64 5.20 getzones . 65 5.21 megatron . ..