Appendix B. Manual Page of reiserfsck
reiserfsck - check a Linux Reiserfs file system
reiserfsck [ -afprVy ] [ --rebuild-sb | --check | --fix-
fixable | --rebuild-tree | --clean-attributes ] [ -j |
--journal device ] [ -z | --adjust-size ] [ -n | --nolog ]
[ -l | --logfile file ] [ -q | --quiet ] [ -y | --yes ] [
-S | --scan-whole-partition ] [ --no-journal-available ]
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 the device or
partition (e.g /dev/hdXX for IDE disk partition or
/dev/sdXX for SCSI disk partition).
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 reis
erfs file system" and you are sure that a Reiserfs
file system is there.
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.
This option recovers certain kinds of corruption
that do not require rebuilding the entire file sys
tem tree (--rebuild-tree). Normally you only need
this option if the --check option reports "corrup
tion that can be fixed with --fix-fixable". This
includes: zeroing invalid data-block pointers, cor
recting st_size and st_blocks for directories, and
deleting invalid directory entries.
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.
This option cleans reserved fields of Stat-Data
--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).
This option causes reiserfsck to correct file sizes
that are larger than the offset of the last discov
ered 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 file, -l file
This option causes reiserfsck to report any corrup
tion it finds to the specified log file rather than
This option prevents reiserfsck from reporting any
kinds of corruption.
This option prevents reiserfsck from reporting its
rate of progress.
This option inhibits reiserfsck from asking you for
confirmation after telling you what it is going to
do, assuming yes. 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 file
system, check if error flags in the superblock are
set and 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 cor
ruption is found set in the superblock, then reis
erfsck finishes with an error.
-V This option prints the reiserfsprogs version and
-r, -f These options are ignored.
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.
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.
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 parti
tion 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.
reiserfsck uses the following exit codes:
0 - No errors.
1 - File system errors corrected.
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.
This version of reiserfsck has been written by Vitaly
There are likely to be some bugs. Please report bugs to
the ReiserFS mail-list <email@example.com>.
Faster recovering, signal handling, i/o error handling,
mkreiserfs(8), reiserfstune(8) resize_reiserfs(8), debu
Reiserfsprogs-3.6.9 April 2003 REISERFSCK(8)