aboutsummaryrefslogtreecommitdiff
path: root/cddl
diff options
context:
space:
mode:
authorAndriy Gapon <avg@FreeBSD.org>2019-10-09 11:34:16 +0000
committerAndriy Gapon <avg@FreeBSD.org>2019-10-09 11:34:16 +0000
commit329012f5132172305d68d37c5e6d36a6a00776ef (patch)
tree6d6e65f9ce8ce8d24b6719aeae2b01849f37ade8 /cddl
parentf5c4c7209be61707dd84b50f1852d994d0df661a (diff)
downloadsrc-329012f5132172305d68d37c5e6d36a6a00776ef.tar.gz
src-329012f5132172305d68d37c5e6d36a6a00776ef.zip
zfs: document large_dnode feature
The text is copied from illumos. The conversion to mdoc is mine. The FreeBSD boot warning is copied from large_block description. MFC after: 4 days
Notes
Notes: svn path=/head/; revision=353341
Diffstat (limited to 'cddl')
-rw-r--r--cddl/contrib/opensolaris/cmd/zpool/zpool-features.730
1 files changed, 30 insertions, 0 deletions
diff --git a/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7 b/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
index 1d6a6f888730..feb91ca4eb46 100644
--- a/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
+++ b/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
@@ -527,6 +527,36 @@ Please note that booting from datasets that have recordsize greater than
supported by the
.Fx
boot loader.
+.It Sy large_dnode
+.Bl -column "READ\-ONLY COMPATIBLE" "org.zfsonlinux:large_dnode"
+.It GUID Ta org.zfsonlinux:large_dnode
+.It READ\-ONLY COMPATIBLE Ta no
+.It DEPENDENCIES Ta extensible_dataset
+.El
+.Pp
+The
+.Sy large_dnode
+feature allows the size of dnodes in a dataset to be set larger than 512B.
+.Pp
+This feature becomes
+.Sy active
+once a dataset contains an object with a dnode larger than 512B,
+which occurs as a result of setting the
+.Sy dnodesize
+dataset property to a value other than
+.Sy legacy .
+The feature will return to being
+.Sy enabled
+once all filesystems that have ever contained a dnode larger than 512B are
+destroyed.
+Large dnodes allow more data to be stored in the bonus buffer, thus potentially
+improving performance by avoiding the use of spill blocks.
+.Pp
+Please note that booting from datasets that have dnodes larger than 512B is
+.Em NOT
+supported by the
+.Fx
+boot loader.
.It Sy sha512
.Bl -column "READ\-ONLY COMPATIBLE" "org.illumos:sha512"
.It GUID Ta org.illumos:sha512