rewrite to decontaminate

SCCS-vsn: sbin/clri/clri.8 8.2

diff --git a/usr/src/sbin/clri/clri.8 b/usr/src/sbin/clri/clri.8
index c1e5d74..bc99abf 100644 (file)
--- a/usr/src/sbin/clri/clri.8
+++ b/usr/src/sbin/clri/clri.8
@@ -1,57 +1,53 @@
 .\" Copyright (c) 1980, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" Copyright (c) 1980, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"

-.\"    %sccs.include.proprietary.roff%
+.\"    %sccs.include.redist.man%

 .\"
 .\"

-.\"    @(#)clri.8      8.1 (Berkeley) %G%
+.\"    @(#)clri.8      8.2 (Berkeley) %G%

 .\"
 .\"

-.TH CLRI 8 ""
-.UC 4
-.SH NAME
-clri \- clear i-node
-.SH SYNOPSIS
-.B /etc/clri
-filesystem i-number ...
-.SH DESCRIPTION
-.B N.B.:
-.I Clri
+.Dd 
+.Dt CLRI 8
+.Os BSD 4
+.Sh NAME
+.Nm clri
+.Nd clear an inode
+.Sh SYNOPSIS
+.Nm clri
+.Ar special_device inode_number ...
+.Sh DESCRIPTION
+.Bf -symbolic
+.Nm Clri

 is obsoleted for normal file system repair work by
 is obsoleted for normal file system repair work by

-.IR fsck (8).
-.PP
-.I Clri
-writes zeros on the i-nodes
-with the decimal
-.I i-numbers
-on the
-.I filesystem.
-After
-.I clri,
-any blocks
-in the affected file
-will show up as `missing' in an
-.IR icheck (8)
-of the
-.I filesystem.
-.PP
-Read and write permission is required on the specified
-file system device.
-The i-node becomes allocatable.
-.PP
+.Xr fsck 8 .
+.Ef
+.Pp
+.Nm Clri
+zeros out the inodes with the specified inode number(s)
+on the filesystem residing on the given
+.Ar special_device .
+The
+.Xr fsck 8
+utility is usually run after
+.Nm clri
+to reclaim the zero'ed inode(s) and the
+blocks previously claimed by those inode(s).
+Both read and write permission are required on the specified
+.Ar special_device .
+.Pp

 The primary purpose of this routine
 is to remove a file which
 The primary purpose of this routine
 is to remove a file which

-for some reason appears in no
-directory.
-If it is used to zap an i-node
-which does appear in a directory, care should be taken to track down
-the entry and remove it.
-Otherwise, when the i-node is reallocated to some new file,
-the old entry will still point to that file.
-At that point removing the old entry will destroy the new file.
-The new entry will again point to an unallocated i-node,
-so the whole cycle is likely to be repeated again and again.
-.SH "SEE ALSO"
-icheck(8)
-.SH BUGS
-If the file is open,
-.I clri
-is likely to be ineffective.
+for some reason is not being properly handled by
+.Xr fsck 8 .
+Once removed,
+it is anticipated that
+.Xr fsck 8
+will be able to clean up the resulting mess.
+.Sh "SEE ALSO"
+.Xr fsck 8 ,
+.Xr fsdb 8 ,
+.Xr icheck 8 ,
+.Xr ncheck 8
+.Sh BUGS
+If the file is open, the work of
+.Nm clri
+will be lost when the inode is written back to disk from the inode cache.