Whamcloud - gitweb
e2fsck: map PROMPT_* values to prompt messages
[tools/e2fsprogs.git] / misc / e2freefrag.8.in
index 77fadd7..e77bcdb 100644 (file)
@@ -1,5 +1,5 @@
 .\" -*- nroff -*-
-.TH E2FREEFRAG 8
+.TH E2FREEFRAG 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
 .SH NAME
 e2freefrag \- report free space fragmentation information
 .SH SYNOPSIS
@@ -16,25 +16,28 @@ e2freefrag \- report free space fragmentation information
 .B e2freefrag
 is used to report free space fragmentation on ext2/3/4 file systems.
 .I filesys
-is the filesystem device name (e.g.
+is the file system device name (e.g.
 .IR /dev/hdc1 ", " /dev/md0 ).
 The
 .B e2freefrag
 program will scan the block bitmap information to check how many free blocks
 are present as contiguous and aligned free space. The percentage of contiguous
 free blocks of size and of alignment
-.IR chunk_kb
+.I chunk_kb
 is reported.  It also displays the minimum/maximum/average free chunk size in
-the filesystem, along with a histogram of all free chunks.  This information
-can be used to gauge the level of free space fragmentation in the filesystem.
+the file system, along with a histogram of all free chunks.  This information
+can be used to gauge the level of free space fragmentation in the file system.
 .SH OPTIONS
 .TP
 .BI \-c " chunk_kb"
-Desired size of chunk. It is specified in units of kilobytes (KB). If no
+If a chunk size is specified, then
+.B e2freefrag
+will print how many free chunks of size
 .I chunk_kb
-is specified on the command line, then the default value is 1024KB.
+are available in units of kilobytes (Kb).  The chunk size must be a
+power of two and be larger than file system block size.
 .TP
-.BI \-h
+.B \-h
 Print the usage of the program.
 .SH EXAMPLE
 # e2freefrag /dev/vgroot/lvhome
@@ -47,12 +50,6 @@ Total blocks: 1504085
 .br
 Free blocks: 292995 (19.5%)
 .br
-Chunk size: 1048576 bytes (256 blocks)
-.br
-Total chunks: 5876
-.br
-Free chunks: 463 (7.9%)
-.br
 
 Min. free extent: 4 KB
 .br