svn commit: r354380 - vendor/illumos/dist/man/man1m
Andriy Gapon
avg at FreeBSD.org
Wed Nov 6 08:53:52 UTC 2019
Author: avg
Date: Wed Nov 6 08:53:52 2019
New Revision: 354380
URL: https://svnweb.freebsd.org/changeset/base/354380
Log:
8899 zpool list property documentation doesn't match actual behaviour
illumos/illumos-gate at 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 at nexenta.com> (yuripv)
Modified:
vendor/illumos/dist/man/man1m/zpool.1m
Modified: vendor/illumos/dist/man/man1m/zpool.1m
==============================================================================
--- vendor/illumos/dist/man/man1m/zpool.1m Wed Nov 6 08:47:09 2019 (r354379)
+++ vendor/illumos/dist/man/man1m/zpool.1m Wed Nov 6 08:53:52 2019 (r354380)
@@ -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
.Dt ZPOOL 1M
.Os
.Sh NAME
@@ -521,10 +521,8 @@ change the behavior of the pool.
.Pp
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 enable
See
.Xr zpool-features 5
for details.
-.It Sy used
-Amount of storage space used within the pool.
.El
.Pp
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
More information about the svn-src-vendor
mailing list