4.4BSD snapshot (revision 8.1); add 1993 to copyright
[unix-history] / usr / src / sbin / icheck / icheck.8
CommitLineData
b91e3d7f
KB
1.\" Copyright (c) 1988, 1993
2.\" The Regents of the University of California. All rights reserved.
5fa428b1 3.\"
79c763b5
KB
4.\" %sccs.include.proprietary.roff%
5.\"
b91e3d7f 6.\" @(#)icheck.8 8.1 (Berkeley) %G%
5fa428b1 7.\"
46e11184 8.TH ICHECK 8 ""
5fa428b1
KM
9.UC 4
10.SH NAME
11icheck \- file system storage consistency check
12.SH SYNOPSIS
11aaec31 13.B icheck
5fa428b1 14[
5fa428b1
KM
15.B \-b
16numbers ]
17[ filesystem ]
18.SH DESCRIPTION
19.B N.B.:
20.I Icheck
21is obsoleted for normal consistency checking by
22.IR fsck (8).
23.PP
24.I Icheck
25examines a file system,
26builds a bit map of used blocks,
27and compares this bit map against
d1256f9e 28the free map maintained on the file system.
5fa428b1
KM
29If the file system is not specified,
30a set of default file systems
31is checked.
32The normal output of
33.I icheck
34includes a report of
35.IP ""
36The total number of files and the numbers of
37regular, directory, block special and character special files.
38.IP ""
39The total number of blocks in use and the numbers of
40single-, double-, and triple-indirect blocks and directory blocks.
41.IP ""
42The number of free blocks.
43.IP ""
44The number of blocks missing; i.e. not in any file
d1256f9e 45nor in any free map.
5fa428b1
KM
46.PP
47Following the
48.B \-b
49option is a list of block numbers;
50whenever any of the named blocks turns up in a file,
51a diagnostic is produced.
52.PP
53.I Icheck
54is faster if the raw version of the special file is used,
55since it reads the i-list many blocks at a time.
56.SH FILES
57Default file systems vary with installation.
58.SH "SEE ALSO"
59fsck(8), dcheck(8), ncheck(8),
e46678a9 60fs(5), clri(8)
5fa428b1
KM
61.SH DIAGNOSTICS
62For duplicate blocks
63and bad blocks (which lie outside the file system)
64.I icheck
65announces the difficulty, the i-number, and the kind of block involved.
66If a read error is encountered,
67the block number of the bad block is printed and
68.I icheck
69considers it to contain 0.
5fa428b1
KM
70.SH BUGS
71Since
72.I icheck
73is inherently two-pass in nature, extraneous diagnostics
74may be produced if applied to active file systems.
75.PP
76It believes even preposterous super-blocks and
77consequently can get core images.