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

FreeBSD Manual Pages

  
 
  

home | help
ZPOOL-ATTACH(8)		    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  mir-
       ror,  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  dur-
	       ing  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  return-
	       ing.

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.2			 May 15, 2020		       ZPOOL-ATTACH(8)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help