xref: /original-bsd/sbin/clri/clri.8 (revision e58c8952)
1.\" Copyright (c) 1980, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\"	%sccs.include.redist.man%
5.\"
6.\"	@(#)clri.8	8.2 (Berkeley) 04/19/94
7.\"
8.Dd
9.Dt CLRI 8
10.Os BSD 4
11.Sh NAME
12.Nm clri
13.Nd clear an inode
14.Sh SYNOPSIS
15.Nm clri
16.Ar special_device inode_number ...
17.Sh DESCRIPTION
18.Bf -symbolic
19.Nm Clri
20is obsoleted for normal file system repair work by
21.Xr fsck 8 .
22.Ef
23.Pp
24.Nm Clri
25zeros out the inodes with the specified inode number(s)
26on the filesystem residing on the given
27.Ar special_device .
28The
29.Xr fsck 8
30utility is usually run after
31.Nm clri
32to reclaim the zero'ed inode(s) and the
33blocks previously claimed by those inode(s).
34Both read and write permission are required on the specified
35.Ar special_device .
36.Pp
37The primary purpose of this routine
38is to remove a file which
39for some reason is not being properly handled by
40.Xr fsck 8 .
41Once removed,
42it is anticipated that
43.Xr fsck 8
44will be able to clean up the resulting mess.
45.Sh "SEE ALSO"
46.Xr fsck 8 ,
47.Xr fsdb 8 ,
48.Xr icheck 8 ,
49.Xr ncheck 8
50.Sh BUGS
51If the file is open, the work of
52.Nm clri
53will be lost when the inode is written back to disk from the inode cache.
54