mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-13 05:02:24 +02:00
Code Issues Packages 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

28
documentation/ref-manual/variables.rst
View File

@@ -5818,17 +5818,20 @@ system and gives an overview of their function and contents.
desired splitting.
:term:`PARALLEL_MAKE`
Extra options passed to the ``make`` command during the
:ref:`ref-tasks-compile` task in order to specify
parallel compilation on the local build host. This variable is
usually in the form "-j x", where x represents the maximum number of
parallel threads ``make`` can run.
Extra options passed to the build tool command (``make``,
``ninja`` or more specific build engines, like the Go language one)
during the :ref:`ref-tasks-compile` task, to specify parallel compilation
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::
In order for :term:`PARALLEL_MAKE` to be effective, ``make`` must be
called with ``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy way to ensure
this is to use the ``oe_runmake`` function.
For software compiled by ``make``, in order for :term:`PARALLEL_MAKE`
to be effective, ``make`` must be called with
``${``\ :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
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.
:term:`PARALLEL_MAKEINST`
Extra options passed to the ``make install`` command during the
:ref:`ref-tasks-install` task in order to specify
Extra options passed to the build tool install command
(``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
:term:`PARALLEL_MAKE`.
.. note::
In order for :term:`PARALLEL_MAKEINST` to be effective, ``make`` must
be called with
For software compiled by ``make``, in order for :term:`PARALLEL_MAKEINST`
to be effective, ``make`` must be called with
``${``\ :term:`EXTRA_OEMAKE`\ ``}``. An easy
way to ensure this is to use the ``oe_runmake`` function.