diff options
Diffstat (limited to 'documentation/poky-ref-manual/ref-variables.xml')
-rw-r--r-- | documentation/poky-ref-manual/ref-variables.xml | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 282d9f3090..4e7f85c37d 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml | |||
@@ -2012,6 +2012,38 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
2012 | </glossdef> | 2012 | </glossdef> |
2013 | </glossentry> | 2013 | </glossentry> |
2014 | 2014 | ||
2015 | <glossentry id='var-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC</glossterm> | ||
2016 | <glossdef> | ||
2017 | <para> | ||
2018 | A promise that your recipe satisfies runtime dependencies | ||
2019 | for optional modules that are found in other recipes. | ||
2020 | <filename>PACKAGES_DYNAMIC</filename> | ||
2021 | does not actually satisfy the dependencies, it only states that | ||
2022 | they should be satisfied. | ||
2023 | For example, if a hard, runtime dependency | ||
2024 | (<filename>RDEPENDS</filename>) of another package is satisfied | ||
2025 | at build time through the <filename>PACKAGES_DYNAMIC</filename> | ||
2026 | variable, but a package with the module name is never actually | ||
2027 | produced, then the other package will be broken. | ||
2028 | Thus, if you attempt to include that package in an image, | ||
2029 | you will get a dependency failure from the packaging system | ||
2030 | during <filename>do_rootfs</filename>. | ||
2031 | Typically, if there is a chance that such a situation can | ||
2032 | occur and the package that is not created is valid | ||
2033 | without the dependency being satisfied, then you should use | ||
2034 | <filename>RRECOMMENDS</filename> (a soft runtime dependency) | ||
2035 | instead of <filename>RDEPENDS</filename>. | ||
2036 | </para> | ||
2037 | |||
2038 | <para> | ||
2039 | For an example of how to use the <filename>PACKAGES_DYNAMIC</filename> | ||
2040 | variable when you are splitting packages, see the | ||
2041 | "<ulink url='&YOCTO_DOCS_DEV_URL;#handling-optional-module-packaging'>Handling Optional Module Packaging</ulink>" section | ||
2042 | in the Yocto Project Development Manual. | ||
2043 | </para> | ||
2044 | </glossdef> | ||
2045 | </glossentry> | ||
2046 | |||
2015 | <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm> | 2047 | <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm> |
2016 | <glossdef> | 2048 | <glossdef> |
2017 | <para>Specifies extra options that are passed to the <filename>make</filename> command during the | 2049 | <para>Specifies extra options that are passed to the <filename>make</filename> command during the |