svn commit: r353754 - stable/12/cddl/contrib/opensolaris/cmd/zpool

[Andriy Gapon]

Author: avg
Date: Sat Oct 19 07:47:28 2019
New Revision: 353754
URL: https://svnweb.freebsd.org/changeset/base/353754

Log:
  MFC r353341,r353342: zfs: document large_dnode feature

Modified:
  stable/12/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
==============================================================================
--- stable/12/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7	Sat Oct 19 07:45:11 2019	(r353753)
+++ stable/12/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7	Sat Oct 19 07:47:28 2019	(r353754)
@@ -527,6 +527,30 @@ Please note that booting from datasets that have recor
 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.
 .It Sy sha512
 .Bl -column "READ\-ONLY COMPATIBLE" "org.illumos:sha512"
 .It GUID Ta org.illumos:sha512