Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 9 Oct 2019 11:34:16 +0000 (UTC)
From:      Andriy Gapon <avg@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org
Subject:   svn commit: r353341 - head/cddl/contrib/opensolaris/cmd/zpool
Message-ID:  <201910091134.x99BYG5h088252@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: avg
Date: Wed Oct  9 11:34:16 2019
New Revision: 353341
URL: https://svnweb.freebsd.org/changeset/base/353341

Log:
  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

Modified:
  head/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7

Modified: head/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
==============================================================================
--- head/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7	Wed Oct  9 11:26:36 2019	(r353340)
+++ head/cddl/contrib/opensolaris/cmd/zpool/zpool-features.7	Wed Oct  9 11:34:16 2019	(r353341)
@@ -527,6 +527,36 @@ 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.
+.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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201910091134.x99BYG5h088252>