Release files - Squashfs1.3r3
1.3r3 18 JAN 2004 Third release of 1.3, this adds a new mksquashfs option,
some bug fixes, and extra patches for new kernels
Signed-off-by: Phillip Lougher <phillip@squashfs.org.uk>
diff --git a/ACKNOWLEDGEMENTS b/ACKNOWLEDGEMENTS
index 4351d7d..597fc4b 100644
--- a/ACKNOWLEDGEMENTS
+++ b/ACKNOWLEDGEMENTS
@@ -46,3 +46,15 @@
Erik Andersen has made some nice suggestions, unfortunately, I have
not had time to implement anything.
+
+Artemiy I. Pavlov has written a useful LDP mini-howto for Squashfs
+(http://linuxdoc.artemio.net/squashfs).
+
+Yves Combe reported the Apple G5 bug, when using Squashfs for
+his PPC Knoppix-mib livecd project.
+
+Jaco Greeff (mklivecd project, and maintainer of the Mandrake
+squashfs-tools package) suggested the new mksquashfs -ef option, and the
+standalone build for mksquashfs.
+
+Mike Schaudies made a donation.
diff --git a/CHANGES b/CHANGES
index 7739a1c..3e4da32 100644
--- a/CHANGES
+++ b/CHANGES
@@ -68,3 +68,19 @@
(2.4.7) but it broke somewhere along the line since then,
3. New patch for Linux 2.4.22,
4. New patch for 2.6.0-test7, this replaces the patch for 2.6.0-test1.
+
+1.3r3 18 JAN 2004 Third release of 1.3, this adds a new mksquashfs option,
+ some bug fixes, and extra patches for new kernels
+
+ 1. New mksquashfs -ef exclude option. This option reads the exclude
+ dirs/files from an exclude file, one exclude dir/file per line. This
+ avoids the command line size limit when using the -e exclude option,
+ 2. When appending to existing filesystems, if mksquashfs experiences a
+ fatal error (e.g. out of space when adding to the destination), the
+ original filesystem is restored,
+ 3. Mksquashfs now builds standalone, without the kernel needing to be patched.
+ 4. Bug fix in the kernel squashfs filesystem, where the pages being
+ filled were not kmapped. This seems to only have caused problems
+ on an Apple G5,
+ 5. New patch for Linux 2.4.24,
+ 6. New patch for Linux 2.6.1, this replaces the patch for 2.6.0-test7.
diff --git a/INSTALL b/INSTALL
index e000c55..df2e7e4 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,32 +1,32 @@
INSTALLING SQUASHFS
-The squashfs1.3r2.tar.gz file contains this file, a README file,
+The squashfs1.3r3.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 five kernel patch directories depending on your linux kernel version.
-In each directory there are patches to provide squashfs1.3 release 2 support
+There are six kernel patch directories depending on your linux kernel version.
+In each directory there are patches to provide squashfs1.3 release 3 support
from a base kernel, and an incremental upgrade patch that upgrades a
-squashfs1.3 patched kernel to a squashfs1.3r2 kernel (except for 2.4.22 and
-2.6.0-test7).
+squashfs1.3r2 patched kernel to a squashfs1.3r3 kernel (except for 2.4.24 and
+2.6.1).
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/squashfs1.3r2-patch
+%patch -p1 < location-of-squashfs/linux-2.4.20/squashfs1.3r3-patch
-Where "location-of-squashfs" is the path to the squashfs1.3r2 source directory.
+Where "location-of-squashfs" is the path to the squashfs1.3r3 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/.
Once patched, the kernel must be reconfigured, with squashfs support turned on
(either Y/M) to ensure that inflate support is built into the kernel. The
squashfs kernel option can be found in the filesystems submenu of the
-configure menus. In the 2.6.0 kernel, the squashfs option is hiding in
+configure menus. In the 2.6.1 kernel, the squashfs option is hiding in
the new miscellaneous filesystems submenu near the bottom of the filesystems
submenu.
@@ -34,6 +34,7 @@
--------------------------
The squashfs-tools directory contains the mksquashfs program. This can be
-made by typing make. The Makefile assumes that the squashfs patched
-kernel is in /usr/src/linux. The program uses Large File Support
+made by typing make. The source files use a local copy of squashfs_fs.h
+(included in the kernel patches) allowing the tools to be made without needing
+to patch the kernel. The program uses Large File Support
(64 bit offsets etc.) and so a relatively recent glibc is needed.
diff --git a/RELEASE-README b/RELEASE-README
index 7ef092e..b919316 100644
--- a/RELEASE-README
+++ b/RELEASE-README
@@ -1,10 +1,10 @@
- SQUASHFS 1.3r2 - A squashed read-only filesystem for Linux
+ SQUASHFS 1.3r3 - A squashed read-only filesystem for Linux
- Copyright 2003 Phillip Lougher (phillip@lougher.demon.co.uk)
+ Copyright 2004 Phillip Lougher (phillip@lougher.demon.co.uk)
Released under the GPL licence (version 2 or later).
-Squashfs is currently at version 1.3 release 2. Please see the CHANGES file
+Squashfs is currently at version 1.3 release 3. Please see the CHANGES file
for recent changes to squashfs.
Squashfs is a highly compressed read-only filesystem for Linux.
@@ -57,7 +57,7 @@
will also append directories and files to pre-existing squashfs filesystems, see
the following 'appending to squashfs filesystems' subsection.
-SYNTAX:./mksquashfs source1 source2 ... dest [options] [-e list of exclude dirs/files]
+SYNTAX:mksquashfs source1 source2 ... dest [options] [-e list of exclude dirs/files]
Options are
-info print files written to filesystem
@@ -75,6 +75,7 @@
-check_data add checkdata for greater filesystem checks
-le create a little endian filesystem
-be create a big endian filesystem
+ -ef exclude file file is a list of exclude dirs/files - one per line
-version print version, licence and copyright message
Source1 source2 ... are the source directories/files containing the
@@ -139,23 +140,29 @@
filesystem exists on it, mksquashfs will append. The -noappend option will
write a new filesystem irrespective of whether an existing filesystem is present.
-The -e option allows files/directories to be specified which are
-excluded from the output filesystem. If an exclude file/directory is
-absolute (i.e. prefixed with /, ../, or ./) the entry is treated as
-absolute, however, if an exclude file/directory is relative, it is
-treated as being relative to each of the sources in turn, i.e.
+The -e and -ef options allow files/directories to be specified which are
+excluded from the output filesystem. The -e option takes the exclude
+files/directories from the command line, the -ef option takes the
+exlude files/directories from the specified exclude file, one file/directory
+per line. If an exclude file/directory is absolute (i.e. prefixed with /, ../,
+or ./) the entry is treated as absolute, however, if an exclude file/directory
+is relative, it is treated as being relative to each of the sources in turn,
+i.e.
%mksquashfs /tmp/source1 source2 output_fs -e ex1 /tmp/source1/ex2 out/ex3
Will generate exclude files /tmp/source1/ex2, /tmp/source1/ex1, source2/ex1,
/tmp/source1/out/ex3 and source2/out/ex3.
-The -e exclude option is usefully used in archiving the entire filesystem,
-where it is wished to avoid archiving /proc, and the filesystem being
-generated, i.e.
+The -e and -ef exclude options are usefully used in archiving the entire
+filesystem, where it is wished to avoid archiving /proc, and the filesystem
+being generated, i.e.
%mksquashfs / /tmp/root.sqsh -e proc /tmp/root.sqsh
+Multiple -ef options can be specified on the command line, and the -ef
+option can be used in conjuction with the -e option.
+
The -info option displays the files/directories as they are compressed and
added to the filesystem. The compression percentage achieved is printed, with
the original uncompressed size. If the compression percentage is listed as
