summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-12-13 12:31:28 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-01-02 13:16:08 +0000
commit5dd83ad7e342e465961e730b30620af578241a21 (patch)
tree99181c7eec76252780b22d82c2da53d7e958ec6f /documentation
parent2c9475edcc5219b912530dbdcbca09ea6f43bcde (diff)
downloadpoky-5dd83ad7e342e465961e730b30620af578241a21.tar.gz
ref-manual: Updated the TCMODE variable description.
(From yocto-docs rev: 96fa2af5161307c839e61d835937812da22f8158) 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/ref-manual/ref-variables.xml48
1 files changed, 34 insertions, 14 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 1f71e7eb39..f43f8e793d 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -6532,25 +6532,45 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6532 <glossentry id='var-TCMODE'><glossterm>TCMODE</glossterm> 6532 <glossentry id='var-TCMODE'><glossterm>TCMODE</glossterm>
6533 <glossdef> 6533 <glossdef>
6534 <para> 6534 <para>
6535 The toolchain selector. 6535 Specifies the toolchain selector.
6536 This variable replaces <filename>POKYMODE</filename>, which is no longer 6536 <filename>TCMODE</filename> controls the characteristics
6537 supported. 6537 of the generated packages and images by telling the
6538 OpenEmbedded build system which toolchain profile to use.
6539 By default, the OpenEmbedded build system builds its own
6540 internal toolchain.
6541 The variable's default value is "default", which uses
6542 that internal toolchain.
6538 </para> 6543 </para>
6544
6539 <para> 6545 <para>
6540 The <filename>TCMODE</filename> variable selects the external toolchain 6546 With additional layers, it is possible to use a pre-compiled
6541 built using the OpenEmbedded build system or a few supported combinations of 6547 external toolchain.
6542 the upstream GCC or CodeSourcery Labs toolchain. 6548 One example is the Sourcery G++ Toolchain.
6543 The variable identifies the <filename>tcmode-*</filename> files used in 6549 The support for this toolchain resides in the separate
6544 the <filename>meta/conf/distro/include</filename> directory, which is found in the 6550 <filename>meta-sourcery</filename> layer at
6545 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. 6551 <ulink url='http://github.com/MentorEmbedded/meta-sourcery/'></ulink>.
6552 You can use <filename>meta-sourcery</filename> as a
6553 template for adding support for other external toolchains.
6554 </para>
6555
6556 <para>
6557 The <filename>TCMODE</filename> variable points the build
6558 system to a file in
6559 <filename>conf/distro/include/tcmode-${TCMODE}.inc</filename>.
6560 Thus, for <filename>meta-sourcery</filename>,
6561 which has <filename>conf/distro/include/tcmode-external-sourcery.inc</filename>,
6562 you would set the variable as follows:
6563 <literallayout class='monospaced'>
6564 TCMODE ?= "external-sourcery"
6565 </literallayout>
6546 </para> 6566 </para>
6567
6547 <para> 6568 <para>
6548 By default, <filename>TCMODE</filename> is set to "default", which
6549 chooses the <filename>tcmode-default.inc</filename> file.
6550 The variable is similar to 6569 The variable is similar to
6551 <link linkend='var-TCLIBC'><filename>TCLIBC</filename></link>, which controls 6570 <link linkend='var-TCLIBC'><filename>TCLIBC</filename></link>,
6552 the variant of the GNU standard C library (<filename>libc</filename>) 6571 which controls the variant of the GNU standard C library
6553 used during the build process: <filename>eglibc</filename> or <filename>uclibc</filename>. 6572 (<filename>libc</filename>) used during the build process:
6573 <filename>eglibc</filename> or <filename>uclibc</filename>.
6554 </para> 6574 </para>
6555 </glossdef> 6575 </glossdef>
6556 </glossentry> 6576 </glossentry>