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

FreeBSD Manual Pages

  
 
  

home | help
ZPOOL-TRIM(8)		FreeBSD	System Manager's Manual		 ZPOOL-TRIM(8)

NAME
     zpool-trim	-- initiate TRIM of free space in ZFS storage pool

SYNOPSIS
     zpool trim	[-dw] [-r rate]	[-c|-s]	pool [device]a|

DESCRIPTION
     Initiates an immediate on-demand TRIM operation for all of	the free space
     in	a pool.	 This operation	informs	the underlying storage devices of all
     blocks in the pool	which are no longer allocated and allows thinly	provi-
     sioned devices to reclaim the space.

     A manual on-demand	TRIM operation can be initiated	irrespective of	the
     autotrim pool property setting.  See the documentation for	the autotrim
     property above for	the types of vdev devices which	can be trimmed.

     -d, --secure
	     Causes a secure TRIM to be	initiated.  When performing a secure
	     TRIM, the device guarantees that data stored on the trimmed
	     blocks has	been erased.  This requires support from the device
	     and is not	supported by all SSDs.

     -r, --rate	rate
	     Controls the rate at which	the TRIM operation progresses.	With-
	     out this option TRIM is executed as quickly as possible.  The
	     rate, expressed in	bytes per second, is applied on	a per-vdev ba-
	     sis and may be set	differently for	each leaf vdev.

     -c, --cancel
	     Cancel trimming on	the specified devices, or all eligible devices
	     if	none are specified.  If	one or more target devices are invalid
	     or	are not	currently being	trimmed, the command will fail and no
	     cancellation will occur on	any device.

     -s, --suspend
	     Suspend trimming on the specified devices,	or all eligible	de-
	     vices if none are specified.  If one or more target devices are
	     invalid or	are not	currently being	trimmed, the command will fail
	     and no suspension will occur on any device.  Trimming can then be
	     resumed by	running	zpool trim with	no flags on the	relevant tar-
	     get devices.

     -w, --wait
	     Wait until	the devices are	done being trimmed before returning.

SEE ALSO
     zpoolprops(7), zpool-initialize(8), zpool-wait(8)

FreeBSD	13.0			 May 27, 2021			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=zpool-trim&sektion=8&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help