diff options
Diffstat (limited to 'documentation/ref-manual/ref-variables.rst')
-rw-r--r-- | documentation/ref-manual/ref-variables.rst | 104 |
1 files changed, 52 insertions, 52 deletions
diff --git a/documentation/ref-manual/ref-variables.rst b/documentation/ref-manual/ref-variables.rst index 8411989b69..65f64b91a5 100644 --- a/documentation/ref-manual/ref-variables.rst +++ b/documentation/ref-manual/ref-variables.rst | |||
@@ -239,7 +239,7 @@ system and gives an overview of their function and contents. | |||
239 | so that it does contain ``${SRCPV}``. | 239 | so that it does contain ``${SRCPV}``. |
240 | 240 | ||
241 | For more information see the | 241 | For more information see the |
242 | ":ref:`dev-manual/dev-manual-common-tasks:automatically incrementing a package version number`" | 242 | ":ref:`dev-manual/common-tasks:automatically incrementing a package version number`" |
243 | section in the Yocto Project Development Tasks Manual. | 243 | section in the Yocto Project Development Tasks Manual. |
244 | 244 | ||
245 | :term:`AVAILABLE_LICENSES` | 245 | :term:`AVAILABLE_LICENSES` |
@@ -261,7 +261,7 @@ system and gives an overview of their function and contents. | |||
261 | The list simply presents the tunes that are available. Not all tunes | 261 | The list simply presents the tunes that are available. Not all tunes |
262 | may be compatible with a particular machine configuration, or with | 262 | may be compatible with a particular machine configuration, or with |
263 | each other in a | 263 | each other in a |
264 | :ref:`Multilib <dev-manual/dev-manual-common-tasks:combining multiple versions of library files into one image>` | 264 | :ref:`Multilib <dev-manual/common-tasks:combining multiple versions of library files into one image>` |
265 | configuration. | 265 | configuration. |
266 | 266 | ||
267 | To add a tune to the list, be sure to append it with spaces using the | 267 | To add a tune to the list, be sure to append it with spaces using the |
@@ -317,7 +317,7 @@ system and gives an overview of their function and contents. | |||
317 | :term:`BASE_LIB` | 317 | :term:`BASE_LIB` |
318 | The library directory name for the CPU or Application Binary | 318 | The library directory name for the CPU or Application Binary |
319 | Interface (ABI) tune. The ``BASE_LIB`` applies only in the Multilib | 319 | Interface (ABI) tune. The ``BASE_LIB`` applies only in the Multilib |
320 | context. See the ":ref:`dev-manual/dev-manual-common-tasks:combining multiple versions of library files into one image`" | 320 | context. See the ":ref:`dev-manual/common-tasks:combining multiple versions of library files into one image`" |
321 | section in the Yocto Project Development Tasks Manual for information | 321 | section in the Yocto Project Development Tasks Manual for information |
322 | on Multilib. | 322 | on Multilib. |
323 | 323 | ||
@@ -545,7 +545,7 @@ system and gives an overview of their function and contents. | |||
545 | is not set higher than "20". | 545 | is not set higher than "20". |
546 | 546 | ||
547 | For more information on speeding up builds, see the | 547 | For more information on speeding up builds, see the |
548 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" | 548 | ":ref:`dev-manual/common-tasks:speeding up a build`" |
549 | section in the Yocto Project Development Tasks Manual. | 549 | section in the Yocto Project Development Tasks Manual. |
550 | 550 | ||
551 | :term:`BB_SERVER_TIMEOUT` | 551 | :term:`BB_SERVER_TIMEOUT` |
@@ -746,7 +746,7 @@ system and gives an overview of their function and contents. | |||
746 | 746 | ||
747 | For information on how to use ``BBMULTICONFIG`` in an environment | 747 | For information on how to use ``BBMULTICONFIG`` in an environment |
748 | that supports building targets with multiple configurations, see the | 748 | that supports building targets with multiple configurations, see the |
749 | ":ref:`dev-manual/dev-manual-common-tasks:building images for multiple targets using multiple configurations`" | 749 | ":ref:`dev-manual/common-tasks:building images for multiple targets using multiple configurations`" |
750 | section in the Yocto Project Development Tasks Manual. | 750 | section in the Yocto Project Development Tasks Manual. |
751 | 751 | ||
752 | :term:`BBPATH` | 752 | :term:`BBPATH` |
@@ -1002,7 +1002,7 @@ system and gives an overview of their function and contents. | |||
1002 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 1002 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
1003 | class, this variable specifies the build history features to be | 1003 | class, this variable specifies the build history features to be |
1004 | enabled. For more information on how build history works, see the | 1004 | enabled. For more information on how build history works, see the |
1005 | ":ref:`dev-manual/dev-manual-common-tasks:maintaining build output quality`" | 1005 | ":ref:`dev-manual/common-tasks:maintaining build output quality`" |
1006 | section in the Yocto Project Development Tasks Manual. | 1006 | section in the Yocto Project Development Tasks Manual. |
1007 | 1007 | ||
1008 | You can specify these features in the form of a space-separated list: | 1008 | You can specify these features in the form of a space-separated list: |
@@ -1299,7 +1299,7 @@ system and gives an overview of their function and contents. | |||
1299 | will be the aggregate of all of them. | 1299 | will be the aggregate of all of them. |
1300 | 1300 | ||
1301 | For information on creating an initramfs, see the | 1301 | For information on creating an initramfs, see the |
1302 | ":ref:`dev-manual/dev-manual-common-tasks:building an initial ram filesystem (initramfs) image`" section | 1302 | ":ref:`dev-manual/common-tasks:building an initial ram filesystem (initramfs) image`" section |
1303 | in the Yocto Project Development Tasks Manual. | 1303 | in the Yocto Project Development Tasks Manual. |
1304 | 1304 | ||
1305 | :term:`CONFIG_SITE` | 1305 | :term:`CONFIG_SITE` |
@@ -1402,7 +1402,7 @@ system and gives an overview of their function and contents. | |||
1402 | newly installed packages to an image, which might be most suitable for | 1402 | newly installed packages to an image, which might be most suitable for |
1403 | read-only filesystems that cannot be upgraded. See the | 1403 | read-only filesystems that cannot be upgraded. See the |
1404 | :term:`LICENSE_CREATE_PACKAGE` variable for additional information. | 1404 | :term:`LICENSE_CREATE_PACKAGE` variable for additional information. |
1405 | You can also reference the ":ref:`dev-manual/dev-manual-common-tasks:providing license text`" | 1405 | You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" |
1406 | section in the Yocto Project Development Tasks Manual for | 1406 | section in the Yocto Project Development Tasks Manual for |
1407 | information on providing license text. | 1407 | information on providing license text. |
1408 | 1408 | ||
@@ -1418,7 +1418,7 @@ system and gives an overview of their function and contents. | |||
1418 | newly installed packages to an image, which might be most suitable for | 1418 | newly installed packages to an image, which might be most suitable for |
1419 | read-only filesystems that cannot be upgraded. See the | 1419 | read-only filesystems that cannot be upgraded. See the |
1420 | :term:`LICENSE_CREATE_PACKAGE` variable for additional information. | 1420 | :term:`LICENSE_CREATE_PACKAGE` variable for additional information. |
1421 | You can also reference the ":ref:`dev-manual/dev-manual-common-tasks:providing license text`" | 1421 | You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" |
1422 | section in the Yocto Project Development Tasks Manual for | 1422 | section in the Yocto Project Development Tasks Manual for |
1423 | information on providing license text. | 1423 | information on providing license text. |
1424 | 1424 | ||
@@ -2029,7 +2029,7 @@ system and gives an overview of their function and contents. | |||
2029 | When used with the :ref:`report-error <ref-classes-report-error>` | 2029 | When used with the :ref:`report-error <ref-classes-report-error>` |
2030 | class, specifies the path used for storing the debug files created by | 2030 | class, specifies the path used for storing the debug files created by |
2031 | the :ref:`error reporting | 2031 | the :ref:`error reporting |
2032 | tool <dev-manual/dev-manual-common-tasks:using the error reporting tool>`, which | 2032 | tool <dev-manual/common-tasks:using the error reporting tool>`, which |
2033 | allows you to submit build errors you encounter to a central | 2033 | allows you to submit build errors you encounter to a central |
2034 | database. By default, the value of this variable is | 2034 | database. By default, the value of this variable is |
2035 | ``${``\ :term:`LOG_DIR`\ ``}/error-report``. | 2035 | ``${``\ :term:`LOG_DIR`\ ``}/error-report``. |
@@ -2129,7 +2129,7 @@ system and gives an overview of their function and contents. | |||
2129 | For more information on ``externalsrc.bbclass``, see the | 2129 | For more information on ``externalsrc.bbclass``, see the |
2130 | ":ref:`externalsrc.bbclass <ref-classes-externalsrc>`" section. You | 2130 | ":ref:`externalsrc.bbclass <ref-classes-externalsrc>`" section. You |
2131 | can also find information on how to use this variable in the | 2131 | can also find information on how to use this variable in the |
2132 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" | 2132 | ":ref:`dev-manual/common-tasks:building software from an external source`" |
2133 | section in the Yocto Project Development Tasks Manual. | 2133 | section in the Yocto Project Development Tasks Manual. |
2134 | 2134 | ||
2135 | :term:`EXTERNALSRC_BUILD` | 2135 | :term:`EXTERNALSRC_BUILD` |
@@ -2143,7 +2143,7 @@ system and gives an overview of their function and contents. | |||
2143 | For more information on ``externalsrc.bbclass``, see the | 2143 | For more information on ``externalsrc.bbclass``, see the |
2144 | ":ref:`externalsrc.bbclass <ref-classes-externalsrc>`" section. You | 2144 | ":ref:`externalsrc.bbclass <ref-classes-externalsrc>`" section. You |
2145 | can also find information on how to use this variable in the | 2145 | can also find information on how to use this variable in the |
2146 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" | 2146 | ":ref:`dev-manual/common-tasks:building software from an external source`" |
2147 | section in the Yocto Project Development Tasks Manual. | 2147 | section in the Yocto Project Development Tasks Manual. |
2148 | 2148 | ||
2149 | :term:`EXTRA_AUTORECONF` | 2149 | :term:`EXTRA_AUTORECONF` |
@@ -2181,7 +2181,7 @@ system and gives an overview of their function and contents. | |||
2181 | useful if you want to develop against the libraries in the image. | 2181 | useful if you want to develop against the libraries in the image. |
2182 | - "read-only-rootfs" - Creates an image whose root filesystem is | 2182 | - "read-only-rootfs" - Creates an image whose root filesystem is |
2183 | read-only. See the | 2183 | read-only. See the |
2184 | ":ref:`dev-manual/dev-manual-common-tasks:creating a read-only root filesystem`" | 2184 | ":ref:`dev-manual/common-tasks:creating a read-only root filesystem`" |
2185 | section in the Yocto Project Development Tasks Manual for more | 2185 | section in the Yocto Project Development Tasks Manual for more |
2186 | information | 2186 | information |
2187 | - "tools-debug" - Adds debugging tools such as gdb and strace. | 2187 | - "tools-debug" - Adds debugging tools such as gdb and strace. |
@@ -2194,7 +2194,7 @@ system and gives an overview of their function and contents. | |||
2194 | Project, see the ":ref:`ref-features-image`" section. | 2194 | Project, see the ":ref:`ref-features-image`" section. |
2195 | 2195 | ||
2196 | For an example that shows how to customize your image by using this | 2196 | For an example that shows how to customize your image by using this |
2197 | variable, see the ":ref:`dev-manual/dev-manual-common-tasks:customizing images using custom \`\`image_features\`\` and \`\`extra_image_features\`\``" | 2197 | variable, see the ":ref:`dev-manual/common-tasks:customizing images using custom \`\`image_features\`\` and \`\`extra_image_features\`\``" |
2198 | section in the Yocto Project Development Tasks Manual. | 2198 | section in the Yocto Project Development Tasks Manual. |
2199 | 2199 | ||
2200 | :term:`EXTRA_IMAGECMD` | 2200 | :term:`EXTRA_IMAGECMD` |
@@ -2511,7 +2511,7 @@ system and gives an overview of their function and contents. | |||
2511 | You can find out more about the patching process in the | 2511 | You can find out more about the patching process in the |
2512 | ":ref:`overview-manual/overview-manual-concepts:patching`" section | 2512 | ":ref:`overview-manual/overview-manual-concepts:patching`" section |
2513 | in the Yocto Project Overview and Concepts Manual and the | 2513 | in the Yocto Project Overview and Concepts Manual and the |
2514 | ":ref:`dev-manual/dev-manual-common-tasks:patching code`" section in | 2514 | ":ref:`dev-manual/common-tasks:patching code`" section in |
2515 | the Yocto Project Development Tasks Manual. See the | 2515 | the Yocto Project Development Tasks Manual. See the |
2516 | :ref:`ref-tasks-patch` task as well. | 2516 | :ref:`ref-tasks-patch` task as well. |
2517 | 2517 | ||
@@ -2904,7 +2904,7 @@ system and gives an overview of their function and contents. | |||
2904 | the same files into a ``boot`` directory within the target partition. | 2904 | the same files into a ``boot`` directory within the target partition. |
2905 | 2905 | ||
2906 | You can find information on how to use the Wic tool in the | 2906 | You can find information on how to use the Wic tool in the |
2907 | ":ref:`dev-manual/dev-manual-common-tasks:creating partitioned images using wic`" | 2907 | ":ref:`dev-manual/common-tasks:creating partitioned images using wic`" |
2908 | section of the Yocto Project Development Tasks Manual. Reference | 2908 | section of the Yocto Project Development Tasks Manual. Reference |
2909 | material for Wic is located in the | 2909 | material for Wic is located in the |
2910 | ":doc:`/ref-manual/ref-kickstart`" chapter. | 2910 | ":doc:`/ref-manual/ref-kickstart`" chapter. |
@@ -2940,7 +2940,7 @@ system and gives an overview of their function and contents. | |||
2940 | the same files into a ``boot`` directory within the target partition. | 2940 | the same files into a ``boot`` directory within the target partition. |
2941 | 2941 | ||
2942 | You can find information on how to use the Wic tool in the | 2942 | You can find information on how to use the Wic tool in the |
2943 | ":ref:`dev-manual/dev-manual-common-tasks:creating partitioned images using wic`" | 2943 | ":ref:`dev-manual/common-tasks:creating partitioned images using wic`" |
2944 | section of the Yocto Project Development Tasks Manual. Reference | 2944 | section of the Yocto Project Development Tasks Manual. Reference |
2945 | material for Wic is located in the | 2945 | material for Wic is located in the |
2946 | ":doc:`/ref-manual/ref-kickstart`" chapter. | 2946 | ":doc:`/ref-manual/ref-kickstart`" chapter. |
@@ -3000,7 +3000,7 @@ system and gives an overview of their function and contents. | |||
3000 | the ":ref:`ref-features-image`" section. | 3000 | the ":ref:`ref-features-image`" section. |
3001 | 3001 | ||
3002 | For an example that shows how to customize your image by using this | 3002 | For an example that shows how to customize your image by using this |
3003 | variable, see the ":ref:`dev-manual/dev-manual-common-tasks:customizing images using custom \`\`image_features\`\` and \`\`extra_image_features\`\``" | 3003 | variable, see the ":ref:`dev-manual/common-tasks:customizing images using custom \`\`image_features\`\` and \`\`extra_image_features\`\``" |
3004 | section in the Yocto Project Development Tasks Manual. | 3004 | section in the Yocto Project Development Tasks Manual. |
3005 | 3005 | ||
3006 | :term:`IMAGE_FSTYPES` | 3006 | :term:`IMAGE_FSTYPES` |
@@ -3058,7 +3058,7 @@ system and gives an overview of their function and contents. | |||
3058 | allows the initial RAM filesystem (initramfs) recipe to use a | 3058 | allows the initial RAM filesystem (initramfs) recipe to use a |
3059 | fixed set of packages and not be affected by ``IMAGE_INSTALL``. | 3059 | fixed set of packages and not be affected by ``IMAGE_INSTALL``. |
3060 | For information on creating an initramfs, see the | 3060 | For information on creating an initramfs, see the |
3061 | ":ref:`dev-manual/dev-manual-common-tasks:building an initial ram filesystem (initramfs) image`" | 3061 | ":ref:`dev-manual/common-tasks:building an initial ram filesystem (initramfs) image`" |
3062 | section in the Yocto Project Development Tasks Manual. | 3062 | section in the Yocto Project Development Tasks Manual. |
3063 | 3063 | ||
3064 | - Using ``IMAGE_INSTALL`` with the | 3064 | - Using ``IMAGE_INSTALL`` with the |
@@ -3554,7 +3554,7 @@ system and gives an overview of their function and contents. | |||
3554 | :term:`INITRAMFS_IMAGE_BUNDLE` | 3554 | :term:`INITRAMFS_IMAGE_BUNDLE` |
3555 | variable, which allows the generated image to be bundled inside the | 3555 | variable, which allows the generated image to be bundled inside the |
3556 | kernel image. Additionally, for information on creating an initramfs | 3556 | kernel image. Additionally, for information on creating an initramfs |
3557 | image, see the ":ref:`dev-manual/dev-manual-common-tasks:building an initial ram filesystem (initramfs) image`" section | 3557 | image, see the ":ref:`dev-manual/common-tasks:building an initial ram filesystem (initramfs) image`" section |
3558 | in the Yocto Project Development Tasks Manual. | 3558 | in the Yocto Project Development Tasks Manual. |
3559 | 3559 | ||
3560 | :term:`INITRAMFS_IMAGE_BUNDLE` | 3560 | :term:`INITRAMFS_IMAGE_BUNDLE` |
@@ -3602,7 +3602,7 @@ system and gives an overview of their function and contents. | |||
3602 | See the | 3602 | See the |
3603 | :yocto_git:`local.conf.sample.extended </poky/tree/meta-poky/conf/local.conf.sample.extended>` | 3603 | :yocto_git:`local.conf.sample.extended </poky/tree/meta-poky/conf/local.conf.sample.extended>` |
3604 | file for additional information. Also, for information on creating an | 3604 | file for additional information. Also, for information on creating an |
3605 | initramfs, see the ":ref:`dev-manual/dev-manual-common-tasks:building an initial ram filesystem (initramfs) image`" section | 3605 | initramfs, see the ":ref:`dev-manual/common-tasks:building an initial ram filesystem (initramfs) image`" section |
3606 | in the Yocto Project Development Tasks Manual. | 3606 | in the Yocto Project Development Tasks Manual. |
3607 | 3607 | ||
3608 | :term:`INITRAMFS_LINK_NAME` | 3608 | :term:`INITRAMFS_LINK_NAME` |
@@ -4191,7 +4191,7 @@ system and gives an overview of their function and contents. | |||
4191 | The OpenEmbedded build system produces a warning if the variable | 4191 | The OpenEmbedded build system produces a warning if the variable |
4192 | is not set for any given layer. | 4192 | is not set for any given layer. |
4193 | 4193 | ||
4194 | See the ":ref:`dev-manual/dev-manual-common-tasks:creating your own layer`" | 4194 | See the ":ref:`dev-manual/common-tasks:creating your own layer`" |
4195 | section in the Yocto Project Development Tasks Manual. | 4195 | section in the Yocto Project Development Tasks Manual. |
4196 | 4196 | ||
4197 | :term:`LAYERVERSION` | 4197 | :term:`LAYERVERSION` |
@@ -4240,7 +4240,7 @@ system and gives an overview of their function and contents. | |||
4240 | This variable must be defined for all recipes (unless | 4240 | This variable must be defined for all recipes (unless |
4241 | :term:`LICENSE` is set to "CLOSED"). | 4241 | :term:`LICENSE` is set to "CLOSED"). |
4242 | 4242 | ||
4243 | For more information, see the ":ref:`dev-manual/dev-manual-common-tasks:tracking license changes`" | 4243 | For more information, see the ":ref:`dev-manual/common-tasks:tracking license changes`" |
4244 | section in the Yocto Project Development Tasks Manual. | 4244 | section in the Yocto Project Development Tasks Manual. |
4245 | 4245 | ||
4246 | :term:`LICENSE` | 4246 | :term:`LICENSE` |
@@ -4306,7 +4306,7 @@ system and gives an overview of their function and contents. | |||
4306 | For related information on providing license text, see the | 4306 | For related information on providing license text, see the |
4307 | :term:`COPY_LIC_DIRS` variable, the | 4307 | :term:`COPY_LIC_DIRS` variable, the |
4308 | :term:`COPY_LIC_MANIFEST` variable, and the | 4308 | :term:`COPY_LIC_MANIFEST` variable, and the |
4309 | ":ref:`dev-manual/dev-manual-common-tasks:providing license text`" | 4309 | ":ref:`dev-manual/common-tasks:providing license text`" |
4310 | section in the Yocto Project Development Tasks Manual. | 4310 | section in the Yocto Project Development Tasks Manual. |
4311 | 4311 | ||
4312 | :term:`LICENSE_FLAGS` | 4312 | :term:`LICENSE_FLAGS` |
@@ -4319,7 +4319,7 @@ system and gives an overview of their function and contents. | |||
4319 | typically used to mark recipes that might require additional licenses | 4319 | typically used to mark recipes that might require additional licenses |
4320 | in order to be used in a commercial product. For more information, | 4320 | in order to be used in a commercial product. For more information, |
4321 | see the | 4321 | see the |
4322 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" | 4322 | ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`" |
4323 | section in the Yocto Project Development Tasks Manual. | 4323 | section in the Yocto Project Development Tasks Manual. |
4324 | 4324 | ||
4325 | :term:`LICENSE_FLAGS_WHITELIST` | 4325 | :term:`LICENSE_FLAGS_WHITELIST` |
@@ -4327,7 +4327,7 @@ system and gives an overview of their function and contents. | |||
4327 | :term:`LICENSE_FLAGS` within a recipe should not | 4327 | :term:`LICENSE_FLAGS` within a recipe should not |
4328 | prevent that recipe from being built. This practice is otherwise | 4328 | prevent that recipe from being built. This practice is otherwise |
4329 | known as "whitelisting" license flags. For more information, see the | 4329 | known as "whitelisting" license flags. For more information, see the |
4330 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" | 4330 | ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`" |
4331 | section in the Yocto Project Development Tasks Manual. | 4331 | section in the Yocto Project Development Tasks Manual. |
4332 | 4332 | ||
4333 | :term:`LICENSE_PATH` | 4333 | :term:`LICENSE_PATH` |
@@ -4890,7 +4890,7 @@ system and gives an overview of their function and contents. | |||
4890 | Controls how the OpenEmbedded build system spawns interactive | 4890 | Controls how the OpenEmbedded build system spawns interactive |
4891 | terminals on the host development system (e.g. using the BitBake | 4891 | terminals on the host development system (e.g. using the BitBake |
4892 | command with the ``-c devshell`` command-line option). For more | 4892 | command with the ``-c devshell`` command-line option). For more |
4893 | information, see the ":ref:`dev-manual/dev-manual-common-tasks:using a development shell`" section in | 4893 | information, see the ":ref:`dev-manual/common-tasks:using a development shell`" section in |
4894 | the Yocto Project Development Tasks Manual. | 4894 | the Yocto Project Development Tasks Manual. |
4895 | 4895 | ||
4896 | You can use the following values for the ``OE_TERMINAL`` variable: | 4896 | You can use the following values for the ``OE_TERMINAL`` variable: |
@@ -4959,7 +4959,7 @@ system and gives an overview of their function and contents. | |||
4959 | 4959 | ||
4960 | An easy way to see what overrides apply is to search for ``OVERRIDES`` | 4960 | An easy way to see what overrides apply is to search for ``OVERRIDES`` |
4961 | in the output of the ``bitbake -e`` command. See the | 4961 | in the output of the ``bitbake -e`` command. See the |
4962 | ":ref:`dev-manual/dev-manual-common-tasks:viewing variable values`" section in the Yocto | 4962 | ":ref:`dev-manual/common-tasks:viewing variable values`" section in the Yocto |
4963 | Project Development Tasks Manual for more information. | 4963 | Project Development Tasks Manual for more information. |
4964 | 4964 | ||
4965 | :term:`P` | 4965 | :term:`P` |
@@ -4981,7 +4981,7 @@ system and gives an overview of their function and contents. | |||
4981 | specific by using the package name as a suffix. | 4981 | specific by using the package name as a suffix. |
4982 | 4982 | ||
4983 | You can find out more about applying this variable in the | 4983 | You can find out more about applying this variable in the |
4984 | ":ref:`dev-manual/dev-manual-common-tasks:adding custom metadata to packages`" | 4984 | ":ref:`dev-manual/common-tasks:adding custom metadata to packages`" |
4985 | section in the Yocto Project Development Tasks Manual. | 4985 | section in the Yocto Project Development Tasks Manual. |
4986 | 4986 | ||
4987 | :term:`PACKAGE_ARCH` | 4987 | :term:`PACKAGE_ARCH` |
@@ -5079,7 +5079,7 @@ system and gives an overview of their function and contents. | |||
5079 | separate ``*-src`` pkg. This is the default behavior. | 5079 | separate ``*-src`` pkg. This is the default behavior. |
5080 | 5080 | ||
5081 | You can find out more about debugging using GDB by reading the | 5081 | You can find out more about debugging using GDB by reading the |
5082 | ":ref:`dev-manual/dev-manual-common-tasks:debugging with the gnu project debugger (gdb) remotely`" section | 5082 | ":ref:`dev-manual/common-tasks:debugging with the gnu project debugger (gdb) remotely`" section |
5083 | in the Yocto Project Development Tasks Manual. | 5083 | in the Yocto Project Development Tasks Manual. |
5084 | 5084 | ||
5085 | :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` | 5085 | :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` |
@@ -5243,7 +5243,7 @@ system and gives an overview of their function and contents. | |||
5243 | the :ref:`core-image-minimal-initramfs <ref-manual/ref-images:images>` | 5243 | the :ref:`core-image-minimal-initramfs <ref-manual/ref-images:images>` |
5244 | image. When working with an initial RAM filesystem (initramfs) image, | 5244 | image. When working with an initial RAM filesystem (initramfs) image, |
5245 | use the ``PACKAGE_INSTALL`` variable. For information on creating an | 5245 | use the ``PACKAGE_INSTALL`` variable. For information on creating an |
5246 | initramfs, see the ":ref:`dev-manual/dev-manual-common-tasks:building an initial ram filesystem (initramfs) image`" section | 5246 | initramfs, see the ":ref:`dev-manual/common-tasks:building an initial ram filesystem (initramfs) image`" section |
5247 | in the Yocto Project Development Tasks Manual. | 5247 | in the Yocto Project Development Tasks Manual. |
5248 | 5248 | ||
5249 | :term:`PACKAGE_INSTALL_ATTEMPTONLY` | 5249 | :term:`PACKAGE_INSTALL_ATTEMPTONLY` |
@@ -5266,7 +5266,7 @@ system and gives an overview of their function and contents. | |||
5266 | ``PACKAGE_WRITE_DEPS``. | 5266 | ``PACKAGE_WRITE_DEPS``. |
5267 | 5267 | ||
5268 | For information on running post-installation scripts, see the | 5268 | For information on running post-installation scripts, see the |
5269 | ":ref:`dev-manual/dev-manual-common-tasks:post-installation scripts`" | 5269 | ":ref:`dev-manual/common-tasks:post-installation scripts`" |
5270 | section in the Yocto Project Development Tasks Manual. | 5270 | section in the Yocto Project Development Tasks Manual. |
5271 | 5271 | ||
5272 | :term:`PACKAGECONFIG` | 5272 | :term:`PACKAGECONFIG` |
@@ -5423,7 +5423,7 @@ system and gives an overview of their function and contents. | |||
5423 | 5423 | ||
5424 | For an example of how to use the ``PACKAGES_DYNAMIC`` variable when | 5424 | For an example of how to use the ``PACKAGES_DYNAMIC`` variable when |
5425 | you are splitting packages, see the | 5425 | you are splitting packages, see the |
5426 | ":ref:`dev-manual/dev-manual-common-tasks:handling optional module packaging`" | 5426 | ":ref:`dev-manual/common-tasks:handling optional module packaging`" |
5427 | section in the Yocto Project Development Tasks Manual. | 5427 | section in the Yocto Project Development Tasks Manual. |
5428 | 5428 | ||
5429 | :term:`PACKAGESPLITFUNCS` | 5429 | :term:`PACKAGESPLITFUNCS` |
@@ -5458,7 +5458,7 @@ system and gives an overview of their function and contents. | |||
5458 | the ``do_compile`` task that result in race conditions, you can clear | 5458 | the ``do_compile`` task that result in race conditions, you can clear |
5459 | the ``PARALLEL_MAKE`` variable within the recipe as a workaround. For | 5459 | the ``PARALLEL_MAKE`` variable within the recipe as a workaround. For |
5460 | information on addressing race conditions, see the | 5460 | information on addressing race conditions, see the |
5461 | ":ref:`dev-manual/dev-manual-common-tasks:debugging parallel make races`" | 5461 | ":ref:`dev-manual/common-tasks:debugging parallel make races`" |
5462 | section in the Yocto Project Development Tasks Manual. | 5462 | section in the Yocto Project Development Tasks Manual. |
5463 | 5463 | ||
5464 | For single socket systems (i.e. one CPU), you should not have to | 5464 | For single socket systems (i.e. one CPU), you should not have to |
@@ -5468,7 +5468,7 @@ system and gives an overview of their function and contents. | |||
5468 | not set higher than "-j 20". | 5468 | not set higher than "-j 20". |
5469 | 5469 | ||
5470 | For more information on speeding up builds, see the | 5470 | For more information on speeding up builds, see the |
5471 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" | 5471 | ":ref:`dev-manual/common-tasks:speeding up a build`" |
5472 | section in the Yocto Project Development Tasks Manual. | 5472 | section in the Yocto Project Development Tasks Manual. |
5473 | 5473 | ||
5474 | :term:`PARALLEL_MAKEINST` | 5474 | :term:`PARALLEL_MAKEINST` |
@@ -5488,7 +5488,7 @@ system and gives an overview of their function and contents. | |||
5488 | the ``do_install`` task that result in race conditions, you can | 5488 | the ``do_install`` task that result in race conditions, you can |
5489 | clear the ``PARALLEL_MAKEINST`` variable within the recipe as a | 5489 | clear the ``PARALLEL_MAKEINST`` variable within the recipe as a |
5490 | workaround. For information on addressing race conditions, see the | 5490 | workaround. For information on addressing race conditions, see the |
5491 | ":ref:`dev-manual/dev-manual-common-tasks:debugging parallel make races`" | 5491 | ":ref:`dev-manual/common-tasks:debugging parallel make races`" |
5492 | section in the Yocto Project Development Tasks Manual. | 5492 | section in the Yocto Project Development Tasks Manual. |
5493 | 5493 | ||
5494 | :term:`PATCHRESOLVE` | 5494 | :term:`PATCHRESOLVE` |
@@ -5580,7 +5580,7 @@ system and gives an overview of their function and contents. | |||
5580 | For examples of how this data is used, see the | 5580 | For examples of how this data is used, see the |
5581 | ":ref:`overview-manual/overview-manual-concepts:automatically added runtime dependencies`" | 5581 | ":ref:`overview-manual/overview-manual-concepts:automatically added runtime dependencies`" |
5582 | section in the Yocto Project Overview and Concepts Manual and the | 5582 | section in the Yocto Project Overview and Concepts Manual and the |
5583 | ":ref:`dev-manual/dev-manual-common-tasks:viewing package information with \`\`oe-pkgdata-util\`\``" | 5583 | ":ref:`dev-manual/common-tasks:viewing package information with \`\`oe-pkgdata-util\`\``" |
5584 | section in the Yocto Project Development Tasks Manual. For more | 5584 | section in the Yocto Project Development Tasks Manual. For more |
5585 | information on the shared, global-state directory, see | 5585 | information on the shared, global-state directory, see |
5586 | :term:`STAGING_DIR_HOST`. | 5586 | :term:`STAGING_DIR_HOST`. |
@@ -5713,7 +5713,7 @@ system and gives an overview of their function and contents. | |||
5713 | 5713 | ||
5714 | Because manually managing ``PR`` can be cumbersome and error-prone, | 5714 | Because manually managing ``PR`` can be cumbersome and error-prone, |
5715 | an automated solution exists. See the | 5715 | an automated solution exists. See the |
5716 | ":ref:`dev-manual/dev-manual-common-tasks:working with a pr service`" section | 5716 | ":ref:`dev-manual/common-tasks:working with a pr service`" section |
5717 | in the Yocto Project Development Tasks Manual for more information. | 5717 | in the Yocto Project Development Tasks Manual for more information. |
5718 | 5718 | ||
5719 | :term:`PREFERRED_PROVIDER` | 5719 | :term:`PREFERRED_PROVIDER` |
@@ -5738,7 +5738,7 @@ system and gives an overview of their function and contents. | |||
5738 | PREFERRED_PROVIDER_virtual/libgl ?= "mesa" | 5738 | PREFERRED_PROVIDER_virtual/libgl ?= "mesa" |
5739 | 5739 | ||
5740 | For more | 5740 | For more |
5741 | information, see the ":ref:`dev-manual/dev-manual-common-tasks:using virtual providers`" | 5741 | information, see the ":ref:`dev-manual/common-tasks:using virtual providers`" |
5742 | section in the Yocto Project Development Tasks Manual. | 5742 | section in the Yocto Project Development Tasks Manual. |
5743 | 5743 | ||
5744 | .. note:: | 5744 | .. note:: |
@@ -5951,7 +5951,7 @@ system and gives an overview of their function and contents. | |||
5951 | 5951 | ||
5952 | You must | 5952 | You must |
5953 | set the variable if you want to automatically start a local :ref:`PR | 5953 | set the variable if you want to automatically start a local :ref:`PR |
5954 | service <dev-manual/dev-manual-common-tasks:working with a pr service>`. You can | 5954 | service <dev-manual/common-tasks:working with a pr service>`. You can |
5955 | set ``PRSERV_HOST`` to other values to use a remote PR service. | 5955 | set ``PRSERV_HOST`` to other values to use a remote PR service. |
5956 | 5956 | ||
5957 | 5957 | ||
@@ -5965,7 +5965,7 @@ system and gives an overview of their function and contents. | |||
5965 | 5965 | ||
5966 | :term:`PTEST_ENABLED` | 5966 | :term:`PTEST_ENABLED` |
5967 | Specifies whether or not :ref:`Package | 5967 | Specifies whether or not :ref:`Package |
5968 | Test <dev-manual/dev-manual-common-tasks:testing packages with ptest>` (ptest) | 5968 | Test <dev-manual/common-tasks:testing packages with ptest>` (ptest) |
5969 | functionality is enabled when building a recipe. You should not set | 5969 | functionality is enabled when building a recipe. You should not set |
5970 | this variable directly. Enabling and disabling building Package Tests | 5970 | this variable directly. Enabling and disabling building Package Tests |
5971 | at build time should be done by adding "ptest" to (or removing it | 5971 | at build time should be done by adding "ptest" to (or removing it |
@@ -7000,7 +7000,7 @@ system and gives an overview of their function and contents. | |||
7000 | various ``SPL_*`` variables used by the OpenEmbedded build system. | 7000 | various ``SPL_*`` variables used by the OpenEmbedded build system. |
7001 | 7001 | ||
7002 | See the BeagleBone machine configuration example in the | 7002 | See the BeagleBone machine configuration example in the |
7003 | ":ref:`dev-manual/dev-manual-common-tasks:adding a layer using the \`\`bitbake-layers\`\` script`" | 7003 | ":ref:`dev-manual/common-tasks:adding a layer using the \`\`bitbake-layers\`\` script`" |
7004 | section in the Yocto Project Board Support Package Developer's Guide | 7004 | section in the Yocto Project Board Support Package Developer's Guide |
7005 | for additional information. | 7005 | for additional information. |
7006 | 7006 | ||
@@ -7200,7 +7200,7 @@ system and gives an overview of their function and contents. | |||
7200 | For information on limitations when inheriting the latest revision | 7200 | For information on limitations when inheriting the latest revision |
7201 | of software using ``SRCREV``, see the :term:`AUTOREV` variable | 7201 | of software using ``SRCREV``, see the :term:`AUTOREV` variable |
7202 | description and the | 7202 | description and the |
7203 | ":ref:`dev-manual/dev-manual-common-tasks:automatically incrementing a package version number`" | 7203 | ":ref:`dev-manual/common-tasks:automatically incrementing a package version number`" |
7204 | section, which is in the Yocto Project Development Tasks Manual. | 7204 | section, which is in the Yocto Project Development Tasks Manual. |
7205 | 7205 | ||
7206 | :term:`SSTATE_DIR` | 7206 | :term:`SSTATE_DIR` |
@@ -7660,7 +7660,7 @@ system and gives an overview of their function and contents. | |||
7660 | 7660 | ||
7661 | :term:`SYSVINIT_ENABLED_GETTYS` | 7661 | :term:`SYSVINIT_ENABLED_GETTYS` |
7662 | When using | 7662 | When using |
7663 | :ref:`SysVinit <dev-manual/dev-manual-common-tasks:enabling system services>`, | 7663 | :ref:`SysVinit <dev-manual/common-tasks:enabling system services>`, |
7664 | specifies a space-separated list of the virtual terminals that should | 7664 | specifies a space-separated list of the virtual terminals that should |
7665 | run a `getty <http://en.wikipedia.org/wiki/Getty_%28Unix%29>`__ | 7665 | run a `getty <http://en.wikipedia.org/wiki/Getty_%28Unix%29>`__ |
7666 | (allowing login), assuming :term:`USE_VT` is not set to | 7666 | (allowing login), assuming :term:`USE_VT` is not set to |
@@ -7946,7 +7946,7 @@ system and gives an overview of their function and contents. | |||
7946 | file. | 7946 | file. |
7947 | 7947 | ||
7948 | For more information on testing images, see the | 7948 | For more information on testing images, see the |
7949 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" | 7949 | ":ref:`dev-manual/common-tasks:performing automated runtime testing`" |
7950 | section in the Yocto Project Development Tasks Manual. | 7950 | section in the Yocto Project Development Tasks Manual. |
7951 | 7951 | ||
7952 | :term:`TEST_SERIALCONTROL_CMD` | 7952 | :term:`TEST_SERIALCONTROL_CMD` |
@@ -8022,7 +8022,7 @@ system and gives an overview of their function and contents. | |||
8022 | TEST_SUITES = "test_A test_B" | 8022 | TEST_SUITES = "test_A test_B" |
8023 | 8023 | ||
8024 | For more information on testing images, see the | 8024 | For more information on testing images, see the |
8025 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" | 8025 | ":ref:`dev-manual/common-tasks:performing automated runtime testing`" |
8026 | section in the Yocto Project Development Tasks Manual. | 8026 | section in the Yocto Project Development Tasks Manual. |
8027 | 8027 | ||
8028 | :term:`TEST_TARGET` | 8028 | :term:`TEST_TARGET` |
@@ -8042,7 +8042,7 @@ system and gives an overview of their function and contents. | |||
8042 | You can provide the following arguments with ``TEST_TARGET``: | 8042 | You can provide the following arguments with ``TEST_TARGET``: |
8043 | 8043 | ||
8044 | - *"qemu":* Boots a QEMU image and runs the tests. See the | 8044 | - *"qemu":* Boots a QEMU image and runs the tests. See the |
8045 | ":ref:`dev-manual/dev-manual-common-tasks:enabling runtime tests on qemu`" section | 8045 | ":ref:`dev-manual/common-tasks:enabling runtime tests on qemu`" section |
8046 | in the Yocto Project Development Tasks Manual for more | 8046 | in the Yocto Project Development Tasks Manual for more |
8047 | information. | 8047 | information. |
8048 | 8048 | ||
@@ -8058,7 +8058,7 @@ system and gives an overview of their function and contents. | |||
8058 | ``meta/lib/oeqa/controllers/simpleremote.py``. | 8058 | ``meta/lib/oeqa/controllers/simpleremote.py``. |
8059 | 8059 | ||
8060 | For information on running tests on hardware, see the | 8060 | For information on running tests on hardware, see the |
8061 | ":ref:`dev-manual/dev-manual-common-tasks:enabling runtime tests on hardware`" | 8061 | ":ref:`dev-manual/common-tasks:enabling runtime tests on hardware`" |
8062 | section in the Yocto Project Development Tasks Manual. | 8062 | section in the Yocto Project Development Tasks Manual. |
8063 | 8063 | ||
8064 | :term:`TEST_TARGET_IP` | 8064 | :term:`TEST_TARGET_IP` |
@@ -8096,7 +8096,7 @@ system and gives an overview of their function and contents. | |||
8096 | 8096 | ||
8097 | For more information | 8097 | For more information |
8098 | on enabling, running, and writing these tests, see the | 8098 | on enabling, running, and writing these tests, see the |
8099 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" | 8099 | ":ref:`dev-manual/common-tasks:performing automated runtime testing`" |
8100 | section in the Yocto Project Development Tasks Manual and the | 8100 | section in the Yocto Project Development Tasks Manual and the |
8101 | ":ref:`testimage*.bbclass <ref-classes-testimage*>`" section. | 8101 | ":ref:`testimage*.bbclass <ref-classes-testimage*>`" section. |
8102 | 8102 | ||
@@ -8554,13 +8554,13 @@ system and gives an overview of their function and contents. | |||
8554 | specifically set. Typically, you would set ``USE_DEVFS`` to "0" for a | 8554 | specifically set. Typically, you would set ``USE_DEVFS`` to "0" for a |
8555 | statically populated ``/dev`` directory. | 8555 | statically populated ``/dev`` directory. |
8556 | 8556 | ||
8557 | See the ":ref:`dev-manual/dev-manual-common-tasks:selecting a device manager`" section in | 8557 | See the ":ref:`dev-manual/common-tasks:selecting a device manager`" section in |
8558 | the Yocto Project Development Tasks Manual for information on how to | 8558 | the Yocto Project Development Tasks Manual for information on how to |
8559 | use this variable. | 8559 | use this variable. |
8560 | 8560 | ||
8561 | :term:`USE_VT` | 8561 | :term:`USE_VT` |
8562 | When using | 8562 | When using |
8563 | :ref:`SysVinit <dev-manual/dev-manual-common-tasks:enabling system services>`, | 8563 | :ref:`SysVinit <dev-manual/common-tasks:enabling system services>`, |
8564 | determines whether or not to run a | 8564 | determines whether or not to run a |
8565 | `getty <http://en.wikipedia.org/wiki/Getty_%28Unix%29>`__ on any | 8565 | `getty <http://en.wikipedia.org/wiki/Getty_%28Unix%29>`__ on any |
8566 | virtual terminals in order to enable logging in through those | 8566 | virtual terminals in order to enable logging in through those |
@@ -8735,7 +8735,7 @@ system and gives an overview of their function and contents. | |||
8735 | OpenEmbedded build system to create a partitioned image | 8735 | OpenEmbedded build system to create a partitioned image |
8736 | (image\ ``.wic``). For information on how to create a partitioned | 8736 | (image\ ``.wic``). For information on how to create a partitioned |
8737 | image, see the | 8737 | image, see the |
8738 | ":ref:`dev-manual/dev-manual-common-tasks:creating partitioned images using wic`" | 8738 | ":ref:`dev-manual/common-tasks:creating partitioned images using wic`" |
8739 | section in the Yocto Project Development Tasks Manual. For details on | 8739 | section in the Yocto Project Development Tasks Manual. For details on |
8740 | the kickstart file format, see the ":doc:`/ref-manual/ref-kickstart`" Chapter. | 8740 | the kickstart file format, see the ":doc:`/ref-manual/ref-kickstart`" Chapter. |
8741 | 8741 | ||