IBM's Journaled File System (JFS) for Linux version 1.1.1

Team members
Steve Best        sbest@us.ibm.com
Dave Kleikamp     shaggy@asutin.ibm.com
Barry Arndt       barndt@us.ibm.com
Christoph Hellwig hch@infradead.org

Release December 17, 2002 (version 1.1.1)

JFS is supported on 2.4.3 or newer kernels.  The 2.2 branch of the JFS
source tree is no longer supported.  JFS has been incorporated into the
2.5.6 and 2.4.20 linux (kernel.org) kernels.  

		UPDATING LINUX-2.4.* TO THE LATEST JFS RELEASE
		---------------------------------------------

JFS requires a few small changes to the kernel source tree in addition
the the "core" jfs files which reside in linux/fs/jfs.  Updating the
kernel source to the most recent release of JFS consists of one or two
steps.

STEP 1: patch "non-core" kernel files
-------------------------------------

If the kernel already contains some version of JFS, the non-core files
will already be compatible with the JFS core code.  You can precede to
step 2.

If applying JFS to the kernel source for the first time, that is, to a
kernel which does not contain an older version of JFS, choose the the
kernel patch which most closely matches your kernel and apply it using
the patch command:

jfs-2.4.3-patch		Apply to 2.4.2-ac2 - 2.4.4 kernel
jfs-2.4.5-patch		Apply to 2.4.5 or 2.4.6 kernel
jfs-2.4.7-patch		Apply to 2.4.7 - 2.4.16 kernel
jfs-2.4.17-patch	Apply to 2.4.17 kernel
jfs-2.4.18-patch	Apply to 2.4.18 kernel
jfs-2.4.19-patch	Apply to 2.4.19 kernel

Step 2: update "core" JFS files
-------------------------------

The core JFS files are most easily updated by untarring them from
jfs-2.4-VERSION.tar.gz.

Alternately, the most up-to-date JFS source can be obtained via CVS.
There is an anonymous cvs access available for the JFS tree. The steps
below are what is needed to pull the JFS CVS tree from the oss.software.ibm.com
server.

id anoncvs
password anoncvs

To checkout 2.4.x series of the JFS files do the following:
CVSROOT should be set to :pserver:anoncvs@oss.software.ibm.com:/usr/cvs/jfs
cvs checkout linux24

Example:
--------

To apply the JFS patch to the 2.4.18 kernel in /usr/src/linux-2.4.18:

cd /usr/src/linux-2.4.18
patch -p1 < /path/to/jfs-2.4.18-patch
tar -xzf /path/to/jfs-2.4-VERSION.tar.gz

For those keeping up-to-date with the latest released JFS code, an
incremental patch, jfs-2.4-PREV_VER-to-VERSION.patch.gz is also
available.