diff options
author | Richard Purdie <richard.purdie@linuxfoundation.org> | 2020-11-06 15:50:24 +0000 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2020-11-12 13:04:10 +0000 |
commit | a8ec1f72ba29926a34ce07a847ce1e7c17c2ef5f (patch) | |
tree | 3628c729782271a10e8fefd7a0c0abf2cca058d5 /documentation | |
parent | e949e76d0f6897ec5d4feaa47afd2b049b32707f (diff) | |
download | poky-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')
-rw-r--r-- | documentation/overview-manual/overview-manual-concepts.rst | 34 |
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 | ||
1518 | The chain of events that occurs when ``gcc-cross`` is bootstrapped is as | 1518 | The chain of events that occurs when the standard toolchain is bootstrapped: |
1519 | follows: | ||
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 |