summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-02-13 13:21:35 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-03-25 12:29:35 +0000
commitfdd99bcb117f83c876f169965c34ae246901384d (patch)
tree10096574c8641a60672d365ccaf68190b14ee4a9 /documentation/ref-manual
parent478f1b7afe46c0d6328d4b8db1d32e22aef6759d (diff)
downloadpoky-fdd99bcb117f83c876f169965c34ae246901384d.tar.gz
ref-manual: Added ICECC_PARALLEL_MAKE to glossary.
Fixes [YOCTO #5801] First draft of this description. (From yocto-docs rev: 412d0cc7dbb74ece45940c40fbb617217ab88d2d) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml40
1 files changed, 40 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 8fe4c1a914..d8e0d2b666 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2405,6 +2405,46 @@
2405 </glossdef> 2405 </glossdef>
2406 </glossentry> 2406 </glossentry>
2407 2407
2408 <glossentry id='var-ICECC_PARALLEL_MAKE'><glossterm>ICECC_PARALLEL_MAKE</glossterm>
2409 <glossdef>
2410 <para>
2411 Extra options passed to the <filename>make</filename>
2412 command during the <filename>do_compile</filename> task
2413 that specify parallel compilation.
2414 This variable usually takes the form of
2415 <filename>-j 4</filename>, where the number
2416 represents the maximum number of parallel threads
2417 <filename>make</filename> can run.
2418 <note>
2419 The options passed affect builds on all enabled
2420 machines on the network, which are machines running the
2421 <filename>iceccd</filename> daemon.
2422 </note>
2423 </para>
2424
2425 <para>
2426 If your enabled machines support multiple cores,
2427 coming up with the maximum number of parallel threads
2428 that gives you the best performance could take some
2429 experimentation since machine speed, network lag,
2430 available memory, and existing machine loads can all
2431 affect build time.
2432 Consequently, unlike the
2433 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>
2434 variable, there is no rule-of-thumb for setting
2435 <filename>ICECC_PARALLEL_MAKE</filename> to achieve
2436 optimal performance.
2437 </para>
2438
2439 <para>
2440 If you do not set <filename>ICECC_PARALLEL_MAKE</filename>,
2441 the build system does not use it (i.e. the system does
2442 not detect and assign the number of cores as is done with
2443 <filename>PARALLEL_MAKE</filename>).
2444 </para>
2445 </glossdef>
2446 </glossentry>
2447
2408 <glossentry id='var-ICECC_PATH'><glossterm>ICECC_PATH</glossterm> 2448 <glossentry id='var-ICECC_PATH'><glossterm>ICECC_PATH</glossterm>
2409 <glossdef> 2449 <glossdef>
2410 <para> 2450 <para>