d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

zfs: document large_dnode feature

Browse Source 
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
This commit is contained in:
avg 2019-10-09 11:34:16 +00:00
parent e9642c209b
commit 46619028b7
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
cddl/contrib/opensolaris/cmd/zpool/zpool-features.7
View File

@ -527,6 +527,36 @@ Please note that booting from datasets that have recordsize greater than
supported by the supported by the
.Fx .Fx
boot loader. 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 .It Sy sha512
.Bl -column "READ\-ONLY COMPATIBLE" "org.illumos:sha512" .Bl -column "READ\-ONLY COMPATIBLE" "org.illumos:sha512"
.It GUID Ta org.illumos:sha512 .It GUID Ta org.illumos:sha512