summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/terms.rst25
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`,