From 16bae98ec525fa013514fb46398df682d7637ae0 Mon Sep 17 00:00:00 2001 From: Cheyenne Wills Date: Mon, 24 Aug 2020 11:10:30 -0600 Subject: [PATCH] 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 Reviewed-by: Benjamin Kaduk --- INSTALL | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/INSTALL b/INSTALL index f45b95c..f9b3166 100644 --- a/INSTALL +++ b/INSTALL @@ -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. \ No newline at end of file -- 1.9.4