sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

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>
This commit is contained in:
Scott Rifenbark 2013-08-26 11:17:49 +03:00 committed by Richard Purdie
parent 648da6d502
commit e901047d4d
2 changed files with 51 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
documentation/adt-manual/adt-prepare.xml
View File

@ -229,8 +229,10 @@
<title>Using a Cross-Toolchain Tarball</title> <title>Using a Cross-Toolchain Tarball</title>
<para> <para>
If you want to simply install the cross-toolchain by hand, you can If you want to simply install a cross-toolchain by hand, you can
do so by running the toolchain installer. do so by running the toolchain installer.
The installer includes the pre-built cross-toolchain, the
<filename>runqemu</filename> script, and support files.
If you use this method to install the cross-toolchain, you If you use this method to install the cross-toolchain, you
might still need to install the target sysroot by installing and might still need to install the target sysroot by installing and
extracting it separately. extracting it separately.
@ -241,25 +243,30 @@
<para> <para>
Follow these steps: Follow these steps:
<orderedlist> <orderedlist>
<listitem><para>Get the toolchain installer using one of the <listitem><para>Get your toolchain installer using one of the
following methods: following methods:
<itemizedlist> <itemizedlist>
<listitem><para>Go to <listitem><para>Go to
<ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink> <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>
and find the folder that matches your host and find the folder that matches your host
development system (i.e. <filename>i686</filename> development system (i.e. <filename>i686</filename>
for 32-bit machines or <filename>x86-64</filename> for 32-bit machines or <filename>x86_64</filename>
for 64-bit machines).</para> for 64-bit machines).</para>
<para>Go into that folder and download the toolchain <para>Go into that folder and download the toolchain
installer whose name includes the appropriate target installer whose name includes the appropriate target
architecture. architecture.
The toolchains provided by the Yocto Project
are based off of the
<filename>core-image-sato</filename> image and
contain libraries appropriate for developing
against that image.
For example, if your host development system is a For example, if your host development system is a
64-bit x86 system and you are going to use 64-bit x86 system and you are going to use
your cross-toolchain for a 32-bit x86 your cross-toolchain for a 32-bit x86
target, go into the <filename>x86_64</filename> target, go into the <filename>x86_64</filename>
folder and download the following installer: folder and download the following installer:
<literallayout class='monospaced'> <literallayout class='monospaced'>
poky-eglibc-x86_64-i586-toolchain-&DISTRO;.sh poky-eglibc-x86_64-core-image-sato-i586.sh
</literallayout></para></listitem> </literallayout></para></listitem>
<listitem><para>Build your own toolchain installer. <listitem><para>Build your own toolchain installer.
For cases where you cannot use an installer For cases where you cannot use an installer
@ -278,7 +285,7 @@
The example assumes the toolchain installer is located The example assumes the toolchain installer is located
in <filename>~/Downloads/</filename>. in <filename>~/Downloads/</filename>.
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ ~/Downloads/poky-eglibc-x86_64-i586-toolchain-&DISTRO;.sh $ ~/Downloads/poky-eglibc-x86_64-core-image-sato-i586.sh
</literallayout> </literallayout>
<note> <note>
If you do not have write permissions for the directory If you do not have write permissions for the directory

60
documentation/yocto-project-qs/yocto-project-qs.xml
View File

@ -552,44 +552,62 @@
<section id='installing-the-toolchain'> <section id='installing-the-toolchain'>
<title>Installing the Toolchain</title> <title>Installing the Toolchain</title>
<para> <para>
You can download a tarball installer, which includes the pre-built toolchain, the You can download a tarball installer, which includes the
<filename>runqemu</filename> pre-built toolchain, the <filename>runqemu</filename>
script, and support files from the appropriate directory under script, and support files from the appropriate directory under
<ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>. <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>.
Toolchains are available for 32-bit and 64-bit x86 development systems from the Toolchains are available for 32-bit and 64-bit x86 development
<filename>i686</filename> and <filename>x86_64</filename> directories, respectively. systems from the <filename>i686</filename> and
Each type of development system supports five target architectures. <filename>x86_64</filename> directories, respectively.
The names of the tarball installer scripts are such that a string representing the The toolchains the Yocto Project provides are based off the
host system appears first in the filename and then is immediately followed by a <filename>core-image-sato</filename> image and contain
string representing the target architecture. libraries appropriate for developing against that image.
Each type of development system supports five or more target
architectures.
</para>
<para>
The names of the tarball installer scripts are such that a
string representing the host system appears first in the
filename and then is immediately followed by a string
that represents the target architecture.
</para> </para>
<literallayout class='monospaced'> <literallayout class='monospaced'>
poky-eglibc-&lt;<emphasis>host_system</emphasis>&gt;-&lt;<emphasis>arch</emphasis>&gt;-toolchain-gmae-&lt;<emphasis>release</emphasis>&gt;.sh poky-eglibc-&lt;<emphasis>host_system</emphasis>&gt;-&lt;<emphasis>image_type</emphasis>&gt;-&lt;<emphasis>arch</emphasis>&gt;.sh
Where: Where:
&lt;<emphasis>host_system</emphasis>&gt; is a string representing your development system: &lt;<emphasis>host_system</emphasis>&gt; is a string representing your development system:
i686 or x86_64. i686 or x86_64.
&lt;<emphasis>arch</emphasis>&gt; is a string representing the target architecture: &lt;<emphasis>image_type</emphasis>&gt; is a string representing the image you wish to
i586, x86_64, powerpc, mips, or arm. develop a Software Development Toolkit (SDK) for use against.
The Yocto Project builds toolchain installers using the
following BitBake command:
&lt;<emphasis>release</emphasis>&gt; is the version of Yocto Project. bitbake core-image-sato -c do_populatesdk core-image-sato
&lt;<emphasis>arch</emphasis>&gt; is a string representing the tuned target architecture:
i586, x86_64, powerpc, mips, armv7a or armv5te
</literallayout> </literallayout>
<para> <para>
For example, the following toolchain installer is for a 64-bit development For example, the following toolchain installer is for a 64-bit
host system and a 32-bit target architecture: development host system and a i586-tuned target architecture
based off the SDK for <filename>core-image-sato</filename>:
<literallayout class='monospaced'>
poky-eglibc-x86_64-core-image-sato-i586.sh
</literallayout>
</para> </para>
<literallayout class='monospaced'>
poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh
</literallayout>
<para> <para>
Toolchains are self-contained and by default are installed into <filename>/opt/poky</filename>. Toolchains are self-contained and by default are installed into
However, when you run the toolchain installer, you can choose an installation directory. <filename>/opt/poky</filename>.
However, when you run the toolchain installer, you can choose an
installation directory.
</para> </para>
<para> <para>
@ -610,7 +628,7 @@
<para> <para>
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ ~/Downloads/poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh $ ~/Downloads/poky-eglibc-x86_64-core-image-sato-i586.sh
</literallayout> </literallayout>
</para> </para>