mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-30 03:32:12 +02:00
Code Issues Packages Projects Releases Wiki Activity

dev-manual, ref-manual, yocto-project-qs: Updates to parallelism variables

Browse Source 
The way the old manual set had worded the use of the
BB_NUMBER_THREADS, PARALLEL_MAKE, and BB_NUMBER_PARSE_THREADS
had become depricated.  It suggested a lot of user intervention
to get these variables set to have the build system utilize
optimal parallelism.  The change a while back to the build system
where the variables are set to the number of build host cores
now makes the variables automatically be set to their best
values.  I have gone through the manual set and changed wordings
appropriately to reflect this.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 3a27b1792c92a2f22173315e2732f672cdad2c78)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2015-01-19 14:14:19 -08:00
committed by Richard Purdie
parent 0a367c514b
commit 4ab132a20d
5 changed files with 33 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -729,20 +729,17 @@
<glossentry id='var-BB_NUMBER_THREADS'><glossterm><imagedata fileref="figures/define-generic.png" />BB_NUMBER_THREADS</glossterm>
<info>
BB_NUMBER_THREADS[doc] = "The maximum number of tasks BitBake should run in parallel at any one time. A good rule of thumb is for this variable to be twice the number of cores."
BB_NUMBER_THREADS[doc] = "The maximum number of tasks BitBake should run in parallel at any one time. This variable is automatically configured to be equal to the number of build system cores."
</info>
<glossdef>
<para>
The maximum number of tasks BitBake should run in parallel
at any one time.
If your host development system supports multiple cores,
a good rule of thumb is to have this variable be twice the
number of cores.
</para>
<para>
The default value for <filename>BB_NUMBER_THREADS</filename>
is equal to the number of cores your build system has.
The OpenEmbedded build system automatically configures
this variable to be equal to the number of cores on the
build system.
To gain optimal parallelism, you should not have to
override this variable.
</para>
</glossdef>
</glossentry>
@@ -7380,11 +7377,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
</para>
<para>
If your development host supports multiple cores, a good
rule of thumb is to set this variable to twice the number
of cores on the host.
If you do not set <filename>PARALLEL_MAKE</filename>, it
defaults to the number of cores your build system has.
The OpenEmbedded build system automatically sets this
variable to be equal to the number of cores the build
system uses.
<note>
Individual recipes might clear out this variable if
the software being built has problems running its