4.4BSD/usr/src/sbin/icheck/icheck.8

.\" Copyright (c) 1988, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" This module is believed to contain source code proprietary to AT&T.
.\" Use and redistribution is subject to the Berkeley Software License
.\" Agreement and your Software Agreement with AT&T (Western Electric).
.\"
.\"	@(#)icheck.8	8.1 (Berkeley) 6/5/93
.\"
.TH ICHECK 8 "June 5, 1993"
.UC 4
.SH NAME
icheck \- file system storage consistency check
.SH SYNOPSIS
.B icheck
[
.B \-b
numbers ]
[ filesystem ]
.SH DESCRIPTION
.B N.B.:
.I Icheck
is obsoleted for normal consistency checking by
.IR fsck (8).
.PP
.I Icheck
examines a file system,
builds a bit map of used blocks,
and compares this bit map against
the free map maintained on the file system.
If the file system is not specified,
a set of default file systems
is checked.
The normal output of
.I icheck
includes a report of
.IP ""
The total number of files and the numbers of
regular, directory, block special and character special files.
.IP ""
The total number of blocks in use and the numbers of 
single-, double-, and triple-indirect blocks and directory blocks.
.IP ""
The number of free blocks.
.IP ""
The number of blocks missing; i.e. not in any file
nor in any free map.
.PP
Following the
.B \-b
option is a list of block numbers;
whenever any of the named blocks turns up in a file,
a diagnostic is produced.
.PP
.I Icheck
is faster if the raw version of the special file is used,
since it reads the i-list many blocks at a time.
.SH FILES
Default file systems vary with installation.
.SH "SEE ALSO"
fsck(8), dcheck(8), ncheck(8),
fs(5), clri(8)
.SH DIAGNOSTICS
For duplicate blocks
and bad blocks (which lie outside the file system)
.I icheck
announces the difficulty, the i-number, and the kind of block involved.
If a read error is encountered,
the block number of the bad block is printed and
.I icheck
considers it to contain 0.
.SH BUGS
Since
.I icheck
is inherently two-pass in nature, extraneous diagnostics
may be produced if applied to active file systems.
.PP
It believes even preposterous super-blocks and
consequently can get core images.