+.de us
+\\$1\l'|0\(ul'
+..
+.TH FSCK 8 "4 February 1983"
+.UC 4
+.SH NAME
+fsck \- file system consistency check and interactive repair
+.SH SYNOPSIS
+.B /etc/fsck
+.B \-p
+[
+filesystem ...
+]
+.br
+.B /etc/fsck
+[
+.B \-b
+block#
+] [
+.B \-y
+] [
+.B \-n
+] [
+filesystem
+] ...
+.SH DESCRIPTION
+The first form of
+.I fsck
+preens a standard set of filesystems or the specified file systems.
+It is normally used in the script
+.B /etc/rc
+during automatic reboot.
+In this case
+.I fsck
+reads the table
+.B /etc/fstab
+to determine which file systems to check.
+It uses the information there to inspect groups of disks in parallel taking
+maximum advantage of i/o overlap to check the file systems
+as quickly as possible.
+Normally, the root file system will be checked on pass 1, other
+``root'' (``a'' partition) file systems on pass 2, other
+small file systems on separate passes (e.g. the ``d'' file systems
+on pass 3 and the ``e'' file systems on pass 4), and finally
+the large user file systems on the last pass, e.g. pass 5.
+A pass number of 0 in fstab causes a disk to not be checked; similarly
+partitions which are not shown as to be mounted ``rw'' or ``ro''
+are not checked.
+.PP
+The system takes care that only a restricted class of innocuous
+inconsistencies can happen unless hardware or software failures intervene.
+These are limited to the following:
+.IP
+Unreferenced inodes
+.ns
+.IP
+Link counts in inodes too large
+.ns
+.IP
+Missing blocks in the free list
+.ns
+.IP
+Blocks in the free list also in files
+.ns
+.IP
+Counts in the super-block wrong
+.PP
+These are the only inconsistencies which
+.I fsck
+with the
+.B \-p
+option will correct; if it encounters other inconsistencies, it exits
+with an abnormal return status and an automatic reboot will then fail.
+For each corrected inconsistency one or more lines will be printed
+identifying the file system on which the correction will take place,
+and the nature of the correction. After successfully correcting a file
+system,
+.I fsck
+will print the number of files on that file system and the number of
+used and free blocks.
+.PP
+Without the
+.B \-p
+option,
+.I fsck
+audits and interactively repairs inconsistent conditions for file systems.
+If the file system is inconsistent the operator is prompted for concurrence
+before each correction is attempted.
+It should be noted that a number of the corrective actions which are not
+fixable under the
+.B \-p
+option will result in some loss
+of data.
+The amount and severity of data lost may be determined from the diagnostic
+output.
+The default action for each consistency correction
+is to wait for the operator to respond \fByes\fP or \fBno\fP.
+If the operator does not have write permission
+.I fsck
+will default to a
+.BR "\-n " action.
+.PP
+.I Fsck
+has more consistency checks than
+its predecessors
+.IR "check, dcheck, fcheck, " "and" " icheck"
+combined.
+.PP
+The following flags are interpreted by
+.I fsck.
+.TP 6
+.B \-b
+Use the block specified immediately after the flag as
+the super block for the file system. Block 32 is always
+an alternate super block.
+.TP 6
+.B \-y
+Assume a yes response to all questions asked by
+.I fsck;
+this should be used with great caution as this is a free license
+to continue after essentially unlimited trouble has been encountered.
+.TP 6
+.B \-n
+Assume a no response to all questions asked by
+.I fsck;
+do not open the file system for writing.
+.PP
+If no filesystems are given to
+.I fsck
+then a default list of file systems is read from
+the file
+.BR /etc/fstab .
+.PP
+.ne 10
+Inconsistencies checked are as follows:
+.TP 6
+1.
+Blocks claimed by more than one inode or the free list.
+.br
+.br
+.ns
+.TP 6
+2.
+Blocks claimed by an inode or the free list outside the range of the file system.
+.br
+.br
+.ns
+.TP 6
+3.
+Incorrect link counts.
+.br
+.br
+.ns
+.TP 6
+4.
+Size checks:
+.br
+.ns
+.IP "" 12
+Directory size not of proper format.
+.br
+.br
+.ns
+.TP 6
+5.
+Bad inode format.
+.br
+.br
+.ns
+.TP 6
+6.
+Blocks not accounted for anywhere.
+.br
+.br
+.ns
+.TP 6
+7.
+Directory checks:
+.br
+.br
+.ns
+.IP "" 12
+File pointing to unallocated inode.
+.br
+Inode number out of range.
+.br
+.br
+.ns
+.TP 6
+8.
+Super Block checks:
+.br
+.br
+.ns
+.IP "" 12
+.br
+More blocks for inodes than there are in the file system.
+.br
+.br
+.ns
+.TP 6
+9.
+Bad free block list format.
+.br
+.br
+.ns
+.TP 6
+10.
+Total free block and/or free inode count incorrect.
+.PP
+Orphaned files and directories (allocated but unreferenced) are,
+with the operator's concurrence, reconnected by
+placing them in the
+.B lost+found
+directory.
+The name assigned is the inode number. The only restriction
+is that the directory
+.B lost+found
+must preexist
+in the root of the filesystem being checked and
+must have empty slots in which entries can be made.
+This is accomplished by making
+.BR lost+found ,
+copying a number of files to the directory, and then removing them
+(before
+.I
+fsck
+is executed).
+.PP
+Checking the raw device is almost always faster.
+.SH FILES
+.br
+.ns
+.TP 21
+/etc/fstab
+contains default list of file systems to check.
+.SH DIAGNOSTICS
+The diagnostics produced by
+.I fsck
+are intended to be self-explanatory.
+.SH "SEE ALSO"
+fstab(5),
+fs(5),
+newfs(8),
+mkfs(8),
+crash(8V),
+reboot(8)
+.SH BUGS
+Inode numbers for
+.BR . ""
+and
+.BR .. ""
+in each directory should be checked for validity.
+.PP
+There should be some way to start a \fBfsck \-p\fR at pass \fIn\fR.
projects / unix-history / commitdiff