Debian Codegraph @

upstream/debian-unstable/man8/dumpe2fs.8

raw
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 "March 2025" "E2fsprogs version 1.47.4"
6 .SH NAME
7 dumpe2fs \- dump ext2/ext3/ext4 file system 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 file system
23 present on
24 .I device.
25 .PP
26 The
27 .I device
28 specifier can either be a filename (i.e., /dev/sda1), or a LABEL or UUID
29 specifier: "\fBLABEL=\fIvolume-label\fR" or "\fBUUID=\fIuuid\fR". (i.e.,
30 LABEL=home or UUID=e40486c6-84d5-4f2f-b99c-032281799c9d).
31 .PP
32 .B Note:
33 When used with a mounted file system, the printed
34 information may be old or inconsistent.
35 .SH OPTIONS
36 .TP
37 .B \-b
38 print the blocks which are reserved as bad in the file system.
39 .TP
40 .B \-o superblock=\fIsuperblock
41 use the block
42 .I superblock
43 when examining the file system.
44 This option is not usually needed except by a file system wizard who
45 is examining the remains of a very badly corrupted file system.
46 .TP
47 .B \-o blocksize=\fIblocksize
48 use blocks of
49 .I blocksize
50 bytes when examining the file system.
51 This option is not usually needed except by a file system wizard who
52 is examining the remains of a very badly corrupted file system.
53 .TP
54 .B \-f
55 force dumpe2fs to display a file system even though it may have some
56 file system feature flags which dumpe2fs may not understand (and which
57 can cause some of dumpe2fs's display to be suspect).
58 .TP
59 .B \-g
60 display the group descriptor information in a machine readable colon-separated
61 value format. The fields displayed are the group number; the number of the
62 first block in the group; the superblock location (or -1 if not present); the
63 range of blocks used by the group descriptors (or -1 if not present); the block
64 bitmap location; the inode bitmap location; and the range of blocks used by the
65 inode table.
66 .TP
67 .B \-h
68 only display the superblock information and not any of the block
69 group descriptor detail information.
70 .TP
71 .B \-i
72 display the file system data from an image file created by
73 .BR e2image ,
74 using
75 .I device
76 as the pathname to the image file.
77 .TP
78 .B \-m
79 If the
80 .B mmp
81 feature is enabled on the file system, check if
82 .I device
83 is in use by another node, see
84 .BR e2mmpstatus (8)
85 for full details. If used together with the
86 .B \-i
87 option, only the MMP block information is printed.
88 .TP
89 .B \-x
90 print the detailed group information block numbers in hexadecimal format
91 .TP
92 .B \-V
93 print the version number of
94 .B dumpe2fs
95 and exit.
96 .SH EXIT CODE
97 .B dumpe2fs
98 exits with a return code of 0 if the operation completed without errors.
99 It will exit with a non-zero return code if there are any errors, such
100 as problems reading a valid superblock, bad checksums, or if the device
101 is in use by another node and
102 .B -m
103 is specified.
104 .SH BUGS
105 You may need to know the physical file system structure to understand the
106 output.
107 .SH AUTHOR
108 .B dumpe2fs
109 was written by Remy Card <[email protected]>. It is currently being
110 maintained by Theodore Ts'o <[email protected]>.
111 .SH AVAILABILITY
112 .B dumpe2fs
113 is part of the e2fsprogs package and is available from
114 http://e2fsprogs.sourceforge.net.
115 .SH SEE ALSO
116 .BR e2fsck (8),
117 .BR e2mmpstatus (8),
118 .BR mke2fs (8),
119 .BR tune2fs (8).
120 .BR ext4 (5)
121