diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-08-26 11:17:49 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-08-26 11:06:30 +0100 |
commit | e901047d4db48fc5e5f20d71fa20601a9e735ab6 (patch) | |
tree | 5fabaf4420963e6f43b12dd888179be7e7f8f396 /documentation | |
parent | 648da6d502e7253873dd9759a2482895d7f0159b (diff) | |
download | poky-e901047d4db48fc5e5f20d71fa20601a9e735ab6.tar.gz |
yocto-project-qs, adt-manual: Updates to toolchain installer script
The way in which the toolchain installer scripts are named has
changed. I have updated two sections that describe this so that
the new naming scheme is used.
(From yocto-docs rev: 71b70a12c72bca7cad565b5d6f44b2c6b311844d)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 17 | ||||
-rw-r--r-- | documentation/yocto-project-qs/yocto-project-qs.xml | 60 |
2 files changed, 51 insertions, 26 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index f8ba557f39..6900b0cd8c 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
@@ -229,8 +229,10 @@ | |||
229 | <title>Using a Cross-Toolchain Tarball</title> | 229 | <title>Using a Cross-Toolchain Tarball</title> |
230 | 230 | ||
231 | <para> | 231 | <para> |
232 | If you want to simply install the cross-toolchain by hand, you can | 232 | If you want to simply install a cross-toolchain by hand, you can |
233 | do so by running the toolchain installer. | 233 | do so by running the toolchain installer. |
234 | The installer includes the pre-built cross-toolchain, the | ||
235 | <filename>runqemu</filename> script, and support files. | ||
234 | If you use this method to install the cross-toolchain, you | 236 | If you use this method to install the cross-toolchain, you |
235 | might still need to install the target sysroot by installing and | 237 | might still need to install the target sysroot by installing and |
236 | extracting it separately. | 238 | extracting it separately. |
@@ -241,25 +243,30 @@ | |||
241 | <para> | 243 | <para> |
242 | Follow these steps: | 244 | Follow these steps: |
243 | <orderedlist> | 245 | <orderedlist> |
244 | <listitem><para>Get the toolchain installer using one of the | 246 | <listitem><para>Get your toolchain installer using one of the |
245 | following methods: | 247 | following methods: |
246 | <itemizedlist> | 248 | <itemizedlist> |
247 | <listitem><para>Go to | 249 | <listitem><para>Go to |
248 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink> | 250 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink> |
249 | and find the folder that matches your host | 251 | and find the folder that matches your host |
250 | development system (i.e. <filename>i686</filename> | 252 | development system (i.e. <filename>i686</filename> |
251 | for 32-bit machines or <filename>x86-64</filename> | 253 | for 32-bit machines or <filename>x86_64</filename> |
252 | for 64-bit machines).</para> | 254 | for 64-bit machines).</para> |
253 | <para>Go into that folder and download the toolchain | 255 | <para>Go into that folder and download the toolchain |
254 | installer whose name includes the appropriate target | 256 | installer whose name includes the appropriate target |
255 | architecture. | 257 | architecture. |
258 | The toolchains provided by the Yocto Project | ||
259 | are based off of the | ||
260 | <filename>core-image-sato</filename> image and | ||
261 | contain libraries appropriate for developing | ||
262 | against that image. | ||
256 | For example, if your host development system is a | 263 | For example, if your host development system is a |
257 | 64-bit x86 system and you are going to use | 264 | 64-bit x86 system and you are going to use |
258 | your cross-toolchain for a 32-bit x86 | 265 | your cross-toolchain for a 32-bit x86 |
259 | target, go into the <filename>x86_64</filename> | 266 | target, go into the <filename>x86_64</filename> |
260 | folder and download the following installer: | 267 | folder and download the following installer: |
261 | <literallayout class='monospaced'> | 268 | <literallayout class='monospaced'> |
262 | poky-eglibc-x86_64-i586-toolchain-&DISTRO;.sh | 269 | poky-eglibc-x86_64-core-image-sato-i586.sh |
263 | </literallayout></para></listitem> | 270 | </literallayout></para></listitem> |
264 | <listitem><para>Build your own toolchain installer. | 271 | <listitem><para>Build your own toolchain installer. |
265 | For cases where you cannot use an installer | 272 | For cases where you cannot use an installer |
@@ -278,7 +285,7 @@ | |||
278 | The example assumes the toolchain installer is located | 285 | The example assumes the toolchain installer is located |
279 | in <filename>~/Downloads/</filename>. | 286 | in <filename>~/Downloads/</filename>. |
280 | <literallayout class='monospaced'> | 287 | <literallayout class='monospaced'> |
281 | $ ~/Downloads/poky-eglibc-x86_64-i586-toolchain-&DISTRO;.sh | 288 | $ ~/Downloads/poky-eglibc-x86_64-core-image-sato-i586.sh |
282 | </literallayout> | 289 | </literallayout> |
283 | <note> | 290 | <note> |
284 | If you do not have write permissions for the directory | 291 | If you do not have write permissions for the directory |
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index a8e8c3a35a..372a86efd0 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml | |||
@@ -552,44 +552,62 @@ | |||
552 | 552 | ||
553 | <section id='installing-the-toolchain'> | 553 | <section id='installing-the-toolchain'> |
554 | <title>Installing the Toolchain</title> | 554 | <title>Installing the Toolchain</title> |
555 | |||
555 | <para> | 556 | <para> |
556 | You can download a tarball installer, which includes the pre-built toolchain, the | 557 | You can download a tarball installer, which includes the |
557 | <filename>runqemu</filename> | 558 | pre-built toolchain, the <filename>runqemu</filename> |
558 | script, and support files from the appropriate directory under | 559 | script, and support files from the appropriate directory under |
559 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>. | 560 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>. |
560 | Toolchains are available for 32-bit and 64-bit x86 development systems from the | 561 | Toolchains are available for 32-bit and 64-bit x86 development |
561 | <filename>i686</filename> and <filename>x86_64</filename> directories, respectively. | 562 | systems from the <filename>i686</filename> and |
562 | Each type of development system supports five target architectures. | 563 | <filename>x86_64</filename> directories, respectively. |
563 | The names of the tarball installer scripts are such that a string representing the | 564 | The toolchains the Yocto Project provides are based off the |
564 | host system appears first in the filename and then is immediately followed by a | 565 | <filename>core-image-sato</filename> image and contain |
565 | string representing the target architecture. | 566 | libraries appropriate for developing against that image. |
567 | Each type of development system supports five or more target | ||
568 | architectures. | ||
569 | </para> | ||
570 | |||
571 | <para> | ||
572 | The names of the tarball installer scripts are such that a | ||
573 | string representing the host system appears first in the | ||
574 | filename and then is immediately followed by a string | ||
575 | that represents the target architecture. | ||
566 | </para> | 576 | </para> |
567 | 577 | ||
568 | <literallayout class='monospaced'> | 578 | <literallayout class='monospaced'> |
569 | poky-eglibc-<<emphasis>host_system</emphasis>>-<<emphasis>arch</emphasis>>-toolchain-gmae-<<emphasis>release</emphasis>>.sh | 579 | poky-eglibc-<<emphasis>host_system</emphasis>>-<<emphasis>image_type</emphasis>>-<<emphasis>arch</emphasis>>.sh |
570 | 580 | ||
571 | Where: | 581 | Where: |
572 | <<emphasis>host_system</emphasis>> is a string representing your development system: | 582 | <<emphasis>host_system</emphasis>> is a string representing your development system: |
573 | i686 or x86_64. | 583 | i686 or x86_64. |
574 | 584 | ||
575 | <<emphasis>arch</emphasis>> is a string representing the target architecture: | 585 | <<emphasis>image_type</emphasis>> is a string representing the image you wish to |
576 | i586, x86_64, powerpc, mips, or arm. | 586 | develop a Software Development Toolkit (SDK) for use against. |
587 | The Yocto Project builds toolchain installers using the | ||
588 | following BitBake command: | ||
589 | |||
590 | bitbake core-image-sato -c do_populatesdk core-image-sato | ||
577 | 591 | ||
578 | <<emphasis>release</emphasis>> is the version of Yocto Project. | 592 | <<emphasis>arch</emphasis>> is a string representing the tuned target architecture: |
593 | |||
594 | i586, x86_64, powerpc, mips, armv7a or armv5te | ||
579 | </literallayout> | 595 | </literallayout> |
580 | 596 | ||
581 | <para> | 597 | <para> |
582 | For example, the following toolchain installer is for a 64-bit development | 598 | For example, the following toolchain installer is for a 64-bit |
583 | host system and a 32-bit target architecture: | 599 | development host system and a i586-tuned target architecture |
600 | based off the SDK for <filename>core-image-sato</filename>: | ||
601 | <literallayout class='monospaced'> | ||
602 | poky-eglibc-x86_64-core-image-sato-i586.sh | ||
603 | </literallayout> | ||
584 | </para> | 604 | </para> |
585 | 605 | ||
586 | <literallayout class='monospaced'> | ||
587 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh | ||
588 | </literallayout> | ||
589 | |||
590 | <para> | 606 | <para> |
591 | Toolchains are self-contained and by default are installed into <filename>/opt/poky</filename>. | 607 | Toolchains are self-contained and by default are installed into |
592 | However, when you run the toolchain installer, you can choose an installation directory. | 608 | <filename>/opt/poky</filename>. |
609 | However, when you run the toolchain installer, you can choose an | ||
610 | installation directory. | ||
593 | </para> | 611 | </para> |
594 | 612 | ||
595 | <para> | 613 | <para> |
@@ -610,7 +628,7 @@ | |||
610 | 628 | ||
611 | <para> | 629 | <para> |
612 | <literallayout class='monospaced'> | 630 | <literallayout class='monospaced'> |
613 | $ ~/Downloads/poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh | 631 | $ ~/Downloads/poky-eglibc-x86_64-core-image-sato-i586.sh |
614 | </literallayout> | 632 | </literallayout> |
615 | </para> | 633 | </para> |
616 | 634 | ||