xref: /illumos-gate/usr/src/man/man8/clri.8 (revision bbf21555)
te
Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
CLRI 8 "Sep 16, 1996"
NAME
clri, dcopy - clear inode
SYNOPSIS

clri [-F FSType] [-V] special i-number

dcopy [-F FSType] [-V] special i-number
DESCRIPTION

clri writes zeros on the inodes with the decimal i-number on the file system stored on special. After clri, any blocks in the affected file show up as missing in an fsck(8) of special.

Read and write permission is required on the specified file system device. The inode becomes allocatable.

The primary purpose of this routine is to remove a file that for some reason appears in no directory. If it is used to zap an inode that does appear in a directory, care should be taken to track down the entry and remove it. Otherwise, when the inode 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 inode, so the whole cycle is likely to be repeated again and again.

dcopy is a symbolic link to clri.

OPTIONS
-F FSType

Specify the FSType on which to operate. The FSType should either be specified here or be determinable from /etc/vfstab by matching special with an entry in the table, or by consulting /etc/default/fs.

-V

Echo the complete command line, but do not execute the command. The command line is generated by using the options and arguments provided by the user and adding to them information derived from /etc/vfstab. This option should be used to verify and validate the command line.

USAGE

See largefile(7) for the description of the behavior of clri and dcopy when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

FILES
/etc/default/fs

Default local file system type

/etc/vfstab

List of default parameters for each file system

SEE ALSO

vfstab (5), attributes (7), largefile (7), fsck (8)

NOTES

This command might not be supported for all FSTypes.