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

FreeBSD Manual Pages

  
 
  

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

NAME
     zpool-attach -- attach new	device to existing ZFS vdev

SYNOPSIS
     zpool attach [-fsw] [-o property=value] pool device new_device

DESCRIPTION
     Attaches new_device to the	existing device.  The existing device cannot
     be	part of	a raidz	configuration.	If device is not currently part	of a
     mirrored configuration, device automatically transforms into a two-way
     mirror of device and new_device.  If device is part of a two-way mirror,
     attaching new_device creates a three-way mirror, and so on.  In either
     case, new_device begins to	resilver immediately and any running scrub is
     cancelled.

     -f	     Forces use	of new_device, even if it appears to be	in use.	 Not
	     all devices can be	overridden in this manner.

     -o	property=value
	     Sets the given pool properties.  See the zpoolprops(7) manual
	     page for a	list of	valid properties that can be set.  The only
	     property supported	at the moment is ashift.

     -s	     The new_device is reconstructed sequentially to restore redun-
	     dancy as quickly as possible.  Checksums are not verified during
	     sequential	reconstruction so a scrub is started when the resilver
	     completes.	 Sequential reconstruction is not supported for	raidz
	     configurations.

     -w	     Waits until new_device has	finished resilvering before returning.

SEE ALSO
     zpool-add(8), zpool-detach(8), zpool-import(8), zpool-initialize(8),
     zpool-online(8), zpool-replace(8),	zpool-resilver(8)

FreeBSD	13.0			 May 15, 2020			  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-attach&sektion=8&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help