e2image: only skip writing zero blocks when writing to a new file

[tools/e2fsprogs.git] / misc / dumpe2fs.8.in

diff --git a/misc/dumpe2fs.8.in b/misc/dumpe2fs.8.in
index d7d4149..befaf94 100644 (file)
--- a/misc/dumpe2fs.8.in
+++ b/misc/dumpe2fs.8.in
@@ -4,48 +4,67 @@
 .\" 
 .TH DUMPE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
 .SH NAME
-dumpe2fs \- dump filesystem information
+dumpe2fs \- dump ext2/ext3/ext4 filesystem information
 .SH SYNOPSIS
 .B dumpe2fs
 [
-.B -b
+.B \-bfhixV
 ]
 [
-.B -ob superblock
+.B \-o superblock=\fIsuperblock
 ]
 [
-.B -oB blocksize
+.B \-o blocksize=\fIblocksize
 ]
-[
-.B -V
-]
-device
+.I device
 .SH DESCRIPTION
-.BI dumpe2fs
+.B dumpe2fs
 prints the super block and blocks group information for the filesystem
 present on
 .I device.
 .PP
-.BI dumpe2fs
-is similar to Berkeley's
-.BI dumpfs
-program for the BSD Fast File System.
+.B Note:
+When used with a mounted filesystem, the printed
+information may be old or inconsistent.
 .SH OPTIONS
 .TP
-.I -b
+.B \-b
 print the blocks which are reserved as bad in the filesystem.
 .TP
-.I -ob superblock
-use the superblock specifed on the command line when examining the filesystem.
+.B \-o superblock=\fIsuperblock
+use the block
+.I superblock
+when examining the filesystem.
 This option is not usually needed except by a filesystem wizard who 
-is examining the remains of a very badly corupted filesystem.
+is examining the remains of a very badly corrupted filesystem.
 .TP
-.I -oB blocksize
-use the blocksize specified on the command line when examining the filesystem.
+.B \-o blocksize=\fIblocksize
+use blocks of
+.I blocksize
+bytes when examining the filesystem.
 This option is not usually needed except by a filesystem wizard who 
-is examining the remains of a very badly corupted filesystem.
+is examining the remains of a very badly corrupted filesystem.
+.TP
+.B \-f
+force dumpe2fs to display a filesystem even though it may have some 
+filesystem feature flags which dumpe2fs may not understand (and which
+can cause some of dumpe2fs's display to be suspect).
+.TP 
+.B \-h
+only display the superblock information and not any of the block
+group descriptor detail information.
+.TP
+.B \-i
+display the filesystem data from an image file created by 
+.BR e2image ,
+using 
+.I device
+as the pathname to the image file.
+.TP
+.B \-x
+print the detailed group information block numbers in hexadecimal format
 .TP
-.I -V
+.B \-V
 print the version number of 
 .B dumpe2fs
 and exit.
@@ -54,13 +73,15 @@ You need to know the physical filesystem structure to understand the
 output.
 .SH AUTHOR
 .B dumpe2fs 
-was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
-of the ext2 fs.
+was written by Remy Card <Remy.Card@linux.org>.  It is currently being
+maintained by Theodore Ts'o <tytso@alum.mit.edu>.
 .SH AVAILABILITY
 .B dumpe2fs
-is part of the e2fsprogs package and is available for anonymous 
-ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
+is part of the e2fsprogs package and is available from 
+http://e2fsprogs.sourceforge.net.
 .SH SEE ALSO
 .BR e2fsck (8),
 .BR mke2fs (8),
-.BR tune2fs (8)
+.BR tune2fs (8).
+.BR ext4 (5)
+