next up previous contents index
Next: The GNU General Public Up: Appendixes Previous: Manual Page of e2fsck   Contents   Index


Manual Page of 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 corrup­
tion 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 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.

-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 reis­
erfs 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 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 filename, -l filename
This option causes reiserfsck to report any corrup­
tion 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 reis­
erfsck 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 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.

EXIT CODE
reiserfsck uses the following exit codes:
0 - No errors
1 - File system errors corrected
2 - File system errors corrected, system should
be rebooted if file system was mounted
4 - File system errors left uncorrected
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.2 January 2002 REISERFSCK(8)


next up previous contents index
Next: The GNU General Public Up: Appendixes Previous: Manual Page of e2fsck   Contents   Index
root 2003-11-05