diff options
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index d8c88c61df..1528b04065 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | |||
@@ -270,45 +270,6 @@ overview of their function and contents. | |||
270 | ``my-recipe.bb`` is executing, the ``BB_FILENAME`` variable contains | 270 | ``my-recipe.bb`` is executing, the ``BB_FILENAME`` variable contains |
271 | "/foo/path/my-recipe.bb". | 271 | "/foo/path/my-recipe.bb". |
272 | 272 | ||
273 | :term:`BBFILES_DYNAMIC` | ||
274 | Activates content depending on presence of identified layers. You | ||
275 | identify the layers by the collections that the layers define. | ||
276 | |||
277 | Use the ``BBFILES_DYNAMIC`` variable to avoid ``.bbappend`` files whose | ||
278 | corresponding ``.bb`` file is in a layer that attempts to modify other | ||
279 | layers through ``.bbappend`` but does not want to introduce a hard | ||
280 | dependency on those other layers. | ||
281 | |||
282 | Additionally you can prefix the rule with "!" to add ``.bbappend`` and | ||
283 | ``.bb`` files in case a layer is not present. Use this avoid hard | ||
284 | dependency on those other layers. | ||
285 | |||
286 | Use the following form for ``BBFILES_DYNAMIC``: :: | ||
287 | |||
288 | collection_name:filename_pattern | ||
289 | |||
290 | The following example identifies two collection names and two filename | ||
291 | patterns: :: | ||
292 | |||
293 | BBFILES_DYNAMIC += "\ | ||
294 | clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \ | ||
295 | core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \ | ||
296 | " | ||
297 | |||
298 | When the collection name is prefixed with "!" it will add the file pattern in case | ||
299 | the layer is absent: :: | ||
300 | |||
301 | BBFILES_DYNAMIC += "\ | ||
302 | !clang-layer:${LAYERDIR}/backfill/meta-clang/*/*/*.bb \ | ||
303 | " | ||
304 | |||
305 | This next example shows an error message that occurs because invalid | ||
306 | entries are found, which cause parsing to abort: :: | ||
307 | |||
308 | ERROR: BBFILES_DYNAMIC entries must be of the form {!}<collection name>:<filename pattern>, not: | ||
309 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend | ||
310 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend | ||
311 | |||
312 | :term:`BB_GENERATE_MIRROR_TARBALLS` | 273 | :term:`BB_GENERATE_MIRROR_TARBALLS` |
313 | Causes tarballs of the Git repositories, including the Git metadata, | 274 | Causes tarballs of the Git repositories, including the Git metadata, |
314 | to be placed in the :term:`DL_DIR` directory. Anyone | 275 | to be placed in the :term:`DL_DIR` directory. Anyone |
@@ -684,6 +645,45 @@ overview of their function and contents. | |||
684 | For details on the syntax, see the documentation by following the | 645 | For details on the syntax, see the documentation by following the |
685 | previous link. | 646 | previous link. |
686 | 647 | ||
648 | :term:`BBFILES_DYNAMIC` | ||
649 | Activates content depending on presence of identified layers. You | ||
650 | identify the layers by the collections that the layers define. | ||
651 | |||
652 | Use the ``BBFILES_DYNAMIC`` variable to avoid ``.bbappend`` files whose | ||
653 | corresponding ``.bb`` file is in a layer that attempts to modify other | ||
654 | layers through ``.bbappend`` but does not want to introduce a hard | ||
655 | dependency on those other layers. | ||
656 | |||
657 | Additionally you can prefix the rule with "!" to add ``.bbappend`` and | ||
658 | ``.bb`` files in case a layer is not present. Use this avoid hard | ||
659 | dependency on those other layers. | ||
660 | |||
661 | Use the following form for ``BBFILES_DYNAMIC``: :: | ||
662 | |||
663 | collection_name:filename_pattern | ||
664 | |||
665 | The following example identifies two collection names and two filename | ||
666 | patterns: :: | ||
667 | |||
668 | BBFILES_DYNAMIC += "\ | ||
669 | clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \ | ||
670 | core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \ | ||
671 | " | ||
672 | |||
673 | When the collection name is prefixed with "!" it will add the file pattern in case | ||
674 | the layer is absent: :: | ||
675 | |||
676 | BBFILES_DYNAMIC += "\ | ||
677 | !clang-layer:${LAYERDIR}/backfill/meta-clang/*/*/*.bb \ | ||
678 | " | ||
679 | |||
680 | This next example shows an error message that occurs because invalid | ||
681 | entries are found, which cause parsing to abort: :: | ||
682 | |||
683 | ERROR: BBFILES_DYNAMIC entries must be of the form {!}<collection name>:<filename pattern>, not: | ||
684 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend | ||
685 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend | ||
686 | |||
687 | :term:`BBINCLUDED` | 687 | :term:`BBINCLUDED` |
688 | Contains a space-separated list of all of all files that BitBake's | 688 | Contains a space-separated list of all of all files that BitBake's |
689 | parser included during parsing of the current file. | 689 | parser included during parsing of the current file. |