ZPOOL-OFFLINE(8)

💅 ZPOOL-OFFLINE — the "bestie needs a lil break" edition (section 8 of the System Manager's Manual, for real) ✨

okay so. imagine ur ZFS pool is a whole friend group and one of the disks is Going Through It. this page is about giving that disk a nap or waking it back up. 🌸 it's zpool-offline, and it lives in section 8, and it is genuinely so useful, iykyk.

---

✨ NAME ✨

zpool-offline — take physical devices offline in ZFS storage pool 🫶

---

🎀 SYNOPSIS 🎀

zpool offline [--power|[-ft]] pool device…
zpool online [--power] [-e] pool device…

---

👑 DESCRIPTION 👑

🦋 zpool offline [--power|[-ft]] pool device…

Takes the specified physical device offline. bestie it's literally putting the disk to sleep. 😴 While the device is offline, no attempt is made to read or write to the device. like, none. zero. she's resting.

heads up: This command is not applicable to spares. spares are not invited to this party, sorry 💀

• --power — Power off the device's slot in the storage enclosure. the lil slot itself gets the off switch. 🔌 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. so like, she's not napping, she's officially marked as Problematic and it STAYS that way through imports unless u said -t. no cap.
• -t — Temporary. Upon reboot, the specified physical device reverts to its previous state. it's giving "just a phase" ✨ the disk comes back to how she was after a reboot.

---

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

Brings the specified physical device online. wake up babe, it's time 💖 This command is not applicable to spares. again — spares, not applicable, that's just how it is 🫶

• --power — Power on the device's slot in the storage enclosure and wait for the device to show up before attempting to online it. it literally powers the slot back on and waits for the device to appear before it even tries anything, which is honestly so considerate. 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. glow-up mode 🌈 but listen: 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. like, ALL of them. everyone eats together or nobody eats. that's the rule. no exceptions, periodt.

---

💜 SEE ALSO 💜

• zpool-detach(8)
• zpool-remove(8)
• zpool-reopen(8)
• zpool-resilver(8)

---

and that's the whole page, bestie 💅 this lil icon was brought to you by OpenZFS, dated December 21, 2023 — go forth and offline responsibly, mwah 🎀💖✨