1
0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00

documentation/poky-ref-manual/faq.xml: Updates to external toolchain

Updated the FAQ entry on "How do I use an external toolchain."
Comments were from Richard Purdie.

(From yocto-docs rev: db3986d2eff17087eb141ac0f4dfed55ff753368)

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
2012-07-13 10:38:29 -07:00
committed by Richard Purdie
parent 7f998daf7e
commit 30f491637c
+9 -7
View File
@@ -477,25 +477,27 @@
<filename><link linkend='var-TCMODE'>TCMODE</link></filename> variable. <filename><link linkend='var-TCMODE'>TCMODE</link></filename> variable.
This variable controls which <filename>tcmode-*.inc</filename> file to include This variable controls which <filename>tcmode-*.inc</filename> file to include
from the <filename>meta/conf/distro/include</filename> directory within the from the <filename>meta/conf/distro/include</filename> directory within the
<ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-files'>Yocto Project Files</ulink>. <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>.
</para> </para>
<para> <para>
The default value of <filename>TCMODE</filename> is "default" The default value of <filename>TCMODE</filename> is "default"
(i.e. <filename>tcmode-default.inc</filename>. (i.e. <filename>tcmode-default.inc</filename>).
However, other patterns are accepted. However, other patterns are accepted.
In particular, "external-*" refers to external toolchains of which there are some In particular, "external-*" refers to external toolchains of which there are some
basic examples included with the core. basic examples included in the OpenEmbedded Core (<filename>meta</filename>).
A user can use their own custom toolchain definition in their own layer You can use your own custom toolchain definition in your own layer
(or as defined in the <filename>local.conf</filename> file) at the location (or as defined in the <filename>local.conf</filename> file) at the location
<filename>conf/distro/include/tcmode-*.inc</filename>. <filename>conf/distro/include/tcmode-*.inc</filename>.
</para> </para>
<para> <para>
In addition to the toolchain configuration, you also need a corresponding toolchain recipe file. In addition to the toolchain configuration, you also need a corresponding toolchain recipe file.
This recipe file needs to package up any pre-built objects in the toolchain such as This recipe file needs to package up any pre-built objects in the toolchain such as
<filename>libgcc</filename>, <filename>libstdcc++</filename>, <filename>libgcc</filename>, <filename>libstdcc++</filename>,
any locales and <filename>libc</filename>. any locales, and <filename>libc</filename>.
An example is the <filename>external-csl-toolchain_2008q3-72.bb</filename>, which reuses the core An example is the <filename>external-sourcery-toolchain.bb</filename>, which is located
<filename>libc</filename> packaging class to do most of the work. in <filename>meta/recipes-core/meta/</filename> within the source directory.
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>