aboutsummaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
authorMark Johnston <markj@FreeBSD.org>2024-04-04 14:54:25 +0000
committerMark Johnston <markj@FreeBSD.org>2024-04-04 14:54:25 +0000
commitd1801babad495be2a3eb1d974e1daf9714c5b0fd (patch)
treeb9a3fee7dada4cce7c4d0c4377a906a5965ec184 /share/man
parent91eca18551554b7aca80fcfd3c648f524b321252 (diff)
downloadsrc-d1801babad495be2a3eb1d974e1daf9714c5b0fd.tar.gz
src-d1801babad495be2a3eb1d974e1daf9714c5b0fd.zip
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man5/tarfs.513
1 files changed, 13 insertions, 0 deletions
diff --git a/share/man/man5/tarfs.5 b/share/man/man5/tarfs.5
index 29999b8066f7..5378491b9c9f 100644
--- a/share/man/man5/tarfs.5
+++ b/share/man/man5/tarfs.5
@@ -61,6 +61,19 @@ sysctl setting and tunable.
Setting it to 0 will reset it to its default value.
Note that changes to this setting only apply to filesystems mounted
after the change.
+.Pp
+When the backing tar file is compressed with
+.Xr zstd 1 ,
+I/O performance can be improved by ensuring that compressed data is
+broken up into multiple frames.
+This helps minimize unnecessary decompression work.
+When using
+.Xr bsdtar 1
+to create the tar file, this can be achieved using the
+.Cm zstd:max-frame-size
+and
+.Cm ztsd:frame-per-file
+options.
.Sh DIAGNOSTICS
If enabled by the
.Dv TARFS_DEBUG