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 | ||
