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

FreeBSD Manual Pages

  
 
  

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

NAME
     zpool-initialize -- write to unallocated regions of ZFS storage pool

SYNOPSIS
     zpool initialize [-c|-s |-u] [-w] -a|pool [device]a|

DESCRIPTION
     Begins  initializing by writing to all unallocated regions on the specified
     devices, or all eligible devices in the pool if no individual  devices  are
     specified.  Only leaf data or log devices may be initialized.

     -a, --all
	     Begin, cancel, suspend initializing on all pools.

     -c, --cancel
	     Cancel  initializing  on the specified devices, or all eligible de-
	     vices if none are specified.  If one or more target devices are in-
	     valid or are not currently being initialized, the command will fail
	     and no cancellation will occur on any device.

     -s, --suspend
	     Suspend initializing on the specified devices, or all eligible  de-
	     vices if none are specified.  If one or more target devices are in-
	     valid or are not currently being initialized, the command will fail
	     and  no suspension will occur on any device.  Initializing can then
	     be resumed by running zpool initialize with no flags on  the  rele-
	     vant target devices.

     -u, --uninit
	     Clears  the  initialization  state on the specified devices, or all
	     eligible devices if none are specified.  If the devices  are  being
	     actively  initialized  the  command will fail.  After being cleared
	     zpool initialize with no flags can be used to re-initialize all un-
	     allocated regions on the relevant target devices.

     -w, --wait
	     Wait until the devices have finished initializing before returning.

SEE ALSO
     zpool-add(8), zpool-attach(8), zpool-create(8), zpool-online(8),  zpool-re-
     place(8), zpool-trim(8)

FreeBSD ports 15.quarterly	  July 30, 2025 	     ZPOOL-INITIALIZE(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zpool-initialize&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help