From b578190fb4c916f4c521a6278371ff1d02fd0910 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Wed, 9 Jul 2025 11:33:32 +0200 Subject: ref-manual/variables.rst: make reference to new limiting-resources doc For host resource limiting variables, make a reference to the new "Limiting the Host Resources Usage" document. (From yocto-docs rev: 161a8549441e8c38791ab7f63001b2a15a39d2f2) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie --- documentation/ref-manual/variables.rst | 32 +++++++++++++++++++++++++------- 1 file changed, 25 insertions(+), 7 deletions(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index c56418e2a2..d079e4b598 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -589,8 +589,12 @@ system and gives an overview of their function and contents. See :term:`bitbake:BB_INVALIDCONF` in the BitBake manual. :term:`BB_LOADFACTOR_MAX` - The system load threshold above which BitBake will stop runnig extra - tasks. + The system load threshold above which :term:`BitBake` will stop running + extra tasks. + + For more information on how to limit the resources used during builds, see + the :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. :term:`BB_LOGCONFIG` See :term:`bitbake:BB_LOGCONFIG` in the BitBake manual. @@ -649,11 +653,9 @@ system and gives an overview of their function and contents. An alternative to using :term:`BB_NUMBER_THREADS` to keep the usage of build system resources under control is to use the smarter :term:`BB_PRESSURE_MAX_CPU`, :term:`BB_PRESSURE_MAX_IO` or - :term:`BB_PRESSURE_MAX_MEMORY` controls. They will prevent BitBake - from starting new tasks as long as thresholds are exceeded. Anyway, - as with :term:`BB_NUMBER_THREADS`, such controls won't prevent the - tasks already being run from using all CPU threads on the system - if :term:`PARALLEL_MAKE` is not set to a low value. + :term:`BB_PRESSURE_MAX_MEMORY` controls. See the + :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. :term:`BB_ORIGENV` See :term:`bitbake:BB_ORIGENV` in the BitBake manual. @@ -664,12 +666,24 @@ system and gives an overview of their function and contents. :term:`BB_PRESSURE_MAX_CPU` See :term:`bitbake:BB_PRESSURE_MAX_CPU` in the BitBake manual. + For more information on how to limit the resources used during builds, see + the :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. + :term:`BB_PRESSURE_MAX_IO` See :term:`bitbake:BB_PRESSURE_MAX_IO` in the BitBake manual. + For more information on how to limit the resources used during builds, see + the :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. + :term:`BB_PRESSURE_MAX_MEMORY` See :term:`bitbake:BB_PRESSURE_MAX_MEMORY` in the BitBake manual. + For more information on how to limit the resources used during builds, see + the :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. + :term:`BB_RUNFMT` See :term:`bitbake:BB_RUNFMT` in the BitBake manual. @@ -7006,6 +7020,10 @@ system and gives an overview of their function and contents. ":ref:`dev-manual/speeding-up-build:speeding up a build`" section in the Yocto Project Development Tasks Manual. + For more information on how to limit the resources used during builds, see + the :doc:`/dev-manual/limiting-resources` section of the Yocto Project + Development Tasks Manual. + :term:`PARALLEL_MAKEINST` Extra options passed to the build tool install command (``make install``, ``ninja install`` or more specific ones) -- cgit v1.2.3-54-g00ecf