]> arthur.barton.de Git - netatalk.git/commitdiff
Added basic instructions. Added BDB3 information.
authorlancel <lancel>
Mon, 15 Oct 2001 05:10:43 +0000 (05:10 +0000)
committerlancel <lancel>
Mon, 15 Oct 2001 05:10:43 +0000 (05:10 +0000)
ChangeLog
doc/DEVELOPER
doc/INSTALL

index 7ac6afd367d39fea6993624e8bfb93103573b94a..c4ebaebe65f29b7ae464b2b3be0eeb3a7458b4ae 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2001-10-14  Lance Levsen  <l.levsen@printwest.com>
+
+       * doc/INSTALL: Added some basic instructions. Filled in more of
+       the ./configure options.
+
+       * doc/DEVELOPER: Added BDB3 information 
 
 2001-10-11  joe  c  <marcus@marcuscom.com>
 
index c8d4efa48397c4daa36031ed27a279386b15cdde..23abc35d6f31b07be4633a9d8e9bebc680470626 100644 (file)
@@ -111,8 +111,10 @@ programs log the client host name of incoming telnet, ftp, rsh,
 rlogin, finger etc. requests. Security options are: access control per
 host, domain and/or service; detection of host name spoofing or host
 address spoofing; booby traps to implement an early-warning system.
-
 TCP Wrappers can be gotten at ftp://ftp.porcupine.org/pub/security/
+Netatalk uses TCP Wrappers to authorize host access when using
+afpovertcp. It should be noted that if DDP is in use, the connection
+will still be allowed as TCP Wrappers do not impact DDP connections.
 
 7. PAM (Pluggable Authentication Modules for Linux) 
 Linux-PAM provides a flexible mechanism for authenticating
@@ -125,3 +127,10 @@ administrator to choose how applications authenticate users.
 
 You can get the Linux PAM documentation and sources from
 http://www.kernel.org/pub/linux/libs/pam/
+
+8 Berkeley DB version 3
+Berkeley DB is a programmatic toolkit that provides fast, reliable,
+scalable, and mission-critical database support to software
+developers. BDB 3 can downloaded from
+http://www.sleepycat.com/download.html
+Netatalk's CNID database uses the library and header files from BDB3.
index 8b22855bf2adb01a23eecb3ed7255e6ed37c4761..5adb1c098189bc7c22c60aebcb0898f3276150ed 100644 (file)
@@ -17,56 +17,109 @@ Netatalk is known to run on at least five operating systems:
 
 
 
-For generic installation instructions see the file INSTALL in the main
-source directory.
+Quickly:
+$> ./autogen.sh
+$> ./configure [options]
+$> make
+$> make install
 
-Netatalk supports some additional option to the ./configure script.
-These are:
+
+1. ./autogen.sh (Not necessary for a release tarball.)
+This shell script runs libtoolize, aclocal, autoheader, automake and
+autoconf. This sets up all the conditions for the next step. You may
+or may not have to do this. If you downloaded a release tarball, or if
+your download contains a ./configure file then this has already been
+run for you.
+
+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. 
+
+Netatalk options to the ./configure script: Use ./configure --help for
+a complete list.
 
 --disable-admin-group: disable admin group (default on),
 
---disable-ddp: disable DDP support,
+--disable-ddp: disable DDP support (AppleTalk),
 
---enable-dropkludge: enable the experimental dropbox fix (INSECURE!)
+--enable-debug: enable debugging messages in syslog,
 
---with-shadow: enable shadow password support,
+--enable-dropkludge: enable the experimental dropbox fix
+       (INSECURE!),
+
+--enable-cnid-db: use persistent cnid database per volume 
+       (EXPERIMENTAL),
+
+--with-db3=PATH: specify path to Berkeley DB3 installation,
+
+--with-did=[scheme]: set DID scheme (last,mtab),
+
+--with-msg-dir=path: path to message files [default=/etc/msg],
+
+--enable-srvloc: Turn on Server Location Protocol support (EXPERIMENTAL),
 
 --with-pam: enable pluggable authentication modules support,
-     PAM provides a flexible mechanism for authenticating
-     users. PAM was invented by SUN Microsystems.
-     Author: Andrew Morgan <morgan@linux.kernel.org>
+       PAM provides a flexible mechanism for authenticating
+       users. PAM was invented by SUN Microsystems.
+
+       Linux-PAM is a suite of shared libraries that enable the local
+       system administrator to choose how applications authenticate users.
+       You can get the Linux PAM documentation and sources from
+       http://www.kernel.org/pub/linux/libs/pam/
+
+--with-shadow: enable shadow password support,
 
-     Linux-PAM is a suite of shared libraries that enable the local
-     system administrator to choose how applications authenticate users.
-     You can get the Linux PAM documentation and sources from
-     http://www.kernel.org/pub/linux/libs/pam/
+--disable-shell-check: disable checking for a valid shell,
 
+--with-flock-locks: enable flock locks support,
 
 --with-tcp-wrappers: enable TCP wrappers support.
-     Wietse Venema's network logger, also known as TCPD or
-     LOG_TCP. These programs log the client host name of incoming
-     telnet, ftp, rsh, rlogin, finger etc. requests. Security
-     options are: access control per host, domain and/or service;
-     detection of host name spoofing or host address spoofing;
-     booby traps to implement an early-warning system.  TCP
-     Wrappers can be gotten at
-     ftp://ftp.porcupine.org/pub/security/
+       Wietse Venema's network logger, also known as TCPD or
+       LOG_TCP. These programs log the client host name of incoming
+       telnet, ftp, rsh, rlogin, finger etc. requests. Security
+       options are: access control per host, domain and/or service;
+       detection of host name spoofing or host address spoofing;
+       booby traps to implement an early-warning system.  TCP
+       Wrappers can be gotten at
+       ftp://ftp.porcupine.org/pub/security/
 
 --with-ssl-dirs=[PATH]: specify path to OpenSSL installation. 
-     NOTE: This is dependent on the same directory layout as the
-     source distribution of Openssl. That is: ./include/ and
-     ./lib/ to be on the same level. Many .rpm formats do not
-     have their files laid out in this format.
-     The OpenSSL Project is a collaborative effort to develop a
-     robust, commercial-grade, full-featured, and Open Source
-     toolkit implementing the Secure Sockets Layer (SSL v2/v3)
-     and Transport Layer Security (TLS v1) protocols as well as a
-     full-strength general purpose cryptography library.
-     This is required to enable DHX login support.
-     Get everything at http://www.openssl.org/ 
+       NOTE: This is dependent on the same directory layout as the
+       source distribution of Openssl. That is: ./include/ and
+       ./lib/ to be on the same level. Many .rpm formats do not
+       have their files laid out in this format.
+       The OpenSSL Project is a collaborative effort to develop a
+       robust, commercial-grade, full-featured, and Open Source
+       toolkit implementing the Secure Sockets Layer (SSL v2/v3)
+       and Transport Layer Security (TLS v1) protocols as well as a
+       full-strength general purpose cryptography library.
+       This is required to enable DHX login support.
+       Get everything at http://www.openssl.org/ 
 
 --with-lastdid: Recreate 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.
+       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-uams-path=path: path to UAMs [default=PKGCONF/uams]
+
+--enable-fhs: use Filesystem Hierarchy Standard (FHS) compatibility
+
+--with-ssl-dir=PATH: specify path to openssl installation (must contain
+       lib and include dirs) 
+
+--enable-pgp-uam: enable build of PGP UAM module
+
+--enable-krb4-uam: enable build of Kerberos v4 UAM module
+
+--enable-overwrite: Overwrite configuration files in PKGCONFDIR
+
+
+3. ./make
+
+Compile all of the programs
+
+4. ./make install
+Install the programs in the places specified by the ./configure process.