diff options
author | Richard Laager <[email protected]> | 2019-04-18 20:21:09 -0500 |
---|---|---|
committer | Brian Behlendorf <[email protected]> | 2019-04-24 17:03:27 -0700 |
commit | 063edd7fd88bdcb17ea286899788fef09459cdb3 (patch) | |
tree | 2b41608e5659045ec67854d9aa9bc553e3334140 /man | |
parent | 6ce7b2d9ad760e3aa0a2185b1c7435c37d284cd8 (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.5 | 8 |
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. |