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

   1 '\" te
   2 .\" Copyright (c) 2000, 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 FSCK_PCFS 1M "Jan 28, 2000"
   7 .SH NAME
   8 fsck_pcfs \- file system consistency check and interactive repair
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBfsck\fR \fB-F\fR pcfs [\fIgeneric_options\fR] \fIspecial\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBfsck\fR \fB-F\fR pcfs [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR] \fIspecial\fR
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 The \fBfsck\fR utility audits and interactively repairs inconsistent conditions
  24 on file systems. \fIspecial\fR represents the character special device on which
  25 the file system resides, for example \fB/dev/rdiskette\fR. The character
  26 special device, not the block special device, should be used.
  27 .sp
  28 .LP
  29 In the case of correcting serious inconsistencies, by default, \fBfsck\fR asks
  30 for confirmation before making a repair and waits for the operator to respond
  31 either \fByes\fR or \fBno\fR. If the operator does not have write permission on
  32 the file system, \fBfsck\fR defaults to a \fB-n\fR (no corrections) action. See
  33 \fBfsck\fR(1M).
  34 .sp
  35 .LP
  36 Repairing some file system inconsistencies may result in loss of data. The
  37 amount and severity of data loss may be determined from the diagnostic output.
  38 .sp
  39 .LP
  40 When executed with the verify option (\fB\fR\fB-o\fR\fB v\fR), \fBfsck_pcfs\fR
  41 automatically scans the entire file system to verify that all of its allocation
  42 units are accessible. If it finds any units inaccessible, it updates the file
  43 allocation table (\fBFAT\fR) appropriately. It also updates any effected
  44 directory entries to reflect the problem. This directory update includes
  45 truncating the file at the point in its allocation chain where the file data is
  46 no longer accessible. Any remaining accessible allocation units become
  47 orphaned.
  48 .sp
  49 .LP
  50 Orphaned chains of accessible allocation units are, with the operator's
  51 concurrence, linked back into the file system as files in the root directory.
  52 These files are assigned names of the form file\fINNNN\fR.chk, where the
  53 \fIN\fRs are digits in the integral range from \fB0\fR through \fB9\fR.
  54 .sp
  55 .LP
  56 After successfully scanning and correcting any errors in the file system,
  57 \fBfsck\fR displays a summary of information about the file system. This
  58 summary includes the size of the file system in bytes, the number of bytes used
  59 in directories and individual files, and the number of available allocation
  60 units remaining in the file system.
  61 .SH OPTIONS
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fIgeneric_options\fR\fR
  66 .ad
  67 .RS 23n
  68 The following generic options are supported:
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-m\fR\fR
  73 .ad
  74 .RS 11n
  75 Check but do not repair. This option checks that the file system is suitable
  76 for mounting, returning the appropriate exit status. If the file system is
  77 ready for mounting, \fBfsck\fR  displays a message such as:
  78 .sp
  79 .in +2
  80 .nf
  81 pcfs fsck: sanity check:
  82 \fB/dev/rdiskette\fR okay
  83 .fi
  84 .in -2
  85 .sp
  86
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-n\fR | \fB-N\fR\fR
  93 .ad
  94 .RS 11n
  95  Assume a no response to  all  questions  asked  by \fBfsck\fR; do not open the
  96 file system for writing.
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fB-V\fR\fR
 103 .ad
 104 .RS 11n
 105 Echo the expanded command line, but do not execute  the command. This option
 106 may be used to verify and  to validate the command line.
 107 .RE
 108
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB-y\fR | \fB-Y\fR\fR
 113 .ad
 114 .RS 11n
 115 Assume a \fByes\fR response to all  questions  asked  by \fBfsck\fR.
 116 .RE
 117
 118 .RE
 119
 120 .sp
 121 .ne 2
 122 .na
 123 \fB\fB-o\fR \fIspecific_options\fR\fR
 124 .ad
 125 .RS 23n
 126 Specify \fBpcfs\fR file system specific options in a comma-separated list, in
 127 any combination, with no intervening spaces.
 128 .sp
 129 .ne 2
 130 .na
 131 \fBv\fR
 132 .ad
 133 .RS 5n
 134 Verify all allocation units are accessible prior to correcting inconsistencies
 135 in the metadata.
 136 .RE
 137
 138 .sp
 139 .ne 2
 140 .na
 141 \fBp\fR
 142 .ad
 143 .RS 5n
 144 Check and fix the file system non-interactively (\fBpreen\fR).  Exit
 145 immediately if there is a problem requiring intervention.
 146 .RE
 147
 148 .sp
 149 .ne 2
 150 .na
 151 \fBw\fR
 152 .ad
 153 .RS 5n
 154 Check writable file systems only.
 155 .RE
 156
 157 .RE
 158
 159 .SH FILES
 160 .sp
 161 .ne 2
 162 .na
 163 \fB\fIspecial\fR\fR
 164 .ad
 165 .RS 11n
 166 The device which contains the pcfs. The device name for a diskette is specified
 167 as \fB/dev/rdiskette0\fR for the first diskette drive, or \fB/dev/rdiskette1\fR
 168 for a second diskette drive. A hard disk device or high-capacity removable
 169 device name much be qualified with a suffix to indicate the proper \fBFDISK\fR
 170 partition.
 171 .sp
 172 For example, in the names: \fB/dev/rdsk/c0t0d0p0:c\fR and
 173 \fB/dev/rdsk/c0t4d0s2:c\fR, the \fB:c\fR suffix indicates the first partition
 174 on the disk contains the \fBpcfs\fR.
 175 .RE
 176
 177 .SH ATTRIBUTES
 178 .sp
 179 .LP
 180 See \fBattributes\fR(5) for descriptions of the following attributes:
 181 .sp
 182
 183 .sp
 184 .TS
 185 box;
 186 c | c
 187 l | l .
 188 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 189 _
 190 Interface Stability     Stable
 191 .TE
 192
 193 .SH SEE ALSO
 194 .sp
 195 .LP
 196 \fBfsck\fR(1M), \fBfstyp\fR(1M), \fBfdisk\fR(1M), \fBmkfs\fR(1M),
 197 \fBmkfs_pcfs\fR(1M), \fBmountall\fR(1M), \fBattributes\fR(5), \fBpcfs\fR(7FS),
 198 .SH WARNINGS
 199 .sp
 200 .LP
 201 The operating system buffers file system data. Running \fBfsck\fR on a mounted
 202 file system can cause the operating system's buffers to become out of date with
 203 respect to the disk. For this reason, the file system should be unmounted when
 204 \fBfsck\fR is used. If this is not possible, care should be taken that the
 205 system is quiescent and that it is rebooted immediately after \fBfsck\fR is
 206 run. Quite often, however, this is not sufficient. A panic will probably occur
 207 if running \fBfsck\fR on a file system modifies the file system.