HomeFreeBSD

4465 zpool(1M) is able to offline cache vdevs despite what man page says

Description

4465 zpool(1M) is able to offline cache vdevs despite what man page says
5659 in the manual page for zpool(1M), one misuse of the word 'zpool' to describe a pool

illumos/illumos-gate@c8323d4323a565676ba44883bfeb289d9ed8813e
https://github.com/illumos/illumos-gate/commit/c8323d4323a565676ba44883bfeb289d9ed8813e

https://www.illumos.org/issues/4465

zpool(1M) is able to offline cache vdevs despite man page saying that it isn't:
       zpool offline [-t] pool device ...
           Takes the specified physical device offline. While the device is
           offline, no attempt is made to read or write to the device.

           This command is not applicable to spares or cache devices.
altair:root:~# zpool create testoff c9t67d0 cache c9t71d0
altair:root:~# zpool status testoff
  pool: testoff
 state: ONLINE
  scan: none requested
config:

        NAME        STATE     READ WRITE CKSUM
        testoff     ONLINE       0     0     0
          c9t67d0   ONLINE       0     0     0
        cache
          c9t71d0   ONLINE       0     0     0

errors: No known data errors
altair:root:~# zpool offline testoff c9t71d0
altair:root:~# zpool status testoff
  pool: testoff
 state: ONLINE
status: One or more devices has been taken offline by the administrator.
        Sufficient replicas exist for the pool to continue functioning in a
        degraded state.
action: Online the device using 'zpool online' or replace the device with
        'zpool replace'.
  scan: none requested

https://www.illumos.org/issues/5659

At https://github.com/illumos/illumos-gate/blob/master/usr/src/man/man1m/
zpool.1m#L931
     Do not add a disk that is currently configured as a quorum device to
     a zpool.
– should be:
     Do not add a disk that is currently configured as a quorum device to
     a pool.

Reviewed by: Matthew Ahrens <mahrens@delphix.com>
Approved by: Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>
Author: Yuri Pankov <yuri.pankov@nexenta.com>

Details

Provenance
avgAuthored on
Reviewer
matthew
Parents
rS318935: MFV r318934: 8070 Add some ZFS comments
Branches
Unknown
Tags
Unknown