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
-
zpooloffline[--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
-tflag was specified. -
-t -
Temporary. Upon reboot, the specified physical device reverts to its previous state.
-
-
zpoolonline[--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_SLOTenvironment 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.