mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-01 13:09:50 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual/variables.rst: expand PARALLEL_MAKE description

Browse Source 
Explain that this variable apply not only to make, but also
to ninja, and to other build tools which support parallel jobs.

(From yocto-docs rev: d3fe2aba3948040a01b9068df5085453ad65309c)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Michael Opdenacker
2022-11-08 21:30:11 +01:00
committed by Richard Purdie
parent 15a8edcead
commit 51b6a55a80
1 changed files with 16 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/variables.rst
+16 -12
View File
@@ -5818,17 +5818,20 @@ system and gives an overview of their function and contents.
desired splitting. desired splitting.
:term:`PARALLEL_MAKE` :term:`PARALLEL_MAKE`
Extra options passed to the ``make`` command during the
:ref:`ref-tasks-compile` task in order to specify Extra options passed to the build tool command (``make``,
parallel compilation on the local build host. This variable is ``ninja`` or more specific build engines, like the Go language one)
usually in the form "-j x", where x represents the maximum number of during the :ref:`ref-tasks-compile` task, to specify parallel compilation
parallel threads ``make`` can run. on the local build host. This variable is usually in the form "-j x",
where x represents the maximum number of parallel threads such engines
can run.
.. note:: .. note::
In order for :term:`PARALLEL_MAKE` to be effective, ``make`` must be For software compiled by ``make``, in order for :term:`PARALLEL_MAKE`
called with ``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy way to ensure to be effective, ``make`` must be called with
this is to use the ``oe_runmake`` function. ``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy
way to ensure this is to use the ``oe_runmake`` function.
By default, the OpenEmbedded build system automatically sets this By default, the OpenEmbedded build system automatically sets this
variable to be equal to the number of cores the build system uses. variable to be equal to the number of cores the build system uses.
@@ -5853,15 +5856,16 @@ system and gives an overview of their function and contents.
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Development Tasks Manual.
:term:`PARALLEL_MAKEINST` :term:`PARALLEL_MAKEINST`
Extra options passed to the ``make install`` command during the Extra options passed to the build tool install command
:ref:`ref-tasks-install` task in order to specify (``make install``, ``ninja install`` or more specific ones)
during the :ref:`ref-tasks-install` task in order to specify
parallel installation. This variable defaults to the value of parallel installation. This variable defaults to the value of
:term:`PARALLEL_MAKE`. :term:`PARALLEL_MAKE`.
.. note:: .. note::
In order for :term:`PARALLEL_MAKEINST` to be effective, ``make`` must For software compiled by ``make``, in order for :term:`PARALLEL_MAKEINST`
be called with to be effective, ``make`` must be called with
``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy ``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy
way to ensure this is to use the ``oe_runmake`` function. way to ensure this is to use the ``oe_runmake`` function.