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)