summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorRichard Laager <[email protected]>2019-04-18 20:21:09 -0500
committerBrian Behlendorf <[email protected]>2019-04-24 17:03:27 -0700
commit063edd7fd88bdcb17ea286899788fef09459cdb3 (patch)
tree2b41608e5659045ec67854d9aa9bc553e3334140 /man
parent6ce7b2d9ad760e3aa0a2185b1c7435c37d284cd8 (diff)
Document that hole_birth is effectively useless
The first sentence of this commit comes from the wiki, and was originally written by: Rich Ercolani <[email protected]> with changes by: Tom Caputi <[email protected]> Reviewed-by: Tom Caputi <[email protected]> Reviewed-by: Brian Behlendorf <[email protected]> Signed-off-by: Richard Laager <[email protected]> Closes #8641 Closes #8642
Diffstat (limited to 'man')
-rw-r--r--man/man5/zpool-features.58
1 files changed, 8 insertions, 0 deletions
diff --git a/man/man5/zpool-features.5 b/man/man5/zpool-features.5
index 1df7f0f76..8893d151d 100644
--- a/man/man5/zpool-features.5
+++ b/man/man5/zpool-features.5
@@ -383,6 +383,14 @@ READ\-ONLY COMPATIBLE no
DEPENDENCIES enabled_txg
.TE
+This feature has/had bugs, the result of which is that, if you do a
+\fBzfs send -i\fR (or \fB-R\fR, since it uses \fB-i\fR) from an affected
+dataset, the receiver will not see any checksum or other errors, but the
+resulting destination snapshot will not match the source. Its use by
+\fBzfs send -i\fR has been disabled by default. See the
+\fBsend_holes_without_birth_time\fR module parameter in
+zfs-module-parameters(5).
+
This feature improves performance of incremental sends (\fBzfs send -i\fR)
and receives for objects with many holes. The most common case of
hole-filled objects is zvols.