zpool-export(8)

zpool-export8

Export zfs storage pools

Usage

zpool {export [-f] -a | pool…}

Overview

Exports the given pools from the system. All devices are marked as exported, but are still considered in use by other subsystems. 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. 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.

-a

Exports all pools imported on the system.

-f

Forcefully unmount all datasets, and allow export of pools with active shared spares.

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.

Examples

Example 1 : No 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

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13

From zfsutils-linux 2.3.9-0+deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.