tests/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