]>
Commit | Line | Data |
---|---|---|
a418d3ad TT |
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 | .\" | |
74becf3c | 5 | .TH DUMPE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
3839e657 | 6 | .SH NAME |
4f858546 | 7 | dumpe2fs \- dump ext2/ext3/ext4 filesystem information |
3839e657 TT |
8 | .SH SYNOPSIS |
9 | .B dumpe2fs | |
5c576477 | 10 | [ |
0858268d | 11 | .B \-bfghixV |
5c576477 TT |
12 | ] |
13 | [ | |
db197a81 | 14 | .B \-o superblock=\fIsuperblock |
02e7dd9a TT |
15 | ] |
16 | [ | |
db197a81 | 17 | .B \-o blocksize=\fIblocksize |
02e7dd9a | 18 | ] |
caf8ce4c | 19 | .I device |
3839e657 | 20 | .SH DESCRIPTION |
caf8ce4c | 21 | .B dumpe2fs |
3839e657 TT |
22 | prints the super block and blocks group information for the filesystem |
23 | present on | |
24 | .I device. | |
25 | .PP | |
d1c9b6ea TT |
26 | .B Note: |
27 | When used with a mounted filesystem, the printed | |
28 | information may be old or inconsistent. | |
5c576477 TT |
29 | .SH OPTIONS |
30 | .TP | |
caf8ce4c | 31 | .B \-b |
5c576477 TT |
32 | print the blocks which are reserved as bad in the filesystem. |
33 | .TP | |
db197a81 | 34 | .B \-o superblock=\fIsuperblock |
caf8ce4c TT |
35 | use the block |
36 | .I superblock | |
37 | when examining the filesystem. | |
d04ad325 | 38 | This option is not usually needed except by a filesystem wizard who |
8139367b | 39 | is examining the remains of a very badly corrupted filesystem. |
02e7dd9a | 40 | .TP |
db197a81 | 41 | .B \-o blocksize=\fIblocksize |
caf8ce4c TT |
42 | use blocks of |
43 | .I blocksize | |
44 | bytes when examining the filesystem. | |
d04ad325 | 45 | This option is not usually needed except by a filesystem wizard who |
8139367b | 46 | is examining the remains of a very badly corrupted filesystem. |
02e7dd9a | 47 | .TP |
caf8ce4c | 48 | .B \-f |
d04ad325 | 49 | force dumpe2fs to display a filesystem even though it may have some |
2740156b TT |
50 | filesystem feature flags which dumpe2fs may not understand (and which |
51 | can cause some of dumpe2fs's display to be suspect). | |
0858268d DW |
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. | |
d04ad325 | 60 | .TP |
caf8ce4c | 61 | .B \-h |
2740156b TT |
62 | only display the superblock information and not any of the block |
63 | group descriptor detail information. | |
64 | .TP | |
348e43dc | 65 | .B \-i |
d04ad325 | 66 | display the filesystem data from an image file created by |
348e43dc | 67 | .BR e2image , |
d04ad325 | 68 | using |
348e43dc TT |
69 | .I device |
70 | as the pathname to the image file. | |
71 | .TP | |
32b8802a SI |
72 | .B \-m |
73 | If the | |
74 | .B mmp | |
75 | feature is enabled on the filesystem, check if | |
76 | .I device | |
77 | is in use by another node, see | |
78 | .BR e2mmpstatus (8) | |
79 | for full details. If used together with the | |
80 | .B \-i | |
81 | option, only the MMP block information is printed. | |
82 | .TP | |
80c22c90 TT |
83 | .B \-x |
84 | print the detailed group information block numbers in hexadecimal format | |
85 | .TP | |
caf8ce4c | 86 | .B \-V |
d04ad325 | 87 | print the version number of |
583ccdc3 TT |
88 | .B dumpe2fs |
89 | and exit. | |
32b8802a SI |
90 | .SH EXIT CODE |
91 | .B dumpe2fs | |
92 | exits with a return code of 0 if the operation completed without errors. | |
93 | It will exit with a non-zero return code if there are any errors, such | |
94 | as problems reading a valid superblock, bad checksums, or if the device | |
95 | is in use by another node and | |
96 | .B -m | |
97 | is specified. | |
3839e657 | 98 | .SH BUGS |
32b8802a | 99 | You may need to know the physical filesystem structure to understand the |
3839e657 TT |
100 | output. |
101 | .SH AUTHOR | |
d04ad325 | 102 | .B dumpe2fs |
2e5a1b9e TT |
103 | was written by Remy Card <Remy.Card@linux.org>. It is currently being |
104 | maintained by Theodore Ts'o <tytso@alum.mit.edu>. | |
3839e657 TT |
105 | .SH AVAILABILITY |
106 | .B dumpe2fs | |
d04ad325 | 107 | is part of the e2fsprogs package and is available from |
348e43dc | 108 | http://e2fsprogs.sourceforge.net. |
3839e657 TT |
109 | .SH SEE ALSO |
110 | .BR e2fsck (8), | |
32b8802a | 111 | .BR e2mmpstatus (8), |
3839e657 | 112 | .BR mke2fs (8), |
3c22bf7e TT |
113 | .BR tune2fs (8). |
114 | .BR ext4 (5) | |
348e43dc | 115 |