zpool
Manage ZFS storage pools
TLDR
List all pools
SYNOPSIS
zpool command [options] [arguments]
DESCRIPTION
zpool manages ZFS storage pools. A pool is composed of virtual devices (vdevs) which can be single disks, mirrors, or RAID-Z configurations. Pools provide the underlying storage that ZFS datasets use.
Vdev types:
- mirror - Data mirrored across 2+ disks
- raidz, raidz2, raidz3 - RAID-Z with 1/2/3 parity disks
- spare - Hot spare disk
- cache - L2ARC read cache (SSD)
- log - ZIL write log (SSD)
Scrubbing verifies all data checksums and repairs errors using redundant copies. Regular scrubs are essential for data integrity.
SUBCOMMANDS
create pool vdev...
Create new storage pooldestroy pool
Destroy pool and all dataadd pool vdev...
Add devices to poolremove pool device
Remove device from poollist [pool]
List pools and propertiesstatus [pool]
Show detailed statusiostat [pool] [interval]
Display I/O statisticsscrub pool
Verify data integrityimport [pool]
Import pool(s)export pool
Export pool for transportupgrade pool
Upgrade pool versionhistory pool
Show pool command historyattach pool device newdevice_
Attach mirror to devicedetach pool device
Detach mirror devicereplace pool old new
Replace disk in poolonline/offline pool device
Bring device online/offline
CAVEATS
Most operations require root privileges.
Pool destruction is permanent. zpool destroy deletes all data.
RAID-Z cannot be expanded by adding disks to an existing vdev (as of OpenZFS 2.2, expansion is possible on some platforms).
Regular scrubs are critical. ZFS detects but cannot repair single-disk pool errors.
SEE ALSO
zfs(8), zdb(8), zpool-status(8)
