summaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
Diffstat (limited to 'bitbake')
-rw-r--r--bitbake/doc/user-manual/user-manual-execution.xml55
1 files changed, 33 insertions, 22 deletions
diff --git a/bitbake/doc/user-manual/user-manual-execution.xml b/bitbake/doc/user-manual/user-manual-execution.xml
index 148ac3e38a..d451ebb533 100644
--- a/bitbake/doc/user-manual/user-manual-execution.xml
+++ b/bitbake/doc/user-manual/user-manual-execution.xml
@@ -167,52 +167,53 @@
167 The following list shows common variables set: 167 The following list shows common variables set:
168 <itemizedlist> 168 <itemizedlist>
169 <listitem><para> 169 <listitem><para>
170 <link linkend='var-BBDEBUG'><filename>BBDEBUG</filename></link> 170 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link>
171 </para></listitem> 171 </para></listitem>
172 <listitem><para> 172 <listitem><para>
173 <link linkend='var-MULTI_PROVIDER_WHITELIST'><filename>MULTI_PROVIDER_WHITELIST</filename></link> 173 <link linkend='var-BB_NUMBER_PARSE_THREADS'><filename>BB_NUMBER_PARSE_THREADS</filename></link>
174 </para></listitem> 174 </para></listitem>
175 <listitem><para> 175 <listitem><para>
176 <link linkend='var-BB_NUMBER_PARSE_THREADS'><filename>BB_NUMBER_PARSE_THREADS</filename></link> 176 <link linkend='var-BB_DEFAULT_TASK'><filename>BB_DEFAULT_TASK</filename></link>
177 </para></listitem> 177 </para></listitem>
178 <listitem><para> 178 <listitem><para>
179 <filename>BBPKGS</filename> 179 <link linkend='var-BBMASK'><filename>BBMASK</filename></link>
180 </para></listitem> 180 </para></listitem>
181 <listitem><para> 181 <listitem><para>
182 <link linkend='var-BB_DEFAULT_TASK'><filename>BB_DEFAULT_TASK</filename></link> 182 <filename>BBPKGS</filename>
183 </para></listitem> 183 </para></listitem>
184 <listitem><para> 184 <listitem><para>
185 <link linkend='var-TOPDIR'><filename>TOPDIR</filename></link> 185 <link linkend='var-TOPDIR'><filename>TOPDIR</filename></link>
186 </para></listitem> 186 </para></listitem>
187 <listitem><para> 187 <listitem><para>
188 <link linkend='var-BB_VERBOSE_LOGS'><filename>BB_VERBOSE_LOGS</filename></link> 188 <link linkend='var-ASSUME_PROVIDED'><filename>ASSUME_PROVIDED</filename></link>
189 </para></listitem> 189 </para></listitem>
190 <listitem><para> 190 <listitem><para>
191 <link linkend='var-BB_NICE_LEVEL'><filename>BB_NICE_LEVEL</filename></link> 191 <link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link>
192 </para></listitem> 192 </para></listitem>
193 <listitem><para> 193 <listitem><para>
194 <link linkend='var-BBFILE_COLLECTIONS'><filename>BBFILE_COLLECTIONS</filename></link> 194 <link linkend='var-PREFERRED_PROVIDERS'><filename>PREFERRED_PROVIDERS</filename></link>
195 </para></listitem> 195 </para></listitem>
196 <listitem><para> 196 <listitem><para>
197 <link linkend='var-ASSUME_PROVIDED'><filename>ASSUME_PROVIDED</filename></link> 197 <link linkend='var-MULTI_PROVIDER_WHITELIST'><filename>MULTI_PROVIDER_WHITELIST</filename></link>
198 </para></listitem> 198 </para></listitem>
199 <listitem><para> 199 <listitem><para>
200 <link linkend='var-BB_DANGLINGAPPENDS_WARNONLY'><filename>BB_DANGLINGAPPENDS_WARNONLY</filename></link> 200 <link linkend='var-BBFILE_COLLECTIONS'><filename>BBFILE_COLLECTIONS</filename></link>
201 </para></listitem> 201 </para></listitem>
202 <listitem><para> 202 <listitem><para>
203 <link linkend='var-BBINCLUDED'><filename>BBINCLUDED</filename></link> 203 <link linkend='var-BBDEBUG'><filename>BBDEBUG</filename></link>
204 </para></listitem> 204 </para></listitem>
205 <listitem><para> 205 <listitem><para>
206 <link linkend='var-BBFILE_PRIORITY'><filename>BBFILE_PRIORITY</filename></link> 206 <link linkend='var-BB_VERBOSE_LOGS'><filename>BB_VERBOSE_LOGS</filename></link>
207 </para></listitem> 207 </para></listitem>
208 <listitem><para> 208 <listitem><para>
209 <link linkend='var-BUILDNAME'><filename>BUILDNAME</filename></link> 209 <link linkend='var-BB_NICE_LEVEL'><filename>BB_NICE_LEVEL</filename></link>
210 </para></listitem> 210 </para></listitem>
211 <listitem><para> 211 <listitem><para>
212 <link linkend='var-BBMASK'><filename>BBMASK</filename></link> 212 <link linkend='var-BB_DANGLINGAPPENDS_WARNONLY'><filename>BB_DANGLINGAPPENDS_WARNONLY</filename></link>
213 </para></listitem>
214 <listitem><para>
215 <link linkend='var-BBINCLUDED'><filename>BBINCLUDED</filename></link>
213 </para></listitem> 216 </para></listitem>
214 <listitem><para><link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link></para></listitem>
215 <listitem><para><link linkend='var-PREFERRED_PROVIDERS'><filename>PREFERRED_PROVIDERS</filename></link></para></listitem>
216 </itemizedlist> 217 </itemizedlist>
217 </para> 218 </para>
218 219
@@ -265,6 +266,10 @@
265 BitBake parses each recipe and append file located 266 BitBake parses each recipe and append file located
266 with <filename>BBFILES</filename> and stores the values of 267 with <filename>BBFILES</filename> and stores the values of
267 various variables into the datastore. 268 various variables into the datastore.
269 <note>
270 Append files are applied in the order they are encountered in
271 <filename>BBFILES</filename>.
272 </note>
268 For each file, a fresh copy of the base configuration is 273 For each file, a fresh copy of the base configuration is
269 made, then the recipe is parsed line by line. 274 made, then the recipe is parsed line by line.
270 Any inherit statements cause BitBake to find and 275 Any inherit statements cause BitBake to find and
@@ -305,8 +310,8 @@
305 decisions about the recipe. 310 decisions about the recipe.
306 Consequently, BitBake caches the values in which it is 311 Consequently, BitBake caches the values in which it is
307 interested and does not store the rest of the information. 312 interested and does not store the rest of the information.
308 Experience has shown it's faster to re-parse the metadata than to 313 Experience has shown it is faster to re-parse the metadata than to
309 try and write it out to the disk and reload then it. 314 try and write it out to the disk and then reload it.
310 </para> 315 </para>
311 316
312 <para> 317 <para>
@@ -427,10 +432,6 @@
427 </para> 432 </para>
428 433
429 <para> 434 <para>
430 In summary, BitBake has created a list of providers, which is prioritized, for each target.
431 </para>
432
433 <para>
434 When there are multiple “versions” of a given package, 435 When there are multiple “versions” of a given package,
435 BitBake defaults to selecting the most recent 436 BitBake defaults to selecting the most recent
436 version, unless otherwise specified. 437 version, unless otherwise specified.
@@ -464,6 +465,10 @@
464 PREFERRED_VERSION_a = "1.1" 465 PREFERRED_VERSION_a = "1.1"
465 </literallayout> 466 </literallayout>
466 </para> 467 </para>
468
469 <para>
470 In summary, BitBake has created a list of providers, which is prioritized, for each target.
471 </para>
467 </section> 472 </section>
468 473
469 <section id='bb-bitbake-dependencies'> 474 <section id='bb-bitbake-dependencies'>
@@ -503,6 +508,12 @@
503 Based on the generated list of providers and the dependency information, 508 Based on the generated list of providers and the dependency information,
504 BitBake can now calculate exactly what tasks it needs to run and in what 509 BitBake can now calculate exactly what tasks it needs to run and in what
505 order it needs to run them. 510 order it needs to run them.
511 The
512 "<link linkend='executing-tasks'>Executing Tasks</link>" section has more
513 information on how BitBake chooses which task to execute next.
514 </para>
515
516 <para>
506 The build now starts with BitBake forking off threads up to the limit set in the 517 The build now starts with BitBake forking off threads up to the limit set in the
507 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link> 518 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link>
508 variable. 519 variable.