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_journal_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 system 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 journal 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 statements 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://jfs.sourceforge.net/

       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_logdump(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://jfs.sourceforge.net/

                                         October 29, 2002                             jfs_fsck(8)