NetCube-Systems-Austria/kumquat-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add customizing toolchain section

Browse Source 
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>
This commit is contained in:
Samuel MARTIN 2012-02-08 23:20:54 +01:00 committed by Peter Korsgaard
parent fd10b42ab8
commit 2c4de62b14
3 changed files with 48 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
docs/manual/customize-toolchain.txt Normal file
View File

@ -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+.

2
docs/manual/customize.txt
View File

@ -8,3 +8,5 @@ include::customize-busybox-config.txt[]
include::customize-uclibc-config.txt[]
include::customize-kernel-config.txt[]
include::customize-toolchain.txt[]

1
docs/manual/external-toolchain.txt
View File

@ -1,5 +1,6 @@
Using an external toolchain
===========================
[[external-toolchain]]
Using an already existing toolchain is useful for different
reasons: