Man Linux: Main Page and Category List

NAME

       reiserfsck - The checking tool for the ReiserFS filesystem.

SYNOPSIS

       reiserfsck  [  -aprVy  ]  [  --rebuild-sb  |  --check | --fix-fixable |
       --rebuild-tree | --clean-attributes ] [ -j | --journal device ] [ -z  |
       --adjust-size  ]  [  -n  |  --nolog  ] [ -B | --badblocks file ] [ -l |
       --logfile file ] [ -q | --quiet ] [ -y | --yes ] [ -f | --force ] [  -S
       | --scan-whole-partition ] [ --no-journal-available ] device

DESCRIPTION

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

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

OPTIONS

       --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. But remember that
              if you have used some  partition  editor  program  and  now  you
              cannot  find  a  filesystem,  probably  something has gone wrong
              while repartitioning and the start of  the  partition  has  been
              changed. If so, instead of rebuilding the super block on a wrong
              place you should find the correct start of the partition  first.

       --check
              This  default  action checks filesystem consistency and reports,
              but does not repair any corruption that it  finds.  This  option
              may be used on a read-only file system mount.

       --fix-fixable
              This  option  recovers  certain  kinds of corruption that do not
              require rebuilding the entire file system tree (--rebuild-tree).
              Normally 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-tree
              This option rebuilds the entire filesystem tree using leaf nodes
              found on the device.  Normally you only need this option if  the
              reiserfsck  --check  reports  "Running  with  --rebuild-tree  is
              required". You are strongly encouraged to make a backup copy  of
              the whole partition before attempting the --rebuild-tree option.
              Once reiserfsck --rebuild-tree is started  it  must  finish  its
              work (and you should not interrupt it), otherwise the filesystem
              will be left in the unmountable state to avoid  subsequent  data
              corruptions.

       --clean-attributes
              This  option  cleans  reserved  fields of Stat-Data items. There
              were days when there were no extended  attributes  in  reiserfs.
              When  they  were implemented old partitions needed to be cleaned
              first -- reiserfs code in the kernel did not care about not used
              fields  in  its  strutures. Thus if you have used one of the old
              (pre-attrbutes) kernels with a ReiserFS filesystem and you  want
              to use extented attribues there, you should clean the filesystem
              first.

       --journal 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
              separate device from the main data device (although  it  can  be
              avoided with the expert option --no-journal-available).

       --adjust-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.

       --badblocks file, -B  file
              This  option  sets  the  badblock  list to be the list of blocks
              specified in the given ‘file‘. The filesystem badblock  list  is
              cleared before the new list is added. It can be used with --fix-
              fixable to fix the list of badblocks (see debugreiserfs -B).  If
              the  device has bad blocks, every time it must be given with the
              --rebuild-tree option.

       --logfile file, -l  file
              This option causes reiserfsck to report any corruption it  finds
              to the specified log file rather than to 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.

       --yes, -y
              This option inhibits reiserfsck from asking you for confirmation
              after telling you what it is going to do.  It  will  assuem  you
              confirm.  For  safety,  it does not work with the --rebuild-tree
              option.

       -a, -p These options are usually passed by fsck -A during the automatic
              checking of those partitions listed in /etc/fstab. These options
              cause reiserfsck to print some information about  the  specified
              filesystem,  to  check  if error flags in the superblock are set
              and to do some light-weight checks. If  these  checks  reveal  a
              corruption   or   the   flag  indicating  a  (possibly  fixable)
              corruption is found  set  in  the  superblock,  then  reiserfsck
              switches to the fix-fixable mode. If the flag indicating a fatal
              corruption is found  set  in  the  superblock,  then  reiserfsck
              finishes with an error.

       --force, -f
              Force checking even if the file system seems clean.

       -V     This option prints the reiserfsprogs version and then exit.

       -r This option does nothing at all; it is provided only for
              backwards compatibility.

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
              but not only the used space on the partition.

AN EXAMPLE OF USING reiserfsck

       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 reiserfsck --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 including your platform and  Linux  kernel
       version. We will try to help solve the problem.

EXIT CODES

       reiserfsck uses the following exit codes:
          0 - No errors.
          1 - File system errors corrected.
          2 - Reboot is needed.
          4 - File system fatal errors left uncorrected,
              reiserfsck --rebuild-tree needs to be launched.
          6 - File system fixable errors left uncorrected,
              reiserfsck --fix-fixable 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>.

BUGS

       Please   report   bugs   to   the   ReiserFS   developers    <reiserfs-
       dev@namesys.com>,  providing  as  much  information  as  possible--your
       hardware, kernel, patches, settings, all printed messages, the logfile;
       check the syslog file for any related information.

TODO

       Faster recovering, signal handling.

SEE ALSO

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