diff options
| -rw-r--r-- | documentation/ref-manual/terms.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst index 2b9bccb4a9..2ccfe1c238 100644 --- a/documentation/ref-manual/terms.rst +++ b/documentation/ref-manual/terms.rst | |||
| @@ -483,6 +483,31 @@ universal, the list includes them just in case: | |||
| 483 | and the ":ref:`dev-manual/sbom:creating a software bill of materials`" | 483 | and the ":ref:`dev-manual/sbom:creating a software bill of materials`" |
| 484 | section of the Development Tasks manual. | 484 | section of the Development Tasks manual. |
| 485 | 485 | ||
| 486 | :term:`Sysroot` | ||
| 487 | When cross-compiling, the target file system may be differently laid | ||
| 488 | out and contain different things compared to the host system. The concept | ||
| 489 | of a *sysroot* is directory which looks like the target filesystem and | ||
| 490 | can be used to cross-compile against. | ||
| 491 | |||
| 492 | In the context of cross-compiling toolchains, a *sysroot* | ||
| 493 | typically contains C library and kernel headers, plus the | ||
| 494 | compiled binaries for the C library. A *multilib toolchain* | ||
| 495 | can contain multiple variants of the C library binaries, | ||
| 496 | each compiled for a target instruction set (such as ``armv5``, | ||
| 497 | ``armv7`` and ``armv8``), and possibly optimized for a specific CPU core. | ||
| 498 | |||
| 499 | In the more specific context of the OpenEmbedded build System and | ||
| 500 | of the Yocto Project, each recipe has two sysroots: | ||
| 501 | |||
| 502 | - A *target sysroot* contains all the **target** libraries and headers | ||
| 503 | needed to build the recipe. | ||
| 504 | |||
| 505 | - A *native sysroot* contains all the **host** files and executables | ||
| 506 | needed to build the recipe. | ||
| 507 | |||
| 508 | See the :term:`SYSROOT_* <SYSROOT_DESTDIR>` variables controlling | ||
| 509 | how sysroots are created and stored. | ||
| 510 | |||
| 486 | :term:`Task` | 511 | :term:`Task` |
| 487 | A per-recipe unit of execution for BitBake (e.g. | 512 | A per-recipe unit of execution for BitBake (e.g. |
| 488 | :ref:`ref-tasks-compile`, | 513 | :ref:`ref-tasks-compile`, |
