man: update recordsize max size info

Reflect https://github.com/openzfs/zfs/commit/f2330bd1568489ae1fb16d975a5a9bcfe12ed219
change in our man pages and add some context.

Wording is primarily copy-pasted from code comments.

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by:  Tino Reichardt <milky-zfs@mcmilk.de>
Signed-off-by: George Melikov <mail@gmelikov.ru>
Closes #16581
This commit is contained in:
George Melikov
2024-09-29 23:19:52 +03:00
committed by GitHub
parent b1958b531b
commit 5591505299
2 changed files with 17 additions and 1 deletions
+12 -1
View File
@@ -1527,11 +1527,22 @@ and less than or equal to
If the
.Sy large_blocks
feature is enabled on the pool, the size may be up to
.Ar 1 MiB .
.Ar 16 MiB .
See
.Xr zpool-features 7
for details on ZFS feature flags.
.Pp
However, blocks larger than
.Ar 1 MiB
can have an impact on i/o latency (e.g. tying up a spinning disk for
~300ms), and also potentially on the memory allocator.
.Pp
Note that maximum size is still limited by default to
.Ar 1 MiB
on x86_32, see
.Sy zfs_max_recordsize
module parameter.
.Pp
Changing the file system's
.Sy recordsize
affects only files created afterward; existing files are unaffected.