Commit | Line | Data |
---|---|---|
cf524f39 KM |
1 | .\" Copyright (c) 1980 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
9bf6dd29 | 5 | .\" @(#)dcheck.8 6.1 (Berkeley) %G% |
cf524f39 | 6 | .\" |
9bf6dd29 | 7 | .TH DCHECK 8 "" |
cf524f39 KM |
8 | .UC 4 |
9 | .SH NAME | |
10 | dcheck \- file system directory consistency check | |
11 | .SH SYNOPSIS | |
12 | .B /etc/dcheck | |
13 | [ | |
14 | .B \-i | |
15 | numbers ] | |
16 | [ filesystem ] | |
17 | .SH DESCRIPTION | |
18 | .B N.B.: | |
19 | .I Dcheck | |
20 | is obsoleted for normal consistency checking by | |
21 | .IR fsck (8). | |
22 | .PP | |
23 | .I Dcheck | |
24 | reads the directories in a file system | |
25 | and compares | |
26 | the link-count in each i-node with the number of directory | |
27 | entries by which it is referenced. | |
28 | If the file system is not specified, | |
29 | a set of default file systems | |
30 | is checked. | |
31 | .PP | |
32 | The | |
33 | .B \-i | |
34 | flag | |
35 | is followed by a list of i-numbers; | |
36 | when one of those i-numbers turns up | |
37 | in a directory, | |
38 | the number, the i-number of the directory, | |
39 | and the name of the entry are reported. | |
40 | .PP | |
41 | The program is fastest if the | |
42 | raw version of the special file is used, | |
43 | since the i-list is read in large chunks. | |
44 | .SH FILES | |
45 | Default file systems vary with installation. | |
46 | .SH "SEE ALSO" | |
15be7965 | 47 | fsck(8), icheck(8), fs(5), clri(8), ncheck(8) |
cf524f39 KM |
48 | .SH DIAGNOSTICS |
49 | When a file turns up for which the link-count and the number | |
50 | of directory entries disagree, | |
51 | the relevant facts are reported. | |
52 | Allocated files which have 0 link-count and no entries are also | |
53 | listed. | |
54 | The only dangerous situation | |
55 | occurs when there are more entries than links; | |
56 | if entries are removed, | |
57 | so the link-count drops to 0, | |
58 | the remaining entries point to thin air. | |
59 | They should be removed. | |
60 | When there are more links than entries, or there is | |
61 | an allocated file with neither links nor entries, | |
62 | some disk space may be lost but the situation will not degenerate. | |
63 | .SH BUGS | |
64 | Since | |
65 | .I dcheck | |
66 | is inherently two-pass in nature, extraneous diagnostics | |
67 | may be produced if applied to active file systems. | |
68 | .PP | |
69 | .I Dcheck | |
70 | is obsoleted by | |
71 | .I fsck | |
72 | and remains for historical reasons. |