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 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 .B Note:
  27 When used with a mounted file system, 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 file system.
  33 .TP
  34 .B \-o superblock=\fIsuperblock
  35 use the block
  36 .I superblock
  37 when examining the file system.
  38 This option is not usually needed except by a file system wizard who
  39 is examining the remains of a very badly corrupted file system.
  40 .TP
  41 .B \-o blocksize=\fIblocksize
  42 use blocks of
  43 .I blocksize
  44 bytes when examining the file system.
  45 This option is not usually needed except by a file system wizard who
  46 is examining the remains of a very badly corrupted file system.
  47 .TP
  48 .B \-f
  49 force dumpe2fs to display a file system even though it may have some
  50 file system 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 file system 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 \-m
  73 If the
  74 .B mmp
  75 feature is enabled on the file system, 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
  83 .B \-x
  84 print the detailed group information block numbers in hexadecimal format
  85 .TP
  86 .B \-V
  87 print the version number of
  88 .B dumpe2fs
  89 and exit.
  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.
  98 .SH BUGS
  99 You may need to know the physical file system structure to understand the
 100 output.
 101 .SH AUTHOR
 102 .B dumpe2fs
 103 was written by Remy Card <Remy.Card@linux.org>.  It is currently being
 104 maintained by Theodore Ts'o <tytso@alum.mit.edu>.
 105 .SH AVAILABILITY
 106 .B dumpe2fs
 107 is part of the e2fsprogs package and is available from
 108 http://e2fsprogs.sourceforge.net.
 109 .SH SEE ALSO
 110 .BR e2fsck (8),
 111 .BR e2mmpstatus (8),
 112 .BR mke2fs (8),
 113 .BR tune2fs (8).
 114 .BR ext4 (5)
 115