Requirements

============

- autofs 5.0.0 requires protocol version 5.00 of the autofs4 kernel

  module (see "Applying the kernel patch" below).

- The LDAP, SASL, and the libxml2 libraries may also be required if

  the LDAP configure options are selected (see "Configure options for

  autofs" below).

How to build and install

========================

To configure, compile, and install the package directly from the

tar distribution, follow these steps.

  1. Make sure you have the latest version of the package available

     from http://www.kernel.org/pub/linux/daemons/autofs/v4.

  2. Type `./configure' to configure the package. You may want to add

     selected configure options. See "Configure options for autofs"

     below.

  3. Build the package by typing `make'

  4. Install the package by typing `make install'.

To build an `rpm' from the tar distribution use:

rpmbuild -tb autofs-5.0.0_beta6.tar.gz

and install the resulting rpm package.

Configure options for autofs

============================

There are several configure options available to add functionality.

--prefix=<root_prefix>

   autofs usually installs in /usr, with the daemon in /usr/sbin,

   the man pages in /usr/man, and the modules in /usr/lib/autofs.

   If you wish to install to a different location use this option.

--with-path=PATH

   Allows the specification of the path to search for utility

   binaries used by autofs during the `configure' process. If

   any of your binaries such as `mount', `mount.cifs' etc. live

   in locations other than /usr/bin:/bin:/usr/sbin:/sbin you

   will need to use this option.

--disable-ext-env

   This option disables the ability to the external environment

   to set an external environment variable for substitution.

--disable-mount-locking

   This option disables mount locking which is to prevent corruption

   in /etc/mtab due to multiple concurrent autofs mount commands.

--enable-force-shutdown

   This option enables the use of the USR1 signal to force an

   unconditional unlink umount of all mounts at shutdown.

--enable-ignore-busy

   This option enables the automount to exit ignoring any busy

   mounts upon receiving a TERM signal. automount attempts to

   recover upon startup.

--with-confdir=DIR

  This option allows the specification of the directory that contains

  the autofs configuration file `autofs'. If not given the directories

  `/etc/sysconfig', `/etc/default' and `/etc/conf.d' and checked for

  existence and the first one found is used.

--with-mapdir=PATH

  This option allows the specification of the directory that contains

  autofs mount maps. The directories `/etc/autofs' and `/etc' are

  checked for existence and first one found is used.

--with-hesiod=DIR

  Use this option to enable Hesiod support if your Hesiod library

  isn't installed in /usr/lib with the include files in /usr/include.

--with-openldap=DIR

  Use this To enable LDAP support if your OpenLDAP library isn't

  installed in /usr/lib with the include files in /usr/include.

--with-sasl=DIR

  Use this to enable TLS encrypted connections and LDAP

  authentication using the SASL library. DIR only needs to be

  given if your LDAP and SASL library and include files are

  installed in other than /usr/lib and /usr/include. See

  auto.master(5) for more information about LDAP configuration.

Applying The Kernel Patch

=========================

Patches that can be applied to the kernel are located in the

`patches' directory. If you have installed autofs from an rpm

then they can be found in the packages' doc directory after

install. They consist of a kernel patch for each kernel from

2.6.9 thru 2.6.16 (the patches are in the 2.6.17-rc series so

patching a 2.6.17 or above kernel shouldn't be needed). If

you need a patch for an older 2.6 kernel then post to the

autofs mailing list and ask for one to be done.

To apply one of these patches:

1) change to the root of your kernel source tree.

2) patch the kernel

3) make the kernel

4) Install the kernel as normal.

If you use a packaged kernel then you need to check to see if

the v5 update patch will apply and if it does apply add the

update patch and build your packaged kernel.

For example, Fedora Core 4 kernel package 2.6.11-1.369_FC4

would use the 2.6.12 patch because it applies the 2.6.12 release

candidate revision 6 patch. But the autofs patch doesn't apply

because the rpm also applies a patch somewhere that changes one

area the patch also changes but this change is not present

in the 2.6.12 release kernel.

On the other hand, Fedora Core 3 kernel 2.6.12-1.1381_FC3

uses the 2.6.12 patch and it applies cleanly because the kernel

doesn't apply a 2.6.13 release candidate patch and there are no

additional patches that clash with the autofs update patch. To

build this kernel with an update patch modify the kernel-2.6.spec

to apply the update patch after all other patches (see example

change below), copy the autofs4-2.6.12-v5-update to the SOURCES

directory of your RPM build tree and us use

`rpmbuild -bb --target=i686 kernel-2.6.spec' in the SPEC directory

of the build tree and install the resulting RPMs.

Example of how to add the update patch:

--- kernel-2.6.spec.orig	2006-05-01 10:14:27.000000000 +0800

+++ kernel-2.6.spec	2006-05-01 10:16:21.000000000 +0800

@@ -358,6 +358,8 @@

 Patch10000: linux-2.6.0-compile.patch

 Patch10001: linux-2.6-compile-fixes.patch

+Patch20000: autofs4-2.6.12-v5-update.patch

+

 # END OF PATCH DEFINITIONS

 BuildRoot: %{_tmppath}/kernel-%{KVERREL}-root

@@ -739,6 +741,7 @@

 %patch10000 -p1

 %patch10001 -p1

+%patch20000 -p1

 # END OF PATCH APPLICATIONS

Some Fedora Core kernels have autofs4 bug fix patches, such as

2.6.16-1.2096_FC5. The update patch supersedes all previous patches

so any additional autofs4 patches should be removed and the update

patch added. For example 2.6.16-1.2096_FC5 needs this change:

--- kernel-2.6.spec.orig	2006-06-18 14:56:27.000000000 +0800

+++ kernel-2.6.spec	2006-06-18 14:56:52.000000000 +0800

@@ -359,7 +359,7 @@

 Patch1630: linux-2.6-radeon-backlight.patch

 Patch1640: linux-2.6-ide-tune-locking.patch

 Patch1641: linux-2.6-ide-cd-shutup.patch

-Patch1650: linux-2.6-autofs-pathlookup.patch

+#Patch1650: linux-2.6-autofs-pathlookup.patch

 Patch1660: linux-2.6-valid-ether-addr.patch

 Patch1670: linux-2.6-softcursor-persistent-alloc.patch

 Patch1680: linux-2.6-pwc-powerup-by-default.patch

@@ -983,7 +983,7 @@

 # Silence noisy CD drive spew

 %patch1641 -p1

 # autofs4 looks up wrong path element when ghosting is enabled

-%patch1650 -p1

+#%patch1650 -p1

 # 

 %patch1660 -p1

 # Use persistent allocation in softcursor