Debian Codegraph @

upstream/debian-trixie/man8/debugreiserfs.8

raw
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)