| 1 |
.\" -*- nroff -*- |
| 2 |
.\" Copyright 1996-2004 Hans Reiser. |
| 3 |
.\" |
| 4 |
.TH DEBUGREISERFS 8 "January 2009" "Reiserfsprogs 3.6.27" |
| 5 |
.SH NAME |
| 6 |
debugreiserfs \- The debugging tool for the ReiserFS filesystem. |
| 7 |
.SH SYNOPSIS |
| 8 |
.B debugreiserfs |
| 9 |
[ |
| 10 |
.B -dDJmoqpuSV |
| 11 |
] [ |
| 12 |
.B -j \fIdevice |
| 13 |
] [ |
| 14 |
.B -B \fIfile |
| 15 |
] [ |
| 16 |
.B -1 \fIN |
| 17 |
] |
| 18 |
|
| 19 |
.\" ] [ |
| 20 |
.\" .B -s |
| 21 |
.\" ] [ |
| 22 |
.I device |
| 23 |
.SH DESCRIPTION |
| 24 |
\fBdebugreiserfs\fR sometimes helps to solve problems with reiserfs filesystems. |
| 25 |
When run without options it prints the super block of the ReiserFS filesystem found |
| 26 |
on the \fIdevice\fR. |
| 27 |
.TP |
| 28 |
.I device |
| 29 |
is the special file corresponding to the device (e.g /dev/hdXX for |
| 30 |
an IDE disk partition or /dev/sdXX for a SCSI disk partition). |
| 31 |
.SH OPTIONS |
| 32 |
.TP |
| 33 |
\fB-j\fR \fIdevice\fR |
| 34 |
prints the contents of the journal. The option \-p allows it to pack the journal |
| 35 |
with other metadata into the archive. |
| 36 |
.TP |
| 37 |
\fB-J\fR |
| 38 |
prints the journal header. |
| 39 |
.TP |
| 40 |
.B -d |
| 41 |
prints the formatted nodes of the internal tree of the filesystem. |
| 42 |
.TP |
| 43 |
.B -D |
| 44 |
prints the formatted nodes of all used blocks of the filesystem. |
| 45 |
.TP |
| 46 |
.B -m |
| 47 |
prints the contents of the bitmap (slightly useful). |
| 48 |
.TP |
| 49 |
.B -o |
| 50 |
prints the objectid map (slightly useful). |
| 51 |
.TP |
| 52 |
\fB-B\fR \fIfile\fR |
| 53 |
takes the list of bad blocks stored in the internal ReiserFS tree and translates it |
| 54 |
into an ascii list written to the specified file. |
| 55 |
.TP |
| 56 |
\fB-1\fR \fIblocknumber\fR |
| 57 |
prints the specified block of the filesystem. |
| 58 |
.TP |
| 59 |
.\" \fB-s |
| 60 |
.\" scans the partition and prints a line when any kind of reiserfs |
| 61 |
.\" formatted nodes found. Can be used to find specific key in the filesystem. |
| 62 |
.\" .TP |
| 63 |
.B -p |
| 64 |
extracts the filesystem's metadata with \fBdebugreiserfs\fR \-p /dev/xxx | gzip \-c > |
| 65 |
xxx.gz. None of your data are packed unless a filesystem corruption presents when |
| 66 |
the whole block having this corruption is packed. You send us the output, and we use |
| 67 |
it to create a filesystem with the same strucure as yours using \fBdebugreiserfs \-u\fR. |
| 68 |
When the data file is not too large, this usually allows us to quickly reproduce |
| 69 |
and debug the problem. |
| 70 |
.TP |
| 71 |
.B -u |
| 72 |
builds the ReiserFS filesystem image with gunzip \-c xxx.gz | \fBdebugreiserfs\fR |
| 73 |
\-u /dev/image of the previously packed metadata with \fBdebugreiserfs \-p\fR. The |
| 74 |
result image is not the same as the original filesystem, because mostly only metadata |
| 75 |
were packed with \fBdebugreiserfs \-p\fR, but the filesystem structure is completely |
| 76 |
recreated. |
| 77 |
.TP |
| 78 |
.B -S |
| 79 |
When \-S is not specified \-p |
| 80 |
.\" and -s |
| 81 |
deals with blocks marked used in the filesystem bitmap only. With this option |
| 82 |
set \fBdebugreiserfs\fR will work with the entire device. |
| 83 |
.TP |
| 84 |
.B -q |
| 85 |
When |
| 86 |
.\" -s or |
| 87 |
\-p is in use, suppress showing the speed of progress. |
| 88 |
.SH AUTHOR |
| 89 |
This version of \fBdebugreiserfs\fR has been written by Vitaly Fertman |
| 90 |
<[email protected]>. |
| 91 |
.SH BUGS |
| 92 |
Please report bugs to the ReiserFS developers <[email protected]>, providing |
| 93 |
as much information as possible--your hardware, kernel, patches, settings, all printed |
| 94 |
messages; check the syslog file for any related information. |
| 95 |
.SH SEE ALSO |
| 96 |
.BR reiserfsck (8), |
| 97 |
.BR mkreiserfs (8) |