c/mirror_zfs
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_zfs.git synced 2024-12-26 19:19:32 +03:00
Code Issues Packages Projects Releases Wiki Activity

Hint about zpool free vs zfs available

Browse Source 
Also describe free/allocated/fragmentation

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Matt Ahrens <mahrens@delphix.com>
Signed-off-by: Josh Soref <jsoref@users.noreply.github.com>
Closes #7565 
Closes #8483
This commit is contained in:
Josh Soref 2019-04-04 13:00:16 -04:00 committed by Brian Behlendorf
parent f4e35b165c
commit af65079300
1 changed files with 25 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
man/man8/zpool.8
View File

@ -587,6 +587,11 @@ The following are read-only properties:
.Bl -tag -width Ds .Bl -tag -width Ds
.It Cm allocated .It Cm allocated
Amount of storage used within the pool. Amount of storage used within the pool.
See
.Sy fragmentation
and
.Sy free
for more information.
.It Sy capacity .It Sy capacity
Percentage of pool space used. Percentage of pool space used.
This property can also be referred to by its shortened column name, This property can also be referred to by its shortened column name,
@ -601,9 +606,28 @@ been brought online
.Pc . .Pc .
This space occurs when a LUN is dynamically expanded. This space occurs when a LUN is dynamically expanded.
.It Sy fragmentation .It Sy fragmentation
The amount of fragmentation in the pool. The amount of fragmentation in the pool. As the amount of space
.Sy allocated
increases, it becomes more difficult to locate
.Sy free
space. This may result in lower write performance compared to pools with more
unfragmented free space.
.It Sy free .It Sy free
The amount of free space available in the pool. The amount of free space available in the pool.
By contrast, the
.Xr zfs 8
.Sy available
property describes how much new data can be written to ZFS filesystems/volumes.
The zpool
.Sy free
property is not generally useful for this purpose, and can be substantially more than the zfs
.Sy available
space. This discrepancy is due to several factors, including raidz party; zfs
reservation, quota, refreservation, and refquota properties; and space set aside by
.Sy spa_slop_shift
(see
.Xr zfs-module-parameters 5
for more information).
.It Sy freeing .It Sy freeing
After a file system or snapshot is destroyed, the space it was using is After a file system or snapshot is destroyed, the space it was using is
returned to the pool asynchronously. returned to the pool asynchronously.