Date: Wed, 6 Nov 2019 08:53:52 +0000 (UTC) From: Andriy Gapon <avg@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-vendor@freebsd.org Subject: svn commit: r354380 - vendor/illumos/dist/man/man1m Message-ID: <201911060853.xA68rqfc046840@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@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) 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201911060853.xA68rqfc046840>