From 52e68edc2d486f530610ed0fe14f80cf50b31067 Mon Sep 17 00:00:00 2001 From: Tim Chase Date: Sat, 21 Jun 2014 09:38:32 -0500 Subject: [PATCH] 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 Signed-off-by: Brian Behlendorf Closes #2416 --- man/man8/zpool.8 | 8 +++++--- 1 file 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