Imported reiserfsprogs-3.6.20

2012-10-11 11:32:09 -04:00
1 parent 0ed773997f
commit dac518d099
@@ -0,0 +1,97 @@
+.\" -*- nroff -*-
+.\" Copyright 1996-2004 Hans Reiser.
+.\" 
+.TH debugfs.reiserfs 8 "February 2004" "Reiserfsprogs 3.6.19"
+.SH NAME
+debugfs.reiserfs \- The debugging tool for the ReiserFS filesystem.
+.SH SYNOPSIS
+.B debugfs.reiserfs
+[
+.B -dDJmoqpuSV
+] [
+.B -j \fIdevice
+] [
+.B -B \fIfile
+] [
+.B -1 \fIN
+]
+
+.\" ] [
+.\" .B -s
+.\" ] [
+.I device
+.SH DESCRIPTION
+\fBdebugfs.reiserfs\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 \fBdebugfs.reiserfs\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 \fBdebugfs.reiserfs -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 | \fBdebugfs.reiserfs\fR 
+-u /dev/image of the previously packed metadata with \fBdebugfs.reiserfs -p\fR. The
+result image is not the same as the original filesystem, because mostly only metadata
+were packed with \fBdebugfs.reiserfs -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 \fBdebugfs.reiserfs\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 \fBdebugfs.reiserfs\fR has been written by Vitaly Fertman 
+<vitaly@namesys.com>.
+.SH BUGS
+Please report bugs to the ReiserFS developers <reiserfs-dev@namesys.com>, 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 fsck.reiserfs (8),
+.BR mkfs.reiserfs (8)