aboutsummaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorMark Johnston <markj@FreeBSD.org>2024-04-05 15:28:55 +0000
committerMark Johnston <markj@FreeBSD.org>2024-04-05 15:43:58 +0000
commitfd56d24725860a3c1f12180cf8503d38d8d0c70d (patch)
treed2d75a1bd0d840e233a12b59ea991679d99c3fc3 /share
parent60bc195745b8c1e1896c535a491906cdf11fe057 (diff)
downloadsrc-fd56d24725860a3c1f12180cf8503d38d8d0c70d.tar.gz
src-fd56d24725860a3c1f12180cf8503d38d8d0c70d.zip
tarfs.5: Provide some guidance on zstd frame sizes
Reviewed by: des, emaste MFC after: 2 weeks Sponsored by: Klara, Inc. Differential Revision: https://reviews.freebsd.org/D44636
Diffstat (limited to 'share')
-rw-r--r--share/man/man5/tarfs.59
1 files changed, 9 insertions, 0 deletions
diff --git a/share/man/man5/tarfs.5 b/share/man/man5/tarfs.5
index 5378491b9c9f..56c56ac43287 100644
--- a/share/man/man5/tarfs.5
+++ b/share/man/man5/tarfs.5
@@ -74,6 +74,15 @@ to create the tar file, this can be achieved using the
and
.Cm ztsd:frame-per-file
options.
+Sensible frame sizes are powers of 2 between the system's base page size
+(see
+.Xr arch 7 )
+and the value of the
+.Sy kern.maxphys
+sysctl.
+Smaller frames will generally yield a worse compression ratio and require extra
+kernel memory to maintain an index, and larger frames will on average require
+more CPU time to access data when performing random I/O.
.Sh DIAGNOSTICS
If enabled by the
.Dv TARFS_DEBUG