diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml index e0f4bb5869..82817ead46 100644 --- a/documentation/poky-ref-manual/faq.xml +++ b/documentation/poky-ref-manual/faq.xml @@ -428,6 +428,39 @@ + + + + How do I use an external toolchain? + + + + + The toolchain configuration is very flexible and customizable. + It is primarily controlled with the TCMODE variable. + This variable controls which file to include + (conf/distro/include/tcmode-*.inc). + + + The default value of TCMODE is "default". + However, other patterns are accepted. + In particular, "external-*" refers to external toolchains of which there are some basic examples + included with the core. + A user can use their own custom toolchain definition in their own layer + (or local.conf directory) at the location + conf/distro/include/tcmode-*.inc. + + + 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 + libgcc, libstdcc++, + any locales and libc. + An example is the external-csl-toolchain_2008q3-72.bb, which reuses the core + libc packaging class to do most of the work. + + + +