reiserfsck
REISERFSCK(8) 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 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).
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 corrup-
tion 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).
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-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
separate 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 cor-
ruption.
--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 reason-
able exit codes, etc.
SEE ALSO
mkreiserfs(8), debugreiserfs(8), reiserfstune(8)
Reiserfsprogs-3.6.4 January 2002 REISERFSCK(8)
