diff options
author | BELHADJ SALEM Talel <bhstalel@gmail.com> | 2023-10-20 10:41:00 +0100 |
---|---|---|
committer | Steve Sakoman <steve@sakoman.com> | 2023-10-25 04:51:01 -1000 |
commit | 90499aafb504c638a13fd59123c7ac7304bd59e8 (patch) | |
tree | 58a81ef89f888e31ab8398039b768ed3ee4f2431 | |
parent | d6701da0f4bd23f33e81f0813d44bb0eb4ca8823 (diff) | |
download | poky-90499aafb504c638a13fd59123c7ac7304bd59e8.tar.gz |
ref-manual: variables: add RECIPE_SYSROOT and RECIPE_SYSROOT_NATIVE
(From yocto-docs rev: acdef1c3728b88f46d94415567fec85438a51ba4)
Signed-off-by: Talel BELHAJSALEM <bhstalel@gmail.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
-rw-r--r-- | documentation/ref-manual/variables.rst | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index abd361bf63..a8752f5ca8 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -6832,6 +6832,36 @@ system and gives an overview of their function and contents. | |||
6832 | in the ":ref:`ref-manual/devtool-reference:checking on the upgrade status of a recipe`" | 6832 | in the ":ref:`ref-manual/devtool-reference:checking on the upgrade status of a recipe`" |
6833 | section. | 6833 | section. |
6834 | 6834 | ||
6835 | :term:`RECIPE_SYSROOT` | ||
6836 | This variable points to the directory that holds all files populated from | ||
6837 | recipes specified in :term:`DEPENDS`. As the name indicates, | ||
6838 | think of this variable as a custom root (``/``) for the recipe that will be | ||
6839 | used by the compiler in order to find headers and other files needed to complete | ||
6840 | its job. | ||
6841 | |||
6842 | This variable is related to :term:`STAGING_DIR_HOST` or :term:`STAGING_DIR_TARGET` | ||
6843 | according to the type of the recipe and the build target. | ||
6844 | |||
6845 | To better understand this variable, consider the following examples: | ||
6846 | |||
6847 | - For ``#include <header.h>``, ``header.h`` should be in ``"${RECIPE_SYSROOT}/usr/include"`` | ||
6848 | |||
6849 | - For ``-lexample``, ``libexample.so`` should be in ``"${RECIPE_SYSROOT}/lib"`` | ||
6850 | or other library sysroot directories. | ||
6851 | |||
6852 | The default value is ``"${WORKDIR}/recipe-sysroot"``. | ||
6853 | Do not modify it. | ||
6854 | |||
6855 | :term:`RECIPE_SYSROOT_NATIVE` | ||
6856 | This is similar to :term:`RECIPE_SYSROOT` but the populated files are from | ||
6857 | ``-native`` recipes. This allows a recipe built for the target machine to | ||
6858 | use ``native`` tools. | ||
6859 | |||
6860 | This variable is related to :term:`STAGING_DIR_NATIVE`. | ||
6861 | |||
6862 | The default value is ``"${WORKDIR}/recipe-sysroot-native"``. | ||
6863 | Do not modify it. | ||
6864 | |||
6835 | :term:`REPODIR` | 6865 | :term:`REPODIR` |
6836 | See :term:`bitbake:REPODIR` in the BitBake manual. | 6866 | See :term:`bitbake:REPODIR` in the BitBake manual. |
6837 | 6867 | ||
@@ -8071,10 +8101,15 @@ system and gives an overview of their function and contents. | |||
8071 | for ``-native`` recipes, as they make use of host headers and | 8101 | for ``-native`` recipes, as they make use of host headers and |
8072 | libraries. | 8102 | libraries. |
8073 | 8103 | ||
8104 | Check :term:`RECIPE_SYSROOT` and :term:`RECIPE_SYSROOT_NATIVE`. | ||
8105 | |||
8074 | :term:`STAGING_DIR_NATIVE` | 8106 | :term:`STAGING_DIR_NATIVE` |
8075 | Specifies the path to the sysroot directory used when building | 8107 | Specifies the path to the sysroot directory used when building |
8076 | components that run on the build host itself. | 8108 | components that run on the build host itself. |
8077 | 8109 | ||
8110 | The default value is ``"${RECIPE_SYSROOT_NATIVE}"``, | ||
8111 | check :term:`RECIPE_SYSROOT_NATIVE`. | ||
8112 | |||
8078 | :term:`STAGING_DIR_TARGET` | 8113 | :term:`STAGING_DIR_TARGET` |
8079 | Specifies the path to the sysroot used for the system for which the | 8114 | Specifies the path to the sysroot used for the system for which the |
8080 | component generates code. For components that do not generate code, | 8115 | component generates code. For components that do not generate code, |