diff options
author | 2016-08-03 10:37:22 -0700 | |
---|---|---|
committer | 2016-08-18 23:50:46 +0100 | |
commit | df337651e4aea2cb0d17785609e3a3f8dca1d1e2 (patch) | |
tree | 0e55c88abecb8e1cc8b30208cf5523e9559f4f02 /documentation/ref-manual/ref-variables.xml | |
parent | 836b80cca2fc26ce7239c1f2cba72ad19a4eaed5 (diff) | |
download | openembedded-core-contrib-df337651e4aea2cb0d17785609e3a3f8dca1d1e2.tar.gz |
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>
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 33 |
1 files changed, 29 insertions, 4 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 8ff0d671d1..d1a31a4bc9 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -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> |