From 935f5d76849a2c2f0971daf871da3d2ed4d62a28 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 4 May 2015 17:30:45 -0700 Subject: [PATCH] ref-manual: Updates to BB_NUMBER_THREADS and PARALLEL_MAKE I added some more detail to these two variables. The system sets them according to the perceived number of cores. These default setting are cool for single socket systems. However, if you have some big system with a lot of physical CPUs, you might want to cap off the values at 20. This is according to Darren Hart. I also put in some cross-references to the "Speeding Up the Build" section. (From yocto-docs rev: 20eafc8290f46d8deea84dd6ff721b65cb8a1463) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 37 ++++++++++++++++++++-- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index c330fe04a1..ea5b9d8506 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -872,8 +872,26 @@ 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. + For example, a system with a dual core processor that + also uses hyper-threading causes the + BB_NUMBER_THREADS variable to default + to "4". + + + + For single socket systems (i.e. one CPU), you should not + have to override this variable to gain optimal parallelism + during builds. + However, if you have very large systems that employ + multiple physical CPUs, you might want to make sure the + BB_NUMBER_THREADS variable is not + set higher than "20". + + + + For more information on speeding up builds, see the + "Speeding Up the Build" + section. @@ -8499,7 +8517,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" do_compile task in order to specify parallel compilation on the local build host. - This variable is usually in the form "-j <x>", + This variable is usually in the form "-j x", where x represents the maximum number of parallel threads make can run. @@ -8513,6 +8531,19 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" the software being built has problems running its make process in parallel. + For single socket systems (i.e. one CPU), you should not + have to override this variable to gain optimal parallelism + during builds. + However, if you have very large systems that employ + multiple physical CPUs, you might want to make sure the + PARALLEL_MAKE variable is not + set higher than "20". + + + + For more information on speeding up builds, see the + "Speeding Up the Build" + section.