| |
| 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 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 |