patch-1.3.89 linux/Documentation/Changes

Next file: linux/Documentation/Configure.help
Previous file: linux/CREDITS
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v1.3.88/linux/Documentation/Changes linux/Documentation/Changes
@@ -3,23 +3,27 @@
 
 The installation information were removed because redundant.
 
-Last updated: 12 Apr 1996.
-Author: Alessandro Sigala `ssigala@globalnet.it'.
+Last updated: 14 Apr 1996.
+Author: Alessandro Sigala (ssigala@globalnet.it).
+
+Section "Upgrading to 1.3.x kernel" contributed by Chris Ricker
+(gt1355b@prism.gatech.edu).
 
 Current Releases
 ****************
 
-- Kernel modules 1.3.69
-- PPP daemon 2.2.0e
+- Kernel modules	 Broken: 1.3.57, Exp: 1.3.69f
+- PPP daemon		 Stable: 2.2.0e, Exp: 2.2.0f-BETA6
 - Dynamic linker (ld.so) 1.7.14
-- GNU CC 2.7.2
-- Binutils 2.6.0.12
-- Linux C Library 5.3.9
-- Linux C++ Library 2.7.1.4
-- Termcap 2.0.7
-- Procps 0.99a
-- Gpm 1.06
-- SysVinit 2.60
+- GNU CC		 2.7.2
+- Binutils		 2.6.0.12
+- Linux C Library	 Latest: 5.3.9, Stable: 5.2.18
+- Linux C++ Library	 2.7.1.4
+- Termcap		 2.0.7
+- Procps		 0.99a
+- Gpm			 1.06
+- SysVinit		 2.60
+- Util-linux		 2.5
 
 What you really need to upgrade
 *******************************
@@ -34,13 +38,13 @@
 ========
 
    The FIFO behavior is changed in latest 1.3.x kernel releases. You may
-upgrade to this version if the older version break.
+upgrade to 2.60 if the older version breaks.
 
 PPP daemon and utilities
 ========================
 
    To use the PPP protocol with the 1.3.x linux kernel, you need to
-upgrade the PPP package to version 2.2.0e.
+upgrade the PPP package to version 2.2.0e or the experimental 2.2.0f.
 
 Procps utilities
 ================
@@ -64,9 +68,9 @@
    The current Linux C Library release is 5.3.9. In this release there
 are some important changes that may break other programs, then read the
 `release.libc-5.3.9' file carefully!  You need to patch and recompile
-the `make' utility, or get it precompiled from the address written in
-the next section of this file.  If you don't want to patch and
-recompile the binaries you may try the release 5.2.18.
+the `make' utility, or get it precompiled from the address written at
+the end of this file.  If you don't want to patch and recompile the
+binaries you may try the release 5.2.18.
 
 The Termcap Library
 ===================
@@ -75,6 +79,212 @@
 read the `README' file contained into the package to get some important
 information about the `tgetent' function changes!
 
+Upgrading to 1.3.x kernel
+*************************
+
+   This section was prepared by Chris Ricker and based on material from
+the linux-kernel mailing list, Jared Mauch's web page "Software Victims
+of the 1.3 Kernel Development"
+(http://www2.nether.net/~jared/victim.html), and Axel Boldt's
+(boldt@math.ucsb.edu) Configure.help file, among other sources.
+
+   This section is intended primarily to help those that are new to the
+1.3.x series of Linux kernels.  In the ongoing effort to make a faster,
+better kernel and eventually achieve complete world domination, several
+features of the kernel have changed.  As a result, when you first
+upgrade to 1.3.x from 1.2.13, you will also have to upgrade several
+utilities that are closely associated with the kernel.
+
+Proc filesystem
+===============
+
+   Various changes in the /proc filesystem have been made, affecting ps,
+top, etc.  Running `top' or `ps -auwwx' will now give you a floating
+point exception. To fix the problem, upgrade to procps-0.99a.tar.gz,
+available at
+ftp://tsx-11.mit.edu/pub/linux/BETA/procps/procps-0.99a.tar.gz (or else
+don't run top or ps with fancy switches and live with the incorrect
+values ;-).
+
+Modules
+=======
+
+   1.3.x is almost completely modularized, and kerneld is now
+incorporated into the kernel.  To take advantage of this, you'll need
+the latest version of the module support apps.  The latest non-beta
+(works fine for me) is modules-1.3.57.tar.gz, and the latest beta is
+modules-1.3.69f.tar.gz.  These should be available at the same place
+you picked up your kernel (ftp://ftp.cc.gatech.edu/pub/linux/kernel/)
+and the home page is http://www.pi.se/blox/modules/index.html.  Note:
+If you try to load a module and get a message like
+
+   gcc2_compiled, undefined Failed to load module!  The symbols from
+kernel 1.3.foo don't match 1.3.foo
+
+   where foo is a number between 1 and 87, then it's time to upgrade
+module utilities from 1.3.57 to 1.3.69f (you'll only get this if you're
+running the latest binutils as well).  Another little tip:  you can't
+have both a.out *and* ELF support compiled as modules.  Otherwise, you
+get a nice Catch-22 when you try to run insmod to install a.out/ELF
+support so you can run insmod ;-).  If you have an all-ELF system, but
+need a.out for the occasional Netscape session, then you can do a.out
+support as a module.  Otherwise, you should probably leave it in the
+kernel.  Similarly, any partitions that you have to mount at startup
+have to have their necessary drivers compiled into the kernel, so don't
+get grandiose ideas about going completely modular and then forget to
+compile ext2fs support into your kernel ;-).
+
+PPP driver
+==========
+
+   The PPP driver was upgraded (and is still in somewhat of a a state of
+flux).  You need to be running a pppd from ppp-2.2.0.tar.gz or greater.
+The latest is 2.2.0e and is available at
+ftp://sunsite.unc.edu/pub/Linux/system/Network/serial/ppp-2.2.0e.tar.gz.
+
+Named pipes
+===========
+
+   Linux's handling of named pipes changed (it now does it The Right Way
+instead of the SunOS way ;-).  This broke some programs that depended
+on the SunOS behavior, most notably SysVinit.  If you're running 2.59
+or earlier, you will probably get a wierd error on shutdown in which
+your computer shuts down fine but "INIT: error reading initrequest" or
+words to that effect scroll across your screen hundreds of times.  To
+fix, upgrade to
+ftp://ftp.cistron.nl/pub/people/miquels/debian/sysvinit-2.60.tar.gz.
+
+Uugetty
+=======
+
+   Older uugettys will not allow use of a bidirectional serial line.  To
+fix this problem, upgrade to
+ftp://sunsite.unc.edu/pub/Linux/system/Serial/getty_ps-2.0.7h.tar.gz.
+
+Console
+=======
+
+   The Linux console type has changed.  If your setup is old enough that
+you have problems, you'll need to update your termcap.  To fix, add
+linux to one of the types in /etc/termcap or snoop around
+http://www.ccil.org/~esr/ncurses.html (reputedly the latest universal
+termcap maintainer).  You may also need to update terminfo by running
+the following as root:
+
+   ln -s /usr/lib/terminfo/l/linux /usr/lib/terminfo/c/console
+
+Hdparm
+======
+
+   Hdparm has been upgraded to take advantage of the latest features of
+the kernel drivers.  The latest can be found at
+ftp://sunsite.unc.edu/pub/Linux/kernel/patches/diskdrives/hdparm-2.7.tar.gz.
+
+IP Accounting
+=============
+
+   IP accounting has now been integrated into the kernel.  To use this,
+you'll need to get ipfwadm from ftp://ftp.xos.nl/pub/linux/ipfwadm.  Get
+ipfwadm-2.0beta2.tar.gz if your kernel is 1.3.66 or later.
+
+Networking
+==========
+
+   Some of the /proc/net entries have changed.  You'll need to upgrade
+to the latest net-tools in
+ftp://ftp.inka.de:/pub/comp/Linux/networking/net-tools.  The last
+official release there is net-tools-1.2.0.tar.gz, and the latest
+release is net-tools-1.3.6-BETA5.tar.gz.  If you need the upgrade, you
+probably need the latest beta release.
+
+xntpd
+=====
+
+   Older versions of xntpd will not work with the latest kernels.
+Upgrade to xntp3.5c.tar.Z, available from
+http://www.eecis.udel.edu/~ntp/.
+
+Sound driver
+============
+
+   The sound driver was upgraded in the 1.3.x kernels, breaking vplay.
+To fix this problem, get a new version of the sndkit from
+ftp://ftp.best.com/pub/front/tasd/snd-util-3.5.tar.gz
+
+tcsh
+====
+
+   If tcsh acts funny, get the source from
+ftp://tesla.ee.cornell.edu/pub/tcsh and add #define SYSMALLOC in
+config_f.h before recompiling tcsh.  Binaries can be found in
+ftp://sunsite.unc.edu/pub/Linux/system/Shells/ and a corrected one will
+probably wind up there eventually.
+
+Make
+====
+
+   If make no longer works, you need to read the release notes for the
+libc you upgraded to.  The latest libc and release notes can be found at
+ftp://tsx-11.mit.edu/pub/linux/packages/GCC.  This is NOT an error due
+to the kernel, though many people have mistakenly thought it is.  When
+you upgrade to libc-5.3.9, you have to patch make to get it to work.
+All of this is documented in the release notes with libc.
+
+Loop device
+===========
+
+   1.3.x kernels include loop device support which lets you mount a file
+as a file system, which can allow for all sorts of cool things like
+encrypted file systems and such.  To use it, you'll need a modified
+version of mount from
+ftp://ftp.win.tue.nl:/pub/linux/util/mount-2.5X.tar.gz and work on
+encrypted file system support can be found in
+ftp.funet.fi:/pub/OS/Linux/BETA/loop/des.1.tar.gz.
+
+Multiple device
+===============
+
+   Multiple device support (allowing you to group several partitions
+into one logical device) has also been added.  Check out
+ftp://sweet-smoke.ufr-info-p7.ibp.fr/pub/Linux/md034.tar.gz to try this
+out.
+
+Arp
+===
+
+   Arp daemon support has been added.  Check out
+http://www.loran.com/~layes/arpd/index.html for more info and a copy of
+arpd.
+
+Quota
+=====
+
+   Quota support has also been added.  You need to get
+ftp://sunsite.unc.edu/pub/Linux/system/Admin/quota_acct.tar.gz to enable
+quotas.  The version that is currently there does not compile, though I
+am uploading a patched one that will compile as I write this (look for
+quota-acct-modified.tgz).
+
+Please send info about any other packages that 1.3.x "broke" or about
+any new features of 1.3.x that require extra packages for use to Chris
+Ricker (gt1355b@prism.gatech.edu) or me.
+
+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.
+
+GNU CC: gcc -v and gcc --version
+PPP: pppd -h (wrong but it show the version)
+Libc: ls -l /lib/libc.so.5
+LibC++: ls -l /usr/lib/libg++.so
+Binutils: ld -v
+dld: ldd -v and ldd -V
+termcap: ls -l /lib/libtermcap.so.*
+modules: insmod -V
+procps: ps --version
+
 Where to get the files
 **********************
 
@@ -128,15 +338,18 @@
 Modules utilities
 =================
 
-The latest public release
+The latest public release:
 ftp://sunsite.unc.edu/pub/Linux/kernel/modules-1.3.57.tar.gz
-The latest experimental release
+The latest experimental release:
 http://www.pi.se/blox/
 
 PPP Daemon and utilities
 ========================
 
+The latest public release:
 ftp://sunsite.unc.edu/pub/Linux/system/Network/serial/ppp-2.2.0e.tar.gz
+The latest experimental release:
+ftp://ftp.sii.com/pub/linux/ppp-2.2/ppp-2.2.0f.BETA6.tar.gz
 
 Procps utilities
 ================
@@ -156,3 +369,9 @@
 ftp://sunsite.unc.edu/pub/Linux/Incoming/sysvinit-2.60.tar.gz
 Next location:
 ftp://sunsite.unc.edu/pub/Linux/system/Daemons/init/sysvinit-2.60.tar.gz
+
+Util-linux
+==========
+
+ftp://sunsite.unc.edu/pub/Linux/system/Misc/util-linux-2.5.tar.gz
+

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen, slshen@lbl.gov with Sam's (original) version
of this