August 1, 1997

Announcing the fourth update to MkLinux DR2.1.

The "DR2.1update4" update fixes some bugs and installs a few more
shared library packages.

The update is available for anonymous ftp from ftp.mklinux.apple.com:

	ftp://ftp.mklinux.apple.com/pub/Updates/DR2.1update4/

or our various mirror sites, in the directory:

    .../Updates/DR2.1update4/

(Please be patient with the mirror sites, it may take them some time to
 mirror the update)

*** IMPORTANT NOTES ****

General
-------

There are two parts to this update.  The first part is similar to previous
updates in that there is a new Microkernel, Linux Server, and Default
Pager.  The second part consists of more RPM (Redhat Package Manager)
packages containing shared libraries, and programs linked with those
shared libraries.  Both parts are required for completing this update.

The sources to these pieces, as well as the tools and instructions needed
to build them, are included for those of you interested.  However, there
is no requirement to rebuild these components in order to apply the update.


Upgrade Path
------------

This is an update to MkLinux DR2.1.  If you are still running MkLinux
DR2 or DR2 with updates, then you should upgrade to DR2.1 before applying
this update.

You may apply this update regardless of whether you applied previous
updates.  More specifically, you do not need to apply DR2.1update1,
DR2.1update2, or DR2.1update3 before you apply this update.  However,
there are special instructions for updating systems earlier than
DR2.1update3.

Here's a summary:

From:			To:				Valid:
-----			---				------
DR2.1update3	->	DR2.1update4			(YES)
DR2.1update2	->	DR2.1update4			(YES) *
DR2.1update1	->	DR2.1update4			(YES) *
DR2.1		->	DR2.1update4			(YES) *
DR2		->	DR2.1update4			(NO)

* NOTE: If you are updating from DR2.1, DR2.1update1, or DR2.1update2,
you will need to follow the "alternate" instructions at the bottom
of the "README.shared" document.


Bug Fixes
---------
We believe this update fixes the following bugs.

- Fixed a regression in update3, synchronous negotiation in mesh driver

- Fixed a hang that many people were seeing after kernel displays
  available memory.


Enhancements
------------

- The Linux server produces coredumps that work properly with GDB

- The Xwindows packages are now based on shared libraries

- XDM is very easy to set up now, just edit the file /etc/inittab
  and set the initdefault to 5.


Known Problems
--------------

If you use "startx" to start Xwindows, when you quit X the colors
of your screen will not be the familiar blue/white color.  You'll
need to type "screenrestore" to get back to the normal colors.


Quick Guide to Files Available in the DR2.1update4 Directory:
-------------------------------------------------------------

Required for the update:

      README
	contains this message.

      README.install
	How to install the Mach Kernel, Linux Server and Default Pager

      README.shared
	How to install the Shared Libraries and packages based on them

      Mach_Kernel.gz
      vmlinux.gz
      default_pager.gz
	The Mach Kernel, Linux Server, and Default Pager in gzipped
        (ie. compressed) form

      install_shlibs.u3u4
	A shell script used to install the Shared Libraries portion
	of DR2.1update4

      RPMS/ppc/*
	All the RPM packages that are part of this update

Optional Alternate files:

      Alternates/Mach_Kernel_alt.gz
	The Mach kernel, built with the older toolset.  Some people
	have had difficulty booting kernels built with the newer
	toolset.  This is the DR2.1update4 kernel, built on a
	DR2.1update2 system.  We are working on addressing these
	difficulties, and hopefully won't need to provide this
	"alternate" kernel in future updates.

      Alternates/install_shlibs.u2u4
	This is the script that you need to use if you are upgrading
	from a DR2.1, DR2.1update1, or DR2.1update2 system.  Useful if
	you don't have any shared libraries installed and you want
	to skip DR2.1update3

      Alternates/RPMS/ppc/*
	A bunch of symbolic links to the "real" rpms needed for
	the install_shlibs.u2u4 script

Optional sources and build tools:

      README.build
	How to build the Mach Kernel and/or Linux Server
	(along with some other tasks in the Microkernel tree, such as
	 the Default Pager)

      DR2.1update4.osfmk.src.tgz
	Sources to Mach Kernel in gzipped tar format.
	(to extract: tar -zxpf DR2.1update4.osfmk.src.tgz)

      DR2.1update4.osfmk.export.tgz
	The export/powermac directories, which contains the "exportable"
	pieces of the Microkernel build (include files and libraries)
	(to extract: tar -zxpf DR2.1update4.osfmk.export.tgz)

      DR2.1update4.mklinux.src.tgz
	Sources to the Linux Server update in gzipped tar format.
	(to extract: tar -zxpf DR2.1update4.mklinux.src.tgz)

      DR2.1update4.tools.tgz
	Various "Mach tools" that are needed to build both the microkernel
	and the Linux server.

      ode-bin.tgz
	OSF development environment tools that are needed to build the
	microkernel.

      SRPMS/*
	The Source RPMs used to build the RPM packages in this update