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