]> git.ipfire.org Git - thirdparty/e2fsprogs.git/blob - misc/dumpe2fs.8.in
Merge branch 'maint' into next
[thirdparty/e2fsprogs.git] / misc / dumpe2fs.8.in
1 .\" -*- nroff -*-
2 .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
3 .\" This file may be copied under the terms of the GNU Public License.
4 .\"
5 .TH DUMPE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
6 .SH NAME
7 dumpe2fs \- dump ext2/ext3/ext4 filesystem information
8 .SH SYNOPSIS
9 .B dumpe2fs
10 [
11 .B \-bfghixV
12 ]
13 [
14 .B \-o superblock=\fIsuperblock
15 ]
16 [
17 .B \-o blocksize=\fIblocksize
18 ]
19 .I device
20 .SH DESCRIPTION
21 .B dumpe2fs
22 prints the super block and blocks group information for the filesystem
23 present on
24 .I device.
25 .PP
26 .B Note:
27 When used with a mounted filesystem, the printed
28 information may be old or inconsistent.
29 .SH OPTIONS
30 .TP
31 .B \-b
32 print the blocks which are reserved as bad in the filesystem.
33 .TP
34 .B \-o superblock=\fIsuperblock
35 use the block
36 .I superblock
37 when examining the filesystem.
38 This option is not usually needed except by a filesystem wizard who
39 is examining the remains of a very badly corrupted filesystem.
40 .TP
41 .B \-o blocksize=\fIblocksize
42 use blocks of
43 .I blocksize
44 bytes when examining the filesystem.
45 This option is not usually needed except by a filesystem wizard who
46 is examining the remains of a very badly corrupted filesystem.
47 .TP
48 .B \-f
49 force dumpe2fs to display a filesystem even though it may have some
50 filesystem feature flags which dumpe2fs may not understand (and which
51 can cause some of dumpe2fs's display to be suspect).
52 .TP
53 .B \-g
54 display the group descriptor information in a machine readable colon-separated
55 value format. The fields displayed are the group number; the number of the
56 first block in the group; the superblock location (or -1 if not present); the
57 range of blocks used by the group descriptors (or -1 if not present); the block
58 bitmap location; the inode bitmap location; and the range of blocks used by the
59 inode table.
60 .TP
61 .B \-h
62 only display the superblock information and not any of the block
63 group descriptor detail information.
64 .TP
65 .B \-i
66 display the filesystem data from an image file created by
67 .BR e2image ,
68 using
69 .I device
70 as the pathname to the image file.
71 .TP
72 .B \-x
73 print the detailed group information block numbers in hexadecimal format
74 .TP
75 .B \-V
76 print the version number of
77 .B dumpe2fs
78 and exit.
79 .SH BUGS
80 You need to know the physical filesystem structure to understand the
81 output.
82 .SH AUTHOR
83 .B dumpe2fs
84 was written by Remy Card <Remy.Card@linux.org>. It is currently being
85 maintained by Theodore Ts'o <tytso@alum.mit.edu>.
86 .SH AVAILABILITY
87 .B dumpe2fs
88 is part of the e2fsprogs package and is available from
89 http://e2fsprogs.sourceforge.net.
90 .SH SEE ALSO
91 .BR e2fsck (8),
92 .BR mke2fs (8),
93 .BR tune2fs (8).
94 .BR ext4 (5)
95