.\" -*- 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
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.
.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 filesystem block size.
.TP
-.BI \-h
+.B \-h
Print the usage of the program.
.SH EXAMPLE
# e2freefrag /dev/vgroot/lvhome
.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 chunk: 4 KB
+Min. free extent: 4 KB
.br
-Max free chunk: 24008 KB
+Max. free extent: 24008 KB
.br
-Avg free chunk: 252 KB
+Avg. free extent: 252 KB
.br
-HISTOGRAM OF FREE CHUNK SIZES:
+HISTOGRAM OF FREE EXTENT SIZES:
.br
-Chunk Size Range : Free chunks Free Blocks Percent
+Extent Size Range : Free extents Free Blocks Percent
.br
4K... 8K- : 704 704 0.2%
.br
git://git.whamcloud.com / tools / e2fsprogs.git / blobdiff