diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-12-11 12:07:58 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-01-07 14:43:25 +0000 |
commit | ed0a240e1632682ec4c33341f3e24ad71773cdfc (patch) | |
tree | 201557f498b77b9f51fad7e12a6009f74aca4c65 /documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html | |
parent | af19d889ef320f9625aae42eed6688b5cc739793 (diff) | |
download | poky-ed0a240e1632682ec4c33341f3e24ad71773cdfc.tar.gz |
documentation: Rename of poky-ref-manual folder to ref-manual.
Changing the folder that holds the YP Reference Manual to be
"ref-manual". This will help with confustion over the manual's
intended purpose.
(From yocto-docs rev: 1106442964b5080cb0b6b3bd3af32e9407c0f7c1)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html')
-rw-r--r-- | documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html b/documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html new file mode 100644 index 0000000000..184ffdbd2c --- /dev/null +++ b/documentation/ref-manual/eclipse/html/poky-ref-manual/usingpoky-components-bitbake.html | |||
@@ -0,0 +1,66 @@ | |||
1 | <html> | ||
2 | <head> | ||
3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
4 | <title>3.1.1. BitBake</title> | ||
5 | <link rel="stylesheet" type="text/css" href="../book.css"> | ||
6 | <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> | ||
7 | <link rel="home" href="index.html" title="The Yocto Project Reference Manual"> | ||
8 | <link rel="up" href="usingpoky-components.html" title="3.1. Yocto Project Components"> | ||
9 | <link rel="prev" href="usingpoky-components.html" title="3.1. Yocto Project Components"> | ||
10 | <link rel="next" href="usingpoky-components-metadata.html" title="3.1.2. Metadata (Recipes)"> | ||
11 | </head> | ||
12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="3.1.1. BitBake"> | ||
13 | <div class="titlepage"><div><div><h3 class="title"> | ||
14 | <a name="usingpoky-components-bitbake"></a>3.1.1. BitBake</h3></div></div></div> | ||
15 | <p> | ||
16 | BitBake is the tool at the heart of the OpenEmbedded build system and is responsible | ||
17 | for parsing the metadata, generating a list of tasks from it, | ||
18 | and then executing those tasks. | ||
19 | To see a list of the options BitBake supports, use the following help command: | ||
20 | </p> | ||
21 | <pre class="literallayout"> | ||
22 | $ bitbake --help | ||
23 | </pre> | ||
24 | <p> | ||
25 | </p> | ||
26 | <p> | ||
27 | The most common usage for BitBake is <code class="filename">bitbake <packagename></code>, where | ||
28 | <code class="filename">packagename</code> is the name of the package you want to build | ||
29 | (referred to as the "target" in this manual). | ||
30 | The target often equates to the first part of a <code class="filename">.bb</code> filename. | ||
31 | So, to run the <code class="filename">matchbox-desktop_1.2.3.bb</code> file, you | ||
32 | might type the following: | ||
33 | </p> | ||
34 | <pre class="literallayout"> | ||
35 | $ bitbake matchbox-desktop | ||
36 | </pre> | ||
37 | <p> | ||
38 | Several different versions of <code class="filename">matchbox-desktop</code> might exist. | ||
39 | BitBake chooses the one selected by the distribution configuration. | ||
40 | You can get more details about how BitBake chooses between different | ||
41 | target versions and providers in the | ||
42 | "<a class="link" href="ref-bitbake-providers.html" title="6.2. Preferences and Providers">Preferences and Providers</a>" section. | ||
43 | </p> | ||
44 | <p> | ||
45 | BitBake also tries to execute any dependent tasks first. | ||
46 | So for example, before building <code class="filename">matchbox-desktop</code>, BitBake | ||
47 | would build a cross compiler and <code class="filename">eglibc</code> if they had not already | ||
48 | been built. | ||
49 | </p> | ||
50 | <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> | ||
51 | <h3 class="title">Note</h3>This release of the Yocto Project does not support the <code class="filename">glibc</code> | ||
52 | GNU version of the Unix standard C library. By default, the OpenEmbedded build system | ||
53 | builds with <code class="filename">eglibc</code>.</div> | ||
54 | <p> | ||
55 | </p> | ||
56 | <p> | ||
57 | A useful BitBake option to consider is the <code class="filename">-k</code> or | ||
58 | <code class="filename">--continue</code> option. | ||
59 | This option instructs BitBake to try and continue processing the job as much | ||
60 | as possible even after encountering an error. | ||
61 | When an error occurs, the target that | ||
62 | failed and those that depend on it cannot be remade. | ||
63 | However, when you use this option other dependencies can still be processed. | ||
64 | </p> | ||
65 | </div></body> | ||
66 | </html> | ||