projects / unix-history / blame
| 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. |