INSTALL: document the minimum Linux kernel level

The change associated with gerrit #14300 removed support for older
Linux kernels (2.6.10 and earlier).

The commit 'Import of code from autoconf-archive' (d8205bbb4) introduced
a check for Autoconf 2.64.  Autoconf 2.64 was released in 2009.

The commit 'regen.sh: Use libtoolize -i, and .gitignore generated
build-tools' (a7cc505d3) introduced a dependency on libtool's  '-i'
option.  Libtool supported the '-i' option with libtool 1.9b in 2004.

Update the INSTALL instructions to document a minimum Linux kernel
level and the minimum levels for autoconf and libtool.

Notes: RHEL4 (EOL in 2017) had a 2.6.9 kernel and RHEL5 has a 2.6.18
kernel. RHEL5 has libtool 1.5.22 and autoconf 2.59, RHEL6 has libtool
2.2.6 and autoconf 2.63, and RHEL7 has libtool 2.4.2 and autoconf 2.69.

Change-Id: I235eeffa4adb152e05aab7aca839700816e62c83
Reviewed-on: https://gerrit.openafs.org/14305
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
This commit is contained in:
Cheyenne Wills 2020-08-24 11:10:30 -06:00 committed by Benjamin Kaduk
parent b968875a34
commit 16bae98ec5

26
INSTALL
View File

@ -202,9 +202,7 @@ D Linux Notes
last kernel you built for, the previous kernel module will be
overwritten.
The Linux 2.4 series (and older) are no longer supported. The OpenAFS 1.6
series of releases are the last ones supporting those old kernels and in
particular their LinuxThreads.
The minimum supported Linux kernel is 2.6.18.
E HP-UX 11.0 Notes
@ -217,7 +215,8 @@ E HP-UX 11.0 Notes
F OpenBSD Notes
If you need to run regen.sh to make the configure script, you should
first install autoconf-2.59, then setenv AUTOCONF_VERSION 2.59.
set the environment variable AUTOCONF_VERSION to the installed autoconf
version, e.g. 'setenv AUTOCONF_VERSION 2.64' (see 'J' below).
You need kernel source installed to build OpenAFS. Use the
--with-bsd-kernel-headers= configure option if your kernel source is
@ -561,3 +560,22 @@ I Other configure options
YFLAGS
Additional flags to pass to yacc.
J Creating 'configure'
Normally you can use the configure script provided with the OpenAFS release
tar file, but if you are patching the autoconf logic or building directly
from source pulled from the git repository you may need to (re-)generate
the configure script.
To create the configure script autoconf-2.64 or later and libtool-1.9b or
later are needed.
Running the script 'regen.sh' creates the configure script. In addition
to creating the configure script, regen.sh will also, by default, build
the man pages, which requires the pod2man utility. Use 'regen.sh -q' to
skip building the man pages.
It is possible to create the configure script on one system to be used on
another. Ensure that the files created by 'regen.sh' are copied to the
target system.