1*acacc6feSsevan.\" $NetBSD: clri.8,v 1.9 2016/09/12 23:11:50 sevan Exp $ 20114e805Scgd.\" 3175ecf65Smycroft.\" Copyright (c) 1980, 1993 4175ecf65Smycroft.\" The Regents of the University of California. All rights reserved. 5175ecf65Smycroft.\" 6175ecf65Smycroft.\" Redistribution and use in source and binary forms, with or without 7175ecf65Smycroft.\" modification, are permitted provided that the following conditions 8175ecf65Smycroft.\" are met: 9175ecf65Smycroft.\" 1. Redistributions of source code must retain the above copyright 10175ecf65Smycroft.\" notice, this list of conditions and the following disclaimer. 11175ecf65Smycroft.\" 2. Redistributions in binary form must reproduce the above copyright 12175ecf65Smycroft.\" notice, this list of conditions and the following disclaimer in the 13175ecf65Smycroft.\" documentation and/or other materials provided with the distribution. 14bf07c871Sagc.\" 3. Neither the name of the University nor the names of its contributors 15175ecf65Smycroft.\" may be used to endorse or promote products derived from this software 16175ecf65Smycroft.\" without specific prior written permission. 17175ecf65Smycroft.\" 18175ecf65Smycroft.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19175ecf65Smycroft.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20175ecf65Smycroft.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21175ecf65Smycroft.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22175ecf65Smycroft.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23175ecf65Smycroft.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24175ecf65Smycroft.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25175ecf65Smycroft.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26175ecf65Smycroft.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27175ecf65Smycroft.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28175ecf65Smycroft.\" SUCH DAMAGE. 29175ecf65Smycroft.\" 3016573e29Smycroft.\" @(#)clri.8 8.2 (Berkeley) 4/19/94 31175ecf65Smycroft.\" 32*acacc6feSsevan.Dd September 13, 2016 33175ecf65Smycroft.Dt CLRI 8 3473f545bbSwiz.Os 35175ecf65Smycroft.Sh NAME 36175ecf65Smycroft.Nm clri 37175ecf65Smycroft.Nd clear an inode 38175ecf65Smycroft.Sh SYNOPSIS 39e40e4b2aSlukem.Nm 40175ecf65Smycroft.Ar special_device inode_number ... 41175ecf65Smycroft.Sh DESCRIPTION 42175ecf65Smycroft.Bf -symbolic 43e40e4b2aSlukem.Nm 44175ecf65Smycroftis obsoleted for normal file system repair work by 45175ecf65Smycroft.Xr fsck 8 . 46175ecf65Smycroft.Ef 47175ecf65Smycroft.Pp 48e40e4b2aSlukem.Nm 49175ecf65Smycroftzeros out the inodes with the specified inode number(s) 50175ecf65Smycrofton the filesystem residing on the given 51175ecf65Smycroft.Ar special_device . 52175ecf65SmycroftThe 53175ecf65Smycroft.Xr fsck 8 54175ecf65Smycroftutility is usually run after 55e40e4b2aSlukem.Nm 56175ecf65Smycroftto reclaim the zero'ed inode(s) and the 57175ecf65Smycroftblocks previously claimed by those inode(s). 58175ecf65SmycroftBoth read and write permission are required on the specified 59175ecf65Smycroft.Ar special_device . 60175ecf65Smycroft.Pp 61175ecf65SmycroftThe primary purpose of this routine 62175ecf65Smycroftis to remove a file which 63175ecf65Smycroftfor some reason is not being properly handled by 64175ecf65Smycroft.Xr fsck 8 . 65175ecf65SmycroftOnce removed, 66175ecf65Smycroftit is anticipated that 67175ecf65Smycroft.Xr fsck 8 68175ecf65Smycroftwill be able to clean up the resulting mess. 69b2275072Scgd.Sh SEE ALSO 70175ecf65Smycroft.Xr fsck 8 , 716ba9c179Smikel.Xr fsdb 8 7285d40180Ssevan.Sh HISTORY 7385d40180SsevanThe 7485d40180Ssevan.Nm 7585d40180Ssevanutility first appeared in 76*acacc6feSsevan.At v6 . 77175ecf65Smycroft.Sh BUGS 78175ecf65SmycroftIf the file is open, the work of 79e40e4b2aSlukem.Nm 80175ecf65Smycroftwill be lost when the inode is written back to disk from the inode cache. 81