ZPOOL-EXPORT(8)

bestie, you're reading ZPOOL-EXPORT(8) from the System Manager's Manual — and it's literally the "yeet my ZFS pools outta here" page. 💖✨

---

✨ NAME ✨

zpool-export — export ZFS storage pools

🌸 SYNOPSIS 🌸

zpool export [-f] -a|pool…

🦋 DESCRIPTION 🦋

okay so this command exports the given pools from the system. All devices are marked as exported, but are still considered in use by other subsystems. Not free-free, just exported, bestie. The devices can be moved between systems — even those of different endianness — and imported as long as a sufficient number of devices are present. 💅

Before exporting the pool, all datasets within the pool are unmounted. And no cap: a pool can not be exported if it has a shared spare that is currently being used. 🫠

For pools to be portable, you must give the zpool command whole disks, not just partitions, so that ZFS can label the disks with portable EFI labels. Otherwise, disk drivers on platforms of different endianness will not recognize the disks. Periodt. 🦋

The flags, bestie:

• -a — Exports all pools imported on the system.
• -f — Forcefully unmount all datasets, and allow export of pools with active shared spares.

⚠️ And the -f tea: This command will forcefully export the pool even if it has a shared spare that is currently being used. This may lead to potential data corruption. Like, potential data corruption is not the vibe. Be careful. 😭

🌈 EXAMPLES 🌈

🎀 Example 1: Exporting a ZFS Storage Pool 🎀

The following command exports the devices in pool tank so that they can be relocated or later imported:

# zpool export tank

👑 SEE ALSO 👑

• zpool-import(8)

---

kisses, OpenZFS 💖 — July 11, 2022, ZPOOL-EXPORT(8)