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 cba514c345..512032a67e 100644 --- a/documentation/ref-manual/terms.rst +++ b/documentation/ref-manual/terms.rst | |||
| @@ -383,6 +383,31 @@ universal, the list includes them just in case: | |||
| 383 | ":ref:`overview-manual/development-environment:repositories, tags, and branches`" | 383 | ":ref:`overview-manual/development-environment:repositories, tags, and branches`" |
| 384 | section in the Yocto Project Overview and Concepts Manual. | 384 | section in the Yocto Project Overview and Concepts Manual. |
| 385 | 385 | ||
| 386 | :term:`Sysroot` | ||
| 387 | When cross-compiling, the target file system may be differently laid | ||
| 388 | out and contain different things compared to the host system. The concept | ||
| 389 | of a *sysroot* is directory which looks like the target filesystem and | ||
| 390 | can be used to cross-compile against. | ||
| 391 | |||
| 392 | In the context of cross-compiling toolchains, a *sysroot* | ||
| 393 | typically contains C library and kernel headers, plus the | ||
| 394 | compiled binaries for the C library. A *multilib toolchain* | ||
| 395 | can contain multiple variants of the C library binaries, | ||
| 396 | each compiled for a target instruction set (such as ``armv5``, | ||
| 397 | ``armv7`` and ``armv8``), and possibly optimized for a specific CPU core. | ||
| 398 | |||
| 399 | In the more specific context of the OpenEmbedded build System and | ||
| 400 | of the Yocto Project, each recipe has two sysroots: | ||
| 401 | |||
| 402 | - A *target sysroot* contains all the **target** libraries and headers | ||
| 403 | needed to build the recipe. | ||
| 404 | |||
| 405 | - A *native sysroot* contains all the **host** files and executables | ||
| 406 | needed to build the recipe. | ||
| 407 | |||
| 408 | See the :term:`SYSROOT_* <SYSROOT_DESTDIR>` variables controlling | ||
| 409 | how sysroots are created and stored. | ||
| 410 | |||
| 386 | :term:`Task` | 411 | :term:`Task` |
| 387 | A per-recipe unit of execution for BitBake (e.g. | 412 | A per-recipe unit of execution for BitBake (e.g. |
| 388 | :ref:`ref-tasks-compile`, | 413 | :ref:`ref-tasks-compile`, |
