sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

ref-manual: Updates to PARALLEL_MAKE, PARALLEL_MAKEINST, EXTRA_OEMAKE 

Fixes [YOCTO #10070]

Updated these three variables with various items to make clear
that PARALLEL_MAKE and PARALLEL_MAKEINST won't work unless
EXTRA_OEMAKE is passed to "make".

(From yocto-docs rev: 4f8b56cc67502cd672e0296cf2f143ecbcde22ac)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2016-08-03 10:37:22 -07:00 committed by Richard Purdie
parent 836b80cca2
commit df337651e4
1 changed files with 29 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
documentation/ref-manual/ref-variables.xml
View File

@ -4025,6 +4025,15 @@
"", you need to set the variable to specify any required
GNU options.
</para>
<para>
<link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>
and
<link linkend='var-PARALLEL_MAKEINST'><filename>PARALLEL_MAKEINST</filename></link>
also make use of
<filename>EXTRA_OEMAKE</filename> to pass the required
flags.
</para>
</glossdef>
</glossentry>
@ -9259,6 +9268,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
where <replaceable>x</replaceable> represents the maximum
number of parallel threads <filename>make</filename> can
run.
<note><title>Caution</title>
In order for <filename>PARALLEL_MAKE</filename> to be
effective, <filename>make</filename> must be called
with
<filename>${</filename><link linkend='var-EXTRA_OEMAKE'><filename>EXTRA_OEMAKE</filename></link><filename>}</filename>.
An easy way to ensure this is to use the
<filename>oe_runmake</filename> function.
</note>
</para>
<para>
@ -9305,16 +9322,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
task in order to specify parallel installation.
This variable defaults to the value of
<link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>.
<note>
If the software being built experiences dependency
issues during the
<note><title>Notes and Cautions</title>
<para>In order for <filename>PARALLEL_MAKEINST</filename>
to be
effective, <filename>make</filename> must be called
with
<filename>${</filename><link linkend='var-EXTRA_OEMAKE'><filename>EXTRA_OEMAKE</filename></link><filename>}</filename>.
An easy way to ensure this is to use the
<filename>oe_runmake</filename> function.</para>
<para>If the software being built experiences
dependency issues during the
<filename>do_install</filename> task that result in
race conditions, you can clear the
<filename>PARALLEL_MAKEINST</filename> variable within
the recipe as a workaround.
For information on addressing race conditions, see the
"<ulink url='&YOCTO_DOCS_DEV_URL;#debugging-parallel-make-races'>Debugging Parallel Make Races</ulink>"
section in the Yocto Project Development Manual.
section in the Yocto Project Development Manual.</para>
</note>
</para>
</glossdef>