summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTim Chase <tim@chase2k.com>2014-06-21 09:38:32 -0500
committerBrian Behlendorf <behlendorf1@llnl.gov>2014-07-01 14:16:43 -0700
commit52e68edc2d486f530610ed0fe14f80cf50b31067 (patch)
tree81387eeefd6ab6bb304c17a25879b2c78e677e67
parent09c0b8fe5e95935d529e6b5d1135f66b232d271d (diff)
Document the optional "device" argument for "zpool split"
Most ZFS implementations seemed to have missed this bit of documentation. The additional text is based on FreeBSD's man page. Signed-off-by: Tim Chase <tim@chase2k.com> Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov> Closes #2416
-rw-r--r--man/man8/zpool.88
1 files changed, 5 insertions, 3 deletions
diff --git a/man/man8/zpool.8 b/man/man8/zpool.8
index e429d38e5..e0d91d94c 100644
--- a/man/man8/zpool.8
+++ b/man/man8/zpool.8
@@ -145,7 +145,7 @@ zpool \- configures ZFS storage pools
.LP
.nf
-\fBzpool split\fR [\fB-n\fR] [\fB-R\fR \fIaltroot\fR] [\fB-o\fR \fIproperty=value\fR] \fIpool\fR \fInewpool\fR
+\fBzpool split\fR [\fB-n\fR] [\fB-R\fR \fIaltroot\fR] [\fB-o\fR \fIproperty=value\fR] \fIpool\fR \fInewpool\fR [\fIdevice\fR ...]
.fi
.LP
@@ -1750,11 +1750,13 @@ Sets the given property on the specified pool. See the "Properties" section for
.ne 2
.mk
.na
-\fBzpool split\fR [\fB-n\fR] [\fB-R\fR \fIaltroot\fR] [\fB-o\fR \fIproperty=value\fR] \fIpool\fR \fInewpool\fR
+\fBzpool split\fR [\fB-n\fR] [\fB-R\fR \fIaltroot\fR] [\fB-o\fR \fIproperty=value\fR] \fIpool\fR \fInewpool\fR [\fIdevice\fR ...]
.ad
.sp .6
.RS 4n
-Split devices off \fIpool\fR creating \fInewpool\fR.  All \fBvdev\fRs in \fIpool\fR must be mirrors.  At the time of the split, \fInewpool\fR will be a replica of \fIpool\fR.
+Split devices off \fIpool\fR creating \fInewpool\fR. All \fBvdev\fRs in \fIpool\fR must be mirrors and the pool must not be in the process of resilvering. At the time of the split, \fInewpool\fR will be a replica of \fIpool\fR. By default, the last device in each mirror is split from \fIpool\fR to create \fInewpool\fR.
+
+The optional \fIdevice\fR 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.
.sp
.ne 2