diff options
-rw-r--r-- | documentation/adt-manual/adt-command.xml | 4 | ||||
-rw-r--r-- | documentation/adt-manual/adt-eclipse.xml | 31 | ||||
-rw-r--r-- | documentation/adt-manual/adt-intro.xml | 12 | ||||
-rw-r--r-- | documentation/adt-manual/adt-package.xml | 6 | ||||
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 54 |
5 files changed, 53 insertions, 54 deletions
diff --git a/documentation/adt-manual/adt-command.xml b/documentation/adt-manual/adt-command.xml index 43bd08b74f..f5ed906962 100644 --- a/documentation/adt-manual/adt-command.xml +++ b/documentation/adt-manual/adt-command.xml | |||
@@ -8,7 +8,7 @@ | |||
8 | <para> | 8 | <para> |
9 | Recall that earlier the manual discussed how to use an existing toolchain | 9 | Recall that earlier the manual discussed how to use an existing toolchain |
10 | tarball that had been installed into <filename>/opt/poky</filename>, | 10 | tarball that had been installed into <filename>/opt/poky</filename>, |
11 | which is outside of the Yocto Project build tree | 11 | which is outside of the build directory |
12 | (see the section "<link linkend='using-an-existing-toolchain-tarball'>Using an Existing | 12 | (see the section "<link linkend='using-an-existing-toolchain-tarball'>Using an Existing |
13 | Toolchain Tarball)</link>". | 13 | Toolchain Tarball)</link>". |
14 | And, that sourcing your architecture-specific environment setup script | 14 | And, that sourcing your architecture-specific environment setup script |
@@ -21,7 +21,7 @@ | |||
21 | for example, <filename>configure.sh</filename> can find pre-generated | 21 | for example, <filename>configure.sh</filename> can find pre-generated |
22 | test results for tests that need target hardware on which to run. | 22 | test results for tests that need target hardware on which to run. |
23 | These conditions allow you to easily use the toolchain outside of the | 23 | These conditions allow you to easily use the toolchain outside of the |
24 | Yocto Project build environment on both autotools-based projects and | 24 | OpenEmbedded build environment on both autotools-based projects and |
25 | Makefile-based projects. | 25 | Makefile-based projects. |
26 | </para> | 26 | </para> |
27 | 27 | ||
diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index 44909b8f5e..4d400ad6df 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml | |||
@@ -7,9 +7,9 @@ | |||
7 | 7 | ||
8 | <para> | 8 | <para> |
9 | The Eclipse IDE is a popular development environment and it fully supports | 9 | The Eclipse IDE is a popular development environment and it fully supports |
10 | development using Yocto Project. | 10 | development using the Yocto Project. |
11 | When you install and configure the Eclipse Yocto Project Plug-in into | 11 | When you install and configure the Eclipse Yocto Project Plug-in into |
12 | the Eclipse IDE, you maximize your Yocto Project design experience. | 12 | the Eclipse IDE, you maximize your Yocto Project experience. |
13 | Installing and configuring the Plug-in results in an environment that | 13 | Installing and configuring the Plug-in results in an environment that |
14 | has extensions specifically designed to let you more easily develop software. | 14 | has extensions specifically designed to let you more easily develop software. |
15 | These extensions allow for cross-compilation, deployment, and execution of | 15 | These extensions allow for cross-compilation, deployment, and execution of |
@@ -21,7 +21,7 @@ | |||
21 | </para> | 21 | </para> |
22 | <para> | 22 | <para> |
23 | This section describes how to install and configure the Eclipse IDE | 23 | This section describes how to install and configure the Eclipse IDE |
24 | Yocto Plug-in and how to use it to develop your Yocto Project. | 24 | Yocto Plug-in and how to use it to develop your application. |
25 | </para> | 25 | </para> |
26 | 26 | ||
27 | <section id='setting-up-the-eclipse-ide'> | 27 | <section id='setting-up-the-eclipse-ide'> |
@@ -152,7 +152,7 @@ | |||
152 | 152 | ||
153 | <para> | 153 | <para> |
154 | You can install the Eclipse Yocto Plug-in into the Eclipse IDE | 154 | You can install the Eclipse Yocto Plug-in into the Eclipse IDE |
155 | one of two ways: use the Yocto Project update site to install the pre-built plug-in, | 155 | one of two ways: use the Yocto Project's Eclipse Update site to install the pre-built plug-in, |
156 | or build and install the plug-in from the latest source code. | 156 | or build and install the plug-in from the latest source code. |
157 | If you don't want to permanently install the plug-in but just want to try it out | 157 | If you don't want to permanently install the plug-in but just want to try it out |
158 | within the Eclipse environment, you can import the plug-in project from the | 158 | within the Eclipse environment, you can import the plug-in project from the |
@@ -320,10 +320,10 @@ | |||
320 | <listitem><para><emphasis> | 320 | <listitem><para><emphasis> |
321 | <filename>Build System Derived Toolchain:</filename></emphasis> | 321 | <filename>Build System Derived Toolchain:</filename></emphasis> |
322 | Select this mode if the cross-toolchain has been installed and built | 322 | Select this mode if the cross-toolchain has been installed and built |
323 | as part of the Yocto Project build tree. | 323 | as part of the build directory. |
324 | When you select <filename>Build system derived toolchain</filename>, | 324 | When you select <filename>Build system derived toolchain</filename>, |
325 | you are using the toolchain bundled | 325 | you are using the toolchain bundled |
326 | inside the Yocto Project build tree. | 326 | inside the build directory. |
327 | </para></listitem> | 327 | </para></listitem> |
328 | </itemizedlist> | 328 | </itemizedlist> |
329 | </para></listitem> | 329 | </para></listitem> |
@@ -342,11 +342,10 @@ | |||
342 | However, doing so is discouraged.</note></para> | 342 | However, doing so is discouraged.</note></para> |
343 | <para>If you are using a system-derived toolchain, the path you provide | 343 | <para>If you are using a system-derived toolchain, the path you provide |
344 | for the <filename>Toolchain Root Location</filename> | 344 | for the <filename>Toolchain Root Location</filename> |
345 | field is the Yocto Project's build directory. | 345 | field is the build directory. |
346 | See section "<link linkend='using-the-toolchain-from-within-the-build-tree'>Using | 346 | See section "<link linkend='using-the-toolchain-from-within-the-build-tree'>Using |
347 | BitBake and the Yocto Project Build Tree</link>" for | 347 | BitBake and the build directory</link>" for |
348 | information on how to install the toolchain into the Yocto | 348 | information on how to install the toolchain into the build directory.</para></listitem> |
349 | Project build tree.</para></listitem> | ||
350 | <listitem><para><emphasis>Specify the Sysroot Location:</emphasis> | 349 | <listitem><para><emphasis>Specify the Sysroot Location:</emphasis> |
351 | This location is where the root filesystem for the | 350 | This location is where the root filesystem for the |
352 | target hardware is created on the development system by the ADT Installer. | 351 | target hardware is created on the development system by the ADT Installer. |
@@ -380,7 +379,7 @@ | |||
380 | and specify any custom options.</para> | 379 | and specify any custom options.</para> |
381 | <para>If you selected <filename>Build system derived toolchain</filename>, | 380 | <para>If you selected <filename>Build system derived toolchain</filename>, |
382 | the target kernel you built will be located in the | 381 | the target kernel you built will be located in the |
383 | Yocto Project build tree in <filename>tmp/deploy/images</filename> directory. | 382 | build directory in <filename>tmp/deploy/images</filename> directory. |
384 | If you selected <filename>Standalone pre-built toolchain</filename>, the | 383 | If you selected <filename>Standalone pre-built toolchain</filename>, the |
385 | pre-built image you downloaded is located | 384 | pre-built image you downloaded is located |
386 | in the directory you specified when you downloaded the image.</para> | 385 | in the directory you specified when you downloaded the image.</para> |
@@ -433,7 +432,7 @@ | |||
433 | <listitem><para>Double click <filename>C Project</filename> to create the project.</para></listitem> | 432 | <listitem><para>Double click <filename>C Project</filename> to create the project.</para></listitem> |
434 | <listitem><para>Expand <filename>Yocto Project ADT Project</filename>.</para></listitem> | 433 | <listitem><para>Expand <filename>Yocto Project ADT Project</filename>.</para></listitem> |
435 | <listitem><para>Select <filename>Hello World ANSI C Autotools Project</filename>. | 434 | <listitem><para>Select <filename>Hello World ANSI C Autotools Project</filename>. |
436 | This is an Autotools-based project based on a Yocto Project template.</para></listitem> | 435 | This is an Autotools-based project based on a Yocto template.</para></listitem> |
437 | <listitem><para>Put a name in the <filename>Project name:</filename> field. | 436 | <listitem><para>Put a name in the <filename>Project name:</filename> field. |
438 | Do not use hyphens as part of the name.</para></listitem> | 437 | Do not use hyphens as part of the name.</para></listitem> |
439 | <listitem><para>Click <filename>Next</filename>.</para></listitem> | 438 | <listitem><para>Click <filename>Next</filename>.</para></listitem> |
@@ -677,7 +676,7 @@ | |||
677 | <filename><project_location>/<project_name></filename>. | 676 | <filename><project_location>/<project_name></filename>. |
678 | If that directory does not exist, you need to check | 677 | If that directory does not exist, you need to check |
679 | the "Clone from Yocto Git Repository" box, which would execute a | 678 | the "Clone from Yocto Git Repository" box, which would execute a |
680 | <filename>git clone</filename> command to get the Yocto project's metadata files. | 679 | <filename>git clone</filename> command to get the project's metadata files. |
681 | </para></listitem> | 680 | </para></listitem> |
682 | <listitem><para>Select <filename>Finish</filename> to create the project.</para></listitem> | 681 | <listitem><para>Select <filename>Finish</filename> to create the project.</para></listitem> |
683 | </orderedlist> | 682 | </orderedlist> |
@@ -702,9 +701,9 @@ | |||
702 | <listitem><para>Select <filename>File -> New -> Yocto BitBake Commander -> BitBake Recipe</filename> | 701 | <listitem><para>Select <filename>File -> New -> Yocto BitBake Commander -> BitBake Recipe</filename> |
703 | to open a new recipe wizard.</para></listitem> | 702 | to open a new recipe wizard.</para></listitem> |
704 | <listitem><para>Point to your source by filling in the "SRC_URL" field. | 703 | <listitem><para>Point to your source by filling in the "SRC_URL" field. |
705 | For example, you can add a recipe in the | 704 | For example, you can add a recipe to your |
706 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-source-files'>Yocto Project Source Files</ulink>, | 705 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-source-files'>source directory structure</ulink> |
707 | input the "SRC_URL" as follows: | 706 | by defining "SRC_URL" as follows: |
708 | <literallayout class='monospaced'> | 707 | <literallayout class='monospaced'> |
709 | ftp://ftp.gnu.org/gnu/m4/m4-1.4.9.tar.gz | 708 | ftp://ftp.gnu.org/gnu/m4/m4-1.4.9.tar.gz |
710 | </literallayout></para></listitem> | 709 | </literallayout></para></listitem> |
diff --git a/documentation/adt-manual/adt-intro.xml b/documentation/adt-manual/adt-intro.xml index 83fe3094e6..ac286a5840 100644 --- a/documentation/adt-manual/adt-intro.xml +++ b/documentation/adt-manual/adt-intro.xml | |||
@@ -17,7 +17,7 @@ | |||
17 | 17 | ||
18 | <para> | 18 | <para> |
19 | Fundamentally, the ADT consists of an architecture-specific cross-toolchain and | 19 | Fundamentally, the ADT consists of an architecture-specific cross-toolchain and |
20 | a matching sysroot that are both built by the Yocto Project build system Poky. | 20 | a matching sysroot that are both built by the OpenEmbedded build system Poky. |
21 | The toolchain and sysroot are based on a metadata configuration and extensions, | 21 | The toolchain and sysroot are based on a metadata configuration and extensions, |
22 | which allows you to cross-develop on the host machine for the target. | 22 | which allows you to cross-develop on the host machine for the target. |
23 | </para> | 23 | </para> |
@@ -50,7 +50,7 @@ | |||
50 | The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger | 50 | The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger |
51 | that are used to develop user-space applications for targeted hardware. | 51 | that are used to develop user-space applications for targeted hardware. |
52 | This toolchain is created either by running the ADT Installer script or | 52 | This toolchain is created either by running the ADT Installer script or |
53 | through a Yocto Project build tree that is based on your metadata | 53 | through a build directory that is based on your metadata |
54 | configuration or extension for your targeted device. | 54 | configuration or extension for your targeted device. |
55 | The cross-toolchain works with a matching target sysroot. | 55 | The cross-toolchain works with a matching target sysroot. |
56 | </para> | 56 | </para> |
@@ -63,7 +63,7 @@ | |||
63 | The matching target sysroot contains needed headers and libraries for generating | 63 | The matching target sysroot contains needed headers and libraries for generating |
64 | binaries that run on the target architecture. | 64 | binaries that run on the target architecture. |
65 | The sysroot is based on the target root filesystem image that is built by | 65 | The sysroot is based on the target root filesystem image that is built by |
66 | the Yocto Project's build system Poky and uses the same metadata configuration | 66 | the OpenEmbedded build system Poky and uses the same metadata configuration |
67 | used to build the cross-toolchain. | 67 | used to build the cross-toolchain. |
68 | </para> | 68 | </para> |
69 | </section> | 69 | </section> |
@@ -79,8 +79,8 @@ | |||
79 | <listitem><para>If you use the ADT Installer script to install ADT, you can | 79 | <listitem><para>If you use the ADT Installer script to install ADT, you can |
80 | specify whether or not to install QEMU.</para></listitem> | 80 | specify whether or not to install QEMU.</para></listitem> |
81 | <listitem><para>If you have downloaded a Yocto Project release and unpacked | 81 | <listitem><para>If you have downloaded a Yocto Project release and unpacked |
82 | it to create a Yocto Project file structure and you have sourced | 82 | it to create a source directory and you have sourced |
83 | the Yocto Project environment setup script, QEMU is installed and automatically | 83 | the environment setup script, QEMU is installed and automatically |
84 | available.</para></listitem> | 84 | available.</para></listitem> |
85 | <listitem><para>If you have installed the cross-toolchain | 85 | <listitem><para>If you have installed the cross-toolchain |
86 | tarball and you have sourcing the toolchain's setup environment script, QEMU | 86 | tarball and you have sourcing the toolchain's setup environment script, QEMU |
@@ -120,7 +120,7 @@ | |||
120 | <listitem><para><emphasis>SystemTap:</emphasis> A free software infrastructure | 120 | <listitem><para><emphasis>SystemTap:</emphasis> A free software infrastructure |
121 | that simplifies information gathering about a running Linux system. | 121 | that simplifies information gathering about a running Linux system. |
122 | This information helps you diagnose performance or functional problems. | 122 | This information helps you diagnose performance or functional problems. |
123 | SystemTap is not available as a user-space tool through the Yocto Eclipse IDE Plug-in. | 123 | SystemTap is not available as a user-space tool through the Eclipse IDE Yocto Plug-in. |
124 | See <ulink url='http://sourceware.org/systemtap'></ulink> for more information | 124 | See <ulink url='http://sourceware.org/systemtap'></ulink> for more information |
125 | on SystemTap.</para></listitem> | 125 | on SystemTap.</para></listitem> |
126 | <listitem><para><emphasis>Lttng-ust:</emphasis> A User-space Tracer designed to | 126 | <listitem><para><emphasis>Lttng-ust:</emphasis> A User-space Tracer designed to |
diff --git a/documentation/adt-manual/adt-package.xml b/documentation/adt-manual/adt-package.xml index 26b5dc18d8..0da301b123 100644 --- a/documentation/adt-manual/adt-package.xml +++ b/documentation/adt-manual/adt-package.xml | |||
@@ -17,7 +17,7 @@ | |||
17 | <title>Package Management Systems</title> | 17 | <title>Package Management Systems</title> |
18 | 18 | ||
19 | <para> | 19 | <para> |
20 | The Yocto Project supports the generation of sysroot files using | 20 | The OpenEmbedded build system supports the generation of sysroot files using |
21 | three different Package Management Systems (PMS): | 21 | three different Package Management Systems (PMS): |
22 | <itemizedlist> | 22 | <itemizedlist> |
23 | <listitem><para><emphasis>OPKG:</emphasis> A less well known PMS whose use | 23 | <listitem><para><emphasis>OPKG:</emphasis> A less well known PMS whose use |
@@ -28,7 +28,7 @@ | |||
28 | <listitem><para><emphasis>RPM:</emphasis> A more widely known PMS intended for GNU/Linux | 28 | <listitem><para><emphasis>RPM:</emphasis> A more widely known PMS intended for GNU/Linux |
29 | distributions. | 29 | distributions. |
30 | This PMS works with files packaged in an <filename>.rms</filename> format. | 30 | This PMS works with files packaged in an <filename>.rms</filename> format. |
31 | The Yocto Project currently installs through this PMS by default. | 31 | The build system currently installs through this PMS by default. |
32 | See <ulink url='http://en.wikipedia.org/wiki/RPM_Package_Manager'></ulink> | 32 | See <ulink url='http://en.wikipedia.org/wiki/RPM_Package_Manager'></ulink> |
33 | for more information about RPM.</para></listitem> | 33 | for more information about RPM.</para></listitem> |
34 | <listitem><para><emphasis>Debian:</emphasis> The PMS for Debian-based systems | 34 | <listitem><para><emphasis>Debian:</emphasis> The PMS for Debian-based systems |
@@ -75,7 +75,7 @@ | |||
75 | </para> | 75 | </para> |
76 | 76 | ||
77 | <para> | 77 | <para> |
78 | Next, source the environment setup script found in the Yocto Project files. | 78 | Next, source the environment setup script found in the source directory. |
79 | Follow that by setting up the installation destination to point to your | 79 | Follow that by setting up the installation destination to point to your |
80 | sysroot as <filename><sysroot_dir></filename>. | 80 | sysroot as <filename><sysroot_dir></filename>. |
81 | Finally, have an OPKG configuration file <filename><conf_file></filename> | 81 | Finally, have an OPKG configuration file <filename><conf_file></filename> |
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index c3e4f6e987..0cda17846c 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
@@ -51,8 +51,8 @@ | |||
51 | If you use this method, you just get the cross-toolchain and QEMU - you do not | 51 | If you use this method, you just get the cross-toolchain and QEMU - you do not |
52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> | 52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> |
53 | <listitem><para><emphasis>Use the Toolchain from within a Yocto Project Build Tree:</emphasis> | 53 | <listitem><para><emphasis>Use the Toolchain from within a Yocto Project Build Tree:</emphasis> |
54 | If you already have a Yocto Project build tree, you can build the cross-toolchain | 54 | If you already have a build directory, you can build the cross-toolchain |
55 | within tree. | 55 | within that structure. |
56 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you | 56 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you |
57 | do not get any of the other benefits without taking separate steps.</para></listitem> | 57 | do not get any of the other benefits without taking separate steps.</para></listitem> |
58 | </itemizedlist> | 58 | </itemizedlist> |
@@ -75,22 +75,21 @@ | |||
75 | <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically | 75 | <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically |
76 | at | 76 | at |
77 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. | 77 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. |
78 | Or, you can use BitBake to generate the tarball inside the existing Yocto Project | 78 | Or, you can use BitBake to generate the tarball inside the existing build directory. |
79 | build tree. | ||
80 | </para> | 79 | </para> |
81 | 80 | ||
82 | <para> | 81 | <para> |
83 | If you use BitBake to generate the ADT Installer tarball, you must | 82 | If you use BitBake to generate the ADT Installer tarball, you must |
84 | <filename>source</filename> the Yocto Project environment setup script | 83 | <filename>source</filename> the environment setup script |
85 | (<filename>oe-init-build-env</filename>) located | 84 | (<filename>oe-init-build-env</filename>) located |
86 | in the Yocto Project file structure before running the <filename>bitbake</filename> | 85 | in the source directory before running the <filename>bitbake</filename> |
87 | command that creates the tarball. | 86 | command that creates the tarball. |
88 | </para> | 87 | </para> |
89 | 88 | ||
90 | <para> | 89 | <para> |
91 | The following example commands download the Yocto Project release tarball, set up the Yocto | 90 | The following example commands download the Yocto Project release tarball, set up the |
92 | Project files structure, set up the environment while also creating the | 91 | source directory, set up the environment while also creating the |
93 | default Yocto Project build tree, | 92 | default build directory, |
94 | and run the <filename>bitbake</filename> command that results in the tarball | 93 | and run the <filename>bitbake</filename> command that results in the tarball |
95 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: | 94 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: |
96 | <literallayout class='monospaced'> | 95 | <literallayout class='monospaced'> |
@@ -151,7 +150,7 @@ | |||
151 | or not to install the emulator QEMU.</para></listitem> | 150 | or not to install the emulator QEMU.</para></listitem> |
152 | <listitem><para><filename>YOCTOADT_NFS_UTIL</filename>: Indicates whether | 151 | <listitem><para><filename>YOCTOADT_NFS_UTIL</filename>: Indicates whether |
153 | or not to install user-mode NFS. | 152 | or not to install user-mode NFS. |
154 | If you plan to use the Yocto Eclipse IDE plug-in against QEMU, | 153 | If you plan to use the Eclipse IDE Yocto plug-in against QEMU, |
155 | you should install NFS. | 154 | you should install NFS. |
156 | <note>To boot QEMU images using our userspace NFS server, you need | 155 | <note>To boot QEMU images using our userspace NFS server, you need |
157 | to be running <filename>portmap</filename> or <filename>rpcbind</filename>. | 156 | to be running <filename>portmap</filename> or <filename>rpcbind</filename>. |
@@ -244,17 +243,17 @@ | |||
244 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2 | 243 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2 |
245 | </literallayout> | 244 | </literallayout> |
246 | <note><para>As an alternative to steps one and two, you can build the toolchain tarball | 245 | <note><para>As an alternative to steps one and two, you can build the toolchain tarball |
247 | if you have a Yocto Project build tree. | 246 | if you have a build directory. |
248 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> | 247 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> |
249 | command. | 248 | command. |
250 | The resulting tarball will support such development. | 249 | The resulting tarball will support such development. |
251 | However, if you are not concerned with GMAE, | 250 | However, if you are not concerned with GMAE, |
252 | you can generate the tarball using <filename>bitbake meta-toolchain</filename>.</para> | 251 | you can generate the tarball using <filename>bitbake meta-toolchain</filename>.</para> |
253 | <para>Use the appropriate <filename>bitbake</filename> command only after you have | 252 | <para>Use the appropriate <filename>bitbake</filename> command only after you have |
254 | sourced the <filename>oe-build-init-env</filename> script located in the Yocto | 253 | sourced the <filename>oe-build-init-env</filename> script located in the source |
255 | Project files. | 254 | directory. |
256 | When the <filename>bitbake</filename> command completes, the tarball will | 255 | When the <filename>bitbake</filename> command completes, the tarball will |
257 | be in <filename>tmp/deploy/sdk</filename> in the Yocto Project build tree. | 256 | be in <filename>tmp/deploy/sdk</filename> in the build directory. |
258 | </para></note></para></listitem> | 257 | </para></note></para></listitem> |
259 | <listitem><para>Make sure you are in the root directory with root privileges and then expand | 258 | <listitem><para>Make sure you are in the root directory with root privileges and then expand |
260 | the tarball. | 259 | the tarball. |
@@ -267,11 +266,11 @@ | |||
267 | </section> | 266 | </section> |
268 | 267 | ||
269 | <section id='using-the-toolchain-from-within-the-build-tree'> | 268 | <section id='using-the-toolchain-from-within-the-build-tree'> |
270 | <title>Using BitBake and the Yocto Project Build Tree</title> | 269 | <title>Using BitBake and the Build Directory</title> |
271 | 270 | ||
272 | <para> | 271 | <para> |
273 | A final way of making the cross-toolchain available is to use BitBake | 272 | A final way of making the cross-toolchain available is to use BitBake |
274 | to generate the toolchain within an existing Yocto Project build tree. | 273 | to generate the toolchain within an existing build directory. |
275 | This method does not install the toolchain into the | 274 | This method does not install the toolchain into the |
276 | <filename>/opt</filename> directory. | 275 | <filename>/opt</filename> directory. |
277 | As with the previous method, if you need to install the target sysroot, you must | 276 | As with the previous method, if you need to install the target sysroot, you must |
@@ -282,12 +281,12 @@ | |||
282 | Follow these steps to generate the toolchain into the build tree: | 281 | Follow these steps to generate the toolchain into the build tree: |
283 | <orderedlist> | 282 | <orderedlist> |
284 | <listitem><para>Source the environment setup script | 283 | <listitem><para>Source the environment setup script |
285 | <filename>oe-init-build-env</filename> located in the Yocto Project | 284 | <filename>oe-init-build-env</filename> located in the source directory. |
286 | files.</para></listitem> | 285 | </para></listitem> |
287 | <listitem><para>At this point, you should be sure that the | 286 | <listitem><para>At this point, you should be sure that the |
288 | <filename>MACHINE</filename> variable | 287 | <filename>MACHINE</filename> variable |
289 | in the <filename>local.conf</filename> file found in the | 288 | in the <filename>local.conf</filename> file found in the |
290 | <filename>conf</filename> directory of the Yocto Project build directory | 289 | <filename>conf</filename> directory of the build directory |
291 | is set for the target architecture. | 290 | is set for the target architecture. |
292 | Comments within the <filename>local.conf</filename> file list the values you | 291 | Comments within the <filename>local.conf</filename> file list the values you |
293 | can use for the <filename>MACHINE</filename> variable. | 292 | can use for the <filename>MACHINE</filename> variable. |
@@ -305,9 +304,9 @@ | |||
305 | after checking or editing the <filename>local.conf</filename> but without | 304 | after checking or editing the <filename>local.conf</filename> but without |
306 | changing out of your working directory.</note> | 305 | changing out of your working directory.</note> |
307 | Once the <filename>bitbake</filename> command finishes, | 306 | Once the <filename>bitbake</filename> command finishes, |
308 | the cross-toolchain is generated and populated within the Yocto Project build tree. | 307 | the cross-toolchain is generated and populated within the build directory. |
309 | You will notice environment setup files for the cross-toolchain in the | 308 | You will notice environment setup files for the cross-toolchain in the |
310 | Yocto Project build tree in the <filename>tmp</filename> directory. | 309 | build directory in the <filename>tmp</filename> directory. |
311 | Setup script filenames contain the strings <filename>environment-setup</filename>. | 310 | Setup script filenames contain the strings <filename>environment-setup</filename>. |
312 | </para></listitem> | 311 | </para></listitem> |
313 | </orderedlist> | 312 | </orderedlist> |
@@ -325,7 +324,7 @@ | |||
325 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> | 324 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> |
326 | directory. | 325 | directory. |
327 | If you installed the toolchain in the build tree, you can find the environment setup | 326 | If you installed the toolchain in the build tree, you can find the environment setup |
328 | script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory. | 327 | script for the toolchain in the build directory's <filename>tmp</filename> directory. |
329 | </para> | 328 | </para> |
330 | 329 | ||
331 | <para> | 330 | <para> |
@@ -363,14 +362,15 @@ | |||
363 | </para> | 362 | </para> |
364 | 363 | ||
365 | <para> | 364 | <para> |
366 | The Yocto Project provides basic kernel and filesystem images for several | 365 | The Yocto Project ships basic kernel and filesystem images for several |
367 | architectures (<filename>x86</filename>, <filename>x86-64</filename>, | 366 | architectures (<filename>x86</filename>, <filename>x86-64</filename>, |
368 | <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) | 367 | <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) |
369 | that you can use unaltered in the QEMU emulator. | 368 | that you can use unaltered in the QEMU emulator. |
370 | These kernel images reside in the Yocto Project release | 369 | These kernel images reside in the release |
371 | area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink> | 370 | area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink> |
372 | and are ideal for experimentation within Yocto Project. | 371 | and are ideal for experimentation using Yocto Project. |
373 | For information on the image types you can build using the Yocto Project, see the | 372 | For information on the image types you can build using the OpenEmbedded build system, |
373 | see the | ||
374 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in | 374 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in |
375 | The Yocto Project Reference Manual. | 375 | The Yocto Project Reference Manual. |
376 | </para> | 376 | </para> |
@@ -389,7 +389,7 @@ | |||
389 | you can do so one of two ways: | 389 | you can do so one of two ways: |
390 | <itemizedlist> | 390 | <itemizedlist> |
391 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in | 391 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in |
392 | the Yocto Project build directory and then rebuild the image. | 392 | the build directory and then rebuild the image. |
393 | With this method, you need to modify the <filename>EXTRA_IMAGE_FEATURES</filename> | 393 | With this method, you need to modify the <filename>EXTRA_IMAGE_FEATURES</filename> |
394 | variable to have the value of "tools-debug" before rebuilding the image. | 394 | variable to have the value of "tools-debug" before rebuilding the image. |
395 | Once the image is rebuilt, the <filename>tcf-agent</filename> will be included | 395 | Once the image is rebuilt, the <filename>tcf-agent</filename> will be included |