diff options
authorAndriy Gapon <avg@FreeBSD.org>2019-11-06 08:53:52 +0000
committerAndriy Gapon <avg@FreeBSD.org>2019-11-06 08:53:52 +0000
commit6532d07b7c52767faee7fa1ca23a1e8d0af1a935 (patch)
parent431b557a046211b10745d256bca9432b92f92604 (diff)
8899 zpool list property documentation doesn't match actual behaviour
illumos/illumos-gate@b0e142e57dfda6f02bf1fa66973c610f5fefe8cb https://github.com/illumos/illumos-gate/commit/b0e142e57dfda6f02bf1fa66973c610f5fefe8cb https://www.illumos.org/issues/8899 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=221795: The `zpool list` section of the zpool(8) manpage says that the default list of displayed properties is as below: The default list is name, size, used, available, fragmentation, expandsize, capacity, health, altroot. This does not seem to be the case. In fact: # zpool list NAME SIZE ALLOC FREE EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT tank 10.9T 6.05T 4.83T - 29% 55% 1.00x ONLINE - The Properties section of the same manpage includes the `used` property, but this seems not to be recognised: # zpool list -o used bad property list: invalid property 'used' usage: [...] # The usage message produced here indeed doesn't include `used`. Author: Yuri Pankov <yuri.pankov@nexenta.com> (yuripv)
Notes: svn path=/vendor/illumos/dist/; revision=354380
1 files changed, 5 insertions, 9 deletions
diff --git a/man/man1m/zpool.1m b/man/man1m/zpool.1m
index 38bc74f76ac6..30876beb2ee3 100644
--- a/man/man1m/zpool.1m
+++ b/man/man1m/zpool.1m
@@ -25,7 +25,7 @@
.\" Copyright (c) 2017 Datto Inc.
.\" Copyright (c) 2017 George Melikov. All Rights Reserved.
-.Dd August 23, 2017
+.Dd December 6, 2017
@@ -521,10 +521,8 @@ change the behavior of the pool.
The following are read-only properties:
.Bl -tag -width Ds
-.It Sy available
-Amount of storage available within the pool.
-This property can also be referred to by its shortened column name,
-.Sy avail .
+.It Cm allocated
+Amount of storage space used within the pool.
.It Sy bootsize
The size of the system boot partition.
This property can only be set at pool creation time and is read-only once pool
@@ -572,8 +570,6 @@ Information about unsupported features that are enabled on the pool.
.Xr zpool-features 5
for details.
-.It Sy used
-Amount of storage space used within the pool.
The space usage properties report actual physical space available to the
@@ -1532,8 +1528,8 @@ See the
.Sx Properties
section for a list of valid properties.
The default list is
-.Sy name , size , used , available , fragmentation , expandsize , capacity ,
-.Sy dedupratio , health , altroot .
+.Cm name , size , allocated , free , expandsize , fragmentation , capacity ,
+.Cm dedupratio , health , altroot .
.It Fl p
Display numbers in parsable
.Pq exact