ZPOOL-SPLIT(8) System Manager's Manual ZPOOL-SPLIT(8)

# [NAME](#NAME)

`zpool-split` — split devices off ZFS storage pool, creating new pool

# [SYNOPSIS](#SYNOPSIS)

`zpool` `split` \[`-gLlnP`] \[`-o` `property`=`value`]… \[`-R` `root`] `pool newpool` \[`device`]…

# [DESCRIPTION](#DESCRIPTION)

Splits devices off `pool` creating `newpool`. All vdevs in `pool` must be mirrors and the pool must not be in the process of resilvering. 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 unspecified, the last device in each mirror is used as would be by default.

[`-g`](#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`](#L)

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

[`-l`](#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 [**keylocation**](#keylocation)=[**prompt**](#prompt), this command will block waiting for the keys to be entered. Without this flag, encrypted datasets will be left unavailable until the keys are loaded.

[`-n`](#n)

Do a dry-run ("No-op") split: do not actually perform it. Print out the expected configuration of `newpool`.

[`-P`](#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`](#o) `property`=`value`

Sets the specified property for `newpool`. See the [zpoolprops(7)](/man/os/zfs/zpoolprops.7) manual page for more information on the available pool properties.

[`-R`](#R) `root`

Set [**altroot**](#altroot) for `newpool` to `root` and automatically import it.

# [SEE ALSO](#SEE_ALSO)

[zpool-import(8)](/man/os/zfs/zpool-import.8), [zpool-list(8)](/man/os/zfs/zpool-list.8), [zpool-remove(8)](/man/os/zfs/zpool-remove.8)

July 11, 2022 OpenZFS

---

Document: zpool-split(8) from zfs 2.4.4-r3 (Chainguard OS)
Source: https://github.com/openzfs/zfs