NAME

fsck - file system consistency check and interactive repair

SYNOPSIS

fsck [-dfnPpqvy] [-l maxparallel] [-T fstype:fsoptions] [-t fstype] [special | node ...]

DESCRIPTION

The fsck command invokes file system-specific programs to check the special devices listed in the fstab(5) file or in the command line for consistency.

It is normally used in the script /etc/rc during automatic reboot. If no file systems are specified, and ``preen'' mode is enabled ( -p option) fsck reads the table /etc/fstab to determine which file systems to check, in what order. Only partitions in fstab that are mounted ``rw,'' ``rq'' or ``ro'' and that have non-zero pass number are checked. File systems with pass number 1 (normally just the root file system) are checked one at a time. When pass 1 completes, all remaining file systems are checked, running one process per disk drive. By default, file systems which are already mounted read-write are not checked. The disk drive containing each file system is inferred from the longest prefix of the device name that ends in a digit; the remaining characters are assumed to be the partition designator.

The options are as follows:

-d
Debugging mode. Just print the commands without executing them.

-f
Force checking of file systems, even when they are marked clean (for file systems that support this), or when they are mounted read-write.

-l maxparallel
Limit the number of parallel checks to the number specified in the following argument. By default, the limit is the number of disks, running one process per disk. If a smaller limit is given, the disks are checked round-robin, one file system at a time.

-n
Causes fsck to assume no as the answer to all operator questions, except "CONTINUE?".

-P
Display a progress meter for each file system check. This option also disables parallel checking. Note that progress meters are not supported by all file system types.

-p
Enter preen mode. In preen mode, fsck will check all file systems listed in /etc/fstab according to their pass number, and will make minor repairs without human intervention.

-q
Quiet mode, do not output any messages for clean filesystems.

-T fstype:fsoptions
List of comma separated file system specific options for the specified file system type, in the same format as mount(8).

-t fstype
Invoke fsck only for the comma separated list of file system types. If the list starts with ``no'' then invoke fsck for the file system types that are not specified in the list.

-v
Print the commands before executing them.

-y
Causes fsck to assume yes as the answer to all operator questions.

EXIT STATUS

fsck exits with 0 on success. Any major problems will cause fsck to exit with the following non-zero exit(3) codes, so as to alert any invoking program or script that human intervention is required.

1
Usage problem.

2
Unresolved errors while checking the filesystem. Re-running fsck on the filesystem(s) is required.

4
The root filesystem was changed in the process of checking, and updating the mount was unsuccessful. A reboot (without sync) is required.

8
The filesystem check has failed, and a subsequent check is required that will require human intervention.

12
fsck exited because of the result of a signal (usually SIGINT or SIGQUIT from the terminal).

FILES

/etc/fstab
file system table

SEE ALSO

fstab(5), fsck_ext2fs(8), fsck_ffs(8), fsck_lfs(8), fsck_msdos(8), mount(8)