diff options
author | Mark Johnston <markj@FreeBSD.org> | 2024-04-05 15:28:55 +0000 |
---|---|---|
committer | Mark Johnston <markj@FreeBSD.org> | 2024-04-05 15:43:58 +0000 |
commit | fd56d24725860a3c1f12180cf8503d38d8d0c70d (patch) | |
tree | d2d75a1bd0d840e233a12b59ea991679d99c3fc3 /share | |
parent | 60bc195745b8c1e1896c535a491906cdf11fe057 (diff) | |
download | src-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.5 | 9 |
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 |