usr/src/man/man1m/clri.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH CLRI 1M "Sep 16, 1996"
   7 .SH NAME
   8 clri, dcopy \- clear inode
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBclri\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] \fIspecial\fR \fIi-number\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBdcopy\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] \fIspecial\fR \fIi-number\fR
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 \fBclri\fR writes zeros on the inodes with the decimal \fIi-number\fR on the
  24 file system stored on  \fIspecial\fR. After  \fBclri\fR, any blocks in the
  25 affected file show up as missing in an  \fBfsck\fR(1M) of \fIspecial\fR.
  26 .sp
  27 .LP
  28 Read and write permission is required on the specified file system device. The
  29 inode becomes allocatable.
  30 .sp
  31 .LP
  32 The primary purpose of this routine is to remove a file that for some reason
  33 appears in no directory. If it is used to zap an inode that does appear in a
  34 directory, care should be taken to track down the entry and remove it.
  35 Otherwise, when the inode is reallocated to some new file, the old entry will
  36 still point to that file. At that point, removing the old entry will destroy
  37 the new file. The new entry will again point to an unallocated inode, so the
  38 whole cycle is likely to be repeated again and again.
  39 .sp
  40 .LP
  41 \fBdcopy\fR is a symbolic link to \fBclri\fR.
  42 .SH OPTIONS
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-F\fR\fI FSType\fR\fR
  47 .ad
  48 .RS 13n
  49 Specify the  \fIFSType\fR on which to operate. The  \fIFSType\fR should either
  50 be specified here or be determinable from  \fB/etc/vfstab\fR by matching
  51 \fIspecial\fR with an entry in the table, or by consulting
  52 \fB/etc/default/fs\fR.
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB-V\fR\fR
  59 .ad
  60 .RS 13n
  61 Echo the complete command line, but do not execute the command. The command
  62 line is generated by using the options and arguments provided by the user and
  63 adding to them information derived from \fB/etc/vfstab\fR. This option should
  64 be used to verify and validate the command line.
  65 .RE
  66
  67 .SH USAGE
  68 .sp
  69 .LP
  70 See \fBlargefile\fR(5) for the description of the behavior of \fBclri\fR and
  71 \fBdcopy\fR when encountering files greater than or equal to 2 Gbyte ( 2^31
  72 bytes).
  73 .SH FILES
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB/etc/default/fs\fR\fR
  78 .ad
  79 .RS 19n
  80 Default local file system type
  81 .RE
  82
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fB/etc/vfstab\fR\fR
  87 .ad
  88 .RS 19n
  89 List of default parameters for each file system
  90 .RE
  91
  92 .SH SEE ALSO
  93 .sp
  94 .LP
  95 \fBfsck\fR(1M), \fBvfstab\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5)
  96 .SH NOTES
  97 .sp
  98 .LP
  99 This command might not be supported for all \fIFSTypes\fR.