Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ZPOOL-REMOVE(8)		  BSD System Manager's Manual	       ZPOOL-REMOVE(8)

     zpool-remove -- Remove a device from a ZFS	storage	pool

     zpool remove [-npw] pool device...
     zpool remove -s pool

     zpool remove [-npw] pool device...
	     Removes the specified device from the pool.  This command sup-
	     ports removing hot	spare, cache, log, and both mirrored and non-
	     redundant primary top-level vdevs,	including dedup	and special
	     vdevs.  When the primary pool storage includes a top-level	raidz
	     vdev only hot spare, cache, and log devices can be	removed.  Note
	     that keys for all encrypted datasets must be loaded for top-level
	     vdevs to be removed.

	     Removing a	top-level vdev reduces the total amount	of space in
	     the storage pool.	The specified device will be evacuated by
	     copying all allocated space from it to the	other devices in the
	     pool.  In this case, the zpool remove command initiates the re-
	     moval and returns,	while the evacuation continues in the back-
	     ground.  The removal progress can be monitored with zpool status.
	     If	an IO error is encountered during the removal process it will
	     be	cancelled. The device_removal feature flag must	be enabled to
	     remove a top-level	vdev, see zpool-features(5).

	     A mirrored	top-level device (log or data) can be removed by spec-
	     ifying the	top-level mirror for the same.	Non-log	devices	or
	     data devices that are part	of a mirrored configuration can	be re-
	     moved using the zpool detach command.

	     -n	     Do	not actually perform the removal ("no-op").  Instead,
		     print the estimated amount	of memory that will be used by
		     the mapping table after the removal completes.  This is
		     nonzero only for top-level	vdevs.

	     -p	     Used in conjunction with the -n flag, displays numbers as
		     parsable (exact) values.

	     -w	     Waits until the removal has completed before returning.

     zpool remove -s pool
	     Stops and cancels an in-progress removal of a top-level vdev.

     zpool-add(8), zpool-detach(8), zpool-offline(8), zpool-labelclear(8),
     zpool-replace(8), zpool-split(8)

BSD				August 9, 2019				   BSD


Want to link to this manual page? Use this URL:

home | help