5e84b8b73c
The new skeleton of the manual as it has been thought:
1. About Buildroot:
Presentation of Buildroot
2. Starting up:
Everything to quickly and easily start working with Buildroot
3. Working with Buildroot
Basics to make your work fitting your needs
4. Troubleshooting
5. Going further in Buildroot's innards
Explaination of how buildroot is organised, how it works, etc
6. Developer Guidelines
7. Getting involved
8. Contibuting to Buildroot
9. Legal notice
10. Appendix
It is easy to distinguish two parts in this plan:
- Sections 1 to 4 mainly address people starting with Buildroot
- Sections 5 to 10 are more focused on how to develop Buildroot itself
Most of the existing sections have just been moved in the hierarchy,
few were split and dispatch in, what i think was the relevant section,
and numerous others have been created.
Signed-off-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
48 lines
1.4 KiB
Plaintext
48 lines
1.4 KiB
Plaintext
// -*- 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+.
|