B.4. Manual Page of jfs_fsck
jfs_fsck(8) JFS utility - file system check jfs_fsck(8)
NAME
jfs_fsck - initiate replay of the JFS transaction log, and
check and repair a JFS formatted device
SYNOPSIS
jfs_fsck [ -afnpvV ] [ -j journal_device ] [ --omit_jour-
nal_replay ] [ --replay_journal_only ] device
DESCRIPTION
jfs_fsck is used to replay the JFS transaction log, check a
JFS formatted device for errors, and fix any errors found.
device is the special file name corresponding to the actual
device to be checked (e.g. /dev/hdb1).
jfs_fsck must be run as root.
WARNING
jfs_fsck should only be used to check an unmounted file sys-
tem or a file system that is mounted READ ONLY. Using
jfs_fsck to check a file system mounted other than READ ONLY
could seriously damage the file system!
OPTIONS
If no options are selected, the default is -p.
-a Autocheck mode - Replay the transaction log. Do not
continue fsck processing unless the aggregate state
is dirty or the log replay failed. Functionally
equivalent to -p. Autocheck mode is typically the
default mode used when jfs_fsck is called at boot
time.
-f Replay the transaction log and force checking even if
the file system appears clean. Repair all problems
automatically.
-j journal_device
Specify the journal device.
-n Open the file system read only. Do not replay the
transaction log. Report errors, but do not repair
them.
--omit_journal_replay
Omit the replay of the transaction log. This option
should not be used unless as a last resort (i.e. the
log has been severely corrupted and replaying it
causes further problems).
-p Automatically repair ("preen") the file system.
Replay the transaction log. Do not continue fsck
processing unless the aggregate state is dirty or the
log replay failed. Functionally equivalent to -a.
--replay_journal_only
Only replay the transaction log. Do not continue
with a full file system check if the replay fails or
if the file system is still dirty even after a jour-
nal replay. In general, this option should only be
used for debugging purposes as it could leave the
file system in an unmountable state. This option
cannot be used with -f, -n, or --omit_journal_replay.
-v Verbose messaging - print details and debug state-
ments to stdout.
-V Print version information and exit (regardless of any
other chosen options).
EXAMPLES
Check the 3rd partition on the 2nd hard disk, print extended
information to stdout, replay the transaction log, force
complete jfs_fsck checking, and give permission to repair
all errors:
jfs_fsck -v -f /dev/hdb3
Check the 5th partition on the 1st hard disk, and report,
but do not repair, any errors:
jfs_fsck -n /dev/hda5
EXIT CODE
The exit code returned by jfs_fsck represents one of the
following conditions:
0 No errors
1 File system errors corrected and/or transaction log
replayed successfully
2 File system errors corrected, system should be
rebooted if file system was mounted
4 File system errors left uncorrected
8 Operational error
16 Usage or syntax error
128 Shared library error
REPORTING BUGS
If you find a bug in JFS or jfs_fsck, please report it via
the bug tracking system ("Report Bugs" section) of the JFS
project web site:
http://oss.software.ibm.com/jfs
Please send as much pertinent information as possible,
including the complete output of running jfs_fsck with the
-v option on the JFS device.
SEE ALSO
fsck(8), jfs_mkfs(8), jfs_fscklog(8), jfs_tune(8), jfs_log-
dump(8), jfs_debugfs(8)
AUTHORS
Barry Arndt (barndt@us.ibm.com)
William Braswell, Jr.
jfs_fsck is maintained by IBM.
See the JFS project web site for more details:
http://oss.software.ibm.com/jfs
October 29, 2002 jfs_fsck(8)