From 0ad26c66e0b926591f5d68095bd4b142f381cd86 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 6 Feb 2013 12:51:39 -0600 Subject: dev-manual: Updates to expose cross-toolchain recipes. Added a bulleted list to the "Terms" section to help define some toolchain recipes such as gcc-cross-initial, gcc-cross-intermediate, and so forth. Added a cross-reference link to the term "Cross-Development Toolchain" in the the "Working Using Stand-alone Cross-development Toolchains" section. This gives the reader a way to see more on the toolchain recipes. (From yocto-docs rev: 2cb612424c0cf6addfd8bce8a0ef77665c35bd9a) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-newbie.xml | 58 ++++++++++++++++++++++---- 1 file changed, 51 insertions(+), 7 deletions(-) (limited to 'documentation/dev-manual/dev-manual-newbie.xml') diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 169f3072ef..7c21379b99 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml @@ -311,17 +311,61 @@ variables for the Texas Instruments ARM Cortex-A8 development board). Configuration files end with a .conf filename extension. - Cross-Development Toolchain: + + Cross-Development Toolchain: A collection of software development - tools and utilities that allow you to develop software for targeted architectures. - This toolchain contains cross-compilers, linkers, and debuggers that are specific to - an architecture. - You can use the OpenEmbedded build system to build a cross-development toolchain - installer that when run installs the toolchain that contains the development tools you + tools and utilities that allow you to develop software for + targeted architectures. + This toolchain contains cross-compilers, linkers, and debuggers + that are specific to an architecture. + You can use the OpenEmbedded build system to build a + cross-development toolchain installer that, when run, installs + the toolchain that contains the development tools you need to cross-compile and test your software. The Yocto Project ships with images that contain installers for toolchains for supported architectures as well. - Sometimes this toolchain is referred to as the meta-toolchain. + Sometimes this toolchain is referred to as the + meta-toolchain. + Following is a list of toolchain recipes with brief + descriptions of each: + + gcc-cross-initial: + The initial compiler needed to bootstrap the toolchain + that runs on the host and is used to build software + for the target. + This tool is a 'native' package. + gcc-cross-intermediate: + The second stage of the bootstrap process that runs + on the host and builds software for the target. + This tool is a 'native' package. + gcc-cross: + The the final stage of the bootstrap process that + results in the cross compiler that runs on the host + and builds software for the target. + If you are replacing the cross compiler toolchain + with a custom version, this is what you must replace. + This tool is a 'native' package. + gcc-runtime: + Runtime libraries from the toolchain bootstrapping + process. + This tool produces a binary for the target. + + gcc-crosssdk-initial/intermediate: + Stage 1 and 2 of the a cross compiler that runs on the + host and builds for the SDK. + Often the SDK is not the same target as the host. + This tool is a 'native' binary. + gcc-crosssdk: + The final stage of the SDK compiler. + This tool is a 'native' binary. + The tool runs on the host and builds for the SDK. + + gcc-cross-canadian: + The compiler that runs on the SDK machine and is + included with the SDK that builds software for the + target. + This tool is a 'nativesdk' package. + Image: An image is the result produced when BitBake processes a given collection of recipes and related metadata. Images are the binary output that run on specific hardware or QEMU -- cgit v1.2.3-54-g00ecf