summaryrefslogtreecommitdiffstats
path: root/docs/manual/customize-toolchain.txt
blob: 91657cf679e44ccb9d06e9d483e67c446de8a3db (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// -*- mode:doc -*- ;

[[toolchain-custom]]
Customizing the toolchain
~~~~~~~~~~~~~~~~~~~~~~~~~

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