diff --git a/LDP/howto/docbook/HOWTO-INDEX/adminSect.sgml b/LDP/howto/docbook/HOWTO-INDEX/adminSect.sgml index 528f8b9e..138fc066 100644 --- a/LDP/howto/docbook/HOWTO-INDEX/adminSect.sgml +++ b/LDP/howto/docbook/HOWTO-INDEX/adminSect.sgml @@ -302,7 +302,7 @@ How to reject junk mail in incoming SMTP transactions. SquashFS-HOWTO, SquashFS HOWTO -Updated: Jan 2008. +Updated: Jul 2008. Describes the usage of SquashFS - a highly-compressed file system for Linux, which is intended for use in tiny/embedded Linux systems, as well as for read-only archiving and general diff --git a/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml b/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml index d022a47d..139d9264 100644 --- a/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml +++ b/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml @@ -4261,7 +4261,7 @@ describes some of the available software. SquashFS-HOWTO, SquashFS HOWTO -Updated: Jan 2008. +Updated: Jul 2008. Describes the usage of SquashFS - a highly-compressed file system for Linux, which is intended for use in tiny/embedded Linux systems, as well as for read-only archiving and general diff --git a/LDP/howto/docbook/HOWTO-INDEX/osSect.sgml b/LDP/howto/docbook/HOWTO-INDEX/osSect.sgml index b0c9cd17..6919c8d1 100644 --- a/LDP/howto/docbook/HOWTO-INDEX/osSect.sgml +++ b/LDP/howto/docbook/HOWTO-INDEX/osSect.sgml @@ -896,7 +896,7 @@ been deleted. SquashFS-HOWTO, SquashFS HOWTO -Updated: Jan 2008. +Updated: Jul 2008. Describes the usage of SquashFS - a highly-compressed file system for Linux, which is intended for use in tiny/embedded Linux systems, as well as for read-only archiving and general diff --git a/LDP/howto/docbook/SquashFS-HOWTO/SquashFS-HOWTO.xml b/LDP/howto/docbook/SquashFS-HOWTO/SquashFS-HOWTO.xml index 91a4d70d..74b7bd63 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/SquashFS-HOWTO.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/SquashFS-HOWTO.xml @@ -8,6 +8,7 @@ + ]> @@ -22,8 +23,8 @@ I. Pavlov - ArtemioLabs -
ap (at) artemio (dot) net
+ Sinevibes +
@@ -33,7 +34,7 @@ Cecchetti -
mrc (dot) ildp (at) gmail (dot) com
+
mrc (dot) ildp (dot) com
 @@ -75,7 +76,14 @@ - + + 1.9 + 2008-07-24 + + Text corrections. + + + 1.8 2008-01-06 @@ -157,5 +165,6 @@ &chapter3; &chapter4; &chapter5; +&chapter6; diff --git a/LDP/howto/docbook/SquashFS-HOWTO/chapter1.xml b/LDP/howto/docbook/SquashFS-HOWTO/chapter1.xml index 7c047f35..ece0a9bb 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/chapter1.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/chapter1.xml @@ -42,36 +42,36 @@ parameter is different in these release trees, it will be written as follows: -Data, inodes and directories are compressed - +Data, inodes and directories are compressed + -SquashFS stores full uid/gids (32 bits), and file creation time - +SquashFS stores full uid/gids (32 bits), and file creation time + -Files up to 2^64 bytes are supported; file systems can be up to 2^64 bytes - +Files up to 2^64 bytes are supported; file systems can be up to 2^64 bytes + -Inode and directory data are highly compacted, and packed on byte +Inode and directory data are highly compacted, and packed on byte boundaries; each compressed inode is on average 8 bytes in length (the exact length varies on file type, i.e. regular file, directory, symbolic link, and block/character device inodes have different sizes) - + -SquashFS can use block sizes up to up to 64 Kb (2.x) and 1Mb (3.x). The default size is 128Kb (3.x), which achieves +SquashFS can use block sizes up to up to 64 Kb (2.x) and 1Mb (3.x). The default size is 128Kb (3.x), which achieves greater compression ratios than the normal 4K block size - + -By the 2.x release it was introduced the concept of fragment blocks: +By the 2.x release it was introduced the concept of fragment blocks: an ability to join multiple files smaller than block size into a single block, achieving greater compression ratios - + -File duplicates are detected and removed - +File duplicates are detected and removed + -Both big and little endian architectures are supported; SquashFS can +Both big and little endian architectures are supported; SquashFS can mount file systems created on different byte-order machines - + @@ -90,21 +90,21 @@ consists of the following steps: -Patching and recompiling the target Linux kernel to enable SquashFS support - +Patching and recompiling the target Linux kernel to enable SquashFS support + -Compiling the mksquashfs and the unsquashfs tools - +Compiling the mksquashfs and the unsquashfs tools + -Creating a compressed file system with mksquashfs - +Creating a compressed file system with mksquashfs + -Testing: mounting a squashed file system to a temporary location - +Testing: mounting a squashed file system to a temporary location + -Modifying the /etc/fstab or startup scripts of +Modifying the /etc/fstab or startup scripts of your target Linux system to mount the new squashed file system when needed - + diff --git a/LDP/howto/docbook/SquashFS-HOWTO/chapter2.xml b/LDP/howto/docbook/SquashFS-HOWTO/chapter2.xml index b5dfa3a5..38d6aa24 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/chapter2.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/chapter2.xml @@ -88,7 +88,7 @@ will be given relative to /usr/src/linux. - + Compiling a 2.6.x kernel @@ -108,32 +108,32 @@ will be given relative to /usr/src/linux. - + In the File systems section, Miscellaneous file systems subsection, enable the Squashed filesystem option, whether as module or bundled with the kernel. It is only obligatory to compile SquashFS inside the kernel if you plan using squashed initial RAM disks (initrd). - + - + In the same subsection, "do NOT" enable the Additional option for memory-constrained system, unless you are configuring your kernel for an embedded system. - + - + If you would like to use a squashed initial RAM disk, enable the Initial RAM disk support in the Device drivers section, Block devices subsection. - + - + If you want to be able to mount the squashed file system via a loopback device in future, you should enable Loopback device support in the Device drivers section, Block devices subsection. - + @@ -145,7 +145,7 @@ If you want to be able to mount the squashed file system via a loopbac - + Compiling a 2.4.x kernel @@ -157,24 +157,24 @@ If you want to be able to mount the squashed file system via a loopbac - + In the File systems section, enable the Squashed filesystem option, whether as module or bundled with the kernel. It is only obligatory to compile SquashFS inside the kernel if you plan using squashed initial RAM disks (initrd). - + - + If you would like to use a squashed initial RAM disk, enable the Initial RAM disk support in the Block devices section. - + - + If you want to be able to mount the squashed file system via a loopback device in future, you should enable Loopback device support in the Block devices section. - + @@ -250,8 +250,8 @@ this means you have successfully enabled SquashFS in your kernel. Compiling the SquashFS tools -Now you need to compile mksquashfs - the tool for creating squashed file systems and -unsquashfs, which extracts files from an existing squashed file system. +Now you need to compile mksquashfs - the tool for creating squashed file systems and the +unsquashfs which extracts files from an existing squashed file system. @@ -278,7 +278,7 @@ If everything went fine, typing mksquashfs or unsqua Installing SquashFS on Debian -If you use Debian (or another Linux distribution) you may want to get SquashFS module and tools from the distro repositories. With Debian you have to install the proper kernel module and the tools with the following commands: +If you use Debian (or onother Linux distribution) you may want to get SquashFS module and tools from the distro repositories. With Debian you have to install the proper kernel module and the tools with the following commands: @@ -286,9 +286,7 @@ If everything went fine, typing mksquashfs or unsqua - bash# apt-get install squashfs-modules-2.6-486 - - bash# apt-get install squashfs-tools + bash# apt-get install squashfs-modules-2.6-486 squashfs-tools Now load the squashfs module for the Linux kernel and if it was correctly loaded you should find it in the relative list @@ -304,7 +302,7 @@ If everything went fine, typing mksquashfs or unsqua -Then you have to add the squashfs module to /etc/modules file if you need it loaded at boot time. +Then you have to add the squashfs module to /etc/modules if you need it loaded at boot time. @@ -312,7 +310,7 @@ Then you have to add the squashfs module to /etc/modules file if you need it loa -Note that at the time of writing, the Debian packages (Etch. 4.0 r2) relates to squashfs 3.1 release. Some latest options and features of 3.3 release may be not supported. Look at the next section for details. +Note that at the time of writing, the Debian packages (Etch. 4.0 r2) relates to squashfs 3.1 release. Some latest options and features of 3.2 release may be not supported. Look at the next section for details. diff --git a/LDP/howto/docbook/SquashFS-HOWTO/chapter3.xml b/LDP/howto/docbook/SquashFS-HOWTO/chapter3.xml index 9124e7f0..2e2c6c1f 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/chapter3.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/chapter3.xml @@ -20,14 +20,14 @@ systems. The general command-line format for mksquashfs is: -source1, source2, etc.: files and directories to be +source1, source2, etc.: files and directories to be added to the resulting file system, given with relative and/or absolute paths - + -destination: a regular file (filesystem +destination: a regular file (filesystem image file), or a block device (such as /dev/fd0 or /dev/hda3) where you want to have your squashed file system - + @@ -37,39 +37,39 @@ Notes for default mksquashfs behavior: - + When the new files are added to the new file system or appended to an existing one, mksquashfs will automatically rename files with duplicate names: if two or more files named text will appear in the same resulting directory, the second file will be renamed to text_1, third one to text_2 and so on. - + - + Duplicate files will be removed, so there will be only one physical instance (By the SquashFS 2.x, you can disable the detection/removal of the duplicates with the -no-duplicates option). - + - + If destination has a pre-existing SquashFS file system on it, by default, the new source items will be appended to the existing root directory. Examine the options table below to force mksquashfs to overwrite the whole destination and/or change the way new source items are added. - + - + If a single source file or directory is given, it becomes the root in a newly created file system. If two or more source files and/or directories are given, they will all become sub-items in the root of the new file system. - + - + The resulting filesystem will be padded to a multiple of 4 Kb: this is required for filesystems to be used on block devices. If you are very sure -you don't need this, use the -nopad option to disable this +you don't ned this, use the -nopad option to disable this operation. - + @@ -260,7 +260,7 @@ and [name] directory will contain all pre-existing files/directories -write-queue [size] --write-queue [size] (3.x) +set output queue to [size] Mb (3.x) @@ -305,9 +305,9 @@ unsquashfs [options] target [files/directories to extract] - + target is the squashed file system to extract. - + @@ -316,20 +316,20 @@ Notes for unsquashfs behavior: - -Not specifying any destination path, unsquashfs extracts the compressed file system in the + +By not specifying any destination path, unsquashfs extracts the compressed file system in the ./squashfs-root directory. - + - + The tool does not extract a squashed file system on already exsisting directory unless the -f option is specified. - + - + You can specify on the command line, a multiple number of files/directories to extract and the items to be extracted can be also be given in a file with -e [file] option. - + @@ -393,7 +393,7 @@ All possible options for unsquashfs are shown in the table be -s[tat] -display file system's superblock informations (it can discover the file system version and the options used to compress it - 3.3) +display file system's superblock informations (it can discover the file system version and the options used to compress it) (3.3) @@ -402,7 +402,7 @@ All possible options for unsquashfs are shown in the table be --r[egex] +-r[egex] treat extract names as POSIX regular expressions (3.3) diff --git a/LDP/howto/docbook/SquashFS-HOWTO/chapter4.xml b/LDP/howto/docbook/SquashFS-HOWTO/chapter4.xml index de52e565..3dcbc803 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/chapter4.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/chapter4.xml @@ -291,18 +291,18 @@ will be used in live CDs (just as an example). For this purpose SquashFS is also - + Enable SquashFS in the linux kernel of the target system - + - + Create a squashed root file system - + - + Modify the /etc/fstab or startup scripts of the target system to mount the squashd file system when you need it - + @@ -326,7 +326,7 @@ for these exclusions). As mentioned, another interesting use for SquashFS is with Unionfs filesystem, which provides copy-on-write semantics for the read-only file systems, enahancing the possibilities. (For unionfs you can -look at http://www.filesystems.org/project-unionfs.html, the Project site) +look at http://www.filesystems.org/project-unionfs.html) @@ -360,7 +360,7 @@ bash# mount -t unionfs -o dirs=rw.fs=rw:/mnt=ro unionfs user1 -As you can see now you can apparently create new files in /home/user1. +As you can see, now you can create new files in /home/user1. @@ -384,7 +384,7 @@ bash# ls /home/rw.fs -You can see that the new file1 was created in /home/rw.fs that's the phisical location of the real writeble branch of the "merged" file system. +You can see that the new file1 was created in /home/rw.fs @@ -426,7 +426,7 @@ at boot time. /home/ro.fs /mnt squashfs loop 0 0 unionfs /home/user1 unionfs dirs=/home/rw.fs=rw:/mnt=ro 0 0 - - + + diff --git a/LDP/howto/docbook/SquashFS-HOWTO/chapter5.xml b/LDP/howto/docbook/SquashFS-HOWTO/chapter5.xml index 3784a158..ad9e9f81 100644 --- a/LDP/howto/docbook/SquashFS-HOWTO/chapter5.xml +++ b/LDP/howto/docbook/SquashFS-HOWTO/chapter5.xml @@ -10,57 +10,37 @@ I would like to express my sincere thanks and immeasurable respect to: - + Phillip Lougher - for his brilliant work under squashfs, for creating an exculsive patch for linux-2.4.18, for his help with polishing this howto and answers to my mails - + - + Tabatha Marshall at TLDP for helping me with bringing this HOWTO to the final 1.0 release - + - + Everybody at The Linux Documentation Project for their great work under all the HOWTOs and guides that helped me a lot with exploring and hacking Linux - + - + All those at the TLDP mailing lists who helped me with getting started - + - + Endless thanks and respect to everybody who develops open-source software - + +Artemiy I. Pavlov -Artemiy I. Pavlov - +I want to thank Artemiy for his patience answering my emails, allowing me to work to this howto. I would express also my thanks and respect to everybody who is involved in free software +Marco Cecchetti - - - -I want to thank Artemiy for his patience answering my emails allowing me to work to this howto. -I would express also my thanks and respect to everybody who is involved in free software. - - - -Marco Cecchetti - - -License - - -This document may be used and distributed under the terms and conditions set forth in -the Open Content licence. In short, this means that you can freely modify and re-distribute -the HOWTO under the main condition that you keep the author and copyright the article along. -The full text of the licence is available at http://www.opencontent.org/opl.shtml - - -