4 Netatalk is known to run on at least five operating systems:
6 OS Versions Hardware Notes
7 -- -------- -------- -----
10 FreeBSD 2.2-current PC after 12 Sept 96
13 SunOS 4.1+ Sparc kernel must have VDDRV
15 Ultrix 4.[1-4] 3100,5000
16 Tru64 4.0 Alpha afpd only
18 See ./doc/README.platforms for more information.
22 $> ./configure [options]
27 ----------------------------------------------------------------
30 A. Download a binary. Several Linux distributions support netatalk
31 with a package. There are also Deb's and RPM packages available on the
32 the Netatalk Sourceforge
33 site. (http://sourceforge.net/projects/netatalk/)
35 B. Download the tarball. There are tar.gz and tar.bz2 files available
36 for download and compiling.
37 (http://sourceforge.net/projects/netatalk/)
39 C. Anonymous CVS. Downloading of the CVS source can be done quickly
42 1. make sure you have cvs installed.
44 should produce a path to cvs.
46 2. if you don't have one make a source directory. Mine is
47 ~lance/src/working/ cd to this directory.
49 3. Authenticate yourself with your local cvs and the remote cvs: (all
53 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk \
56 Just hit enter for the password for the anonymous user.
58 4. Now that both machines know who you are, get the source: (all one
62 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk \
65 This tells cvs what compression, (-z3) what protocol, repository and
66 where the source is (-d:protocol:host:path) what to do (co is an alias
67 for checkout) and what (netatalk) module.
69 This will create a netatalk directory and download a complete and
70 fresh copy of the netatalk source
73 ----------------------------------------------------------------
75 1. ./autogen.sh (Not necessary for a release tarball.)
76 This shell script runs libtoolize, aclocal, autoheader, automake and
77 autoconf. This sets up all the conditions for the next step. You may
78 or may not have to do this. If you downloaded a release tarball, or if
79 your download contains a ./configure file then this has already been
82 ----------------------------------------------------------------
85 This step reads the options to the ./configure program and checks your
86 system against the requirements of those options. It generally fails
87 if your system doesn't meet the requirements. You should read check
88 the DEVELOPER file because some of these options require external
89 sources to function correctly. (PAM, SSL, Berkeley DB3, TCP Wrappers,
92 Netatalk options to the ./configure script: Use ./configure --help for
95 --disable-admin-group: disable admin group (default on),
97 --disable-ddp: disable DDP support (AppleTalk),
99 --enable-debug: enable debugging messages in syslog,
101 --enable-dropkludge: enable the experimental dropbox fix
104 --enable-cnid-db: use persistent cnid database per volume
107 --with-db3=PATH: specify path to Berkeley DB3 installation,
109 --with-did=[scheme]: set DID scheme (last,mtab),
110 The last DID scheme recreates version 37b behaviour where
111 directory id's are incrementally calculated versus the new
112 hash method. Unfortunately for machines that have a lot of
113 devices, and/or a lot of inodes the hash can fail with
114 multiple directories resolving to the same DID.
116 --with-msg-dir=path: path to message files [default=/etc/msg],
118 --enable-srvloc: Turn on Server Location Protocol support (EXPERIMENTAL),
120 --with-pam: enable pluggable authentication modules support,
121 PAM provides a flexible mechanism for authenticating
122 users. PAM was invented by SUN Microsystems.
124 Linux-PAM is a suite of shared libraries that enable the local
125 system administrator to choose how applications authenticate users.
126 You can get the Linux PAM documentation and sources from
127 http://www.kernel.org/pub/linux/libs/pam/
129 --with-shadow: enable shadow password support,
131 --disable-shell-check: disable checking for a valid shell,
133 --with-flock-locks: enable flock locks support,
135 --with-tcp-wrappers: enable TCP wrappers support.
136 Wietse Venema's network logger, also known as TCPD or
137 LOG_TCP. These programs log the client host name of incoming
138 telnet, ftp, rsh, rlogin, finger etc. requests. Security
139 options are: access control per host, domain and/or service;
140 detection of host name spoofing or host address spoofing;
141 booby traps to implement an early-warning system. TCP
142 Wrappers can be gotten at
143 ftp://ftp.porcupine.org/pub/security/
145 --with-ssl-dirs=[PATH]: specify path to OpenSSL installation.
146 NOTE: This is dependent on the same directory layout as the
147 source distribution of Openssl. That is: ./include/ and
148 ./lib/ to be on the same level. Many .rpm formats do not
149 have their files laid out in this format.
150 The OpenSSL Project is a collaborative effort to develop a
151 robust, commercial-grade, full-featured, and Open Source
152 toolkit implementing the Secure Sockets Layer (SSL v2/v3)
153 and Transport Layer Security (TLS v1) protocols as well as a
154 full-strength general purpose cryptography library.
155 This is required to enable DHX login support, which
156 will encrypt all of the passwords being sent across the
157 connection. (Some old mac clients don't support this, check
158 the FAQ for the section on AppleShare clients.)
159 Check to see if your unix has OpenSSL already, or
160 get everything at http://www.openssl.org/
162 --with-uams-path=path: path to UAMs [default=PKGCONF/uams]
164 --enable-fhs: use Filesystem Hierarchy Standard (FHS) compatibility
166 --with-ssl-dir=PATH: specify path to openssl installation (must contain
167 lib and include dirs)
169 --enable-pgp-uam: enable build of PGP UAM module
171 --enable-krb4-uam: enable build of Kerberos v4 UAM module
173 --enable-overwrite: Overwrite configuration files in PKGCONFDIR
175 ----------------------------------------------------------------
179 Compile all of the programs
181 ----------------------------------------------------------------
184 Install the programs in the places specified by the ./configure process.