summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/ref-variables.rst')
-rw-r--r--documentation/ref-manual/ref-variables.rst104
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