From 2c4de62b14cf5c661ea6f999a031e9a4f115782e Mon Sep 17 00:00:00 2001 From: Samuel MARTIN Date: Wed, 8 Feb 2012 23:20:54 +0100 Subject: [PATCH] docs: Add customizing toolchain section Signed-off-by: Samuel MARTIN Acked-by: Arnout Vandecappelle (Essensium/Mind) Acked-by: Thomas De Schampheleire Signed-off-by: Peter Korsgaard --- docs/manual/customize-toolchain.txt | 45 +++++++++++++++++++++++++++++ docs/manual/customize.txt | 2 ++ docs/manual/external-toolchain.txt | 1 + 3 files changed, 48 insertions(+) create mode 100644 docs/manual/customize-toolchain.txt diff --git a/docs/manual/customize-toolchain.txt b/docs/manual/customize-toolchain.txt new file mode 100644 index 0000000000..a54e2e2202 --- /dev/null +++ b/docs/manual/customize-toolchain.txt @@ -0,0 +1,45 @@ +Customizing the toolchain +------------------------- +[[toolchain-custom]] + +There are three distinct types of toolchain backend supported in Buildroot, +available under the menu +Toolchain+, invoking +make menuconfig+. + +Using the external toolchain backend +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There is no way of tuning an external toolchain since Buildroot does not +generate it. + +It also requires to set the Buildroot settings according to the toolchain ones +(see xref:external-toolchain[]). + +Using the internal Buildroot toolchain backend +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The internal Buildroot toolchain backend *only* allows to generate +*http://www.uclibc.org/[uClibc]-based toolchains*. + +However, it allows to tune major settings, such as: + +* Linux header version + +* http://www.uclibc.org/[uClibc] configuration (see xref:uclibc-custom[uClibc]) + +* Binutils, GCC, Gdb and toolchain options + +This is directly avaiblable after selecting the +Buildroot toolchain+ type in +the menu +Toolchain+. + +Using the Crosstool-NG backend +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The http://crosstool-ng.org[crosstool-NG] toolchain backend enables a rather +limited set of settings under the Buildroot +Toolchain+ menu (ie. when invoking ++make menuconfig+); mostly: + +* The http://crosstool-ng.org[crosstool-NG] configuration file + +* Gdb and some toolchain options + +Then, the toolchain can be finely tuned invoking +make ctng-menuconfig+. diff --git a/docs/manual/customize.txt b/docs/manual/customize.txt index c9f4dfd41a..e8235dee86 100644 --- a/docs/manual/customize.txt +++ b/docs/manual/customize.txt @@ -8,3 +8,5 @@ include::customize-busybox-config.txt[] include::customize-uclibc-config.txt[] include::customize-kernel-config.txt[] + +include::customize-toolchain.txt[] diff --git a/docs/manual/external-toolchain.txt b/docs/manual/external-toolchain.txt index 20eebdb202..62eb0a386f 100644 --- a/docs/manual/external-toolchain.txt +++ b/docs/manual/external-toolchain.txt @@ -1,5 +1,6 @@ Using an external toolchain =========================== +[[external-toolchain]] Using an already existing toolchain is useful for different reasons: -- 2.30.2