diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2023-02-08 18:44:44 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2023-02-15 10:26:49 +0000 |
commit | 1b1ca97a25c2c40ce5440e66da5a1d88750d291a (patch) | |
tree | d311d30df977eaa7939767e64605b9b38af767ce /documentation | |
parent | 86e9630511321530ba6f19ebedbaebad1a89a89f (diff) | |
download | poky-1b1ca97a25c2c40ce5440e66da5a1d88750d291a.tar.gz |
ref-manual: document SSTATE_EXCLUDEDEPS_SYSROOT
Backport from master:
https://git.yoctoproject.org/yocto-docs/commit/?id=b6690011c14ce4bf30571f045152a9d324ad5039
(From yocto-docs rev: 0b0509d14742ad1cd050a79164718e6e17020c65)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/variables.rst | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 061b1c28d8..968e8d6e05 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -7335,6 +7335,32 @@ system and gives an overview of their function and contents. | |||
7335 | :term:`SSTATE_DIR` | 7335 | :term:`SSTATE_DIR` |
7336 | The directory for the shared state cache. | 7336 | The directory for the shared state cache. |
7337 | 7337 | ||
7338 | :term:`SSTATE_EXCLUDEDEPS_SYSROOT` | ||
7339 | This variable allows to specify indirect dependencies to exclude | ||
7340 | from sysroots, for example to avoid the situations when a dependency on | ||
7341 | any ``-native`` recipe will pull in all dependencies of that recipe | ||
7342 | in the recipe sysroot. This behaviour might not always be wanted, | ||
7343 | for example when that ``-native`` recipe depends on build tools | ||
7344 | that are not relevant for the current recipe. | ||
7345 | |||
7346 | This way, irrelevant dependencies are ignored, which could have | ||
7347 | prevented the reuse of prebuilt artifacts stored in the Shared | ||
7348 | State Cache. | ||
7349 | |||
7350 | :term:`SSTATE_EXCLUDEDEPS_SYSROOT` is evaluated as two regular | ||
7351 | expressions of recipe and dependency to ignore. An example | ||
7352 | is the rule in :oe_git:`meta/conf/layer.conf </openembedded-core/tree/meta/conf/layer.conf>`:: | ||
7353 | |||
7354 | # Nothing needs to depend on libc-initial | ||
7355 | # base-passwd/shadow-sysroot don't need their dependencies | ||
7356 | SSTATE_EXCLUDEDEPS_SYSROOT += "\ | ||
7357 | .*->.*-initial.* \ | ||
7358 | .*(base-passwd|shadow-sysroot)->.* \ | ||
7359 | " | ||
7360 | |||
7361 | The ``->`` substring represents the dependency between | ||
7362 | the two regular expressions. | ||
7363 | |||
7338 | :term:`SSTATE_MIRROR_ALLOW_NETWORK` | 7364 | :term:`SSTATE_MIRROR_ALLOW_NETWORK` |
7339 | If set to "1", allows fetches from mirrors that are specified in | 7365 | If set to "1", allows fetches from mirrors that are specified in |
7340 | :term:`SSTATE_MIRRORS` to work even when | 7366 | :term:`SSTATE_MIRRORS` to work even when |