1These images contain various forms of corrupted filesystem which
2e2fsck will correct.  They are used as a regression test for e2fsck.
3
4The test_script program will automatically run e2fsck against the
5filesystem images.  It will run them two times, and display the exit
6status for each run.  The meaning of the exit status codes are as
7follows:
8
9	0		No filesystem errors were detected
10	1		Filesystem errors detected, but corrected
11	2		System should be rebooted
12	4		Filesystem errors left uncorrected
13	8		Operational error (generally means internal error,
14				or filesystem error that the e2fsck was not
15				prepared to deal with)
16	16		Usage or syntax error
17
18During the regression test, the first exit code should be 1, and the
19second exit code should be 0.  In other words, all (with one
20exception) of the test filesystems in this directory have some sort of
21filesystem corruption, which e2fsck should fix on the first pass.
22After the first pass, e2fsck should leave a fully consistent
23filesystem with no detectable errors found in the second pass.  The
24exception is the okgroup.img filesystem, which contains no errors, and
25so both exit codes should be 0.
26
27NOTE: It appears that at least some versions of the original e2fsck do
28not exit with an exit status code of 1 after correcting filesystem
29errors.  So if you modify the test_script to try running these
30filesystems against the original e2fsck, you will have to inspect the
31test_script.log file manually.
32
33--------------------------------------------------------------
34Here's a one-line descriptons of the various test images in this
35directory:
36
37baddir.img		Filesystem with a corrupted directory
38badbblocks.img		Filesystem with illegal blocks in the bad block inode.
39badinode.img		Filesystem with various different corrupted inode
40				entries.
41badlkcnt.img		Filesystem with deleted files with non-zero link count
42badroot.img		Filesystem with a file for a root directory
43badtable.img		Filesystem with blocks shared between the bitmaps and
44				inode table blocks and the bad block inode
45bbfile.img		Filesystem with files containing bad blocks
46bitmaps.img		Filesystem with corrupted inode and block bitmaps
47dirlink.img		Filesystem with a hard link to a directory
48dup.img			Filesystem with blocks claimed by two different files
49dup2.img		Filesystem with blocks claimed by three different files
50dupfsblks.img		Filesystem with blocks claimed by a file and
51				inode/block bitmaps and inode tables
52dupsuper.img		Filesystem with blocks claimed by a file and
53				the superblock / group descriptors
54end-bitmap.img		Filesystem with corruption at the end of the block 
55				bitmap
56expand.img		Tests e2fsck's ability to expand lost+found if 
57				necessary
58lpf.img			Filesystem with disconnected files and no /lost+found 
59				directory
60mke2fs2b.img		Filesystem with corruption similar to that
61				created by mke2fs version 0.2b
62noroot.img		Filesystem with a deleted root directory
63okgroup.img		Filesystem that's exactly 8193 blocks long 
64				(otherwise OK)
65overfsblks.img		Filesystem with overlapping inode and block bitmaps
66symlinks.img		Filesystem with bad symlink sizes
67
68
69