aboutsummaryrefslogtreecommitdiff
path: root/sys/contrib/openzfs/man/man8/zpool-replace.8
diff options
context:
space:
mode:
Diffstat (limited to 'sys/contrib/openzfs/man/man8/zpool-replace.8')
-rw-r--r--sys/contrib/openzfs/man/man8/zpool-replace.844
1 files changed, 19 insertions, 25 deletions
diff --git a/sys/contrib/openzfs/man/man8/zpool-replace.8 b/sys/contrib/openzfs/man/man8/zpool-replace.8
index ae2e66344870..2b2875ed4292 100644
--- a/sys/contrib/openzfs/man/man8/zpool-replace.8
+++ b/sys/contrib/openzfs/man/man8/zpool-replace.8
@@ -18,7 +18,6 @@
.\"
.\" CDDL HEADER END
.\"
-.\"
.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
@@ -27,48 +26,42 @@
.\" Copyright 2017 Nexenta Systems, Inc.
.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
.\"
-.Dd May 15, 2020
+.Dd May 29, 2021
.Dt ZPOOL-REPLACE 8
.Os
+.
.Sh NAME
.Nm zpool-replace
-.Nd Replace one device with another in a ZFS storage pool
+.Nd replace one device with another in ZFS storage pool
.Sh SYNOPSIS
.Nm zpool
.Cm replace
.Op Fl fsw
.Oo Fl o Ar property Ns = Ns Ar value Oc
-.Ar pool Ar device Op Ar new_device
+.Ar pool Ar device Op Ar new-device
+.
.Sh DESCRIPTION
-.Bl -tag -width Ds
-.It Xo
-.Nm zpool
-.Cm replace
-.Op Fl fsw
-.Op Fl o Ar property Ns = Ns Ar value
-.Ar pool Ar device Op Ar new_device
-.Xc
Replaces
-.Ar old_device
+.Ar device
with
-.Ar new_device .
+.Ar new-device .
This is equivalent to attaching
-.Ar new_device ,
+.Ar new-device ,
waiting for it to resilver, and then detaching
-.Ar old_device .
+.Ar device .
Any in progress scrub will be cancelled.
.Pp
The size of
-.Ar new_device
+.Ar new-device
must be greater than or equal to the minimum size of all the devices in a mirror
or raidz configuration.
.Pp
-.Ar new_device
+.Ar new-device
is required if the pool is not redundant.
If
-.Ar new_device
+.Ar new-device
is not specified, it defaults to
-.Ar old_device .
+.Ar device .
This form of replacement is useful after an existing disk has failed and has
been physically replaced.
In this case, the new disk may have the same
@@ -78,18 +71,19 @@ ZFS recognizes this.
.Bl -tag -width Ds
.It Fl f
Forces use of
-.Ar new_device ,
+.Ar new-device ,
even if it appears to be in use.
Not all devices can be overridden in this manner.
.It Fl o Ar property Ns = Ns Ar value
-Sets the given pool properties. See the
-.Xr zpoolprops 8
+Sets the given pool properties.
+See the
+.Xr zpoolprops 7
manual page for a list of valid properties that can be set.
The only property supported at the moment is
.Sy ashift .
.It Fl s
The
-.Ar new_device
+.Ar new-device
is reconstructed sequentially to restore redundancy as quickly as possible.
Checksums are not verfied during sequential reconstruction so a scrub is
started when the resilver completes.
@@ -97,7 +91,7 @@ Sequential reconstruction is not supported for raidz configurations.
.It Fl w
Waits until the replacement has completed before returning.
.El
-.El
+.
.Sh SEE ALSO
.Xr zpool-detach 8 ,
.Xr zpool-initialize 8 ,