diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/poky-ref-manual/usingpoky.xml | 32 | 
1 files changed, 16 insertions, 16 deletions
| diff --git a/documentation/poky-ref-manual/usingpoky.xml b/documentation/poky-ref-manual/usingpoky.xml index 79e9dfbf9c..2d2e3f6eac 100644 --- a/documentation/poky-ref-manual/usingpoky.xml +++ b/documentation/poky-ref-manual/usingpoky.xml | |||
| @@ -5,7 +5,7 @@ | |||
| 5 | 5 | ||
| 6 | <para> | 6 | <para> | 
| 7 | This section gives an overview of the components that make up Poky | 7 | This section gives an overview of the components that make up Poky | 
| 8 | following by information about running poky builds and dealing with any | 8 | followed by information about running poky builds and dealing with any | 
| 9 | problems that may arise. | 9 | problems that may arise. | 
| 10 | </para> | 10 | </para> | 
| 11 | 11 | ||
| @@ -13,8 +13,8 @@ | |||
| 13 | <title>Poky Overview</title> | 13 | <title>Poky Overview</title> | 
| 14 | 14 | ||
| 15 | <para> | 15 | <para> | 
| 16 | The bitbake task executor together with various types of configuration files form the core of Poky. | 16 | The BitBake task executor together with various types of configuration files form the core of Poky. | 
| 17 | This section overviews the bitbake task executor and the | 17 | This section overviews the BitBake task executor and the | 
| 18 | configuration files by describing what they are used for and they they interact. | 18 | configuration files by describing what they are used for and they they interact. | 
| 19 | </para> | 19 | </para> | 
| 20 | 20 | ||
| @@ -48,12 +48,12 @@ | |||
| 48 | <para> | 48 | <para> | 
| 49 | Bitbake is the tool at the heart of Poky and is responsible | 49 | Bitbake is the tool at the heart of Poky and is responsible | 
| 50 | for parsing the metadata, generating a list of tasks from it | 50 | for parsing the metadata, generating a list of tasks from it | 
| 51 | and then executing them. To see a list of the options bitbake | 51 | and then executing them. To see a list of the options BitBake | 
| 52 | supports look at 'bitbake --help'. | 52 | supports look at 'bitbake --help'. | 
| 53 | </para> | 53 | </para> | 
| 54 | 54 | ||
| 55 | <para> | 55 | <para> | 
| 56 | The most common usage for bitbake is <filename>bitbake <packagename></filename>, where | 56 | The most common usage for BitBake is <filename>bitbake <packagename></filename>, where | 
| 57 | packagename is the name of the package you want to build (referred to as the 'target' | 57 | packagename is the name of the package you want to build (referred to as the 'target' | 
| 58 | in this manual). | 58 | in this manual). | 
| 59 | The target often equates to the first part of a <filename>.bb</filename> filename. | 59 | The target often equates to the first part of a <filename>.bb</filename> filename. | 
| @@ -64,13 +64,13 @@ | |||
| 64 | </literallayout> | 64 | </literallayout> | 
| 65 | Several different versions of <filename>matchbox-desktop</filename> might exist. | 65 | Several different versions of <filename>matchbox-desktop</filename> might exist. | 
| 66 | Bitbake chooses the one selected by the distribution configuration. | 66 | Bitbake chooses the one selected by the distribution configuration. | 
| 67 | You can get more details about how bitbake chooses between different versions | 67 | You can get more details about how BitBake chooses between different versions | 
| 68 | and providers in the <link linkend='ref-bitbake-providers'> | 68 | and providers in the <link linkend='ref-bitbake-providers'> | 
| 69 | 'Preferences and Providers'</link> section. | 69 | 'Preferences and Providers'</link> section. | 
| 70 | </para> | 70 | </para> | 
| 71 | <para> | 71 | <para> | 
| 72 | Bitbake also tries to execute any dependent tasks first. | 72 | Bitbake also tries to execute any dependent tasks first. | 
| 73 | So for example, before building <filename>matchbox-desktop</filename> bitbake | 73 | So for example, before building <filename>matchbox-desktop</filename> BitBake | 
| 74 | would build a cross compiler and glibc if they had not already been built. | 74 | would build a cross compiler and glibc if they had not already been built. | 
| 75 | </para> | 75 | </para> | 
| 76 | 76 | ||
| @@ -197,7 +197,7 @@ | |||
| 197 | <para>The log file for shell tasks is available in <filename>${WORKDIR}/temp/log.do_taskname.pid</filename>. | 197 | <para>The log file for shell tasks is available in <filename>${WORKDIR}/temp/log.do_taskname.pid</filename>. | 
| 198 | For example, the "compile" task of busybox 1.01 on the ARM spitz machine might be | 198 | For example, the "compile" task of busybox 1.01 on the ARM spitz machine might be | 
| 199 | <filename>tmp/work/armv5te-poky-linux-gnueabi/busybox-1.01/temp/log.do_compile.1234</filename>. | 199 | <filename>tmp/work/armv5te-poky-linux-gnueabi/busybox-1.01/temp/log.do_compile.1234</filename>. | 
| 200 | To see what bitbake runs to generate that log, look at the corresponding | 200 | To see what BitBake runs to generate that log, look at the corresponding | 
| 201 | <filename>run.do_taskname.pid </filename> file located in the same directory. | 201 | <filename>run.do_taskname.pid </filename> file located in the same directory. | 
| 202 | </para> | 202 | </para> | 
| 203 | 203 | ||
| @@ -214,10 +214,10 @@ | |||
| 214 | In most cases the series is: fetch, unpack, patch, configure, | 214 | In most cases the series is: fetch, unpack, patch, configure, | 
| 215 | compile, install, package, package_write and build. | 215 | compile, install, package, package_write and build. | 
| 216 | The default task is "build" and any tasks on which it depends build first - hence, | 216 | The default task is "build" and any tasks on which it depends build first - hence, | 
| 217 | the standard bitbake behaviour. | 217 | the standard BitBake behaviour. | 
| 218 | Some tasks exist, such as devshell, that are not part of the default build chain. | 218 | Some tasks exist, such as devshell, that are not part of the default build chain. | 
| 219 | If you wish to run a task that is not part of the default build chain you can use the | 219 | If you wish to run a task that is not part of the default build chain you can use the | 
| 220 | "-c" option in bitbake as follows: | 220 | "-c" option in BitBake as follows: | 
| 221 | <literallayout class='monospaced'> | 221 | <literallayout class='monospaced'> | 
| 222 | $ bitbake matchbox-desktop -c devshell | 222 | $ bitbake matchbox-desktop -c devshell | 
| 223 | </literallayout> | 223 | </literallayout> | 
| @@ -259,7 +259,7 @@ | |||
| 259 | <title>Dependency Graphs</title> | 259 | <title>Dependency Graphs</title> | 
| 260 | 260 | ||
| 261 | <para> | 261 | <para> | 
| 262 | Sometimes it can be hard to see why bitbake wants to build some other packages before a given | 262 | Sometimes it can be hard to see why BitBake wants to build some other packages before a given | 
| 263 | package you've specified. | 263 | package you've specified. | 
| 264 | The <filename>bitbake -g targetname</filename> command creates the <filename>depends.dot</filename> and | 264 | The <filename>bitbake -g targetname</filename> command creates the <filename>depends.dot</filename> and | 
| 265 | <filename>task-depends.dot</filename> files in the current directory. | 265 | <filename>task-depends.dot</filename> files in the current directory. | 
| @@ -273,8 +273,8 @@ | |||
| 273 | <title>General Bitbake Problems</title> | 273 | <title>General Bitbake Problems</title> | 
| 274 | 274 | ||
| 275 | <para> | 275 | <para> | 
| 276 | You can see debug output from bitbake by using the "-D" option. | 276 | You can see debug output from BitBake by using the "-D" option. | 
| 277 | The debug output gives more information about what bitbake | 277 | The debug output gives more information about what BitBake | 
| 278 | is doing and the reason behind it. | 278 | is doing and the reason behind it. | 
| 279 | Each "-D" option you use increases the logging level. | 279 | Each "-D" option you use increases the logging level. | 
| 280 | The most common usage is <filename>-DDD</filename>. | 280 | The most common usage is <filename>-DDD</filename>. | 
| @@ -282,9 +282,9 @@ | |||
| 282 | 282 | ||
| 283 | <para> | 283 | <para> | 
| 284 | The output from <filename>bitbake -DDD -v targetname</filename> can reveal why | 284 | The output from <filename>bitbake -DDD -v targetname</filename> can reveal why | 
| 285 | bitbake chose a certain version of a package or why bitbake | 285 | BitBake chose a certain version of a package or why BitBake | 
| 286 | picked a certain provider. | 286 | picked a certain provider. | 
| 287 | This command could also help you in a situation where you think bitbake did something | 287 | This command could also help you in a situation where you think BitBake did something | 
| 288 | unexpected. | 288 | unexpected. | 
| 289 | </para> | 289 | </para> | 
| 290 | </section> | 290 | </section> | 
| @@ -296,7 +296,7 @@ | |||
| 296 | the command form <filename>bitbake -b somepath/somefile.bb</filename>. | 296 | the command form <filename>bitbake -b somepath/somefile.bb</filename>. | 
| 297 | This command form does not check for dependencies so you should use it | 297 | This command form does not check for dependencies so you should use it | 
| 298 | only when you know its dependencies already exist. | 298 | only when you know its dependencies already exist. | 
| 299 | You can also specify fragments of the filename and bitbake checks for a unique match. | 299 | You can also specify fragments of the filename and BitBake checks for a unique match. | 
| 300 | </para> | 300 | </para> | 
| 301 | </section> | 301 | </section> | 
| 302 | 302 | ||
