ZPOOL-CLEAR(8)

📦
version 2.4.4 · 7 versions
, in alpine 3.23, alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

✨ zpool-clear — the glow-up your pool's error log desperately needed 💅

okay bestie, so this is the zpool-clear(8) page, straight out of the System Manager's Manual, and it's literally the "clear the drama" button for ZFS storage pools. errors? gone. reset. periodt. 🧚✨

🌸 SYNOPSIS 🌸

zpool clear [--power] pool [device]…

that's it. that's the whole vibe. you pass a pool, you optionally pass some devices, and we clean house. 🫶

💖 DESCRIPTION 💖

So like, this command clears device errors in a pool. That's the whole job. Not me overexplaining, that's genuinely it. 🌈

  • If you specify no arguments, all device errors within the pool get cleared. every last one. spring cleaning energy. 🧹✨
  • If you specify one or more devices, only those errors associated with the specified device or devices get cleared. surgical. precise. main character. 👑

Also, and this is the important bit so listen up: if the pool was suspended, it will be brought back online — provided the devices can actually be accessed. it's giving "we can fix her but only if the hardware cooperates." 😭

⚠️ but wait. Pools with multihost enabled which have been suspended cannot be resumed when there is evidence that the pool was imported by another host. no cap, that's a hard no. The same checks performed during an import will be applied before the clear proceeds, so it's not just vibes — there's an actual gate check. 🚧

🌟 --power 🌟

  • --power — powers on the device's slot in the storage enclosure, then waits for the device to show up before attempting to clear errors. and yes, this is done on all the devices specified. all of them. collectively. group effort. 💪

Alternatively — and this is a cute lil shortcut — you can set the ZPOOL_AUTO_POWER_ON_SLOT environment variable to always enable this behavior, so you never have to type the flag again. obsessed. ✨

💀 Note: This flag currently works on Linux only. sorry to the other platforms, it's not you it's the kernel. 🙈

🔥 SEE ALSO 🔥

iykyk. go read those next, bestie. 📚✨

and that's a wrap on this page, which shipped as part of OpenZFS, dated April 29, 2024 — so yeah, go clear those errors and slay. you've got this. 🎀💜🌸

📦 where this page comes from