Provided by: zfsutils-linux_2.1.5-1ubuntu6~22.04.4_amd64 bug

NAME

     zpool-replace — replace one device with another in ZFS storage pool

SYNOPSIS

     zpool replace [-fsw] [-o property=value] pool device [new-device]

DESCRIPTION

     Replaces device with new-device.  This is equivalent to attaching new-device, waiting for it
     to resilver, and then detaching device.  Any in progress scrub will be cancelled.

     The size of new-device must be greater than or equal to the minimum size of all the devices
     in a mirror or raidz configuration.

     new-device is required if the pool is not redundant.  If new-device is not specified, it
     defaults to 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 /dev path as
     the old device, even though it is actually a different disk.  ZFS recognizes this.

     -f      Forces use of new-device, even if it appears to be in use.  Not all devices can be
             overridden in this manner.

     -o property=value
             Sets the given pool properties.  See the zpoolprops(7) manual page for a list of
             valid properties that can be set.  The only property supported at the moment is
             ashift.

     -s      The new-device is reconstructed sequentially to restore redundancy as quickly as
             possible.  Checksums are not verified during sequential reconstruction so a scrub is
             started when the resilver completes.  Sequential reconstruction is not supported for
             raidz configurations.

     -w      Waits until the replacement has completed before returning.

SEE ALSO

     zpool-detach(8), zpool-initialize(8), zpool-online(8), zpool-resilver(8)