xref: /illumos-gate/usr/src/man/man8/fsck_pcfs.8 (revision 8119dad84d6416f13557b0ba8e2aaf9064cbcfd3)
te
Copyright (c) 2000, 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]
FSCK_PCFS 8 "Jan 28, 2000"
NAME
fsck_pcfs - file system consistency check and interactive repair
SYNOPSIS

fsck -F pcfs [generic_options] special

fsck -F pcfs [generic_options] [-o specific_options] special
DESCRIPTION

The fsck utility audits and interactively repairs inconsistent conditions on file systems. special represents the character special device on which the file system resides, for example /dev/rdiskette. The character special device, not the block special device, should be used.

In the case of correcting serious inconsistencies, by default, fsck asks for confirmation before making a repair and waits for the operator to respond either yes or no. If the operator does not have write permission on the file system, fsck defaults to a -n (no corrections) action. See fsck(8).

Repairing some file system inconsistencies may result in loss of data. The amount and severity of data loss may be determined from the diagnostic output.

When executed with the verify option (-o v), fsck_pcfs automatically scans the entire file system to verify that all of its allocation units are accessible. If it finds any units inaccessible, it updates the file allocation table (FAT) appropriately. It also updates any effected directory entries to reflect the problem. This directory update includes truncating the file at the point in its allocation chain where the file data is no longer accessible. Any remaining accessible allocation units become orphaned.

Orphaned chains of accessible allocation units are, with the operator's concurrence, linked back into the file system as files in the root directory. These files are assigned names of the form fileNNNN.chk, where the Ns are digits in the integral range from 0 through 9.

After successfully scanning and correcting any errors in the file system, fsck displays a summary of information about the file system. This summary includes the size of the file system in bytes, the number of bytes used in directories and individual files, and the number of available allocation units remaining in the file system.

OPTIONS
generic_options

The following generic options are supported: -m

Check but do not repair. This option checks that the file system is suitable for mounting, returning the appropriate exit status. If the file system is ready for mounting, fsck displays a message such as:

pcfs fsck: sanity check:
/dev/rdiskette okay
-n | -N

Assume a no response to all questions asked by fsck; do not open the file system for writing.

-V

Echo the expanded command line, but do not execute the command. This option may be used to verify and to validate the command line.

-y | -Y

Assume a yes response to all questions asked by fsck.

-o specific_options

Specify pcfs file system specific options in a comma-separated list, in any combination, with no intervening spaces. v

Verify all allocation units are accessible prior to correcting inconsistencies in the metadata.

p

Check and fix the file system non-interactively (preen). Exit immediately if there is a problem requiring intervention.

w

Check writable file systems only.

FILES
special

The device which contains the pcfs. The device name for a diskette is specified as /dev/rdiskette0 for the first diskette drive, or /dev/rdiskette1 for a second diskette drive. A hard disk device or high-capacity removable device name much be qualified with a suffix to indicate the proper FDISK partition. For example, in the names: /dev/rdsk/c0t0d0p0:c and /dev/rdsk/c0t4d0s2:c, the :c suffix indicates the first partition on the disk contains the pcfs.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Stable
SEE ALSO

fsck(8), fstyp(8), fdisk(8), mkfs(8), mkfs_pcfs(8), mountall(8), attributes(7), pcfs(4FS),

WARNINGS

The operating system buffers file system data. Running fsck on a mounted file system can cause the operating system's buffers to become out of date with respect to the disk. For this reason, the file system should be unmounted when fsck is used. If this is not possible, care should be taken that the system is quiescent and that it is rebooted immediately after fsck is run. Quite often, however, this is not sufficient. A panic will probably occur if running fsck on a file system modifies the file system.