.\" -*- nroff -*- .\" Copyright 1996-2003 Hans Reiser. .\" .TH REISERFSCK 8 "April 2003" "Reiserfsprogs-3.6.9" .SH NAME reiserfsck \- check a Linux Reiserfs file system .SH SYNOPSIS .B reiserfsck [ \fB-afprVy\fR ] [ \fB--rebuild-sb\fR | \fB--check\fR | \fB--fix-fixable\fR | \fB--rebuild-tree\fR | \fB--clean-attributes\fR ] .\" [ \fB-i\fR | \fB--interactive\fR ] [ \fB-j\fR | \fB--journal\fR \fIdevice\fR ] [ \fB-z\fR | \fB--adjust-size\fR ] [ \fB-n\fR | \fB--nolog\fR ] [ \fB-l\fR | \fB--logfile \fIfile\fR ] [ \fB-q\fR | \fB--quiet\fR ] [ \fB-y\fR | \fB--yes\fR ] .\" [ \fB-b\fR | \fB--scan-marked-in-bitmap \fIbitmap-filename\fR ] .\" [ \fB-h\fR | \fB--hash \fIhash-name\fR ] .\" [ \fB-g\fR | \fB--background\fR ] [ \fB-S\fR | \fB--scan-whole-partition\fR ] [ \fB--no-journal-available\fR ] .I device .SH DESCRIPTION \fBReiserfsck\fR searches for a Reiserfs filesystem on a device, replays any necessary transactions, and either checks or repairs the file system. .TP .I 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). .SH OPTIONS .TP .B --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. .TP .B --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. .TP .B --fix-fixable This option recovers certain kinds of corruption that do not require rebuilding the entire file system tree (\fB--rebuild-tree\fR). Normally you only need this option if the \fB--check\fR option reports "corruption that can be fixed with \fB--fix-fixable\fR". This includes: zeroing invalid data-block pointers, correcting st_size and st_blocks for directories, and deleting invalid directory entries. .TP .B --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 \fB--check\fR option reports "corruption that can be fixed only during \fB--rebuild-tree\fR". You are strongly encouraged to make a backup copy of the whole partition before attempting the \fB--rebuild-tree\fR option. .TP .B --clean-attributes This option cleans reserved fields of Stat-Data items. .TP .B \fB--journal \fIdevice \fR, \fB-j \fIdevice \fR 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 \fB--no-journal-available\fR). .TP .\" .B --interactive, -i .\" This makes \fBreiserfsck\fR to stop after each pass completed. .\" .TP .B --adjust-size, -z This option causes \fBreiserfsck\fR 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. .TP \fB--logfile \fIfile\fR, \fB-l \fI file\fR This option causes \fBreiserfsck\fR to report any corruption it finds to the specified log file rather than stderr. .TP .B --nolog, -n This option prevents \fBreiserfsck\fR from reporting any kinds of corruption. .TP .B --quiet, -q This option prevents \fBreiserfsck\fR from reporting its rate of progress. .TP .B --yes, -y This option inhibits \fBreiserfsck\fR 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. .TP \fB-a\fR, \fB-p\fR These options are usually passed by fsck -A during the automatic checking of those partitions listed in /etc/fstab. These options cause \fBreiserfsck\fR 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 \fBreiserfsck\fR switches to the fix-fixable mode. If the flag indicating a fatal corruption is found set in the superblock, then \fBreiserfsck\fR finishes with an error. .TP .B -V This option prints the reiserfsprogs version and exit. .TP \fB-r\fR, \fB-f\fR These options are ignored. .SH 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. .TP .B \fB\--no-journal-available\fR This option allows \fBreiserfsck\fR 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 \fBreiserfstune\fR to specify a new journal device. .TP .B --scan-whole-partition, -S This option causes \fB--rebuild-tree\fR to scan the whole partition, not only used space on the partition. .SH 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 \fBreiserfsck --check --logfile check.log /dev/hda1\fR. If \fBreiserfsck --check\fR exits with status 0 it means no errors were discovered. 3. If \fBreiserfsck --check\fR exits with status 1 (and reports about fixable corruptions) it means that you should run \fBreiserfsck --fix-fixable --logfile fixable.log /dev/hda1\fR. 4. If \fBreiserfsck --check\fR exits with status 2 (and reports about fatal corruptions) it means that you need to run \fBreiserfsck --rebuild-tree\fR. If \fBreiserfsck --check\fR fails in some way you should also run \fBreiserfsck --rebuild-tree\fR, but we also encourage you to submit this as a bug report. 5. Before running \fBreiserfsck --rebuild-tree\fR, please make a backup of the whole partition before proceeding. Then run \fBreiserfsck --rebuild-tree --logfile rebuild.log /dev/hda1\fR. 6. If the \fB--rebuild-tree\fR 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 \fBreiserfsck\fR uses the following exit codes: .br \ \fI0\fR \-\ No errors. .br \ \fI1\fR \-\ File system errors corrected. .br \ \fI4\fR \-\ File system fatal errors left uncorrected, .br \ \fBreiserfsck --rebuild-tree\fR needs to be launched. .br \ \fI6\fR \-\ File system fixable errors left uncorrected, .br \ \fBreiserfsck --fix-fixable\fR needs to be launched. .br \ \fI8\fR \-\ Operational error. .br \ \fI16\fR \-\ Usage or syntax error. .br .SH AUTHOR This version of \fBreiserfsck\fR has been written by Vitaly Fertman . .SH BUGS There are likely to be some bugs. Please report bugs to the ReiserFS mail-list . .SH TODO Faster recovering, signal handling, i/o error handling, etc. .SH SEE ALSO .BR mkreiserfs (8), .BR reiserfstune (8) .BR resize_reiserfs (8), .BR debugreiserfs (8),