zpool-online(8)

zpool-online8

Take physical devices offline in zfs storage pool

Part of zpool-offline(8).

Usage

zpool offline [{--power | [-ft]}] pool device…

zpool online [--power] [-e] pool device…

Overview

zpool offline [--power|[-ft]] pool device… Takes the specified physical device offline or force-fault it. While the device is offline or force-faulted, no attempt is made to read or write to the device. dRAID spares can not be offlined or force faulted. Traditional spares can only be offlined or force-faulted when they are active.

--power

Power off the device's slot in the storage enclosure. This flag currently works on Linux only

-f

Force fault. Instead of offlining the disk, put it into a faulted state. The fault will persist across imports unless the -t flag was specified.

-t

Temporary. Upon reboot, the specified physical device reverts to its previous state.

zpool online [--power] [-e] pool device… Brings the specified physical device online. This command is not applicable to spares.

--power

Power on the device's slot in the storage enclosure and wait for the device to show up before attempting to online it. Alternatively, you can set the ZPOOL_AUTO_POWER_ON_SLOT environment variable to always enable this behavior. This flag currently works on Linux only

-e

Expand the device to use all available space. If the device is part of a mirror or raidz then all devices must be expanded before the new space will become available to the pool.

Releases

15 releases since FreeBSD 13.0-RELEASE; the text changed 6 times.

  1. 13.0
  2. 13.1–13.3
  3. 13.4–13.5
  4. 14.0
  5. 14.1–14.5
  6. 15.0–15.1
  7. 16.0

--power since FreeBSD 14.1-RELEASE.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.