| 1 |
COMPRESSED LOOPBACK DEVICE (cloop.o) |
|---|
| 2 |
============================================================================= |
|---|
| 3 |
|
|---|
| 4 |
DISCLAIMER: THE AUTHORS HEREBY DENY ANY WARRANTY FOR ANY DATA LOSS AND |
|---|
| 5 |
DAMAGE WHATSOEVER THAT MAY BE CAUSED DIRECTLY OR INDIRECTLY BY USING THIS |
|---|
| 6 |
SOFTWARE. THIS IS EXPERIMENTAL SOFTWARE. USE AT YOUR OWN RISK. |
|---|
| 7 |
|
|---|
| 8 |
This module is licensed under the GNU GENERAL PUBLIC LICENSE Version 2, as |
|---|
| 9 |
stated in the source. |
|---|
| 10 |
|
|---|
| 11 |
----------------------------------------------------------------------------- |
|---|
| 12 |
|
|---|
| 13 |
This is cloop, a Kernel module to add support for filesystem-independent, |
|---|
| 14 |
transparently decompressed, read-only block devices. |
|---|
| 15 |
|
|---|
| 16 |
Original Author: Paul 'Rusty' Russel |
|---|
| 17 |
Extensions & Bugfixes: Klaus Knopper (http://www.knopper.net/knoppix/) |
|---|
| 18 |
|
|---|
| 19 |
INSTALLATION: |
|---|
| 20 |
------------- |
|---|
| 21 |
|
|---|
| 22 |
make KERNEL_DIR=/path/to/linux-kernel/sources |
|---|
| 23 |
(as root) mkdir -p /lib/modules/misc && cp cloop.o /lib/modules/misc/ |
|---|
| 24 |
(as root) depmod -a |
|---|
| 25 |
(as root) mknod /dev/cloop b 240 0 |
|---|
| 26 |
(as root) mknod /dev/cloop1 b 240 1 |
|---|
| 27 |
... |
|---|
| 28 |
|
|---|
| 29 |
USAGE: |
|---|
| 30 |
------ |
|---|
| 31 |
|
|---|
| 32 |
Creating a compressed image: |
|---|
| 33 |
create_compressed_fs image blocksize > image.cloop_compressed |
|---|
| 34 |
|
|---|
| 35 |
blocksize must be a multiple of 512 bytes. Make sure you have enough |
|---|
| 36 |
swap to hold the entire compressed image in virtual memory! Use "-" |
|---|
| 37 |
as filename to read data from stdin, as in: |
|---|
| 38 |
|
|---|
| 39 |
mkisofs -r datadir | create_compressed_fs - 65536 > datadir.iso.compressed |
|---|
| 40 |
|
|---|
| 41 |
Mounting a compressed image (see above for device creation): |
|---|
| 42 |
insmod cloop.o file=/path/to/compressed/image |
|---|
| 43 |
mount -o ro -t whatever /dev/cloop /mnt/compressed |
|---|
| 44 |
|
|---|
| 45 |
Starting from cloop version 1.0, setting of cloop compressed files via |
|---|
| 46 |
losetup /dev/cloop1 /path/to/file |
|---|
| 47 |
is possible. cloop 1.0 uses 64bit pointers instead of 32bit, so cloop files |
|---|
| 48 |
are no longer limited to <= 4GB (uncompressed size). |
|---|
| 49 |
|
|---|
| 50 |
For more information, please refer to the sources. If you don't understand |
|---|
| 51 |
what all this is about, please DON'T EVEN ATTEMPT TO INSTALL OR USE THIS |
|---|
| 52 |
SOFTWARE. |
|---|
| 53 |
|
|---|
| 54 |
A download location for the currentmost version of this module |
|---|
| 55 |
has been provided at: http://www.knopper.net/knoppix/sources/ |
|---|
| 56 |
|
|---|
| 57 |
-Klaus Knopper 29.08.2003 <cloop@knopper.net> |
|---|
