REISERFSCK(8)						      System Manager's Manual						     REISERFSCK(8)

NAME

       reiserfsck - check a Linux Reiserfs file system

SYNOPSIS

       reiserfsck  [ -afprVy ] [ --check | --fix-fixable | --rebuild-sb | --rebuild-tree | --clean-attributes ] [ -j | --journal-device device ] [
       --no-journal-available ] [ -z | --adjust-file-size ] [ -S | --scan-whole-partition ] [ -l | --logfile filename ] [ -n | --nolog ]  [  -q  |
       --quiet ] device

DESCRIPTION

       Reiserfsck  searches  for a Reiserfs filesystem on a device, replays any necessary transactions, and either checks or repairs the file sys-
       tem.

       device is the special file corresponding to the device or partition (e.g /dev/hdXX for IDE disk partition or /dev/sdXX for SCSI disk parti-
	      tion).

OPTIONS

       --check
	      This  default action checks file system consistency and reports but does not repair any corruption that it finds. This option may be
	      used on a read-only file system mount.  The --check option exits with status 0 to indicate that no corruption was found.	Otherwise,
	      reiserfsck  returns  1  to  indicate  corruption	that  can  be  fixed with --fix-fixable and 2 to indicate corruption that requires
	      --rebuild-tree.

       --fix-fixable
	      This option recovers certain kinds of corruption that do not require rebuilding the entire file system tree  (--rebuild-tree).  Nor-
	      mally  you  only	need  this  option if the --check option reports "corruption that can be fixed with --fix-fixable". This includes:
	      zeroing invalid data-block pointers, correcting st_size and st_blocks for directories, and deleting invalid directory entries.

       --rebuild-sb
	      This option recovers the superblock on a Reiserfs partition.  Normally you only need this option if mount reports "read_super_block:
	      can't find a reiserfs file system" and you are sure that a Reiserfs file system is there.

       --rebuild-tree
	      This  option  rebuilds  the entire file system tree using leaf nodes found on the device.  Normally you only need this option if the
	      --check option reports "corruption that can be fixed only during --rebuild-tree".  You are strongly encouraged to make a backup copy
	      of the whole partition before attempting the --rebuild-tree option.

       --clean-attributes
	      This option cleans reserved fields of Stat-Data items.

       --journal-device device , -j device
	      This option supplies the device name of the current file system journal.	This option is required when the journal resides on a sep-
	      arate device from the main data device (although it can be avoided with the expert option --no-journal-available).

       --adjust-file-size, -z
	      This option causes reiserfsck to correct file sizes that are larger than the offset of the last discovered byte.	This implies  that
	      holes  at  the end of a file will be removed.  File sizes that are smaller than the offset of the last discovered byte are corrected
	      by --fix-fixable.

       --logfile filename, -l  filename
	      This option causes reiserfsck to report any corruption it finds to the specified log file rather than stderr.

       --nolog, -n
	      This option prevents reiserfsck from reporting any kinds of corruption.

       --quiet, -q
	      This option prevents reiserfsck from reporting its rate of progress.

       -a, -p These options are usually passed by fsck -A during the automatic	checking  of  /etc/fstab  partitions.	For  compatibility,  these
	      options  simply  cause  reiserfsck to print information about the specified file system.	No checks are performed.  When it is set -
	      reiserfsck assumes that it is called by fsck -A, provides some information about the specified filesystem and exits.

       -V     This option prints the reiserfsprogs version and exit.

       -r, -p, -y
	      These options are ignored.

       -V, -f prints version and exits

EXPERT OPTIONS

       DO NOT USE THESE OPTIONS UNLESS YOU KNOW WHAT YOU ARE DOING.  WE ARE NOT RESPONSIBLE IF YOU LOSE DATA AS A RESULT OF THESE OPTIONS.

       --no-journal-available
	      This option allows reiserfsck to proceed when the journal device is not available. This option has no effect  when  the  journal	is
	      located on the main data device. NOTE: after this operation you must use reiserfstune to specify a new journal device.

       --scan-whole-partition, -S
	      This option causes --rebuild-tree to scan the whole partition, not only used space on the partition.

EXAMPLE OF USING

       1. You think something may be wrong with a reiserfs partition on /dev/hda1 or you would just like to perform a periodic disk check.

       2. Run reiserfsck --check --logfile check.log /dev/hda1. If reiserfsck --check exits with status 0 it means no errors were discovered.

       3.  If reiserfsck --check exits with status 1 (and reports about fixable corruptions) it means that you should run reiserfsck --fix-fixable
       --logfile fixable.log /dev/hda1.

       4. If reiserfsck --check exits with status 2 (and reports about fatal corruptions) it means that you need to run reiserfsck --rebuild-tree.
       If  reiserfsck  --check	fails in some way you should also run reiserfsck --rebuild-tree, but we also encourage you to submit this as a bug
       report.

       5. Before running reiserfsck --rebuild-tree, please make a backup of the whole partition before proceeding. Then run reiserfsck	--rebuild-
       tree --logfile rebuild.log /dev/hda1.

       6.  If  the  --rebuild-tree  step  fails  or does not recover what you expected, please submit this as a bug report. Try to provide as much
       information as possible and we will try to help solve the problem.  SH EXIT CODES eiserfsck uses the following exit codes:
	  0  - No errors.
	  1  - Errors found, esierfsck --fix-fixable needs to be launched.
	  2  - Errors found, esierfsck --rebuild-tree needs to be launched.
	  8  - Operational error.
	  16 - Usage or syntax error.

AUTHOR

       This version of reiserfsck has been written by Vitaly Fertman <vitaly@namesys.com> and Vladimir Saveliev <vs@namesys.com>.

BUGS

       There are likely to be some bugs. Please report bugs to the ReiserFS mail-list <reiserfs-list@namesys.com>.

TODO

       Faster recovering, signal handling, i/o error handling, return reasonable exit codes, etc.

SEE ALSO

       mkreiserfs(8), debugreiserfs(8), reiserfstune(8)

Reiserfsprogs-3.6.4						   January 2002 						     REISERFSCK(8)