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-all mailing list