Release files - Squashfs2.2

2.2	3 JUL 2005	This release has some small improvements, bug fixes
			and patches for new kernels.

Signed-off-by: Phillip Lougher <phillip@squashfs.org.uk>

3 files changed, 57 insertions, 11 deletions

diff --git a/CHANGES b/CHANGES
index 7266028..c5d371e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,5 +1,31 @@
 			SQUASHFS CHANGE LOG
  
+2.2	3 JUL 2005	This release has some small improvements, bug fixes
+			and patches for new kernels.
+
+	1. Sort routine re-worked and debugged from release 2.1.  It now allows
+	   you to give Mkisofs style sort files and checks for filenames that
+	   don't match anything.  Sort priority has also been changed to
+	   conform to Mkisofs usage, highest priority files are now placed
+	   at the start of the filesystem (this means they will be on the
+	   inside of a CD or DVD).
+	2. New Configure options for embedded systems (memory constrained
+	   systems).  See INSTALL file for further details.
+	3. Directory index bug fixed where chars were treated as signed on
+           some architectures.  A file would not be found in the rare case
+	   that the filename started with a chracter greater than 127.
+	4. Bug introduced into the read_data() routine when sped up to use data
+	   block queueing fixed.  If the second or later block resulted in an
+	   I/O error this was not checked.
+	5. Append bug introduced in 2.1 fixed.  The code to compute the new
+	   compressed and uncompressed directory parts after appending was
+	   wrong.
+	6. Metadata block length read routine altered to not perform a
+	   misaligned short read.  This was to fix reading on an ARM7 running
+	   uCLinux without a misaligned read interrupt handler.
+	7. Checkdata bug introduced in 2.1 fixed.
+	
+
 2.1-r2  15 DEC 2004	Code changed so it can be compiled with gcc 2.x
 
 	1.  In some of the code added for release 2.1 I unknowingly used some
diff --git a/INSTALL b/INSTALL
index 4a907b0..34626b4 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,23 +1,23 @@
 			INSTALLING SQUASHFS
 
-The squashfs2.1-r2.tar.gz file contains this file, a README file,
+The squashfs2.2.tar.gz file contains this file, a README file,
 an ACKNOWLEDGEMENTS file, a CHANGES file, the squashfs patch
 directories/files, and the squashfs-tools directory (mksquashfs).
 
 1. Patching the kernel
 ----------------------
 
-There are ten kernel patch directories depending on your linux kernel version.
-If your kernel version isn't listed then try the patch for the nearest kernel
-listed.
+There are twelve kernel patch directories depending on your linux kernel
+version.  If your kernel version isn't listed then try the patch for the nearest
+kernel listed.
 
 To patch your kernel, cd into the top level directory, and run the "patch"
 comand, e.g. assuming linux-2.4.20
 
 %cd /usr/src/linux-2.4.20
-%patch -p1 < location-of-squashfs/linux-2.4.20/squashfs2.1-patch
+%patch -p1 < location-of-squashfs/linux-2.4.20/squashfs2.2-patch
 
-Where "location-of-squashfs" is the path to the squashfs2.1 source directory.
+Where "location-of-squashfs" is the path to the squashfs2.2 source directory.
 
 The squashfs patches patch the relevant kernel files to add configure support,
 initrd support, include files, and the squashfs directory under linux/fs/.
@@ -28,6 +28,27 @@ configure menus.  In the 2.6.x kernels, the squashfs option is hiding in
 the new miscellaneous filesystems submenu near the bottom of the filesystems
 submenu.
 
+In SquashFS 2.2 there are a new set of options which are intended for use by
+embedded systems with low memory.  At the "Additional options for
+memory-constrained systems" prompt, please say NO unless you know what you're
+doing!  Saying Y here allows you to specify cache sizes and how Squashfs
+allocates memory.
+
+The "Number of fragments cached" prompt allows the number of fragments cached
+to be controlled.  By default SquashFS caches the last 3 fragments read from
+the filesystem.  Increasing this amount may mean SquashFS has to re-read
+fragments less often from disk, at the expense of extra system memory.
+Decreasing this amount will mean SquashFS uses less memory at the expense of
+extra reads from disk.  Note there must be at least one cached fragment.
+Anything much more than three will probably not make much difference.
+
+The "Use Vmalloc rather than Kmalloc" prompt allows you to tell SquashFS to
+use Vmalloc.  By default SquashFS uses kmalloc to obtain fragment cache memory.
+Kmalloc memory is the standard kernel allocator, but it can fail on memory
+constrained systems.  Because of the way Vmalloc works, Vmalloc can succeed
+when kmalloc fails.  Specifying this option will make SquashFS always use
+Vmalloc to allocate the fragment cache memory.
+
 2. Building squashfs tools
 --------------------------
 
diff --git a/RELEASE-README b/RELEASE-README
index f08d9aa..c097947 100644
--- a/RELEASE-README
+++ b/RELEASE-README
@@ -1,12 +1,11 @@
-	SQUASHFS 2.1 - A squashed read-only filesystem for Linux
+	SQUASHFS 2.2 - A squashed read-only filesystem for Linux
 
-	Copyright 2004 Phillip Lougher (plougher@users.sourceforge.net)
+	Copyright 2005 Phillip Lougher (phillip@lougher.demon.co.uk)
 
 	Released under the GPL licence (version 2 or later).
 
-Welcome to Squashfs version 2.1-r2.  Significant improvements to
-directory handling and numerous other smaller improvements have been made.
-Please see the README-2.1 and CHANGES files for further details.
+Welcome to Squashfs version 2.2.  Please see the CHANGES file for details
+of changes.
 
 Squashfs is a highly compressed read-only filesystem for Linux.
 It uses zlib compression to compress both files, inodes and directories.