-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Describe the fragmentation metric in zpool.8
While it's commonly understood that a larger fragmentation value is worse than a smaller one it is never explained anywhere but the source what this value means. Using the comment in the source add this information to the zpool.8 man page. Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
- Loading branch information
1 parent
24ef51f
commit 3235065
Showing
1 changed file
with
32 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
1 comment
on commit 3235065
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm glad to see this getting addressed but I think a bit more explanation is warranted as to how the overall pool fragmentation is calculated. The text above, taken from the code comments, relate to a single metaslab but doesn't really give the big picture as to how the single metric displayed to the user is calculated.
Maybe this ought to say "The fragmentation metric, expressed as a percentage, of the pool described below. It is not, directly, a percentage of anything but is a metric in which the value is inversely proportional to the amount of contiguous free space available". This could lead into the internals discussion below.