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