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

History

  • FreeBSD 16.0-CURRENT (2026-10-27): the text shown here
  • FreeBSD 15.1-RELEASE to FreeBSD 15.0-RELEASE
  • FreeBSD 14.5-RELEASE to FreeBSD 14.1-RELEASE
  • FreeBSD 14.0-RELEASE
  • FreeBSD 13.5-RELEASE to FreeBSD 13.4-RELEASE
  • FreeBSD 13.3-RELEASE to FreeBSD 13.1-RELEASE
  • FreeBSD 13.0-RELEASE

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