From 8c7e1aced86cbef5f7856bb59c2190bb408dd024 Mon Sep 17 00:00:00 2001 From: Zhai Edwin Date: Thu, 9 Sep 2010 16:23:01 +0800 Subject: handbook: review and modify CH4 (BSP) and Appendix B Besides basic corrections, also add .bbappend to bsp introduction and update bitbake help to match latest output Signed-off-by: Zhai Edwin Signed-off-by: Dexuan Cui Signed-off-by: Kevin Tian --- handbook/ref-bitbake.xml | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) (limited to 'handbook/ref-bitbake.xml') diff --git a/handbook/ref-bitbake.xml b/handbook/ref-bitbake.xml index ddf3c760f..eaf946795 100644 --- a/handbook/ref-bitbake.xml +++ b/handbook/ref-bitbake.xml @@ -6,7 +6,7 @@ Reference: Bitbake - Bitbake a program written in Python which interprets the metadata + Bitbake is a program written in Python that interprets the metadata that makes up Poky. At some point, people wonder what actually happens when you type bitbake poky-image-sato. This section aims to give an overview of what happens behind the scenes from a @@ -16,7 +16,7 @@ It is worth noting that bitbake aims to be a generic "task" executor capable of handling complex dependency relationships. As such it has no - real knowledge of what the tasks its executing actually do. It just + real knowledge of what the tasks it is executing actually do. It just considers a list of tasks with dependencies and handles metadata consisting of variables in a certain format which get passed to the tasks. @@ -26,7 +26,7 @@ Parsing - The first thing BitBake does is work out its configuration by + The first thing BitBake does is that work out its configuration by looking for a file called bitbake.conf. Bitbake searches through the BBPATH environment variable looking for a conf/ @@ -117,7 +117,7 @@ specified on the commandline) and looks for providers of that target. Once a provider is selected, BitBake resolves all the dependencies for the target. In the case of "poky-image-sato", it would lead to - task-oh.bb and task-base.bb + task-base.bb which in turn would lead to packages like Contacts, Dates, BusyBox and these in turn depend on glibc and the toolchain. @@ -154,7 +154,8 @@ "1" makes it likely the package will be used. PREFERRED_VERSION overrides - any default preference. DEFAULT_PREFERENCE. DEFAULT_PREFERENCE is often used to mark more experimental new versions of packages until they've undergone sufficient @@ -176,7 +177,7 @@ multi-core systems, BitBake considers each task as an independent entity with a set of dependencies. There are many variables that are used to signify these dependencies and more information can be found - found about these in the + about these in the BitBake manual. At a basic level it is sufficient to know that BitBake uses the DEPENDS and @@ -196,7 +197,7 @@ order. The build now starts with BitBake forking off threads up to the limit set in the BB_NUMBER_THREADS variable - as long there are tasks ready to run, i.e. tasks with all their + as long as there are tasks ready to run, i.e. tasks with all their dependencies met. @@ -271,9 +272,9 @@ Options: target that failed, and those that depend on it, cannot be remade, the other dependencies of these targets can be processed all the same. + -a, --tryaltconfigs continue with builds by trying to use alternative + providers where possible. -f, --force force run of specified cmd, regardless of stamp status - -i, --interactive drop into the interactive mode also called the BitBake - shell. -c CMD, --cmd=CMD Specify task to execute. Note that this only executes the specified task for the providee and the packages it depends on, i.e. 'compile' does not implicitly call @@ -286,6 +287,9 @@ Options: -D, --debug Increase the debug level. You can specify this more than once. -n, --dry-run don't execute, just go through the motions + -S, --dump-signatures + don't execute, just dump out the signature + construction information -p, --parse-only quit after parsing the BB files (developers only) -d, --disable-psyco disable using the psyco just-in-time compiler (not recommended) @@ -294,13 +298,16 @@ Options: what used to be bbread) -g, --graphviz emit the dependency trees of the specified packages in the dot syntax - -I IGNORED_DOT_DEPS, --ignore-deps=IGNORED_DOT_DEPS - Stop processing at the given list of dependencies when - generating dependency graphs. This can help to make - the graph more appealing + -I EXTRA_ASSUME_PROVIDED, --ignore-deps=EXTRA_ASSUME_PROVIDED + Assume these dependencies don't exist and are already + provided (equivalent to ASSUME_PROVIDED). Useful to + make dependency graphs more appealing -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS Show debug logging for the specified logging domains - -P, --profile profile the command and print a report + -P, --profile profile the command and print a report + -u UI, --ui=UI userinterface to use + --revisions-changed Set the exit code depending on whether upstream + floating revisions have changed or not -- cgit v1.2.3