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

FreeBSD Manual Pages

  
 
  

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

NAME
     zpool-split -- Split devices off a	ZFS storage pool creating a new	pool

SYNOPSIS
     zpool split [-gLlnP] [-o property=value]... [-R root] pool	newpool
	   [device]...

DESCRIPTION
     zpool split [-gLlnP] [-o property=value]... [-R root] pool	newpool
	     [device ...]
	     Splits devices off	pool creating newpool.	All vdevs in pool must
	     be	mirrors	and the	pool must not be in the	process	of resilver-
	     ing.  At the time of the split, newpool will be a replica of
	     pool.  By default,	the last device	in each	mirror is split	from
	     pool to create newpool.

	     The optional device specification causes the specified device(s)
	     to	be included in the new pool and, should	any devices remain un-
	     specified,	the last device	in each	mirror is used as would	be by
	     default.

	     -g	     Display vdev GUIDs	instead	of the normal device names.
		     These GUIDs can be	used in	place of device	names for the
		     zpool detach/offline/remove/replace commands.

	     -L	     Display real paths	for vdevs resolving all	symbolic
		     links. This can be	used to	look up	the current block de-
		     vice name regardless of the /dev/disk/ path used to open
		     it.

	     -l	     Indicates that this command will request encryption keys
		     for all encrypted datasets	it attempts to mount as	it is
		     bringing the new pool online. Note	that if	any datasets
		     have a keylocation	of prompt this command will block
		     waiting for the keys to be	entered. Without this flag en-
		     crypted datasets will be left unavailable until the keys
		     are loaded.

	     -n	     Do	dry run, do not	actually perform the split.  Print out
		     the expected configuration	of newpool.

	     -P	     Display full paths	for vdevs instead of only the last
		     component of the path. This can be	used in	conjunction
		     with the -L flag.

	     -o	property=value
		     Sets the specified	property for newpool.  See the
		     zpoolprops	manual page for	more information on the	avail-
		     able pool properties.

	     -R	root
		     Set altroot for newpool to	root and automatically import
		     it.

SEE ALSO
     zpool-import(8), zpool-list(8), zpool-remove(8)

FreeBSD	13.0			August 9, 2019			  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-split&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help