Annotation of cci/usr/src/man/man8/icheck.8, revision 1.1.1.1

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.