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 a new device to an existing	ZFS virtual device
     (vdev).

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

DESCRIPTION
     zpool attach [-fsw] [-o property=value] pool device new_device
	     Attaches new_device to the	existing device.  The existing device
	     cannot be part of a raidz configuration.  If device is not	cur-
	     rently 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(8)
		     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
		     redundancy	as quickly as possible.	 Checksums are not
		     verfied during sequential reconstruction so a scrub is
		     started when the resilver completes.  Sequential recon-
		     struction is not supported	for raidz configurations.

	     -w	     Waits until new_device has	finished resilvering before
		     returning.

SEE ALSO
     zpool-detach(8), zpool-add(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.0-RELEASE+and+Ports>

home | help