diff options
Diffstat (limited to 'handbook/ref-bitbake.xml')
-rw-r--r-- | handbook/ref-bitbake.xml | 35 |
1 files changed, 21 insertions, 14 deletions
diff --git a/handbook/ref-bitbake.xml b/handbook/ref-bitbake.xml index ddf3c760f2..eaf9467950 100644 --- a/handbook/ref-bitbake.xml +++ b/handbook/ref-bitbake.xml | |||
@@ -6,7 +6,7 @@ | |||
6 | <title>Reference: Bitbake</title> | 6 | <title>Reference: Bitbake</title> |
7 | 7 | ||
8 | <para> | 8 | <para> |
9 | Bitbake a program written in Python which interprets the metadata | 9 | Bitbake is a program written in Python that interprets the metadata |
10 | that makes up Poky. At some point, people wonder what actually happens | 10 | that makes up Poky. At some point, people wonder what actually happens |
11 | when you type <command>bitbake poky-image-sato</command>. This section | 11 | when you type <command>bitbake poky-image-sato</command>. This section |
12 | aims to give an overview of what happens behind the scenes from a | 12 | aims to give an overview of what happens behind the scenes from a |
@@ -16,7 +16,7 @@ | |||
16 | <para> | 16 | <para> |
17 | It is worth noting that bitbake aims to be a generic "task" executor | 17 | It is worth noting that bitbake aims to be a generic "task" executor |
18 | capable of handling complex dependency relationships. As such it has no | 18 | capable of handling complex dependency relationships. As such it has no |
19 | real knowledge of what the tasks its executing actually do. It just | 19 | real knowledge of what the tasks it is executing actually do. It just |
20 | considers a list of tasks with dependencies and handles metadata | 20 | considers a list of tasks with dependencies and handles metadata |
21 | consisting of variables in a certain format which get passed to the | 21 | consisting of variables in a certain format which get passed to the |
22 | tasks. | 22 | tasks. |
@@ -26,7 +26,7 @@ | |||
26 | <title>Parsing</title> | 26 | <title>Parsing</title> |
27 | 27 | ||
28 | <para> | 28 | <para> |
29 | The first thing BitBake does is work out its configuration by | 29 | The first thing BitBake does is that work out its configuration by |
30 | looking for a file called <filename>bitbake.conf</filename>. | 30 | looking for a file called <filename>bitbake.conf</filename>. |
31 | Bitbake searches through the <varname>BBPATH</varname> environment | 31 | Bitbake searches through the <varname>BBPATH</varname> environment |
32 | variable looking for a <filename class="directory">conf/</filename> | 32 | variable looking for a <filename class="directory">conf/</filename> |
@@ -117,7 +117,7 @@ | |||
117 | specified on the commandline) and looks for providers of that target. | 117 | specified on the commandline) and looks for providers of that target. |
118 | Once a provider is selected, BitBake resolves all the dependencies for | 118 | Once a provider is selected, BitBake resolves all the dependencies for |
119 | the target. In the case of "poky-image-sato", it would lead to | 119 | the target. In the case of "poky-image-sato", it would lead to |
120 | <filename>task-oh.bb</filename> and <filename>task-base.bb</filename> | 120 | <filename>task-base.bb</filename> |
121 | which in turn would lead to packages like <application>Contacts</application>, | 121 | which in turn would lead to packages like <application>Contacts</application>, |
122 | <application>Dates</application>, <application>BusyBox</application> | 122 | <application>Dates</application>, <application>BusyBox</application> |
123 | and these in turn depend on glibc and the toolchain. | 123 | and these in turn depend on glibc and the toolchain. |
@@ -154,7 +154,8 @@ | |||
154 | "1" makes it likely the package will be used. | 154 | "1" makes it likely the package will be used. |
155 | <glossterm><link | 155 | <glossterm><link |
156 | linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></glossterm> overrides | 156 | linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></glossterm> overrides |
157 | any default preference. <glossterm><link | 157 | any <glossterm><link |
158 | linkend='var-DEFAULT_PREFERENCE'>DEFAULT_PREFERENCE</link></glossterm>. <glossterm><link | ||
158 | linkend='var-DEFAULT_PREFERENCE'>DEFAULT_PREFERENCE</link></glossterm> | 159 | linkend='var-DEFAULT_PREFERENCE'>DEFAULT_PREFERENCE</link></glossterm> |
159 | is often used to mark more | 160 | is often used to mark more |
160 | experimental new versions of packages until they've undergone sufficient | 161 | experimental new versions of packages until they've undergone sufficient |
@@ -176,7 +177,7 @@ | |||
176 | multi-core systems, BitBake considers each task as an independent | 177 | multi-core systems, BitBake considers each task as an independent |
177 | entity with a set of dependencies. There are many variables that | 178 | entity with a set of dependencies. There are many variables that |
178 | are used to signify these dependencies and more information can be found | 179 | are used to signify these dependencies and more information can be found |
179 | found about these in the <ulink url='http://bitbake.berlios.de/manual/'> | 180 | about these in the <ulink url='http://bitbake.berlios.de/manual/'> |
180 | BitBake manual</ulink>. At a basic level it is sufficient to know | 181 | BitBake manual</ulink>. At a basic level it is sufficient to know |
181 | that BitBake uses the <glossterm><link | 182 | that BitBake uses the <glossterm><link |
182 | linkend='var-DEPENDS'>DEPENDS</link></glossterm> and | 183 | linkend='var-DEPENDS'>DEPENDS</link></glossterm> and |
@@ -196,7 +197,7 @@ | |||
196 | order. The build now starts with BitBake forking off threads up to | 197 | order. The build now starts with BitBake forking off threads up to |
197 | the limit set in the <glossterm><link | 198 | the limit set in the <glossterm><link |
198 | linkend='var-BB_NUMBER_THREADS'>BB_NUMBER_THREADS</link></glossterm> variable | 199 | linkend='var-BB_NUMBER_THREADS'>BB_NUMBER_THREADS</link></glossterm> variable |
199 | as long there are tasks ready to run, i.e. tasks with all their | 200 | as long as there are tasks ready to run, i.e. tasks with all their |
200 | dependencies met. | 201 | dependencies met. |
201 | </para> | 202 | </para> |
202 | 203 | ||
@@ -271,9 +272,9 @@ Options: | |||
271 | target that failed, and those that depend on it, | 272 | target that failed, and those that depend on it, |
272 | cannot be remade, the other dependencies of these | 273 | cannot be remade, the other dependencies of these |
273 | targets can be processed all the same. | 274 | targets can be processed all the same. |
275 | -a, --tryaltconfigs continue with builds by trying to use alternative | ||
276 | providers where possible. | ||
274 | -f, --force force run of specified cmd, regardless of stamp status | 277 | -f, --force force run of specified cmd, regardless of stamp status |
275 | -i, --interactive drop into the interactive mode also called the BitBake | ||
276 | shell. | ||
277 | -c CMD, --cmd=CMD Specify task to execute. Note that this only executes | 278 | -c CMD, --cmd=CMD Specify task to execute. Note that this only executes |
278 | the specified task for the providee and the packages | 279 | the specified task for the providee and the packages |
279 | it depends on, i.e. 'compile' does not implicitly call | 280 | it depends on, i.e. 'compile' does not implicitly call |
@@ -286,6 +287,9 @@ Options: | |||
286 | -D, --debug Increase the debug level. You can specify this more | 287 | -D, --debug Increase the debug level. You can specify this more |
287 | than once. | 288 | than once. |
288 | -n, --dry-run don't execute, just go through the motions | 289 | -n, --dry-run don't execute, just go through the motions |
290 | -S, --dump-signatures | ||
291 | don't execute, just dump out the signature | ||
292 | construction information | ||
289 | -p, --parse-only quit after parsing the BB files (developers only) | 293 | -p, --parse-only quit after parsing the BB files (developers only) |
290 | -d, --disable-psyco disable using the psyco just-in-time compiler (not | 294 | -d, --disable-psyco disable using the psyco just-in-time compiler (not |
291 | recommended) | 295 | recommended) |
@@ -294,13 +298,16 @@ Options: | |||
294 | what used to be bbread) | 298 | what used to be bbread) |
295 | -g, --graphviz emit the dependency trees of the specified packages in | 299 | -g, --graphviz emit the dependency trees of the specified packages in |
296 | the dot syntax | 300 | the dot syntax |
297 | -I IGNORED_DOT_DEPS, --ignore-deps=IGNORED_DOT_DEPS | 301 | -I EXTRA_ASSUME_PROVIDED, --ignore-deps=EXTRA_ASSUME_PROVIDED |
298 | Stop processing at the given list of dependencies when | 302 | Assume these dependencies don't exist and are already |
299 | generating dependency graphs. This can help to make | 303 | provided (equivalent to ASSUME_PROVIDED). Useful to |
300 | the graph more appealing | 304 | make dependency graphs more appealing |
301 | -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS | 305 | -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS |
302 | Show debug logging for the specified logging domains | 306 | Show debug logging for the specified logging domains |
303 | -P, --profile profile the command and print a report</screen> | 307 | -P, --profile profile the command and print a report |
308 | -u UI, --ui=UI userinterface to use | ||
309 | --revisions-changed Set the exit code depending on whether upstream | ||
310 | floating revisions have changed or not</screen> | ||
304 | 311 | ||
305 | </section> | 312 | </section> |
306 | 313 | ||