share/man/man8/fsck_udfs.8

   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_UDFS 8 "Sep 5, 2000"
   7 .SH NAME
   8 fsck_udfs \- file system consistency check and interactive repair
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBfsck\fR \fB-F\fR udfs [\fIgeneric_options\fR] [\fIspecial \|.\|.\|.\fR]
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBfsck\fR \fB-F\fR udfs [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR]
  18      [\fIspecial \|.\|.\|.\fR]
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .sp
  23 .LP
  24 \fBfsck\fR audits and interactively repairs inconsistent conditions on file
  25 systems. A file system to be checked can be specified by giving the name of the
  26 block or character special device or by giving the name of its mount point if a
  27 matching entry exists in \fB/etc/vfstab\fR.
  28 .sp
  29 .LP
  30 \fIspecial\fR represents the character special device, for example,
  31 \fB/dev/rdsk/c0t2d0s0\fR, on which the file system resides. The character
  32 special device, not the block special device should be used. \fBfsck\fR does
  33 not work on a mounted block device.
  34 .sp
  35 .LP
  36 If no special device is specified, all \fBudfs\fR file systems specified in the
  37 \fBvfstab\fR file with a \fBfsckdev\fR entry are checked. If the \fB-p\fR
  38 (\fBpreen\fR) option is specified, \fBudfs\fR file systems with an
  39 \fBfsckpass\fR number greater than \fB1\fR are checked in parallel. See
  40 \fBfsck\fR(8).
  41 .sp
  42 .LP
  43 In the case of correcting serious inconsistencies, by default, \fBfsck\fR asks
  44 for confirmation before making a repair and waits for the operator to respond
  45 with either \fByes\fR or \fBno\fR. If the operator does not have write
  46 permission on the file system, \fBfsck\fR defaults to the \fB-n\fR (no
  47 corrections) option. See \fBfsck\fR(8).
  48 .sp
  49 .LP
  50 Repairing some file system inconsistencies can result in loss of data. The
  51 amount and severity of data loss can be determined from the diagnostic output.
  52 .sp
  53 .LP
  54 \fBfsck\fR automatically corrects innocuous inconsistencies. It displays a
  55 message for each corrected inconsistency that identifies the nature of the
  56 correction which took place on the file system. After successfully correcting a
  57 file system, \fBfsck\fR prints the number of files on that file system and the
  58 number of used and free blocks.
  59 .sp
  60 .LP
  61 Inconsistencies checked are as follows:
  62 .RS +4
  63 .TP
  64 .ie t \(bu
  65 .el o
  66 Blocks claimed by more than one file or the free list
  67 .RE
  68 .RS +4
  69 .TP
  70 .ie t \(bu
  71 .el o
  72 Blocks claimed by a file or the free list outside the range of the file system
  73 .RE
  74 .RS +4
  75 .TP
  76 .ie t \(bu
  77 .el o
  78 Incorrect link counts in file entries
  79 .RE
  80 .RS +4
  81 .TP
  82 .ie t \(bu
  83 .el o
  84 Incorrect directory sizes
  85 .RE
  86 .RS +4
  87 .TP
  88 .ie t \(bu
  89 .el o
  90 Bad file entry format
  91 .RE
  92 .RS +4
  93 .TP
  94 .ie t \(bu
  95 .el o
  96 Blocks not accounted for anywhere
  97 .RE
  98 .RS +4
  99 .TP
 100 .ie t \(bu
 101 .el o
 102 Directory checks, file pointing to unallocated file entry and absence of a
 103 parent directory entry
 104 .RE
 105 .RS +4
 106 .TP
 107 .ie t \(bu
 108 .el o
 109 Descriptor checks, more blocks for files than there are in the file system
 110 .RE
 111 .RS +4
 112 .TP
 113 .ie t \(bu
 114 .el o
 115 Bad free block list format
 116 .RE
 117 .RS +4
 118 .TP
 119 .ie t \(bu
 120 .el o
 121 Total free block count incorrect
 122 .RE
 123 .SH OPTIONS
 124 .sp
 125 .LP
 126 The following options are supported:
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fIgeneric_options\fR\fR
 131 .ad
 132 .RS 23n
 133 The following \fIgeneric_options\fR are supported:
 134 .sp
 135 .ne 2
 136 .na
 137 \fB\fB-m\fR\fR
 138 .ad
 139 .RS 11n
 140 Check but do not repair. This option checks to be sure that the file system is
 141 suitable for mounting, and returns the appropriate exit status. If the file
 142 system is ready for mounting, \fBfsck \fRdisplays a message such as:
 143 .sp
 144 .in +2
 145 .nf
 146 udfs fsck: sanity check: /dev/rdsk/c0t2d0s0 okay
 147 .fi
 148 .in -2
 149 .sp
 150
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fB-n\fR | \fB-N\fR\fR
 157 .ad
 158 .RS 11n
 159 Assume a \fBno\fR response to all questions asked by \fBfsck\fR; do not open
 160 the file system for writing.
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fB-V\fR\fR
 167 .ad
 168 .RS 11n
 169 Echo the expanded command line, but do not execute the command. This option can
 170 be used to verify and to validate the command line.
 171 .RE
 172
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fB-y\fR | \fB-Y\fR\fR
 177 .ad
 178 .RS 11n
 179 Assume a \fByes\fR response to all questions asked by \fBfsck\fR.
 180 .RE
 181
 182 .RE
 183
 184 .sp
 185 .ne 2
 186 .na
 187 \fB\fB-o\fR \fIspecific_options\fR\fR
 188 .ad
 189 .RS 23n
 190 Specify \fBudfs\fR file system specific options in a comma-separated list with
 191 no intervening spaces. The following \fIspecific_options\fR are available:
 192 .sp
 193 .ne 2
 194 .na
 195 \fB\fBf\fR\fR
 196 .ad
 197 .RS 5n
 198 Force checking of file systems regardless of the state of their logical volume
 199 integrity state.
 200 .RE
 201
 202 .sp
 203 .ne 2
 204 .na
 205 \fB\fBp\fR\fR
 206 .ad
 207 .RS 5n
 208 Check and fix the file system non-interactively (\fBpreen\fR). Exit immediately
 209 if there is a problem that requires intervention. This option is required to
 210 enable parallel file system checking.
 211 .RE
 212
 213 .sp
 214 .ne 2
 215 .na
 216 \fB\fBw\fR\fR
 217 .ad
 218 .RS 5n
 219 Check writable file systems only.
 220 .RE
 221
 222 .RE
 223
 224 .SH FILES
 225 .sp
 226 .ne 2
 227 .na
 228 \fB\fB/etc/vtstab\fR\fR
 229 .ad
 230 .RS 15n
 231 List of default parameters for each file system.
 232 .RE
 233
 234 .SH SEE ALSO
 235 .sp
 236 .LP
 237 \fBfsck\fR(8), \fBfsdb_udfs\fR(8), \fBfstyp\fR(8), \fBmkfs\fR(8),
 238 \fBmkfs_udfs\fR(8), \fBmountall\fR(8), \fBreboot\fR(8), \fBvfstab\fR(4),
 239 \fBattributes\fR(5)
 240 .SH WARNINGS
 241 .sp
 242 .LP
 243 The operating system buffers file system data. Running \fBfsck\fR on a mounted
 244 file system can cause the operating system's buffers to become out of date with
 245 respect to the disk. For this reason, use \fBfsck\fR only when the file system
 246 is unmounted. If this is not possible, take care that the system is quiescent
 247 and that it is rebooted immediately after running \fBfsck\fR. A panic will
 248 probably occur if running \fBfsck\fR on a file system that modifies the file
 249 system while it is mounted.
 250 .sp
 251 .LP
 252 If an unmount of the file system is not done before the system is shut down,
 253 the file system might become corrupted. In this case, a file system check needs
 254 to be completed before the next mount operation.
 255 .SH DIAGNOSTICS
 256 .sp
 257 .ne 2
 258 .na
 259 \fBnot writable\fR
 260 .ad
 261 .sp .6
 262 .RS 4n
 263 You cannot write to the device.
 264 .RE
 265
 266 .sp
 267 .ne 2
 268 .na
 269 \fBCurrently Mounted on\fR
 270 .ad
 271 .sp .6
 272 .RS 4n
 273 The device is already mounted and cannot run \fBfsck\fR.
 274 .RE
 275
 276 .sp
 277 .ne 2
 278 .na
 279 \fBFILE SYSTEM WAS MODIFIED\fR
 280 .ad
 281 .sp .6
 282 .RS 4n
 283 File system has been modified to bring it to a consistent state.
 284 .RE
 285
 286 .sp
 287 .ne 2
 288 .na
 289 \fBCan't read allocation extent\fR
 290 .ad
 291 .sp .6
 292 .RS 4n
 293 Cannot read the block containing allocation extent.
 294 .RE
 295
 296 .sp
 297 .ne 2
 298 .na
 299 \fBBad tag on alloc extent\fR
 300 .ad
 301 .sp .6
 302 .RS 4n
 303 Invalid tag detected when expecting an allocation extent.
 304 .RE
 305
 306 .sp
 307 .ne 2
 308 .na
 309 \fBVolume sequence tag error\fR
 310 .ad
 311 .sp .6
 312 .RS 4n
 313 Invalid tag detected in the volume sequence.
 314 .RE
 315
 316 .sp
 317 .ne 2
 318 .na
 319 \fBSpace bitmap tag error\fR
 320 .ad
 321 .sp .6
 322 .RS 4n
 323 Invalid tag detected in the space bitmap.
 324 .RE
 325
 326 .sp
 327 .ne 2
 328 .na
 329 \fBUNEXPECTED INCONSISTENCY; RUN fsck MANUALLY\fR
 330 .ad
 331 .sp .6
 332 .RS 4n
 333 Use \fBfsck\fR in interactive mode.
 334 .RE
 335