OS Manuals

/usr/bin/zpool

Advanced filesystem and volume manager

From zfs 2.4.4-r4 (os), captured 2026-11-05 by running zpool --help (exit 0). permalink

usage: zpool command args ...
where 'command' is one of the following:

	version [-j]

	create [-fnd] [-o property=value] ...
	    [-O file-system-property=value] ...
	    [-m mountpoint] [-R root] <pool> <vdev> ...
	destroy [-f] <pool>

	add [-afgLnP] [-o property=value] <pool> <vdev> ...
	remove [-npsw] <pool> <device> ...

	labelclear [-f] <vdev>

	checkpoint [-d [-w]] <pool> ...
	prefetch [-t <type>] <pool>

	list [-gHLpPv] [-o property[,...]] [-j [--json-int, --json-pool-key-guid]] ...
	    [-T d|u] [pool] [interval [count]]
	iostat [[[-c [script1,script2,...][-lq]]|[-rw]] [-T d | u] [-ghHLpPvy]
	    [[pool ...]|[pool vdev ...]|[vdev ...]] [[-n] interval [count]]
	status [-DdegiLPpstvx] [-c script1[,script2,...]] ...
	    [-j|--json [--json-flat-vdevs] [--json-int] [--json-pool-key-guid]] ...
	    [-T d|u] [--power] [pool] [interval [count]]

	online [--power][-e] <pool> <device> ...
	offline [--power]|[[-f][-t]] <pool> <device> ...
	clear [[--power]|[-nF]] <pool> [device]
	reopen [-n] <pool>

	attach [-fsw] [-o property=value] <pool> <vdev> <new-device>
	detach <pool> <device>
	replace [-fsw] [-o property=value] <pool> <device> [new-device]
	split [-gLnPl] [-R altroot] [-o mntopts]
	    [-o property=value] <pool> <newpool> [<device> ...]

	initialize [-c | -s | -u] [-w] <-a | <pool> [<device> ...]>
	resilver <pool> ...
	scrub [-e | -s | -p | -C | -E | -S] [-w] <-a | <pool> [<pool> ...]>
	trim [-dw] [-r <rate>] [-c | -s] <-a | <pool> [<device> ...]>

	import [-d dir] [-D]
	import [-o mntopts] [-o property=value] ...
	    [-d dir | -c cachefile] [-D] [-l] [-f] [-m] [-N] [-R root] [-F [-n]] -a
	import [-o mntopts] [-o property=value] ...
	    [-d dir | -c cachefile] [-D] [-l] [-f] [-m] [-N] [-R root] [-F [-n]]
	    [--rewind-to-checkpoint] <pool | id> [newpool]
	export [-af] <pool> ...
	upgrade
	upgrade -v
	upgrade [-V version] <-a | pool ...>
	reguid [-g guid] <pool>

	history [-il] [<pool>] ...
	events [-vHf [pool] | -c]

	get [-Hp] [-j [--json-int, --json-pool-key-guid]] ...
	    [-o "all" | field[,...]] <"all" | property[,...]> <pool> ...
	set <property=value> <pool>
	set <vdev_property=value> <pool> <vdev>
	sync [pool] ...

	wait [-Hp] [-T d|u] [-t <activity>[,...]] <pool> [interval]

	ddtprune -d|-p <amount> <pool>

For further help on a command or topic, run: zpool help [<topic>]
Exit status (3) from the manual page
0Successful completion.
1An error occurred.
2Invalid command line options were specified.
Examples (8) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.