Project

General

Profile

Bug #8899

zpool list property documentation doesn't match actual behaviour

Added by Yuri Pankov almost 2 years ago. Updated over 1 year ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
zfs - Zettabyte File System
Start date:
2017-12-06
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:

Description

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`.


Related issues

Has duplicate illumos gate - Bug #8606: zpool man page was never updated for removal of "used" propertyClosed2017-09-01

Actions

History

#1

Updated by Electric Monk over 1 year ago

  • Status changed from In Progress to Closed
  • % Done changed from 50 to 100

git commit b0e142e57dfda6f02bf1fa66973c610f5fefe8cb

commit  b0e142e57dfda6f02bf1fa66973c610f5fefe8cb
Author: Yuri Pankov <yuri.pankov@nexenta.com>
Date:   2017-12-21T16:40:40.000Z

    8899 zpool list property documentation doesn't match actual behaviour
    Reviewed by: Alexander Pyhalov <alp@rsu.ru>
    Approved by: Dan McDonald <danmcd@joyent.com>

#2

Updated by Yuri Pankov over 1 year ago

  • Has duplicate Bug #8606: zpool man page was never updated for removal of "used" property added

Also available in: Atom PDF