Intro
=====

This document is designed to provide a list of the minimum levels of
software necessary to run the 2.1.x kernels, as well as provide brief
instructions regarding any other "Gotchas" users may encounter when
trying life on the Bleeding Edge.  If upgrading from a pre-2.0.x
kernel, please consult the Changes file included with 2.0.x kernels for
additional information; most of that information will not be repeated
here.  Basically, this document assumes that your system is already
functional and running at least 2.0.x.

   It is originally based on my "Changes" file for 2.0.x kernels and
therefore owes credit to the same people as that file (Jared Mauch,
Axel Boldt, Alessandro Sigala, and countless other users all over the
'net).  Please feel free to submit changes, corrections, gripes,
flames, money, etc. to me (gt1355b@prism.gatech.edu).  If you do so,
you don't need to bother doing so in the form of a diff, as this is
generated by texinfo so a diff is useless anyway (though I can
incorporate one by hand if you insist upon sending it that way ;-).

   Check out http://www.cviog.uga.edu/Misc/info/LinuxBleed.html for an
HTML-ized shopping list.

   For those of you in Europe,
http://www.datanet.hu/generations/linux/Changes2.html is an
English-language HTML version.

Last updated: April 1, 1997.
Current Author: Chris Ricker (gt1355b@prism.gatech.edu).

Current Minimal Requirements
****************************

   Upgrade to at *least* these software revisions before thinking you've
encountered a bug!

- Kernel modules	 modutils-2.1.29-970320
- Gnu C 		 2.7.2.1
- Binutils		 2.7.0.9
- Linux C Library	 5.4.23
- Dynamic Linker (ld.so) 1.8.5
- Linux C++ Library	 2.7.2.1
- Procps		 1.01
- Mount                  2.5p
- Net-tools              1.32-alpha
- Kbd                    0.91
- Loadlin                1.6a
- Sh-utils               1.16
- Ncpfs                  2.1.1

Upgrade notes
*************

General Information
===================

   <CTRL><ALT><DEL> now performs a cold reboot instead of a warm reboot
for increased hardware compatibility.  If you want a warm reboot and
know it works on your hardware, add a "reboot=warm" command line option
in Lilo.  A small number of machines need "reboot=bios" to reboot via
the BIOS.

Libc
====

   Linux-2.1.x is ELF-only.  You can still compile a.out apps if you
really want, but your kernel must be compiled ELF.  If you can't
currently compile ELF, consult the ELF howto at
http://sunsite.unc.edu/mdw/HOWTO/ELF-HOWTO.html and upgrade your system
accordingly.

   For modules to work, you need to be running libc-5.4.x or greater.
Since updates to libc fix other problems as well (security flaws, for
example) and since 5.4.7 is missing a few needed symbols, try to get
the latest 5.4.x you can.  Currently, libc-5.4.23 is the latest public
release.

   If you upgrade to libc-5.4.x, you also have to upgrade your dynamic
linker (ld.so) to at least 1.8.5, or all sorts of weirdness will
happen.  Actually, ld.so-1.8.2 and later will work, but only 1.8.5 is
widely available, so if you need to upgrade, use it.

Modules
=======

   You need to upgrade to modutils-2.1.29-970320 for kernels 2.1.29 and
later.

Binutils
========

   If you upgrade binutils, please read its accompanying release notes
to find out the proper way to upgrade it.

Gnu C
=====

   You need at least GCC 2.7.2 to compile the kernel.  If you're
upgrading from an earlier release, you might as well get GCC 2.7.2.1,
the latest public release.  If you already have GCC 2.7.2 on your
system, you don't have to upgrade just so the kernel will work (though
feel free to upgrade if you want the gcc bug fixes).

Networking Changes
==================

   Please read Documentation/networking/routing.txt and
Documentation/networking/policy-routing.txt for more information about
changes in routing code.  OSPF classes have been added, and interface
routes are generated automatically.

   If for some reason you need to override this automatic default
routing, you have to specify the complete route specification (netmask,
device, etc.) for the kernel to accept it. Consequently, you need to
either remove interface routes from your init scripts or add missing
information to them if you need to replace the automatic routes.

   Also note that some routes, such as loopback routes, do not show up
in some standard tools.  Check in /proc/net/rt_local to verify their
presence.

   To turn on IP forwarding, issue the following command:   echo 1 >
/proc/sys/net/ipv4/ip_forwarding

   To run bootpd, you'll need to issue the following command:   echo 1
>/proc/sys/net/ipv4/ip_boot_agent

RPM
===

   If you run RedHat Linux or any other distribution that uses RPM, you
need to upgrade RPM to version 2.2.7 or later.

DOSEMU
======

   A new "stable" version of DOSEMU is available for 2.1.x kernels.
Upgrade to 0.66.1 or later.

Loadlin
=======

   Linux 2.1.22 and later releases use a new method of memory size
detection, requiring loadlin users to upgrade to loadlin-1.6a.

Sh-utils
========

   As of Linux-2.1.26, the Configure script ("make config") has been
updated to be POSIX-compliant.  As a result, your expr needs to be
updated.  Use sh-utils 1.16 or later.

How to know the version of the installed programs
*************************************************

   There are some simple methods useful to know the version of the
installed programs and libraries.  The SysVinit version display
requires that you be logged in as root.

Binutils: ld -v
Gnu C: gcc -v or gcc --version
Kbd: loadkeys -h
Ld.so: ldd -v
Libc: ls -l /lib/libc.so.*
Libc++: ls -l /usr/lib/libg++.so.*
Modutils: insmod -V
Mount: mount --version
Procps: ps --version
RPM:  rpm --version
Sh-utils:  expr --v

Where to get the files
**********************

Binutils
========

The 2.7.0.9 release:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/binutils-2.7.0.9.bin.tar.gz
ftp://sunsite.unc.edu/pub/Linux/GCC/binutils-2.7.0.9.bin.tar.gz
Installation notes:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/release.binutils-2.7.0.9
ftp://sunsite.unc.edu/pub/Linux/GCC/release.binutils-2.7.0.9

Gnu C
=====

The 2.7.2.1 release:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/gcc-2.7.2.1.bin.tar.gz
ftp://sunsite.unc.edu/pub/Linux/GCC/gcc-2.7.2.1.bin.tar.gz
Installation notes:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/release.gcc-2.7.2.1
ftp://sunsite.unc.edu/pub/Linux/GCC/release.gcc-2.7.2.1

Linux C Library
===============

The 5.4.23 release:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/libc-5.4.23.bin.tar.gz
ftp://sunsite.unc.edu/pub/Linux/GCC/libc-5.4.23.bin.tar.gz
Installation notes for 5.4.23:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/release.libc-5.4.23
ftp://sunsite.unc.edu/pub/Linux/GCC/release.libc-5.4.23

Linux C++ Library
=================

The 2.7.2.1 release:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/libg++-2.7.2.1.bin.tar.gz
ftp://sunsite.unc.edu/pub/Linux/GCC/libg++-2.7.2.1.bin.tar.gz
Installation notes:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/release.libg++-2.7.2.1
ftp://sunsite.unc.edu/pub/Linux/GCC/release.libg++-2.7.2.1

Dynamic Linker
==============

The 1.8.5 release:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC/ld.so-1.8.5.tar.gz
ftp://sunsite.unc.edu/pub/Linux/GCC/ld.so-1.8.5.tar.gz

Modules utilities
=================

The 2.1.29-970320 release:
ftp://ftp.redhat.com/pub/alphabits/modutils-2.1.29-970320.tar.gz

Procps utilities
================

The 1.01 release:
ftp://tsx-11.mit.edu/pub/linux/sources/usr.bin/procps-1.01.tgz
ftp://sunsite.unc.edu/pub/Linux/system/status/ps/procps-1.01.tgz

RPM utilities
=============

The 2.2.7 release for Intel:
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/i386/rpm-2.2.7-1.i386.rpm
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/i386/rpm-devel-2.2.7-1.i386.rpm
The 2.2.7 release for Alpha:
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/axp/rpm-2.2.7-1.axp.rpm
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/axp/rpm-devel-2.2.7-1.axp.rpm
The 2.2.7 release for SPARC:
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/i386/rpm-2.2.7-1.sparc.rpm
ftp://ftp.redhat.com/pub/redhat/redhat-4.0/updates/i386/rpm-devel-2.2.7-1.sparc.rpm

DOSEMU
======

The 0.66.1 release:
ftp://tsx-11.mit.edu/pub/linux/ALPHA/dosemu/dosemu0.66.1.tgz
ftp://sunsite.unc.edu/pub/Linux/system/emulators/dosemu0.66.1.tgz

Loadlin
=======

The 1.6a release:
ftp://ftp.suse.com/pub/loadlin/update-1.6a/loadlin.exe.gz
ftp://elserv.ffm.fgan.de/pub/linux/loadlin-1.6/update-1.6a/loadlin.exe.gz

Sh-utils
========

The 1.16 release
ftp://sunsite.unc.edu/pub/gnu/sh-utils-1.16.tar.gz
ftp://prep.ai.mit.edu/pub/gnu/sh-utils-1.16.tar.gz

Other Info
==========

   Please remember that most of these utils are available on your
favorite local linux mirror.  If you can, please get them from a closer
site before checking sunsite.

   Also, for those of you running Red Hat (or RPM on a different
distribution), most of these are available in RPM format.  Check around
your favorite Red Hat mirror site before installing the non-RPM
version.  Remember, you might need to use the -force option to get the
upgrade to install.  ftp://ftp.redhat.com/pub/contrib/ will have almost
everything you need.

   For others, David Bourgin has put together a package of everything
necessary to quickly and easily upgrade to 2.1.x.  See
ftp://ftp.wsc.com/pub/freeware/linux/update.linux/kernel-v2.1.x/ for
more information and the files.

Please send info about any other packages that 2.1.x "broke" or about
any new features of 2.1.x that require extra or new packages for use to
Chris Ricker (gt1355b@prism.gatech.edu).

