Add device rebuild feature

[mirror_zfs.git] / man / man5 / zpool-features.5

diff --git a/man/man5/zpool-features.5 b/man/man5/zpool-features.5
index e7a61957ff4f3bafcdd4af5bcd65744da3789ee8..3f690c3340c4bb63bef1fb4391fa682f08283e7b 100644 (file)
--- a/man/man5/zpool-features.5
+++ b/man/man5/zpool-features.5
@@ -255,6 +255,35 @@ This feature becomes \fBactive\fR when a bookmark is created and will be
 returned to the \fBenabled\fR state when all bookmarks with these fields are destroyed.
 .RE
 
+.sp
+.ne 2
+.na
+\fBdevice_rebuild\fR
+.ad
+.RS 4n
+.TS
+l l .
+GUID   org.openzfs:device_rebuild
+READ\-ONLY COMPATIBLE  yes
+DEPENDENCIES   none
+.TE
+
+This feature enables the ability for the \fBzpool attach\fR and \fBzpool
+replace\fR subcommands to perform sequential reconstruction (instead of
+healing reconstruction) when resilvering.
+
+Sequential reconstruction resilvers a device in LBA order without immediately
+verifying the checksums.  Once complete a scrub is started which then verifies
+the checksums.  This approach allows full redundancy to be restored to the pool
+in the minimum amount of time.  This two phase approach will take longer than a
+healing resilver when the time to verify the checksums is included.  However,
+unless there is additional pool damage no checksum errors should be reported
+by the scrub.  This feature is incompatible with raidz configurations.
+
+This feature becomes \fBactive\fR while a sequential resilver is in progress,
+and returns to \fBenabled\fR when the resilver completes.
+.RE
+
 .sp
 .ne 2
 .na