Basic Installation
==================
-Netatalk is known to run on at least five operating systems:
+Netatalk is known to run on these operating systems:
OS Versions Hardware Notes
-- -------- -------- -----
Ultrix 4.[1-4] 3100,5000
Tru64 4.0 Alpha afpd only
-See ./doc/README.platforms for more information.
+See README.platforms for more information.
Quickly:
-$> ./autogen.sh
$> ./configure [options]
$> make
$> make install
2. ./configure
This step reads the options to the ./configure program and checks your
system against the requirements of those options. It generally fails
-if your system doesn't meet the requirements. You should read check
-the DEVELOPER file because some of these options require external
-sources to function correctly. (PAM, SSL, Berkeley DB3, TCP Wrappers,
-etc).
+if your system doesn't meet the requirements. You should read the
+DEVELOPER file because some of these options require external sources
+to function correctly. (PAM, OpenSSL, Berkeley DB, TCP Wrappers, etc).
Netatalk options to the ./configure script: Use ./configure --help for
a complete list.
--enable-dropkludge: enable the experimental dropbox fix
(INSECURE!),
---enable-cnid-db: use persistent cnid database per volume
- (EXPERIMENTAL),
+--with-bdb=PATH: specify path to Berkeley DB installation,
---with-db3=PATH: specify path to Berkeley DB3 installation,
+--with-did=[scheme]: set DID scheme (cnid,last),
+ CNID is a new scheme using Berkeley DB files to store a
+ per-volume cnid database persistently.
---with-did=[scheme]: set DID scheme (last,mtab),
The last DID scheme recreates version 37b behaviour where
directory id's are incrementally calculated versus the new
hash method. Unfortunately for machines that have a lot of
devices, and/or a lot of inodes the hash can fail with
multiple directories resolving to the same DID.
---with-msg-dir=path: path to message files [default=/etc/msg],
+--with-message-dir=path: path to message files [default is DISABLED],
---enable-srvloc: Turn on Server Location Protocol support (EXPERIMENTAL),
+--enable-srvloc: Turn on Server Location Protocol support,
--with-pam: enable pluggable authentication modules support,
PAM provides a flexible mechanism for authenticating
----------------------------------------------------------------
-3. ./make
+3. make
-Compile all of the programs
+Compile all of the programs.
+Note: GNU make is required to build netatalk.
----------------------------------------------------------------
-4. ./make install
-Install the programs in the places specified by the ./configure process.
+4. make install Install the programs, scripts and man pages in the
+places specified by the ./configure process.