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