home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man8 / icheck.8 < prev    next >
Encoding:
Text File  |  1975-06-26  |  2.7 KB  |  106 lines

  1. .th ICHECK VIII 2/9/75
  2. .sh NAME
  3. icheck \*- file system storage consistency check
  4. .sh SYNOPSIS
  5. .bd icheck
  6. [
  7. .bd \*-s
  8. ]  [
  9. .bd \*-b
  10. numbers ]
  11. [ filesystem ]
  12. .sh DESCRIPTION
  13. .it Icheck
  14. examines a file system,
  15. builds a bit map of used blocks,
  16. and compares this bit map against
  17. the free list maintained on the file system.
  18. If the file system is not specified,
  19. a set of default file systems
  20. is checked.
  21. The normal output of
  22. .it icheck
  23. includes a report of
  24. .s3
  25. .lp +4 0
  26. The number of blocks missing; i.e. not in any file
  27. nor in the free list,
  28. .lp +4 0
  29. The number of special files,
  30. .lp +4 0
  31. The total number of files,
  32. .lp +4 0
  33. The number of large and huge files,
  34. .lp +4 0
  35. The number of directories,
  36. .lp +4 0
  37. The number of indirect blocks,
  38. and the number of double-indirect blocks in huge files,
  39. .lp +4 0
  40. The number of blocks used in files,
  41. .lp +4 0
  42. The number of free blocks.
  43. .s3
  44. .i0
  45. The
  46. .bd \*-s
  47. flag causes
  48. .it icheck
  49. to ignore the actual free list and reconstruct a new one
  50. by rewriting the super-block of the file system.
  51. The file system should be dismounted while this is done;
  52. if this is not possible (for example if
  53. the root file system has to be salvaged)
  54. care should be taken that the system is quiescent and that
  55. it is rebooted immediately afterwards so that the old, bad in-core
  56. copy of the super-block will not continue to be used.
  57. Notice also that
  58. the words in the super-block
  59. which indicate the size of the free list and of the
  60. i-list are believed.
  61. If the super-block has been curdled
  62. these words will have to be patched.
  63. The
  64. .bd \*-s
  65. flag
  66. causes the normal output reports to be suppressed.
  67. .s3
  68. Following the
  69. .bd \-b
  70. flag is a list of block numbers;
  71. whenever any of the named blocks turns up in a file,
  72. a diagnostic is produced.
  73. .s3
  74. .it Icheck
  75. is faster if the raw version of the special file is used,
  76. since it reads the i-list many blocks at a time.
  77. .sh FILES
  78. Currently, /dev/rrk2
  79. and /dev/rrp0
  80. are the default file systems.
  81. .sh "SEE ALSO"
  82. dcheck (VIII), ncheck (VIII),
  83. fs (V), clri (VIII), restor(VIII)
  84. .sh DIAGNOSTICS
  85. For duplicate blocks
  86. and bad blocks (which lie outside the file system)
  87. .it icheck
  88. announces the difficulty, the i-number, and the kind of block involved.
  89. If a read error is encountered,
  90. the block number of the bad block is printed and
  91. .it icheck
  92. considers it to contain 0.
  93. ``Bad freeblock'' means that
  94. a block number outside the available space was encountered in the free list.
  95. ``\fIn\fR dups in free''
  96. means that \fIn\fR blocks were found in the free list which
  97. duplicate blocks either in some file or in the earlier part of the free list.
  98. .sh BUGS
  99. Since
  100. .it icheck
  101. is inherently two-pass in nature, extraneous diagnostics
  102. may be produced if applied to active file systems.
  103. .br
  104. It believes even preposterous super-blocks and
  105. consequently can get core images.
  106.