NAME

fsck − check and repair file systems

SYNOPSIS

fsck [ −F FSType ] [ −V ] [ −m ] [ special ... ]
fsck [ −F FSType ] [ −V ] [− y | Y | n | N ] [ −o FSType-specific_options ] [ special ... ]

AVAILABILITY

SUNWcsr

DESCRIPTION

fsck audits and interactively repairs inconsistent file system conditions.  If the file system is inconsistent the default action for each correction is to wait for the user to respond yes or no.  If the user does not have write permission fsck defaults to a no action.  Some corrective actions will result in loss of data.  The amount and severity of data loss may be determined from the diagnostic output. 

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. 

FSType-specific_options are options specified in a comma-separated (with no intervening spaces) list of options or keyword-attribute pairs for interpretation by the FSType-specific module of the command.

special represents the block or character special device (for example, /dev/rdsk/c1d0s7) on which the file system resides.  In general, the character special device should be used.  fsck will not work on a block device if it is mounted. 

If no special device is specified, this indicates that fsck should check file systems listed in in /etc/vfstab.  Those entries in /etc/vfstab which have a character special device entry in the fsckdev field and have a non-zero numeric entry in the fsckpass field will be checked.  Specifying −F FSType causes the list of file systems to be checked to be narrowed to those of the type indicated. 

If a file system type supports parallel checking (for example, ufs) some filesystems eligible for checking may be checked in parallel.  Consult the file system-specific man page (for example fsck_ufs(1M)) for more information. 

If special is specified, but −F is not, the file system type will be determined by looking for a matching entry in /etc/vfstab.  If no entry is found, the default local file system type specified in /etc/default/fs will be used. 

OPTIONS

−FFSType
Specify the file system type on which to operate.

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

−y|Y Assume a yes response to all questions asked by fsck. 

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

−m Check but don’t 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

ufs fsck: sanity check: /dev/rdsk/c0t3d0s1 okay

−o FSType-specific options.

EXIT CODES

0 file system is okay and does not need checking

32 file system is unmounted and needs checking (fsck −m only)

33 file system is already mounted

34 cannot stat device

36 uncorrectable errors detected - terminate normally

37 a signal was caught during processing

39 uncorrectable errors detected - terminate immediately

40 for root, same as 0. 

FILES

/etc/vfstab list of default parameters for each file system

/etc/default/fs
default local file system type

SEE ALSO

mkfs(1M), vfstab(4)
Manual pages for the FSType-specific modules of fsck

NOTES

This command may not be supported for all FSTypes.

SunOS 5.1  —  Last change: 14 Sep 1992