ref-manual: Add XZ_THREADS and XZ_MEMLIMIT

XZ_THREADS and XZ_MEMLIMIT were introduced in dunfell.

[RP improved an original patch from Paul]
(From yocto-docs rev: 96defb66b775093b5270bd1ebad0461c2bba1e5b)

Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Richard Purdie
2022-04-21 18:40:39 -07:00
parent c1496e2268
commit e2cb52612e

View File

@@ -8759,4 +8759,23 @@ system and gives an overview of their function and contents.
The default value of :term:`XSERVER`, if not specified in the machine
configuration, is "xserver-xorg xf86-video-fbdev xf86-input-evdev".
:term:`XZ_THREADS`
Specifies the number of parallel threads that should be used when
using xz compression.
By default this scales with core count, but is never set less than 2
to ensure that multi-threaded mode is always used so that the output
file contents are deterministic. Builds will work with a value of 1
but the output will differ compared to the output from the compression
generated when more than one thread is used.
On systems where many tasks run in parallel, setting a limit to this
can be helpful in controlling system resource usage.
:term:`XZ_MEMLIMIT`
Specifies the maximum memory the xz compression should use as a percentage
of system memory. If unconstrained the xz compressor can use large amounts of
memory and become problematic with parallelism elsewhere in the build.
"50%" has been found to be a good value.