diff options
| author | Samuel MARTIN | 2012-02-08 23:20:54 +0100 |
|---|---|---|
| committer | Peter Korsgaard | 2012-02-09 23:23:42 +0100 |
| commit | 2c4de62b14cf5c661ea6f999a031e9a4f115782e (patch) | |
| tree | c920b2a85987f91527fef3118fbeb48b1372c284 /docs | |
| parent | dependencies: build a host-tar if no suitable tar can be found (diff) | |
| download | buildroot-2c4de62b14cf5c661ea6f999a031e9a4f115782e.tar.gz buildroot-2c4de62b14cf5c661ea6f999a031e9a4f115782e.tar.xz buildroot-2c4de62b14cf5c661ea6f999a031e9a4f115782e.zip | |
docs: Add customizing toolchain section
Signed-off-by: Samuel MARTIN <s.martin49@gmail.com>
Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be>
Acked-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/manual/customize-toolchain.txt | 45 | ||||
| -rw-r--r-- | docs/manual/customize.txt | 2 | ||||
| -rw-r--r-- | docs/manual/external-toolchain.txt | 1 |
3 files changed, 48 insertions, 0 deletions
diff --git a/docs/manual/customize-toolchain.txt b/docs/manual/customize-toolchain.txt new file mode 100644 index 000000000..a54e2e220 --- /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 c9f4dfd41..e8235dee8 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 20eebdb20..62eb0a386 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: |