BSD 4_2 development

Work on file usr/man/man8/dcheck.8

Synthesized-from: CSRG/cd1/4.2

diff --git a/usr/man/man8/dcheck.8 b/usr/man/man8/dcheck.8
new file mode 100644 (file)
index 0000000..5ce1e6a
--- /dev/null
+++ b/usr/man/man8/dcheck.8
@@ -0,0 +1,66 @@
+.TH DCHECK 8  "4 February 1983"
+.UC 4
+.SH NAME
+dcheck \- file system directory consistency check
+.SH SYNOPSIS
+.B /etc/dcheck
+[
+.B \-i
+numbers ]
+[ filesystem ]
+.SH DESCRIPTION
+.B N.B.:
+.I Dcheck
+is obsoleted for normal consistency checking by
+.IR fsck (8).
+.PP
+.I Dcheck
+reads the directories in a file system
+and compares
+the link-count in each i-node with the number of directory
+entries by which it is referenced.
+If the file system is not specified,
+a set of default file systems
+is checked.
+.PP
+The
+.B \-i
+flag
+is followed by a list of i-numbers;
+when one of those i-numbers turns up
+in a directory,
+the number, the i-number of the directory,
+and the name of the entry are reported.
+.PP
+The program is fastest if the
+raw version of the special file is used,
+since the i-list is read in large chunks.
+.SH FILES
+Default file systems vary with installation.
+.SH "SEE ALSO"
+fsck(8), icheck(8), fs(5), clri(8), ncheck(8)
+.SH DIAGNOSTICS
+When a file turns up for which the link-count and the number
+of directory entries disagree,
+the relevant facts are reported.
+Allocated files which have 0 link-count and no entries are also
+listed.
+The only dangerous situation
+occurs when there are more entries than links;
+if entries are removed,
+so the link-count drops to 0,
+the remaining entries point to thin air.
+They should be removed.
+When there are more links than entries, or there is
+an allocated file with neither links nor entries,
+some disk space may be lost but the situation will not degenerate.
+.SH BUGS
+Since
+.I dcheck
+is inherently two-pass in nature, extraneous diagnostics
+may be produced if applied to active file systems.
+.PP
+.I Dcheck
+is obsoleted by
+.I fsck
+and remains for historical reasons.