Jeff Mahoney
0407950dfe
This patch is originally from the Debian package but no authorship information was contained within it. Signed-off-by: Jeff Mahoney <jeffm@suse.com>
98 lines
3.0 KiB
Plaintext
98 lines
3.0 KiB
Plaintext
.\" -*- nroff -*-
|
|
.\" Copyright 1996-2004 Hans Reiser.
|
|
.\"
|
|
.TH DEBUGREISERFS 8 "January 2009" "Reiserfsprogs @PACKAGE_VERSION@"
|
|
.SH NAME
|
|
debugreiserfs \- The debugging tool for the ReiserFS filesystem.
|
|
.SH SYNOPSIS
|
|
.B debugreiserfs
|
|
[
|
|
.B -dDJmoqpuSV
|
|
] [
|
|
.B -j \fIdevice
|
|
] [
|
|
.B -B \fIfile
|
|
] [
|
|
.B -1 \fIN
|
|
]
|
|
|
|
.\" ] [
|
|
.\" .B -s
|
|
.\" ] [
|
|
.I device
|
|
.SH DESCRIPTION
|
|
\fBdebugreiserfs\fR sometimes helps to solve problems with reiserfs filesystems.
|
|
When run without options it prints the super block of the ReiserFS filesystem found
|
|
on the \fIdevice\fR.
|
|
.TP
|
|
.I device
|
|
is the special file corresponding to the device (e.g /dev/hdXX for
|
|
an IDE disk partition or /dev/sdXX for a SCSI disk partition).
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB-j\fR \fIdevice\fR
|
|
prints the contents of the journal. The option \-p allows it to pack the journal
|
|
with other metadata into the archive.
|
|
.TP
|
|
\fB-J\fR
|
|
prints the journal header.
|
|
.TP
|
|
.B -d
|
|
prints the formatted nodes of the internal tree of the filesystem.
|
|
.TP
|
|
.B -D
|
|
prints the formatted nodes of all used blocks of the filesystem.
|
|
.TP
|
|
.B -m
|
|
prints the contents of the bitmap (slightly useful).
|
|
.TP
|
|
.B -o
|
|
prints the objectid map (slightly useful).
|
|
.TP
|
|
\fB-B\fR \fIfile\fR
|
|
takes the list of bad blocks stored in the internal ReiserFS tree and translates it
|
|
into an ascii list written to the specified file.
|
|
.TP
|
|
\fB-1\fR \fIblocknumber\fR
|
|
prints the specified block of the filesystem.
|
|
.TP
|
|
.\" \fB-s
|
|
.\" scans the partition and prints a line when any kind of reiserfs
|
|
.\" formatted nodes found. Can be used to find specific key in the filesystem.
|
|
.\" .TP
|
|
.B -p
|
|
extracts the filesystem's metadata with \fBdebugreiserfs\fR \-p /dev/xxx | gzip \-c >
|
|
xxx.gz. None of your data are packed unless a filesystem corruption presents when
|
|
the whole block having this corruption is packed. You send us the output, and we use
|
|
it to create a filesystem with the same strucure as yours using \fBdebugreiserfs \-u\fR.
|
|
When the data file is not too large, this usually allows us to quickly reproduce
|
|
and debug the problem.
|
|
.TP
|
|
.B -u
|
|
builds the ReiserFS filesystem image with gunzip \-c xxx.gz | \fBdebugreiserfs\fR
|
|
\-u /dev/image of the previously packed metadata with \fBdebugreiserfs \-p\fR. The
|
|
result image is not the same as the original filesystem, because mostly only metadata
|
|
were packed with \fBdebugreiserfs \-p\fR, but the filesystem structure is completely
|
|
recreated.
|
|
.TP
|
|
.B -S
|
|
When \-S is not specified \-p
|
|
.\" and -s
|
|
deals with blocks marked used in the filesystem bitmap only. With this option
|
|
set \fBdebugreiserfs\fR will work with the entire device.
|
|
.TP
|
|
.B -q
|
|
When
|
|
.\" -s or
|
|
\-p is in use, suppress showing the speed of progress.
|
|
.SH AUTHOR
|
|
This version of \fBdebugreiserfs\fR has been written by Vitaly Fertman
|
|
<vitaly@namesys.com>.
|
|
.SH BUGS
|
|
Please report bugs to the ReiserFS developers <reiserfs-devel@vger.kernel.org>, providing
|
|
as much information as possible--your hardware, kernel, patches, settings, all printed
|
|
messages; check the syslog file for any related information.
|
|
.SH SEE ALSO
|
|
.BR reiserfsck (8),
|
|
.BR mkreiserfs (8)
|