summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual
diff options
context:
space:
mode:
authorRichard Purdie <richard.purdie@linuxfoundation.org>2020-11-06 15:50:24 +0000
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-11-12 13:04:10 +0000
commita8ec1f72ba29926a34ce07a847ce1e7c17c2ef5f (patch)
tree3628c729782271a10e8fefd7a0c0abf2cca058d5 /documentation/overview-manual
parente949e76d0f6897ec5d4feaa47afd2b049b32707f (diff)
downloadpoky-a8ec1f72ba29926a34ce07a847ce1e7c17c2ef5f.tar.gz
overview-manual-concepts: Fix the compiler bootstrap process
gcc-cross-initial and glibc-inital were removed a while ago and this flow is incorrect anyway. Fix it to match what happens (adding libgcc and libgcc-initial which are now important in this context). (From yocto-docs rev: 047bff2b79c7742abc19d549b78c175dd3b5a8f5) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r--documentation/overview-manual/overview-manual-concepts.rst34
1 files changed, 12 insertions, 22 deletions
diff --git a/documentation/overview-manual/overview-manual-concepts.rst b/documentation/overview-manual/overview-manual-concepts.rst
index d9f50e5194..736fd9591e 100644
--- a/documentation/overview-manual/overview-manual-concepts.rst
+++ b/documentation/overview-manual/overview-manual-concepts.rst
@@ -1515,27 +1515,24 @@ cross-compiler that is used internally within BitBake only.
1515 gcc-cross 1515 gcc-cross
1516 . 1516 .
1517 1517
1518The chain of events that occurs when ``gcc-cross`` is bootstrapped is as 1518The chain of events that occurs when the standard toolchain is bootstrapped:
1519follows:
1520:: 1519::
1521 1520
1522 gcc -> binutils-cross -> gcc-cross-initial -> linux-libc-headers -> glibc-initial -> glibc -> gcc-cross -> gcc-runtime 1521 binutils-cross -> linux-libc-headers -> gcc-cross -> libgcc-initial -> glibc -> libgcc -> gcc-runtime
1523 1522
1524- ``gcc``: The build host's GNU Compiler Collection (GCC). 1523- ``gcc``: The compiler, GNU Compiler Collection (GCC).
1525 1524
1526- ``binutils-cross``: The bare minimum binary utilities needed in order 1525- ``binutils-cross``: The binary utilities needed in order
1527 to run the ``gcc-cross-initial`` phase of the bootstrap operation. 1526 to run the ``gcc-cross`` phase of the bootstrap operation and build the
1527 headers for the C library.
1528 1528
1529- ``gcc-cross-initial``: An early stage of the bootstrap process for 1529- ``linux-libc-headers``: Headers needed for the cross-compiler and C library build.
1530 creating the cross-compiler. This stage builds enough of the
1531 ``gcc-cross``, the C library, and other pieces needed to finish
1532 building the final cross-compiler in later stages. This tool is a
1533 "native" package (i.e. it is designed to run on the build host).
1534 1530
1535- ``linux-libc-headers``: Headers needed for the cross-compiler. 1531- ``libgcc-initial``: An initial version of the gcc support library needed
1532 to bootstrap ``glibc``.
1536 1533
1537- ``glibc-initial``: An initial version of the Embedded GNU C Library 1534- ``libgcc``: The final version of the gcc support library which
1538 (GLIBC) needed to bootstrap ``glibc``. 1535 can only be built once there is a C library to link against.
1539 1536
1540- ``glibc``: The GNU C Library. 1537- ``glibc``: The GNU C Library.
1541 1538
@@ -1543,14 +1540,7 @@ follows:
1543 cross-compiler. This stage results in the actual cross-compiler that 1540 cross-compiler. This stage results in the actual cross-compiler that
1544 BitBake uses when it builds an image for a targeted device. 1541 BitBake uses when it builds an image for a targeted device.
1545 1542
1546 .. note:: 1543 This tool is a "native" tool (i.e. it is designed to run on
1547
1548 If you are replacing this cross compiler toolchain with a custom
1549 version, you must replace
1550 gcc-cross
1551 .
1552
1553 This tool is also a "native" package (i.e. it is designed to run on
1554 the build host). 1544 the build host).
1555 1545
1556- ``gcc-runtime``: Runtime libraries resulting from the toolchain 1546- ``gcc-runtime``: Runtime libraries resulting from the toolchain