diff options
Diffstat (limited to 'documentation/ref-manual')
-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 26a5aed827..097a5fac5c 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -6971,6 +6971,36 @@ system and gives an overview of their function and contents. | |||
6971 | in the ":ref:`ref-manual/devtool-reference:checking on the upgrade status of a recipe`" | 6971 | in the ":ref:`ref-manual/devtool-reference:checking on the upgrade status of a recipe`" |
6972 | section. | 6972 | section. |
6973 | 6973 | ||
6974 | :term:`RECIPE_SYSROOT` | ||
6975 | This variable points to the directory that holds all files populated from | ||
6976 | recipes specified in :term:`DEPENDS`. As the name indicates, | ||
6977 | think of this variable as a custom root (``/``) for the recipe that will be | ||
6978 | used by the compiler in order to find headers and other files needed to complete | ||
6979 | its job. | ||
6980 | |||
6981 | This variable is related to :term:`STAGING_DIR_HOST` or :term:`STAGING_DIR_TARGET` | ||
6982 | according to the type of the recipe and the build target. | ||
6983 | |||
6984 | To better understand this variable, consider the following examples: | ||
6985 | |||
6986 | - For ``#include <header.h>``, ``header.h`` should be in ``"${RECIPE_SYSROOT}/usr/include"`` | ||
6987 | |||
6988 | - For ``-lexample``, ``libexample.so`` should be in ``"${RECIPE_SYSROOT}/lib"`` | ||
6989 | or other library sysroot directories. | ||
6990 | |||
6991 | The default value is ``"${WORKDIR}/recipe-sysroot"``. | ||
6992 | Do not modify it. | ||
6993 | |||
6994 | :term:`RECIPE_SYSROOT_NATIVE` | ||
6995 | This is similar to :term:`RECIPE_SYSROOT` but the populated files are from | ||
6996 | ``-native`` recipes. This allows a recipe built for the target machine to | ||
6997 | use ``native`` tools. | ||
6998 | |||
6999 | This variable is related to :term:`STAGING_DIR_NATIVE`. | ||
7000 | |||
7001 | The default value is ``"${WORKDIR}/recipe-sysroot-native"``. | ||
7002 | Do not modify it. | ||
7003 | |||
6974 | :term:`REPODIR` | 7004 | :term:`REPODIR` |
6975 | See :term:`bitbake:REPODIR` in the BitBake manual. | 7005 | See :term:`bitbake:REPODIR` in the BitBake manual. |
6976 | 7006 | ||
@@ -8275,10 +8305,15 @@ system and gives an overview of their function and contents. | |||
8275 | for ``-native`` recipes, as they make use of host headers and | 8305 | for ``-native`` recipes, as they make use of host headers and |
8276 | libraries. | 8306 | libraries. |
8277 | 8307 | ||
8308 | Check :term:`RECIPE_SYSROOT` and :term:`RECIPE_SYSROOT_NATIVE`. | ||
8309 | |||
8278 | :term:`STAGING_DIR_NATIVE` | 8310 | :term:`STAGING_DIR_NATIVE` |
8279 | Specifies the path to the sysroot directory used when building | 8311 | Specifies the path to the sysroot directory used when building |
8280 | components that run on the build host itself. | 8312 | components that run on the build host itself. |
8281 | 8313 | ||
8314 | The default value is ``"${RECIPE_SYSROOT_NATIVE}"``, | ||
8315 | check :term:`RECIPE_SYSROOT_NATIVE`. | ||
8316 | |||
8282 | :term:`STAGING_DIR_TARGET` | 8317 | :term:`STAGING_DIR_TARGET` |
8283 | Specifies the path to the sysroot used for the system for which the | 8318 | Specifies the path to the sysroot used for the system for which the |
8284 | component generates code. For components that do not generate code, | 8319 | component generates code. For components that do not generate code, |