diff options
| author | Quentin Schulz <foss@0leil.net> | 2020-10-03 10:23:36 +0200 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-01-04 10:55:00 +0000 |
| commit | a934ad95cfafba4219732fa6c5c40a2d16220f23 (patch) | |
| tree | 99ac5bcd36673d2d3b6e29a4996a12a3bd865677 /documentation/ref-manual | |
| parent | 23b1085ba7ec78450c4f28286ef4dd021fe9df84 (diff) | |
| download | poky-a934ad95cfafba4219732fa6c5c40a2d16220f23.tar.gz | |
docs: ref-manual: ref-variables: add links to terms in glossary
Before the move to Sphinx, it used to be possible to get a direct link to a
variable from the term glossary. It is very useful when pointing people to
a specific variable when manually looking for it in the glossary.
Let's add this "feature" back.
(From yocto-docs rev: ee811e9f351eb79987dcdc2c2dbbd14ac52d92ca)
Signed-off-by: Quentin Schulz <foss@0leil.net>
Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
(cherry picked from commit 9e468274eaad270efd5f50e58a523798fcb8097e)
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
| -rw-r--r-- | documentation/ref-manual/ref-variables.rst | 1162 |
1 files changed, 581 insertions, 581 deletions
diff --git a/documentation/ref-manual/ref-variables.rst b/documentation/ref-manual/ref-variables.rst index 6b00380350..60a766e79e 100644 --- a/documentation/ref-manual/ref-variables.rst +++ b/documentation/ref-manual/ref-variables.rst | |||
| @@ -18,7 +18,7 @@ system and gives an overview of their function and contents. | |||
| 18 | 18 | ||
| 19 | .. glossary:: | 19 | .. glossary:: |
| 20 | 20 | ||
| 21 | ABIEXTENSION | 21 | :term:`ABIEXTENSION` |
| 22 | Extension to the Application Binary Interface (ABI) field of the GNU | 22 | Extension to the Application Binary Interface (ABI) field of the GNU |
| 23 | canonical architecture name (e.g. "eabi"). | 23 | canonical architecture name (e.g. "eabi"). |
| 24 | 24 | ||
| @@ -29,7 +29,7 @@ system and gives an overview of their function and contents. | |||
| 29 | 29 | ||
| 30 | ABIEXTENSION = "eabi" | 30 | ABIEXTENSION = "eabi" |
| 31 | 31 | ||
| 32 | ALLOW_EMPTY | 32 | :term:`ALLOW_EMPTY` |
| 33 | Specifies whether to produce an output package even if it is empty. | 33 | Specifies whether to produce an output package even if it is empty. |
| 34 | By default, BitBake does not produce empty packages. This default | 34 | By default, BitBake does not produce empty packages. This default |
| 35 | behavior can cause issues when there is an | 35 | behavior can cause issues when there is an |
| @@ -44,7 +44,7 @@ system and gives an overview of their function and contents. | |||
| 44 | ALLOW_EMPTY_${PN}-dev = "1" | 44 | ALLOW_EMPTY_${PN}-dev = "1" |
| 45 | ALLOW_EMPTY_${PN}-staticdev = "1" | 45 | ALLOW_EMPTY_${PN}-staticdev = "1" |
| 46 | 46 | ||
| 47 | ALTERNATIVE | 47 | :term:`ALTERNATIVE` |
| 48 | Lists commands in a package that need an alternative binary naming | 48 | Lists commands in a package that need an alternative binary naming |
| 49 | scheme. Sometimes the same command is provided in multiple packages. | 49 | scheme. Sometimes the same command is provided in multiple packages. |
| 50 | When this occurs, the OpenEmbedded build system needs to use the | 50 | When this occurs, the OpenEmbedded build system needs to use the |
| @@ -63,7 +63,7 @@ system and gives an overview of their function and contents. | |||
| 63 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" | 63 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" |
| 64 | section. | 64 | section. |
| 65 | 65 | ||
| 66 | ALTERNATIVE_LINK_NAME | 66 | :term:`ALTERNATIVE_LINK_NAME` |
| 67 | Used by the alternatives system to map duplicated commands to actual | 67 | Used by the alternatives system to map duplicated commands to actual |
| 68 | locations. For example, if the ``bracket`` command provided by the | 68 | locations. For example, if the ``bracket`` command provided by the |
| 69 | ``busybox`` package is duplicated through another package, you must | 69 | ``busybox`` package is duplicated through another package, you must |
| @@ -84,7 +84,7 @@ system and gives an overview of their function and contents. | |||
| 84 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" | 84 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" |
| 85 | section. | 85 | section. |
| 86 | 86 | ||
| 87 | ALTERNATIVE_PRIORITY | 87 | :term:`ALTERNATIVE_PRIORITY` |
| 88 | Used by the alternatives system to create default priorities for | 88 | Used by the alternatives system to create default priorities for |
| 89 | duplicated commands. You can use the variable to create a single | 89 | duplicated commands. You can use the variable to create a single |
| 90 | default regardless of the command name or package, a default for | 90 | default regardless of the command name or package, a default for |
| @@ -101,7 +101,7 @@ system and gives an overview of their function and contents. | |||
| 101 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" | 101 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" |
| 102 | section. | 102 | section. |
| 103 | 103 | ||
| 104 | ALTERNATIVE_TARGET | 104 | :term:`ALTERNATIVE_TARGET` |
| 105 | Used by the alternatives system to create default link locations for | 105 | Used by the alternatives system to create default link locations for |
| 106 | duplicated commands. You can use the variable to create a single | 106 | duplicated commands. You can use the variable to create a single |
| 107 | default location for all duplicated commands regardless of the | 107 | default location for all duplicated commands regardless of the |
| @@ -132,17 +132,17 @@ system and gives an overview of their function and contents. | |||
| 132 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" | 132 | ":ref:`update-alternatives.bbclass <ref-classes-update-alternatives>`" |
| 133 | section. | 133 | section. |
| 134 | 134 | ||
| 135 | APPEND | 135 | :term:`APPEND` |
| 136 | An override list of append strings for each target specified with | 136 | An override list of append strings for each target specified with |
| 137 | :term:`LABELS`. | 137 | :term:`LABELS`. |
| 138 | 138 | ||
| 139 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more | 139 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more |
| 140 | information on how this variable is used. | 140 | information on how this variable is used. |
| 141 | 141 | ||
| 142 | AR | 142 | :term:`AR` |
| 143 | The minimal command and arguments used to run ``ar``. | 143 | The minimal command and arguments used to run ``ar``. |
| 144 | 144 | ||
| 145 | ARCHIVER_MODE | 145 | :term:`ARCHIVER_MODE` |
| 146 | When used with the :ref:`archiver <ref-classes-archiver>` class, | 146 | When used with the :ref:`archiver <ref-classes-archiver>` class, |
| 147 | determines the type of information used to create a released archive. | 147 | determines the type of information used to create a released archive. |
| 148 | You can use this variable to create archives of patched source, | 148 | You can use this variable to create archives of patched source, |
| @@ -162,10 +162,10 @@ system and gives an overview of their function and contents. | |||
| 162 | For information on how the variable works, see the | 162 | For information on how the variable works, see the |
| 163 | ``meta/classes/archiver.bbclass`` file in the :term:`Source Directory`. | 163 | ``meta/classes/archiver.bbclass`` file in the :term:`Source Directory`. |
| 164 | 164 | ||
| 165 | AS | 165 | :term:`AS` |
| 166 | Minimal command and arguments needed to run the assembler. | 166 | Minimal command and arguments needed to run the assembler. |
| 167 | 167 | ||
| 168 | ASSUME_PROVIDED | 168 | :term:`ASSUME_PROVIDED` |
| 169 | Lists recipe names (:term:`PN` values) BitBake does not | 169 | Lists recipe names (:term:`PN` values) BitBake does not |
| 170 | attempt to build. Instead, BitBake assumes these recipes have already | 170 | attempt to build. Instead, BitBake assumes these recipes have already |
| 171 | been built. | 171 | been built. |
| @@ -175,7 +175,7 @@ system and gives an overview of their function and contents. | |||
| 175 | when specified, allows for the Git binary from the host to be used | 175 | when specified, allows for the Git binary from the host to be used |
| 176 | rather than building ``git-native``. | 176 | rather than building ``git-native``. |
| 177 | 177 | ||
| 178 | ASSUME_SHLIBS | 178 | :term:`ASSUME_SHLIBS` |
| 179 | Provides additional ``shlibs`` provider mapping information, which | 179 | Provides additional ``shlibs`` provider mapping information, which |
| 180 | adds to or overwrites the information provided automatically by the | 180 | adds to or overwrites the information provided automatically by the |
| 181 | system. Separate multiple entries using spaces. | 181 | system. Separate multiple entries using spaces. |
| @@ -192,11 +192,11 @@ system and gives an overview of their function and contents. | |||
| 192 | 192 | ||
| 193 | ASSUME_SHLIBS = "libEGL.so.1:libegl-implementation" | 193 | ASSUME_SHLIBS = "libEGL.so.1:libegl-implementation" |
| 194 | 194 | ||
| 195 | AUTHOR | 195 | :term:`AUTHOR` |
| 196 | The email address used to contact the original author or authors in | 196 | The email address used to contact the original author or authors in |
| 197 | order to send patches and forward bugs. | 197 | order to send patches and forward bugs. |
| 198 | 198 | ||
| 199 | AUTO_LIBNAME_PKGS | 199 | :term:`AUTO_LIBNAME_PKGS` |
| 200 | When the :ref:`debian <ref-classes-debian>` class is inherited, | 200 | When the :ref:`debian <ref-classes-debian>` class is inherited, |
| 201 | which is the default behavior, ``AUTO_LIBNAME_PKGS`` specifies which | 201 | which is the default behavior, ``AUTO_LIBNAME_PKGS`` specifies which |
| 202 | packages should be checked for libraries and renamed according to | 202 | packages should be checked for libraries and renamed according to |
| @@ -205,12 +205,12 @@ system and gives an overview of their function and contents. | |||
| 205 | The default value is "${PACKAGES}", which causes the debian class to | 205 | The default value is "${PACKAGES}", which causes the debian class to |
| 206 | act on all packages that are explicitly generated by the recipe. | 206 | act on all packages that are explicitly generated by the recipe. |
| 207 | 207 | ||
| 208 | AUTO_SYSLINUXMENU | 208 | :term:`AUTO_SYSLINUXMENU` |
| 209 | Enables creating an automatic menu for the syslinux bootloader. You | 209 | Enables creating an automatic menu for the syslinux bootloader. You |
| 210 | must set this variable in your recipe. The | 210 | must set this variable in your recipe. The |
| 211 | :ref:`syslinux <ref-classes-syslinux>` class checks this variable. | 211 | :ref:`syslinux <ref-classes-syslinux>` class checks this variable. |
| 212 | 212 | ||
| 213 | AUTOREV | 213 | :term:`AUTOREV` |
| 214 | When ``SRCREV`` is set to the value of this variable, it specifies to | 214 | When ``SRCREV`` is set to the value of this variable, it specifies to |
| 215 | use the latest source revision in the repository. Here is an example: | 215 | use the latest source revision in the repository. Here is an example: |
| 216 | :: | 216 | :: |
| @@ -230,7 +230,7 @@ system and gives an overview of their function and contents. | |||
| 230 | ":ref:`dev-manual/dev-manual-common-tasks:automatically incrementing a package version number`" | 230 | ":ref:`dev-manual/dev-manual-common-tasks:automatically incrementing a package version number`" |
| 231 | section in the Yocto Project Development Tasks Manual. | 231 | section in the Yocto Project Development Tasks Manual. |
| 232 | 232 | ||
| 233 | AVAILABLE_LICENSES | 233 | :term:`AVAILABLE_LICENSES` |
| 234 | List of licenses found in the directories specified by | 234 | List of licenses found in the directories specified by |
| 235 | :term:`COMMON_LICENSE_DIR` and | 235 | :term:`COMMON_LICENSE_DIR` and |
| 236 | :term:`LICENSE_PATH`. | 236 | :term:`LICENSE_PATH`. |
| @@ -247,7 +247,7 @@ system and gives an overview of their function and contents. | |||
| 247 | license.bbclass | 247 | license.bbclass |
| 248 | ). | 248 | ). |
| 249 | 249 | ||
| 250 | AVAILTUNES | 250 | :term:`AVAILTUNES` |
| 251 | The list of defined CPU and Application Binary Interface (ABI) | 251 | The list of defined CPU and Application Binary Interface (ABI) |
| 252 | tunings (i.e. "tunes") available for use by the OpenEmbedded build | 252 | tunings (i.e. "tunes") available for use by the OpenEmbedded build |
| 253 | system. | 253 | system. |
| @@ -264,7 +264,7 @@ system and gives an overview of their function and contents. | |||
| 264 | ":ref:`Basic Syntax <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:basic syntax>`" section in the BitBake | 264 | ":ref:`Basic Syntax <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:basic syntax>`" section in the BitBake |
| 265 | User Manual for more information. | 265 | User Manual for more information. |
| 266 | 266 | ||
| 267 | B | 267 | :term:`B` |
| 268 | The directory within the :term:`Build Directory` in | 268 | The directory within the :term:`Build Directory` in |
| 269 | which the OpenEmbedded build system places generated objects during a | 269 | which the OpenEmbedded build system places generated objects during a |
| 270 | recipe's build process. By default, this directory is the same as the | 270 | recipe's build process. By default, this directory is the same as the |
| @@ -278,7 +278,7 @@ system and gives an overview of their function and contents. | |||
| 278 | separating these directories. The build system defaults to using | 278 | separating these directories. The build system defaults to using |
| 279 | separate directories for ``gcc`` and some kernel recipes. | 279 | separate directories for ``gcc`` and some kernel recipes. |
| 280 | 280 | ||
| 281 | BAD_RECOMMENDATIONS | 281 | :term:`BAD_RECOMMENDATIONS` |
| 282 | Lists "recommended-only" packages to not install. Recommended-only | 282 | Lists "recommended-only" packages to not install. Recommended-only |
| 283 | packages are packages installed only through the | 283 | packages are packages installed only through the |
| 284 | :term:`RRECOMMENDS` variable. You can prevent any | 284 | :term:`RRECOMMENDS` variable. You can prevent any |
| @@ -308,7 +308,7 @@ system and gives an overview of their function and contents. | |||
| 308 | :term:`PACKAGE_EXCLUDE` variables for related | 308 | :term:`PACKAGE_EXCLUDE` variables for related |
| 309 | information. | 309 | information. |
| 310 | 310 | ||
| 311 | BASE_LIB | 311 | :term:`BASE_LIB` |
| 312 | The library directory name for the CPU or Application Binary | 312 | The library directory name for the CPU or Application Binary |
| 313 | Interface (ABI) tune. The ``BASE_LIB`` applies only in the Multilib | 313 | Interface (ABI) tune. The ``BASE_LIB`` applies only in the Multilib |
| 314 | context. See the ":ref:`dev-manual/dev-manual-common-tasks:combining multiple versions of library files into one image`" | 314 | context. See the ":ref:`dev-manual/dev-manual-common-tasks:combining multiple versions of library files into one image`" |
| @@ -319,11 +319,11 @@ system and gives an overview of their function and contents. | |||
| 319 | the :term:`Source Directory`. If Multilib is not | 319 | the :term:`Source Directory`. If Multilib is not |
| 320 | being used, the value defaults to "lib". | 320 | being used, the value defaults to "lib". |
| 321 | 321 | ||
| 322 | BASE_WORKDIR | 322 | :term:`BASE_WORKDIR` |
| 323 | Points to the base of the work directory for all recipes. The default | 323 | Points to the base of the work directory for all recipes. The default |
| 324 | value is "${TMPDIR}/work". | 324 | value is "${TMPDIR}/work". |
| 325 | 325 | ||
| 326 | BB_ALLOWED_NETWORKS | 326 | :term:`BB_ALLOWED_NETWORKS` |
| 327 | Specifies a space-delimited list of hosts that the fetcher is allowed | 327 | Specifies a space-delimited list of hosts that the fetcher is allowed |
| 328 | to use to obtain the required source code. Following are | 328 | to use to obtain the required source code. Following are |
| 329 | considerations surrounding this variable: | 329 | considerations surrounding this variable: |
| @@ -362,7 +362,7 @@ system and gives an overview of their function and contents. | |||
| 362 | host listed in ``SRC_URI`` after a successful fetch from the | 362 | host listed in ``SRC_URI`` after a successful fetch from the |
| 363 | ``PREMIRRORS`` occurs. | 363 | ``PREMIRRORS`` occurs. |
| 364 | 364 | ||
| 365 | BB_DANGLINGAPPENDS_WARNONLY | 365 | :term:`BB_DANGLINGAPPENDS_WARNONLY` |
| 366 | Defines how BitBake handles situations where an append file | 366 | Defines how BitBake handles situations where an append file |
| 367 | (``.bbappend``) has no corresponding recipe file (``.bb``). This | 367 | (``.bbappend``) has no corresponding recipe file (``.bb``). This |
| 368 | condition often occurs when layers get out of sync (e.g. ``oe-core`` | 368 | condition often occurs when layers get out of sync (e.g. ``oe-core`` |
| @@ -381,7 +381,7 @@ system and gives an overview of their function and contents. | |||
| 381 | 381 | ||
| 382 | BB_DANGLINGAPPENDS_WARNONLY = "1" | 382 | BB_DANGLINGAPPENDS_WARNONLY = "1" |
| 383 | 383 | ||
| 384 | BB_DISKMON_DIRS | 384 | :term:`BB_DISKMON_DIRS` |
| 385 | Monitors disk space and available inodes during the build and allows | 385 | Monitors disk space and available inodes during the build and allows |
| 386 | you to control the build based on these parameters. | 386 | you to control the build based on these parameters. |
| 387 | 387 | ||
| @@ -453,7 +453,7 @@ system and gives an overview of their function and contents. | |||
| 453 | free inodes in the ``${TMPDIR}`` directory drops below 100 Kbytes. No | 453 | free inodes in the ``${TMPDIR}`` directory drops below 100 Kbytes. No |
| 454 | disk space monitoring for the directory itself occurs in this case. | 454 | disk space monitoring for the directory itself occurs in this case. |
| 455 | 455 | ||
| 456 | BB_DISKMON_WARNINTERVAL | 456 | :term:`BB_DISKMON_WARNINTERVAL` |
| 457 | Defines the disk space and free inode warning intervals. To set these | 457 | Defines the disk space and free inode warning intervals. To set these |
| 458 | intervals, define the variable in your ``conf/local.conf`` file in | 458 | intervals, define the variable in your ``conf/local.conf`` file in |
| 459 | the :term:`Build Directory`. | 459 | the :term:`Build Directory`. |
| @@ -503,7 +503,7 @@ system and gives an overview of their function and contents. | |||
| 503 | a respective interval is reached beyond the initial warning (i.e. 1 | 503 | a respective interval is reached beyond the initial warning (i.e. 1 |
| 504 | Gbytes and 100 Kbytes). | 504 | Gbytes and 100 Kbytes). |
| 505 | 505 | ||
| 506 | BB_GENERATE_MIRROR_TARBALLS | 506 | :term:`BB_GENERATE_MIRROR_TARBALLS` |
| 507 | Causes tarballs of the source control repositories (e.g. Git | 507 | Causes tarballs of the source control repositories (e.g. Git |
| 508 | repositories), including metadata, to be placed in the | 508 | repositories), including metadata, to be placed in the |
| 509 | :term:`DL_DIR` directory. | 509 | :term:`DL_DIR` directory. |
| @@ -522,7 +522,7 @@ system and gives an overview of their function and contents. | |||
| 522 | clean up your ``DL_DIR`` directory by deleting any Git or other | 522 | clean up your ``DL_DIR`` directory by deleting any Git or other |
| 523 | source control work directories. | 523 | source control work directories. |
| 524 | 524 | ||
| 525 | BB_NUMBER_THREADS | 525 | :term:`BB_NUMBER_THREADS` |
| 526 | The maximum number of tasks BitBake should run in parallel at any one | 526 | The maximum number of tasks BitBake should run in parallel at any one |
| 527 | time. The OpenEmbedded build system automatically configures this | 527 | time. The OpenEmbedded build system automatically configures this |
| 528 | variable to be equal to the number of cores on the build system. For | 528 | variable to be equal to the number of cores on the build system. For |
| @@ -540,7 +540,7 @@ system and gives an overview of their function and contents. | |||
| 540 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" | 540 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" |
| 541 | section in the Yocto Project Development Tasks Manual. | 541 | section in the Yocto Project Development Tasks Manual. |
| 542 | 542 | ||
| 543 | BB_SERVER_TIMEOUT | 543 | :term:`BB_SERVER_TIMEOUT` |
| 544 | Specifies the time (in seconds) after which to unload the BitBake | 544 | Specifies the time (in seconds) after which to unload the BitBake |
| 545 | server due to inactivity. Set ``BB_SERVER_TIMEOUT`` to determine how | 545 | server due to inactivity. Set ``BB_SERVER_TIMEOUT`` to determine how |
| 546 | long the BitBake server stays resident between invocations. | 546 | long the BitBake server stays resident between invocations. |
| @@ -554,7 +554,7 @@ system and gives an overview of their function and contents. | |||
| 554 | If you want the server to never be unloaded, | 554 | If you want the server to never be unloaded, |
| 555 | set ``BB_SERVER_TIMEOUT`` to "-1". | 555 | set ``BB_SERVER_TIMEOUT`` to "-1". |
| 556 | 556 | ||
| 557 | BBCLASSEXTEND | 557 | :term:`BBCLASSEXTEND` |
| 558 | Allows you to extend a recipe so that it builds variants of the | 558 | Allows you to extend a recipe so that it builds variants of the |
| 559 | software. Common variants for recipes exist such as "natives" like | 559 | software. Common variants for recipes exist such as "natives" like |
| 560 | ``quilt-native``, which is a copy of Quilt built to run on the build | 560 | ``quilt-native``, which is a copy of Quilt built to run on the build |
| @@ -585,18 +585,18 @@ system and gives an overview of their function and contents. | |||
| 585 | since ``include`` statements are processed when the recipe is | 585 | since ``include`` statements are processed when the recipe is |
| 586 | parsed. | 586 | parsed. |
| 587 | 587 | ||
| 588 | BBFILE_COLLECTIONS | 588 | :term:`BBFILE_COLLECTIONS` |
| 589 | Lists the names of configured layers. These names are used to find | 589 | Lists the names of configured layers. These names are used to find |
| 590 | the other ``BBFILE_*`` variables. Typically, each layer will append | 590 | the other ``BBFILE_*`` variables. Typically, each layer will append |
| 591 | its name to this variable in its ``conf/layer.conf`` file. | 591 | its name to this variable in its ``conf/layer.conf`` file. |
| 592 | 592 | ||
| 593 | BBFILE_PATTERN | 593 | :term:`BBFILE_PATTERN` |
| 594 | Variable that expands to match files from | 594 | Variable that expands to match files from |
| 595 | :term:`BBFILES` in a particular layer. This variable | 595 | :term:`BBFILES` in a particular layer. This variable |
| 596 | is used in the ``conf/layer.conf`` file and must be suffixed with the | 596 | is used in the ``conf/layer.conf`` file and must be suffixed with the |
| 597 | name of the specific layer (e.g. ``BBFILE_PATTERN_emenlow``). | 597 | name of the specific layer (e.g. ``BBFILE_PATTERN_emenlow``). |
| 598 | 598 | ||
| 599 | BBFILE_PRIORITY | 599 | :term:`BBFILE_PRIORITY` |
| 600 | Assigns the priority for recipe files in each layer. | 600 | Assigns the priority for recipe files in each layer. |
| 601 | 601 | ||
| 602 | This variable is useful in situations where the same recipe appears | 602 | This variable is useful in situations where the same recipe appears |
| @@ -623,7 +623,7 @@ system and gives an overview of their function and contents. | |||
| 623 | bitbake-layers show-layers | 623 | bitbake-layers show-layers |
| 624 | to list all configured layers along with their priorities. | 624 | to list all configured layers along with their priorities. |
| 625 | 625 | ||
| 626 | BBFILES | 626 | :term:`BBFILES` |
| 627 | A space-separated list of recipe files BitBake uses to build | 627 | A space-separated list of recipe files BitBake uses to build |
| 628 | software. | 628 | software. |
| 629 | 629 | ||
| @@ -632,7 +632,7 @@ system and gives an overview of their function and contents. | |||
| 632 | For details on the syntax, see the documentation by following the | 632 | For details on the syntax, see the documentation by following the |
| 633 | previous link. | 633 | previous link. |
| 634 | 634 | ||
| 635 | BBFILES_DYNAMIC | 635 | :term:`BBFILES_DYNAMIC` |
| 636 | Activates content when identified layers are present. You identify | 636 | Activates content when identified layers are present. You identify |
| 637 | the layers by the collections that the layers define. | 637 | the layers by the collections that the layers define. |
| 638 | 638 | ||
| @@ -659,16 +659,16 @@ system and gives an overview of their function and contents. | |||
| 659 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend | 659 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend |
| 660 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend | 660 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend |
| 661 | 661 | ||
| 662 | BBINCLUDELOGS | 662 | :term:`BBINCLUDELOGS` |
| 663 | Variable that controls how BitBake displays logs on build failure. | 663 | Variable that controls how BitBake displays logs on build failure. |
| 664 | 664 | ||
| 665 | BBINCLUDELOGS_LINES | 665 | :term:`BBINCLUDELOGS_LINES` |
| 666 | If :term:`BBINCLUDELOGS` is set, specifies the | 666 | If :term:`BBINCLUDELOGS` is set, specifies the |
| 667 | maximum number of lines from the task log file to print when | 667 | maximum number of lines from the task log file to print when |
| 668 | reporting a failed task. If you do not set ``BBINCLUDELOGS_LINES``, | 668 | reporting a failed task. If you do not set ``BBINCLUDELOGS_LINES``, |
| 669 | the entire log is printed. | 669 | the entire log is printed. |
| 670 | 670 | ||
| 671 | BBLAYERS | 671 | :term:`BBLAYERS` |
| 672 | Lists the layers to enable during the build. This variable is defined | 672 | Lists the layers to enable during the build. This variable is defined |
| 673 | in the ``bblayers.conf`` configuration file in the :term:`Build Directory`. | 673 | in the ``bblayers.conf`` configuration file in the :term:`Build Directory`. |
| 674 | Here is an example: | 674 | Here is an example: |
| @@ -683,7 +683,7 @@ system and gives an overview of their function and contents. | |||
| 683 | This example enables four layers, one of which is a custom, | 683 | This example enables four layers, one of which is a custom, |
| 684 | user-defined layer named ``meta-mykernel``. | 684 | user-defined layer named ``meta-mykernel``. |
| 685 | 685 | ||
| 686 | BBMASK | 686 | :term:`BBMASK` |
| 687 | Prevents BitBake from processing recipes and recipe append files. | 687 | Prevents BitBake from processing recipes and recipe append files. |
| 688 | 688 | ||
| 689 | You can use the ``BBMASK`` variable to "hide" these ``.bb`` and | 689 | You can use the ``BBMASK`` variable to "hide" these ``.bb`` and |
| @@ -720,7 +720,7 @@ system and gives an overview of their function and contents. | |||
| 720 | When specifying a directory name, use the trailing slash character | 720 | When specifying a directory name, use the trailing slash character |
| 721 | to ensure you match just that directory name. | 721 | to ensure you match just that directory name. |
| 722 | 722 | ||
| 723 | BBMULTICONFIG | 723 | :term:`BBMULTICONFIG` |
| 724 | Specifies each additional separate configuration when you are | 724 | Specifies each additional separate configuration when you are |
| 725 | building targets with multiple configurations. Use this variable in | 725 | building targets with multiple configurations. Use this variable in |
| 726 | your ``conf/local.conf`` configuration file. Specify a | 726 | your ``conf/local.conf`` configuration file. Specify a |
| @@ -740,7 +740,7 @@ system and gives an overview of their function and contents. | |||
| 740 | ":ref:`dev-building-images-for-multiple-targets-using-multiple-configurations`" | 740 | ":ref:`dev-building-images-for-multiple-targets-using-multiple-configurations`" |
| 741 | section in the Yocto Project Development Tasks Manual. | 741 | section in the Yocto Project Development Tasks Manual. |
| 742 | 742 | ||
| 743 | BBPATH | 743 | :term:`BBPATH` |
| 744 | Used by BitBake to locate ``.bbclass`` and configuration files. This | 744 | Used by BitBake to locate ``.bbclass`` and configuration files. This |
| 745 | variable is analogous to the ``PATH`` variable. | 745 | variable is analogous to the ``PATH`` variable. |
| 746 | 746 | ||
| @@ -759,7 +759,7 @@ system and gives an overview of their function and contents. | |||
| 759 | $ bitbake target | 759 | $ bitbake target |
| 760 | 760 | ||
| 761 | 761 | ||
| 762 | BBSERVER | 762 | :term:`BBSERVER` |
| 763 | If defined in the BitBake environment, ``BBSERVER`` points to the | 763 | If defined in the BitBake environment, ``BBSERVER`` points to the |
| 764 | BitBake remote server. | 764 | BitBake remote server. |
| 765 | 765 | ||
| @@ -774,7 +774,7 @@ system and gives an overview of their function and contents. | |||
| 774 | Consequently, ``BBSERVER`` is excluded from checksum and dependency | 774 | Consequently, ``BBSERVER`` is excluded from checksum and dependency |
| 775 | data. | 775 | data. |
| 776 | 776 | ||
| 777 | BINCONFIG | 777 | :term:`BINCONFIG` |
| 778 | When inheriting the | 778 | When inheriting the |
| 779 | :ref:`binconfig-disabled <ref-classes-binconfig-disabled>` class, | 779 | :ref:`binconfig-disabled <ref-classes-binconfig-disabled>` class, |
| 780 | this variable specifies binary configuration scripts to disable in | 780 | this variable specifies binary configuration scripts to disable in |
| @@ -789,7 +789,7 @@ system and gives an overview of their function and contents. | |||
| 789 | 789 | ||
| 790 | BINCONFIG = "${bindir}/libpng-config ${bindir}/libpng16-config" | 790 | BINCONFIG = "${bindir}/libpng-config ${bindir}/libpng16-config" |
| 791 | 791 | ||
| 792 | BINCONFIG_GLOB | 792 | :term:`BINCONFIG_GLOB` |
| 793 | When inheriting the :ref:`binconfig <ref-classes-binconfig>` class, | 793 | When inheriting the :ref:`binconfig <ref-classes-binconfig>` class, |
| 794 | this variable specifies a wildcard for configuration scripts that | 794 | this variable specifies a wildcard for configuration scripts that |
| 795 | need editing. The scripts are edited to correct any paths that have | 795 | need editing. The scripts are edited to correct any paths that have |
| @@ -816,7 +816,7 @@ system and gives an overview of their function and contents. | |||
| 816 | information on the class in the | 816 | information on the class in the |
| 817 | ":ref:`binconfig.bbclass <ref-classes-binconfig>`" section. | 817 | ":ref:`binconfig.bbclass <ref-classes-binconfig>`" section. |
| 818 | 818 | ||
| 819 | BP | 819 | :term:`BP` |
| 820 | The base recipe name and version but without any special recipe name | 820 | The base recipe name and version but without any special recipe name |
| 821 | suffix (i.e. ``-native``, ``lib64-``, and so forth). ``BP`` is | 821 | suffix (i.e. ``-native``, ``lib64-``, and so forth). ``BP`` is |
| 822 | comprised of the following: | 822 | comprised of the following: |
| @@ -824,7 +824,7 @@ system and gives an overview of their function and contents. | |||
| 824 | 824 | ||
| 825 | ${BPN}-${PV} | 825 | ${BPN}-${PV} |
| 826 | 826 | ||
| 827 | BPN | 827 | :term:`BPN` |
| 828 | This variable is a version of the :term:`PN` variable with | 828 | This variable is a version of the :term:`PN` variable with |
| 829 | common prefixes and suffixes removed, such as ``nativesdk-``, | 829 | common prefixes and suffixes removed, such as ``nativesdk-``, |
| 830 | ``-cross``, ``-native``, and multilib's ``lib64-`` and ``lib32-``. | 830 | ``-cross``, ``-native``, and multilib's ``lib64-`` and ``lib32-``. |
| @@ -833,73 +833,73 @@ system and gives an overview of their function and contents. | |||
| 833 | :term:`SPECIAL_PKGSUFFIX` variables, | 833 | :term:`SPECIAL_PKGSUFFIX` variables, |
| 834 | respectively. | 834 | respectively. |
| 835 | 835 | ||
| 836 | BUGTRACKER | 836 | :term:`BUGTRACKER` |
| 837 | Specifies a URL for an upstream bug tracking website for a recipe. | 837 | Specifies a URL for an upstream bug tracking website for a recipe. |
| 838 | The OpenEmbedded build system does not use this variable. Rather, the | 838 | The OpenEmbedded build system does not use this variable. Rather, the |
| 839 | variable is a useful pointer in case a bug in the software being | 839 | variable is a useful pointer in case a bug in the software being |
| 840 | built needs to be manually reported. | 840 | built needs to be manually reported. |
| 841 | 841 | ||
| 842 | BUILD_ARCH | 842 | :term:`BUILD_ARCH` |
| 843 | Specifies the architecture of the build host (e.g. ``i686``). The | 843 | Specifies the architecture of the build host (e.g. ``i686``). The |
| 844 | OpenEmbedded build system sets the value of ``BUILD_ARCH`` from the | 844 | OpenEmbedded build system sets the value of ``BUILD_ARCH`` from the |
| 845 | machine name reported by the ``uname`` command. | 845 | machine name reported by the ``uname`` command. |
| 846 | 846 | ||
| 847 | BUILD_AS_ARCH | 847 | :term:`BUILD_AS_ARCH` |
| 848 | Specifies the architecture-specific assembler flags for the build | 848 | Specifies the architecture-specific assembler flags for the build |
| 849 | host. By default, the value of ``BUILD_AS_ARCH`` is empty. | 849 | host. By default, the value of ``BUILD_AS_ARCH`` is empty. |
| 850 | 850 | ||
| 851 | BUILD_CC_ARCH | 851 | :term:`BUILD_CC_ARCH` |
| 852 | Specifies the architecture-specific C compiler flags for the build | 852 | Specifies the architecture-specific C compiler flags for the build |
| 853 | host. By default, the value of ``BUILD_CC_ARCH`` is empty. | 853 | host. By default, the value of ``BUILD_CC_ARCH`` is empty. |
| 854 | 854 | ||
| 855 | BUILD_CCLD | 855 | :term:`BUILD_CCLD` |
| 856 | Specifies the linker command to be used for the build host when the C | 856 | Specifies the linker command to be used for the build host when the C |
| 857 | compiler is being used as the linker. By default, ``BUILD_CCLD`` | 857 | compiler is being used as the linker. By default, ``BUILD_CCLD`` |
| 858 | points to GCC and passes as arguments the value of | 858 | points to GCC and passes as arguments the value of |
| 859 | :term:`BUILD_CC_ARCH`, assuming | 859 | :term:`BUILD_CC_ARCH`, assuming |
| 860 | ``BUILD_CC_ARCH`` is set. | 860 | ``BUILD_CC_ARCH`` is set. |
| 861 | 861 | ||
| 862 | BUILD_CFLAGS | 862 | :term:`BUILD_CFLAGS` |
| 863 | Specifies the flags to pass to the C compiler when building for the | 863 | Specifies the flags to pass to the C compiler when building for the |
| 864 | build host. When building in the ``-native`` context, | 864 | build host. When building in the ``-native`` context, |
| 865 | :term:`CFLAGS` is set to the value of this variable by | 865 | :term:`CFLAGS` is set to the value of this variable by |
| 866 | default. | 866 | default. |
| 867 | 867 | ||
| 868 | BUILD_CPPFLAGS | 868 | :term:`BUILD_CPPFLAGS` |
| 869 | Specifies the flags to pass to the C preprocessor (i.e. to both the C | 869 | Specifies the flags to pass to the C preprocessor (i.e. to both the C |
| 870 | and the C++ compilers) when building for the build host. When | 870 | and the C++ compilers) when building for the build host. When |
| 871 | building in the ``-native`` context, :term:`CPPFLAGS` | 871 | building in the ``-native`` context, :term:`CPPFLAGS` |
| 872 | is set to the value of this variable by default. | 872 | is set to the value of this variable by default. |
| 873 | 873 | ||
| 874 | BUILD_CXXFLAGS | 874 | :term:`BUILD_CXXFLAGS` |
| 875 | Specifies the flags to pass to the C++ compiler when building for the | 875 | Specifies the flags to pass to the C++ compiler when building for the |
| 876 | build host. When building in the ``-native`` context, | 876 | build host. When building in the ``-native`` context, |
| 877 | :term:`CXXFLAGS` is set to the value of this variable | 877 | :term:`CXXFLAGS` is set to the value of this variable |
| 878 | by default. | 878 | by default. |
| 879 | 879 | ||
| 880 | BUILD_FC | 880 | :term:`BUILD_FC` |
| 881 | Specifies the Fortran compiler command for the build host. By | 881 | Specifies the Fortran compiler command for the build host. By |
| 882 | default, ``BUILD_FC`` points to Gfortran and passes as arguments the | 882 | default, ``BUILD_FC`` points to Gfortran and passes as arguments the |
| 883 | value of :term:`BUILD_CC_ARCH`, assuming | 883 | value of :term:`BUILD_CC_ARCH`, assuming |
| 884 | ``BUILD_CC_ARCH`` is set. | 884 | ``BUILD_CC_ARCH`` is set. |
| 885 | 885 | ||
| 886 | BUILD_LD | 886 | :term:`BUILD_LD` |
| 887 | Specifies the linker command for the build host. By default, | 887 | Specifies the linker command for the build host. By default, |
| 888 | ``BUILD_LD`` points to the GNU linker (ld) and passes as arguments | 888 | ``BUILD_LD`` points to the GNU linker (ld) and passes as arguments |
| 889 | the value of :term:`BUILD_LD_ARCH`, assuming | 889 | the value of :term:`BUILD_LD_ARCH`, assuming |
| 890 | ``BUILD_LD_ARCH`` is set. | 890 | ``BUILD_LD_ARCH`` is set. |
| 891 | 891 | ||
| 892 | BUILD_LD_ARCH | 892 | :term:`BUILD_LD_ARCH` |
| 893 | Specifies architecture-specific linker flags for the build host. By | 893 | Specifies architecture-specific linker flags for the build host. By |
| 894 | default, the value of ``BUILD_LD_ARCH`` is empty. | 894 | default, the value of ``BUILD_LD_ARCH`` is empty. |
| 895 | 895 | ||
| 896 | BUILD_LDFLAGS | 896 | :term:`BUILD_LDFLAGS` |
| 897 | Specifies the flags to pass to the linker when building for the build | 897 | Specifies the flags to pass to the linker when building for the build |
| 898 | host. When building in the ``-native`` context, | 898 | host. When building in the ``-native`` context, |
| 899 | :term:`LDFLAGS` is set to the value of this variable | 899 | :term:`LDFLAGS` is set to the value of this variable |
| 900 | by default. | 900 | by default. |
| 901 | 901 | ||
| 902 | BUILD_OPTIMIZATION | 902 | :term:`BUILD_OPTIMIZATION` |
| 903 | Specifies the optimization flags passed to the C compiler when | 903 | Specifies the optimization flags passed to the C compiler when |
| 904 | building for the build host or the SDK. The flags are passed through | 904 | building for the build host or the SDK. The flags are passed through |
| 905 | the :term:`BUILD_CFLAGS` and | 905 | the :term:`BUILD_CFLAGS` and |
| @@ -908,25 +908,25 @@ system and gives an overview of their function and contents. | |||
| 908 | The default value of the ``BUILD_OPTIMIZATION`` variable is "-O2 | 908 | The default value of the ``BUILD_OPTIMIZATION`` variable is "-O2 |
| 909 | -pipe". | 909 | -pipe". |
| 910 | 910 | ||
| 911 | BUILD_OS | 911 | :term:`BUILD_OS` |
| 912 | Specifies the operating system in use on the build host (e.g. | 912 | Specifies the operating system in use on the build host (e.g. |
| 913 | "linux"). The OpenEmbedded build system sets the value of | 913 | "linux"). The OpenEmbedded build system sets the value of |
| 914 | ``BUILD_OS`` from the OS reported by the ``uname`` command - the | 914 | ``BUILD_OS`` from the OS reported by the ``uname`` command - the |
| 915 | first word, converted to lower-case characters. | 915 | first word, converted to lower-case characters. |
| 916 | 916 | ||
| 917 | BUILD_PREFIX | 917 | :term:`BUILD_PREFIX` |
| 918 | The toolchain binary prefix used for native recipes. The OpenEmbedded | 918 | The toolchain binary prefix used for native recipes. The OpenEmbedded |
| 919 | build system uses the ``BUILD_PREFIX`` value to set the | 919 | build system uses the ``BUILD_PREFIX`` value to set the |
| 920 | :term:`TARGET_PREFIX` when building for | 920 | :term:`TARGET_PREFIX` when building for |
| 921 | ``native`` recipes. | 921 | ``native`` recipes. |
| 922 | 922 | ||
| 923 | BUILD_STRIP | 923 | :term:`BUILD_STRIP` |
| 924 | Specifies the command to be used to strip debugging symbols from | 924 | Specifies the command to be used to strip debugging symbols from |
| 925 | binaries produced for the build host. By default, ``BUILD_STRIP`` | 925 | binaries produced for the build host. By default, ``BUILD_STRIP`` |
| 926 | points to | 926 | points to |
| 927 | ``${``\ :term:`BUILD_PREFIX`\ ``}strip``. | 927 | ``${``\ :term:`BUILD_PREFIX`\ ``}strip``. |
| 928 | 928 | ||
| 929 | BUILD_SYS | 929 | :term:`BUILD_SYS` |
| 930 | Specifies the system, including the architecture and the operating | 930 | Specifies the system, including the architecture and the operating |
| 931 | system, to use when building for the build host (i.e. when building | 931 | system, to use when building for the build host (i.e. when building |
| 932 | ``native`` recipes). | 932 | ``native`` recipes). |
| @@ -937,11 +937,11 @@ system and gives an overview of their function and contents. | |||
| 937 | :term:`BUILD_OS`. You do not need to set the | 937 | :term:`BUILD_OS`. You do not need to set the |
| 938 | ``BUILD_SYS`` variable yourself. | 938 | ``BUILD_SYS`` variable yourself. |
| 939 | 939 | ||
| 940 | BUILD_VENDOR | 940 | :term:`BUILD_VENDOR` |
| 941 | Specifies the vendor name to use when building for the build host. | 941 | Specifies the vendor name to use when building for the build host. |
| 942 | The default value is an empty string (""). | 942 | The default value is an empty string (""). |
| 943 | 943 | ||
| 944 | BUILDDIR | 944 | :term:`BUILDDIR` |
| 945 | Points to the location of the :term:`Build Directory`. | 945 | Points to the location of the :term:`Build Directory`. |
| 946 | You can define this directory indirectly through the | 946 | You can define this directory indirectly through the |
| 947 | ````` <#structure-core-script>`__ script by passing in a Build | 947 | ````` <#structure-core-script>`__ script by passing in a Build |
| @@ -949,7 +949,7 @@ system and gives an overview of their function and contents. | |||
| 949 | not provide a Build Directory path, the ``BUILDDIR`` defaults to | 949 | not provide a Build Directory path, the ``BUILDDIR`` defaults to |
| 950 | ``build`` in the current directory. | 950 | ``build`` in the current directory. |
| 951 | 951 | ||
| 952 | BUILDHISTORY_COMMIT | 952 | :term:`BUILDHISTORY_COMMIT` |
| 953 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 953 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 954 | class, this variable specifies whether or not to commit the build | 954 | class, this variable specifies whether or not to commit the build |
| 955 | history output in a local Git repository. If set to "1", this local | 955 | history output in a local Git repository. If set to "1", this local |
| @@ -965,7 +965,7 @@ system and gives an overview of their function and contents. | |||
| 965 | 965 | ||
| 966 | BUILDHISTORY_COMMIT ?= "0" | 966 | BUILDHISTORY_COMMIT ?= "0" |
| 967 | 967 | ||
| 968 | BUILDHISTORY_COMMIT_AUTHOR | 968 | :term:`BUILDHISTORY_COMMIT_AUTHOR` |
| 969 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 969 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 970 | class, this variable specifies the author to use for each Git commit. | 970 | class, this variable specifies the author to use for each Git commit. |
| 971 | In order for the ``BUILDHISTORY_COMMIT_AUTHOR`` variable to work, the | 971 | In order for the ``BUILDHISTORY_COMMIT_AUTHOR`` variable to work, the |
| @@ -982,7 +982,7 @@ system and gives an overview of their function and contents. | |||
| 982 | 982 | ||
| 983 | BUILDHISTORY_COMMIT_AUTHOR ?= "buildhistory <buildhistory@${DISTRO}>" | 983 | BUILDHISTORY_COMMIT_AUTHOR ?= "buildhistory <buildhistory@${DISTRO}>" |
| 984 | 984 | ||
| 985 | BUILDHISTORY_DIR | 985 | :term:`BUILDHISTORY_DIR` |
| 986 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 986 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 987 | class, this variable specifies the directory in which build history | 987 | class, this variable specifies the directory in which build history |
| 988 | information is kept. For more information on how the variable works, | 988 | information is kept. For more information on how the variable works, |
| @@ -993,7 +993,7 @@ system and gives an overview of their function and contents. | |||
| 993 | 993 | ||
| 994 | BUILDHISTORY_DIR ?= "${TOPDIR}/buildhistory" | 994 | BUILDHISTORY_DIR ?= "${TOPDIR}/buildhistory" |
| 995 | 995 | ||
| 996 | BUILDHISTORY_FEATURES | 996 | :term:`BUILDHISTORY_FEATURES` |
| 997 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 997 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 998 | class, this variable specifies the build history features to be | 998 | class, this variable specifies the build history features to be |
| 999 | enabled. For more information on how build history works, see the | 999 | enabled. For more information on how build history works, see the |
| @@ -1022,7 +1022,7 @@ system and gives an overview of their function and contents. | |||
| 1022 | 1022 | ||
| 1023 | BUILDHISTORY_FEATURES ?= "image package sdk" | 1023 | BUILDHISTORY_FEATURES ?= "image package sdk" |
| 1024 | 1024 | ||
| 1025 | BUILDHISTORY_IMAGE_FILES | 1025 | :term:`BUILDHISTORY_IMAGE_FILES` |
| 1026 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 1026 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 1027 | class, this variable specifies a list of paths to files copied from | 1027 | class, this variable specifies a list of paths to files copied from |
| 1028 | the image contents into the build history directory under an | 1028 | the image contents into the build history directory under an |
| @@ -1039,7 +1039,7 @@ system and gives an overview of their function and contents. | |||
| 1039 | 1039 | ||
| 1040 | BUILDHISTORY_IMAGE_FILES ?= "/etc/passwd /etc/group" | 1040 | BUILDHISTORY_IMAGE_FILES ?= "/etc/passwd /etc/group" |
| 1041 | 1041 | ||
| 1042 | BUILDHISTORY_PUSH_REPO | 1042 | :term:`BUILDHISTORY_PUSH_REPO` |
| 1043 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` | 1043 | When inheriting the :ref:`buildhistory <ref-classes-buildhistory>` |
| 1044 | class, this variable optionally specifies a remote repository to | 1044 | class, this variable optionally specifies a remote repository to |
| 1045 | which build history pushes Git changes. In order for | 1045 | which build history pushes Git changes. In order for |
| @@ -1057,38 +1057,38 @@ system and gives an overview of their function and contents. | |||
| 1057 | 1057 | ||
| 1058 | BUILDHISTORY_PUSH_REPO ?= "" | 1058 | BUILDHISTORY_PUSH_REPO ?= "" |
| 1059 | 1059 | ||
| 1060 | BUILDSDK_CFLAGS | 1060 | :term:`BUILDSDK_CFLAGS` |
| 1061 | Specifies the flags to pass to the C compiler when building for the | 1061 | Specifies the flags to pass to the C compiler when building for the |
| 1062 | SDK. When building in the ``nativesdk-`` context, | 1062 | SDK. When building in the ``nativesdk-`` context, |
| 1063 | :term:`CFLAGS` is set to the value of this variable by | 1063 | :term:`CFLAGS` is set to the value of this variable by |
| 1064 | default. | 1064 | default. |
| 1065 | 1065 | ||
| 1066 | BUILDSDK_CPPFLAGS | 1066 | :term:`BUILDSDK_CPPFLAGS` |
| 1067 | Specifies the flags to pass to the C pre-processor (i.e. to both the | 1067 | Specifies the flags to pass to the C pre-processor (i.e. to both the |
| 1068 | C and the C++ compilers) when building for the SDK. When building in | 1068 | C and the C++ compilers) when building for the SDK. When building in |
| 1069 | the ``nativesdk-`` context, :term:`CPPFLAGS` is set | 1069 | the ``nativesdk-`` context, :term:`CPPFLAGS` is set |
| 1070 | to the value of this variable by default. | 1070 | to the value of this variable by default. |
| 1071 | 1071 | ||
| 1072 | BUILDSDK_CXXFLAGS | 1072 | :term:`BUILDSDK_CXXFLAGS` |
| 1073 | Specifies the flags to pass to the C++ compiler when building for the | 1073 | Specifies the flags to pass to the C++ compiler when building for the |
| 1074 | SDK. When building in the ``nativesdk-`` context, | 1074 | SDK. When building in the ``nativesdk-`` context, |
| 1075 | :term:`CXXFLAGS` is set to the value of this variable | 1075 | :term:`CXXFLAGS` is set to the value of this variable |
| 1076 | by default. | 1076 | by default. |
| 1077 | 1077 | ||
| 1078 | BUILDSDK_LDFLAGS | 1078 | :term:`BUILDSDK_LDFLAGS` |
| 1079 | Specifies the flags to pass to the linker when building for the SDK. | 1079 | Specifies the flags to pass to the linker when building for the SDK. |
| 1080 | When building in the ``nativesdk-`` context, | 1080 | When building in the ``nativesdk-`` context, |
| 1081 | :term:`LDFLAGS` is set to the value of this variable | 1081 | :term:`LDFLAGS` is set to the value of this variable |
| 1082 | by default. | 1082 | by default. |
| 1083 | 1083 | ||
| 1084 | BUILDSTATS_BASE | 1084 | :term:`BUILDSTATS_BASE` |
| 1085 | Points to the location of the directory that holds build statistics | 1085 | Points to the location of the directory that holds build statistics |
| 1086 | when you use and enable the | 1086 | when you use and enable the |
| 1087 | :ref:`buildstats <ref-classes-buildstats>` class. The | 1087 | :ref:`buildstats <ref-classes-buildstats>` class. The |
| 1088 | ``BUILDSTATS_BASE`` directory defaults to | 1088 | ``BUILDSTATS_BASE`` directory defaults to |
| 1089 | ``${``\ :term:`TMPDIR`\ ``}/buildstats/``. | 1089 | ``${``\ :term:`TMPDIR`\ ``}/buildstats/``. |
| 1090 | 1090 | ||
| 1091 | BUSYBOX_SPLIT_SUID | 1091 | :term:`BUSYBOX_SPLIT_SUID` |
| 1092 | For the BusyBox recipe, specifies whether to split the output | 1092 | For the BusyBox recipe, specifies whether to split the output |
| 1093 | executable file into two parts: one for features that require | 1093 | executable file into two parts: one for features that require |
| 1094 | ``setuid root``, and one for the remaining features (i.e. those that | 1094 | ``setuid root``, and one for the remaining features (i.e. those that |
| @@ -1098,15 +1098,15 @@ system and gives an overview of their function and contents. | |||
| 1098 | splitting the output executable file. Set the variable to "0" to get | 1098 | splitting the output executable file. Set the variable to "0" to get |
| 1099 | a single output executable file. | 1099 | a single output executable file. |
| 1100 | 1100 | ||
| 1101 | CACHE | 1101 | :term:`CACHE` |
| 1102 | Specifies the directory BitBake uses to store a cache of the | 1102 | Specifies the directory BitBake uses to store a cache of the |
| 1103 | :term:`Metadata` so it does not need to be parsed every time | 1103 | :term:`Metadata` so it does not need to be parsed every time |
| 1104 | BitBake is started. | 1104 | BitBake is started. |
| 1105 | 1105 | ||
| 1106 | CC | 1106 | :term:`CC` |
| 1107 | The minimal command and arguments used to run the C compiler. | 1107 | The minimal command and arguments used to run the C compiler. |
| 1108 | 1108 | ||
| 1109 | CFLAGS | 1109 | :term:`CFLAGS` |
| 1110 | Specifies the flags to pass to the C compiler. This variable is | 1110 | Specifies the flags to pass to the C compiler. This variable is |
| 1111 | exported to an environment variable and thus made visible to the | 1111 | exported to an environment variable and thus made visible to the |
| 1112 | software being built during the compilation step. | 1112 | software being built during the compilation step. |
| @@ -1123,7 +1123,7 @@ system and gives an overview of their function and contents. | |||
| 1123 | - :term:`BUILDSDK_CFLAGS` when building for | 1123 | - :term:`BUILDSDK_CFLAGS` when building for |
| 1124 | an SDK (i.e. ``nativesdk-``) | 1124 | an SDK (i.e. ``nativesdk-``) |
| 1125 | 1125 | ||
| 1126 | CLASSOVERRIDE | 1126 | :term:`CLASSOVERRIDE` |
| 1127 | An internal variable specifying the special class override that | 1127 | An internal variable specifying the special class override that |
| 1128 | should currently apply (e.g. "class-target", "class-native", and so | 1128 | should currently apply (e.g. "class-target", "class-native", and so |
| 1129 | forth). The classes that use this variable (e.g. | 1129 | forth). The classes that use this variable (e.g. |
| @@ -1158,14 +1158,14 @@ system and gives an overview of their function and contents. | |||
| 1158 | that it is included in the default value of | 1158 | that it is included in the default value of |
| 1159 | :term:`OVERRIDES`. | 1159 | :term:`OVERRIDES`. |
| 1160 | 1160 | ||
| 1161 | CLEANBROKEN | 1161 | :term:`CLEANBROKEN` |
| 1162 | If set to "1" within a recipe, ``CLEANBROKEN`` specifies that the | 1162 | If set to "1" within a recipe, ``CLEANBROKEN`` specifies that the |
| 1163 | ``make clean`` command does not work for the software being built. | 1163 | ``make clean`` command does not work for the software being built. |
| 1164 | Consequently, the OpenEmbedded build system will not try to run | 1164 | Consequently, the OpenEmbedded build system will not try to run |
| 1165 | ``make clean`` during the :ref:`ref-tasks-configure` | 1165 | ``make clean`` during the :ref:`ref-tasks-configure` |
| 1166 | task, which is the default behavior. | 1166 | task, which is the default behavior. |
| 1167 | 1167 | ||
| 1168 | COMBINED_FEATURES | 1168 | :term:`COMBINED_FEATURES` |
| 1169 | Provides a list of hardware features that are enabled in both | 1169 | Provides a list of hardware features that are enabled in both |
| 1170 | :term:`MACHINE_FEATURES` and | 1170 | :term:`MACHINE_FEATURES` and |
| 1171 | :term:`DISTRO_FEATURES`. This select list of | 1171 | :term:`DISTRO_FEATURES`. This select list of |
| @@ -1175,12 +1175,12 @@ system and gives an overview of their function and contents. | |||
| 1175 | optional at the distribution level, in case the hardware supports | 1175 | optional at the distribution level, in case the hardware supports |
| 1176 | Bluetooth but you do not ever intend to use it. | 1176 | Bluetooth but you do not ever intend to use it. |
| 1177 | 1177 | ||
| 1178 | COMMON_LICENSE_DIR | 1178 | :term:`COMMON_LICENSE_DIR` |
| 1179 | Points to ``meta/files/common-licenses`` in the | 1179 | Points to ``meta/files/common-licenses`` in the |
| 1180 | :term:`Source Directory`, which is where generic license | 1180 | :term:`Source Directory`, which is where generic license |
| 1181 | files reside. | 1181 | files reside. |
| 1182 | 1182 | ||
| 1183 | COMPATIBLE_HOST | 1183 | :term:`COMPATIBLE_HOST` |
| 1184 | A regular expression that resolves to one or more hosts (when the | 1184 | A regular expression that resolves to one or more hosts (when the |
| 1185 | recipe is native) or one or more targets (when the recipe is | 1185 | recipe is native) or one or more targets (when the recipe is |
| 1186 | non-native) with which a recipe is compatible. The regular expression | 1186 | non-native) with which a recipe is compatible. The regular expression |
| @@ -1191,7 +1191,7 @@ system and gives an overview of their function and contents. | |||
| 1191 | parsing speed since the build system skips parsing recipes not | 1191 | parsing speed since the build system skips parsing recipes not |
| 1192 | compatible with the current system. | 1192 | compatible with the current system. |
| 1193 | 1193 | ||
| 1194 | COMPATIBLE_MACHINE | 1194 | :term:`COMPATIBLE_MACHINE` |
| 1195 | A regular expression that resolves to one or more target machines | 1195 | A regular expression that resolves to one or more target machines |
| 1196 | with which a recipe is compatible. The regular expression is matched | 1196 | with which a recipe is compatible. The regular expression is matched |
| 1197 | against :term:`MACHINEOVERRIDES`. You can use | 1197 | against :term:`MACHINEOVERRIDES`. You can use |
| @@ -1201,7 +1201,7 @@ system and gives an overview of their function and contents. | |||
| 1201 | speed since the build system skips parsing recipes not compatible | 1201 | speed since the build system skips parsing recipes not compatible |
| 1202 | with the current machine. | 1202 | with the current machine. |
| 1203 | 1203 | ||
| 1204 | COMPLEMENTARY_GLOB | 1204 | :term:`COMPLEMENTARY_GLOB` |
| 1205 | Defines wildcards to match when installing a list of complementary | 1205 | Defines wildcards to match when installing a list of complementary |
| 1206 | packages for all the packages explicitly (or implicitly) installed in | 1206 | packages for all the packages explicitly (or implicitly) installed in |
| 1207 | an image. | 1207 | an image. |
| @@ -1230,7 +1230,7 @@ system and gives an overview of their function and contents. | |||
| 1230 | 1230 | ||
| 1231 | COMPLEMENTARY_GLOB[dev-pkgs] = '*-dev' | 1231 | COMPLEMENTARY_GLOB[dev-pkgs] = '*-dev' |
| 1232 | 1232 | ||
| 1233 | COMPONENTS_DIR | 1233 | :term:`COMPONENTS_DIR` |
| 1234 | Stores sysroot components for each recipe. The OpenEmbedded build | 1234 | Stores sysroot components for each recipe. The OpenEmbedded build |
| 1235 | system uses ``COMPONENTS_DIR`` when constructing recipe-specific | 1235 | system uses ``COMPONENTS_DIR`` when constructing recipe-specific |
| 1236 | sysroots for other recipes. | 1236 | sysroots for other recipes. |
| @@ -1240,12 +1240,12 @@ system and gives an overview of their function and contents. | |||
| 1240 | (i.e. | 1240 | (i.e. |
| 1241 | "``${``\ :term:`TMPDIR`\ ``}/sysroots-components``"). | 1241 | "``${``\ :term:`TMPDIR`\ ``}/sysroots-components``"). |
| 1242 | 1242 | ||
| 1243 | CONF_VERSION | 1243 | :term:`CONF_VERSION` |
| 1244 | Tracks the version of the local configuration file (i.e. | 1244 | Tracks the version of the local configuration file (i.e. |
| 1245 | ``local.conf``). The value for ``CONF_VERSION`` increments each time | 1245 | ``local.conf``). The value for ``CONF_VERSION`` increments each time |
| 1246 | ``build/conf/`` compatibility changes. | 1246 | ``build/conf/`` compatibility changes. |
| 1247 | 1247 | ||
| 1248 | CONFFILES | 1248 | :term:`CONFFILES` |
| 1249 | Identifies editable or configurable files that are part of a package. | 1249 | Identifies editable or configurable files that are part of a package. |
| 1250 | If the Package Management System (PMS) is being used to update | 1250 | If the Package Management System (PMS) is being used to update |
| 1251 | packages on the target system, it is possible that configuration | 1251 | packages on the target system, it is possible that configuration |
| @@ -1291,7 +1291,7 @@ system and gives an overview of their function and contents. | |||
| 1291 | Source Directory | 1291 | Source Directory |
| 1292 | . | 1292 | . |
| 1293 | 1293 | ||
| 1294 | CONFIG_INITRAMFS_SOURCE | 1294 | :term:`CONFIG_INITRAMFS_SOURCE` |
| 1295 | Identifies the initial RAM filesystem (initramfs) source files. The | 1295 | Identifies the initial RAM filesystem (initramfs) source files. The |
| 1296 | OpenEmbedded build system receives and uses this kernel Kconfig | 1296 | OpenEmbedded build system receives and uses this kernel Kconfig |
| 1297 | variable as an environment variable. By default, the variable is set | 1297 | variable as an environment variable. By default, the variable is set |
| @@ -1312,15 +1312,15 @@ system and gives an overview of their function and contents. | |||
| 1312 | ":ref:`building-an-initramfs-image`" section | 1312 | ":ref:`building-an-initramfs-image`" section |
| 1313 | in the Yocto Project Development Tasks Manual. | 1313 | in the Yocto Project Development Tasks Manual. |
| 1314 | 1314 | ||
| 1315 | CONFIG_SITE | 1315 | :term:`CONFIG_SITE` |
| 1316 | A list of files that contains ``autoconf`` test results relevant to | 1316 | A list of files that contains ``autoconf`` test results relevant to |
| 1317 | the current build. This variable is used by the Autotools utilities | 1317 | the current build. This variable is used by the Autotools utilities |
| 1318 | when running ``configure``. | 1318 | when running ``configure``. |
| 1319 | 1319 | ||
| 1320 | CONFIGURE_FLAGS | 1320 | :term:`CONFIGURE_FLAGS` |
| 1321 | The minimal arguments for GNU configure. | 1321 | The minimal arguments for GNU configure. |
| 1322 | 1322 | ||
| 1323 | CONFLICT_DISTRO_FEATURES | 1323 | :term:`CONFLICT_DISTRO_FEATURES` |
| 1324 | When inheriting the | 1324 | When inheriting the |
| 1325 | :ref:`distro_features_check <ref-classes-distro_features_check>` | 1325 | :ref:`distro_features_check <ref-classes-distro_features_check>` |
| 1326 | class, this variable identifies distribution features that would be | 1326 | class, this variable identifies distribution features that would be |
| @@ -1329,7 +1329,7 @@ system and gives an overview of their function and contents. | |||
| 1329 | appears in ``DISTRO_FEATURES`` within the current configuration, an | 1329 | appears in ``DISTRO_FEATURES`` within the current configuration, an |
| 1330 | error occurs and the build stops. | 1330 | error occurs and the build stops. |
| 1331 | 1331 | ||
| 1332 | COPYLEFT_LICENSE_EXCLUDE | 1332 | :term:`COPYLEFT_LICENSE_EXCLUDE` |
| 1333 | A space-separated list of licenses to exclude from the source | 1333 | A space-separated list of licenses to exclude from the source |
| 1334 | archived by the :ref:`archiver <ref-classes-archiver>` class. In | 1334 | archived by the :ref:`archiver <ref-classes-archiver>` class. In |
| 1335 | other words, if a license in a recipe's | 1335 | other words, if a license in a recipe's |
| @@ -1350,7 +1350,7 @@ system and gives an overview of their function and contents. | |||
| 1350 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which | 1350 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which |
| 1351 | is inherited by the ``archiver`` class. | 1351 | is inherited by the ``archiver`` class. |
| 1352 | 1352 | ||
| 1353 | COPYLEFT_LICENSE_INCLUDE | 1353 | :term:`COPYLEFT_LICENSE_INCLUDE` |
| 1354 | A space-separated list of licenses to include in the source archived | 1354 | A space-separated list of licenses to include in the source archived |
| 1355 | by the :ref:`archiver <ref-classes-archiver>` class. In other | 1355 | by the :ref:`archiver <ref-classes-archiver>` class. In other |
| 1356 | words, if a license in a recipe's :term:`LICENSE` | 1356 | words, if a license in a recipe's :term:`LICENSE` |
| @@ -1362,7 +1362,7 @@ system and gives an overview of their function and contents. | |||
| 1362 | is inherited by the ``archiver`` class. The default value includes | 1362 | is inherited by the ``archiver`` class. The default value includes |
| 1363 | "GPL*", "LGPL*", and "AGPL*". | 1363 | "GPL*", "LGPL*", and "AGPL*". |
| 1364 | 1364 | ||
| 1365 | COPYLEFT_PN_EXCLUDE | 1365 | :term:`COPYLEFT_PN_EXCLUDE` |
| 1366 | A list of recipes to exclude in the source archived by the | 1366 | A list of recipes to exclude in the source archived by the |
| 1367 | :ref:`archiver <ref-classes-archiver>` class. The | 1367 | :ref:`archiver <ref-classes-archiver>` class. The |
| 1368 | ``COPYLEFT_PN_EXCLUDE`` variable overrides the license inclusion and | 1368 | ``COPYLEFT_PN_EXCLUDE`` variable overrides the license inclusion and |
| @@ -1376,7 +1376,7 @@ system and gives an overview of their function and contents. | |||
| 1376 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which | 1376 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which |
| 1377 | is inherited by the ``archiver`` class. | 1377 | is inherited by the ``archiver`` class. |
| 1378 | 1378 | ||
| 1379 | COPYLEFT_PN_INCLUDE | 1379 | :term:`COPYLEFT_PN_INCLUDE` |
| 1380 | A list of recipes to include in the source archived by the | 1380 | A list of recipes to include in the source archived by the |
| 1381 | :ref:`archiver <ref-classes-archiver>` class. The | 1381 | :ref:`archiver <ref-classes-archiver>` class. The |
| 1382 | ``COPYLEFT_PN_INCLUDE`` variable overrides the license inclusion and | 1382 | ``COPYLEFT_PN_INCLUDE`` variable overrides the license inclusion and |
| @@ -1390,7 +1390,7 @@ system and gives an overview of their function and contents. | |||
| 1390 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which | 1390 | :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which |
| 1391 | is inherited by the ``archiver`` class. | 1391 | is inherited by the ``archiver`` class. |
| 1392 | 1392 | ||
| 1393 | COPYLEFT_RECIPE_TYPES | 1393 | :term:`COPYLEFT_RECIPE_TYPES` |
| 1394 | A space-separated list of recipe types to include in the source | 1394 | A space-separated list of recipe types to include in the source |
| 1395 | archived by the :ref:`archiver <ref-classes-archiver>` class. | 1395 | archived by the :ref:`archiver <ref-classes-archiver>` class. |
| 1396 | Recipe types are ``target``, ``native``, ``nativesdk``, ``cross``, | 1396 | Recipe types are ``target``, ``native``, ``nativesdk``, ``cross``, |
| @@ -1400,7 +1400,7 @@ system and gives an overview of their function and contents. | |||
| 1400 | is set by the :ref:`copyleft_filter <ref-classes-copyleft_filter>` | 1400 | is set by the :ref:`copyleft_filter <ref-classes-copyleft_filter>` |
| 1401 | class, which is inherited by the ``archiver`` class. | 1401 | class, which is inherited by the ``archiver`` class. |
| 1402 | 1402 | ||
| 1403 | COPY_LIC_DIRS | 1403 | :term:`COPY_LIC_DIRS` |
| 1404 | If set to "1" along with the | 1404 | If set to "1" along with the |
| 1405 | :term:`COPY_LIC_MANIFEST` variable, the | 1405 | :term:`COPY_LIC_MANIFEST` variable, the |
| 1406 | OpenEmbedded build system copies into the image the license files, | 1406 | OpenEmbedded build system copies into the image the license files, |
| @@ -1421,7 +1421,7 @@ system and gives an overview of their function and contents. | |||
| 1421 | " section in the Yocto Project Development Tasks Manual for | 1421 | " section in the Yocto Project Development Tasks Manual for |
| 1422 | information on providing license text. | 1422 | information on providing license text. |
| 1423 | 1423 | ||
| 1424 | COPY_LIC_MANIFEST | 1424 | :term:`COPY_LIC_MANIFEST` |
| 1425 | If set to "1", the OpenEmbedded build system copies the license | 1425 | If set to "1", the OpenEmbedded build system copies the license |
| 1426 | manifest for the image to | 1426 | manifest for the image to |
| 1427 | ``/usr/share/common-licenses/license.manifest`` within the image | 1427 | ``/usr/share/common-licenses/license.manifest`` within the image |
| @@ -1440,7 +1440,7 @@ system and gives an overview of their function and contents. | |||
| 1440 | " section in the Yocto Project Development Tasks Manual for | 1440 | " section in the Yocto Project Development Tasks Manual for |
| 1441 | information on providing license text. | 1441 | information on providing license text. |
| 1442 | 1442 | ||
| 1443 | CORE_IMAGE_EXTRA_INSTALL | 1443 | :term:`CORE_IMAGE_EXTRA_INSTALL` |
| 1444 | Specifies the list of packages to be added to the image. You should | 1444 | Specifies the list of packages to be added to the image. You should |
| 1445 | only set this variable in the ``local.conf`` configuration file found | 1445 | only set this variable in the ``local.conf`` configuration file found |
| 1446 | in the :term:`Build Directory`. | 1446 | in the :term:`Build Directory`. |
| @@ -1448,7 +1448,7 @@ system and gives an overview of their function and contents. | |||
| 1448 | This variable replaces ``POKY_EXTRA_INSTALL``, which is no longer | 1448 | This variable replaces ``POKY_EXTRA_INSTALL``, which is no longer |
| 1449 | supported. | 1449 | supported. |
| 1450 | 1450 | ||
| 1451 | COREBASE | 1451 | :term:`COREBASE` |
| 1452 | Specifies the parent directory of the OpenEmbedded-Core Metadata | 1452 | Specifies the parent directory of the OpenEmbedded-Core Metadata |
| 1453 | layer (i.e. ``meta``). | 1453 | layer (i.e. ``meta``). |
| 1454 | 1454 | ||
| @@ -1459,7 +1459,7 @@ system and gives an overview of their function and contents. | |||
| 1459 | points to the ``poky`` folder because it is the parent directory of | 1459 | points to the ``poky`` folder because it is the parent directory of |
| 1460 | the ``poky/meta`` layer. | 1460 | the ``poky/meta`` layer. |
| 1461 | 1461 | ||
| 1462 | COREBASE_FILES | 1462 | :term:`COREBASE_FILES` |
| 1463 | Lists files from the :term:`COREBASE` directory that | 1463 | Lists files from the :term:`COREBASE` directory that |
| 1464 | should be copied other than the layers listed in the | 1464 | should be copied other than the layers listed in the |
| 1465 | ``bblayers.conf`` file. The ``COREBASE_FILES`` variable exists for | 1465 | ``bblayers.conf`` file. The ``COREBASE_FILES`` variable exists for |
| @@ -1472,10 +1472,10 @@ system and gives an overview of their function and contents. | |||
| 1472 | of ``COREBASE_FILES`` is used in order to only copy the files that | 1472 | of ``COREBASE_FILES`` is used in order to only copy the files that |
| 1473 | are actually needed. | 1473 | are actually needed. |
| 1474 | 1474 | ||
| 1475 | CPP | 1475 | :term:`CPP` |
| 1476 | The minimal command and arguments used to run the C preprocessor. | 1476 | The minimal command and arguments used to run the C preprocessor. |
| 1477 | 1477 | ||
| 1478 | CPPFLAGS | 1478 | :term:`CPPFLAGS` |
| 1479 | Specifies the flags to pass to the C pre-processor (i.e. to both the | 1479 | Specifies the flags to pass to the C pre-processor (i.e. to both the |
| 1480 | C and the C++ compilers). This variable is exported to an environment | 1480 | C and the C++ compilers). This variable is exported to an environment |
| 1481 | variable and thus made visible to the software being built during the | 1481 | variable and thus made visible to the software being built during the |
| @@ -1493,7 +1493,7 @@ system and gives an overview of their function and contents. | |||
| 1493 | - :term:`BUILDSDK_CPPFLAGS` when building | 1493 | - :term:`BUILDSDK_CPPFLAGS` when building |
| 1494 | for an SDK (i.e. ``nativesdk-``) | 1494 | for an SDK (i.e. ``nativesdk-``) |
| 1495 | 1495 | ||
| 1496 | CROSS_COMPILE | 1496 | :term:`CROSS_COMPILE` |
| 1497 | The toolchain binary prefix for the target tools. The | 1497 | The toolchain binary prefix for the target tools. The |
| 1498 | ``CROSS_COMPILE`` variable is the same as the | 1498 | ``CROSS_COMPILE`` variable is the same as the |
| 1499 | :term:`TARGET_PREFIX` variable. | 1499 | :term:`TARGET_PREFIX` variable. |
| @@ -1505,14 +1505,14 @@ system and gives an overview of their function and contents. | |||
| 1505 | variable only in certain contexts (e.g. when building for kernel | 1505 | variable only in certain contexts (e.g. when building for kernel |
| 1506 | and kernel module recipes). | 1506 | and kernel module recipes). |
| 1507 | 1507 | ||
| 1508 | CVSDIR | 1508 | :term:`CVSDIR` |
| 1509 | The directory in which files checked out under the CVS system are | 1509 | The directory in which files checked out under the CVS system are |
| 1510 | stored. | 1510 | stored. |
| 1511 | 1511 | ||
| 1512 | CXX | 1512 | :term:`CXX` |
| 1513 | The minimal command and arguments used to run the C++ compiler. | 1513 | The minimal command and arguments used to run the C++ compiler. |
| 1514 | 1514 | ||
| 1515 | CXXFLAGS | 1515 | :term:`CXXFLAGS` |
| 1516 | Specifies the flags to pass to the C++ compiler. This variable is | 1516 | Specifies the flags to pass to the C++ compiler. This variable is |
| 1517 | exported to an environment variable and thus made visible to the | 1517 | exported to an environment variable and thus made visible to the |
| 1518 | software being built during the compilation step. | 1518 | software being built during the compilation step. |
| @@ -1529,7 +1529,7 @@ system and gives an overview of their function and contents. | |||
| 1529 | - :term:`BUILDSDK_CXXFLAGS` when building | 1529 | - :term:`BUILDSDK_CXXFLAGS` when building |
| 1530 | for an SDK (i.e. ``nativesdk-``) | 1530 | for an SDK (i.e. ``nativesdk-``) |
| 1531 | 1531 | ||
| 1532 | D | 1532 | :term:`D` |
| 1533 | The destination directory. The location in the :term:`Build Directory` | 1533 | The destination directory. The location in the :term:`Build Directory` |
| 1534 | where components are installed by the | 1534 | where components are installed by the |
| 1535 | :ref:`ref-tasks-install` task. This location defaults | 1535 | :ref:`ref-tasks-install` task. This location defaults |
| @@ -1544,15 +1544,15 @@ system and gives an overview of their function and contents. | |||
| 1544 | fakeroot | 1544 | fakeroot |
| 1545 | . | 1545 | . |
| 1546 | 1546 | ||
| 1547 | DATE | 1547 | :term:`DATE` |
| 1548 | The date the build was started. Dates appear using the year, month, | 1548 | The date the build was started. Dates appear using the year, month, |
| 1549 | and day (YMD) format (e.g. "20150209" for February 9th, 2015). | 1549 | and day (YMD) format (e.g. "20150209" for February 9th, 2015). |
| 1550 | 1550 | ||
| 1551 | DATETIME | 1551 | :term:`DATETIME` |
| 1552 | The date and time on which the current build started. The format is | 1552 | The date and time on which the current build started. The format is |
| 1553 | suitable for timestamps. | 1553 | suitable for timestamps. |
| 1554 | 1554 | ||
| 1555 | DEBIAN_NOAUTONAME | 1555 | :term:`DEBIAN_NOAUTONAME` |
| 1556 | When the :ref:`debian <ref-classes-debian>` class is inherited, | 1556 | When the :ref:`debian <ref-classes-debian>` class is inherited, |
| 1557 | which is the default behavior, ``DEBIAN_NOAUTONAME`` specifies a | 1557 | which is the default behavior, ``DEBIAN_NOAUTONAME`` specifies a |
| 1558 | particular package should not be renamed according to Debian library | 1558 | particular package should not be renamed according to Debian library |
| @@ -1562,7 +1562,7 @@ system and gives an overview of their function and contents. | |||
| 1562 | 1562 | ||
| 1563 | DEBIAN_NOAUTONAME_fontconfig-utils = "1" | 1563 | DEBIAN_NOAUTONAME_fontconfig-utils = "1" |
| 1564 | 1564 | ||
| 1565 | DEBIANNAME | 1565 | :term:`DEBIANNAME` |
| 1566 | When the :ref:`debian <ref-classes-debian>` class is inherited, | 1566 | When the :ref:`debian <ref-classes-debian>` class is inherited, |
| 1567 | which is the default behavior, ``DEBIANNAME`` allows you to override | 1567 | which is the default behavior, ``DEBIANNAME`` allows you to override |
| 1568 | the library name for an individual package. Overriding the library | 1568 | the library name for an individual package. Overriding the library |
| @@ -1573,16 +1573,16 @@ system and gives an overview of their function and contents. | |||
| 1573 | 1573 | ||
| 1574 | DEBIANNAME_${PN} = "dbus-1" | 1574 | DEBIANNAME_${PN} = "dbus-1" |
| 1575 | 1575 | ||
| 1576 | DEBUG_BUILD | 1576 | :term:`DEBUG_BUILD` |
| 1577 | Specifies to build packages with debugging information. This | 1577 | Specifies to build packages with debugging information. This |
| 1578 | influences the value of the ``SELECTED_OPTIMIZATION`` variable. | 1578 | influences the value of the ``SELECTED_OPTIMIZATION`` variable. |
| 1579 | 1579 | ||
| 1580 | DEBUG_OPTIMIZATION | 1580 | :term:`DEBUG_OPTIMIZATION` |
| 1581 | The options to pass in ``TARGET_CFLAGS`` and ``CFLAGS`` when | 1581 | The options to pass in ``TARGET_CFLAGS`` and ``CFLAGS`` when |
| 1582 | compiling a system for debugging. This variable defaults to "-O | 1582 | compiling a system for debugging. This variable defaults to "-O |
| 1583 | -fno-omit-frame-pointer ${DEBUG_FLAGS} -pipe". | 1583 | -fno-omit-frame-pointer ${DEBUG_FLAGS} -pipe". |
| 1584 | 1584 | ||
| 1585 | DEFAULT_PREFERENCE | 1585 | :term:`DEFAULT_PREFERENCE` |
| 1586 | Specifies a weak bias for recipe selection priority. | 1586 | Specifies a weak bias for recipe selection priority. |
| 1587 | 1587 | ||
| 1588 | The most common usage of this is variable is to set it to "-1" within | 1588 | The most common usage of this is variable is to set it to "-1" within |
| @@ -1600,7 +1600,7 @@ system and gives an overview of their function and contents. | |||
| 1600 | if that variable is different between two layers that contain | 1600 | if that variable is different between two layers that contain |
| 1601 | different versions of the same recipe. | 1601 | different versions of the same recipe. |
| 1602 | 1602 | ||
| 1603 | DEFAULTTUNE | 1603 | :term:`DEFAULTTUNE` |
| 1604 | The default CPU and Application Binary Interface (ABI) tunings (i.e. | 1604 | The default CPU and Application Binary Interface (ABI) tunings (i.e. |
| 1605 | the "tune") used by the OpenEmbedded build system. The | 1605 | the "tune") used by the OpenEmbedded build system. The |
| 1606 | ``DEFAULTTUNE`` helps define | 1606 | ``DEFAULTTUNE`` helps define |
| @@ -1611,7 +1611,7 @@ system and gives an overview of their function and contents. | |||
| 1611 | the setting using available tunes as defined with | 1611 | the setting using available tunes as defined with |
| 1612 | :term:`AVAILTUNES`. | 1612 | :term:`AVAILTUNES`. |
| 1613 | 1613 | ||
| 1614 | DEPENDS | 1614 | :term:`DEPENDS` |
| 1615 | Lists a recipe's build-time dependencies. These are dependencies on | 1615 | Lists a recipe's build-time dependencies. These are dependencies on |
| 1616 | other recipes whose contents (e.g. headers and shared libraries) are | 1616 | other recipes whose contents (e.g. headers and shared libraries) are |
| 1617 | needed by the recipe at build time. | 1617 | needed by the recipe at build time. |
| @@ -1686,7 +1686,7 @@ system and gives an overview of their function and contents. | |||
| 1686 | BitBake User Manual for additional information on tasks and | 1686 | BitBake User Manual for additional information on tasks and |
| 1687 | dependencies. | 1687 | dependencies. |
| 1688 | 1688 | ||
| 1689 | DEPLOY_DIR | 1689 | :term:`DEPLOY_DIR` |
| 1690 | Points to the general area that the OpenEmbedded build system uses to | 1690 | Points to the general area that the OpenEmbedded build system uses to |
| 1691 | place images, packages, SDKs, and other output files that are ready | 1691 | place images, packages, SDKs, and other output files that are ready |
| 1692 | to be used outside of the build system. By default, this directory | 1692 | to be used outside of the build system. By default, this directory |
| @@ -1701,7 +1701,7 @@ system and gives an overview of their function and contents. | |||
| 1701 | ":ref:`sdk-dev-environment`" sections all in the | 1701 | ":ref:`sdk-dev-environment`" sections all in the |
| 1702 | Yocto Project Overview and Concepts Manual. | 1702 | Yocto Project Overview and Concepts Manual. |
| 1703 | 1703 | ||
| 1704 | DEPLOY_DIR_DEB | 1704 | :term:`DEPLOY_DIR_DEB` |
| 1705 | Points to the area that the OpenEmbedded build system uses to place | 1705 | Points to the area that the OpenEmbedded build system uses to place |
| 1706 | Debian packages that are ready to be used outside of the build | 1706 | Debian packages that are ready to be used outside of the build |
| 1707 | system. This variable applies only when | 1707 | system. This variable applies only when |
| @@ -1723,7 +1723,7 @@ system and gives an overview of their function and contents. | |||
| 1723 | Feeds <package-feeds-dev-environment>`" section | 1723 | Feeds <package-feeds-dev-environment>`" section |
| 1724 | in the Yocto Project Overview and Concepts Manual. | 1724 | in the Yocto Project Overview and Concepts Manual. |
| 1725 | 1725 | ||
| 1726 | DEPLOY_DIR_IMAGE | 1726 | :term:`DEPLOY_DIR_IMAGE` |
| 1727 | Points to the area that the OpenEmbedded build system uses to place | 1727 | Points to the area that the OpenEmbedded build system uses to place |
| 1728 | images and other associated output files that are ready to be | 1728 | images and other associated output files that are ready to be |
| 1729 | deployed onto the target machine. The directory is machine-specific | 1729 | deployed onto the target machine. The directory is machine-specific |
| @@ -1738,7 +1738,7 @@ system and gives an overview of their function and contents. | |||
| 1738 | ":ref:`sdk-dev-environment`" sections both in | 1738 | ":ref:`sdk-dev-environment`" sections both in |
| 1739 | the Yocto Project Overview and Concepts Manual. | 1739 | the Yocto Project Overview and Concepts Manual. |
| 1740 | 1740 | ||
| 1741 | DEPLOY_DIR_IPK | 1741 | :term:`DEPLOY_DIR_IPK` |
| 1742 | Points to the area that the OpenEmbedded build system uses to place | 1742 | Points to the area that the OpenEmbedded build system uses to place |
| 1743 | IPK packages that are ready to be used outside of the build system. | 1743 | IPK packages that are ready to be used outside of the build system. |
| 1744 | This variable applies only when | 1744 | This variable applies only when |
| @@ -1759,7 +1759,7 @@ system and gives an overview of their function and contents. | |||
| 1759 | Feeds <package-feeds-dev-environment>`" section | 1759 | Feeds <package-feeds-dev-environment>`" section |
| 1760 | in the Yocto Project Overview and Concepts Manual. | 1760 | in the Yocto Project Overview and Concepts Manual. |
| 1761 | 1761 | ||
| 1762 | DEPLOY_DIR_RPM | 1762 | :term:`DEPLOY_DIR_RPM` |
| 1763 | Points to the area that the OpenEmbedded build system uses to place | 1763 | Points to the area that the OpenEmbedded build system uses to place |
| 1764 | RPM packages that are ready to be used outside of the build system. | 1764 | RPM packages that are ready to be used outside of the build system. |
| 1765 | This variable applies only when | 1765 | This variable applies only when |
| @@ -1780,7 +1780,7 @@ system and gives an overview of their function and contents. | |||
| 1780 | Feeds <package-feeds-dev-environment>`" section | 1780 | Feeds <package-feeds-dev-environment>`" section |
| 1781 | in the Yocto Project Overview and Concepts Manual. | 1781 | in the Yocto Project Overview and Concepts Manual. |
| 1782 | 1782 | ||
| 1783 | DEPLOY_DIR_TAR | 1783 | :term:`DEPLOY_DIR_TAR` |
| 1784 | Points to the area that the OpenEmbedded build system uses to place | 1784 | Points to the area that the OpenEmbedded build system uses to place |
| 1785 | tarballs that are ready to be used outside of the build system. This | 1785 | tarballs that are ready to be used outside of the build system. This |
| 1786 | variable applies only when | 1786 | variable applies only when |
| @@ -1801,7 +1801,7 @@ system and gives an overview of their function and contents. | |||
| 1801 | Feeds <package-feeds-dev-environment>`" section | 1801 | Feeds <package-feeds-dev-environment>`" section |
| 1802 | in the Yocto Project Overview and Concepts Manual. | 1802 | in the Yocto Project Overview and Concepts Manual. |
| 1803 | 1803 | ||
| 1804 | DEPLOYDIR | 1804 | :term:`DEPLOYDIR` |
| 1805 | When inheriting the :ref:`deploy <ref-classes-deploy>` class, the | 1805 | When inheriting the :ref:`deploy <ref-classes-deploy>` class, the |
| 1806 | ``DEPLOYDIR`` points to a temporary work area for deployed files that | 1806 | ``DEPLOYDIR`` points to a temporary work area for deployed files that |
| 1807 | is set in the ``deploy`` class as follows: | 1807 | is set in the ``deploy`` class as follows: |
| @@ -1814,12 +1814,12 @@ system and gives an overview of their function and contents. | |||
| 1814 | them into :term:`DEPLOY_DIR_IMAGE` | 1814 | them into :term:`DEPLOY_DIR_IMAGE` |
| 1815 | afterwards. | 1815 | afterwards. |
| 1816 | 1816 | ||
| 1817 | DESCRIPTION | 1817 | :term:`DESCRIPTION` |
| 1818 | The package description used by package managers. If not set, | 1818 | The package description used by package managers. If not set, |
| 1819 | ``DESCRIPTION`` takes the value of the :term:`SUMMARY` | 1819 | ``DESCRIPTION`` takes the value of the :term:`SUMMARY` |
| 1820 | variable. | 1820 | variable. |
| 1821 | 1821 | ||
| 1822 | DISTRO | 1822 | :term:`DISTRO` |
| 1823 | The short name of the distribution. For information on the long name | 1823 | The short name of the distribution. For information on the long name |
| 1824 | of the distribution, see the :term:`DISTRO_NAME` | 1824 | of the distribution, see the :term:`DISTRO_NAME` |
| 1825 | variable. | 1825 | variable. |
| @@ -1851,10 +1851,10 @@ system and gives an overview of their function and contents. | |||
| 1851 | meta/conf/distro/defaultsetup.conf | 1851 | meta/conf/distro/defaultsetup.conf |
| 1852 | also in the Source Directory. | 1852 | also in the Source Directory. |
| 1853 | 1853 | ||
| 1854 | DISTRO_CODENAME | 1854 | :term:`DISTRO_CODENAME` |
| 1855 | Specifies a codename for the distribution being built. | 1855 | Specifies a codename for the distribution being built. |
| 1856 | 1856 | ||
| 1857 | DISTRO_EXTRA_RDEPENDS | 1857 | :term:`DISTRO_EXTRA_RDEPENDS` |
| 1858 | Specifies a list of distro-specific packages to add to all images. | 1858 | Specifies a list of distro-specific packages to add to all images. |
| 1859 | This variable takes affect through ``packagegroup-base`` so the | 1859 | This variable takes affect through ``packagegroup-base`` so the |
| 1860 | variable only really applies to the more full-featured images that | 1860 | variable only really applies to the more full-featured images that |
| @@ -1862,13 +1862,13 @@ system and gives an overview of their function and contents. | |||
| 1862 | distro policy out of generic images. As with all other distro | 1862 | distro policy out of generic images. As with all other distro |
| 1863 | variables, you set this variable in the distro ``.conf`` file. | 1863 | variables, you set this variable in the distro ``.conf`` file. |
| 1864 | 1864 | ||
| 1865 | DISTRO_EXTRA_RRECOMMENDS | 1865 | :term:`DISTRO_EXTRA_RRECOMMENDS` |
| 1866 | Specifies a list of distro-specific packages to add to all images if | 1866 | Specifies a list of distro-specific packages to add to all images if |
| 1867 | the packages exist. The packages might not exist or be empty (e.g. | 1867 | the packages exist. The packages might not exist or be empty (e.g. |
| 1868 | kernel modules). The list of packages are automatically installed but | 1868 | kernel modules). The list of packages are automatically installed but |
| 1869 | you can remove them. | 1869 | you can remove them. |
| 1870 | 1870 | ||
| 1871 | DISTRO_FEATURES | 1871 | :term:`DISTRO_FEATURES` |
| 1872 | The software support you want in your distribution for various | 1872 | The software support you want in your distribution for various |
| 1873 | features. You define your distribution features in the distribution | 1873 | features. You define your distribution features in the distribution |
| 1874 | configuration file. | 1874 | configuration file. |
| @@ -1887,7 +1887,7 @@ system and gives an overview of their function and contents. | |||
| 1887 | provide with this variable, see the "`Distro | 1887 | provide with this variable, see the "`Distro |
| 1888 | Features <#ref-features-distro>`__" section. | 1888 | Features <#ref-features-distro>`__" section. |
| 1889 | 1889 | ||
| 1890 | DISTRO_FEATURES_BACKFILL | 1890 | :term:`DISTRO_FEATURES_BACKFILL` |
| 1891 | Features to be added to ``DISTRO_FEATURES`` if not also present in | 1891 | Features to be added to ``DISTRO_FEATURES`` if not also present in |
| 1892 | ``DISTRO_FEATURES_BACKFILL_CONSIDERED``. | 1892 | ``DISTRO_FEATURES_BACKFILL_CONSIDERED``. |
| 1893 | 1893 | ||
| @@ -1898,13 +1898,13 @@ system and gives an overview of their function and contents. | |||
| 1898 | Backfilling <#ref-features-backfill>`__" section for more | 1898 | Backfilling <#ref-features-backfill>`__" section for more |
| 1899 | information. | 1899 | information. |
| 1900 | 1900 | ||
| 1901 | DISTRO_FEATURES_BACKFILL_CONSIDERED | 1901 | :term:`DISTRO_FEATURES_BACKFILL_CONSIDERED` |
| 1902 | Features from ``DISTRO_FEATURES_BACKFILL`` that should not be | 1902 | Features from ``DISTRO_FEATURES_BACKFILL`` that should not be |
| 1903 | backfilled (i.e. added to ``DISTRO_FEATURES``) during the build. See | 1903 | backfilled (i.e. added to ``DISTRO_FEATURES``) during the build. See |
| 1904 | the "`Feature Backfilling <#ref-features-backfill>`__" section for | 1904 | the "`Feature Backfilling <#ref-features-backfill>`__" section for |
| 1905 | more information. | 1905 | more information. |
| 1906 | 1906 | ||
| 1907 | DISTRO_FEATURES_DEFAULT | 1907 | :term:`DISTRO_FEATURES_DEFAULT` |
| 1908 | A convenience variable that gives you the default list of distro | 1908 | A convenience variable that gives you the default list of distro |
| 1909 | features with the exception of any features specific to the C library | 1909 | features with the exception of any features specific to the C library |
| 1910 | (``libc``). | 1910 | (``libc``). |
| @@ -1918,7 +1918,7 @@ system and gives an overview of their function and contents. | |||
| 1918 | 1918 | ||
| 1919 | DISTRO_FEATURES ?= "${DISTRO_FEATURES_DEFAULT} myfeature" | 1919 | DISTRO_FEATURES ?= "${DISTRO_FEATURES_DEFAULT} myfeature" |
| 1920 | 1920 | ||
| 1921 | DISTRO_FEATURES_FILTER_NATIVE | 1921 | :term:`DISTRO_FEATURES_FILTER_NATIVE` |
| 1922 | Specifies a list of features that if present in the target | 1922 | Specifies a list of features that if present in the target |
| 1923 | :term:`DISTRO_FEATURES` value should be | 1923 | :term:`DISTRO_FEATURES` value should be |
| 1924 | included in ``DISTRO_FEATURES`` when building native recipes. This | 1924 | included in ``DISTRO_FEATURES`` when building native recipes. This |
| @@ -1926,7 +1926,7 @@ system and gives an overview of their function and contents. | |||
| 1926 | :term:`DISTRO_FEATURES_NATIVE` | 1926 | :term:`DISTRO_FEATURES_NATIVE` |
| 1927 | variable. | 1927 | variable. |
| 1928 | 1928 | ||
| 1929 | DISTRO_FEATURES_FILTER_NATIVESDK | 1929 | :term:`DISTRO_FEATURES_FILTER_NATIVESDK` |
| 1930 | Specifies a list of features that if present in the target | 1930 | Specifies a list of features that if present in the target |
| 1931 | :term:`DISTRO_FEATURES` value should be | 1931 | :term:`DISTRO_FEATURES` value should be |
| 1932 | included in ``DISTRO_FEATURES`` when building nativesdk recipes. This | 1932 | included in ``DISTRO_FEATURES`` when building nativesdk recipes. This |
| @@ -1934,7 +1934,7 @@ system and gives an overview of their function and contents. | |||
| 1934 | :term:`DISTRO_FEATURES_NATIVESDK` | 1934 | :term:`DISTRO_FEATURES_NATIVESDK` |
| 1935 | variable. | 1935 | variable. |
| 1936 | 1936 | ||
| 1937 | DISTRO_FEATURES_NATIVE | 1937 | :term:`DISTRO_FEATURES_NATIVE` |
| 1938 | Specifies a list of features that should be included in | 1938 | Specifies a list of features that should be included in |
| 1939 | :term:`DISTRO_FEATURES` when building native | 1939 | :term:`DISTRO_FEATURES` when building native |
| 1940 | recipes. This variable is used in addition to the features filtered | 1940 | recipes. This variable is used in addition to the features filtered |
| @@ -1942,7 +1942,7 @@ system and gives an overview of their function and contents. | |||
| 1942 | :term:`DISTRO_FEATURES_FILTER_NATIVE` | 1942 | :term:`DISTRO_FEATURES_FILTER_NATIVE` |
| 1943 | variable. | 1943 | variable. |
| 1944 | 1944 | ||
| 1945 | DISTRO_FEATURES_NATIVESDK | 1945 | :term:`DISTRO_FEATURES_NATIVESDK` |
| 1946 | Specifies a list of features that should be included in | 1946 | Specifies a list of features that should be included in |
| 1947 | :term:`DISTRO_FEATURES` when building | 1947 | :term:`DISTRO_FEATURES` when building |
| 1948 | nativesdk recipes. This variable is used in addition to the features | 1948 | nativesdk recipes. This variable is used in addition to the features |
| @@ -1950,7 +1950,7 @@ system and gives an overview of their function and contents. | |||
| 1950 | :term:`DISTRO_FEATURES_FILTER_NATIVESDK` | 1950 | :term:`DISTRO_FEATURES_FILTER_NATIVESDK` |
| 1951 | variable. | 1951 | variable. |
| 1952 | 1952 | ||
| 1953 | DISTRO_NAME | 1953 | :term:`DISTRO_NAME` |
| 1954 | The long name of the distribution. For information on the short name | 1954 | The long name of the distribution. For information on the short name |
| 1955 | of the distribution, see the :term:`DISTRO` variable. | 1955 | of the distribution, see the :term:`DISTRO` variable. |
| 1956 | 1956 | ||
| @@ -1980,10 +1980,10 @@ system and gives an overview of their function and contents. | |||
| 1980 | meta/conf/distro/defaultsetup.conf | 1980 | meta/conf/distro/defaultsetup.conf |
| 1981 | also in the Source Directory. | 1981 | also in the Source Directory. |
| 1982 | 1982 | ||
| 1983 | DISTRO_VERSION | 1983 | :term:`DISTRO_VERSION` |
| 1984 | The version of the distribution. | 1984 | The version of the distribution. |
| 1985 | 1985 | ||
| 1986 | DISTROOVERRIDES | 1986 | :term:`DISTROOVERRIDES` |
| 1987 | A colon-separated list of overrides specific to the current | 1987 | A colon-separated list of overrides specific to the current |
| 1988 | distribution. By default, this list includes the value of | 1988 | distribution. By default, this list includes the value of |
| 1989 | :term:`DISTRO`. | 1989 | :term:`DISTRO`. |
| @@ -1995,7 +1995,7 @@ system and gives an overview of their function and contents. | |||
| 1995 | is included in the default value of | 1995 | is included in the default value of |
| 1996 | :term:`OVERRIDES`. | 1996 | :term:`OVERRIDES`. |
| 1997 | 1997 | ||
| 1998 | DL_DIR | 1998 | :term:`DL_DIR` |
| 1999 | The central download directory used by the build process to store | 1999 | The central download directory used by the build process to store |
| 2000 | downloads. By default, ``DL_DIR`` gets files suitable for mirroring | 2000 | downloads. By default, ``DL_DIR`` gets files suitable for mirroring |
| 2001 | for everything except Git repositories. If you want tarballs of Git | 2001 | for everything except Git repositories. If you want tarballs of Git |
| @@ -2034,7 +2034,7 @@ system and gives an overview of their function and contents. | |||
| 2034 | ":yocto_wiki:`Working Behind a Network Proxy </wiki/Working_Behind_a_Network_Proxy>`" | 2034 | ":yocto_wiki:`Working Behind a Network Proxy </wiki/Working_Behind_a_Network_Proxy>`" |
| 2035 | Wiki page. | 2035 | Wiki page. |
| 2036 | 2036 | ||
| 2037 | DOC_COMPRESS | 2037 | :term:`DOC_COMPRESS` |
| 2038 | When inheriting the :ref:`compress_doc <ref-classes-compress_doc>` | 2038 | When inheriting the :ref:`compress_doc <ref-classes-compress_doc>` |
| 2039 | class, this variable sets the compression policy used when the | 2039 | class, this variable sets the compression policy used when the |
| 2040 | OpenEmbedded build system compresses man pages and info pages. By | 2040 | OpenEmbedded build system compresses man pages and info pages. By |
| @@ -2044,7 +2044,7 @@ system and gives an overview of their function and contents. | |||
| 2044 | For information on policies and on how to use this variable, see the | 2044 | For information on policies and on how to use this variable, see the |
| 2045 | comments in the ``meta/classes/compress_doc.bbclass`` file. | 2045 | comments in the ``meta/classes/compress_doc.bbclass`` file. |
| 2046 | 2046 | ||
| 2047 | EFI_PROVIDER | 2047 | :term:`EFI_PROVIDER` |
| 2048 | When building bootable images (i.e. where ``hddimg``, ``iso``, or | 2048 | When building bootable images (i.e. where ``hddimg``, ``iso``, or |
| 2049 | ``wic.vmdk`` is in :term:`IMAGE_FSTYPES`), the | 2049 | ``wic.vmdk`` is in :term:`IMAGE_FSTYPES`), the |
| 2050 | ``EFI_PROVIDER`` variable specifies the EFI bootloader to use. The | 2050 | ``EFI_PROVIDER`` variable specifies the EFI bootloader to use. The |
| @@ -2054,12 +2054,12 @@ system and gives an overview of their function and contents. | |||
| 2054 | :ref:`image-live <ref-classes-image-live>` classes for more | 2054 | :ref:`image-live <ref-classes-image-live>` classes for more |
| 2055 | information. | 2055 | information. |
| 2056 | 2056 | ||
| 2057 | ENABLE_BINARY_LOCALE_GENERATION | 2057 | :term:`ENABLE_BINARY_LOCALE_GENERATION` |
| 2058 | Variable that controls which locales for ``glibc`` are generated | 2058 | Variable that controls which locales for ``glibc`` are generated |
| 2059 | during the build (useful if the target device has 64Mbytes of RAM or | 2059 | during the build (useful if the target device has 64Mbytes of RAM or |
| 2060 | less). | 2060 | less). |
| 2061 | 2061 | ||
| 2062 | ERR_REPORT_DIR | 2062 | :term:`ERR_REPORT_DIR` |
| 2063 | When used with the :ref:`report-error <ref-classes-report-error>` | 2063 | When used with the :ref:`report-error <ref-classes-report-error>` |
| 2064 | class, specifies the path used for storing the debug files created by | 2064 | class, specifies the path used for storing the debug files created by |
| 2065 | the :ref:`error reporting | 2065 | the :ref:`error reporting |
| @@ -2075,14 +2075,14 @@ system and gives an overview of their function and contents. | |||
| 2075 | 2075 | ||
| 2076 | ERR_REPORT_DIR = "path" | 2076 | ERR_REPORT_DIR = "path" |
| 2077 | 2077 | ||
| 2078 | ERROR_QA | 2078 | :term:`ERROR_QA` |
| 2079 | Specifies the quality assurance checks whose failures are reported as | 2079 | Specifies the quality assurance checks whose failures are reported as |
| 2080 | errors by the OpenEmbedded build system. You set this variable in | 2080 | errors by the OpenEmbedded build system. You set this variable in |
| 2081 | your distribution configuration file. For a list of the checks you | 2081 | your distribution configuration file. For a list of the checks you |
| 2082 | can control with this variable, see the | 2082 | can control with this variable, see the |
| 2083 | ":ref:`insane.bbclass <ref-classes-insane>`" section. | 2083 | ":ref:`insane.bbclass <ref-classes-insane>`" section. |
| 2084 | 2084 | ||
| 2085 | EXCLUDE_FROM_SHLIBS | 2085 | :term:`EXCLUDE_FROM_SHLIBS` |
| 2086 | Triggers the OpenEmbedded build system's shared libraries resolver to | 2086 | Triggers the OpenEmbedded build system's shared libraries resolver to |
| 2087 | exclude an entire package when scanning for shared libraries. | 2087 | exclude an entire package when scanning for shared libraries. |
| 2088 | 2088 | ||
| @@ -2106,7 +2106,7 @@ system and gives an overview of their function and contents. | |||
| 2106 | 2106 | ||
| 2107 | EXCLUDE_FROM_SHLIBS = "1" | 2107 | EXCLUDE_FROM_SHLIBS = "1" |
| 2108 | 2108 | ||
| 2109 | EXCLUDE_FROM_WORLD | 2109 | :term:`EXCLUDE_FROM_WORLD` |
| 2110 | Directs BitBake to exclude a recipe from world builds (i.e. | 2110 | Directs BitBake to exclude a recipe from world builds (i.e. |
| 2111 | ``bitbake world``). During world builds, BitBake locates, parses and | 2111 | ``bitbake world``). During world builds, BitBake locates, parses and |
| 2112 | builds all recipes found in every layer exposed in the | 2112 | builds all recipes found in every layer exposed in the |
| @@ -2125,7 +2125,7 @@ system and gives an overview of their function and contents. | |||
| 2125 | only ensures that the recipe is not explicitly added to the list | 2125 | only ensures that the recipe is not explicitly added to the list |
| 2126 | of build targets in a world build. | 2126 | of build targets in a world build. |
| 2127 | 2127 | ||
| 2128 | EXTENDPE | 2128 | :term:`EXTENDPE` |
| 2129 | Used with file and pathnames to create a prefix for a recipe's | 2129 | Used with file and pathnames to create a prefix for a recipe's |
| 2130 | version based on the recipe's :term:`PE` value. If ``PE`` | 2130 | version based on the recipe's :term:`PE` value. If ``PE`` |
| 2131 | is set and greater than zero for a recipe, ``EXTENDPE`` becomes that | 2131 | is set and greater than zero for a recipe, ``EXTENDPE`` becomes that |
| @@ -2135,7 +2135,7 @@ system and gives an overview of their function and contents. | |||
| 2135 | 2135 | ||
| 2136 | See the :term:`STAMP` variable for an example. | 2136 | See the :term:`STAMP` variable for an example. |
| 2137 | 2137 | ||
| 2138 | EXTENDPKGV | 2138 | :term:`EXTENDPKGV` |
| 2139 | The full package version specification as it appears on the final | 2139 | The full package version specification as it appears on the final |
| 2140 | packages produced by a recipe. The variable's value is normally used | 2140 | packages produced by a recipe. The variable's value is normally used |
| 2141 | to fix a runtime dependency to the exact same version of another | 2141 | to fix a runtime dependency to the exact same version of another |
| @@ -2147,7 +2147,7 @@ system and gives an overview of their function and contents. | |||
| 2147 | The dependency relationships are intended to force the package | 2147 | The dependency relationships are intended to force the package |
| 2148 | manager to upgrade these types of packages in lock-step. | 2148 | manager to upgrade these types of packages in lock-step. |
| 2149 | 2149 | ||
| 2150 | EXTERNAL_KERNEL_TOOLS | 2150 | :term:`EXTERNAL_KERNEL_TOOLS` |
| 2151 | When set, the ``EXTERNAL_KERNEL_TOOLS`` variable indicates that these | 2151 | When set, the ``EXTERNAL_KERNEL_TOOLS`` variable indicates that these |
| 2152 | tools are not in the source tree. | 2152 | tools are not in the source tree. |
| 2153 | 2153 | ||
| @@ -2158,7 +2158,7 @@ system and gives an overview of their function and contents. | |||
| 2158 | :ref:`kernel-yocto <ref-classes-kernel-yocto>` class in | 2158 | :ref:`kernel-yocto <ref-classes-kernel-yocto>` class in |
| 2159 | ``meta/classes`` to see how the variable is used. | 2159 | ``meta/classes`` to see how the variable is used. |
| 2160 | 2160 | ||
| 2161 | EXTERNALSRC | 2161 | :term:`EXTERNALSRC` |
| 2162 | When inheriting the :ref:`externalsrc <ref-classes-externalsrc>` | 2162 | When inheriting the :ref:`externalsrc <ref-classes-externalsrc>` |
| 2163 | class, this variable points to the source tree, which is outside of | 2163 | class, this variable points to the source tree, which is outside of |
| 2164 | the OpenEmbedded build system. When set, this variable sets the | 2164 | the OpenEmbedded build system. When set, this variable sets the |
| @@ -2171,7 +2171,7 @@ system and gives an overview of their function and contents. | |||
| 2171 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" | 2171 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" |
| 2172 | section in the Yocto Project Development Tasks Manual. | 2172 | section in the Yocto Project Development Tasks Manual. |
| 2173 | 2173 | ||
| 2174 | EXTERNALSRC_BUILD | 2174 | :term:`EXTERNALSRC_BUILD` |
| 2175 | When inheriting the :ref:`externalsrc <ref-classes-externalsrc>` | 2175 | When inheriting the :ref:`externalsrc <ref-classes-externalsrc>` |
| 2176 | class, this variable points to the directory in which the recipe's | 2176 | class, this variable points to the directory in which the recipe's |
| 2177 | source code is built, which is outside of the OpenEmbedded build | 2177 | source code is built, which is outside of the OpenEmbedded build |
| @@ -2185,7 +2185,7 @@ system and gives an overview of their function and contents. | |||
| 2185 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" | 2185 | ":ref:`dev-manual/dev-manual-common-tasks:building software from an external source`" |
| 2186 | section in the Yocto Project Development Tasks Manual. | 2186 | section in the Yocto Project Development Tasks Manual. |
| 2187 | 2187 | ||
| 2188 | EXTRA_AUTORECONF | 2188 | :term:`EXTRA_AUTORECONF` |
| 2189 | For recipes inheriting the :ref:`autotools <ref-classes-autotools>` | 2189 | For recipes inheriting the :ref:`autotools <ref-classes-autotools>` |
| 2190 | class, you can use ``EXTRA_AUTORECONF`` to specify extra options to | 2190 | class, you can use ``EXTRA_AUTORECONF`` to specify extra options to |
| 2191 | pass to the ``autoreconf`` command that is executed during the | 2191 | pass to the ``autoreconf`` command that is executed during the |
| @@ -2193,7 +2193,7 @@ system and gives an overview of their function and contents. | |||
| 2193 | 2193 | ||
| 2194 | The default value is "--exclude=autopoint". | 2194 | The default value is "--exclude=autopoint". |
| 2195 | 2195 | ||
| 2196 | EXTRA_IMAGE_FEATURES | 2196 | :term:`EXTRA_IMAGE_FEATURES` |
| 2197 | A list of additional features to include in an image. When listing | 2197 | A list of additional features to include in an image. When listing |
| 2198 | more than one feature, separate them with a space. | 2198 | more than one feature, separate them with a space. |
| 2199 | 2199 | ||
| @@ -2237,7 +2237,7 @@ system and gives an overview of their function and contents. | |||
| 2237 | variable, see the ":ref:`usingpoky-extend-customimage-imagefeatures`" | 2237 | variable, see the ":ref:`usingpoky-extend-customimage-imagefeatures`" |
| 2238 | section in the Yocto Project Development Tasks Manual. | 2238 | section in the Yocto Project Development Tasks Manual. |
| 2239 | 2239 | ||
| 2240 | EXTRA_IMAGECMD | 2240 | :term:`EXTRA_IMAGECMD` |
| 2241 | Specifies additional options for the image creation command that has | 2241 | Specifies additional options for the image creation command that has |
| 2242 | been specified in :term:`IMAGE_CMD`. When setting | 2242 | been specified in :term:`IMAGE_CMD`. When setting |
| 2243 | this variable, use an override for the associated image type. Here is | 2243 | this variable, use an override for the associated image type. Here is |
| @@ -2246,7 +2246,7 @@ system and gives an overview of their function and contents. | |||
| 2246 | 2246 | ||
| 2247 | EXTRA_IMAGECMD_ext3 ?= "-i 4096" | 2247 | EXTRA_IMAGECMD_ext3 ?= "-i 4096" |
| 2248 | 2248 | ||
| 2249 | EXTRA_IMAGEDEPENDS | 2249 | :term:`EXTRA_IMAGEDEPENDS` |
| 2250 | A list of recipes to build that do not provide packages for | 2250 | A list of recipes to build that do not provide packages for |
| 2251 | installing into the root filesystem. | 2251 | installing into the root filesystem. |
| 2252 | 2252 | ||
| @@ -2261,7 +2261,7 @@ system and gives an overview of their function and contents. | |||
| 2261 | \*RDEPENDS and \*RRECOMMENDS | 2261 | \*RDEPENDS and \*RRECOMMENDS |
| 2262 | variables. | 2262 | variables. |
| 2263 | 2263 | ||
| 2264 | EXTRANATIVEPATH | 2264 | :term:`EXTRANATIVEPATH` |
| 2265 | A list of subdirectories of | 2265 | A list of subdirectories of |
| 2266 | ``${``\ :term:`STAGING_BINDIR_NATIVE`\ ``}`` | 2266 | ``${``\ :term:`STAGING_BINDIR_NATIVE`\ ``}`` |
| 2267 | added to the beginning of the environment variable ``PATH``. As an | 2267 | added to the beginning of the environment variable ``PATH``. As an |
| @@ -2272,16 +2272,16 @@ system and gives an overview of their function and contents. | |||
| 2272 | 2272 | ||
| 2273 | EXTRANATIVEPATH = "foo bar" | 2273 | EXTRANATIVEPATH = "foo bar" |
| 2274 | 2274 | ||
| 2275 | EXTRA_OECMAKE | 2275 | :term:`EXTRA_OECMAKE` |
| 2276 | Additional `CMake <https://cmake.org/overview/>`__ options. See the | 2276 | Additional `CMake <https://cmake.org/overview/>`__ options. See the |
| 2277 | :ref:`cmake <ref-classes-cmake>` class for additional information. | 2277 | :ref:`cmake <ref-classes-cmake>` class for additional information. |
| 2278 | 2278 | ||
| 2279 | EXTRA_OECONF | 2279 | :term:`EXTRA_OECONF` |
| 2280 | Additional ``configure`` script options. See | 2280 | Additional ``configure`` script options. See |
| 2281 | :term:`PACKAGECONFIG_CONFARGS` for | 2281 | :term:`PACKAGECONFIG_CONFARGS` for |
| 2282 | additional information on passing configure script options. | 2282 | additional information on passing configure script options. |
| 2283 | 2283 | ||
| 2284 | EXTRA_OEMAKE | 2284 | :term:`EXTRA_OEMAKE` |
| 2285 | Additional GNU ``make`` options. | 2285 | Additional GNU ``make`` options. |
| 2286 | 2286 | ||
| 2287 | Because the ``EXTRA_OEMAKE`` defaults to "", you need to set the | 2287 | Because the ``EXTRA_OEMAKE`` defaults to "", you need to set the |
| @@ -2291,12 +2291,12 @@ system and gives an overview of their function and contents. | |||
| 2291 | :term:`PARALLEL_MAKEINST` also make use of | 2291 | :term:`PARALLEL_MAKEINST` also make use of |
| 2292 | ``EXTRA_OEMAKE`` to pass the required flags. | 2292 | ``EXTRA_OEMAKE`` to pass the required flags. |
| 2293 | 2293 | ||
| 2294 | EXTRA_OESCONS | 2294 | :term:`EXTRA_OESCONS` |
| 2295 | When inheriting the :ref:`scons <ref-classes-scons>` class, this | 2295 | When inheriting the :ref:`scons <ref-classes-scons>` class, this |
| 2296 | variable specifies additional configuration options you want to pass | 2296 | variable specifies additional configuration options you want to pass |
| 2297 | to the ``scons`` command line. | 2297 | to the ``scons`` command line. |
| 2298 | 2298 | ||
| 2299 | EXTRA_USERS_PARAMS | 2299 | :term:`EXTRA_USERS_PARAMS` |
| 2300 | When inheriting the :ref:`extrausers <ref-classes-extrausers>` | 2300 | When inheriting the :ref:`extrausers <ref-classes-extrausers>` |
| 2301 | class, this variable provides image level user and group operations. | 2301 | class, this variable provides image level user and group operations. |
| 2302 | This is a more global method of providing user and group | 2302 | This is a more global method of providing user and group |
| @@ -2318,7 +2318,7 @@ system and gives an overview of their function and contents. | |||
| 2318 | # usermod -s /bin/sh tester; \ | 2318 | # usermod -s /bin/sh tester; \ |
| 2319 | # " | 2319 | # " |
| 2320 | 2320 | ||
| 2321 | FEATURE_PACKAGES | 2321 | :term:`FEATURE_PACKAGES` |
| 2322 | Defines one or more packages to include in an image when a specific | 2322 | Defines one or more packages to include in an image when a specific |
| 2323 | item is included in :term:`IMAGE_FEATURES`. | 2323 | item is included in :term:`IMAGE_FEATURES`. |
| 2324 | When setting the value, ``FEATURE_PACKAGES`` should have the name of | 2324 | When setting the value, ``FEATURE_PACKAGES`` should have the name of |
| @@ -2340,7 +2340,7 @@ system and gives an overview of their function and contents. | |||
| 2340 | variable with package groups, which are discussed elsewhere in the | 2340 | variable with package groups, which are discussed elsewhere in the |
| 2341 | documentation. | 2341 | documentation. |
| 2342 | 2342 | ||
| 2343 | FEED_DEPLOYDIR_BASE_URI | 2343 | :term:`FEED_DEPLOYDIR_BASE_URI` |
| 2344 | Points to the base URL of the server and location within the | 2344 | Points to the base URL of the server and location within the |
| 2345 | document-root that provides the metadata and packages required by | 2345 | document-root that provides the metadata and packages required by |
| 2346 | OPKG to support runtime package management of IPK packages. You set | 2346 | OPKG to support runtime package management of IPK packages. You set |
| @@ -2358,7 +2358,7 @@ system and gives an overview of their function and contents. | |||
| 2358 | a set of configuration files for you in your target that work with | 2358 | a set of configuration files for you in your target that work with |
| 2359 | the feed. | 2359 | the feed. |
| 2360 | 2360 | ||
| 2361 | FILES | 2361 | :term:`FILES` |
| 2362 | The list of files and directories that are placed in a package. The | 2362 | The list of files and directories that are placed in a package. The |
| 2363 | :term:`PACKAGES` variable lists the packages | 2363 | :term:`PACKAGES` variable lists the packages |
| 2364 | generated by a recipe. | 2364 | generated by a recipe. |
| @@ -2395,7 +2395,7 @@ system and gives an overview of their function and contents. | |||
| 2395 | the :term:`CONFFILES` variable for information on | 2395 | the :term:`CONFFILES` variable for information on |
| 2396 | how to identify these files to the PMS. | 2396 | how to identify these files to the PMS. |
| 2397 | 2397 | ||
| 2398 | FILES_SOLIBSDEV | 2398 | :term:`FILES_SOLIBSDEV` |
| 2399 | Defines the file specification to match | 2399 | Defines the file specification to match |
| 2400 | :term:`SOLIBSDEV`. In other words, | 2400 | :term:`SOLIBSDEV`. In other words, |
| 2401 | ``FILES_SOLIBSDEV`` defines the full path name of the development | 2401 | ``FILES_SOLIBSDEV`` defines the full path name of the development |
| @@ -2407,7 +2407,7 @@ system and gives an overview of their function and contents. | |||
| 2407 | 2407 | ||
| 2408 | FILES_SOLIBSDEV ?= "${base_libdir}/lib*${SOLIBSDEV} ${libdir}/lib*${SOLIBSDEV}" | 2408 | FILES_SOLIBSDEV ?= "${base_libdir}/lib*${SOLIBSDEV} ${libdir}/lib*${SOLIBSDEV}" |
| 2409 | 2409 | ||
| 2410 | FILESEXTRAPATHS | 2410 | :term:`FILESEXTRAPATHS` |
| 2411 | Extends the search path the OpenEmbedded build system uses when | 2411 | Extends the search path the OpenEmbedded build system uses when |
| 2412 | looking for files and patches as it processes recipes and append | 2412 | looking for files and patches as it processes recipes and append |
| 2413 | files. The default directories BitBake uses when it processes recipes | 2413 | files. The default directories BitBake uses when it processes recipes |
| @@ -2479,7 +2479,7 @@ system and gives an overview of their function and contents. | |||
| 2479 | files that reside in different layers but are used for the same | 2479 | files that reside in different layers but are used for the same |
| 2480 | recipe to correctly extend the path. | 2480 | recipe to correctly extend the path. |
| 2481 | 2481 | ||
| 2482 | FILESOVERRIDES | 2482 | :term:`FILESOVERRIDES` |
| 2483 | A subset of :term:`OVERRIDES` used by the | 2483 | A subset of :term:`OVERRIDES` used by the |
| 2484 | OpenEmbedded build system for creating | 2484 | OpenEmbedded build system for creating |
| 2485 | :term:`FILESPATH`. The ``FILESOVERRIDES`` variable | 2485 | :term:`FILESPATH`. The ``FILESOVERRIDES`` variable |
| @@ -2503,7 +2503,7 @@ system and gives an overview of their function and contents. | |||
| 2503 | variable. The values match up with expected overrides and are used | 2503 | variable. The values match up with expected overrides and are used |
| 2504 | in an expected manner by the build system. | 2504 | in an expected manner by the build system. |
| 2505 | 2505 | ||
| 2506 | FILESPATH | 2506 | :term:`FILESPATH` |
| 2507 | The default set of directories the OpenEmbedded build system uses | 2507 | The default set of directories the OpenEmbedded build system uses |
| 2508 | when searching for patches and files. | 2508 | when searching for patches and files. |
| 2509 | 2509 | ||
| @@ -2562,7 +2562,7 @@ system and gives an overview of their function and contents. | |||
| 2562 | the Yocto Project Development Tasks Manual. See the | 2562 | the Yocto Project Development Tasks Manual. See the |
| 2563 | :ref:`ref-tasks-patch` task as well. | 2563 | :ref:`ref-tasks-patch` task as well. |
| 2564 | 2564 | ||
| 2565 | FILESYSTEM_PERMS_TABLES | 2565 | :term:`FILESYSTEM_PERMS_TABLES` |
| 2566 | Allows you to define your own file permissions settings table as part | 2566 | Allows you to define your own file permissions settings table as part |
| 2567 | of your configuration for the packaging process. For example, suppose | 2567 | of your configuration for the packaging process. For example, suppose |
| 2568 | you need a consistent set of custom permissions for a set of groups | 2568 | you need a consistent set of custom permissions for a set of groups |
| @@ -2585,19 +2585,19 @@ system and gives an overview of their function and contents. | |||
| 2585 | For guidance on how to create your own file permissions settings | 2585 | For guidance on how to create your own file permissions settings |
| 2586 | table file, examine the existing ``fs-perms.txt``. | 2586 | table file, examine the existing ``fs-perms.txt``. |
| 2587 | 2587 | ||
| 2588 | FIT_HASH_ALG | 2588 | :term:`FIT_HASH_ALG` |
| 2589 | Specifies the hash algorithm used in creating the FIT Image. For e.g. sha256. | 2589 | Specifies the hash algorithm used in creating the FIT Image. For e.g. sha256. |
| 2590 | 2590 | ||
| 2591 | FIT_SIGN_ALG | 2591 | :term:`FIT_SIGN_ALG` |
| 2592 | Specifies the signature algorithm used in creating the FIT Image. | 2592 | Specifies the signature algorithm used in creating the FIT Image. |
| 2593 | For e.g. rsa2048. | 2593 | For e.g. rsa2048. |
| 2594 | 2594 | ||
| 2595 | FONT_EXTRA_RDEPENDS | 2595 | :term:`FONT_EXTRA_RDEPENDS` |
| 2596 | When inheriting the :ref:`fontcache <ref-classes-fontcache>` class, | 2596 | When inheriting the :ref:`fontcache <ref-classes-fontcache>` class, |
| 2597 | this variable specifies the runtime dependencies for font packages. | 2597 | this variable specifies the runtime dependencies for font packages. |
| 2598 | By default, the ``FONT_EXTRA_RDEPENDS`` is set to "fontconfig-utils". | 2598 | By default, the ``FONT_EXTRA_RDEPENDS`` is set to "fontconfig-utils". |
| 2599 | 2599 | ||
| 2600 | FONT_PACKAGES | 2600 | :term:`FONT_PACKAGES` |
| 2601 | When inheriting the :ref:`fontcache <ref-classes-fontcache>` class, | 2601 | When inheriting the :ref:`fontcache <ref-classes-fontcache>` class, |
| 2602 | this variable identifies packages containing font files that need to | 2602 | this variable identifies packages containing font files that need to |
| 2603 | be cached by Fontconfig. By default, the ``fontcache`` class assumes | 2603 | be cached by Fontconfig. By default, the ``fontcache`` class assumes |
| @@ -2605,18 +2605,18 @@ system and gives an overview of their function and contents. | |||
| 2605 | ``${``\ :term:`PN`\ ``}``). Use this variable if fonts you | 2605 | ``${``\ :term:`PN`\ ``}``). Use this variable if fonts you |
| 2606 | need are in a package other than that main package. | 2606 | need are in a package other than that main package. |
| 2607 | 2607 | ||
| 2608 | FORCE_RO_REMOVE | 2608 | :term:`FORCE_RO_REMOVE` |
| 2609 | Forces the removal of the packages listed in ``ROOTFS_RO_UNNEEDED`` | 2609 | Forces the removal of the packages listed in ``ROOTFS_RO_UNNEEDED`` |
| 2610 | during the generation of the root filesystem. | 2610 | during the generation of the root filesystem. |
| 2611 | 2611 | ||
| 2612 | Set the variable to "1" to force the removal of these packages. | 2612 | Set the variable to "1" to force the removal of these packages. |
| 2613 | 2613 | ||
| 2614 | FULL_OPTIMIZATION | 2614 | :term:`FULL_OPTIMIZATION` |
| 2615 | The options to pass in ``TARGET_CFLAGS`` and ``CFLAGS`` when | 2615 | The options to pass in ``TARGET_CFLAGS`` and ``CFLAGS`` when |
| 2616 | compiling an optimized system. This variable defaults to "-O2 -pipe | 2616 | compiling an optimized system. This variable defaults to "-O2 -pipe |
| 2617 | ${DEBUG_FLAGS}". | 2617 | ${DEBUG_FLAGS}". |
| 2618 | 2618 | ||
| 2619 | GCCPIE | 2619 | :term:`GCCPIE` |
| 2620 | Enables Position Independent Executables (PIE) within the GNU C | 2620 | Enables Position Independent Executables (PIE) within the GNU C |
| 2621 | Compiler (GCC). Enabling PIE in the GCC makes Return Oriented | 2621 | Compiler (GCC). Enabling PIE in the GCC makes Return Oriented |
| 2622 | Programming (ROP) attacks much more difficult to execute. | 2622 | Programming (ROP) attacks much more difficult to execute. |
| @@ -2627,7 +2627,7 @@ system and gives an overview of their function and contents. | |||
| 2627 | 2627 | ||
| 2628 | GCCPIE ?= "--enable-default-pie" | 2628 | GCCPIE ?= "--enable-default-pie" |
| 2629 | 2629 | ||
| 2630 | GCCVERSION | 2630 | :term:`GCCVERSION` |
| 2631 | Specifies the default version of the GNU C Compiler (GCC) used for | 2631 | Specifies the default version of the GNU C Compiler (GCC) used for |
| 2632 | compilation. By default, ``GCCVERSION`` is set to "8.x" in the | 2632 | compilation. By default, ``GCCVERSION`` is set to "8.x" in the |
| 2633 | ``meta/conf/distro/include/tcmode-default.inc`` include file: | 2633 | ``meta/conf/distro/include/tcmode-default.inc`` include file: |
| @@ -2638,14 +2638,14 @@ system and gives an overview of their function and contents. | |||
| 2638 | You can override this value by setting it in a | 2638 | You can override this value by setting it in a |
| 2639 | configuration file such as the ``local.conf``. | 2639 | configuration file such as the ``local.conf``. |
| 2640 | 2640 | ||
| 2641 | GDB | 2641 | :term:`GDB` |
| 2642 | The minimal command and arguments to run the GNU Debugger. | 2642 | The minimal command and arguments to run the GNU Debugger. |
| 2643 | 2643 | ||
| 2644 | GITDIR | 2644 | :term:`GITDIR` |
| 2645 | The directory in which a local copy of a Git repository is stored | 2645 | The directory in which a local copy of a Git repository is stored |
| 2646 | when it is cloned. | 2646 | when it is cloned. |
| 2647 | 2647 | ||
| 2648 | GLIBC_GENERATE_LOCALES | 2648 | :term:`GLIBC_GENERATE_LOCALES` |
| 2649 | Specifies the list of GLIBC locales to generate should you not wish | 2649 | Specifies the list of GLIBC locales to generate should you not wish |
| 2650 | to generate all LIBC locals, which can be time consuming. | 2650 | to generate all LIBC locals, which can be time consuming. |
| 2651 | 2651 | ||
| @@ -2663,7 +2663,7 @@ system and gives an overview of their function and contents. | |||
| 2663 | 2663 | ||
| 2664 | GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8" | 2664 | GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8" |
| 2665 | 2665 | ||
| 2666 | GROUPADD_PARAM | 2666 | :term:`GROUPADD_PARAM` |
| 2667 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, | 2667 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, |
| 2668 | this variable specifies for a package what parameters should be | 2668 | this variable specifies for a package what parameters should be |
| 2669 | passed to the ``groupadd`` command if you wish to add a group to the | 2669 | passed to the ``groupadd`` command if you wish to add a group to the |
| @@ -2677,7 +2677,7 @@ system and gives an overview of their function and contents. | |||
| 2677 | For information on the standard Linux shell command | 2677 | For information on the standard Linux shell command |
| 2678 | ``groupadd``, see http://linux.die.net/man/8/groupadd. | 2678 | ``groupadd``, see http://linux.die.net/man/8/groupadd. |
| 2679 | 2679 | ||
| 2680 | GROUPMEMS_PARAM | 2680 | :term:`GROUPMEMS_PARAM` |
| 2681 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, | 2681 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, |
| 2682 | this variable specifies for a package what parameters should be | 2682 | this variable specifies for a package what parameters should be |
| 2683 | passed to the ``groupmems`` command if you wish to modify the members | 2683 | passed to the ``groupmems`` command if you wish to modify the members |
| @@ -2686,7 +2686,7 @@ system and gives an overview of their function and contents. | |||
| 2686 | For information on the standard Linux shell command ``groupmems``, | 2686 | For information on the standard Linux shell command ``groupmems``, |
| 2687 | see http://linux.die.net/man/8/groupmems. | 2687 | see http://linux.die.net/man/8/groupmems. |
| 2688 | 2688 | ||
| 2689 | GRUB_GFXSERIAL | 2689 | :term:`GRUB_GFXSERIAL` |
| 2690 | Configures the GNU GRand Unified Bootloader (GRUB) to have graphics | 2690 | Configures the GNU GRand Unified Bootloader (GRUB) to have graphics |
| 2691 | and serial in the boot menu. Set this variable to "1" in your | 2691 | and serial in the boot menu. Set this variable to "1" in your |
| 2692 | ``local.conf`` or distribution configuration file to enable graphics | 2692 | ``local.conf`` or distribution configuration file to enable graphics |
| @@ -2695,7 +2695,7 @@ system and gives an overview of their function and contents. | |||
| 2695 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more | 2695 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more |
| 2696 | information on how this variable is used. | 2696 | information on how this variable is used. |
| 2697 | 2697 | ||
| 2698 | GRUB_OPTS | 2698 | :term:`GRUB_OPTS` |
| 2699 | Additional options to add to the GNU GRand Unified Bootloader (GRUB) | 2699 | Additional options to add to the GNU GRand Unified Bootloader (GRUB) |
| 2700 | configuration. Use a semi-colon character (``;``) to separate | 2700 | configuration. Use a semi-colon character (``;``) to separate |
| 2701 | multiple options. | 2701 | multiple options. |
| @@ -2704,7 +2704,7 @@ system and gives an overview of their function and contents. | |||
| 2704 | :ref:`grub-efi <ref-classes-grub-efi>` class for more information | 2704 | :ref:`grub-efi <ref-classes-grub-efi>` class for more information |
| 2705 | on how this variable is used. | 2705 | on how this variable is used. |
| 2706 | 2706 | ||
| 2707 | GRUB_TIMEOUT | 2707 | :term:`GRUB_TIMEOUT` |
| 2708 | Specifies the timeout before executing the default ``LABEL`` in the | 2708 | Specifies the timeout before executing the default ``LABEL`` in the |
| 2709 | GNU GRand Unified Bootloader (GRUB). | 2709 | GNU GRand Unified Bootloader (GRUB). |
| 2710 | 2710 | ||
| @@ -2712,18 +2712,18 @@ system and gives an overview of their function and contents. | |||
| 2712 | :ref:`grub-efi <ref-classes-grub-efi>` class for more information | 2712 | :ref:`grub-efi <ref-classes-grub-efi>` class for more information |
| 2713 | on how this variable is used. | 2713 | on how this variable is used. |
| 2714 | 2714 | ||
| 2715 | GTKIMMODULES_PACKAGES | 2715 | :term:`GTKIMMODULES_PACKAGES` |
| 2716 | When inheriting the | 2716 | When inheriting the |
| 2717 | :ref:`gtk-immodules-cache <ref-classes-gtk-immodules-cache>` class, | 2717 | :ref:`gtk-immodules-cache <ref-classes-gtk-immodules-cache>` class, |
| 2718 | this variable specifies the packages that contain the GTK+ input | 2718 | this variable specifies the packages that contain the GTK+ input |
| 2719 | method modules being installed when the modules are in packages other | 2719 | method modules being installed when the modules are in packages other |
| 2720 | than the main package. | 2720 | than the main package. |
| 2721 | 2721 | ||
| 2722 | HOMEPAGE | 2722 | :term:`HOMEPAGE` |
| 2723 | Website where more information about the software the recipe is | 2723 | Website where more information about the software the recipe is |
| 2724 | building can be found. | 2724 | building can be found. |
| 2725 | 2725 | ||
| 2726 | HOST_ARCH | 2726 | :term:`HOST_ARCH` |
| 2727 | The name of the target architecture, which is normally the same as | 2727 | The name of the target architecture, which is normally the same as |
| 2728 | :term:`TARGET_ARCH`. The OpenEmbedded build system | 2728 | :term:`TARGET_ARCH`. The OpenEmbedded build system |
| 2729 | supports many architectures. Here is an example list of architectures | 2729 | supports many architectures. Here is an example list of architectures |
| @@ -2738,7 +2738,7 @@ system and gives an overview of their function and contents. | |||
| 2738 | - mips | 2738 | - mips |
| 2739 | - mipsel | 2739 | - mipsel |
| 2740 | 2740 | ||
| 2741 | HOST_CC_ARCH | 2741 | :term:`HOST_CC_ARCH` |
| 2742 | Specifies architecture-specific compiler flags that are passed to the | 2742 | Specifies architecture-specific compiler flags that are passed to the |
| 2743 | C compiler. | 2743 | C compiler. |
| 2744 | 2744 | ||
| @@ -2754,18 +2754,18 @@ system and gives an overview of their function and contents. | |||
| 2754 | - ``BUILDSDK_CC_ARCH`` when building for an SDK (i.e. | 2754 | - ``BUILDSDK_CC_ARCH`` when building for an SDK (i.e. |
| 2755 | ``nativesdk-``) | 2755 | ``nativesdk-``) |
| 2756 | 2756 | ||
| 2757 | HOST_OS | 2757 | :term:`HOST_OS` |
| 2758 | Specifies the name of the target operating system, which is normally | 2758 | Specifies the name of the target operating system, which is normally |
| 2759 | the same as the :term:`TARGET_OS`. The variable can | 2759 | the same as the :term:`TARGET_OS`. The variable can |
| 2760 | be set to "linux" for ``glibc``-based systems and to "linux-musl" for | 2760 | be set to "linux" for ``glibc``-based systems and to "linux-musl" for |
| 2761 | ``musl``. For ARM/EABI targets, there are also "linux-gnueabi" and | 2761 | ``musl``. For ARM/EABI targets, there are also "linux-gnueabi" and |
| 2762 | "linux-musleabi" values possible. | 2762 | "linux-musleabi" values possible. |
| 2763 | 2763 | ||
| 2764 | HOST_PREFIX | 2764 | :term:`HOST_PREFIX` |
| 2765 | Specifies the prefix for the cross-compile toolchain. ``HOST_PREFIX`` | 2765 | Specifies the prefix for the cross-compile toolchain. ``HOST_PREFIX`` |
| 2766 | is normally the same as :term:`TARGET_PREFIX`. | 2766 | is normally the same as :term:`TARGET_PREFIX`. |
| 2767 | 2767 | ||
| 2768 | HOST_SYS | 2768 | :term:`HOST_SYS` |
| 2769 | Specifies the system, including the architecture and the operating | 2769 | Specifies the system, including the architecture and the operating |
| 2770 | system, for which the build is occurring in the context of the | 2770 | system, for which the build is occurring in the context of the |
| 2771 | current recipe. | 2771 | current recipe. |
| @@ -2787,7 +2787,7 @@ system and gives an overview of their function and contents. | |||
| 2787 | - Given a recipe being built for a little-endian MIPS target running | 2787 | - Given a recipe being built for a little-endian MIPS target running |
| 2788 | Linux, the value might be "mipsel-linux". | 2788 | Linux, the value might be "mipsel-linux". |
| 2789 | 2789 | ||
| 2790 | HOSTTOOLS | 2790 | :term:`HOSTTOOLS` |
| 2791 | A space-separated list (filter) of tools on the build host that | 2791 | A space-separated list (filter) of tools on the build host that |
| 2792 | should be allowed to be called from within build tasks. Using this | 2792 | should be allowed to be called from within build tasks. Using this |
| 2793 | filter helps reduce the possibility of host contamination. If a tool | 2793 | filter helps reduce the possibility of host contamination. If a tool |
| @@ -2798,7 +2798,7 @@ system and gives an overview of their function and contents. | |||
| 2798 | For additional information, see | 2798 | For additional information, see |
| 2799 | :term:`HOSTTOOLS_NONFATAL`. | 2799 | :term:`HOSTTOOLS_NONFATAL`. |
| 2800 | 2800 | ||
| 2801 | HOSTTOOLS_NONFATAL | 2801 | :term:`HOSTTOOLS_NONFATAL` |
| 2802 | A space-separated list (filter) of tools on the build host that | 2802 | A space-separated list (filter) of tools on the build host that |
| 2803 | should be allowed to be called from within build tasks. Using this | 2803 | should be allowed to be called from within build tasks. Using this |
| 2804 | filter helps reduce the possibility of host contamination. Unlike | 2804 | filter helps reduce the possibility of host contamination. Unlike |
| @@ -2807,11 +2807,11 @@ system and gives an overview of their function and contents. | |||
| 2807 | ``HOSTTOOLS_NONFATAL`` is not found on the build host. Thus, you can | 2807 | ``HOSTTOOLS_NONFATAL`` is not found on the build host. Thus, you can |
| 2808 | use ``HOSTTOOLS_NONFATAL`` to filter optional host tools. | 2808 | use ``HOSTTOOLS_NONFATAL`` to filter optional host tools. |
| 2809 | 2809 | ||
| 2810 | HOST_VENDOR | 2810 | :term:`HOST_VENDOR` |
| 2811 | Specifies the name of the vendor. ``HOST_VENDOR`` is normally the | 2811 | Specifies the name of the vendor. ``HOST_VENDOR`` is normally the |
| 2812 | same as :term:`TARGET_VENDOR`. | 2812 | same as :term:`TARGET_VENDOR`. |
| 2813 | 2813 | ||
| 2814 | ICECC_DISABLED | 2814 | :term:`ICECC_DISABLED` |
| 2815 | Disables or enables the ``icecc`` (Icecream) function. For more | 2815 | Disables or enables the ``icecc`` (Icecream) function. For more |
| 2816 | information on this function and best practices for using this | 2816 | information on this function and best practices for using this |
| 2817 | variable, see the ":ref:`icecc.bbclass <ref-classes-icecc>`" | 2817 | variable, see the ":ref:`icecc.bbclass <ref-classes-icecc>`" |
| @@ -2828,7 +2828,7 @@ system and gives an overview of their function and contents. | |||
| 2828 | 2828 | ||
| 2829 | ICECC_DISABLED = "" | 2829 | ICECC_DISABLED = "" |
| 2830 | 2830 | ||
| 2831 | ICECC_ENV_EXEC | 2831 | :term:`ICECC_ENV_EXEC` |
| 2832 | Points to the ``icecc-create-env`` script that you provide. This | 2832 | Points to the ``icecc-create-env`` script that you provide. This |
| 2833 | variable is used by the :ref:`icecc <ref-classes-icecc>` class. You | 2833 | variable is used by the :ref:`icecc <ref-classes-icecc>` class. You |
| 2834 | set this variable in your ``local.conf`` file. | 2834 | set this variable in your ``local.conf`` file. |
| @@ -2838,7 +2838,7 @@ system and gives an overview of their function and contents. | |||
| 2838 | ``icecc-create-env.bb`` recipe, which is a modified version and not | 2838 | ``icecc-create-env.bb`` recipe, which is a modified version and not |
| 2839 | the one that comes with ``icecc``. | 2839 | the one that comes with ``icecc``. |
| 2840 | 2840 | ||
| 2841 | ICECC_PARALLEL_MAKE | 2841 | :term:`ICECC_PARALLEL_MAKE` |
| 2842 | Extra options passed to the ``make`` command during the | 2842 | Extra options passed to the ``make`` command during the |
| 2843 | :ref:`ref-tasks-compile` task that specify parallel | 2843 | :ref:`ref-tasks-compile` task that specify parallel |
| 2844 | compilation. This variable usually takes the form of "-j x", where x | 2844 | compilation. This variable usually takes the form of "-j x", where x |
| @@ -2864,13 +2864,13 @@ system and gives an overview of their function and contents. | |||
| 2864 | use it (i.e. the system does not detect and assign the number of | 2864 | use it (i.e. the system does not detect and assign the number of |
| 2865 | cores as is done with ``PARALLEL_MAKE``). | 2865 | cores as is done with ``PARALLEL_MAKE``). |
| 2866 | 2866 | ||
| 2867 | ICECC_PATH | 2867 | :term:`ICECC_PATH` |
| 2868 | The location of the ``icecc`` binary. You can set this variable in | 2868 | The location of the ``icecc`` binary. You can set this variable in |
| 2869 | your ``local.conf`` file. If your ``local.conf`` file does not define | 2869 | your ``local.conf`` file. If your ``local.conf`` file does not define |
| 2870 | this variable, the :ref:`icecc <ref-classes-icecc>` class attempts | 2870 | this variable, the :ref:`icecc <ref-classes-icecc>` class attempts |
| 2871 | to define it by locating ``icecc`` using ``which``. | 2871 | to define it by locating ``icecc`` using ``which``. |
| 2872 | 2872 | ||
| 2873 | ICECC_USER_CLASS_BL | 2873 | :term:`ICECC_USER_CLASS_BL` |
| 2874 | Identifies user classes that you do not want the Icecream distributed | 2874 | Identifies user classes that you do not want the Icecream distributed |
| 2875 | compile support to consider. This variable is used by the | 2875 | compile support to consider. This variable is used by the |
| 2876 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in | 2876 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in |
| @@ -2880,7 +2880,7 @@ system and gives an overview of their function and contents. | |||
| 2880 | them from distributed compilation across remote hosts. Any classes | 2880 | them from distributed compilation across remote hosts. Any classes |
| 2881 | you list will be distributed and compiled locally. | 2881 | you list will be distributed and compiled locally. |
| 2882 | 2882 | ||
| 2883 | ICECC_USER_PACKAGE_BL | 2883 | :term:`ICECC_USER_PACKAGE_BL` |
| 2884 | Identifies user recipes that you do not want the Icecream distributed | 2884 | Identifies user recipes that you do not want the Icecream distributed |
| 2885 | compile support to consider. This variable is used by the | 2885 | compile support to consider. This variable is used by the |
| 2886 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in | 2886 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in |
| @@ -2890,7 +2890,7 @@ system and gives an overview of their function and contents. | |||
| 2890 | them from distributed compilation across remote hosts. Any packages | 2890 | them from distributed compilation across remote hosts. Any packages |
| 2891 | you list will be distributed and compiled locally. | 2891 | you list will be distributed and compiled locally. |
| 2892 | 2892 | ||
| 2893 | ICECC_USER_PACKAGE_WL | 2893 | :term:`ICECC_USER_PACKAGE_WL` |
| 2894 | Identifies user recipes that use an empty | 2894 | Identifies user recipes that use an empty |
| 2895 | :term:`PARALLEL_MAKE` variable that you want to | 2895 | :term:`PARALLEL_MAKE` variable that you want to |
| 2896 | force remote distributed compilation on using the Icecream | 2896 | force remote distributed compilation on using the Icecream |
| @@ -2898,11 +2898,11 @@ system and gives an overview of their function and contents. | |||
| 2898 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in | 2898 | :ref:`icecc <ref-classes-icecc>` class. You set this variable in |
| 2899 | your ``local.conf`` file. | 2899 | your ``local.conf`` file. |
| 2900 | 2900 | ||
| 2901 | IMAGE_BASENAME | 2901 | :term:`IMAGE_BASENAME` |
| 2902 | The base name of image output files. This variable defaults to the | 2902 | The base name of image output files. This variable defaults to the |
| 2903 | recipe name (``${``\ :term:`PN`\ ``}``). | 2903 | recipe name (``${``\ :term:`PN`\ ``}``). |
| 2904 | 2904 | ||
| 2905 | IMAGE_BOOT_FILES | 2905 | :term:`IMAGE_BOOT_FILES` |
| 2906 | A space-separated list of files installed into the boot partition | 2906 | A space-separated list of files installed into the boot partition |
| 2907 | when preparing an image using the Wic tool with the | 2907 | when preparing an image using the Wic tool with the |
| 2908 | ``bootimg-partition`` or ``bootimg-efi`` source plugin. By default, | 2908 | ``bootimg-partition`` or ``bootimg-efi`` source plugin. By default, |
| @@ -2938,7 +2938,7 @@ system and gives an overview of their function and contents. | |||
| 2938 | material for Wic is located in the | 2938 | material for Wic is located in the |
| 2939 | ":doc:`../ref-manual/ref-kickstart`" chapter. | 2939 | ":doc:`../ref-manual/ref-kickstart`" chapter. |
| 2940 | 2940 | ||
| 2941 | IMAGE_CLASSES | 2941 | :term:`IMAGE_CLASSES` |
| 2942 | A list of classes that all images should inherit. You typically use | 2942 | A list of classes that all images should inherit. You typically use |
| 2943 | this variable to specify the list of classes that register the | 2943 | this variable to specify the list of classes that register the |
| 2944 | different types of images the OpenEmbedded build system creates. | 2944 | different types of images the OpenEmbedded build system creates. |
| @@ -2950,7 +2950,7 @@ system and gives an overview of their function and contents. | |||
| 2950 | For more information, see ``meta/classes/image_types.bbclass`` in the | 2950 | For more information, see ``meta/classes/image_types.bbclass`` in the |
| 2951 | :term:`Source Directory`. | 2951 | :term:`Source Directory`. |
| 2952 | 2952 | ||
| 2953 | IMAGE_CMD | 2953 | :term:`IMAGE_CMD` |
| 2954 | Specifies the command to create the image file for a specific image | 2954 | Specifies the command to create the image file for a specific image |
| 2955 | type, which corresponds to the value set set in | 2955 | type, which corresponds to the value set set in |
| 2956 | :term:`IMAGE_FSTYPES`, (e.g. ``ext3``, | 2956 | :term:`IMAGE_FSTYPES`, (e.g. ``ext3``, |
| @@ -2967,7 +2967,7 @@ system and gives an overview of their function and contents. | |||
| 2967 | variable, see the :ref:`image_types <ref-classes-image_types>` | 2967 | variable, see the :ref:`image_types <ref-classes-image_types>` |
| 2968 | class file, which is ``meta/classes/image_types.bbclass``. | 2968 | class file, which is ``meta/classes/image_types.bbclass``. |
| 2969 | 2969 | ||
| 2970 | IMAGE_DEVICE_TABLES | 2970 | :term:`IMAGE_DEVICE_TABLES` |
| 2971 | Specifies one or more files that contain custom device tables that | 2971 | Specifies one or more files that contain custom device tables that |
| 2972 | are passed to the ``makedevs`` command as part of creating an image. | 2972 | are passed to the ``makedevs`` command as part of creating an image. |
| 2973 | These files list basic device nodes that should be created under | 2973 | These files list basic device nodes that should be created under |
| @@ -2977,7 +2977,7 @@ system and gives an overview of their function and contents. | |||
| 2977 | device table files, see ``meta/files/device_table-minimal.txt`` as an | 2977 | device table files, see ``meta/files/device_table-minimal.txt`` as an |
| 2978 | example. | 2978 | example. |
| 2979 | 2979 | ||
| 2980 | IMAGE_FEATURES | 2980 | :term:`IMAGE_FEATURES` |
| 2981 | The primary list of features to include in an image. Typically, you | 2981 | The primary list of features to include in an image. Typically, you |
| 2982 | configure this variable in an image recipe. Although you can use this | 2982 | configure this variable in an image recipe. Although you can use this |
| 2983 | variable from your ``local.conf`` file, which is found in the | 2983 | variable from your ``local.conf`` file, which is found in the |
| @@ -2997,7 +2997,7 @@ system and gives an overview of their function and contents. | |||
| 2997 | variable, see the ":ref:`usingpoky-extend-customimage-imagefeatures`" | 2997 | variable, see the ":ref:`usingpoky-extend-customimage-imagefeatures`" |
| 2998 | section in the Yocto Project Development Tasks Manual. | 2998 | section in the Yocto Project Development Tasks Manual. |
| 2999 | 2999 | ||
| 3000 | IMAGE_FSTYPES | 3000 | :term:`IMAGE_FSTYPES` |
| 3001 | Specifies the formats the OpenEmbedded build system uses during the | 3001 | Specifies the formats the OpenEmbedded build system uses during the |
| 3002 | build when creating the root filesystem. For example, setting | 3002 | build when creating the root filesystem. For example, setting |
| 3003 | ``IMAGE_FSTYPES`` as follows causes the build system to create root | 3003 | ``IMAGE_FSTYPES`` as follows causes the build system to create root |
| @@ -3020,7 +3020,7 @@ system and gives an overview of their function and contents. | |||
| 3020 | or ``_prepend``. You must use the ``+=`` operator to add one or | 3020 | or ``_prepend``. You must use the ``+=`` operator to add one or |
| 3021 | more options to the ``IMAGE_FSTYPES`` variable. | 3021 | more options to the ``IMAGE_FSTYPES`` variable. |
| 3022 | 3022 | ||
| 3023 | IMAGE_INSTALL | 3023 | :term:`IMAGE_INSTALL` |
| 3024 | Used by recipes to specify the packages to install into an image | 3024 | Used by recipes to specify the packages to install into an image |
| 3025 | through the :ref:`image <ref-classes-image>` class. Use the | 3025 | through the :ref:`image <ref-classes-image>` class. Use the |
| 3026 | ``IMAGE_INSTALL`` variable with care to avoid ordering issues. | 3026 | ``IMAGE_INSTALL`` variable with care to avoid ordering issues. |
| @@ -3070,7 +3070,7 @@ system and gives an overview of their function and contents. | |||
| 3070 | specific situation. In both these cases, the behavior is | 3070 | specific situation. In both these cases, the behavior is |
| 3071 | contrary to how most users expect the ``+=`` operator to work. | 3071 | contrary to how most users expect the ``+=`` operator to work. |
| 3072 | 3072 | ||
| 3073 | IMAGE_LINGUAS | 3073 | :term:`IMAGE_LINGUAS` |
| 3074 | Specifies the list of locales to install into the image during the | 3074 | Specifies the list of locales to install into the image during the |
| 3075 | root filesystem construction process. The OpenEmbedded build system | 3075 | root filesystem construction process. The OpenEmbedded build system |
| 3076 | automatically splits locale files, which are used for localization, | 3076 | automatically splits locale files, which are used for localization, |
| @@ -3092,7 +3092,7 @@ system and gives an overview of their function and contents. | |||
| 3092 | See the :term:`GLIBC_GENERATE_LOCALES` | 3092 | See the :term:`GLIBC_GENERATE_LOCALES` |
| 3093 | variable for information on generating GLIBC locales. | 3093 | variable for information on generating GLIBC locales. |
| 3094 | 3094 | ||
| 3095 | IMAGE_MANIFEST | 3095 | :term:`IMAGE_MANIFEST` |
| 3096 | The manifest file for the image. This file lists all the installed | 3096 | The manifest file for the image. This file lists all the installed |
| 3097 | packages that make up the image. The file contains package | 3097 | packages that make up the image. The file contains package |
| 3098 | information on a line-per-package basis as follows: | 3098 | information on a line-per-package basis as follows: |
| @@ -3112,7 +3112,7 @@ system and gives an overview of their function and contents. | |||
| 3112 | information on how the image is created in the ":ref:`image-generation-dev-environment`" | 3112 | information on how the image is created in the ":ref:`image-generation-dev-environment`" |
| 3113 | section in the Yocto Project Overview and Concepts Manual. | 3113 | section in the Yocto Project Overview and Concepts Manual. |
| 3114 | 3114 | ||
| 3115 | IMAGE_NAME | 3115 | :term:`IMAGE_NAME` |
| 3116 | The name of the output image files minus the extension. This variable | 3116 | The name of the output image files minus the extension. This variable |
| 3117 | is derived using the :term:`IMAGE_BASENAME`, | 3117 | is derived using the :term:`IMAGE_BASENAME`, |
| 3118 | :term:`MACHINE`, and :term:`DATETIME` | 3118 | :term:`MACHINE`, and :term:`DATETIME` |
| @@ -3121,7 +3121,7 @@ system and gives an overview of their function and contents. | |||
| 3121 | 3121 | ||
| 3122 | IMAGE_NAME = "${IMAGE_BASENAME}-${MACHINE}-${DATETIME}" | 3122 | IMAGE_NAME = "${IMAGE_BASENAME}-${MACHINE}-${DATETIME}" |
| 3123 | 3123 | ||
| 3124 | IMAGE_OVERHEAD_FACTOR | 3124 | :term:`IMAGE_OVERHEAD_FACTOR` |
| 3125 | Defines a multiplier that the build system applies to the initial | 3125 | Defines a multiplier that the build system applies to the initial |
| 3126 | image size for cases when the multiplier times the returned disk | 3126 | image size for cases when the multiplier times the returned disk |
| 3127 | usage value for the image is greater than the sum of | 3127 | usage value for the image is greater than the sum of |
| @@ -3150,7 +3150,7 @@ system and gives an overview of their function and contents. | |||
| 3150 | added to the image by using the ``IMAGE_ROOTFS_EXTRA_SPACE`` | 3150 | added to the image by using the ``IMAGE_ROOTFS_EXTRA_SPACE`` |
| 3151 | variable. | 3151 | variable. |
| 3152 | 3152 | ||
| 3153 | IMAGE_PKGTYPE | 3153 | :term:`IMAGE_PKGTYPE` |
| 3154 | Defines the package type (i.e. DEB, RPM, IPK, or TAR) used by the | 3154 | Defines the package type (i.e. DEB, RPM, IPK, or TAR) used by the |
| 3155 | OpenEmbedded build system. The variable is defined appropriately by | 3155 | OpenEmbedded build system. The variable is defined appropriately by |
| 3156 | the :ref:`package_deb <ref-classes-package_deb>`, | 3156 | the :ref:`package_deb <ref-classes-package_deb>`, |
| @@ -3183,7 +3183,7 @@ system and gives an overview of their function and contents. | |||
| 3183 | format are never used as a substitute packaging format for DEB, | 3183 | format are never used as a substitute packaging format for DEB, |
| 3184 | RPM, and IPK formatted files for your image or SDK. | 3184 | RPM, and IPK formatted files for your image or SDK. |
| 3185 | 3185 | ||
| 3186 | IMAGE_POSTPROCESS_COMMAND | 3186 | :term:`IMAGE_POSTPROCESS_COMMAND` |
| 3187 | Specifies a list of functions to call once the OpenEmbedded build | 3187 | Specifies a list of functions to call once the OpenEmbedded build |
| 3188 | system creates the final image output files. You can specify | 3188 | system creates the final image output files. You can specify |
| 3189 | functions separated by semicolons: | 3189 | functions separated by semicolons: |
| @@ -3197,7 +3197,7 @@ system and gives an overview of their function and contents. | |||
| 3197 | :term:`IMAGE_ROOTFS` variable for more | 3197 | :term:`IMAGE_ROOTFS` variable for more |
| 3198 | information. | 3198 | information. |
| 3199 | 3199 | ||
| 3200 | IMAGE_PREPROCESS_COMMAND | 3200 | :term:`IMAGE_PREPROCESS_COMMAND` |
| 3201 | Specifies a list of functions to call before the OpenEmbedded build | 3201 | Specifies a list of functions to call before the OpenEmbedded build |
| 3202 | system creates the final image output files. You can specify | 3202 | system creates the final image output files. You can specify |
| 3203 | functions separated by semicolons: | 3203 | functions separated by semicolons: |
| @@ -3211,19 +3211,19 @@ system and gives an overview of their function and contents. | |||
| 3211 | :term:`IMAGE_ROOTFS` variable for more | 3211 | :term:`IMAGE_ROOTFS` variable for more |
| 3212 | information. | 3212 | information. |
| 3213 | 3213 | ||
| 3214 | IMAGE_ROOTFS | 3214 | :term:`IMAGE_ROOTFS` |
| 3215 | The location of the root filesystem while it is under construction | 3215 | The location of the root filesystem while it is under construction |
| 3216 | (i.e. during the :ref:`ref-tasks-rootfs` task). This | 3216 | (i.e. during the :ref:`ref-tasks-rootfs` task). This |
| 3217 | variable is not configurable. Do not change it. | 3217 | variable is not configurable. Do not change it. |
| 3218 | 3218 | ||
| 3219 | IMAGE_ROOTFS_ALIGNMENT | 3219 | :term:`IMAGE_ROOTFS_ALIGNMENT` |
| 3220 | Specifies the alignment for the output image file in Kbytes. If the | 3220 | Specifies the alignment for the output image file in Kbytes. If the |
| 3221 | size of the image is not a multiple of this value, then the size is | 3221 | size of the image is not a multiple of this value, then the size is |
| 3222 | rounded up to the nearest multiple of the value. The default value is | 3222 | rounded up to the nearest multiple of the value. The default value is |
| 3223 | "1". See :term:`IMAGE_ROOTFS_SIZE` for | 3223 | "1". See :term:`IMAGE_ROOTFS_SIZE` for |
| 3224 | additional information. | 3224 | additional information. |
| 3225 | 3225 | ||
| 3226 | IMAGE_ROOTFS_EXTRA_SPACE | 3226 | :term:`IMAGE_ROOTFS_EXTRA_SPACE` |
| 3227 | Defines additional free disk space created in the image in Kbytes. By | 3227 | Defines additional free disk space created in the image in Kbytes. By |
| 3228 | default, this variable is set to "0". This free disk space is added | 3228 | default, this variable is set to "0". This free disk space is added |
| 3229 | to the image after the build system determines the image size as | 3229 | to the image after the build system determines the image size as |
| @@ -3243,7 +3243,7 @@ system and gives an overview of their function and contents. | |||
| 3243 | 3243 | ||
| 3244 | IMAGE_ROOTFS_EXTRA_SPACE = "41943040" | 3244 | IMAGE_ROOTFS_EXTRA_SPACE = "41943040" |
| 3245 | 3245 | ||
| 3246 | IMAGE_ROOTFS_SIZE | 3246 | :term:`IMAGE_ROOTFS_SIZE` |
| 3247 | Defines the size in Kbytes for the generated image. The OpenEmbedded | 3247 | Defines the size in Kbytes for the generated image. The OpenEmbedded |
| 3248 | build system determines the final size for the generated image using | 3248 | build system determines the final size for the generated image using |
| 3249 | an algorithm that takes into account the initial disk space used for | 3249 | an algorithm that takes into account the initial disk space used for |
| @@ -3268,7 +3268,7 @@ system and gives an overview of their function and contents. | |||
| 3268 | and :term:`IMAGE_ROOTFS_EXTRA_SPACE` | 3268 | and :term:`IMAGE_ROOTFS_EXTRA_SPACE` |
| 3269 | variables for related information. | 3269 | variables for related information. |
| 3270 | 3270 | ||
| 3271 | IMAGE_TYPEDEP | 3271 | :term:`IMAGE_TYPEDEP` |
| 3272 | Specifies a dependency from one image type on another. Here is an | 3272 | Specifies a dependency from one image type on another. Here is an |
| 3273 | example from the :ref:`image-live <ref-classes-image-live>` class: | 3273 | example from the :ref:`image-live <ref-classes-image-live>` class: |
| 3274 | :: | 3274 | :: |
| @@ -3281,7 +3281,7 @@ system and gives an overview of their function and contents. | |||
| 3281 | one of the components of the live image is an ``ext3`` formatted | 3281 | one of the components of the live image is an ``ext3`` formatted |
| 3282 | partition containing the root filesystem. | 3282 | partition containing the root filesystem. |
| 3283 | 3283 | ||
| 3284 | IMAGE_TYPES | 3284 | :term:`IMAGE_TYPES` |
| 3285 | Specifies the complete list of supported image types by default: | 3285 | Specifies the complete list of supported image types by default: |
| 3286 | 3286 | ||
| 3287 | - btrfs | 3287 | - btrfs |
| @@ -3326,7 +3326,7 @@ system and gives an overview of their function and contents. | |||
| 3326 | For more information about these types of images, see | 3326 | For more information about these types of images, see |
| 3327 | ``meta/classes/image_types*.bbclass`` in the :term:`Source Directory`. | 3327 | ``meta/classes/image_types*.bbclass`` in the :term:`Source Directory`. |
| 3328 | 3328 | ||
| 3329 | INC_PR | 3329 | :term:`INC_PR` |
| 3330 | Helps define the recipe revision for recipes that share a common | 3330 | Helps define the recipe revision for recipes that share a common |
| 3331 | ``include`` file. You can think of this variable as part of the | 3331 | ``include`` file. You can think of this variable as part of the |
| 3332 | recipe revision as set from within an include file. | 3332 | recipe revision as set from within an include file. |
| @@ -3364,7 +3364,7 @@ system and gives an overview of their function and contents. | |||
| 3364 | lines in the example are from individual recipes and show how the | 3364 | lines in the example are from individual recipes and show how the |
| 3365 | ``PR`` value is set. | 3365 | ``PR`` value is set. |
| 3366 | 3366 | ||
| 3367 | INCOMPATIBLE_LICENSE | 3367 | :term:`INCOMPATIBLE_LICENSE` |
| 3368 | Specifies a space-separated list of license names (as they would | 3368 | Specifies a space-separated list of license names (as they would |
| 3369 | appear in :term:`LICENSE`) that should be excluded | 3369 | appear in :term:`LICENSE`) that should be excluded |
| 3370 | from the build. Recipes that provide no alternatives to listed | 3370 | from the build. Recipes that provide no alternatives to listed |
| @@ -3406,7 +3406,7 @@ system and gives an overview of their function and contents. | |||
| 3406 | COMPATIBLE_LICENSES | 3406 | COMPATIBLE_LICENSES |
| 3407 | , thus only allowing the latter licences to be used. | 3407 | , thus only allowing the latter licences to be used. |
| 3408 | 3408 | ||
| 3409 | INHERIT | 3409 | :term:`INHERIT` |
| 3410 | Causes the named class or classes to be inherited globally. Anonymous | 3410 | Causes the named class or classes to be inherited globally. Anonymous |
| 3411 | functions in the class or classes are not executed for the base | 3411 | functions in the class or classes are not executed for the base |
| 3412 | configuration and in each individual recipe. The OpenEmbedded build | 3412 | configuration and in each individual recipe. The OpenEmbedded build |
| @@ -3416,7 +3416,7 @@ system and gives an overview of their function and contents. | |||
| 3416 | :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:\`\`inherit\`\` configuration directive`" | 3416 | :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:\`\`inherit\`\` configuration directive`" |
| 3417 | section in the Bitbake User Manual. | 3417 | section in the Bitbake User Manual. |
| 3418 | 3418 | ||
| 3419 | INHERIT_DISTRO | 3419 | :term:`INHERIT_DISTRO` |
| 3420 | Lists classes that will be inherited at the distribution level. It is | 3420 | Lists classes that will be inherited at the distribution level. It is |
| 3421 | unlikely that you want to edit this variable. | 3421 | unlikely that you want to edit this variable. |
| 3422 | 3422 | ||
| @@ -3426,7 +3426,7 @@ system and gives an overview of their function and contents. | |||
| 3426 | 3426 | ||
| 3427 | INHERIT_DISTRO ?= "debian devshell sstate license" | 3427 | INHERIT_DISTRO ?= "debian devshell sstate license" |
| 3428 | 3428 | ||
| 3429 | INHIBIT_DEFAULT_DEPS | 3429 | :term:`INHIBIT_DEFAULT_DEPS` |
| 3430 | Prevents the default dependencies, namely the C compiler and standard | 3430 | Prevents the default dependencies, namely the C compiler and standard |
| 3431 | C library (libc), from being added to :term:`DEPENDS`. | 3431 | C library (libc), from being added to :term:`DEPENDS`. |
| 3432 | This variable is usually used within recipes that do not require any | 3432 | This variable is usually used within recipes that do not require any |
| @@ -3435,7 +3435,7 @@ system and gives an overview of their function and contents. | |||
| 3435 | Set the variable to "1" to prevent the default dependencies from | 3435 | Set the variable to "1" to prevent the default dependencies from |
| 3436 | being added. | 3436 | being added. |
| 3437 | 3437 | ||
| 3438 | INHIBIT_PACKAGE_DEBUG_SPLIT | 3438 | :term:`INHIBIT_PACKAGE_DEBUG_SPLIT` |
| 3439 | Prevents the OpenEmbedded build system from splitting out debug | 3439 | Prevents the OpenEmbedded build system from splitting out debug |
| 3440 | information during packaging. By default, the build system splits out | 3440 | information during packaging. By default, the build system splits out |
| 3441 | debugging information during the | 3441 | debugging information during the |
| @@ -3451,7 +3451,7 @@ system and gives an overview of their function and contents. | |||
| 3451 | 3451 | ||
| 3452 | INHIBIT_PACKAGE_DEBUG_SPLIT = "1" | 3452 | INHIBIT_PACKAGE_DEBUG_SPLIT = "1" |
| 3453 | 3453 | ||
| 3454 | INHIBIT_PACKAGE_STRIP | 3454 | :term:`INHIBIT_PACKAGE_STRIP` |
| 3455 | If set to "1", causes the build to not strip binaries in resulting | 3455 | If set to "1", causes the build to not strip binaries in resulting |
| 3456 | packages and prevents the ``-dbg`` package from containing the source | 3456 | packages and prevents the ``-dbg`` package from containing the source |
| 3457 | files. | 3457 | files. |
| @@ -3461,7 +3461,7 @@ system and gives an overview of their function and contents. | |||
| 3461 | Consequently, you should not set ``INHIBIT_PACKAGE_STRIP`` when you | 3461 | Consequently, you should not set ``INHIBIT_PACKAGE_STRIP`` when you |
| 3462 | plan to debug in general. | 3462 | plan to debug in general. |
| 3463 | 3463 | ||
| 3464 | INHIBIT_SYSROOT_STRIP | 3464 | :term:`INHIBIT_SYSROOT_STRIP` |
| 3465 | If set to "1", causes the build to not strip binaries in the | 3465 | If set to "1", causes the build to not strip binaries in the |
| 3466 | resulting sysroot. | 3466 | resulting sysroot. |
| 3467 | 3467 | ||
| @@ -3485,7 +3485,7 @@ system and gives an overview of their function and contents. | |||
| 3485 | strippable, other files exist that are needed for the build that | 3485 | strippable, other files exist that are needed for the build that |
| 3486 | are not strippable. | 3486 | are not strippable. |
| 3487 | 3487 | ||
| 3488 | INITRAMFS_FSTYPES | 3488 | :term:`INITRAMFS_FSTYPES` |
| 3489 | Defines the format for the output image of an initial RAM filesystem | 3489 | Defines the format for the output image of an initial RAM filesystem |
| 3490 | (initramfs), which is used during boot. Supported formats are the | 3490 | (initramfs), which is used during boot. Supported formats are the |
| 3491 | same as those supported by the | 3491 | same as those supported by the |
| @@ -3498,7 +3498,7 @@ system and gives an overview of their function and contents. | |||
| 3498 | `initrd <https://en.wikipedia.org/wiki/Initrd>`__ mechanism, expects | 3498 | `initrd <https://en.wikipedia.org/wiki/Initrd>`__ mechanism, expects |
| 3499 | an optionally compressed cpio archive. | 3499 | an optionally compressed cpio archive. |
| 3500 | 3500 | ||
| 3501 | INITRAMFS_IMAGE | 3501 | :term:`INITRAMFS_IMAGE` |
| 3502 | Specifies the :term:`PROVIDES` name of an image | 3502 | Specifies the :term:`PROVIDES` name of an image |
| 3503 | recipe that is used to build an initial RAM filesystem (initramfs) | 3503 | recipe that is used to build an initial RAM filesystem (initramfs) |
| 3504 | image. In other words, the ``INITRAMFS_IMAGE`` variable causes an | 3504 | image. In other words, the ``INITRAMFS_IMAGE`` variable causes an |
| @@ -3539,7 +3539,7 @@ system and gives an overview of their function and contents. | |||
| 3539 | image, see the ":ref:`building-an-initramfs-image`" section | 3539 | image, see the ":ref:`building-an-initramfs-image`" section |
| 3540 | in the Yocto Project Development Tasks Manual. | 3540 | in the Yocto Project Development Tasks Manual. |
| 3541 | 3541 | ||
| 3542 | INITRAMFS_IMAGE_BUNDLE | 3542 | :term:`INITRAMFS_IMAGE_BUNDLE` |
| 3543 | Controls whether or not the image recipe specified by | 3543 | Controls whether or not the image recipe specified by |
| 3544 | :term:`INITRAMFS_IMAGE` is run through an | 3544 | :term:`INITRAMFS_IMAGE` is run through an |
| 3545 | extra pass | 3545 | extra pass |
| @@ -3589,7 +3589,7 @@ system and gives an overview of their function and contents. | |||
| 3589 | initramfs, see the ":ref:`building-an-initramfs-image`" section | 3589 | initramfs, see the ":ref:`building-an-initramfs-image`" section |
| 3590 | in the Yocto Project Development Tasks Manual. | 3590 | in the Yocto Project Development Tasks Manual. |
| 3591 | 3591 | ||
| 3592 | INITRAMFS_LINK_NAME | 3592 | :term:`INITRAMFS_LINK_NAME` |
| 3593 | The link name of the initial RAM filesystem image. This variable is | 3593 | The link name of the initial RAM filesystem image. This variable is |
| 3594 | set in the ``meta/classes/kernel-artifact-names.bbclass`` file as | 3594 | set in the ``meta/classes/kernel-artifact-names.bbclass`` file as |
| 3595 | follows: | 3595 | follows: |
| @@ -3607,7 +3607,7 @@ system and gives an overview of their function and contents. | |||
| 3607 | See the :term:`MACHINE` variable for additional | 3607 | See the :term:`MACHINE` variable for additional |
| 3608 | information. | 3608 | information. |
| 3609 | 3609 | ||
| 3610 | INITRAMFS_NAME | 3610 | :term:`INITRAMFS_NAME` |
| 3611 | The base name of the initial RAM filesystem image. This variable is | 3611 | The base name of the initial RAM filesystem image. This variable is |
| 3612 | set in the ``meta/classes/kernel-artifact-names.bbclass`` file as | 3612 | set in the ``meta/classes/kernel-artifact-names.bbclass`` file as |
| 3613 | follows: | 3613 | follows: |
| @@ -3621,14 +3621,14 @@ system and gives an overview of their function and contents. | |||
| 3621 | 3621 | ||
| 3622 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" | 3622 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" |
| 3623 | 3623 | ||
| 3624 | INITRD | 3624 | :term:`INITRD` |
| 3625 | Indicates list of filesystem images to concatenate and use as an | 3625 | Indicates list of filesystem images to concatenate and use as an |
| 3626 | initial RAM disk (``initrd``). | 3626 | initial RAM disk (``initrd``). |
| 3627 | 3627 | ||
| 3628 | The ``INITRD`` variable is an optional variable used with the | 3628 | The ``INITRD`` variable is an optional variable used with the |
| 3629 | :ref:`image-live <ref-classes-image-live>` class. | 3629 | :ref:`image-live <ref-classes-image-live>` class. |
| 3630 | 3630 | ||
| 3631 | INITRD_IMAGE | 3631 | :term:`INITRD_IMAGE` |
| 3632 | When building a "live" bootable image (i.e. when | 3632 | When building a "live" bootable image (i.e. when |
| 3633 | :term:`IMAGE_FSTYPES` contains "live"), | 3633 | :term:`IMAGE_FSTYPES` contains "live"), |
| 3634 | ``INITRD_IMAGE`` specifies the image recipe that should be built to | 3634 | ``INITRD_IMAGE`` specifies the image recipe that should be built to |
| @@ -3638,14 +3638,14 @@ system and gives an overview of their function and contents. | |||
| 3638 | See the :ref:`image-live <ref-classes-image-live>` class for more | 3638 | See the :ref:`image-live <ref-classes-image-live>` class for more |
| 3639 | information. | 3639 | information. |
| 3640 | 3640 | ||
| 3641 | INITSCRIPT_NAME | 3641 | :term:`INITSCRIPT_NAME` |
| 3642 | The filename of the initialization script as installed to | 3642 | The filename of the initialization script as installed to |
| 3643 | ``${sysconfdir}/init.d``. | 3643 | ``${sysconfdir}/init.d``. |
| 3644 | 3644 | ||
| 3645 | This variable is used in recipes when using ``update-rc.d.bbclass``. | 3645 | This variable is used in recipes when using ``update-rc.d.bbclass``. |
| 3646 | The variable is mandatory. | 3646 | The variable is mandatory. |
| 3647 | 3647 | ||
| 3648 | INITSCRIPT_PACKAGES | 3648 | :term:`INITSCRIPT_PACKAGES` |
| 3649 | A list of the packages that contain initscripts. If multiple packages | 3649 | A list of the packages that contain initscripts. If multiple packages |
| 3650 | are specified, you need to append the package name to the other | 3650 | are specified, you need to append the package name to the other |
| 3651 | ``INITSCRIPT_*`` as an override. | 3651 | ``INITSCRIPT_*`` as an override. |
| @@ -3654,7 +3654,7 @@ system and gives an overview of their function and contents. | |||
| 3654 | The variable is optional and defaults to the :term:`PN` | 3654 | The variable is optional and defaults to the :term:`PN` |
| 3655 | variable. | 3655 | variable. |
| 3656 | 3656 | ||
| 3657 | INITSCRIPT_PARAMS | 3657 | :term:`INITSCRIPT_PARAMS` |
| 3658 | Specifies the options to pass to ``update-rc.d``. Here is an example: | 3658 | Specifies the options to pass to ``update-rc.d``. Here is an example: |
| 3659 | :: | 3659 | :: |
| 3660 | 3660 | ||
| @@ -3671,7 +3671,7 @@ system and gives an overview of their function and contents. | |||
| 3671 | please see the ``update-rc.d`` manual page at | 3671 | please see the ``update-rc.d`` manual page at |
| 3672 | https://manpages.debian.org/buster/init-system-helpers/update-rc.d.8.en.html | 3672 | https://manpages.debian.org/buster/init-system-helpers/update-rc.d.8.en.html |
| 3673 | 3673 | ||
| 3674 | INSANE_SKIP | 3674 | :term:`INSANE_SKIP` |
| 3675 | Specifies the QA checks to skip for a specific package within a | 3675 | Specifies the QA checks to skip for a specific package within a |
| 3676 | recipe. For example, to skip the check for symbolic link ``.so`` | 3676 | recipe. For example, to skip the check for symbolic link ``.so`` |
| 3677 | files in the main package of a recipe, add the following to the | 3677 | files in the main package of a recipe, add the following to the |
| @@ -3684,19 +3684,19 @@ system and gives an overview of their function and contents. | |||
| 3684 | See the ":ref:`insane.bbclass <ref-classes-insane>`" section for a | 3684 | See the ":ref:`insane.bbclass <ref-classes-insane>`" section for a |
| 3685 | list of the valid QA checks you can specify using this variable. | 3685 | list of the valid QA checks you can specify using this variable. |
| 3686 | 3686 | ||
| 3687 | INSTALL_TIMEZONE_FILE | 3687 | :term:`INSTALL_TIMEZONE_FILE` |
| 3688 | By default, the ``tzdata`` recipe packages an ``/etc/timezone`` file. | 3688 | By default, the ``tzdata`` recipe packages an ``/etc/timezone`` file. |
| 3689 | Set the ``INSTALL_TIMEZONE_FILE`` variable to "0" at the | 3689 | Set the ``INSTALL_TIMEZONE_FILE`` variable to "0" at the |
| 3690 | configuration level to disable this behavior. | 3690 | configuration level to disable this behavior. |
| 3691 | 3691 | ||
| 3692 | IPK_FEED_URIS | 3692 | :term:`IPK_FEED_URIS` |
| 3693 | When the IPK backend is in use and package management is enabled on | 3693 | When the IPK backend is in use and package management is enabled on |
| 3694 | the target, you can use this variable to set up ``opkg`` in the | 3694 | the target, you can use this variable to set up ``opkg`` in the |
| 3695 | target image to point to package feeds on a nominated server. Once | 3695 | target image to point to package feeds on a nominated server. Once |
| 3696 | the feed is established, you can perform installations or upgrades | 3696 | the feed is established, you can perform installations or upgrades |
| 3697 | using the package manager at runtime. | 3697 | using the package manager at runtime. |
| 3698 | 3698 | ||
| 3699 | KARCH | 3699 | :term:`KARCH` |
| 3700 | Defines the kernel architecture used when assembling the | 3700 | Defines the kernel architecture used when assembling the |
| 3701 | configuration. Architectures supported for this release are: | 3701 | configuration. Architectures supported for this release are: |
| 3702 | 3702 | ||
| @@ -3709,7 +3709,7 @@ system and gives an overview of their function and contents. | |||
| 3709 | 3709 | ||
| 3710 | You define the ``KARCH`` variable in the :ref:`kernel-dev/kernel-dev-advanced:bsp descriptions`. | 3710 | You define the ``KARCH`` variable in the :ref:`kernel-dev/kernel-dev-advanced:bsp descriptions`. |
| 3711 | 3711 | ||
| 3712 | KBRANCH | 3712 | :term:`KBRANCH` |
| 3713 | A regular expression used by the build process to explicitly identify | 3713 | A regular expression used by the build process to explicitly identify |
| 3714 | the kernel branch that is validated, patched, and configured during a | 3714 | the kernel branch that is validated, patched, and configured during a |
| 3715 | build. You must set this variable to ensure the exact kernel branch | 3715 | build. You must set this variable to ensure the exact kernel branch |
| @@ -3744,7 +3744,7 @@ system and gives an overview of their function and contents. | |||
| 3744 | identify the kernel branch to use when building for each supported | 3744 | identify the kernel branch to use when building for each supported |
| 3745 | BSP. | 3745 | BSP. |
| 3746 | 3746 | ||
| 3747 | KBUILD_DEFCONFIG | 3747 | :term:`KBUILD_DEFCONFIG` |
| 3748 | When used with the :ref:`kernel-yocto <ref-classes-kernel-yocto>` | 3748 | When used with the :ref:`kernel-yocto <ref-classes-kernel-yocto>` |
| 3749 | class, specifies an "in-tree" kernel configuration file for use | 3749 | class, specifies an "in-tree" kernel configuration file for use |
| 3750 | during a kernel build. | 3750 | during a kernel build. |
| @@ -3780,12 +3780,12 @@ system and gives an overview of their function and contents. | |||
| 3780 | ":ref:`kernel-dev/kernel-dev-common:using an "in-tree" \`\`defconfig\`\` file`" | 3780 | ":ref:`kernel-dev/kernel-dev-common:using an "in-tree" \`\`defconfig\`\` file`" |
| 3781 | section in the Yocto Project Linux Kernel Development Manual. | 3781 | section in the Yocto Project Linux Kernel Development Manual. |
| 3782 | 3782 | ||
| 3783 | KERNEL_ALT_IMAGETYPE | 3783 | :term:`KERNEL_ALT_IMAGETYPE` |
| 3784 | Specifies an alternate kernel image type for creation in addition to | 3784 | Specifies an alternate kernel image type for creation in addition to |
| 3785 | the kernel image type specified using the | 3785 | the kernel image type specified using the |
| 3786 | :term:`KERNEL_IMAGETYPE` variable. | 3786 | :term:`KERNEL_IMAGETYPE` variable. |
| 3787 | 3787 | ||
| 3788 | KERNEL_ARTIFACT_NAME | 3788 | :term:`KERNEL_ARTIFACT_NAME` |
| 3789 | Specifies the name of all of the build artifacts. You can change the | 3789 | Specifies the name of all of the build artifacts. You can change the |
| 3790 | name of the artifacts by changing the ``KERNEL_ARTIFACT_NAME`` | 3790 | name of the artifacts by changing the ``KERNEL_ARTIFACT_NAME`` |
| 3791 | variable. | 3791 | variable. |
| @@ -3804,7 +3804,7 @@ system and gives an overview of their function and contents. | |||
| 3804 | 3804 | ||
| 3805 | The IMAGE_VERSION_SUFFIX variable is set to DATETIME. | 3805 | The IMAGE_VERSION_SUFFIX variable is set to DATETIME. |
| 3806 | 3806 | ||
| 3807 | KERNEL_CLASSES | 3807 | :term:`KERNEL_CLASSES` |
| 3808 | A list of classes defining kernel image types that the | 3808 | A list of classes defining kernel image types that the |
| 3809 | :ref:`kernel <ref-classes-kernel>` class should inherit. You | 3809 | :ref:`kernel <ref-classes-kernel>` class should inherit. You |
| 3810 | typically append this variable to enable extended image types. An | 3810 | typically append this variable to enable extended image types. An |
| @@ -3813,7 +3813,7 @@ system and gives an overview of their function and contents. | |||
| 3813 | custom kernel image types with the ``kernel`` class using this | 3813 | custom kernel image types with the ``kernel`` class using this |
| 3814 | variable. | 3814 | variable. |
| 3815 | 3815 | ||
| 3816 | KERNEL_DEVICETREE | 3816 | :term:`KERNEL_DEVICETREE` |
| 3817 | Specifies the name of the generated Linux kernel device tree (i.e. | 3817 | Specifies the name of the generated Linux kernel device tree (i.e. |
| 3818 | the ``.dtb``) file. | 3818 | the ``.dtb``) file. |
| 3819 | 3819 | ||
| @@ -3826,7 +3826,7 @@ system and gives an overview of their function and contents. | |||
| 3826 | :ref:`kernel-devicetree <ref-classes-kernel-devicetree>` class must | 3826 | :ref:`kernel-devicetree <ref-classes-kernel-devicetree>` class must |
| 3827 | be inherited. | 3827 | be inherited. |
| 3828 | 3828 | ||
| 3829 | KERNEL_DTB_LINK_NAME | 3829 | :term:`KERNEL_DTB_LINK_NAME` |
| 3830 | The link name of the kernel device tree binary (DTB). This variable | 3830 | The link name of the kernel device tree binary (DTB). This variable |
| 3831 | is set in the ``meta/classes/kernel-artifact-names.bbclass`` file as | 3831 | is set in the ``meta/classes/kernel-artifact-names.bbclass`` file as |
| 3832 | follows: | 3832 | follows: |
| @@ -3844,7 +3844,7 @@ system and gives an overview of their function and contents. | |||
| 3844 | See the :term:`MACHINE` variable for additional | 3844 | See the :term:`MACHINE` variable for additional |
| 3845 | information. | 3845 | information. |
| 3846 | 3846 | ||
| 3847 | KERNEL_DTB_NAME | 3847 | :term:`KERNEL_DTB_NAME` |
| 3848 | The base name of the kernel device tree binary (DTB). This variable | 3848 | The base name of the kernel device tree binary (DTB). This variable |
| 3849 | is set in the ``meta/classes/kernel-artifact-names.bbclass`` file as | 3849 | is set in the ``meta/classes/kernel-artifact-names.bbclass`` file as |
| 3850 | follows: | 3850 | follows: |
| @@ -3858,11 +3858,11 @@ system and gives an overview of their function and contents. | |||
| 3858 | 3858 | ||
| 3859 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" | 3859 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" |
| 3860 | 3860 | ||
| 3861 | KERNEL_EXTRA_ARGS | 3861 | :term:`KERNEL_EXTRA_ARGS` |
| 3862 | Specifies additional ``make`` command-line arguments the OpenEmbedded | 3862 | Specifies additional ``make`` command-line arguments the OpenEmbedded |
| 3863 | build system passes on when compiling the kernel. | 3863 | build system passes on when compiling the kernel. |
| 3864 | 3864 | ||
| 3865 | KERNEL_FEATURES | 3865 | :term:`KERNEL_FEATURES` |
| 3866 | Includes additional kernel metadata. In the OpenEmbedded build | 3866 | Includes additional kernel metadata. In the OpenEmbedded build |
| 3867 | system, the default Board Support Packages (BSPs) | 3867 | system, the default Board Support Packages (BSPs) |
| 3868 | :term:`Metadata` is provided through the | 3868 | :term:`Metadata` is provided through the |
| @@ -3889,7 +3889,7 @@ system and gives an overview of their function and contents. | |||
| 3889 | KERNEL_FEATURES_append_qemux86 = " cfg/sound.scc cfg/paravirt_kvm.scc" | 3889 | KERNEL_FEATURES_append_qemux86 = " cfg/sound.scc cfg/paravirt_kvm.scc" |
| 3890 | KERNEL_FEATURES_append_qemux86-64 = "cfg/sound.scc" | 3890 | KERNEL_FEATURES_append_qemux86-64 = "cfg/sound.scc" |
| 3891 | 3891 | ||
| 3892 | KERNEL_FIT_LINK_NAME | 3892 | :term:`KERNEL_FIT_LINK_NAME` |
| 3893 | The link name of the kernel flattened image tree (FIT) image. This | 3893 | The link name of the kernel flattened image tree (FIT) image. This |
| 3894 | variable is set in the ``meta/classes/kernel-artifact-names.bbclass`` | 3894 | variable is set in the ``meta/classes/kernel-artifact-names.bbclass`` |
| 3895 | file as follows: | 3895 | file as follows: |
| @@ -3907,7 +3907,7 @@ system and gives an overview of their function and contents. | |||
| 3907 | See the :term:`MACHINE` variable for additional | 3907 | See the :term:`MACHINE` variable for additional |
| 3908 | information. | 3908 | information. |
| 3909 | 3909 | ||
| 3910 | KERNEL_FIT_NAME | 3910 | :term:`KERNEL_FIT_NAME` |
| 3911 | The base name of the kernel flattened image tree (FIT) image. This | 3911 | The base name of the kernel flattened image tree (FIT) image. This |
| 3912 | variable is set in the ``meta/classes/kernel-artifact-names.bbclass`` | 3912 | variable is set in the ``meta/classes/kernel-artifact-names.bbclass`` |
| 3913 | file as follows: | 3913 | file as follows: |
| @@ -3921,7 +3921,7 @@ system and gives an overview of their function and contents. | |||
| 3921 | 3921 | ||
| 3922 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" | 3922 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" |
| 3923 | 3923 | ||
| 3924 | KERNEL_IMAGE_LINK_NAME | 3924 | :term:`KERNEL_IMAGE_LINK_NAME` |
| 3925 | The link name for the kernel image. This variable is set in the | 3925 | The link name for the kernel image. This variable is set in the |
| 3926 | ``meta/classes/kernel-artifact-names.bbclass`` file as follows: | 3926 | ``meta/classes/kernel-artifact-names.bbclass`` file as follows: |
| 3927 | :: | 3927 | :: |
| @@ -3938,7 +3938,7 @@ system and gives an overview of their function and contents. | |||
| 3938 | See the :term:`MACHINE` variable for additional | 3938 | See the :term:`MACHINE` variable for additional |
| 3939 | information. | 3939 | information. |
| 3940 | 3940 | ||
| 3941 | KERNEL_IMAGE_MAXSIZE | 3941 | :term:`KERNEL_IMAGE_MAXSIZE` |
| 3942 | Specifies the maximum size of the kernel image file in kilobytes. If | 3942 | Specifies the maximum size of the kernel image file in kilobytes. If |
| 3943 | ``KERNEL_IMAGE_MAXSIZE`` is set, the size of the kernel image file is | 3943 | ``KERNEL_IMAGE_MAXSIZE`` is set, the size of the kernel image file is |
| 3944 | checked against the set value during the | 3944 | checked against the set value during the |
| @@ -3951,7 +3951,7 @@ system and gives an overview of their function and contents. | |||
| 3951 | By default, this variable is not set, which means the size of the | 3951 | By default, this variable is not set, which means the size of the |
| 3952 | kernel image is not checked. | 3952 | kernel image is not checked. |
| 3953 | 3953 | ||
| 3954 | KERNEL_IMAGE_NAME | 3954 | :term:`KERNEL_IMAGE_NAME` |
| 3955 | The base name of the kernel image. This variable is set in the | 3955 | The base name of the kernel image. This variable is set in the |
| 3956 | ``meta/classes/kernel-artifact-names.bbclass`` file as follows: | 3956 | ``meta/classes/kernel-artifact-names.bbclass`` file as follows: |
| 3957 | :: | 3957 | :: |
| @@ -3965,7 +3965,7 @@ system and gives an overview of their function and contents. | |||
| 3965 | 3965 | ||
| 3966 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" | 3966 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" |
| 3967 | 3967 | ||
| 3968 | KERNEL_IMAGETYPE | 3968 | :term:`KERNEL_IMAGETYPE` |
| 3969 | The type of kernel to build for a device, usually set by the machine | 3969 | The type of kernel to build for a device, usually set by the machine |
| 3970 | configuration files and defaults to "zImage". This variable is used | 3970 | configuration files and defaults to "zImage". This variable is used |
| 3971 | when building the kernel and is passed to ``make`` as the target to | 3971 | when building the kernel and is passed to ``make`` as the target to |
| @@ -3974,7 +3974,7 @@ system and gives an overview of their function and contents. | |||
| 3974 | If you want to build an alternate kernel image type, use the | 3974 | If you want to build an alternate kernel image type, use the |
| 3975 | :term:`KERNEL_ALT_IMAGETYPE` variable. | 3975 | :term:`KERNEL_ALT_IMAGETYPE` variable. |
| 3976 | 3976 | ||
| 3977 | KERNEL_MODULE_AUTOLOAD | 3977 | :term:`KERNEL_MODULE_AUTOLOAD` |
| 3978 | Lists kernel modules that need to be auto-loaded during boot. | 3978 | Lists kernel modules that need to be auto-loaded during boot. |
| 3979 | 3979 | ||
| 3980 | .. note:: | 3980 | .. note:: |
| @@ -4006,14 +4006,14 @@ system and gives an overview of their function and contents. | |||
| 4006 | For information on how to populate the ``modname.conf`` file with | 4006 | For information on how to populate the ``modname.conf`` file with |
| 4007 | ``modprobe.d`` syntax lines, see the :term:`KERNEL_MODULE_PROBECONF` variable. | 4007 | ``modprobe.d`` syntax lines, see the :term:`KERNEL_MODULE_PROBECONF` variable. |
| 4008 | 4008 | ||
| 4009 | KERNEL_MODULE_PROBECONF | 4009 | :term:`KERNEL_MODULE_PROBECONF` |
| 4010 | Provides a list of modules for which the OpenEmbedded build system | 4010 | Provides a list of modules for which the OpenEmbedded build system |
| 4011 | expects to find ``module_conf_``\ modname values that specify | 4011 | expects to find ``module_conf_``\ modname values that specify |
| 4012 | configuration for each of the modules. For information on how to | 4012 | configuration for each of the modules. For information on how to |
| 4013 | provide those module configurations, see the | 4013 | provide those module configurations, see the |
| 4014 | :term:`module_conf_* <module_conf>` variable. | 4014 | :term:`module_conf_* <module_conf>` variable. |
| 4015 | 4015 | ||
| 4016 | KERNEL_PATH | 4016 | :term:`KERNEL_PATH` |
| 4017 | The location of the kernel sources. This variable is set to the value | 4017 | The location of the kernel sources. This variable is set to the value |
| 4018 | of the :term:`STAGING_KERNEL_DIR` within | 4018 | of the :term:`STAGING_KERNEL_DIR` within |
| 4019 | the :ref:`module <ref-classes-module>` class. For information on | 4019 | the :ref:`module <ref-classes-module>` class. For information on |
| @@ -4027,7 +4027,7 @@ system and gives an overview of their function and contents. | |||
| 4027 | the ``KERNEL_PATH`` variable. Both variables are common variables | 4027 | the ``KERNEL_PATH`` variable. Both variables are common variables |
| 4028 | used by external Makefiles to point to the kernel source directory. | 4028 | used by external Makefiles to point to the kernel source directory. |
| 4029 | 4029 | ||
| 4030 | KERNEL_SRC | 4030 | :term:`KERNEL_SRC` |
| 4031 | The location of the kernel sources. This variable is set to the value | 4031 | The location of the kernel sources. This variable is set to the value |
| 4032 | of the :term:`STAGING_KERNEL_DIR` within | 4032 | of the :term:`STAGING_KERNEL_DIR` within |
| 4033 | the :ref:`module <ref-classes-module>` class. For information on | 4033 | the :ref:`module <ref-classes-module>` class. For information on |
| @@ -4041,14 +4041,14 @@ system and gives an overview of their function and contents. | |||
| 4041 | to the ``KERNEL_SRC`` variable. Both variables are common variables | 4041 | to the ``KERNEL_SRC`` variable. Both variables are common variables |
| 4042 | used by external Makefiles to point to the kernel source directory. | 4042 | used by external Makefiles to point to the kernel source directory. |
| 4043 | 4043 | ||
| 4044 | KERNEL_VERSION | 4044 | :term:`KERNEL_VERSION` |
| 4045 | Specifies the version of the kernel as extracted from ``version.h`` | 4045 | Specifies the version of the kernel as extracted from ``version.h`` |
| 4046 | or ``utsrelease.h`` within the kernel sources. Effects of setting | 4046 | or ``utsrelease.h`` within the kernel sources. Effects of setting |
| 4047 | this variable do not take affect until the kernel has been | 4047 | this variable do not take affect until the kernel has been |
| 4048 | configured. Consequently, attempting to refer to this variable in | 4048 | configured. Consequently, attempting to refer to this variable in |
| 4049 | contexts prior to configuration will not work. | 4049 | contexts prior to configuration will not work. |
| 4050 | 4050 | ||
| 4051 | KERNELDEPMODDEPEND | 4051 | :term:`KERNELDEPMODDEPEND` |
| 4052 | Specifies whether the data referenced through | 4052 | Specifies whether the data referenced through |
| 4053 | :term:`PKGDATA_DIR` is needed or not. The | 4053 | :term:`PKGDATA_DIR` is needed or not. The |
| 4054 | ``KERNELDEPMODDEPEND`` does not control whether or not that data | 4054 | ``KERNELDEPMODDEPEND`` does not control whether or not that data |
| @@ -4057,7 +4057,7 @@ system and gives an overview of their function and contents. | |||
| 4057 | ``initramfs`` recipe. Setting the variable there when the data is not | 4057 | ``initramfs`` recipe. Setting the variable there when the data is not |
| 4058 | needed avoids a potential dependency loop. | 4058 | needed avoids a potential dependency loop. |
| 4059 | 4059 | ||
| 4060 | KFEATURE_DESCRIPTION | 4060 | :term:`KFEATURE_DESCRIPTION` |
| 4061 | Provides a short description of a configuration fragment. You use | 4061 | Provides a short description of a configuration fragment. You use |
| 4062 | this variable in the ``.scc`` file that describes a configuration | 4062 | this variable in the ``.scc`` file that describes a configuration |
| 4063 | fragment file. Here is the variable used in a file named ``smp.scc`` | 4063 | fragment file. Here is the variable used in a file named ``smp.scc`` |
| @@ -4066,7 +4066,7 @@ system and gives an overview of their function and contents. | |||
| 4066 | 4066 | ||
| 4067 | define KFEATURE_DESCRIPTION "Enable SMP" | 4067 | define KFEATURE_DESCRIPTION "Enable SMP" |
| 4068 | 4068 | ||
| 4069 | KMACHINE | 4069 | :term:`KMACHINE` |
| 4070 | The machine as known by the kernel. Sometimes the machine name used | 4070 | The machine as known by the kernel. Sometimes the machine name used |
| 4071 | by the kernel does not match the machine name used by the | 4071 | by the kernel does not match the machine name used by the |
| 4072 | OpenEmbedded build system. For example, the machine name that the | 4072 | OpenEmbedded build system. For example, the machine name that the |
| @@ -4094,7 +4094,7 @@ system and gives an overview of their function and contents. | |||
| 4094 | However, the OpenEmbedded build system understands the machine as | 4094 | However, the OpenEmbedded build system understands the machine as |
| 4095 | "core2-32-intel-common". | 4095 | "core2-32-intel-common". |
| 4096 | 4096 | ||
| 4097 | KTYPE | 4097 | :term:`KTYPE` |
| 4098 | Defines the kernel type to be used in assembling the configuration. | 4098 | Defines the kernel type to be used in assembling the configuration. |
| 4099 | The linux-yocto recipes define "standard", "tiny", and "preempt-rt" | 4099 | The linux-yocto recipes define "standard", "tiny", and "preempt-rt" |
| 4100 | kernel types. See the ":ref:`kernel-dev/kernel-dev-advanced:kernel types`" | 4100 | kernel types. See the ":ref:`kernel-dev/kernel-dev-advanced:kernel types`" |
| @@ -4108,13 +4108,13 @@ system and gives an overview of their function and contents. | |||
| 4108 | :term:`LINUX_KERNEL_TYPE` value used by the | 4108 | :term:`LINUX_KERNEL_TYPE` value used by the |
| 4109 | kernel recipe. | 4109 | kernel recipe. |
| 4110 | 4110 | ||
| 4111 | LABELS | 4111 | :term:`LABELS` |
| 4112 | Provides a list of targets for automatic configuration. | 4112 | Provides a list of targets for automatic configuration. |
| 4113 | 4113 | ||
| 4114 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more | 4114 | See the :ref:`grub-efi <ref-classes-grub-efi>` class for more |
| 4115 | information on how this variable is used. | 4115 | information on how this variable is used. |
| 4116 | 4116 | ||
| 4117 | LAYERDEPENDS | 4117 | :term:`LAYERDEPENDS` |
| 4118 | Lists the layers, separated by spaces, on which this recipe depends. | 4118 | Lists the layers, separated by spaces, on which this recipe depends. |
| 4119 | Optionally, you can specify a specific layer version for a dependency | 4119 | Optionally, you can specify a specific layer version for a dependency |
| 4120 | by adding it to the end of the layer name. Here is an example: | 4120 | by adding it to the end of the layer name. Here is an example: |
| @@ -4131,13 +4131,13 @@ system and gives an overview of their function and contents. | |||
| 4131 | the ``conf/layer.conf`` file and must be suffixed with the name of | 4131 | the ``conf/layer.conf`` file and must be suffixed with the name of |
| 4132 | the specific layer (e.g. ``LAYERDEPENDS_mylayer``). | 4132 | the specific layer (e.g. ``LAYERDEPENDS_mylayer``). |
| 4133 | 4133 | ||
| 4134 | LAYERDIR | 4134 | :term:`LAYERDIR` |
| 4135 | When used inside the ``layer.conf`` configuration file, this variable | 4135 | When used inside the ``layer.conf`` configuration file, this variable |
| 4136 | provides the path of the current layer. This variable is not | 4136 | provides the path of the current layer. This variable is not |
| 4137 | available outside of ``layer.conf`` and references are expanded | 4137 | available outside of ``layer.conf`` and references are expanded |
| 4138 | immediately when parsing of the file completes. | 4138 | immediately when parsing of the file completes. |
| 4139 | 4139 | ||
| 4140 | LAYERRECOMMENDS | 4140 | :term:`LAYERRECOMMENDS` |
| 4141 | Lists the layers, separated by spaces, recommended for use with this | 4141 | Lists the layers, separated by spaces, recommended for use with this |
| 4142 | layer. | 4142 | layer. |
| 4143 | 4143 | ||
| @@ -4155,7 +4155,7 @@ system and gives an overview of their function and contents. | |||
| 4155 | suffixed with the name of the specific layer (e.g. | 4155 | suffixed with the name of the specific layer (e.g. |
| 4156 | ``LAYERRECOMMENDS_mylayer``). | 4156 | ``LAYERRECOMMENDS_mylayer``). |
| 4157 | 4157 | ||
| 4158 | LAYERSERIES_COMPAT | 4158 | :term:`LAYERSERIES_COMPAT` |
| 4159 | Lists the versions of the :term:`OpenEmbedded-Core (OE-Core)` for which | 4159 | Lists the versions of the :term:`OpenEmbedded-Core (OE-Core)` for which |
| 4160 | a layer is compatible. Using the ``LAYERSERIES_COMPAT`` variable | 4160 | a layer is compatible. Using the ``LAYERSERIES_COMPAT`` variable |
| 4161 | allows the layer maintainer to indicate which combinations of the | 4161 | allows the layer maintainer to indicate which combinations of the |
| @@ -4184,7 +4184,7 @@ system and gives an overview of their function and contents. | |||
| 4184 | See the ":ref:`dev-manual/dev-manual-common-tasks:creating your own layer`" | 4184 | See the ":ref:`dev-manual/dev-manual-common-tasks:creating your own layer`" |
| 4185 | section in the Yocto Project Development Tasks Manual. | 4185 | section in the Yocto Project Development Tasks Manual. |
| 4186 | 4186 | ||
| 4187 | LAYERVERSION | 4187 | :term:`LAYERVERSION` |
| 4188 | Optionally specifies the version of a layer as a single number. You | 4188 | Optionally specifies the version of a layer as a single number. You |
| 4189 | can use this within :term:`LAYERDEPENDS` for | 4189 | can use this within :term:`LAYERDEPENDS` for |
| 4190 | another layer in order to depend on a specific version of the layer. | 4190 | another layer in order to depend on a specific version of the layer. |
| @@ -4192,10 +4192,10 @@ system and gives an overview of their function and contents. | |||
| 4192 | suffixed with the name of the specific layer (e.g. | 4192 | suffixed with the name of the specific layer (e.g. |
| 4193 | ``LAYERVERSION_mylayer``). | 4193 | ``LAYERVERSION_mylayer``). |
| 4194 | 4194 | ||
| 4195 | LD | 4195 | :term:`LD` |
| 4196 | The minimal command and arguments used to run the linker. | 4196 | The minimal command and arguments used to run the linker. |
| 4197 | 4197 | ||
| 4198 | LDFLAGS | 4198 | :term:`LDFLAGS` |
| 4199 | Specifies the flags to pass to the linker. This variable is exported | 4199 | Specifies the flags to pass to the linker. This variable is exported |
| 4200 | to an environment variable and thus made visible to the software | 4200 | to an environment variable and thus made visible to the software |
| 4201 | being built during the compilation step. | 4201 | being built during the compilation step. |
| @@ -4212,14 +4212,14 @@ system and gives an overview of their function and contents. | |||
| 4212 | - :term:`BUILDSDK_LDFLAGS` when building for | 4212 | - :term:`BUILDSDK_LDFLAGS` when building for |
| 4213 | an SDK (i.e. ``nativesdk-``) | 4213 | an SDK (i.e. ``nativesdk-``) |
| 4214 | 4214 | ||
| 4215 | LEAD_SONAME | 4215 | :term:`LEAD_SONAME` |
| 4216 | Specifies the lead (or primary) compiled library file (i.e. ``.so``) | 4216 | Specifies the lead (or primary) compiled library file (i.e. ``.so``) |
| 4217 | that the :ref:`debian <ref-classes-debian>` class applies its | 4217 | that the :ref:`debian <ref-classes-debian>` class applies its |
| 4218 | naming policy to given a recipe that packages multiple libraries. | 4218 | naming policy to given a recipe that packages multiple libraries. |
| 4219 | 4219 | ||
| 4220 | This variable works in conjunction with the ``debian`` class. | 4220 | This variable works in conjunction with the ``debian`` class. |
| 4221 | 4221 | ||
| 4222 | LIC_FILES_CHKSUM | 4222 | :term:`LIC_FILES_CHKSUM` |
| 4223 | Checksums of the license text in the recipe source code. | 4223 | Checksums of the license text in the recipe source code. |
| 4224 | 4224 | ||
| 4225 | This variable tracks changes in license text of the source code | 4225 | This variable tracks changes in license text of the source code |
| @@ -4233,7 +4233,7 @@ system and gives an overview of their function and contents. | |||
| 4233 | For more information, see the ":ref:`usingpoky-configuring-lic_files_chksum`" | 4233 | For more information, see the ":ref:`usingpoky-configuring-lic_files_chksum`" |
| 4234 | section in the Yocto Project Development Tasks Manual. | 4234 | section in the Yocto Project Development Tasks Manual. |
| 4235 | 4235 | ||
| 4236 | LICENSE | 4236 | :term:`LICENSE` |
| 4237 | The list of source licenses for the recipe. Follow these rules: | 4237 | The list of source licenses for the recipe. Follow these rules: |
| 4238 | 4238 | ||
| 4239 | - Do not use spaces within individual license names. | 4239 | - Do not use spaces within individual license names. |
| @@ -4276,7 +4276,7 @@ system and gives an overview of their function and contents. | |||
| 4276 | LICENSE_${PN} = "GPLv2" | 4276 | LICENSE_${PN} = "GPLv2" |
| 4277 | LICENSE_${PN}-doc = "GFDL-1.2" | 4277 | LICENSE_${PN}-doc = "GFDL-1.2" |
| 4278 | 4278 | ||
| 4279 | LICENSE_CREATE_PACKAGE | 4279 | :term:`LICENSE_CREATE_PACKAGE` |
| 4280 | Setting ``LICENSE_CREATE_PACKAGE`` to "1" causes the OpenEmbedded | 4280 | Setting ``LICENSE_CREATE_PACKAGE`` to "1" causes the OpenEmbedded |
| 4281 | build system to create an extra package (i.e. | 4281 | build system to create an extra package (i.e. |
| 4282 | ``${``\ :term:`PN`\ ``}-lic``) for each recipe and to add | 4282 | ``${``\ :term:`PN`\ ``}-lic``) for each recipe and to add |
| @@ -4299,7 +4299,7 @@ system and gives an overview of their function and contents. | |||
| 4299 | ":ref:`dev-manual/dev-manual-common-tasks:providing license text`" | 4299 | ":ref:`dev-manual/dev-manual-common-tasks:providing license text`" |
| 4300 | section in the Yocto Project Development Tasks Manual. | 4300 | section in the Yocto Project Development Tasks Manual. |
| 4301 | 4301 | ||
| 4302 | LICENSE_FLAGS | 4302 | :term:`LICENSE_FLAGS` |
| 4303 | Specifies additional flags for a recipe you must whitelist through | 4303 | Specifies additional flags for a recipe you must whitelist through |
| 4304 | :term:`LICENSE_FLAGS_WHITELIST` in | 4304 | :term:`LICENSE_FLAGS_WHITELIST` in |
| 4305 | order to allow the recipe to be built. When providing multiple flags, | 4305 | order to allow the recipe to be built. When providing multiple flags, |
| @@ -4312,7 +4312,7 @@ system and gives an overview of their function and contents. | |||
| 4312 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" | 4312 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" |
| 4313 | section in the Yocto Project Development Tasks Manual. | 4313 | section in the Yocto Project Development Tasks Manual. |
| 4314 | 4314 | ||
| 4315 | LICENSE_FLAGS_WHITELIST | 4315 | :term:`LICENSE_FLAGS_WHITELIST` |
| 4316 | Lists license flags that when specified in | 4316 | Lists license flags that when specified in |
| 4317 | :term:`LICENSE_FLAGS` within a recipe should not | 4317 | :term:`LICENSE_FLAGS` within a recipe should not |
| 4318 | prevent that recipe from being built. This practice is otherwise | 4318 | prevent that recipe from being built. This practice is otherwise |
| @@ -4320,7 +4320,7 @@ system and gives an overview of their function and contents. | |||
| 4320 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" | 4320 | ":ref:`dev-manual/dev-manual-common-tasks:enabling commercially licensed recipes`" |
| 4321 | section in the Yocto Project Development Tasks Manual. | 4321 | section in the Yocto Project Development Tasks Manual. |
| 4322 | 4322 | ||
| 4323 | LICENSE_PATH | 4323 | :term:`LICENSE_PATH` |
| 4324 | Path to additional licenses used during the build. By default, the | 4324 | Path to additional licenses used during the build. By default, the |
| 4325 | OpenEmbedded build system uses ``COMMON_LICENSE_DIR`` to define the | 4325 | OpenEmbedded build system uses ``COMMON_LICENSE_DIR`` to define the |
| 4326 | directory that holds common license text used during the build. The | 4326 | directory that holds common license text used during the build. The |
| @@ -4330,7 +4330,7 @@ system and gives an overview of their function and contents. | |||
| 4330 | 4330 | ||
| 4331 | LICENSE_PATH += "path-to-additional-common-licenses" | 4331 | LICENSE_PATH += "path-to-additional-common-licenses" |
| 4332 | 4332 | ||
| 4333 | LINUX_KERNEL_TYPE | 4333 | :term:`LINUX_KERNEL_TYPE` |
| 4334 | Defines the kernel type to be used in assembling the configuration. | 4334 | Defines the kernel type to be used in assembling the configuration. |
| 4335 | The linux-yocto recipes define "standard", "tiny", and "preempt-rt" | 4335 | The linux-yocto recipes define "standard", "tiny", and "preempt-rt" |
| 4336 | kernel types. See the ":ref:`kernel-dev/kernel-dev-advanced:kernel types`" | 4336 | kernel types. See the ":ref:`kernel-dev/kernel-dev-advanced:kernel types`" |
| @@ -4345,7 +4345,7 @@ system and gives an overview of their function and contents. | |||
| 4345 | kernel :term:`Metadata` with which to build out the sources | 4345 | kernel :term:`Metadata` with which to build out the sources |
| 4346 | and configuration. | 4346 | and configuration. |
| 4347 | 4347 | ||
| 4348 | LINUX_VERSION | 4348 | :term:`LINUX_VERSION` |
| 4349 | The Linux version from ``kernel.org`` on which the Linux kernel image | 4349 | The Linux version from ``kernel.org`` on which the Linux kernel image |
| 4350 | being built using the OpenEmbedded build system is based. You define | 4350 | being built using the OpenEmbedded build system is based. You define |
| 4351 | this variable in the kernel recipe. For example, the | 4351 | this variable in the kernel recipe. For example, the |
| @@ -4361,7 +4361,7 @@ system and gives an overview of their function and contents. | |||
| 4361 | 4361 | ||
| 4362 | PV = "${LINUX_VERSION}+git${SRCPV}" | 4362 | PV = "${LINUX_VERSION}+git${SRCPV}" |
| 4363 | 4363 | ||
| 4364 | LINUX_VERSION_EXTENSION | 4364 | :term:`LINUX_VERSION_EXTENSION` |
| 4365 | A string extension compiled into the version string of the Linux | 4365 | A string extension compiled into the version string of the Linux |
| 4366 | kernel built with the OpenEmbedded build system. You define this | 4366 | kernel built with the OpenEmbedded build system. You define this |
| 4367 | variable in the kernel recipe. For example, the linux-yocto kernel | 4367 | variable in the kernel recipe. For example, the linux-yocto kernel |
| @@ -4379,14 +4379,14 @@ system and gives an overview of their function and contents. | |||
| 4379 | $ uname -r | 4379 | $ uname -r |
| 4380 | 3.7.0-rc8-custom | 4380 | 3.7.0-rc8-custom |
| 4381 | 4381 | ||
| 4382 | LOG_DIR | 4382 | :term:`LOG_DIR` |
| 4383 | Specifies the directory to which the OpenEmbedded build system writes | 4383 | Specifies the directory to which the OpenEmbedded build system writes |
| 4384 | overall log files. The default directory is ``${TMPDIR}/log``. | 4384 | overall log files. The default directory is ``${TMPDIR}/log``. |
| 4385 | 4385 | ||
| 4386 | For the directory containing logs specific to each task, see the | 4386 | For the directory containing logs specific to each task, see the |
| 4387 | :term:`T` variable. | 4387 | :term:`T` variable. |
| 4388 | 4388 | ||
| 4389 | MACHINE | 4389 | :term:`MACHINE` |
| 4390 | Specifies the target device for which the image is built. You define | 4390 | Specifies the target device for which the image is built. You define |
| 4391 | ``MACHINE`` in the ``local.conf`` file found in the | 4391 | ``MACHINE`` in the ``local.conf`` file found in the |
| 4392 | :term:`Build Directory`. By default, ``MACHINE`` is set to | 4392 | :term:`Build Directory`. By default, ``MACHINE`` is set to |
| @@ -4429,13 +4429,13 @@ system and gives an overview of their function and contents. | |||
| 4429 | MACHINE | 4429 | MACHINE |
| 4430 | . | 4430 | . |
| 4431 | 4431 | ||
| 4432 | MACHINE_ARCH | 4432 | :term:`MACHINE_ARCH` |
| 4433 | Specifies the name of the machine-specific architecture. This | 4433 | Specifies the name of the machine-specific architecture. This |
| 4434 | variable is set automatically from :term:`MACHINE` or | 4434 | variable is set automatically from :term:`MACHINE` or |
| 4435 | :term:`TUNE_PKGARCH`. You should not hand-edit | 4435 | :term:`TUNE_PKGARCH`. You should not hand-edit |
| 4436 | the ``MACHINE_ARCH`` variable. | 4436 | the ``MACHINE_ARCH`` variable. |
| 4437 | 4437 | ||
| 4438 | MACHINE_ESSENTIAL_EXTRA_RDEPENDS | 4438 | :term:`MACHINE_ESSENTIAL_EXTRA_RDEPENDS` |
| 4439 | A list of required machine-specific packages to install as part of | 4439 | A list of required machine-specific packages to install as part of |
| 4440 | the image being built. The build process depends on these packages | 4440 | the image being built. The build process depends on these packages |
| 4441 | being present. Furthermore, because this is a "machine-essential" | 4441 | being present. Furthermore, because this is a "machine-essential" |
| @@ -4458,7 +4458,7 @@ system and gives an overview of their function and contents. | |||
| 4458 | 4458 | ||
| 4459 | MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "example-init" | 4459 | MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "example-init" |
| 4460 | 4460 | ||
| 4461 | MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS | 4461 | :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` |
| 4462 | A list of recommended machine-specific packages to install as part of | 4462 | A list of recommended machine-specific packages to install as part of |
| 4463 | the image being built. The build process does not depend on these | 4463 | the image being built. The build process does not depend on these |
| 4464 | packages being present. However, because this is a | 4464 | packages being present. However, because this is a |
| @@ -4503,7 +4503,7 @@ system and gives an overview of their function and contents. | |||
| 4503 | Some examples of these machine essentials are flash, screen, | 4503 | Some examples of these machine essentials are flash, screen, |
| 4504 | keyboard, mouse, or touchscreen drivers (depending on the machine). | 4504 | keyboard, mouse, or touchscreen drivers (depending on the machine). |
| 4505 | 4505 | ||
| 4506 | MACHINE_EXTRA_RDEPENDS | 4506 | :term:`MACHINE_EXTRA_RDEPENDS` |
| 4507 | A list of machine-specific packages to install as part of the image | 4507 | A list of machine-specific packages to install as part of the image |
| 4508 | being built that are not essential for the machine to boot. However, | 4508 | being built that are not essential for the machine to boot. However, |
| 4509 | the build process for more fully-featured images depends on the | 4509 | the build process for more fully-featured images depends on the |
| @@ -4530,7 +4530,7 @@ system and gives an overview of their function and contents. | |||
| 4530 | 4530 | ||
| 4531 | MACHINE_EXTRA_RDEPENDS += "wifidriver-firmware" | 4531 | MACHINE_EXTRA_RDEPENDS += "wifidriver-firmware" |
| 4532 | 4532 | ||
| 4533 | MACHINE_EXTRA_RRECOMMENDS | 4533 | :term:`MACHINE_EXTRA_RRECOMMENDS` |
| 4534 | A list of machine-specific packages to install as part of the image | 4534 | A list of machine-specific packages to install as part of the image |
| 4535 | being built that are not essential for booting the machine. The image | 4535 | being built that are not essential for booting the machine. The image |
| 4536 | being built has no build dependency on this list of packages. | 4536 | being built has no build dependency on this list of packages. |
| @@ -4557,7 +4557,7 @@ system and gives an overview of their function and contents. | |||
| 4557 | 4557 | ||
| 4558 | MACHINE_EXTRA_RRECOMMENDS += "kernel-module-examplewifi" | 4558 | MACHINE_EXTRA_RRECOMMENDS += "kernel-module-examplewifi" |
| 4559 | 4559 | ||
| 4560 | MACHINE_FEATURES | 4560 | :term:`MACHINE_FEATURES` |
| 4561 | Specifies the list of hardware features the | 4561 | Specifies the list of hardware features the |
| 4562 | :term:`MACHINE` is capable of supporting. For related | 4562 | :term:`MACHINE` is capable of supporting. For related |
| 4563 | information on enabling features, see the | 4563 | information on enabling features, see the |
| @@ -4569,7 +4569,7 @@ system and gives an overview of their function and contents. | |||
| 4569 | shipped, see the "`Machine Features <#ref-features-machine>`__" | 4569 | shipped, see the "`Machine Features <#ref-features-machine>`__" |
| 4570 | section. | 4570 | section. |
| 4571 | 4571 | ||
| 4572 | MACHINE_FEATURES_BACKFILL | 4572 | :term:`MACHINE_FEATURES_BACKFILL` |
| 4573 | Features to be added to ``MACHINE_FEATURES`` if not also present in | 4573 | Features to be added to ``MACHINE_FEATURES`` if not also present in |
| 4574 | ``MACHINE_FEATURES_BACKFILL_CONSIDERED``. | 4574 | ``MACHINE_FEATURES_BACKFILL_CONSIDERED``. |
| 4575 | 4575 | ||
| @@ -4580,13 +4580,13 @@ system and gives an overview of their function and contents. | |||
| 4580 | Backfilling <#ref-features-backfill>`__" section for more | 4580 | Backfilling <#ref-features-backfill>`__" section for more |
| 4581 | information. | 4581 | information. |
| 4582 | 4582 | ||
| 4583 | MACHINE_FEATURES_BACKFILL_CONSIDERED | 4583 | :term:`MACHINE_FEATURES_BACKFILL_CONSIDERED` |
| 4584 | Features from ``MACHINE_FEATURES_BACKFILL`` that should not be | 4584 | Features from ``MACHINE_FEATURES_BACKFILL`` that should not be |
| 4585 | backfilled (i.e. added to ``MACHINE_FEATURES``) during the build. See | 4585 | backfilled (i.e. added to ``MACHINE_FEATURES``) during the build. See |
| 4586 | the "`Feature Backfilling <#ref-features-backfill>`__" section for | 4586 | the "`Feature Backfilling <#ref-features-backfill>`__" section for |
| 4587 | more information. | 4587 | more information. |
| 4588 | 4588 | ||
| 4589 | MACHINEOVERRIDES | 4589 | :term:`MACHINEOVERRIDES` |
| 4590 | A colon-separated list of overrides that apply to the current | 4590 | A colon-separated list of overrides that apply to the current |
| 4591 | machine. By default, this list includes the value of | 4591 | machine. By default, this list includes the value of |
| 4592 | :term:`MACHINE`. | 4592 | :term:`MACHINE`. |
| @@ -4614,10 +4614,10 @@ system and gives an overview of their function and contents. | |||
| 4614 | ``MACHINEOVERRIDES`` is simply that it is included in the default | 4614 | ``MACHINEOVERRIDES`` is simply that it is included in the default |
| 4615 | value of :term:`OVERRIDES`. | 4615 | value of :term:`OVERRIDES`. |
| 4616 | 4616 | ||
| 4617 | MAINTAINER | 4617 | :term:`MAINTAINER` |
| 4618 | The email address of the distribution maintainer. | 4618 | The email address of the distribution maintainer. |
| 4619 | 4619 | ||
| 4620 | MIRRORS | 4620 | :term:`MIRRORS` |
| 4621 | Specifies additional paths from which the OpenEmbedded build system | 4621 | Specifies additional paths from which the OpenEmbedded build system |
| 4622 | gets source code. When the build system searches for source code, it | 4622 | gets source code. When the build system searches for source code, it |
| 4623 | first tries the local download directory. If that location fails, the | 4623 | first tries the local download directory. If that location fails, the |
| @@ -4629,7 +4629,7 @@ system and gives an overview of their function and contents. | |||
| 4629 | the default value for ``MIRRORS`` is defined in the | 4629 | the default value for ``MIRRORS`` is defined in the |
| 4630 | ``conf/distro/poky.conf`` file in the ``meta-poky`` Git repository. | 4630 | ``conf/distro/poky.conf`` file in the ``meta-poky`` Git repository. |
| 4631 | 4631 | ||
| 4632 | MLPREFIX | 4632 | :term:`MLPREFIX` |
| 4633 | Specifies a prefix has been added to :term:`PN` to create a | 4633 | Specifies a prefix has been added to :term:`PN` to create a |
| 4634 | special version of a recipe or package (i.e. a Multilib version). The | 4634 | special version of a recipe or package (i.e. a Multilib version). The |
| 4635 | variable is used in places where the prefix needs to be added to or | 4635 | variable is used in places where the prefix needs to be added to or |
| @@ -4716,12 +4716,12 @@ system and gives an overview of their function and contents. | |||
| 4716 | For information on how to specify kernel modules to auto-load on | 4716 | For information on how to specify kernel modules to auto-load on |
| 4717 | boot, see the :term:`KERNEL_MODULE_AUTOLOAD` variable. | 4717 | boot, see the :term:`KERNEL_MODULE_AUTOLOAD` variable. |
| 4718 | 4718 | ||
| 4719 | MODULE_TARBALL_DEPLOY | 4719 | :term:`MODULE_TARBALL_DEPLOY` |
| 4720 | Controls creation of the ``modules-*.tgz`` file. Set this variable to | 4720 | Controls creation of the ``modules-*.tgz`` file. Set this variable to |
| 4721 | "0" to disable creation of this file, which contains all of the | 4721 | "0" to disable creation of this file, which contains all of the |
| 4722 | kernel modules resulting from a kernel build. | 4722 | kernel modules resulting from a kernel build. |
| 4723 | 4723 | ||
| 4724 | MODULE_TARBALL_LINK_NAME | 4724 | :term:`MODULE_TARBALL_LINK_NAME` |
| 4725 | The link name of the kernel module tarball. This variable is set in | 4725 | The link name of the kernel module tarball. This variable is set in |
| 4726 | the ``meta/classes/kernel-artifact-names.bbclass`` file as follows: | 4726 | the ``meta/classes/kernel-artifact-names.bbclass`` file as follows: |
| 4727 | :: | 4727 | :: |
| @@ -4737,7 +4737,7 @@ system and gives an overview of their function and contents. | |||
| 4737 | 4737 | ||
| 4738 | See the :term:`MACHINE` variable for additional information. | 4738 | See the :term:`MACHINE` variable for additional information. |
| 4739 | 4739 | ||
| 4740 | MODULE_TARBALL_NAME | 4740 | :term:`MODULE_TARBALL_NAME` |
| 4741 | The base name of the kernel module tarball. This variable is set in | 4741 | The base name of the kernel module tarball. This variable is set in |
| 4742 | the ``meta/classes/kernel-artifact-names.bbclass`` file as follows: | 4742 | the ``meta/classes/kernel-artifact-names.bbclass`` file as follows: |
| 4743 | :: | 4743 | :: |
| @@ -4750,7 +4750,7 @@ system and gives an overview of their function and contents. | |||
| 4750 | 4750 | ||
| 4751 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" | 4751 | KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}" |
| 4752 | 4752 | ||
| 4753 | MULTIMACH_TARGET_SYS | 4753 | :term:`MULTIMACH_TARGET_SYS` |
| 4754 | Uniquely identifies the type of the target system for which packages | 4754 | Uniquely identifies the type of the target system for which packages |
| 4755 | are being built. This variable allows output for different types of | 4755 | are being built. This variable allows output for different types of |
| 4756 | target systems to be put into different subdirectories of the same | 4756 | target systems to be put into different subdirectories of the same |
| @@ -4768,7 +4768,7 @@ system and gives an overview of their function and contents. | |||
| 4768 | See the :term:`STAMP` variable for an example. See the | 4768 | See the :term:`STAMP` variable for an example. See the |
| 4769 | :term:`STAGING_DIR_TARGET` variable for more information. | 4769 | :term:`STAGING_DIR_TARGET` variable for more information. |
| 4770 | 4770 | ||
| 4771 | NATIVELSBSTRING | 4771 | :term:`NATIVELSBSTRING` |
| 4772 | A string identifying the host distribution. Strings consist of the | 4772 | A string identifying the host distribution. Strings consist of the |
| 4773 | host distributor ID followed by the release, as reported by the | 4773 | host distributor ID followed by the release, as reported by the |
| 4774 | ``lsb_release`` tool or as read from ``/etc/lsb-release``. For | 4774 | ``lsb_release`` tool or as read from ``/etc/lsb-release``. For |
| @@ -4783,10 +4783,10 @@ system and gives an overview of their function and contents. | |||
| 4783 | :term:`SANITY_TESTED_DISTROS` if that | 4783 | :term:`SANITY_TESTED_DISTROS` if that |
| 4784 | variable is set. | 4784 | variable is set. |
| 4785 | 4785 | ||
| 4786 | NM | 4786 | :term:`NM` |
| 4787 | The minimal command and arguments to run ``nm``. | 4787 | The minimal command and arguments to run ``nm``. |
| 4788 | 4788 | ||
| 4789 | NO_GENERIC_LICENSE | 4789 | :term:`NO_GENERIC_LICENSE` |
| 4790 | Avoids QA errors when you use a non-common, non-CLOSED license in a | 4790 | Avoids QA errors when you use a non-common, non-CLOSED license in a |
| 4791 | recipe. Packages exist, such as the linux-firmware package, with many | 4791 | recipe. Packages exist, such as the linux-firmware package, with many |
| 4792 | licenses that are not in any way common. Also, new licenses are added | 4792 | licenses that are not in any way common. Also, new licenses are added |
| @@ -4808,7 +4808,7 @@ system and gives an overview of their function and contents. | |||
| 4808 | 4808 | ||
| 4809 | NO_GENERIC_LICENSE[Firmware-Abilis] = "LICENSE.Abilis.txt" | 4809 | NO_GENERIC_LICENSE[Firmware-Abilis] = "LICENSE.Abilis.txt" |
| 4810 | 4810 | ||
| 4811 | NO_RECOMMENDATIONS | 4811 | :term:`NO_RECOMMENDATIONS` |
| 4812 | Prevents installation of all "recommended-only" packages. | 4812 | Prevents installation of all "recommended-only" packages. |
| 4813 | Recommended-only packages are packages installed only through the | 4813 | Recommended-only packages are packages installed only through the |
| 4814 | :term:`RRECOMMENDS` variable). Setting the | 4814 | :term:`RRECOMMENDS` variable). Setting the |
| @@ -4841,7 +4841,7 @@ system and gives an overview of their function and contents. | |||
| 4841 | the :term:`PACKAGE_EXCLUDE` variables for | 4841 | the :term:`PACKAGE_EXCLUDE` variables for |
| 4842 | related information. | 4842 | related information. |
| 4843 | 4843 | ||
| 4844 | NOAUTOPACKAGEDEBUG | 4844 | :term:`NOAUTOPACKAGEDEBUG` |
| 4845 | Disables auto package from splitting ``.debug`` files. If a recipe | 4845 | Disables auto package from splitting ``.debug`` files. If a recipe |
| 4846 | requires ``FILES_${PN}-dbg`` to be set manually, the | 4846 | requires ``FILES_${PN}-dbg`` to be set manually, the |
| 4847 | ``NOAUTOPACKAGEDEBUG`` can be defined allowing you to define the | 4847 | ``NOAUTOPACKAGEDEBUG`` can be defined allowing you to define the |
| @@ -4853,13 +4853,13 @@ system and gives an overview of their function and contents. | |||
| 4853 | FILES_${PN}-dbg = "/usr/src/debug/" | 4853 | FILES_${PN}-dbg = "/usr/src/debug/" |
| 4854 | FILES_${QT_BASE_NAME}-demos-doc = "${docdir}/${QT_DIR_NAME}/qch/qt.qch" | 4854 | FILES_${QT_BASE_NAME}-demos-doc = "${docdir}/${QT_DIR_NAME}/qch/qt.qch" |
| 4855 | 4855 | ||
| 4856 | OBJCOPY | 4856 | :term:`OBJCOPY` |
| 4857 | The minimal command and arguments to run ``objcopy``. | 4857 | The minimal command and arguments to run ``objcopy``. |
| 4858 | 4858 | ||
| 4859 | OBJDUMP | 4859 | :term:`OBJDUMP` |
| 4860 | The minimal command and arguments to run ``objdump``. | 4860 | The minimal command and arguments to run ``objdump``. |
| 4861 | 4861 | ||
| 4862 | OE_BINCONFIG_EXTRA_MANGLE | 4862 | :term:`OE_BINCONFIG_EXTRA_MANGLE` |
| 4863 | When inheriting the :ref:`binconfig <ref-classes-binconfig>` class, | 4863 | When inheriting the :ref:`binconfig <ref-classes-binconfig>` class, |
| 4864 | this variable specifies additional arguments passed to the "sed" | 4864 | this variable specifies additional arguments passed to the "sed" |
| 4865 | command. The sed command alters any paths in configuration scripts | 4865 | command. The sed command alters any paths in configuration scripts |
| @@ -4874,7 +4874,7 @@ system and gives an overview of their function and contents. | |||
| 4874 | information on the ``binconfig`` class, see the | 4874 | information on the ``binconfig`` class, see the |
| 4875 | ":ref:`binconfig.bbclass <ref-classes-binconfig>`" section. | 4875 | ":ref:`binconfig.bbclass <ref-classes-binconfig>`" section. |
| 4876 | 4876 | ||
| 4877 | OE_IMPORTS | 4877 | :term:`OE_IMPORTS` |
| 4878 | An internal variable used to tell the OpenEmbedded build system what | 4878 | An internal variable used to tell the OpenEmbedded build system what |
| 4879 | Python modules to import for every Python function run by the system. | 4879 | Python modules to import for every Python function run by the system. |
| 4880 | 4880 | ||
| @@ -4882,7 +4882,7 @@ system and gives an overview of their function and contents. | |||
| 4882 | 4882 | ||
| 4883 | Do not set this variable. It is for internal use only. | 4883 | Do not set this variable. It is for internal use only. |
| 4884 | 4884 | ||
| 4885 | OE_INIT_ENV_SCRIPT | 4885 | :term:`OE_INIT_ENV_SCRIPT` |
| 4886 | The name of the build environment setup script for the purposes of | 4886 | The name of the build environment setup script for the purposes of |
| 4887 | setting up the environment within the extensible SDK. The default | 4887 | setting up the environment within the extensible SDK. The default |
| 4888 | value is "oe-init-build-env". | 4888 | value is "oe-init-build-env". |
| @@ -4890,7 +4890,7 @@ system and gives an overview of their function and contents. | |||
| 4890 | If you use a custom script to set up your build environment, set the | 4890 | If you use a custom script to set up your build environment, set the |
| 4891 | ``OE_INIT_ENV_SCRIPT`` variable to its name. | 4891 | ``OE_INIT_ENV_SCRIPT`` variable to its name. |
| 4892 | 4892 | ||
| 4893 | OE_TERMINAL | 4893 | :term:`OE_TERMINAL` |
| 4894 | Controls how the OpenEmbedded build system spawns interactive | 4894 | Controls how the OpenEmbedded build system spawns interactive |
| 4895 | terminals on the host development system (e.g. using the BitBake | 4895 | terminals on the host development system (e.g. using the BitBake |
| 4896 | command with the ``-c devshell`` command-line option). For more | 4896 | command with the ``-c devshell`` command-line option). For more |
| @@ -4907,7 +4907,7 @@ system and gives an overview of their function and contents. | |||
| 4907 | - konsole | 4907 | - konsole |
| 4908 | - none | 4908 | - none |
| 4909 | 4909 | ||
| 4910 | OEROOT | 4910 | :term:`OEROOT` |
| 4911 | The directory from which the top-level build environment setup script | 4911 | The directory from which the top-level build environment setup script |
| 4912 | is sourced. The Yocto Project provides a top-level build environment | 4912 | is sourced. The Yocto Project provides a top-level build environment |
| 4913 | setup script: ````` <#structure-core-script>`__. When you run this | 4913 | setup script: ````` <#structure-core-script>`__. When you run this |
| @@ -4917,7 +4917,7 @@ system and gives an overview of their function and contents. | |||
| 4917 | For additional information on how this variable is used, see the | 4917 | For additional information on how this variable is used, see the |
| 4918 | initialization script. | 4918 | initialization script. |
| 4919 | 4919 | ||
| 4920 | OLDEST_KERNEL | 4920 | :term:`OLDEST_KERNEL` |
| 4921 | Declares the oldest version of the Linux kernel that the produced | 4921 | Declares the oldest version of the Linux kernel that the produced |
| 4922 | binaries must support. This variable is passed into the build of the | 4922 | binaries must support. This variable is passed into the build of the |
| 4923 | Embedded GNU C Library (``glibc``). | 4923 | Embedded GNU C Library (``glibc``). |
| @@ -4927,7 +4927,7 @@ system and gives an overview of their function and contents. | |||
| 4927 | default by setting the variable in a custom distribution | 4927 | default by setting the variable in a custom distribution |
| 4928 | configuration file. | 4928 | configuration file. |
| 4929 | 4929 | ||
| 4930 | OVERRIDES | 4930 | :term:`OVERRIDES` |
| 4931 | A colon-separated list of overrides that currently apply. Overrides | 4931 | A colon-separated list of overrides that currently apply. Overrides |
| 4932 | are a BitBake mechanism that allows variables to be selectively | 4932 | are a BitBake mechanism that allows variables to be selectively |
| 4933 | overridden at the end of parsing. The set of overrides in | 4933 | overridden at the end of parsing. The set of overrides in |
| @@ -4970,13 +4970,13 @@ system and gives an overview of their function and contents. | |||
| 4970 | " section in the Yocto Project Development Tasks Manual for more | 4970 | " section in the Yocto Project Development Tasks Manual for more |
| 4971 | information. | 4971 | information. |
| 4972 | 4972 | ||
| 4973 | P | 4973 | :term:`P` |
| 4974 | The recipe name and version. ``P`` is comprised of the following: | 4974 | The recipe name and version. ``P`` is comprised of the following: |
| 4975 | :: | 4975 | :: |
| 4976 | 4976 | ||
| 4977 | ${PN}-${PV} | 4977 | ${PN}-${PV} |
| 4978 | 4978 | ||
| 4979 | PACKAGE_ADD_METADATA | 4979 | :term:`PACKAGE_ADD_METADATA` |
| 4980 | This variable defines additional metdata to add to packages. | 4980 | This variable defines additional metdata to add to packages. |
| 4981 | 4981 | ||
| 4982 | You may find you need to inject additional metadata into packages. | 4982 | You may find you need to inject additional metadata into packages. |
| @@ -4992,7 +4992,7 @@ system and gives an overview of their function and contents. | |||
| 4992 | ":ref:`dev-manual/dev-manual-common-tasks:adding custom metadata to packages`" | 4992 | ":ref:`dev-manual/dev-manual-common-tasks:adding custom metadata to packages`" |
| 4993 | section in the Yocto Project Development Tasks Manual. | 4993 | section in the Yocto Project Development Tasks Manual. |
| 4994 | 4994 | ||
| 4995 | PACKAGE_ARCH | 4995 | :term:`PACKAGE_ARCH` |
| 4996 | The architecture of the resulting package or packages. | 4996 | The architecture of the resulting package or packages. |
| 4997 | 4997 | ||
| 4998 | By default, the value of this variable is set to | 4998 | By default, the value of this variable is set to |
| @@ -5015,19 +5015,19 @@ system and gives an overview of their function and contents. | |||
| 5015 | 5015 | ||
| 5016 | PACKAGE_ARCH = "${MACHINE_ARCH}" | 5016 | PACKAGE_ARCH = "${MACHINE_ARCH}" |
| 5017 | 5017 | ||
| 5018 | PACKAGE_ARCHS | 5018 | :term:`PACKAGE_ARCHS` |
| 5019 | Specifies a list of architectures compatible with the target machine. | 5019 | Specifies a list of architectures compatible with the target machine. |
| 5020 | This variable is set automatically and should not normally be | 5020 | This variable is set automatically and should not normally be |
| 5021 | hand-edited. Entries are separated using spaces and listed in order | 5021 | hand-edited. Entries are separated using spaces and listed in order |
| 5022 | of priority. The default value for ``PACKAGE_ARCHS`` is "all any | 5022 | of priority. The default value for ``PACKAGE_ARCHS`` is "all any |
| 5023 | noarch ${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}". | 5023 | noarch ${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}". |
| 5024 | 5024 | ||
| 5025 | PACKAGE_BEFORE_PN | 5025 | :term:`PACKAGE_BEFORE_PN` |
| 5026 | Enables easily adding packages to ``PACKAGES`` before ``${PN}`` so | 5026 | Enables easily adding packages to ``PACKAGES`` before ``${PN}`` so |
| 5027 | that those added packages can pick up files that would normally be | 5027 | that those added packages can pick up files that would normally be |
| 5028 | included in the default package. | 5028 | included in the default package. |
| 5029 | 5029 | ||
| 5030 | PACKAGE_CLASSES | 5030 | :term:`PACKAGE_CLASSES` |
| 5031 | This variable, which is set in the ``local.conf`` configuration file | 5031 | This variable, which is set in the ``local.conf`` configuration file |
| 5032 | found in the ``conf`` folder of the | 5032 | found in the ``conf`` folder of the |
| 5033 | :term:`Build Directory`, specifies the package manager the | 5033 | :term:`Build Directory`, specifies the package manager the |
| @@ -5060,7 +5060,7 @@ system and gives an overview of their function and contents. | |||
| 5060 | result of the package manager in use, see the | 5060 | result of the package manager in use, see the |
| 5061 | ":ref:`package.bbclass <ref-classes-package>`" section. | 5061 | ":ref:`package.bbclass <ref-classes-package>`" section. |
| 5062 | 5062 | ||
| 5063 | PACKAGE_DEBUG_SPLIT_STYLE | 5063 | :term:`PACKAGE_DEBUG_SPLIT_STYLE` |
| 5064 | Determines how to split up the binary and debug information when | 5064 | Determines how to split up the binary and debug information when |
| 5065 | creating ``*-dbg`` packages to be used with the GNU Project Debugger | 5065 | creating ``*-dbg`` packages to be used with the GNU Project Debugger |
| 5066 | (GDB). | 5066 | (GDB). |
| @@ -5093,7 +5093,7 @@ system and gives an overview of their function and contents. | |||
| 5093 | ":ref:`platdev-gdb-remotedebug`" section | 5093 | ":ref:`platdev-gdb-remotedebug`" section |
| 5094 | in the Yocto Project Development Tasks Manual. | 5094 | in the Yocto Project Development Tasks Manual. |
| 5095 | 5095 | ||
| 5096 | PACKAGE_EXCLUDE_COMPLEMENTARY | 5096 | :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` |
| 5097 | Prevents specific packages from being installed when you are | 5097 | Prevents specific packages from being installed when you are |
| 5098 | installing complementary packages. | 5098 | installing complementary packages. |
| 5099 | 5099 | ||
| @@ -5105,7 +5105,7 @@ system and gives an overview of their function and contents. | |||
| 5105 | use the ``PACKAGE_EXCLUDE_COMPLEMENTARY`` variable to specify regular | 5105 | use the ``PACKAGE_EXCLUDE_COMPLEMENTARY`` variable to specify regular |
| 5106 | expressions to match the packages you want to exclude. | 5106 | expressions to match the packages you want to exclude. |
| 5107 | 5107 | ||
| 5108 | PACKAGE_EXCLUDE | 5108 | :term:`PACKAGE_EXCLUDE` |
| 5109 | Lists packages that should not be installed into an image. For | 5109 | Lists packages that should not be installed into an image. For |
| 5110 | example: | 5110 | example: |
| 5111 | :: | 5111 | :: |
| @@ -5134,12 +5134,12 @@ system and gives an overview of their function and contents. | |||
| 5134 | :term:`BAD_RECOMMENDATIONS` variables for | 5134 | :term:`BAD_RECOMMENDATIONS` variables for |
| 5135 | related information. | 5135 | related information. |
| 5136 | 5136 | ||
| 5137 | PACKAGE_EXTRA_ARCHS | 5137 | :term:`PACKAGE_EXTRA_ARCHS` |
| 5138 | Specifies the list of architectures compatible with the device CPU. | 5138 | Specifies the list of architectures compatible with the device CPU. |
| 5139 | This variable is useful when you build for several different devices | 5139 | This variable is useful when you build for several different devices |
| 5140 | that use miscellaneous processors such as XScale and ARM926-EJS. | 5140 | that use miscellaneous processors such as XScale and ARM926-EJS. |
| 5141 | 5141 | ||
| 5142 | PACKAGE_FEED_ARCHS | 5142 | :term:`PACKAGE_FEED_ARCHS` |
| 5143 | Optionally specifies the package architectures used as part of the | 5143 | Optionally specifies the package architectures used as part of the |
| 5144 | package feed URIs during the build. When used, the | 5144 | package feed URIs during the build. When used, the |
| 5145 | ``PACKAGE_FEED_ARCHS`` variable is appended to the final package feed | 5145 | ``PACKAGE_FEED_ARCHS`` variable is appended to the final package feed |
| @@ -5180,7 +5180,7 @@ system and gives an overview of their function and contents. | |||
| 5180 | https://example.com/packagerepos/updates/rpm-dev/all | 5180 | https://example.com/packagerepos/updates/rpm-dev/all |
| 5181 | https://example.com/packagerepos/updates/rpm-dev/core2-64 | 5181 | https://example.com/packagerepos/updates/rpm-dev/core2-64 |
| 5182 | 5182 | ||
| 5183 | PACKAGE_FEED_BASE_PATHS | 5183 | :term:`PACKAGE_FEED_BASE_PATHS` |
| 5184 | Specifies the base path used when constructing package feed URIs. The | 5184 | Specifies the base path used when constructing package feed URIs. The |
| 5185 | ``PACKAGE_FEED_BASE_PATHS`` variable makes up the middle portion of a | 5185 | ``PACKAGE_FEED_BASE_PATHS`` variable makes up the middle portion of a |
| 5186 | package feed URI used by the OpenEmbedded build system. The base path | 5186 | package feed URI used by the OpenEmbedded build system. The base path |
| @@ -5209,7 +5209,7 @@ system and gives an overview of their function and contents. | |||
| 5209 | https://example.com/packagerepos/updates/rpm-dev/all | 5209 | https://example.com/packagerepos/updates/rpm-dev/all |
| 5210 | https://example.com/packagerepos/updates/rpm-dev/core2-64 | 5210 | https://example.com/packagerepos/updates/rpm-dev/core2-64 |
| 5211 | 5211 | ||
| 5212 | PACKAGE_FEED_URIS | 5212 | :term:`PACKAGE_FEED_URIS` |
| 5213 | Specifies the front portion of the package feed URI used by the | 5213 | Specifies the front portion of the package feed URI used by the |
| 5214 | OpenEmbedded build system. Each final package feed URI is comprised | 5214 | OpenEmbedded build system. Each final package feed URI is comprised |
| 5215 | of ``PACKAGE_FEED_URIS``, | 5215 | of ``PACKAGE_FEED_URIS``, |
| @@ -5238,7 +5238,7 @@ system and gives an overview of their function and contents. | |||
| 5238 | https://example.com/packagerepos/updates/rpm-dev/all | 5238 | https://example.com/packagerepos/updates/rpm-dev/all |
| 5239 | https://example.com/packagerepos/updates/rpm-dev/core2-64 | 5239 | https://example.com/packagerepos/updates/rpm-dev/core2-64 |
| 5240 | 5240 | ||
| 5241 | PACKAGE_INSTALL | 5241 | :term:`PACKAGE_INSTALL` |
| 5242 | The final list of packages passed to the package manager for | 5242 | The final list of packages passed to the package manager for |
| 5243 | installation into the image. | 5243 | installation into the image. |
| 5244 | 5244 | ||
| @@ -5256,18 +5256,18 @@ system and gives an overview of their function and contents. | |||
| 5256 | initramfs, see the ":ref:`building-an-initramfs-image`" section | 5256 | initramfs, see the ":ref:`building-an-initramfs-image`" section |
| 5257 | in the Yocto Project Development Tasks Manual. | 5257 | in the Yocto Project Development Tasks Manual. |
| 5258 | 5258 | ||
| 5259 | PACKAGE_INSTALL_ATTEMPTONLY | 5259 | :term:`PACKAGE_INSTALL_ATTEMPTONLY` |
| 5260 | Specifies a list of packages the OpenEmbedded build system attempts | 5260 | Specifies a list of packages the OpenEmbedded build system attempts |
| 5261 | to install when creating an image. If a listed package fails to | 5261 | to install when creating an image. If a listed package fails to |
| 5262 | install, the build system does not generate an error. This variable | 5262 | install, the build system does not generate an error. This variable |
| 5263 | is generally not user-defined. | 5263 | is generally not user-defined. |
| 5264 | 5264 | ||
| 5265 | PACKAGE_PREPROCESS_FUNCS | 5265 | :term:`PACKAGE_PREPROCESS_FUNCS` |
| 5266 | Specifies a list of functions run to pre-process the | 5266 | Specifies a list of functions run to pre-process the |
| 5267 | :term:`PKGD` directory prior to splitting the files out | 5267 | :term:`PKGD` directory prior to splitting the files out |
| 5268 | to individual packages. | 5268 | to individual packages. |
| 5269 | 5269 | ||
| 5270 | PACKAGE_WRITE_DEPS | 5270 | :term:`PACKAGE_WRITE_DEPS` |
| 5271 | Specifies a list of dependencies for post-installation and | 5271 | Specifies a list of dependencies for post-installation and |
| 5272 | pre-installation scripts on native/cross tools. If your | 5272 | pre-installation scripts on native/cross tools. If your |
| 5273 | post-installation or pre-installation script can execute at rootfs | 5273 | post-installation or pre-installation script can execute at rootfs |
| @@ -5279,7 +5279,7 @@ system and gives an overview of their function and contents. | |||
| 5279 | ":ref:`dev-manual/dev-manual-common-tasks:post-installation scripts`" | 5279 | ":ref:`dev-manual/dev-manual-common-tasks:post-installation scripts`" |
| 5280 | section in the Yocto Project Development Tasks Manual. | 5280 | section in the Yocto Project Development Tasks Manual. |
| 5281 | 5281 | ||
| 5282 | PACKAGECONFIG | 5282 | :term:`PACKAGECONFIG` |
| 5283 | This variable provides a means of enabling or disabling features of a | 5283 | This variable provides a means of enabling or disabling features of a |
| 5284 | recipe on a per-recipe basis. ``PACKAGECONFIG`` blocks are defined in | 5284 | recipe on a per-recipe basis. ``PACKAGECONFIG`` blocks are defined in |
| 5285 | recipes when you specify features and then arguments that define | 5285 | recipes when you specify features and then arguments that define |
| @@ -5371,7 +5371,7 @@ system and gives an overview of their function and contents. | |||
| 5371 | 5371 | ||
| 5372 | PACKAGECONFIG_append_pn-recipename = " f4" | 5372 | PACKAGECONFIG_append_pn-recipename = " f4" |
| 5373 | 5373 | ||
| 5374 | PACKAGECONFIG_CONFARGS | 5374 | :term:`PACKAGECONFIG_CONFARGS` |
| 5375 | A space-separated list of configuration options generated from the | 5375 | A space-separated list of configuration options generated from the |
| 5376 | :term:`PACKAGECONFIG` setting. | 5376 | :term:`PACKAGECONFIG` setting. |
| 5377 | 5377 | ||
| @@ -5382,7 +5382,7 @@ system and gives an overview of their function and contents. | |||
| 5382 | handles the ``do_configure`` task, then you need to use | 5382 | handles the ``do_configure`` task, then you need to use |
| 5383 | ``PACKAGECONFIG_CONFARGS`` appropriately. | 5383 | ``PACKAGECONFIG_CONFARGS`` appropriately. |
| 5384 | 5384 | ||
| 5385 | PACKAGEGROUP_DISABLE_COMPLEMENTARY | 5385 | :term:`PACKAGEGROUP_DISABLE_COMPLEMENTARY` |
| 5386 | For recipes inheriting the | 5386 | For recipes inheriting the |
| 5387 | :ref:`packagegroup <ref-classes-packagegroup>` class, setting | 5387 | :ref:`packagegroup <ref-classes-packagegroup>` class, setting |
| 5388 | ``PACKAGEGROUP_DISABLE_COMPLEMENTARY`` to "1" specifies that the | 5388 | ``PACKAGEGROUP_DISABLE_COMPLEMENTARY`` to "1" specifies that the |
| @@ -5390,7 +5390,7 @@ system and gives an overview of their function and contents. | |||
| 5390 | should not be automatically created by the ``packagegroup`` recipe, | 5390 | should not be automatically created by the ``packagegroup`` recipe, |
| 5391 | which is the default behavior. | 5391 | which is the default behavior. |
| 5392 | 5392 | ||
| 5393 | PACKAGES | 5393 | :term:`PACKAGES` |
| 5394 | The list of packages the recipe creates. The default value is the | 5394 | The list of packages the recipe creates. The default value is the |
| 5395 | following: | 5395 | following: |
| 5396 | :: | 5396 | :: |
| @@ -5410,7 +5410,7 @@ system and gives an overview of their function and contents. | |||
| 5410 | unless generation is forced through the | 5410 | unless generation is forced through the |
| 5411 | :term:`ALLOW_EMPTY` variable. | 5411 | :term:`ALLOW_EMPTY` variable. |
| 5412 | 5412 | ||
| 5413 | PACKAGES_DYNAMIC | 5413 | :term:`PACKAGES_DYNAMIC` |
| 5414 | A promise that your recipe satisfies runtime dependencies for | 5414 | A promise that your recipe satisfies runtime dependencies for |
| 5415 | optional modules that are found in other recipes. | 5415 | optional modules that are found in other recipes. |
| 5416 | ``PACKAGES_DYNAMIC`` does not actually satisfy the dependencies, it | 5416 | ``PACKAGES_DYNAMIC`` does not actually satisfy the dependencies, it |
| @@ -5433,7 +5433,7 @@ system and gives an overview of their function and contents. | |||
| 5433 | ":ref:`dev-manual/dev-manual-common-tasks:handling optional module packaging`" | 5433 | ":ref:`dev-manual/dev-manual-common-tasks:handling optional module packaging`" |
| 5434 | section in the Yocto Project Development Tasks Manual. | 5434 | section in the Yocto Project Development Tasks Manual. |
| 5435 | 5435 | ||
| 5436 | PACKAGESPLITFUNCS | 5436 | :term:`PACKAGESPLITFUNCS` |
| 5437 | Specifies a list of functions run to perform additional splitting of | 5437 | Specifies a list of functions run to perform additional splitting of |
| 5438 | files into individual packages. Recipes can either prepend to this | 5438 | files into individual packages. Recipes can either prepend to this |
| 5439 | variable or prepend to the ``populate_packages`` function in order to | 5439 | variable or prepend to the ``populate_packages`` function in order to |
| @@ -5443,7 +5443,7 @@ system and gives an overview of their function and contents. | |||
| 5443 | other packaging variables appropriately in order to perform the | 5443 | other packaging variables appropriately in order to perform the |
| 5444 | desired splitting. | 5444 | desired splitting. |
| 5445 | 5445 | ||
| 5446 | PARALLEL_MAKE | 5446 | :term:`PARALLEL_MAKE` |
| 5447 | Extra options passed to the ``make`` command during the | 5447 | Extra options passed to the ``make`` command during the |
| 5448 | :ref:`ref-tasks-compile` task in order to specify | 5448 | :ref:`ref-tasks-compile` task in order to specify |
| 5449 | parallel compilation on the local build host. This variable is | 5449 | parallel compilation on the local build host. This variable is |
| @@ -5489,7 +5489,7 @@ system and gives an overview of their function and contents. | |||
| 5489 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" | 5489 | ":ref:`dev-manual/dev-manual-common-tasks:speeding up a build`" |
| 5490 | section in the Yocto Project Development Tasks Manual. | 5490 | section in the Yocto Project Development Tasks Manual. |
| 5491 | 5491 | ||
| 5492 | PARALLEL_MAKEINST | 5492 | :term:`PARALLEL_MAKEINST` |
| 5493 | Extra options passed to the ``make install`` command during the | 5493 | Extra options passed to the ``make install`` command during the |
| 5494 | :ref:`ref-tasks-install` task in order to specify | 5494 | :ref:`ref-tasks-install` task in order to specify |
| 5495 | parallel installation. This variable defaults to the value of | 5495 | parallel installation. This variable defaults to the value of |
| @@ -5509,7 +5509,7 @@ system and gives an overview of their function and contents. | |||
| 5509 | ":ref:`dev-manual/dev-manual-common-tasks:debugging parallel make races`" | 5509 | ":ref:`dev-manual/dev-manual-common-tasks:debugging parallel make races`" |
| 5510 | section in the Yocto Project Development Tasks Manual. | 5510 | section in the Yocto Project Development Tasks Manual. |
| 5511 | 5511 | ||
| 5512 | PATCHRESOLVE | 5512 | :term:`PATCHRESOLVE` |
| 5513 | Determines the action to take when a patch fails. You can set this | 5513 | Determines the action to take when a patch fails. You can set this |
| 5514 | variable to one of two values: "noop" and "user". | 5514 | variable to one of two values: "noop" and "user". |
| 5515 | 5515 | ||
| @@ -5521,7 +5521,7 @@ system and gives an overview of their function and contents. | |||
| 5521 | 5521 | ||
| 5522 | Set this variable in your ``local.conf`` file. | 5522 | Set this variable in your ``local.conf`` file. |
| 5523 | 5523 | ||
| 5524 | PATCHTOOL | 5524 | :term:`PATCHTOOL` |
| 5525 | Specifies the utility used to apply patches for a recipe during the | 5525 | Specifies the utility used to apply patches for a recipe during the |
| 5526 | :ref:`ref-tasks-patch` task. You can specify one of | 5526 | :ref:`ref-tasks-patch` task. You can specify one of |
| 5527 | three utilities: "patch", "quilt", or "git". The default utility used | 5527 | three utilities: "patch", "quilt", or "git". The default utility used |
| @@ -5537,20 +5537,20 @@ system and gives an overview of their function and contents. | |||
| 5537 | PATCHTOOL = "quilt" | 5537 | PATCHTOOL = "quilt" |
| 5538 | PATCHTOOL = "git" | 5538 | PATCHTOOL = "git" |
| 5539 | 5539 | ||
| 5540 | PE | 5540 | :term:`PE` |
| 5541 | The epoch of the recipe. By default, this variable is unset. The | 5541 | The epoch of the recipe. By default, this variable is unset. The |
| 5542 | variable is used to make upgrades possible when the versioning scheme | 5542 | variable is used to make upgrades possible when the versioning scheme |
| 5543 | changes in some backwards incompatible way. | 5543 | changes in some backwards incompatible way. |
| 5544 | 5544 | ||
| 5545 | ``PE`` is the default value of the :term:`PKGE` variable. | 5545 | ``PE`` is the default value of the :term:`PKGE` variable. |
| 5546 | 5546 | ||
| 5547 | PF | 5547 | :term:`PF` |
| 5548 | Specifies the recipe or package name and includes all version and | 5548 | Specifies the recipe or package name and includes all version and |
| 5549 | revision numbers (i.e. ``glibc-2.13-r20+svnr15508/`` and | 5549 | revision numbers (i.e. ``glibc-2.13-r20+svnr15508/`` and |
| 5550 | ``bash-4.2-r1/``). This variable is comprised of the following: | 5550 | ``bash-4.2-r1/``). This variable is comprised of the following: |
| 5551 | ${:term:`PN`}-${:term:`EXTENDPE`}${:term:`PV`}-${:term:`PR`} | 5551 | ${:term:`PN`}-${:term:`EXTENDPE`}${:term:`PV`}-${:term:`PR`} |
| 5552 | 5552 | ||
| 5553 | PIXBUF_PACKAGES | 5553 | :term:`PIXBUF_PACKAGES` |
| 5554 | When inheriting the :ref:`pixbufcache <ref-classes-pixbufcache>` | 5554 | When inheriting the :ref:`pixbufcache <ref-classes-pixbufcache>` |
| 5555 | class, this variable identifies packages that contain the pixbuf | 5555 | class, this variable identifies packages that contain the pixbuf |
| 5556 | loaders used with ``gdk-pixbuf``. By default, the ``pixbufcache`` | 5556 | loaders used with ``gdk-pixbuf``. By default, the ``pixbufcache`` |
| @@ -5558,7 +5558,7 @@ system and gives an overview of their function and contents. | |||
| 5558 | ``${``\ :term:`PN`\ ``}``). Use this variable if the | 5558 | ``${``\ :term:`PN`\ ``}``). Use this variable if the |
| 5559 | loaders you need are in a package other than that main package. | 5559 | loaders you need are in a package other than that main package. |
| 5560 | 5560 | ||
| 5561 | PKG | 5561 | :term:`PKG` |
| 5562 | The name of the resulting package created by the OpenEmbedded build | 5562 | The name of the resulting package created by the OpenEmbedded build |
| 5563 | system. | 5563 | system. |
| 5564 | 5564 | ||
| @@ -5572,11 +5572,11 @@ system and gives an overview of their function and contents. | |||
| 5572 | renames the output package, it does so by setting | 5572 | renames the output package, it does so by setting |
| 5573 | ``PKG_packagename``. | 5573 | ``PKG_packagename``. |
| 5574 | 5574 | ||
| 5575 | PKG_CONFIG_PATH | 5575 | :term:`PKG_CONFIG_PATH` |
| 5576 | The path to ``pkg-config`` files for the current build context. | 5576 | The path to ``pkg-config`` files for the current build context. |
| 5577 | ``pkg-config`` reads this variable from the environment. | 5577 | ``pkg-config`` reads this variable from the environment. |
| 5578 | 5578 | ||
| 5579 | PKGD | 5579 | :term:`PKGD` |
| 5580 | Points to the destination directory for files to be packaged before | 5580 | Points to the destination directory for files to be packaged before |
| 5581 | they are split into individual packages. This directory defaults to | 5581 | they are split into individual packages. This directory defaults to |
| 5582 | the following: | 5582 | the following: |
| @@ -5586,7 +5586,7 @@ system and gives an overview of their function and contents. | |||
| 5586 | 5586 | ||
| 5587 | Do not change this default. | 5587 | Do not change this default. |
| 5588 | 5588 | ||
| 5589 | PKGDATA_DIR | 5589 | :term:`PKGDATA_DIR` |
| 5590 | Points to a shared, global-state directory that holds data generated | 5590 | Points to a shared, global-state directory that holds data generated |
| 5591 | during the packaging process. During the packaging process, the | 5591 | during the packaging process. During the packaging process, the |
| 5592 | :ref:`ref-tasks-packagedata` task packages data | 5592 | :ref:`ref-tasks-packagedata` task packages data |
| @@ -5605,7 +5605,7 @@ system and gives an overview of their function and contents. | |||
| 5605 | information on the shared, global-state directory, see | 5605 | information on the shared, global-state directory, see |
| 5606 | :term:`STAGING_DIR_HOST`. | 5606 | :term:`STAGING_DIR_HOST`. |
| 5607 | 5607 | ||
| 5608 | PKGDEST | 5608 | :term:`PKGDEST` |
| 5609 | Points to the parent directory for files to be packaged after they | 5609 | Points to the parent directory for files to be packaged after they |
| 5610 | have been split into individual packages. This directory defaults to | 5610 | have been split into individual packages. This directory defaults to |
| 5611 | the following: | 5611 | the following: |
| @@ -5617,7 +5617,7 @@ system and gives an overview of their function and contents. | |||
| 5617 | package specified in :term:`PACKAGES`. Do not change | 5617 | package specified in :term:`PACKAGES`. Do not change |
| 5618 | this default. | 5618 | this default. |
| 5619 | 5619 | ||
| 5620 | PKGDESTWORK | 5620 | :term:`PKGDESTWORK` |
| 5621 | Points to a temporary work area where the | 5621 | Points to a temporary work area where the |
| 5622 | :ref:`ref-tasks-package` task saves package metadata. | 5622 | :ref:`ref-tasks-package` task saves package metadata. |
| 5623 | The ``PKGDESTWORK`` location defaults to the following: | 5623 | The ``PKGDESTWORK`` location defaults to the following: |
| @@ -5631,19 +5631,19 @@ system and gives an overview of their function and contents. | |||
| 5631 | package metadata from ``PKGDESTWORK`` to | 5631 | package metadata from ``PKGDESTWORK`` to |
| 5632 | :term:`PKGDATA_DIR` to make it available globally. | 5632 | :term:`PKGDATA_DIR` to make it available globally. |
| 5633 | 5633 | ||
| 5634 | PKGE | 5634 | :term:`PKGE` |
| 5635 | The epoch of the package(s) built by the recipe. By default, ``PKGE`` | 5635 | The epoch of the package(s) built by the recipe. By default, ``PKGE`` |
| 5636 | is set to :term:`PE`. | 5636 | is set to :term:`PE`. |
| 5637 | 5637 | ||
| 5638 | PKGR | 5638 | :term:`PKGR` |
| 5639 | The revision of the package(s) built by the recipe. By default, | 5639 | The revision of the package(s) built by the recipe. By default, |
| 5640 | ``PKGR`` is set to :term:`PR`. | 5640 | ``PKGR`` is set to :term:`PR`. |
| 5641 | 5641 | ||
| 5642 | PKGV | 5642 | :term:`PKGV` |
| 5643 | The version of the package(s) built by the recipe. By default, | 5643 | The version of the package(s) built by the recipe. By default, |
| 5644 | ``PKGV`` is set to :term:`PV`. | 5644 | ``PKGV`` is set to :term:`PV`. |
| 5645 | 5645 | ||
| 5646 | PN | 5646 | :term:`PN` |
| 5647 | This variable can have two separate functions depending on the | 5647 | This variable can have two separate functions depending on the |
| 5648 | context: a recipe name or a resulting package name. | 5648 | context: a recipe name or a resulting package name. |
| 5649 | 5649 | ||
| @@ -5662,7 +5662,7 @@ system and gives an overview of their function and contents. | |||
| 5662 | packages for the target and for Multilib, ``PN`` would be ``bash`` | 5662 | packages for the target and for Multilib, ``PN`` would be ``bash`` |
| 5663 | and ``lib64-bash``, respectively. | 5663 | and ``lib64-bash``, respectively. |
| 5664 | 5664 | ||
| 5665 | PNBLACKLIST | 5665 | :term:`PNBLACKLIST` |
| 5666 | Lists recipes you do not want the OpenEmbedded build system to build. | 5666 | Lists recipes you do not want the OpenEmbedded build system to build. |
| 5667 | This variable works in conjunction with the | 5667 | This variable works in conjunction with the |
| 5668 | :ref:`blacklist <ref-classes-blacklist>` class, which is inherited | 5668 | :ref:`blacklist <ref-classes-blacklist>` class, which is inherited |
| @@ -5675,7 +5675,7 @@ system and gives an overview of their function and contents. | |||
| 5675 | 5675 | ||
| 5676 | PNBLACKLIST[myrecipe] = "Not supported by our organization." | 5676 | PNBLACKLIST[myrecipe] = "Not supported by our organization." |
| 5677 | 5677 | ||
| 5678 | POPULATE_SDK_POST_HOST_COMMAND | 5678 | :term:`POPULATE_SDK_POST_HOST_COMMAND` |
| 5679 | Specifies a list of functions to call once the OpenEmbedded build | 5679 | Specifies a list of functions to call once the OpenEmbedded build |
| 5680 | system has created the host part of the SDK. You can specify | 5680 | system has created the host part of the SDK. You can specify |
| 5681 | functions separated by semicolons: | 5681 | functions separated by semicolons: |
| @@ -5688,7 +5688,7 @@ system and gives an overview of their function and contents. | |||
| 5688 | the OpenEmbedded build system when creating SDK output. See the | 5688 | the OpenEmbedded build system when creating SDK output. See the |
| 5689 | :term:`SDK_DIR` variable for more information. | 5689 | :term:`SDK_DIR` variable for more information. |
| 5690 | 5690 | ||
| 5691 | POPULATE_SDK_POST_TARGET_COMMAND | 5691 | :term:`POPULATE_SDK_POST_TARGET_COMMAND` |
| 5692 | Specifies a list of functions to call once the OpenEmbedded build | 5692 | Specifies a list of functions to call once the OpenEmbedded build |
| 5693 | system has created the target part of the SDK. You can specify | 5693 | system has created the target part of the SDK. You can specify |
| 5694 | functions separated by semicolons: | 5694 | functions separated by semicolons: |
| @@ -5701,7 +5701,7 @@ system and gives an overview of their function and contents. | |||
| 5701 | the OpenEmbedded build system when creating SDK output. See the | 5701 | the OpenEmbedded build system when creating SDK output. See the |
| 5702 | :term:`SDK_DIR` variable for more information. | 5702 | :term:`SDK_DIR` variable for more information. |
| 5703 | 5703 | ||
| 5704 | PR | 5704 | :term:`PR` |
| 5705 | The revision of the recipe. The default value for this variable is | 5705 | The revision of the recipe. The default value for this variable is |
| 5706 | "r0". Subsequent revisions of the recipe conventionally have the | 5706 | "r0". Subsequent revisions of the recipe conventionally have the |
| 5707 | values "r1", "r2", and so forth. When :term:`PV` increases, | 5707 | values "r1", "r2", and so forth. When :term:`PV` increases, |
| @@ -5740,7 +5740,7 @@ system and gives an overview of their function and contents. | |||
| 5740 | ":ref:`dev-manual/dev-manual-common-tasks:working with a pr service`" section | 5740 | ":ref:`dev-manual/dev-manual-common-tasks:working with a pr service`" section |
| 5741 | in the Yocto Project Development Tasks Manual for more information. | 5741 | in the Yocto Project Development Tasks Manual for more information. |
| 5742 | 5742 | ||
| 5743 | PREFERRED_PROVIDER | 5743 | :term:`PREFERRED_PROVIDER` |
| 5744 | If multiple recipes provide the same item, this variable determines | 5744 | If multiple recipes provide the same item, this variable determines |
| 5745 | which recipe is preferred and thus provides the item (i.e. the | 5745 | which recipe is preferred and thus provides the item (i.e. the |
| 5746 | preferred provider). You should always suffix this variable with the | 5746 | preferred provider). You should always suffix this variable with the |
| @@ -5779,7 +5779,7 @@ system and gives an overview of their function and contents. | |||
| 5779 | mechanism is designed to select between mutually exclusive | 5779 | mechanism is designed to select between mutually exclusive |
| 5780 | alternative providers. | 5780 | alternative providers. |
| 5781 | 5781 | ||
| 5782 | PREFERRED_VERSION | 5782 | :term:`PREFERRED_VERSION` |
| 5783 | If multiple versions of recipes exist, this variable determines which | 5783 | If multiple versions of recipes exist, this variable determines which |
| 5784 | version is given preference. You must always suffix the variable with | 5784 | version is given preference. You must always suffix the variable with |
| 5785 | the :term:`PN` you want to select, and you should set the | 5785 | the :term:`PN` you want to select, and you should set the |
| @@ -5841,7 +5841,7 @@ system and gives an overview of their function and contents. | |||
| 5841 | The \_forcevariable override is not handled specially. This override | 5841 | The \_forcevariable override is not handled specially. This override |
| 5842 | only works because the default value of OVERRIDES includes "forcevariable". | 5842 | only works because the default value of OVERRIDES includes "forcevariable". |
| 5843 | 5843 | ||
| 5844 | PREMIRRORS | 5844 | :term:`PREMIRRORS` |
| 5845 | Specifies additional paths from which the OpenEmbedded build system | 5845 | Specifies additional paths from which the OpenEmbedded build system |
| 5846 | gets source code. When the build system searches for source code, it | 5846 | gets source code. When the build system searches for source code, it |
| 5847 | first tries the local download directory. If that location fails, the | 5847 | first tries the local download directory. If that location fails, the |
| @@ -5871,7 +5871,7 @@ system and gives an overview of their function and contents. | |||
| 5871 | ``file://`` URLs to point to local directories or network shares as | 5871 | ``file://`` URLs to point to local directories or network shares as |
| 5872 | well. | 5872 | well. |
| 5873 | 5873 | ||
| 5874 | PRIORITY | 5874 | :term:`PRIORITY` |
| 5875 | Indicates the importance of a package. | 5875 | Indicates the importance of a package. |
| 5876 | 5876 | ||
| 5877 | ``PRIORITY`` is considered to be part of the distribution policy | 5877 | ``PRIORITY`` is considered to be part of the distribution policy |
| @@ -5882,7 +5882,7 @@ system and gives an overview of their function and contents. | |||
| 5882 | You can set ``PRIORITY`` to "required", "standard", "extra", and | 5882 | You can set ``PRIORITY`` to "required", "standard", "extra", and |
| 5883 | "optional", which is the default. | 5883 | "optional", which is the default. |
| 5884 | 5884 | ||
| 5885 | PRIVATE_LIBS | 5885 | :term:`PRIVATE_LIBS` |
| 5886 | Specifies libraries installed within a recipe that should be ignored | 5886 | Specifies libraries installed within a recipe that should be ignored |
| 5887 | by the OpenEmbedded build system's shared library resolver. This | 5887 | by the OpenEmbedded build system's shared library resolver. This |
| 5888 | variable is typically used when software being built by a recipe has | 5888 | variable is typically used when software being built by a recipe has |
| @@ -5908,7 +5908,7 @@ system and gives an overview of their function and contents. | |||
| 5908 | ":ref:`overview-manual/overview-manual-concepts:automatically added runtime dependencies`" | 5908 | ":ref:`overview-manual/overview-manual-concepts:automatically added runtime dependencies`" |
| 5909 | section in the Yocto Project Overview and Concepts Manual. | 5909 | section in the Yocto Project Overview and Concepts Manual. |
| 5910 | 5910 | ||
| 5911 | PROVIDES | 5911 | :term:`PROVIDES` |
| 5912 | A list of aliases by which a particular recipe can be known. By | 5912 | A list of aliases by which a particular recipe can be known. By |
| 5913 | default, a recipe's own ``PN`` is implicitly already in its | 5913 | default, a recipe's own ``PN`` is implicitly already in its |
| 5914 | ``PROVIDES`` list and therefore does not need to mention that it | 5914 | ``PROVIDES`` list and therefore does not need to mention that it |
| @@ -5971,7 +5971,7 @@ system and gives an overview of their function and contents. | |||
| 5971 | VIRTUAL-RUNTIME_dev_manager = "udev" | 5971 | VIRTUAL-RUNTIME_dev_manager = "udev" |
| 5972 | 5972 | ||
| 5973 | 5973 | ||
| 5974 | PRSERV_HOST | 5974 | :term:`PRSERV_HOST` |
| 5975 | The network based :term:`PR` service host and port. | 5975 | The network based :term:`PR` service host and port. |
| 5976 | 5976 | ||
| 5977 | The ``conf/local.conf.sample.extended`` configuration file in the | 5977 | The ``conf/local.conf.sample.extended`` configuration file in the |
| @@ -5986,7 +5986,7 @@ system and gives an overview of their function and contents. | |||
| 5986 | service <dev-manual/dev-manual-common-tasks:working with a pr service>`. You can | 5986 | service <dev-manual/dev-manual-common-tasks:working with a pr service>`. You can |
| 5987 | set ``PRSERV_HOST`` to other values to use a remote PR service. | 5987 | set ``PRSERV_HOST`` to other values to use a remote PR service. |
| 5988 | 5988 | ||
| 5989 | PTEST_ENABLED | 5989 | :term:`PTEST_ENABLED` |
| 5990 | Specifies whether or not :ref:`Package | 5990 | Specifies whether or not :ref:`Package |
| 5991 | Test <dev-manual/dev-manual-common-tasks:testing packages with ptest>` (ptest) | 5991 | Test <dev-manual/dev-manual-common-tasks:testing packages with ptest>` (ptest) |
| 5992 | functionality is enabled when building a recipe. You should not set | 5992 | functionality is enabled when building a recipe. You should not set |
| @@ -5994,7 +5994,7 @@ system and gives an overview of their function and contents. | |||
| 5994 | at build time should be done by adding "ptest" to (or removing it | 5994 | at build time should be done by adding "ptest" to (or removing it |
| 5995 | from) :term:`DISTRO_FEATURES`. | 5995 | from) :term:`DISTRO_FEATURES`. |
| 5996 | 5996 | ||
| 5997 | PV | 5997 | :term:`PV` |
| 5998 | The version of the recipe. The version is normally extracted from the | 5998 | The version of the recipe. The version is normally extracted from the |
| 5999 | recipe filename. For example, if the recipe is named | 5999 | recipe filename. For example, if the recipe is named |
| 6000 | ``expat_2.0.1.bb``, then the default value of ``PV`` will be "2.0.1". | 6000 | ``expat_2.0.1.bb``, then the default value of ``PV`` will be "2.0.1". |
| @@ -6004,7 +6004,7 @@ system and gives an overview of their function and contents. | |||
| 6004 | 6004 | ||
| 6005 | ``PV`` is the default value of the :term:`PKGV` variable. | 6005 | ``PV`` is the default value of the :term:`PKGV` variable. |
| 6006 | 6006 | ||
| 6007 | PYTHON_ABI | 6007 | :term:`PYTHON_ABI` |
| 6008 | When used by recipes that inherit the | 6008 | When used by recipes that inherit the |
| 6009 | :ref:`distutils3 <ref-classes-distutils3>`, | 6009 | :ref:`distutils3 <ref-classes-distutils3>`, |
| 6010 | :ref:`setuptools3 <ref-classes-setuptools3>`, | 6010 | :ref:`setuptools3 <ref-classes-setuptools3>`, |
| @@ -6022,7 +6022,7 @@ system and gives an overview of their function and contents. | |||
| 6022 | use this variable to locate the headers and libraries of the | 6022 | use this variable to locate the headers and libraries of the |
| 6023 | appropriate Python that the extension is targeting. | 6023 | appropriate Python that the extension is targeting. |
| 6024 | 6024 | ||
| 6025 | PYTHON_PN | 6025 | :term:`PYTHON_PN` |
| 6026 | When used by recipes that inherit the | 6026 | When used by recipes that inherit the |
| 6027 | `distutils3 <ref-classes-distutils3>`, | 6027 | `distutils3 <ref-classes-distutils3>`, |
| 6028 | :ref:`setuptools3 <ref-classes-setuptools3>`, | 6028 | :ref:`setuptools3 <ref-classes-setuptools3>`, |
| @@ -6041,10 +6041,10 @@ system and gives an overview of their function and contents. | |||
| 6041 | In the previous example, | 6041 | In the previous example, |
| 6042 | the version of the dependency is ``PYTHON_PN``. | 6042 | the version of the dependency is ``PYTHON_PN``. |
| 6043 | 6043 | ||
| 6044 | RANLIB | 6044 | :term:`RANLIB` |
| 6045 | The minimal command and arguments to run ``ranlib``. | 6045 | The minimal command and arguments to run ``ranlib``. |
| 6046 | 6046 | ||
| 6047 | RCONFLICTS | 6047 | :term:`RCONFLICTS` |
| 6048 | The list of packages that conflict with packages. Note that packages | 6048 | The list of packages that conflict with packages. Note that packages |
| 6049 | will not be installed if conflicting packages are not first removed. | 6049 | will not be installed if conflicting packages are not first removed. |
| 6050 | 6050 | ||
| @@ -6070,7 +6070,7 @@ system and gives an overview of their function and contents. | |||
| 6070 | 6070 | ||
| 6071 | RCONFLICTS_${PN} = "foo (>= 1.2)" | 6071 | RCONFLICTS_${PN} = "foo (>= 1.2)" |
| 6072 | 6072 | ||
| 6073 | RDEPENDS | 6073 | :term:`RDEPENDS` |
| 6074 | Lists runtime dependencies of a package. These dependencies are other | 6074 | Lists runtime dependencies of a package. These dependencies are other |
| 6075 | packages that must be installed in order for the package to function | 6075 | packages that must be installed in order for the package to function |
| 6076 | correctly. As an example, the following assignment declares that the | 6076 | correctly. As an example, the following assignment declares that the |
| @@ -6182,7 +6182,7 @@ system and gives an overview of their function and contents. | |||
| 6182 | BitBake User Manual for additional information on tasks and | 6182 | BitBake User Manual for additional information on tasks and |
| 6183 | dependencies. | 6183 | dependencies. |
| 6184 | 6184 | ||
| 6185 | REQUIRED_DISTRO_FEATURES | 6185 | :term:`REQUIRED_DISTRO_FEATURES` |
| 6186 | When inheriting the | 6186 | When inheriting the |
| 6187 | :ref:`distro_features_check <ref-classes-distro_features_check>` | 6187 | :ref:`distro_features_check <ref-classes-distro_features_check>` |
| 6188 | class, this variable identifies distribution features that must exist | 6188 | class, this variable identifies distribution features that must exist |
| @@ -6192,13 +6192,13 @@ system and gives an overview of their function and contents. | |||
| 6192 | appear in ``DISTRO_FEATURES`` within the current configuration, an | 6192 | appear in ``DISTRO_FEATURES`` within the current configuration, an |
| 6193 | error occurs and the build stops. | 6193 | error occurs and the build stops. |
| 6194 | 6194 | ||
| 6195 | RM_WORK_EXCLUDE | 6195 | :term:`RM_WORK_EXCLUDE` |
| 6196 | With ``rm_work`` enabled, this variable specifies a list of recipes | 6196 | With ``rm_work`` enabled, this variable specifies a list of recipes |
| 6197 | whose work directories should not be removed. See the | 6197 | whose work directories should not be removed. See the |
| 6198 | ":ref:`rm_work.bbclass <ref-classes-rm-work>`" section for more | 6198 | ":ref:`rm_work.bbclass <ref-classes-rm-work>`" section for more |
| 6199 | details. | 6199 | details. |
| 6200 | 6200 | ||
| 6201 | ROOT_HOME | 6201 | :term:`ROOT_HOME` |
| 6202 | Defines the root home directory. By default, this directory is set as | 6202 | Defines the root home directory. By default, this directory is set as |
| 6203 | follows in the BitBake configuration file: | 6203 | follows in the BitBake configuration file: |
| 6204 | :: | 6204 | :: |
| @@ -6224,13 +6224,13 @@ system and gives an overview of their function and contents. | |||
| 6224 | override examples use ``/root``, which is probably the most commonly | 6224 | override examples use ``/root``, which is probably the most commonly |
| 6225 | used override. | 6225 | used override. |
| 6226 | 6226 | ||
| 6227 | ROOTFS | 6227 | :term:`ROOTFS` |
| 6228 | Indicates a filesystem image to include as the root filesystem. | 6228 | Indicates a filesystem image to include as the root filesystem. |
| 6229 | 6229 | ||
| 6230 | The ``ROOTFS`` variable is an optional variable used with the | 6230 | The ``ROOTFS`` variable is an optional variable used with the |
| 6231 | :ref:`image-live <ref-classes-image-live>` class. | 6231 | :ref:`image-live <ref-classes-image-live>` class. |
| 6232 | 6232 | ||
| 6233 | ROOTFS_POSTINSTALL_COMMAND | 6233 | :term:`ROOTFS_POSTINSTALL_COMMAND` |
| 6234 | Specifies a list of functions to call after the OpenEmbedded build | 6234 | Specifies a list of functions to call after the OpenEmbedded build |
| 6235 | system has installed packages. You can specify functions separated by | 6235 | system has installed packages. You can specify functions separated by |
| 6236 | semicolons: | 6236 | semicolons: |
| @@ -6244,7 +6244,7 @@ system and gives an overview of their function and contents. | |||
| 6244 | :term:`IMAGE_ROOTFS` variable for more | 6244 | :term:`IMAGE_ROOTFS` variable for more |
| 6245 | information. | 6245 | information. |
| 6246 | 6246 | ||
| 6247 | ROOTFS_POSTPROCESS_COMMAND | 6247 | :term:`ROOTFS_POSTPROCESS_COMMAND` |
| 6248 | Specifies a list of functions to call once the OpenEmbedded build | 6248 | Specifies a list of functions to call once the OpenEmbedded build |
| 6249 | system has created the root filesystem. You can specify functions | 6249 | system has created the root filesystem. You can specify functions |
| 6250 | separated by semicolons: | 6250 | separated by semicolons: |
| @@ -6258,7 +6258,7 @@ system and gives an overview of their function and contents. | |||
| 6258 | :term:`IMAGE_ROOTFS` variable for more | 6258 | :term:`IMAGE_ROOTFS` variable for more |
| 6259 | information. | 6259 | information. |
| 6260 | 6260 | ||
| 6261 | ROOTFS_POSTUNINSTALL_COMMAND | 6261 | :term:`ROOTFS_POSTUNINSTALL_COMMAND` |
| 6262 | Specifies a list of functions to call after the OpenEmbedded build | 6262 | Specifies a list of functions to call after the OpenEmbedded build |
| 6263 | system has removed unnecessary packages. When runtime package | 6263 | system has removed unnecessary packages. When runtime package |
| 6264 | management is disabled in the image, several packages are removed | 6264 | management is disabled in the image, several packages are removed |
| @@ -6274,7 +6274,7 @@ system and gives an overview of their function and contents. | |||
| 6274 | :term:`IMAGE_ROOTFS` variable for more | 6274 | :term:`IMAGE_ROOTFS` variable for more |
| 6275 | information. | 6275 | information. |
| 6276 | 6276 | ||
| 6277 | ROOTFS_PREPROCESS_COMMAND | 6277 | :term:`ROOTFS_PREPROCESS_COMMAND` |
| 6278 | Specifies a list of functions to call before the OpenEmbedded build | 6278 | Specifies a list of functions to call before the OpenEmbedded build |
| 6279 | system has created the root filesystem. You can specify functions | 6279 | system has created the root filesystem. You can specify functions |
| 6280 | separated by semicolons: | 6280 | separated by semicolons: |
| @@ -6288,7 +6288,7 @@ system and gives an overview of their function and contents. | |||
| 6288 | :term:`IMAGE_ROOTFS` variable for more | 6288 | :term:`IMAGE_ROOTFS` variable for more |
| 6289 | information. | 6289 | information. |
| 6290 | 6290 | ||
| 6291 | RPROVIDES | 6291 | :term:`RPROVIDES` |
| 6292 | A list of package name aliases that a package also provides. These | 6292 | A list of package name aliases that a package also provides. These |
| 6293 | aliases are useful for satisfying runtime dependencies of other | 6293 | aliases are useful for satisfying runtime dependencies of other |
| 6294 | packages both during the build and on the target (as specified by | 6294 | packages both during the build and on the target (as specified by |
| @@ -6307,7 +6307,7 @@ system and gives an overview of their function and contents. | |||
| 6307 | 6307 | ||
| 6308 | RPROVIDES_${PN} = "widget-abi-2" | 6308 | RPROVIDES_${PN} = "widget-abi-2" |
| 6309 | 6309 | ||
| 6310 | RRECOMMENDS | 6310 | :term:`RRECOMMENDS` |
| 6311 | A list of packages that extends the usability of a package being | 6311 | A list of packages that extends the usability of a package being |
| 6312 | built. The package being built does not depend on this list of | 6312 | built. The package being built does not depend on this list of |
| 6313 | packages in order to successfully build, but rather uses them for | 6313 | packages in order to successfully build, but rather uses them for |
| @@ -6367,7 +6367,7 @@ system and gives an overview of their function and contents. | |||
| 6367 | 6367 | ||
| 6368 | RRECOMMENDS_${PN} = "foo (>= 1.2)" | 6368 | RRECOMMENDS_${PN} = "foo (>= 1.2)" |
| 6369 | 6369 | ||
| 6370 | RREPLACES | 6370 | :term:`RREPLACES` |
| 6371 | A list of packages replaced by a package. The package manager uses | 6371 | A list of packages replaced by a package. The package manager uses |
| 6372 | this variable to determine which package should be installed to | 6372 | this variable to determine which package should be installed to |
| 6373 | replace other package(s) during an upgrade. In order to also have the | 6373 | replace other package(s) during an upgrade. In order to also have the |
| @@ -6403,7 +6403,7 @@ system and gives an overview of their function and contents. | |||
| 6403 | 6403 | ||
| 6404 | RREPLACES_${PN} = "foo (>= 1.2)" | 6404 | RREPLACES_${PN} = "foo (>= 1.2)" |
| 6405 | 6405 | ||
| 6406 | RSUGGESTS | 6406 | :term:`RSUGGESTS` |
| 6407 | A list of additional packages that you can suggest for installation | 6407 | A list of additional packages that you can suggest for installation |
| 6408 | by the package manager at the time a package is installed. Not all | 6408 | by the package manager at the time a package is installed. Not all |
| 6409 | package managers support this functionality. | 6409 | package managers support this functionality. |
| @@ -6415,7 +6415,7 @@ system and gives an overview of their function and contents. | |||
| 6415 | 6415 | ||
| 6416 | RSUGGESTS_${PN} = "useful_package another_package" | 6416 | RSUGGESTS_${PN} = "useful_package another_package" |
| 6417 | 6417 | ||
| 6418 | S | 6418 | :term:`S` |
| 6419 | The location in the :term:`Build Directory` where | 6419 | The location in the :term:`Build Directory` where |
| 6420 | unpacked recipe source code resides. By default, this directory is | 6420 | unpacked recipe source code resides. By default, this directory is |
| 6421 | ``${``\ :term:`WORKDIR`\ ``}/${``\ :term:`BPN`\ ``}-${``\ :term:`PV`\ ``}``, | 6421 | ``${``\ :term:`WORKDIR`\ ``}/${``\ :term:`BPN`\ ``}-${``\ :term:`PV`\ ``}``, |
| @@ -6446,13 +6446,13 @@ system and gives an overview of their function and contents. | |||
| 6446 | SRC_URI = "git://path/to/repo.git" | 6446 | SRC_URI = "git://path/to/repo.git" |
| 6447 | S = "${WORKDIR}/git" | 6447 | S = "${WORKDIR}/git" |
| 6448 | 6448 | ||
| 6449 | SANITY_REQUIRED_UTILITIES | 6449 | :term:`SANITY_REQUIRED_UTILITIES` |
| 6450 | Specifies a list of command-line utilities that should be checked for | 6450 | Specifies a list of command-line utilities that should be checked for |
| 6451 | during the initial sanity checking process when running BitBake. If | 6451 | during the initial sanity checking process when running BitBake. If |
| 6452 | any of the utilities are not installed on the build host, then | 6452 | any of the utilities are not installed on the build host, then |
| 6453 | BitBake immediately exits with an error. | 6453 | BitBake immediately exits with an error. |
| 6454 | 6454 | ||
| 6455 | SANITY_TESTED_DISTROS | 6455 | :term:`SANITY_TESTED_DISTROS` |
| 6456 | A list of the host distribution identifiers that the build system has | 6456 | A list of the host distribution identifiers that the build system has |
| 6457 | been tested against. Identifiers consist of the host distributor ID | 6457 | been tested against. Identifiers consist of the host distributor ID |
| 6458 | followed by the release, as reported by the ``lsb_release`` tool or | 6458 | followed by the release, as reported by the ``lsb_release`` tool or |
| @@ -6463,11 +6463,11 @@ system and gives an overview of their function and contents. | |||
| 6463 | list, then the build system reports a warning that indicates the | 6463 | list, then the build system reports a warning that indicates the |
| 6464 | current host distribution has not been tested as a build host. | 6464 | current host distribution has not been tested as a build host. |
| 6465 | 6465 | ||
| 6466 | SDK_ARCH | 6466 | :term:`SDK_ARCH` |
| 6467 | The target architecture for the SDK. Typically, you do not directly | 6467 | The target architecture for the SDK. Typically, you do not directly |
| 6468 | set this variable. Instead, use :term:`SDKMACHINE`. | 6468 | set this variable. Instead, use :term:`SDKMACHINE`. |
| 6469 | 6469 | ||
| 6470 | SDK_DEPLOY | 6470 | :term:`SDK_DEPLOY` |
| 6471 | The directory set up and used by the | 6471 | The directory set up and used by the |
| 6472 | :ref:`populate_sdk_base <ref-classes-populate-sdk>` class to which | 6472 | :ref:`populate_sdk_base <ref-classes-populate-sdk>` class to which |
| 6473 | the SDK is deployed. The ``populate_sdk_base`` class defines | 6473 | the SDK is deployed. The ``populate_sdk_base`` class defines |
| @@ -6476,7 +6476,7 @@ system and gives an overview of their function and contents. | |||
| 6476 | 6476 | ||
| 6477 | SDK_DEPLOY = "${TMPDIR}/deploy/sdk" | 6477 | SDK_DEPLOY = "${TMPDIR}/deploy/sdk" |
| 6478 | 6478 | ||
| 6479 | SDK_DIR | 6479 | :term:`SDK_DIR` |
| 6480 | The parent directory used by the OpenEmbedded build system when | 6480 | The parent directory used by the OpenEmbedded build system when |
| 6481 | creating SDK output. The | 6481 | creating SDK output. The |
| 6482 | :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` class defines | 6482 | :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` class defines |
| @@ -6495,7 +6495,7 @@ system and gives an overview of their function and contents. | |||
| 6495 | SDK_DEPLOY | 6495 | SDK_DEPLOY |
| 6496 | . | 6496 | . |
| 6497 | 6497 | ||
| 6498 | SDK_EXT_TYPE | 6498 | :term:`SDK_EXT_TYPE` |
| 6499 | Controls whether or not shared state artifacts are copied into the | 6499 | Controls whether or not shared state artifacts are copied into the |
| 6500 | extensible SDK. The default value of "full" copies all of the | 6500 | extensible SDK. The default value of "full" copies all of the |
| 6501 | required shared state artifacts into the extensible SDK. The value | 6501 | required shared state artifacts into the extensible SDK. The value |
| @@ -6508,7 +6508,7 @@ system and gives an overview of their function and contents. | |||
| 6508 | is set in the SDK's configuration to enable the artifacts to be | 6508 | is set in the SDK's configuration to enable the artifacts to be |
| 6509 | fetched as needed. | 6509 | fetched as needed. |
| 6510 | 6510 | ||
| 6511 | SDK_HOST_MANIFEST | 6511 | :term:`SDK_HOST_MANIFEST` |
| 6512 | The manifest file for the host part of the SDK. This file lists all | 6512 | The manifest file for the host part of the SDK. This file lists all |
| 6513 | the installed packages that make up the host part of the SDK. The | 6513 | the installed packages that make up the host part of the SDK. The |
| 6514 | file contains package information on a line-per-package basis as | 6514 | file contains package information on a line-per-package basis as |
| @@ -6526,7 +6526,7 @@ system and gives an overview of their function and contents. | |||
| 6526 | The location is derived using the :term:`SDK_DEPLOY` and | 6526 | The location is derived using the :term:`SDK_DEPLOY` and |
| 6527 | :term:`TOOLCHAIN_OUTPUTNAME` variables. | 6527 | :term:`TOOLCHAIN_OUTPUTNAME` variables. |
| 6528 | 6528 | ||
| 6529 | SDK_INCLUDE_PKGDATA | 6529 | :term:`SDK_INCLUDE_PKGDATA` |
| 6530 | When set to "1", specifies to include the packagedata for all recipes | 6530 | When set to "1", specifies to include the packagedata for all recipes |
| 6531 | in the "world" target in the extensible SDK. Including this data | 6531 | in the "world" target in the extensible SDK. Including this data |
| 6532 | allows the ``devtool search`` command to find these recipes in search | 6532 | allows the ``devtool search`` command to find these recipes in search |
| @@ -6541,7 +6541,7 @@ system and gives an overview of their function and contents. | |||
| 6541 | needs to be built. Enabling the variable also slightly increases | 6541 | needs to be built. Enabling the variable also slightly increases |
| 6542 | the size of the extensible SDK. | 6542 | the size of the extensible SDK. |
| 6543 | 6543 | ||
| 6544 | SDK_INCLUDE_TOOLCHAIN | 6544 | :term:`SDK_INCLUDE_TOOLCHAIN` |
| 6545 | When set to "1", specifies to include the toolchain in the extensible | 6545 | When set to "1", specifies to include the toolchain in the extensible |
| 6546 | SDK. Including the toolchain is useful particularly when | 6546 | SDK. Including the toolchain is useful particularly when |
| 6547 | :term:`SDK_EXT_TYPE` is set to "minimal" to keep | 6547 | :term:`SDK_EXT_TYPE` is set to "minimal" to keep |
| @@ -6554,7 +6554,7 @@ system and gives an overview of their function and contents. | |||
| 6554 | ``SDK_EXT_TYPE`` is set to "minimal", and defaults to "1" if | 6554 | ``SDK_EXT_TYPE`` is set to "minimal", and defaults to "1" if |
| 6555 | ``SDK_EXT_TYPE`` is set to "full". | 6555 | ``SDK_EXT_TYPE`` is set to "full". |
| 6556 | 6556 | ||
| 6557 | SDK_INHERIT_BLACKLIST | 6557 | :term:`SDK_INHERIT_BLACKLIST` |
| 6558 | A list of classes to remove from the :term:`INHERIT` | 6558 | A list of classes to remove from the :term:`INHERIT` |
| 6559 | value globally within the extensible SDK configuration. The | 6559 | value globally within the extensible SDK configuration. The |
| 6560 | :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the | 6560 | :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the |
| @@ -6572,7 +6572,7 @@ system and gives an overview of their function and contents. | |||
| 6572 | section in the Yocto Project Application Development and the | 6572 | section in the Yocto Project Application Development and the |
| 6573 | Extensible Software Development Kit (eSDK) manual. | 6573 | Extensible Software Development Kit (eSDK) manual. |
| 6574 | 6574 | ||
| 6575 | SDK_LOCAL_CONF_BLACKLIST | 6575 | :term:`SDK_LOCAL_CONF_BLACKLIST` |
| 6576 | A list of variables not allowed through from the OpenEmbedded build | 6576 | A list of variables not allowed through from the OpenEmbedded build |
| 6577 | system configuration into the extensible SDK configuration. Usually, | 6577 | system configuration into the extensible SDK configuration. Usually, |
| 6578 | these are variables that are specific to the machine on which the | 6578 | these are variables that are specific to the machine on which the |
| @@ -6598,7 +6598,7 @@ system and gives an overview of their function and contents. | |||
| 6598 | section in the Yocto Project Application Development and the | 6598 | section in the Yocto Project Application Development and the |
| 6599 | Extensible Software Development Kit (eSDK) manual. | 6599 | Extensible Software Development Kit (eSDK) manual. |
| 6600 | 6600 | ||
| 6601 | SDK_LOCAL_CONF_WHITELIST | 6601 | :term:`SDK_LOCAL_CONF_WHITELIST` |
| 6602 | A list of variables allowed through from the OpenEmbedded build | 6602 | A list of variables allowed through from the OpenEmbedded build |
| 6603 | system configuration into the extensible SDK configuration. By | 6603 | system configuration into the extensible SDK configuration. By |
| 6604 | default, the list of variables is empty and is set in the | 6604 | default, the list of variables is empty and is set in the |
| @@ -6617,7 +6617,7 @@ system and gives an overview of their function and contents. | |||
| 6617 | section in the Yocto Project Application Development and the | 6617 | section in the Yocto Project Application Development and the |
| 6618 | Extensible Software Development Kit (eSDK) manual. | 6618 | Extensible Software Development Kit (eSDK) manual. |
| 6619 | 6619 | ||
| 6620 | SDK_NAME | 6620 | :term:`SDK_NAME` |
| 6621 | The base name for SDK output files. The name is derived from the | 6621 | The base name for SDK output files. The name is derived from the |
| 6622 | :term:`DISTRO`, :term:`TCLIBC`, | 6622 | :term:`DISTRO`, :term:`TCLIBC`, |
| 6623 | :term:`SDK_ARCH`, | 6623 | :term:`SDK_ARCH`, |
| @@ -6627,11 +6627,11 @@ system and gives an overview of their function and contents. | |||
| 6627 | 6627 | ||
| 6628 | SDK_NAME = "${DISTRO}-${TCLIBC}-${SDK_ARCH}-${IMAGE_BASENAME}-${TUNE_PKGARCH}" | 6628 | SDK_NAME = "${DISTRO}-${TCLIBC}-${SDK_ARCH}-${IMAGE_BASENAME}-${TUNE_PKGARCH}" |
| 6629 | 6629 | ||
| 6630 | SDK_OS | 6630 | :term:`SDK_OS` |
| 6631 | Specifies the operating system for which the SDK will be built. The | 6631 | Specifies the operating system for which the SDK will be built. The |
| 6632 | default value is the value of :term:`BUILD_OS`. | 6632 | default value is the value of :term:`BUILD_OS`. |
| 6633 | 6633 | ||
| 6634 | SDK_OUTPUT | 6634 | :term:`SDK_OUTPUT` |
| 6635 | The location used by the OpenEmbedded build system when creating SDK | 6635 | The location used by the OpenEmbedded build system when creating SDK |
| 6636 | output. The :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` | 6636 | output. The :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` |
| 6637 | class defines the variable as follows: | 6637 | class defines the variable as follows: |
| @@ -6647,14 +6647,14 @@ system and gives an overview of their function and contents. | |||
| 6647 | WORKDIR by way of SDK_DIR. The final output directory is | 6647 | WORKDIR by way of SDK_DIR. The final output directory is |
| 6648 | SDK_DEPLOY. | 6648 | SDK_DEPLOY. |
| 6649 | 6649 | ||
| 6650 | SDK_PACKAGE_ARCHS | 6650 | :term:`SDK_PACKAGE_ARCHS` |
| 6651 | Specifies a list of architectures compatible with the SDK machine. | 6651 | Specifies a list of architectures compatible with the SDK machine. |
| 6652 | This variable is set automatically and should not normally be | 6652 | This variable is set automatically and should not normally be |
| 6653 | hand-edited. Entries are separated using spaces and listed in order | 6653 | hand-edited. Entries are separated using spaces and listed in order |
| 6654 | of priority. The default value for ``SDK_PACKAGE_ARCHS`` is "all any | 6654 | of priority. The default value for ``SDK_PACKAGE_ARCHS`` is "all any |
| 6655 | noarch ${SDK_ARCH}-${SDKPKGSUFFIX}". | 6655 | noarch ${SDK_ARCH}-${SDKPKGSUFFIX}". |
| 6656 | 6656 | ||
| 6657 | SDK_POSTPROCESS_COMMAND | 6657 | :term:`SDK_POSTPROCESS_COMMAND` |
| 6658 | Specifies a list of functions to call once the OpenEmbedded build | 6658 | Specifies a list of functions to call once the OpenEmbedded build |
| 6659 | system creates the SDK. You can specify functions separated by | 6659 | system creates the SDK. You can specify functions separated by |
| 6660 | semicolons: SDK_POSTPROCESS_COMMAND += "function; ... " | 6660 | semicolons: SDK_POSTPROCESS_COMMAND += "function; ... " |
| @@ -6664,13 +6664,13 @@ system and gives an overview of their function and contents. | |||
| 6664 | the OpenEmbedded build system when creating SDK output. See the | 6664 | the OpenEmbedded build system when creating SDK output. See the |
| 6665 | :term:`SDK_DIR` variable for more information. | 6665 | :term:`SDK_DIR` variable for more information. |
| 6666 | 6666 | ||
| 6667 | SDK_PREFIX | 6667 | :term:`SDK_PREFIX` |
| 6668 | The toolchain binary prefix used for ``nativesdk`` recipes. The | 6668 | The toolchain binary prefix used for ``nativesdk`` recipes. The |
| 6669 | OpenEmbedded build system uses the ``SDK_PREFIX`` value to set the | 6669 | OpenEmbedded build system uses the ``SDK_PREFIX`` value to set the |
| 6670 | :term:`TARGET_PREFIX` when building | 6670 | :term:`TARGET_PREFIX` when building |
| 6671 | ``nativesdk`` recipes. The default value is "${SDK_SYS}-". | 6671 | ``nativesdk`` recipes. The default value is "${SDK_SYS}-". |
| 6672 | 6672 | ||
| 6673 | SDK_RECRDEP_TASKS | 6673 | :term:`SDK_RECRDEP_TASKS` |
| 6674 | A list of shared state tasks added to the extensible SDK. By default, | 6674 | A list of shared state tasks added to the extensible SDK. By default, |
| 6675 | the following tasks are added: | 6675 | the following tasks are added: |
| 6676 | 6676 | ||
| @@ -6686,7 +6686,7 @@ system and gives an overview of their function and contents. | |||
| 6686 | tasks that are needed in order to build | 6686 | tasks that are needed in order to build |
| 6687 | :term:`SDK_TARGETS`). | 6687 | :term:`SDK_TARGETS`). |
| 6688 | 6688 | ||
| 6689 | SDK_SYS | 6689 | :term:`SDK_SYS` |
| 6690 | Specifies the system, including the architecture and the operating | 6690 | Specifies the system, including the architecture and the operating |
| 6691 | system, for which the SDK will be built. | 6691 | system, for which the SDK will be built. |
| 6692 | 6692 | ||
| @@ -6696,7 +6696,7 @@ system and gives an overview of their function and contents. | |||
| 6696 | :term:`SDK_OS`. You do not need to set the ``SDK_SYS`` | 6696 | :term:`SDK_OS`. You do not need to set the ``SDK_SYS`` |
| 6697 | variable yourself. | 6697 | variable yourself. |
| 6698 | 6698 | ||
| 6699 | SDK_TARGET_MANIFEST | 6699 | :term:`SDK_TARGET_MANIFEST` |
| 6700 | The manifest file for the target part of the SDK. This file lists all | 6700 | The manifest file for the target part of the SDK. This file lists all |
| 6701 | the installed packages that make up the target part of the SDK. The | 6701 | the installed packages that make up the target part of the SDK. The |
| 6702 | file contains package information on a line-per-package basis as | 6702 | file contains package information on a line-per-package basis as |
| @@ -6714,7 +6714,7 @@ system and gives an overview of their function and contents. | |||
| 6714 | The location is derived using the :term:`SDK_DEPLOY` and | 6714 | The location is derived using the :term:`SDK_DEPLOY` and |
| 6715 | :term:`TOOLCHAIN_OUTPUTNAME` variables. | 6715 | :term:`TOOLCHAIN_OUTPUTNAME` variables. |
| 6716 | 6716 | ||
| 6717 | SDK_TARGETS | 6717 | :term:`SDK_TARGETS` |
| 6718 | A list of targets to install from shared state as part of the | 6718 | A list of targets to install from shared state as part of the |
| 6719 | standard or extensible SDK installation. The default value is "${PN}" | 6719 | standard or extensible SDK installation. The default value is "${PN}" |
| 6720 | (i.e. the image from which the SDK is built). | 6720 | (i.e. the image from which the SDK is built). |
| @@ -6722,7 +6722,7 @@ system and gives an overview of their function and contents. | |||
| 6722 | The ``SDK_TARGETS`` variable is an internal variable and typically | 6722 | The ``SDK_TARGETS`` variable is an internal variable and typically |
| 6723 | would not be changed. | 6723 | would not be changed. |
| 6724 | 6724 | ||
| 6725 | SDK_TITLE | 6725 | :term:`SDK_TITLE` |
| 6726 | The title to be printed when running the SDK installer. By default, | 6726 | The title to be printed when running the SDK installer. By default, |
| 6727 | this title is based on the :term:`DISTRO_NAME` or | 6727 | this title is based on the :term:`DISTRO_NAME` or |
| 6728 | :term:`DISTRO` variable and is set in the | 6728 | :term:`DISTRO` variable and is set in the |
| @@ -6740,15 +6740,15 @@ system and gives an overview of their function and contents. | |||
| 6740 | section in the Yocto Project Application Development and the | 6740 | section in the Yocto Project Application Development and the |
| 6741 | Extensible Software Development Kit (eSDK) manual. | 6741 | Extensible Software Development Kit (eSDK) manual. |
| 6742 | 6742 | ||
| 6743 | SDK_UPDATE_URL | 6743 | :term:`SDK_UPDATE_URL` |
| 6744 | An optional URL for an update server for the extensible SDK. If set, | 6744 | An optional URL for an update server for the extensible SDK. If set, |
| 6745 | the value is used as the default update server when running | 6745 | the value is used as the default update server when running |
| 6746 | ``devtool sdk-update`` within the extensible SDK. | 6746 | ``devtool sdk-update`` within the extensible SDK. |
| 6747 | 6747 | ||
| 6748 | SDK_VENDOR | 6748 | :term:`SDK_VENDOR` |
| 6749 | Specifies the name of the SDK vendor. | 6749 | Specifies the name of the SDK vendor. |
| 6750 | 6750 | ||
| 6751 | SDK_VERSION | 6751 | :term:`SDK_VERSION` |
| 6752 | Specifies the version of the SDK. The distribution configuration file | 6752 | Specifies the version of the SDK. The distribution configuration file |
| 6753 | (e.g. ``/meta-poky/conf/distro/poky.conf``) defines the | 6753 | (e.g. ``/meta-poky/conf/distro/poky.conf``) defines the |
| 6754 | ``SDK_VERSION`` as follows: | 6754 | ``SDK_VERSION`` as follows: |
| @@ -6760,7 +6760,7 @@ system and gives an overview of their function and contents. | |||
| 6760 | :term:`DISTRO_VERSION` and | 6760 | :term:`DISTRO_VERSION` and |
| 6761 | :term:`DATE` variables. | 6761 | :term:`DATE` variables. |
| 6762 | 6762 | ||
| 6763 | SDKEXTPATH | 6763 | :term:`SDKEXTPATH` |
| 6764 | The default installation directory for the Extensible SDK. By | 6764 | The default installation directory for the Extensible SDK. By |
| 6765 | default, this directory is based on the :term:`DISTRO` | 6765 | default, this directory is based on the :term:`DISTRO` |
| 6766 | variable and is set in the | 6766 | variable and is set in the |
| @@ -6778,14 +6778,14 @@ system and gives an overview of their function and contents. | |||
| 6778 | section in the Yocto Project Application Development and the | 6778 | section in the Yocto Project Application Development and the |
| 6779 | Extensible Software Development Kit (eSDK) manual. | 6779 | Extensible Software Development Kit (eSDK) manual. |
| 6780 | 6780 | ||
| 6781 | SDKIMAGE_FEATURES | 6781 | :term:`SDKIMAGE_FEATURES` |
| 6782 | Equivalent to ``IMAGE_FEATURES``. However, this variable applies to | 6782 | Equivalent to ``IMAGE_FEATURES``. However, this variable applies to |
| 6783 | the SDK generated from an image using the following command: | 6783 | the SDK generated from an image using the following command: |
| 6784 | :: | 6784 | :: |
| 6785 | 6785 | ||
| 6786 | $ bitbake -c populate_sdk imagename | 6786 | $ bitbake -c populate_sdk imagename |
| 6787 | 6787 | ||
| 6788 | SDKMACHINE | 6788 | :term:`SDKMACHINE` |
| 6789 | The machine for which the SDK is built. In other words, the SDK is | 6789 | The machine for which the SDK is built. In other words, the SDK is |
| 6790 | built such that it runs on the target you specify with the | 6790 | built such that it runs on the target you specify with the |
| 6791 | ``SDKMACHINE`` value. The value points to a corresponding ``.conf`` | 6791 | ``SDKMACHINE`` value. The value points to a corresponding ``.conf`` |
| @@ -6805,23 +6805,23 @@ system and gives an overview of their function and contents. | |||
| 6805 | variable in your distribution configuration file. If you do, the | 6805 | variable in your distribution configuration file. If you do, the |
| 6806 | configuration will not take affect. | 6806 | configuration will not take affect. |
| 6807 | 6807 | ||
| 6808 | SDKPATH | 6808 | :term:`SDKPATH` |
| 6809 | Defines the path offered to the user for installation of the SDK that | 6809 | Defines the path offered to the user for installation of the SDK that |
| 6810 | is generated by the OpenEmbedded build system. The path appears as | 6810 | is generated by the OpenEmbedded build system. The path appears as |
| 6811 | the default location for installing the SDK when you run the SDK's | 6811 | the default location for installing the SDK when you run the SDK's |
| 6812 | installation script. You can override the offered path when you run | 6812 | installation script. You can override the offered path when you run |
| 6813 | the script. | 6813 | the script. |
| 6814 | 6814 | ||
| 6815 | SDKTARGETSYSROOT | 6815 | :term:`SDKTARGETSYSROOT` |
| 6816 | The full path to the sysroot used for cross-compilation within an SDK | 6816 | The full path to the sysroot used for cross-compilation within an SDK |
| 6817 | as it will be when installed into the default | 6817 | as it will be when installed into the default |
| 6818 | :term:`SDKPATH`. | 6818 | :term:`SDKPATH`. |
| 6819 | 6819 | ||
| 6820 | SECTION | 6820 | :term:`SECTION` |
| 6821 | The section in which packages should be categorized. Package | 6821 | The section in which packages should be categorized. Package |
| 6822 | management utilities can make use of this variable. | 6822 | management utilities can make use of this variable. |
| 6823 | 6823 | ||
| 6824 | SELECTED_OPTIMIZATION | 6824 | :term:`SELECTED_OPTIMIZATION` |
| 6825 | Specifies the optimization flags passed to the C compiler when | 6825 | Specifies the optimization flags passed to the C compiler when |
| 6826 | building for the target. The flags are passed through the default | 6826 | building for the target. The flags are passed through the default |
| 6827 | value of the :term:`TARGET_CFLAGS` variable. | 6827 | value of the :term:`TARGET_CFLAGS` variable. |
| @@ -6830,7 +6830,7 @@ system and gives an overview of their function and contents. | |||
| 6830 | ``FULL_OPTIMIZATION`` unless ``DEBUG_BUILD`` = "1". If that is the | 6830 | ``FULL_OPTIMIZATION`` unless ``DEBUG_BUILD`` = "1". If that is the |
| 6831 | case, the value of ``DEBUG_OPTIMIZATION`` is used. | 6831 | case, the value of ``DEBUG_OPTIMIZATION`` is used. |
| 6832 | 6832 | ||
| 6833 | SERIAL_CONSOLE | 6833 | :term:`SERIAL_CONSOLE` |
| 6834 | Defines a serial console (TTY) to enable using | 6834 | Defines a serial console (TTY) to enable using |
| 6835 | `getty <https://en.wikipedia.org/wiki/Getty_(Unix)>`__. Provide a | 6835 | `getty <https://en.wikipedia.org/wiki/Getty_(Unix)>`__. Provide a |
| 6836 | value that specifies the baud rate followed by the TTY device name | 6836 | value that specifies the baud rate followed by the TTY device name |
| @@ -6847,7 +6847,7 @@ system and gives an overview of their function and contents. | |||
| 6847 | SERIAL_CONSOLES | 6847 | SERIAL_CONSOLES |
| 6848 | variable. | 6848 | variable. |
| 6849 | 6849 | ||
| 6850 | SERIAL_CONSOLES | 6850 | :term:`SERIAL_CONSOLES` |
| 6851 | Defines a serial console (TTY) to enable using | 6851 | Defines a serial console (TTY) to enable using |
| 6852 | `getty <https://en.wikipedia.org/wiki/Getty_(Unix)>`__. Provide a | 6852 | `getty <https://en.wikipedia.org/wiki/Getty_(Unix)>`__. Provide a |
| 6853 | value that specifies the baud rate followed by the TTY device name | 6853 | value that specifies the baud rate followed by the TTY device name |
| @@ -6856,7 +6856,7 @@ system and gives an overview of their function and contents. | |||
| 6856 | 6856 | ||
| 6857 | SERIAL_CONSOLES = "115200;ttyS0 115200;ttyS1" | 6857 | SERIAL_CONSOLES = "115200;ttyS0 115200;ttyS1" |
| 6858 | 6858 | ||
| 6859 | SERIAL_CONSOLES_CHECK | 6859 | :term:`SERIAL_CONSOLES_CHECK` |
| 6860 | Specifies serial consoles, which must be listed in | 6860 | Specifies serial consoles, which must be listed in |
| 6861 | :term:`SERIAL_CONSOLES`, to check against | 6861 | :term:`SERIAL_CONSOLES`, to check against |
| 6862 | ``/proc/console`` before enabling them using getty. This variable | 6862 | ``/proc/console`` before enabling them using getty. This variable |
| @@ -6869,7 +6869,7 @@ system and gives an overview of their function and contents. | |||
| 6869 | This variable is currently only supported with SysVinit (i.e. not | 6869 | This variable is currently only supported with SysVinit (i.e. not |
| 6870 | with systemd). | 6870 | with systemd). |
| 6871 | 6871 | ||
| 6872 | SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS | 6872 | :term:`SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS` |
| 6873 | A list of recipe dependencies that should not be used to determine | 6873 | A list of recipe dependencies that should not be used to determine |
| 6874 | signatures of tasks from one recipe when they depend on tasks from | 6874 | signatures of tasks from one recipe when they depend on tasks from |
| 6875 | another recipe. For example: :: | 6875 | another recipe. For example: :: |
| @@ -6897,7 +6897,7 @@ system and gives an overview of their function and contents. | |||
| 6897 | the software might break during runtime if the interface of the | 6897 | the software might break during runtime if the interface of the |
| 6898 | second recipe was changed after the first recipe had been built. | 6898 | second recipe was changed after the first recipe had been built. |
| 6899 | 6899 | ||
| 6900 | SIGGEN_EXCLUDERECIPES_ABISAFE | 6900 | :term:`SIGGEN_EXCLUDERECIPES_ABISAFE` |
| 6901 | A list of recipes that are completely stable and will never change. | 6901 | A list of recipes that are completely stable and will never change. |
| 6902 | The ABI for the recipes in the list are presented by output from the | 6902 | The ABI for the recipes in the list are presented by output from the |
| 6903 | tasks run to build the recipe. Use of this variable is one way to | 6903 | tasks run to build the recipe. Use of this variable is one way to |
| @@ -6910,15 +6910,15 @@ system and gives an overview of their function and contents. | |||
| 6910 | might break at runtime if the interface of the recipe was changed | 6910 | might break at runtime if the interface of the recipe was changed |
| 6911 | after the other had been built. | 6911 | after the other had been built. |
| 6912 | 6912 | ||
| 6913 | SITEINFO_BITS | 6913 | :term:`SITEINFO_BITS` |
| 6914 | Specifies the number of bits for the target system CPU. The value | 6914 | Specifies the number of bits for the target system CPU. The value |
| 6915 | should be either "32" or "64". | 6915 | should be either "32" or "64". |
| 6916 | 6916 | ||
| 6917 | SITEINFO_ENDIANNESS | 6917 | :term:`SITEINFO_ENDIANNESS` |
| 6918 | Specifies the endian byte order of the target system. The value | 6918 | Specifies the endian byte order of the target system. The value |
| 6919 | should be either "le" for little-endian or "be" for big-endian. | 6919 | should be either "le" for little-endian or "be" for big-endian. |
| 6920 | 6920 | ||
| 6921 | SKIP_FILEDEPS | 6921 | :term:`SKIP_FILEDEPS` |
| 6922 | Enables removal of all files from the "Provides" section of an RPM | 6922 | Enables removal of all files from the "Provides" section of an RPM |
| 6923 | package. Removal of these files is required for packages containing | 6923 | package. Removal of these files is required for packages containing |
| 6924 | prebuilt binaries and libraries such as ``libstdc++`` and ``glibc``. | 6924 | prebuilt binaries and libraries such as ``libstdc++`` and ``glibc``. |
| @@ -6930,7 +6930,7 @@ system and gives an overview of their function and contents. | |||
| 6930 | 6930 | ||
| 6931 | SKIP_FILEDEPS = "1" | 6931 | SKIP_FILEDEPS = "1" |
| 6932 | 6932 | ||
| 6933 | SOC_FAMILY | 6933 | :term:`SOC_FAMILY` |
| 6934 | Groups together machines based upon the same family of SOC (System On | 6934 | Groups together machines based upon the same family of SOC (System On |
| 6935 | Chip). You typically set this variable in a common ``.inc`` file that | 6935 | Chip). You typically set this variable in a common ``.inc`` file that |
| 6936 | you include in the configuration files of all the machines. | 6936 | you include in the configuration files of all the machines. |
| @@ -6943,7 +6943,7 @@ system and gives an overview of their function and contents. | |||
| 6943 | MACHINEOVERRIDES | 6943 | MACHINEOVERRIDES |
| 6944 | . | 6944 | . |
| 6945 | 6945 | ||
| 6946 | SOLIBS | 6946 | :term:`SOLIBS` |
| 6947 | Defines the suffix for shared libraries used on the target platform. | 6947 | Defines the suffix for shared libraries used on the target platform. |
| 6948 | By default, this suffix is ".so.*" for all Linux-based systems and is | 6948 | By default, this suffix is ".so.*" for all Linux-based systems and is |
| 6949 | defined in the ``meta/conf/bitbake.conf`` configuration file. | 6949 | defined in the ``meta/conf/bitbake.conf`` configuration file. |
| @@ -6951,7 +6951,7 @@ system and gives an overview of their function and contents. | |||
| 6951 | You will see this variable referenced in the default values of | 6951 | You will see this variable referenced in the default values of |
| 6952 | ``FILES_${PN}``. | 6952 | ``FILES_${PN}``. |
| 6953 | 6953 | ||
| 6954 | SOLIBSDEV | 6954 | :term:`SOLIBSDEV` |
| 6955 | Defines the suffix for the development symbolic link (symlink) for | 6955 | Defines the suffix for the development symbolic link (symlink) for |
| 6956 | shared libraries on the target platform. By default, this suffix is | 6956 | shared libraries on the target platform. By default, this suffix is |
| 6957 | ".so" for Linux-based systems and is defined in the | 6957 | ".so" for Linux-based systems and is defined in the |
| @@ -6960,7 +6960,7 @@ system and gives an overview of their function and contents. | |||
| 6960 | You will see this variable referenced in the default values of | 6960 | You will see this variable referenced in the default values of |
| 6961 | ``FILES_${PN}-dev``. | 6961 | ``FILES_${PN}-dev``. |
| 6962 | 6962 | ||
| 6963 | SOURCE_MIRROR_FETCH | 6963 | :term:`SOURCE_MIRROR_FETCH` |
| 6964 | When you are fetching files to create a mirror of sources (i.e. | 6964 | When you are fetching files to create a mirror of sources (i.e. |
| 6965 | creating a source mirror), setting ``SOURCE_MIRROR_FETCH`` to "1" in | 6965 | creating a source mirror), setting ``SOURCE_MIRROR_FETCH`` to "1" in |
| 6966 | your ``local.conf`` configuration file ensures the source for all | 6966 | your ``local.conf`` configuration file ensures the source for all |
| @@ -6979,7 +6979,7 @@ system and gives an overview of their function and contents. | |||
| 6979 | variable unless you are creating a source mirror. In other words, | 6979 | variable unless you are creating a source mirror. In other words, |
| 6980 | do not set the variable during a normal build. | 6980 | do not set the variable during a normal build. |
| 6981 | 6981 | ||
| 6982 | SOURCE_MIRROR_URL | 6982 | :term:`SOURCE_MIRROR_URL` |
| 6983 | Defines your own :term:`PREMIRRORS` from which to | 6983 | Defines your own :term:`PREMIRRORS` from which to |
| 6984 | first fetch source before attempting to fetch from the upstream | 6984 | first fetch source before attempting to fetch from the upstream |
| 6985 | specified in :term:`SRC_URI`. | 6985 | specified in :term:`SRC_URI`. |
| @@ -6998,7 +6998,7 @@ system and gives an overview of their function and contents. | |||
| 6998 | SOURCE_MIRROR_URL | 6998 | SOURCE_MIRROR_URL |
| 6999 | . | 6999 | . |
| 7000 | 7000 | ||
| 7001 | SPDXLICENSEMAP | 7001 | :term:`SPDXLICENSEMAP` |
| 7002 | Maps commonly used license names to their SPDX counterparts found in | 7002 | Maps commonly used license names to their SPDX counterparts found in |
| 7003 | ``meta/files/common-licenses/``. For the default ``SPDXLICENSEMAP`` | 7003 | ``meta/files/common-licenses/``. For the default ``SPDXLICENSEMAP`` |
| 7004 | mappings, see the ``meta/conf/licenses.conf`` file. | 7004 | mappings, see the ``meta/conf/licenses.conf`` file. |
| @@ -7006,13 +7006,13 @@ system and gives an overview of their function and contents. | |||
| 7006 | For additional information, see the :term:`LICENSE` | 7006 | For additional information, see the :term:`LICENSE` |
| 7007 | variable. | 7007 | variable. |
| 7008 | 7008 | ||
| 7009 | SPECIAL_PKGSUFFIX | 7009 | :term:`SPECIAL_PKGSUFFIX` |
| 7010 | A list of prefixes for :term:`PN` used by the OpenEmbedded | 7010 | A list of prefixes for :term:`PN` used by the OpenEmbedded |
| 7011 | build system to create variants of recipes or packages. The list | 7011 | build system to create variants of recipes or packages. The list |
| 7012 | specifies the prefixes to strip off during certain circumstances such | 7012 | specifies the prefixes to strip off during certain circumstances such |
| 7013 | as the generation of the :term:`BPN` variable. | 7013 | as the generation of the :term:`BPN` variable. |
| 7014 | 7014 | ||
| 7015 | SPL_BINARY | 7015 | :term:`SPL_BINARY` |
| 7016 | The file type for the Secondary Program Loader (SPL). Some devices | 7016 | The file type for the Secondary Program Loader (SPL). Some devices |
| 7017 | use an SPL from which to boot (e.g. the BeagleBone development | 7017 | use an SPL from which to boot (e.g. the BeagleBone development |
| 7018 | board). For such cases, you can declare the file type of the SPL | 7018 | board). For such cases, you can declare the file type of the SPL |
| @@ -7040,7 +7040,7 @@ system and gives an overview of their function and contents. | |||
| 7040 | section in the Yocto Project Board Support Package Developer's Guide | 7040 | section in the Yocto Project Board Support Package Developer's Guide |
| 7041 | for additional information. | 7041 | for additional information. |
| 7042 | 7042 | ||
| 7043 | SRC_URI | 7043 | :term:`SRC_URI` |
| 7044 | The list of source files - local or remote. This variable tells the | 7044 | The list of source files - local or remote. This variable tells the |
| 7045 | OpenEmbedded build system which bits to pull in for the build and how | 7045 | OpenEmbedded build system which bits to pull in for the build and how |
| 7046 | to pull them in. For example, if the recipe or append file only needs | 7046 | to pull them in. For example, if the recipe or append file only needs |
| @@ -7183,18 +7183,18 @@ system and gives an overview of their function and contents. | |||
| 7183 | - ``downloadfilename`` - Specifies the filename used when storing | 7183 | - ``downloadfilename`` - Specifies the filename used when storing |
| 7184 | the downloaded file. | 7184 | the downloaded file. |
| 7185 | 7185 | ||
| 7186 | SRC_URI_OVERRIDES_PACKAGE_ARCH | 7186 | :term:`SRC_URI_OVERRIDES_PACKAGE_ARCH` |
| 7187 | By default, the OpenEmbedded build system automatically detects | 7187 | By default, the OpenEmbedded build system automatically detects |
| 7188 | whether ``SRC_URI`` contains files that are machine-specific. If so, | 7188 | whether ``SRC_URI`` contains files that are machine-specific. If so, |
| 7189 | the build system automatically changes ``PACKAGE_ARCH``. Setting this | 7189 | the build system automatically changes ``PACKAGE_ARCH``. Setting this |
| 7190 | variable to "0" disables this behavior. | 7190 | variable to "0" disables this behavior. |
| 7191 | 7191 | ||
| 7192 | SRCDATE | 7192 | :term:`SRCDATE` |
| 7193 | The date of the source code used to build the package. This variable | 7193 | The date of the source code used to build the package. This variable |
| 7194 | applies only if the source was fetched from a Source Code Manager | 7194 | applies only if the source was fetched from a Source Code Manager |
| 7195 | (SCM). | 7195 | (SCM). |
| 7196 | 7196 | ||
| 7197 | SRCPV | 7197 | :term:`SRCPV` |
| 7198 | Returns the version string of the current package. This string is | 7198 | Returns the version string of the current package. This string is |
| 7199 | used to help define the value of :term:`PV`. | 7199 | used to help define the value of :term:`PV`. |
| 7200 | 7200 | ||
| @@ -7213,7 +7213,7 @@ system and gives an overview of their function and contents. | |||
| 7213 | 7213 | ||
| 7214 | PV = "0.12-git${SRCPV}" | 7214 | PV = "0.12-git${SRCPV}" |
| 7215 | 7215 | ||
| 7216 | SRCREV | 7216 | :term:`SRCREV` |
| 7217 | The revision of the source code used to build the package. This | 7217 | The revision of the source code used to build the package. This |
| 7218 | variable applies to Subversion, Git, Mercurial, and Bazaar only. Note | 7218 | variable applies to Subversion, Git, Mercurial, and Bazaar only. Note |
| 7219 | that if you want to build a fixed revision and you want to avoid | 7219 | that if you want to build a fixed revision and you want to avoid |
| @@ -7232,10 +7232,10 @@ system and gives an overview of their function and contents. | |||
| 7232 | Automatically Incrementing a Binary Package Revision Number | 7232 | Automatically Incrementing a Binary Package Revision Number |
| 7233 | " section, which is in the Yocto Project Development Tasks Manual. | 7233 | " section, which is in the Yocto Project Development Tasks Manual. |
| 7234 | 7234 | ||
| 7235 | SSTATE_DIR | 7235 | :term:`SSTATE_DIR` |
| 7236 | The directory for the shared state cache. | 7236 | The directory for the shared state cache. |
| 7237 | 7237 | ||
| 7238 | SSTATE_MIRROR_ALLOW_NETWORK | 7238 | :term:`SSTATE_MIRROR_ALLOW_NETWORK` |
| 7239 | If set to "1", allows fetches from mirrors that are specified in | 7239 | If set to "1", allows fetches from mirrors that are specified in |
| 7240 | :term:`SSTATE_MIRRORS` to work even when | 7240 | :term:`SSTATE_MIRRORS` to work even when |
| 7241 | fetching from the network is disabled by setting ``BB_NO_NETWORK`` to | 7241 | fetching from the network is disabled by setting ``BB_NO_NETWORK`` to |
| @@ -7244,7 +7244,7 @@ system and gives an overview of their function and contents. | |||
| 7244 | your shared state cache, but you want to disable any other fetching | 7244 | your shared state cache, but you want to disable any other fetching |
| 7245 | from the network. | 7245 | from the network. |
| 7246 | 7246 | ||
| 7247 | SSTATE_MIRRORS | 7247 | :term:`SSTATE_MIRRORS` |
| 7248 | Configures the OpenEmbedded build system to search other mirror | 7248 | Configures the OpenEmbedded build system to search other mirror |
| 7249 | locations for prebuilt cache data objects before building out the | 7249 | locations for prebuilt cache data objects before building out the |
| 7250 | data. This variable works like fetcher :term:`MIRRORS` | 7250 | data. This variable works like fetcher :term:`MIRRORS` |
| @@ -7278,7 +7278,7 @@ system and gives an overview of their function and contents. | |||
| 7278 | file://.* http://someserver.tld/share/sstate/PATH;downloadfilename=PATH \n \ | 7278 | file://.* http://someserver.tld/share/sstate/PATH;downloadfilename=PATH \n \ |
| 7279 | file://.* file:///some-local-dir/sstate/PATH" | 7279 | file://.* file:///some-local-dir/sstate/PATH" |
| 7280 | 7280 | ||
| 7281 | SSTATE_SCAN_FILES | 7281 | :term:`SSTATE_SCAN_FILES` |
| 7282 | Controls the list of files the OpenEmbedded build system scans for | 7282 | Controls the list of files the OpenEmbedded build system scans for |
| 7283 | hardcoded installation paths. The variable uses a space-separated | 7283 | hardcoded installation paths. The variable uses a space-separated |
| 7284 | list of filenames (not paths) with standard wildcard characters | 7284 | list of filenames (not paths) with standard wildcard characters |
| @@ -7297,21 +7297,21 @@ system and gives an overview of their function and contents. | |||
| 7297 | For details on the process, see the | 7297 | For details on the process, see the |
| 7298 | :ref:`staging <ref-classes-staging>` class. | 7298 | :ref:`staging <ref-classes-staging>` class. |
| 7299 | 7299 | ||
| 7300 | STAGING_BASE_LIBDIR_NATIVE | 7300 | :term:`STAGING_BASE_LIBDIR_NATIVE` |
| 7301 | Specifies the path to the ``/lib`` subdirectory of the sysroot | 7301 | Specifies the path to the ``/lib`` subdirectory of the sysroot |
| 7302 | directory for the build host. | 7302 | directory for the build host. |
| 7303 | 7303 | ||
| 7304 | STAGING_BASELIBDIR | 7304 | :term:`STAGING_BASELIBDIR` |
| 7305 | Specifies the path to the ``/lib`` subdirectory of the sysroot | 7305 | Specifies the path to the ``/lib`` subdirectory of the sysroot |
| 7306 | directory for the target for which the current recipe is being built | 7306 | directory for the target for which the current recipe is being built |
| 7307 | (:term:`STAGING_DIR_HOST`). | 7307 | (:term:`STAGING_DIR_HOST`). |
| 7308 | 7308 | ||
| 7309 | STAGING_BINDIR | 7309 | :term:`STAGING_BINDIR` |
| 7310 | Specifies the path to the ``/usr/bin`` subdirectory of the sysroot | 7310 | Specifies the path to the ``/usr/bin`` subdirectory of the sysroot |
| 7311 | directory for the target for which the current recipe is being built | 7311 | directory for the target for which the current recipe is being built |
| 7312 | (:term:`STAGING_DIR_HOST`). | 7312 | (:term:`STAGING_DIR_HOST`). |
| 7313 | 7313 | ||
| 7314 | STAGING_BINDIR_CROSS | 7314 | :term:`STAGING_BINDIR_CROSS` |
| 7315 | Specifies the path to the directory containing binary configuration | 7315 | Specifies the path to the directory containing binary configuration |
| 7316 | scripts. These scripts provide configuration information for other | 7316 | scripts. These scripts provide configuration information for other |
| 7317 | software that wants to make use of libraries or include files | 7317 | software that wants to make use of libraries or include files |
| @@ -7328,20 +7328,20 @@ system and gives an overview of their function and contents. | |||
| 7328 | pkg-config | 7328 | pkg-config |
| 7329 | instead of a provided configuration script. | 7329 | instead of a provided configuration script. |
| 7330 | 7330 | ||
| 7331 | STAGING_BINDIR_NATIVE | 7331 | :term:`STAGING_BINDIR_NATIVE` |
| 7332 | Specifies the path to the ``/usr/bin`` subdirectory of the sysroot | 7332 | Specifies the path to the ``/usr/bin`` subdirectory of the sysroot |
| 7333 | directory for the build host. | 7333 | directory for the build host. |
| 7334 | 7334 | ||
| 7335 | STAGING_DATADIR | 7335 | :term:`STAGING_DATADIR` |
| 7336 | Specifies the path to the ``/usr/share`` subdirectory of the sysroot | 7336 | Specifies the path to the ``/usr/share`` subdirectory of the sysroot |
| 7337 | directory for the target for which the current recipe is being built | 7337 | directory for the target for which the current recipe is being built |
| 7338 | (:term:`STAGING_DIR_HOST`). | 7338 | (:term:`STAGING_DIR_HOST`). |
| 7339 | 7339 | ||
| 7340 | STAGING_DATADIR_NATIVE | 7340 | :term:`STAGING_DATADIR_NATIVE` |
| 7341 | Specifies the path to the ``/usr/share`` subdirectory of the sysroot | 7341 | Specifies the path to the ``/usr/share`` subdirectory of the sysroot |
| 7342 | directory for the build host. | 7342 | directory for the build host. |
| 7343 | 7343 | ||
| 7344 | STAGING_DIR | 7344 | :term:`STAGING_DIR` |
| 7345 | Helps construct the ``recipe-sysroots`` directory, which is used | 7345 | Helps construct the ``recipe-sysroots`` directory, which is used |
| 7346 | during packaging. | 7346 | during packaging. |
| 7347 | 7347 | ||
| @@ -7367,7 +7367,7 @@ system and gives an overview of their function and contents. | |||
| 7367 | task and then the OpenEmbedded build system will stage a subset of | 7367 | task and then the OpenEmbedded build system will stage a subset of |
| 7368 | those files into the sysroot. | 7368 | those files into the sysroot. |
| 7369 | 7369 | ||
| 7370 | STAGING_DIR_HOST | 7370 | :term:`STAGING_DIR_HOST` |
| 7371 | Specifies the path to the sysroot directory for the system on which | 7371 | Specifies the path to the sysroot directory for the system on which |
| 7372 | the component is built to run (the system that hosts the component). | 7372 | the component is built to run (the system that hosts the component). |
| 7373 | For most recipes, this sysroot is the one in which that recipe's | 7373 | For most recipes, this sysroot is the one in which that recipe's |
| @@ -7405,11 +7405,11 @@ system and gives an overview of their function and contents. | |||
| 7405 | for ``-native`` recipes, as they make use of host headers and | 7405 | for ``-native`` recipes, as they make use of host headers and |
| 7406 | libraries. | 7406 | libraries. |
| 7407 | 7407 | ||
| 7408 | STAGING_DIR_NATIVE | 7408 | :term:`STAGING_DIR_NATIVE` |
| 7409 | Specifies the path to the sysroot directory used when building | 7409 | Specifies the path to the sysroot directory used when building |
| 7410 | components that run on the build host itself. | 7410 | components that run on the build host itself. |
| 7411 | 7411 | ||
| 7412 | STAGING_DIR_TARGET | 7412 | :term:`STAGING_DIR_TARGET` |
| 7413 | Specifies the path to the sysroot used for the system for which the | 7413 | Specifies the path to the sysroot used for the system for which the |
| 7414 | component generates code. For components that do not generate code, | 7414 | component generates code. For components that do not generate code, |
| 7415 | which is the majority, ``STAGING_DIR_TARGET`` is set to match | 7415 | which is the majority, ``STAGING_DIR_TARGET`` is set to match |
| @@ -7425,45 +7425,45 @@ system and gives an overview of their function and contents. | |||
| 7425 | for the "HOST" system, while ``STAGING_DIR_TARGET`` points to the | 7425 | for the "HOST" system, while ``STAGING_DIR_TARGET`` points to the |
| 7426 | sysroot used for the "TARGET" system. | 7426 | sysroot used for the "TARGET" system. |
| 7427 | 7427 | ||
| 7428 | STAGING_ETCDIR_NATIVE | 7428 | :term:`STAGING_ETCDIR_NATIVE` |
| 7429 | Specifies the path to the ``/etc`` subdirectory of the sysroot | 7429 | Specifies the path to the ``/etc`` subdirectory of the sysroot |
| 7430 | directory for the build host. | 7430 | directory for the build host. |
| 7431 | 7431 | ||
| 7432 | STAGING_EXECPREFIXDIR | 7432 | :term:`STAGING_EXECPREFIXDIR` |
| 7433 | Specifies the path to the ``/usr`` subdirectory of the sysroot | 7433 | Specifies the path to the ``/usr`` subdirectory of the sysroot |
| 7434 | directory for the target for which the current recipe is being built | 7434 | directory for the target for which the current recipe is being built |
| 7435 | (:term:`STAGING_DIR_HOST`). | 7435 | (:term:`STAGING_DIR_HOST`). |
| 7436 | 7436 | ||
| 7437 | STAGING_INCDIR | 7437 | :term:`STAGING_INCDIR` |
| 7438 | Specifies the path to the ``/usr/include`` subdirectory of the | 7438 | Specifies the path to the ``/usr/include`` subdirectory of the |
| 7439 | sysroot directory for the target for which the current recipe being | 7439 | sysroot directory for the target for which the current recipe being |
| 7440 | built (:term:`STAGING_DIR_HOST`). | 7440 | built (:term:`STAGING_DIR_HOST`). |
| 7441 | 7441 | ||
| 7442 | STAGING_INCDIR_NATIVE | 7442 | :term:`STAGING_INCDIR_NATIVE` |
| 7443 | Specifies the path to the ``/usr/include`` subdirectory of the | 7443 | Specifies the path to the ``/usr/include`` subdirectory of the |
| 7444 | sysroot directory for the build host. | 7444 | sysroot directory for the build host. |
| 7445 | 7445 | ||
| 7446 | STAGING_KERNEL_BUILDDIR | 7446 | :term:`STAGING_KERNEL_BUILDDIR` |
| 7447 | Points to the directory containing the kernel build artifacts. | 7447 | Points to the directory containing the kernel build artifacts. |
| 7448 | Recipes building software that needs to access kernel build artifacts | 7448 | Recipes building software that needs to access kernel build artifacts |
| 7449 | (e.g. ``systemtap-uprobes``) can look in the directory specified with | 7449 | (e.g. ``systemtap-uprobes``) can look in the directory specified with |
| 7450 | the ``STAGING_KERNEL_BUILDDIR`` variable to find these artifacts | 7450 | the ``STAGING_KERNEL_BUILDDIR`` variable to find these artifacts |
| 7451 | after the kernel has been built. | 7451 | after the kernel has been built. |
| 7452 | 7452 | ||
| 7453 | STAGING_KERNEL_DIR | 7453 | :term:`STAGING_KERNEL_DIR` |
| 7454 | The directory with kernel headers that are required to build | 7454 | The directory with kernel headers that are required to build |
| 7455 | out-of-tree modules. | 7455 | out-of-tree modules. |
| 7456 | 7456 | ||
| 7457 | STAGING_LIBDIR | 7457 | :term:`STAGING_LIBDIR` |
| 7458 | Specifies the path to the ``/usr/lib`` subdirectory of the sysroot | 7458 | Specifies the path to the ``/usr/lib`` subdirectory of the sysroot |
| 7459 | directory for the target for which the current recipe is being built | 7459 | directory for the target for which the current recipe is being built |
| 7460 | (:term:`STAGING_DIR_HOST`). | 7460 | (:term:`STAGING_DIR_HOST`). |
| 7461 | 7461 | ||
| 7462 | STAGING_LIBDIR_NATIVE | 7462 | :term:`STAGING_LIBDIR_NATIVE` |
| 7463 | Specifies the path to the ``/usr/lib`` subdirectory of the sysroot | 7463 | Specifies the path to the ``/usr/lib`` subdirectory of the sysroot |
| 7464 | directory for the build host. | 7464 | directory for the build host. |
| 7465 | 7465 | ||
| 7466 | STAMP | 7466 | :term:`STAMP` |
| 7467 | Specifies the base path used to create recipe stamp files. The path | 7467 | Specifies the base path used to create recipe stamp files. The path |
| 7468 | to an actual stamp file is constructed by evaluating this string and | 7468 | to an actual stamp file is constructed by evaluating this string and |
| 7469 | then appending additional information. Currently, the default | 7469 | then appending additional information. Currently, the default |
| @@ -7484,26 +7484,26 @@ system and gives an overview of their function and contents. | |||
| 7484 | :term:`PV`, and :term:`PR` for related variable | 7484 | :term:`PV`, and :term:`PR` for related variable |
| 7485 | information. | 7485 | information. |
| 7486 | 7486 | ||
| 7487 | STAMPS_DIR | 7487 | :term:`STAMPS_DIR` |
| 7488 | Specifies the base directory in which the OpenEmbedded build system | 7488 | Specifies the base directory in which the OpenEmbedded build system |
| 7489 | places stamps. The default directory is ``${TMPDIR}/stamps``. | 7489 | places stamps. The default directory is ``${TMPDIR}/stamps``. |
| 7490 | 7490 | ||
| 7491 | STRIP | 7491 | :term:`STRIP` |
| 7492 | The minimal command and arguments to run ``strip``, which is used to | 7492 | The minimal command and arguments to run ``strip``, which is used to |
| 7493 | strip symbols. | 7493 | strip symbols. |
| 7494 | 7494 | ||
| 7495 | SUMMARY | 7495 | :term:`SUMMARY` |
| 7496 | The short (72 characters or less) summary of the binary package for | 7496 | The short (72 characters or less) summary of the binary package for |
| 7497 | packaging systems such as ``opkg``, ``rpm``, or ``dpkg``. By default, | 7497 | packaging systems such as ``opkg``, ``rpm``, or ``dpkg``. By default, |
| 7498 | ``SUMMARY`` is used to define the | 7498 | ``SUMMARY`` is used to define the |
| 7499 | :term:`DESCRIPTION` variable if ``DESCRIPTION`` is | 7499 | :term:`DESCRIPTION` variable if ``DESCRIPTION`` is |
| 7500 | not set in the recipe. | 7500 | not set in the recipe. |
| 7501 | 7501 | ||
| 7502 | SVNDIR | 7502 | :term:`SVNDIR` |
| 7503 | The directory in which files checked out of a Subversion system are | 7503 | The directory in which files checked out of a Subversion system are |
| 7504 | stored. | 7504 | stored. |
| 7505 | 7505 | ||
| 7506 | SYSLINUX_DEFAULT_CONSOLE | 7506 | :term:`SYSLINUX_DEFAULT_CONSOLE` |
| 7507 | Specifies the kernel boot default console. If you want to use a | 7507 | Specifies the kernel boot default console. If you want to use a |
| 7508 | console other than the default, set this variable in your recipe as | 7508 | console other than the default, set this variable in your recipe as |
| 7509 | follows where "X" is the console number you want to use: | 7509 | follows where "X" is the console number you want to use: |
| @@ -7514,7 +7514,7 @@ system and gives an overview of their function and contents. | |||
| 7514 | The :ref:`syslinux <ref-classes-syslinux>` class initially sets | 7514 | The :ref:`syslinux <ref-classes-syslinux>` class initially sets |
| 7515 | this variable to null but then checks for a value later. | 7515 | this variable to null but then checks for a value later. |
| 7516 | 7516 | ||
| 7517 | SYSLINUX_OPTS | 7517 | :term:`SYSLINUX_OPTS` |
| 7518 | Lists additional options to add to the syslinux file. You need to set | 7518 | Lists additional options to add to the syslinux file. You need to set |
| 7519 | this variable in your recipe. If you want to list multiple options, | 7519 | this variable in your recipe. If you want to list multiple options, |
| 7520 | separate the options with a semicolon character (``;``). | 7520 | separate the options with a semicolon character (``;``). |
| @@ -7522,7 +7522,7 @@ system and gives an overview of their function and contents. | |||
| 7522 | The :ref:`syslinux <ref-classes-syslinux>` class uses this variable | 7522 | The :ref:`syslinux <ref-classes-syslinux>` class uses this variable |
| 7523 | to create a set of options. | 7523 | to create a set of options. |
| 7524 | 7524 | ||
| 7525 | SYSLINUX_SERIAL | 7525 | :term:`SYSLINUX_SERIAL` |
| 7526 | Specifies the alternate serial port or turns it off. To turn off | 7526 | Specifies the alternate serial port or turns it off. To turn off |
| 7527 | serial, set this variable to an empty string in your recipe. The | 7527 | serial, set this variable to an empty string in your recipe. The |
| 7528 | variable's default value is set in the | 7528 | variable's default value is set in the |
| @@ -7533,7 +7533,7 @@ system and gives an overview of their function and contents. | |||
| 7533 | 7533 | ||
| 7534 | The class checks for and uses the variable as needed. | 7534 | The class checks for and uses the variable as needed. |
| 7535 | 7535 | ||
| 7536 | SYSLINUX_SERIAL_TTY | 7536 | :term:`SYSLINUX_SERIAL_TTY` |
| 7537 | Specifies the alternate console=tty... kernel boot argument. The | 7537 | Specifies the alternate console=tty... kernel boot argument. The |
| 7538 | variable's default value is set in the | 7538 | variable's default value is set in the |
| 7539 | :ref:`syslinux <ref-classes-syslinux>` class as follows: | 7539 | :ref:`syslinux <ref-classes-syslinux>` class as follows: |
| @@ -7543,7 +7543,7 @@ system and gives an overview of their function and contents. | |||
| 7543 | 7543 | ||
| 7544 | The class checks for and uses the variable as needed. | 7544 | The class checks for and uses the variable as needed. |
| 7545 | 7545 | ||
| 7546 | SYSLINUX_SPLASH | 7546 | :term:`SYSLINUX_SPLASH` |
| 7547 | An ``.LSS`` file used as the background for the VGA boot menu when | 7547 | An ``.LSS`` file used as the background for the VGA boot menu when |
| 7548 | you use the boot menu. You need to set this variable in your recipe. | 7548 | you use the boot menu. You need to set this variable in your recipe. |
| 7549 | 7549 | ||
| @@ -7551,13 +7551,13 @@ system and gives an overview of their function and contents. | |||
| 7551 | variable and if found, the OpenEmbedded build system installs the | 7551 | variable and if found, the OpenEmbedded build system installs the |
| 7552 | splash screen. | 7552 | splash screen. |
| 7553 | 7553 | ||
| 7554 | SYSROOT_DESTDIR | 7554 | :term:`SYSROOT_DESTDIR` |
| 7555 | Points to the temporary directory under the work directory (default | 7555 | Points to the temporary directory under the work directory (default |
| 7556 | "``${``\ :term:`WORKDIR`\ ``}/sysroot-destdir``") | 7556 | "``${``\ :term:`WORKDIR`\ ``}/sysroot-destdir``") |
| 7557 | where the files populated into the sysroot are assembled during the | 7557 | where the files populated into the sysroot are assembled during the |
| 7558 | :ref:`ref-tasks-populate_sysroot` task. | 7558 | :ref:`ref-tasks-populate_sysroot` task. |
| 7559 | 7559 | ||
| 7560 | SYSROOT_DIRS | 7560 | :term:`SYSROOT_DIRS` |
| 7561 | Directories that are staged into the sysroot by the | 7561 | Directories that are staged into the sysroot by the |
| 7562 | :ref:`ref-tasks-populate_sysroot` task. By | 7562 | :ref:`ref-tasks-populate_sysroot` task. By |
| 7563 | default, the following directories are staged: | 7563 | default, the following directories are staged: |
| @@ -7571,7 +7571,7 @@ system and gives an overview of their function and contents. | |||
| 7571 | ${datadir} \ | 7571 | ${datadir} \ |
| 7572 | " | 7572 | " |
| 7573 | 7573 | ||
| 7574 | SYSROOT_DIRS_BLACKLIST | 7574 | :term:`SYSROOT_DIRS_BLACKLIST` |
| 7575 | Directories that are not staged into the sysroot by the | 7575 | Directories that are not staged into the sysroot by the |
| 7576 | :ref:`ref-tasks-populate_sysroot` task. You | 7576 | :ref:`ref-tasks-populate_sysroot` task. You |
| 7577 | can use this variable to exclude certain subdirectories of | 7577 | can use this variable to exclude certain subdirectories of |
| @@ -7589,7 +7589,7 @@ system and gives an overview of their function and contents. | |||
| 7589 | ${datadir}/pixmaps \ | 7589 | ${datadir}/pixmaps \ |
| 7590 | " | 7590 | " |
| 7591 | 7591 | ||
| 7592 | SYSROOT_DIRS_NATIVE | 7592 | :term:`SYSROOT_DIRS_NATIVE` |
| 7593 | Extra directories staged into the sysroot by the | 7593 | Extra directories staged into the sysroot by the |
| 7594 | :ref:`ref-tasks-populate_sysroot` task for | 7594 | :ref:`ref-tasks-populate_sysroot` task for |
| 7595 | ``-native`` recipes, in addition to those specified in | 7595 | ``-native`` recipes, in addition to those specified in |
| @@ -7616,12 +7616,12 @@ system and gives an overview of their function and contents. | |||
| 7616 | ), which is why additional directories containing program | 7616 | ), which is why additional directories containing program |
| 7617 | executables and supporting files need to be staged. | 7617 | executables and supporting files need to be staged. |
| 7618 | 7618 | ||
| 7619 | SYSROOT_PREPROCESS_FUNCS | 7619 | :term:`SYSROOT_PREPROCESS_FUNCS` |
| 7620 | A list of functions to execute after files are staged into the | 7620 | A list of functions to execute after files are staged into the |
| 7621 | sysroot. These functions are usually used to apply additional | 7621 | sysroot. These functions are usually used to apply additional |
| 7622 | processing on the staged files, or to stage additional files. | 7622 | processing on the staged files, or to stage additional files. |
| 7623 | 7623 | ||
| 7624 | SYSTEMD_AUTO_ENABLE | 7624 | :term:`SYSTEMD_AUTO_ENABLE` |
| 7625 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, | 7625 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, |
| 7626 | this variable specifies whether the specified service in | 7626 | this variable specifies whether the specified service in |
| 7627 | :term:`SYSTEMD_SERVICE` should start | 7627 | :term:`SYSTEMD_SERVICE` should start |
| @@ -7634,7 +7634,7 @@ system and gives an overview of their function and contents. | |||
| 7634 | 7634 | ||
| 7635 | You can disable the service by setting the variable to "disable". | 7635 | You can disable the service by setting the variable to "disable". |
| 7636 | 7636 | ||
| 7637 | SYSTEMD_BOOT_CFG | 7637 | :term:`SYSTEMD_BOOT_CFG` |
| 7638 | When :term:`EFI_PROVIDER` is set to | 7638 | When :term:`EFI_PROVIDER` is set to |
| 7639 | "systemd-boot", the ``SYSTEMD_BOOT_CFG`` variable specifies the | 7639 | "systemd-boot", the ``SYSTEMD_BOOT_CFG`` variable specifies the |
| 7640 | configuration file that should be used. By default, the | 7640 | configuration file that should be used. By default, the |
| @@ -7647,7 +7647,7 @@ system and gives an overview of their function and contents. | |||
| 7647 | For information on Systemd-boot, see the `Systemd-boot | 7647 | For information on Systemd-boot, see the `Systemd-boot |
| 7648 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. | 7648 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. |
| 7649 | 7649 | ||
| 7650 | SYSTEMD_BOOT_ENTRIES | 7650 | :term:`SYSTEMD_BOOT_ENTRIES` |
| 7651 | When :term:`EFI_PROVIDER` is set to | 7651 | When :term:`EFI_PROVIDER` is set to |
| 7652 | "systemd-boot", the ``SYSTEMD_BOOT_ENTRIES`` variable specifies a | 7652 | "systemd-boot", the ``SYSTEMD_BOOT_ENTRIES`` variable specifies a |
| 7653 | list of entry files (``*.conf``) to install that contain one boot | 7653 | list of entry files (``*.conf``) to install that contain one boot |
| @@ -7661,7 +7661,7 @@ system and gives an overview of their function and contents. | |||
| 7661 | For information on Systemd-boot, see the `Systemd-boot | 7661 | For information on Systemd-boot, see the `Systemd-boot |
| 7662 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. | 7662 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. |
| 7663 | 7663 | ||
| 7664 | SYSTEMD_BOOT_TIMEOUT | 7664 | :term:`SYSTEMD_BOOT_TIMEOUT` |
| 7665 | When :term:`EFI_PROVIDER` is set to | 7665 | When :term:`EFI_PROVIDER` is set to |
| 7666 | "systemd-boot", the ``SYSTEMD_BOOT_TIMEOUT`` variable specifies the | 7666 | "systemd-boot", the ``SYSTEMD_BOOT_TIMEOUT`` variable specifies the |
| 7667 | boot menu timeout in seconds. By default, the | 7667 | boot menu timeout in seconds. By default, the |
| @@ -7674,7 +7674,7 @@ system and gives an overview of their function and contents. | |||
| 7674 | For information on Systemd-boot, see the `Systemd-boot | 7674 | For information on Systemd-boot, see the `Systemd-boot |
| 7675 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. | 7675 | documentation <http://www.freedesktop.org/wiki/Software/systemd/systemd-boot/>`__. |
| 7676 | 7676 | ||
| 7677 | SYSTEMD_PACKAGES | 7677 | :term:`SYSTEMD_PACKAGES` |
| 7678 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, | 7678 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, |
| 7679 | this variable locates the systemd unit files when they are not found | 7679 | this variable locates the systemd unit files when they are not found |
| 7680 | in the main recipe's package. By default, the ``SYSTEMD_PACKAGES`` | 7680 | in the main recipe's package. By default, the ``SYSTEMD_PACKAGES`` |
| @@ -7688,7 +7688,7 @@ system and gives an overview of their function and contents. | |||
| 7688 | to use ``SYSTEMD_PACKAGES`` to list the package or packages in which | 7688 | to use ``SYSTEMD_PACKAGES`` to list the package or packages in which |
| 7689 | the build system can find the systemd unit files. | 7689 | the build system can find the systemd unit files. |
| 7690 | 7690 | ||
| 7691 | SYSTEMD_SERVICE | 7691 | :term:`SYSTEMD_SERVICE` |
| 7692 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, | 7692 | When inheriting the :ref:`systemd <ref-classes-systemd>` class, |
| 7693 | this variable specifies the systemd service name for a package. | 7693 | this variable specifies the systemd service name for a package. |
| 7694 | 7694 | ||
| @@ -7699,7 +7699,7 @@ system and gives an overview of their function and contents. | |||
| 7699 | 7699 | ||
| 7700 | SYSTEMD_SERVICE_${PN} = "connman.service" | 7700 | SYSTEMD_SERVICE_${PN} = "connman.service" |
| 7701 | 7701 | ||
| 7702 | SYSVINIT_ENABLED_GETTYS | 7702 | :term:`SYSVINIT_ENABLED_GETTYS` |
| 7703 | When using | 7703 | When using |
| 7704 | :ref:`SysVinit <dev-manual/dev-manual-common-tasks:enabling system services>`, | 7704 | :ref:`SysVinit <dev-manual/dev-manual-common-tasks:enabling system services>`, |
| 7705 | specifies a space-separated list of the virtual terminals that should | 7705 | specifies a space-separated list of the virtual terminals that should |
| @@ -7710,7 +7710,7 @@ system and gives an overview of their function and contents. | |||
| 7710 | The default value for ``SYSVINIT_ENABLED_GETTYS`` is "1" (i.e. only | 7710 | The default value for ``SYSVINIT_ENABLED_GETTYS`` is "1" (i.e. only |
| 7711 | run a getty on the first virtual terminal). | 7711 | run a getty on the first virtual terminal). |
| 7712 | 7712 | ||
| 7713 | T | 7713 | :term:`T` |
| 7714 | This variable points to a directory were BitBake places temporary | 7714 | This variable points to a directory were BitBake places temporary |
| 7715 | files, which consist mostly of task logs and scripts, when building a | 7715 | files, which consist mostly of task logs and scripts, when building a |
| 7716 | particular recipe. The variable is typically set as follows: | 7716 | particular recipe. The variable is typically set as follows: |
| @@ -7727,7 +7727,7 @@ system and gives an overview of their function and contents. | |||
| 7727 | the directory tree where BitBake places the output of an entire | 7727 | the directory tree where BitBake places the output of an entire |
| 7728 | build. | 7728 | build. |
| 7729 | 7729 | ||
| 7730 | TARGET_ARCH | 7730 | :term:`TARGET_ARCH` |
| 7731 | The target machine's architecture. The OpenEmbedded build system | 7731 | The target machine's architecture. The OpenEmbedded build system |
| 7732 | supports many architectures. Here is an example list of architectures | 7732 | supports many architectures. Here is an example list of architectures |
| 7733 | supported. This list is by no means complete as the architecture is | 7733 | supported. This list is by no means complete as the architecture is |
| @@ -7744,7 +7744,7 @@ system and gives an overview of their function and contents. | |||
| 7744 | For additional information on machine architectures, see the | 7744 | For additional information on machine architectures, see the |
| 7745 | :term:`TUNE_ARCH` variable. | 7745 | :term:`TUNE_ARCH` variable. |
| 7746 | 7746 | ||
| 7747 | TARGET_AS_ARCH | 7747 | :term:`TARGET_AS_ARCH` |
| 7748 | Specifies architecture-specific assembler flags for the target | 7748 | Specifies architecture-specific assembler flags for the target |
| 7749 | system. ``TARGET_AS_ARCH`` is initialized from | 7749 | system. ``TARGET_AS_ARCH`` is initialized from |
| 7750 | :term:`TUNE_ASARGS` by default in the BitBake | 7750 | :term:`TUNE_ASARGS` by default in the BitBake |
| @@ -7753,7 +7753,7 @@ system and gives an overview of their function and contents. | |||
| 7753 | 7753 | ||
| 7754 | TARGET_AS_ARCH = "${TUNE_ASARGS}" | 7754 | TARGET_AS_ARCH = "${TUNE_ASARGS}" |
| 7755 | 7755 | ||
| 7756 | TARGET_CC_ARCH | 7756 | :term:`TARGET_CC_ARCH` |
| 7757 | Specifies architecture-specific C compiler flags for the target | 7757 | Specifies architecture-specific C compiler flags for the target |
| 7758 | system. ``TARGET_CC_ARCH`` is initialized from | 7758 | system. ``TARGET_CC_ARCH`` is initialized from |
| 7759 | :term:`TUNE_CCARGS` by default. | 7759 | :term:`TUNE_CCARGS` by default. |
| @@ -7769,7 +7769,7 @@ system and gives an overview of their function and contents. | |||
| 7769 | LDFLAGS | 7769 | LDFLAGS |
| 7770 | variable. | 7770 | variable. |
| 7771 | 7771 | ||
| 7772 | TARGET_CC_KERNEL_ARCH | 7772 | :term:`TARGET_CC_KERNEL_ARCH` |
| 7773 | This is a specific kernel compiler flag for a CPU or Application | 7773 | This is a specific kernel compiler flag for a CPU or Application |
| 7774 | Binary Interface (ABI) tune. The flag is used rarely and only for | 7774 | Binary Interface (ABI) tune. The flag is used rarely and only for |
| 7775 | cases where a userspace :term:`TUNE_CCARGS` is not | 7775 | cases where a userspace :term:`TUNE_CCARGS` is not |
| @@ -7779,7 +7779,7 @@ system and gives an overview of their function and contents. | |||
| 7779 | ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in the | 7779 | ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in the |
| 7780 | :term:`Source Directory` for an example. | 7780 | :term:`Source Directory` for an example. |
| 7781 | 7781 | ||
| 7782 | TARGET_CFLAGS | 7782 | :term:`TARGET_CFLAGS` |
| 7783 | Specifies the flags to pass to the C compiler when building for the | 7783 | Specifies the flags to pass to the C compiler when building for the |
| 7784 | target. When building in the target context, | 7784 | target. When building in the target context, |
| 7785 | :term:`CFLAGS` is set to the value of this variable by | 7785 | :term:`CFLAGS` is set to the value of this variable by |
| @@ -7789,7 +7789,7 @@ system and gives an overview of their function and contents. | |||
| 7789 | variable in the environment to the ``TARGET_CFLAGS`` value so that | 7789 | variable in the environment to the ``TARGET_CFLAGS`` value so that |
| 7790 | executables built using the SDK also have the flags applied. | 7790 | executables built using the SDK also have the flags applied. |
| 7791 | 7791 | ||
| 7792 | TARGET_CPPFLAGS | 7792 | :term:`TARGET_CPPFLAGS` |
| 7793 | Specifies the flags to pass to the C pre-processor (i.e. to both the | 7793 | Specifies the flags to pass to the C pre-processor (i.e. to both the |
| 7794 | C and the C++ compilers) when building for the target. When building | 7794 | C and the C++ compilers) when building for the target. When building |
| 7795 | in the target context, :term:`CPPFLAGS` is set to the | 7795 | in the target context, :term:`CPPFLAGS` is set to the |
| @@ -7800,7 +7800,7 @@ system and gives an overview of their function and contents. | |||
| 7800 | value so that executables built using the SDK also have the flags | 7800 | value so that executables built using the SDK also have the flags |
| 7801 | applied. | 7801 | applied. |
| 7802 | 7802 | ||
| 7803 | TARGET_CXXFLAGS | 7803 | :term:`TARGET_CXXFLAGS` |
| 7804 | Specifies the flags to pass to the C++ compiler when building for the | 7804 | Specifies the flags to pass to the C++ compiler when building for the |
| 7805 | target. When building in the target context, | 7805 | target. When building in the target context, |
| 7806 | :term:`CXXFLAGS` is set to the value of this variable | 7806 | :term:`CXXFLAGS` is set to the value of this variable |
| @@ -7811,13 +7811,13 @@ system and gives an overview of their function and contents. | |||
| 7811 | value so that executables built using the SDK also have the flags | 7811 | value so that executables built using the SDK also have the flags |
| 7812 | applied. | 7812 | applied. |
| 7813 | 7813 | ||
| 7814 | TARGET_FPU | 7814 | :term:`TARGET_FPU` |
| 7815 | Specifies the method for handling FPU code. For FPU-less targets, | 7815 | Specifies the method for handling FPU code. For FPU-less targets, |
| 7816 | which include most ARM CPUs, the variable must be set to "soft". If | 7816 | which include most ARM CPUs, the variable must be set to "soft". If |
| 7817 | not, the kernel emulation gets used, which results in a performance | 7817 | not, the kernel emulation gets used, which results in a performance |
| 7818 | penalty. | 7818 | penalty. |
| 7819 | 7819 | ||
| 7820 | TARGET_LD_ARCH | 7820 | :term:`TARGET_LD_ARCH` |
| 7821 | Specifies architecture-specific linker flags for the target system. | 7821 | Specifies architecture-specific linker flags for the target system. |
| 7822 | ``TARGET_LD_ARCH`` is initialized from | 7822 | ``TARGET_LD_ARCH`` is initialized from |
| 7823 | :term:`TUNE_LDARGS` by default in the BitBake | 7823 | :term:`TUNE_LDARGS` by default in the BitBake |
| @@ -7826,7 +7826,7 @@ system and gives an overview of their function and contents. | |||
| 7826 | 7826 | ||
| 7827 | TARGET_LD_ARCH = "${TUNE_LDARGS}" | 7827 | TARGET_LD_ARCH = "${TUNE_LDARGS}" |
| 7828 | 7828 | ||
| 7829 | TARGET_LDFLAGS | 7829 | :term:`TARGET_LDFLAGS` |
| 7830 | Specifies the flags to pass to the linker when building for the | 7830 | Specifies the flags to pass to the linker when building for the |
| 7831 | target. When building in the target context, | 7831 | target. When building in the target context, |
| 7832 | :term:`LDFLAGS` is set to the value of this variable | 7832 | :term:`LDFLAGS` is set to the value of this variable |
| @@ -7837,13 +7837,13 @@ system and gives an overview of their function and contents. | |||
| 7837 | ``TARGET_LDFLAGS`` value so that executables built using the SDK also | 7837 | ``TARGET_LDFLAGS`` value so that executables built using the SDK also |
| 7838 | have the flags applied. | 7838 | have the flags applied. |
| 7839 | 7839 | ||
| 7840 | TARGET_OS | 7840 | :term:`TARGET_OS` |
| 7841 | Specifies the target's operating system. The variable can be set to | 7841 | Specifies the target's operating system. The variable can be set to |
| 7842 | "linux" for glibc-based systems (GNU C Library) and to "linux-musl" | 7842 | "linux" for glibc-based systems (GNU C Library) and to "linux-musl" |
| 7843 | for musl libc. For ARM/EABI targets, "linux-gnueabi" and | 7843 | for musl libc. For ARM/EABI targets, "linux-gnueabi" and |
| 7844 | "linux-musleabi" possible values exist. | 7844 | "linux-musleabi" possible values exist. |
| 7845 | 7845 | ||
| 7846 | TARGET_PREFIX | 7846 | :term:`TARGET_PREFIX` |
| 7847 | Specifies the prefix used for the toolchain binary target tools. | 7847 | Specifies the prefix used for the toolchain binary target tools. |
| 7848 | 7848 | ||
| 7849 | Depending on the type of recipe and the build target, | 7849 | Depending on the type of recipe and the build target, |
| @@ -7858,7 +7858,7 @@ system and gives an overview of their function and contents. | |||
| 7858 | - For native SDK recipes (``nativesdk``), the build system sets the | 7858 | - For native SDK recipes (``nativesdk``), the build system sets the |
| 7859 | variable to the value of ``SDK_PREFIX``. | 7859 | variable to the value of ``SDK_PREFIX``. |
| 7860 | 7860 | ||
| 7861 | TARGET_SYS | 7861 | :term:`TARGET_SYS` |
| 7862 | Specifies the system, including the architecture and the operating | 7862 | Specifies the system, including the architecture and the operating |
| 7863 | system, for which the build is occurring in the context of the | 7863 | system, for which the build is occurring in the context of the |
| 7864 | current recipe. | 7864 | current recipe. |
| @@ -7880,17 +7880,17 @@ system and gives an overview of their function and contents. | |||
| 7880 | - Given a recipe being built for a little-endian, MIPS target | 7880 | - Given a recipe being built for a little-endian, MIPS target |
| 7881 | running Linux, the value might be "mipsel-linux". | 7881 | running Linux, the value might be "mipsel-linux". |
| 7882 | 7882 | ||
| 7883 | TARGET_VENDOR | 7883 | :term:`TARGET_VENDOR` |
| 7884 | Specifies the name of the target vendor. | 7884 | Specifies the name of the target vendor. |
| 7885 | 7885 | ||
| 7886 | TCLIBC | 7886 | :term:`TCLIBC` |
| 7887 | Specifies the GNU standard C library (``libc``) variant to use during | 7887 | Specifies the GNU standard C library (``libc``) variant to use during |
| 7888 | the build process. This variable replaces ``POKYLIBC``, which is no | 7888 | the build process. This variable replaces ``POKYLIBC``, which is no |
| 7889 | longer supported. | 7889 | longer supported. |
| 7890 | 7890 | ||
| 7891 | You can select "glibc", "musl", "newlib", or "baremetal" | 7891 | You can select "glibc", "musl", "newlib", or "baremetal" |
| 7892 | 7892 | ||
| 7893 | TCLIBCAPPEND | 7893 | :term:`TCLIBCAPPEND` |
| 7894 | Specifies a suffix to be appended onto the | 7894 | Specifies a suffix to be appended onto the |
| 7895 | :term:`TMPDIR` value. The suffix identifies the | 7895 | :term:`TMPDIR` value. The suffix identifies the |
| 7896 | ``libc`` variant for building. When you are building for multiple | 7896 | ``libc`` variant for building. When you are building for multiple |
| @@ -7904,7 +7904,7 @@ system and gives an overview of their function and contents. | |||
| 7904 | ``TCLIBCAPPEND`` to "" in their distro configuration file resulting | 7904 | ``TCLIBCAPPEND`` to "" in their distro configuration file resulting |
| 7905 | in no suffix being applied. | 7905 | in no suffix being applied. |
| 7906 | 7906 | ||
| 7907 | TCMODE | 7907 | :term:`TCMODE` |
| 7908 | Specifies the toolchain selector. ``TCMODE`` controls the | 7908 | Specifies the toolchain selector. ``TCMODE`` controls the |
| 7909 | characteristics of the generated packages and images by telling the | 7909 | characteristics of the generated packages and images by telling the |
| 7910 | OpenEmbedded build system which toolchain profile to use. By default, | 7910 | OpenEmbedded build system which toolchain profile to use. By default, |
| @@ -7948,7 +7948,7 @@ system and gives an overview of their function and contents. | |||
| 7948 | toolchain. You can use ``meta-sourcery`` as a template for adding | 7948 | toolchain. You can use ``meta-sourcery`` as a template for adding |
| 7949 | support for other external toolchains. | 7949 | support for other external toolchains. |
| 7950 | 7950 | ||
| 7951 | TEST_EXPORT_DIR | 7951 | :term:`TEST_EXPORT_DIR` |
| 7952 | The location the OpenEmbedded build system uses to export tests when | 7952 | The location the OpenEmbedded build system uses to export tests when |
| 7953 | the :term:`TEST_EXPORT_ONLY` variable is set | 7953 | the :term:`TEST_EXPORT_ONLY` variable is set |
| 7954 | to "1". | 7954 | to "1". |
| @@ -7956,12 +7956,12 @@ system and gives an overview of their function and contents. | |||
| 7956 | The ``TEST_EXPORT_DIR`` variable defaults to | 7956 | The ``TEST_EXPORT_DIR`` variable defaults to |
| 7957 | ``"${TMPDIR}/testimage/${PN}"``. | 7957 | ``"${TMPDIR}/testimage/${PN}"``. |
| 7958 | 7958 | ||
| 7959 | TEST_EXPORT_ONLY | 7959 | :term:`TEST_EXPORT_ONLY` |
| 7960 | Specifies to export the tests only. Set this variable to "1" if you | 7960 | Specifies to export the tests only. Set this variable to "1" if you |
| 7961 | do not want to run the tests but you want them to be exported in a | 7961 | do not want to run the tests but you want them to be exported in a |
| 7962 | manner that you to run them outside of the build system. | 7962 | manner that you to run them outside of the build system. |
| 7963 | 7963 | ||
| 7964 | TEST_LOG_DIR | 7964 | :term:`TEST_LOG_DIR` |
| 7965 | Holds the SSH log and the boot log for QEMU machines. The | 7965 | Holds the SSH log and the boot log for QEMU machines. The |
| 7966 | ``TEST_LOG_DIR`` variable defaults to ``"${WORKDIR}/testimage"``. | 7966 | ``TEST_LOG_DIR`` variable defaults to ``"${WORKDIR}/testimage"``. |
| 7967 | 7967 | ||
| @@ -7973,7 +7973,7 @@ system and gives an overview of their function and contents. | |||
| 7973 | ${WORKDIR}/temp/ | 7973 | ${WORKDIR}/temp/ |
| 7974 | directory. | 7974 | directory. |
| 7975 | 7975 | ||
| 7976 | TEST_POWERCONTROL_CMD | 7976 | :term:`TEST_POWERCONTROL_CMD` |
| 7977 | For automated hardware testing, specifies the command to use to | 7977 | For automated hardware testing, specifies the command to use to |
| 7978 | control the power of the target machine under test. Typically, this | 7978 | control the power of the target machine under test. Typically, this |
| 7979 | command would point to a script that performs the appropriate action | 7979 | command would point to a script that performs the appropriate action |
| @@ -7982,7 +7982,7 @@ system and gives an overview of their function and contents. | |||
| 7982 | "cycle" specifying to power off, on, or cycle (power off and then | 7982 | "cycle" specifying to power off, on, or cycle (power off and then |
| 7983 | power on) the device, respectively. | 7983 | power on) the device, respectively. |
| 7984 | 7984 | ||
| 7985 | TEST_POWERCONTROL_EXTRA_ARGS | 7985 | :term:`TEST_POWERCONTROL_EXTRA_ARGS` |
| 7986 | For automated hardware testing, specifies additional arguments to | 7986 | For automated hardware testing, specifies additional arguments to |
| 7987 | pass through to the command specified in | 7987 | pass through to the command specified in |
| 7988 | :term:`TEST_POWERCONTROL_CMD`. Setting | 7988 | :term:`TEST_POWERCONTROL_CMD`. Setting |
| @@ -7990,7 +7990,7 @@ system and gives an overview of their function and contents. | |||
| 7990 | wish, for example, to separate the machine-specific and | 7990 | wish, for example, to separate the machine-specific and |
| 7991 | non-machine-specific parts of the arguments. | 7991 | non-machine-specific parts of the arguments. |
| 7992 | 7992 | ||
| 7993 | TEST_QEMUBOOT_TIMEOUT | 7993 | :term:`TEST_QEMUBOOT_TIMEOUT` |
| 7994 | The time in seconds allowed for an image to boot before automated | 7994 | The time in seconds allowed for an image to boot before automated |
| 7995 | runtime tests begin to run against an image. The default timeout | 7995 | runtime tests begin to run against an image. The default timeout |
| 7996 | period to allow the boot process to reach the login prompt is 500 | 7996 | period to allow the boot process to reach the login prompt is 500 |
| @@ -8001,7 +8001,7 @@ system and gives an overview of their function and contents. | |||
| 8001 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" | 8001 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" |
| 8002 | section in the Yocto Project Development Tasks Manual. | 8002 | section in the Yocto Project Development Tasks Manual. |
| 8003 | 8003 | ||
| 8004 | TEST_SERIALCONTROL_CMD | 8004 | :term:`TEST_SERIALCONTROL_CMD` |
| 8005 | For automated hardware testing, specifies the command to use to | 8005 | For automated hardware testing, specifies the command to use to |
| 8006 | connect to the serial console of the target machine under test. This | 8006 | connect to the serial console of the target machine under test. This |
| 8007 | command simply needs to connect to the serial console and forward | 8007 | command simply needs to connect to the serial console and forward |
| @@ -8014,7 +8014,7 @@ system and gives an overview of their function and contents. | |||
| 8014 | 8014 | ||
| 8015 | TEST_SERIALCONTROL_CMD = "picocom /dev/ttyUSB0 -b 115200" | 8015 | TEST_SERIALCONTROL_CMD = "picocom /dev/ttyUSB0 -b 115200" |
| 8016 | 8016 | ||
| 8017 | TEST_SERIALCONTROL_EXTRA_ARGS | 8017 | :term:`TEST_SERIALCONTROL_EXTRA_ARGS` |
| 8018 | For automated hardware testing, specifies additional arguments to | 8018 | For automated hardware testing, specifies additional arguments to |
| 8019 | pass through to the command specified in | 8019 | pass through to the command specified in |
| 8020 | :term:`TEST_SERIALCONTROL_CMD`. Setting | 8020 | :term:`TEST_SERIALCONTROL_CMD`. Setting |
| @@ -8022,7 +8022,7 @@ system and gives an overview of their function and contents. | |||
| 8022 | wish, for example, to separate the machine-specific and | 8022 | wish, for example, to separate the machine-specific and |
| 8023 | non-machine-specific parts of the command. | 8023 | non-machine-specific parts of the command. |
| 8024 | 8024 | ||
| 8025 | TEST_SERVER_IP | 8025 | :term:`TEST_SERVER_IP` |
| 8026 | The IP address of the build machine (host machine). This IP address | 8026 | The IP address of the build machine (host machine). This IP address |
| 8027 | is usually automatically detected. However, if detection fails, this | 8027 | is usually automatically detected. However, if detection fails, this |
| 8028 | variable needs to be set to the IP address of the build machine (i.e. | 8028 | variable needs to be set to the IP address of the build machine (i.e. |
| @@ -8037,7 +8037,7 @@ system and gives an overview of their function and contents. | |||
| 8037 | WORKDIR/oe-rootfs-repo | 8037 | WORKDIR/oe-rootfs-repo |
| 8038 | . | 8038 | . |
| 8039 | 8039 | ||
| 8040 | TEST_SUITES | 8040 | :term:`TEST_SUITES` |
| 8041 | An ordered list of tests (modules) to run against an image when | 8041 | An ordered list of tests (modules) to run against an image when |
| 8042 | performing automated runtime testing. | 8042 | performing automated runtime testing. |
| 8043 | 8043 | ||
| @@ -8080,7 +8080,7 @@ system and gives an overview of their function and contents. | |||
| 8080 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" | 8080 | ":ref:`dev-manual/dev-manual-common-tasks:performing automated runtime testing`" |
| 8081 | section in the Yocto Project Development Tasks Manual. | 8081 | section in the Yocto Project Development Tasks Manual. |
| 8082 | 8082 | ||
| 8083 | TEST_TARGET | 8083 | :term:`TEST_TARGET` |
| 8084 | Specifies the target controller to use when running tests against a | 8084 | Specifies the target controller to use when running tests against a |
| 8085 | test image. The default controller to use is "qemu": | 8085 | test image. The default controller to use is "qemu": |
| 8086 | :: | 8086 | :: |
| @@ -8117,7 +8117,7 @@ system and gives an overview of their function and contents. | |||
| 8117 | ":ref:`hardware-image-enabling-tests`" | 8117 | ":ref:`hardware-image-enabling-tests`" |
| 8118 | section in the Yocto Project Development Tasks Manual. | 8118 | section in the Yocto Project Development Tasks Manual. |
| 8119 | 8119 | ||
| 8120 | TEST_TARGET_IP | 8120 | :term:`TEST_TARGET_IP` |
| 8121 | The IP address of your hardware under test. The ``TEST_TARGET_IP`` | 8121 | The IP address of your hardware under test. The ``TEST_TARGET_IP`` |
| 8122 | variable has no effect when :term:`TEST_TARGET` is | 8122 | variable has no effect when :term:`TEST_TARGET` is |
| 8123 | set to "qemu". | 8123 | set to "qemu". |
| @@ -8134,7 +8134,7 @@ system and gives an overview of their function and contents. | |||
| 8134 | directly accessible from your host and you need to do port address | 8134 | directly accessible from your host and you need to do port address |
| 8135 | translation. | 8135 | translation. |
| 8136 | 8136 | ||
| 8137 | TESTIMAGE_AUTO | 8137 | :term:`TESTIMAGE_AUTO` |
| 8138 | Automatically runs the series of automated tests for images when an | 8138 | Automatically runs the series of automated tests for images when an |
| 8139 | image is successfully built. Setting ``TESTIMAGE_AUTO`` to "1" causes | 8139 | image is successfully built. Setting ``TESTIMAGE_AUTO`` to "1" causes |
| 8140 | any image that successfully builds to automatically boot under QEMU. | 8140 | any image that successfully builds to automatically boot under QEMU. |
| @@ -8156,16 +8156,16 @@ system and gives an overview of their function and contents. | |||
| 8156 | section in the Yocto Project Development Tasks Manual and the | 8156 | section in the Yocto Project Development Tasks Manual and the |
| 8157 | ":ref:`testimage*.bbclass <ref-classes-testimage*>`" section. | 8157 | ":ref:`testimage*.bbclass <ref-classes-testimage*>`" section. |
| 8158 | 8158 | ||
| 8159 | THISDIR | 8159 | :term:`THISDIR` |
| 8160 | The directory in which the file BitBake is currently parsing is | 8160 | The directory in which the file BitBake is currently parsing is |
| 8161 | located. Do not manually set this variable. | 8161 | located. Do not manually set this variable. |
| 8162 | 8162 | ||
| 8163 | TIME | 8163 | :term:`TIME` |
| 8164 | The time the build was started. Times appear using the hour, minute, | 8164 | The time the build was started. Times appear using the hour, minute, |
| 8165 | and second (HMS) format (e.g. "140159" for one minute and fifty-nine | 8165 | and second (HMS) format (e.g. "140159" for one minute and fifty-nine |
| 8166 | seconds past 1400 hours). | 8166 | seconds past 1400 hours). |
| 8167 | 8167 | ||
| 8168 | TMPDIR | 8168 | :term:`TMPDIR` |
| 8169 | This variable is the base directory the OpenEmbedded build system | 8169 | This variable is the base directory the OpenEmbedded build system |
| 8170 | uses for all build output and intermediate files (other than the | 8170 | uses for all build output and intermediate files (other than the |
| 8171 | shared state cache). By default, the ``TMPDIR`` variable points to | 8171 | shared state cache). By default, the ``TMPDIR`` variable points to |
| @@ -8187,7 +8187,7 @@ system and gives an overview of their function and contents. | |||
| 8187 | implementations, NFS does not meet this minimum requirement. | 8187 | implementations, NFS does not meet this minimum requirement. |
| 8188 | Consequently, ``TMPDIR`` cannot be on NFS. | 8188 | Consequently, ``TMPDIR`` cannot be on NFS. |
| 8189 | 8189 | ||
| 8190 | TOOLCHAIN_HOST_TASK | 8190 | :term:`TOOLCHAIN_HOST_TASK` |
| 8191 | This variable lists packages the OpenEmbedded build system uses when | 8191 | This variable lists packages the OpenEmbedded build system uses when |
| 8192 | building an SDK, which contains a cross-development environment. The | 8192 | building an SDK, which contains a cross-development environment. The |
| 8193 | packages specified by this variable are part of the toolchain set | 8193 | packages specified by this variable are part of the toolchain set |
| @@ -8212,7 +8212,7 @@ system and gives an overview of their function and contents. | |||
| 8212 | information on setting up a cross-development environment, see the | 8212 | information on setting up a cross-development environment, see the |
| 8213 | :doc:`../sdk-manual/sdk-manual` manual. | 8213 | :doc:`../sdk-manual/sdk-manual` manual. |
| 8214 | 8214 | ||
| 8215 | TOOLCHAIN_OUTPUTNAME | 8215 | :term:`TOOLCHAIN_OUTPUTNAME` |
| 8216 | This variable defines the name used for the toolchain output. The | 8216 | This variable defines the name used for the toolchain output. The |
| 8217 | :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` class sets | 8217 | :ref:`populate_sdk_base <ref-classes-populate-sdk-*>` class sets |
| 8218 | the ``TOOLCHAIN_OUTPUTNAME`` variable as follows: | 8218 | the ``TOOLCHAIN_OUTPUTNAME`` variable as follows: |
| @@ -8225,7 +8225,7 @@ system and gives an overview of their function and contents. | |||
| 8225 | :term:`SDK_VERSION` variables for additional | 8225 | :term:`SDK_VERSION` variables for additional |
| 8226 | information. | 8226 | information. |
| 8227 | 8227 | ||
| 8228 | TOOLCHAIN_TARGET_TASK | 8228 | :term:`TOOLCHAIN_TARGET_TASK` |
| 8229 | This variable lists packages the OpenEmbedded build system uses when | 8229 | This variable lists packages the OpenEmbedded build system uses when |
| 8230 | it creates the target part of an SDK (i.e. the part built for the | 8230 | it creates the target part of an SDK (i.e. the part built for the |
| 8231 | target hardware), which includes libraries and headers. Use this | 8231 | target hardware), which includes libraries and headers. Use this |
| @@ -8242,12 +8242,12 @@ system and gives an overview of their function and contents. | |||
| 8242 | information on setting up a cross-development environment, see the | 8242 | information on setting up a cross-development environment, see the |
| 8243 | :doc:`../sdk-manual/sdk-manual` manual. | 8243 | :doc:`../sdk-manual/sdk-manual` manual. |
| 8244 | 8244 | ||
| 8245 | TOPDIR | 8245 | :term:`TOPDIR` |
| 8246 | The top-level :term:`Build Directory`. BitBake | 8246 | The top-level :term:`Build Directory`. BitBake |
| 8247 | automatically sets this variable when you initialize your build | 8247 | automatically sets this variable when you initialize your build |
| 8248 | environment using ````` <#structure-core-script>`__. | 8248 | environment using ````` <#structure-core-script>`__. |
| 8249 | 8249 | ||
| 8250 | TRANSLATED_TARGET_ARCH | 8250 | :term:`TRANSLATED_TARGET_ARCH` |
| 8251 | A sanitized version of :term:`TARGET_ARCH`. This | 8251 | A sanitized version of :term:`TARGET_ARCH`. This |
| 8252 | variable is used where the architecture is needed in a value where | 8252 | variable is used where the architecture is needed in a value where |
| 8253 | underscores are not allowed, for example within package filenames. In | 8253 | underscores are not allowed, for example within package filenames. In |
| @@ -8256,7 +8256,7 @@ system and gives an overview of their function and contents. | |||
| 8256 | 8256 | ||
| 8257 | Do not edit this variable. | 8257 | Do not edit this variable. |
| 8258 | 8258 | ||
| 8259 | TUNE_ARCH | 8259 | :term:`TUNE_ARCH` |
| 8260 | The GNU canonical architecture for a specific architecture (i.e. | 8260 | The GNU canonical architecture for a specific architecture (i.e. |
| 8261 | ``arm``, ``armeb``, ``mips``, ``mips64``, and so forth). BitBake uses | 8261 | ``arm``, ``armeb``, ``mips``, ``mips64``, and so forth). BitBake uses |
| 8262 | this value to setup configuration. | 8262 | this value to setup configuration. |
| @@ -8288,7 +8288,7 @@ system and gives an overview of their function and contents. | |||
| 8288 | - mips | 8288 | - mips |
| 8289 | - mipsel | 8289 | - mipsel |
| 8290 | 8290 | ||
| 8291 | TUNE_ASARGS | 8291 | :term:`TUNE_ASARGS` |
| 8292 | Specifies architecture-specific assembler flags for the target | 8292 | Specifies architecture-specific assembler flags for the target |
| 8293 | system. The set of flags is based on the selected tune features. | 8293 | system. The set of flags is based on the selected tune features. |
| 8294 | ``TUNE_ASARGS`` is set using the tune include files, which are | 8294 | ``TUNE_ASARGS`` is set using the tune include files, which are |
| @@ -8306,7 +8306,7 @@ system and gives an overview of their function and contents. | |||
| 8306 | in turn, affects the tune variables themselves (i.e. the tune can | 8306 | in turn, affects the tune variables themselves (i.e. the tune can |
| 8307 | supply its own set of flags). | 8307 | supply its own set of flags). |
| 8308 | 8308 | ||
| 8309 | TUNE_CCARGS | 8309 | :term:`TUNE_CCARGS` |
| 8310 | Specifies architecture-specific C compiler flags for the target | 8310 | Specifies architecture-specific C compiler flags for the target |
| 8311 | system. The set of flags is based on the selected tune features. | 8311 | system. The set of flags is based on the selected tune features. |
| 8312 | ``TUNE_CCARGS`` is set using the tune include files, which are | 8312 | ``TUNE_CCARGS`` is set using the tune include files, which are |
| @@ -8319,7 +8319,7 @@ system and gives an overview of their function and contents. | |||
| 8319 | in turn, affects the tune variables themselves (i.e. the tune can | 8319 | in turn, affects the tune variables themselves (i.e. the tune can |
| 8320 | supply its own set of flags). | 8320 | supply its own set of flags). |
| 8321 | 8321 | ||
| 8322 | TUNE_FEATURES | 8322 | :term:`TUNE_FEATURES` |
| 8323 | Features used to "tune" a compiler for optimal use given a specific | 8323 | Features used to "tune" a compiler for optimal use given a specific |
| 8324 | processor. The features are defined within the tune files and allow | 8324 | processor. The features are defined within the tune files and allow |
| 8325 | arguments (i.e. ``TUNE_*ARGS``) to be dynamically generated based on | 8325 | arguments (i.e. ``TUNE_*ARGS``) to be dynamically generated based on |
| @@ -8336,7 +8336,7 @@ system and gives an overview of their function and contents. | |||
| 8336 | 8336 | ||
| 8337 | See the :term:`DEFAULTTUNE` variable for more information. | 8337 | See the :term:`DEFAULTTUNE` variable for more information. |
| 8338 | 8338 | ||
| 8339 | TUNE_LDARGS | 8339 | :term:`TUNE_LDARGS` |
| 8340 | Specifies architecture-specific linker flags for the target system. | 8340 | Specifies architecture-specific linker flags for the target system. |
| 8341 | The set of flags is based on the selected tune features. | 8341 | The set of flags is based on the selected tune features. |
| 8342 | ``TUNE_LDARGS`` is set using the tune include files, which are | 8342 | ``TUNE_LDARGS`` is set using the tune include files, which are |
| @@ -8354,7 +8354,7 @@ system and gives an overview of their function and contents. | |||
| 8354 | in turn, affects the tune variables themselves (i.e. the tune can | 8354 | in turn, affects the tune variables themselves (i.e. the tune can |
| 8355 | supply its own set of flags). | 8355 | supply its own set of flags). |
| 8356 | 8356 | ||
| 8357 | TUNE_PKGARCH | 8357 | :term:`TUNE_PKGARCH` |
| 8358 | The package architecture understood by the packaging system to define | 8358 | The package architecture understood by the packaging system to define |
| 8359 | the architecture, ABI, and tuning of output packages. The specific | 8359 | the architecture, ABI, and tuning of output packages. The specific |
| 8360 | tune is defined using the "_tune" override as follows: | 8360 | tune is defined using the "_tune" override as follows: |
| @@ -8369,7 +8369,7 @@ system and gives an overview of their function and contents. | |||
| 8369 | 8369 | ||
| 8370 | TUNE_PKGARCH_tune-core2-32 = "core2-32" | 8370 | TUNE_PKGARCH_tune-core2-32 = "core2-32" |
| 8371 | 8371 | ||
| 8372 | TUNEABI | 8372 | :term:`TUNEABI` |
| 8373 | An underlying Application Binary Interface (ABI) used by a particular | 8373 | An underlying Application Binary Interface (ABI) used by a particular |
| 8374 | tuning in a given toolchain layer. Providers that use prebuilt | 8374 | tuning in a given toolchain layer. Providers that use prebuilt |
| 8375 | libraries can use the ``TUNEABI``, | 8375 | libraries can use the ``TUNEABI``, |
| @@ -8381,7 +8381,7 @@ system and gives an overview of their function and contents. | |||
| 8381 | :ref:`sanity <ref-classes-sanity>` class to see how the variable is | 8381 | :ref:`sanity <ref-classes-sanity>` class to see how the variable is |
| 8382 | used. | 8382 | used. |
| 8383 | 8383 | ||
| 8384 | TUNEABI_OVERRIDE | 8384 | :term:`TUNEABI_OVERRIDE` |
| 8385 | If set, the OpenEmbedded system ignores the | 8385 | If set, the OpenEmbedded system ignores the |
| 8386 | :term:`TUNEABI_WHITELIST` variable. | 8386 | :term:`TUNEABI_WHITELIST` variable. |
| 8387 | Providers that use prebuilt libraries can use the | 8387 | Providers that use prebuilt libraries can use the |
| @@ -8392,7 +8392,7 @@ system and gives an overview of their function and contents. | |||
| 8392 | See the :ref:`sanity <ref-classes-sanity>` class to see how the | 8392 | See the :ref:`sanity <ref-classes-sanity>` class to see how the |
| 8393 | variable is used. | 8393 | variable is used. |
| 8394 | 8394 | ||
| 8395 | TUNEABI_WHITELIST | 8395 | :term:`TUNEABI_WHITELIST` |
| 8396 | A whitelist of permissible :term:`TUNEABI` values. If | 8396 | A whitelist of permissible :term:`TUNEABI` values. If |
| 8397 | ``TUNEABI_WHITELIST`` is not set, all tunes are allowed. Providers | 8397 | ``TUNEABI_WHITELIST`` is not set, all tunes are allowed. Providers |
| 8398 | that use prebuilt libraries can use the ``TUNEABI_WHITELIST``, | 8398 | that use prebuilt libraries can use the ``TUNEABI_WHITELIST``, |
| @@ -8403,7 +8403,7 @@ system and gives an overview of their function and contents. | |||
| 8403 | See the :ref:`sanity <ref-classes-sanity>` class to see how the | 8403 | See the :ref:`sanity <ref-classes-sanity>` class to see how the |
| 8404 | variable is used. | 8404 | variable is used. |
| 8405 | 8405 | ||
| 8406 | TUNECONFLICTS[feature] | 8406 | :term:`TUNECONFLICTS[feature]` |
| 8407 | Specifies CPU or Application Binary Interface (ABI) tuning features | 8407 | Specifies CPU or Application Binary Interface (ABI) tuning features |
| 8408 | that conflict with feature. | 8408 | that conflict with feature. |
| 8409 | 8409 | ||
| @@ -8416,7 +8416,7 @@ system and gives an overview of their function and contents. | |||
| 8416 | 8416 | ||
| 8417 | TUNECONFLICTS[n32] = "o32 n64" | 8417 | TUNECONFLICTS[n32] = "o32 n64" |
| 8418 | 8418 | ||
| 8419 | TUNEVALID[feature] | 8419 | :term:`TUNEVALID[feature]` |
| 8420 | Specifies a valid CPU or Application Binary Interface (ABI) tuning | 8420 | Specifies a valid CPU or Application Binary Interface (ABI) tuning |
| 8421 | feature. The specified feature is stored as a flag. Valid features | 8421 | feature. The specified feature is stored as a flag. Valid features |
| 8422 | are specified in the machine include files (e.g. | 8422 | are specified in the machine include files (e.g. |
| @@ -8429,7 +8429,7 @@ system and gives an overview of their function and contents. | |||
| 8429 | See the machine include files in the :term:`Source Directory` | 8429 | See the machine include files in the :term:`Source Directory` |
| 8430 | for these features. | 8430 | for these features. |
| 8431 | 8431 | ||
| 8432 | UBOOT_CONFIG | 8432 | :term:`UBOOT_CONFIG` |
| 8433 | Configures the :term:`UBOOT_MACHINE` and can | 8433 | Configures the :term:`UBOOT_MACHINE` and can |
| 8434 | also define :term:`IMAGE_FSTYPES` for individual | 8434 | also define :term:`IMAGE_FSTYPES` for individual |
| 8435 | cases. | 8435 | cases. |
| @@ -8451,30 +8451,30 @@ system and gives an overview of their function and contents. | |||
| 8451 | :ref:`uboot-config <ref-classes-uboot-config>` | 8451 | :ref:`uboot-config <ref-classes-uboot-config>` |
| 8452 | class. | 8452 | class. |
| 8453 | 8453 | ||
| 8454 | UBOOT_DTB_LOADADDRESS | 8454 | :term:`UBOOT_DTB_LOADADDRESS` |
| 8455 | Specifies the load address for the dtb image used by U-boot. During FIT | 8455 | Specifies the load address for the dtb image used by U-boot. During FIT |
| 8456 | image creation, the ``UBOOT_DTB_LOADADDRESS`` variable is used in | 8456 | image creation, the ``UBOOT_DTB_LOADADDRESS`` variable is used in |
| 8457 | :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class to specify | 8457 | :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class to specify |
| 8458 | the load address to be used in | 8458 | the load address to be used in |
| 8459 | creating the dtb sections of Image Tree Source for the FIT image. | 8459 | creating the dtb sections of Image Tree Source for the FIT image. |
| 8460 | 8460 | ||
| 8461 | UBOOT_DTBO_LOADADDRESS | 8461 | :term:`UBOOT_DTBO_LOADADDRESS` |
| 8462 | Specifies the load address for the dtbo image used by U-boot. During FIT | 8462 | Specifies the load address for the dtbo image used by U-boot. During FIT |
| 8463 | image creation, the ``UBOOT_DTBO_LOADADDRESS`` variable is used in | 8463 | image creation, the ``UBOOT_DTBO_LOADADDRESS`` variable is used in |
| 8464 | :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class to specify the load address to be used in | 8464 | :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class to specify the load address to be used in |
| 8465 | creating the dtbo sections of Image Tree Source for the FIT image. | 8465 | creating the dtbo sections of Image Tree Source for the FIT image. |
| 8466 | 8466 | ||
| 8467 | UBOOT_ENTRYPOINT | 8467 | :term:`UBOOT_ENTRYPOINT` |
| 8468 | Specifies the entry point for the U-Boot image. During U-Boot image | 8468 | Specifies the entry point for the U-Boot image. During U-Boot image |
| 8469 | creation, the ``UBOOT_ENTRYPOINT`` variable is passed as a | 8469 | creation, the ``UBOOT_ENTRYPOINT`` variable is passed as a |
| 8470 | command-line parameter to the ``uboot-mkimage`` utility. | 8470 | command-line parameter to the ``uboot-mkimage`` utility. |
| 8471 | 8471 | ||
| 8472 | UBOOT_LOADADDRESS | 8472 | :term:`UBOOT_LOADADDRESS` |
| 8473 | Specifies the load address for the U-Boot image. During U-Boot image | 8473 | Specifies the load address for the U-Boot image. During U-Boot image |
| 8474 | creation, the ``UBOOT_LOADADDRESS`` variable is passed as a | 8474 | creation, the ``UBOOT_LOADADDRESS`` variable is passed as a |
| 8475 | command-line parameter to the ``uboot-mkimage`` utility. | 8475 | command-line parameter to the ``uboot-mkimage`` utility. |
| 8476 | 8476 | ||
| 8477 | UBOOT_LOCALVERSION | 8477 | :term:`UBOOT_LOCALVERSION` |
| 8478 | Appends a string to the name of the local version of the U-Boot | 8478 | Appends a string to the name of the local version of the U-Boot |
| 8479 | image. For example, assuming the version of the U-Boot image built | 8479 | image. For example, assuming the version of the U-Boot image built |
| 8480 | was "2013.10", the full version string reported by U-Boot would be | 8480 | was "2013.10", the full version string reported by U-Boot would be |
| @@ -8483,7 +8483,7 @@ system and gives an overview of their function and contents. | |||
| 8483 | 8483 | ||
| 8484 | UBOOT_LOCALVERSION = "-yocto" | 8484 | UBOOT_LOCALVERSION = "-yocto" |
| 8485 | 8485 | ||
| 8486 | UBOOT_MACHINE | 8486 | :term:`UBOOT_MACHINE` |
| 8487 | Specifies the value passed on the ``make`` command line when building | 8487 | Specifies the value passed on the ``make`` command line when building |
| 8488 | a U-Boot image. The value indicates the target platform | 8488 | a U-Boot image. The value indicates the target platform |
| 8489 | configuration. You typically set this variable from the machine | 8489 | configuration. You typically set this variable from the machine |
| @@ -8492,15 +8492,15 @@ system and gives an overview of their function and contents. | |||
| 8492 | Please see the "Selection of Processor Architecture and Board Type" | 8492 | Please see the "Selection of Processor Architecture and Board Type" |
| 8493 | section in the U-Boot README for valid values for this variable. | 8493 | section in the U-Boot README for valid values for this variable. |
| 8494 | 8494 | ||
| 8495 | UBOOT_MAKE_TARGET | 8495 | :term:`UBOOT_MAKE_TARGET` |
| 8496 | Specifies the target called in the ``Makefile``. The default target | 8496 | Specifies the target called in the ``Makefile``. The default target |
| 8497 | is "all". | 8497 | is "all". |
| 8498 | 8498 | ||
| 8499 | UBOOT_MKIMAGE_DTCOPTS | 8499 | :term:`UBOOT_MKIMAGE_DTCOPTS` |
| 8500 | Options for the device tree compiler passed to mkimage '-D' | 8500 | Options for the device tree compiler passed to mkimage '-D' |
| 8501 | feature while creating FIT image in :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class. | 8501 | feature while creating FIT image in :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class. |
| 8502 | 8502 | ||
| 8503 | UBOOT_RD_ENTRYPOINT | 8503 | :term:`UBOOT_RD_ENTRYPOINT` |
| 8504 | Specifies the entrypoint for the RAM disk image. | 8504 | Specifies the entrypoint for the RAM disk image. |
| 8505 | During FIT image creation, the | 8505 | During FIT image creation, the |
| 8506 | ``UBOOT_RD_ENTRYPOINT`` variable is used | 8506 | ``UBOOT_RD_ENTRYPOINT`` variable is used |
| @@ -8508,7 +8508,7 @@ system and gives an overview of their function and contents. | |||
| 8508 | entrypoint to be used in creating the Image Tree Source for | 8508 | entrypoint to be used in creating the Image Tree Source for |
| 8509 | the FIT image. | 8509 | the FIT image. |
| 8510 | 8510 | ||
| 8511 | UBOOT_RD_LOADADDRESS | 8511 | :term:`UBOOT_RD_LOADADDRESS` |
| 8512 | Specifies the load address for the RAM disk image. | 8512 | Specifies the load address for the RAM disk image. |
| 8513 | During FIT image creation, the | 8513 | During FIT image creation, the |
| 8514 | ``UBOOT_RD_LOADADDRESS`` variable is used | 8514 | ``UBOOT_RD_LOADADDRESS`` variable is used |
| @@ -8516,33 +8516,33 @@ system and gives an overview of their function and contents. | |||
| 8516 | load address to be used in creating the Image Tree Source for | 8516 | load address to be used in creating the Image Tree Source for |
| 8517 | the FIT image. | 8517 | the FIT image. |
| 8518 | 8518 | ||
| 8519 | UBOOT_SIGN_ENABLE | 8519 | :term:`UBOOT_SIGN_ENABLE` |
| 8520 | Enable signing of FIT image. The default value is "0". | 8520 | Enable signing of FIT image. The default value is "0". |
| 8521 | 8521 | ||
| 8522 | UBOOT_SIGN_KEYDIR | 8522 | :term:`UBOOT_SIGN_KEYDIR` |
| 8523 | Location of the directory containing the RSA key and | 8523 | Location of the directory containing the RSA key and |
| 8524 | certificate used for signing FIT image. | 8524 | certificate used for signing FIT image. |
| 8525 | 8525 | ||
| 8526 | UBOOT_SIGN_KEYNAME | 8526 | :term:`UBOOT_SIGN_KEYNAME` |
| 8527 | The name of keys used for signing U-boot FIT image stored in | 8527 | The name of keys used for signing U-boot FIT image stored in |
| 8528 | :term:`UBOOT_SIGN_KEYDIR` directory. For e.g. dev.key key and dev.crt | 8528 | :term:`UBOOT_SIGN_KEYDIR` directory. For e.g. dev.key key and dev.crt |
| 8529 | certificate stored in :term:`UBOOT_SIGN_KEYDIR` directory will have | 8529 | certificate stored in :term:`UBOOT_SIGN_KEYDIR` directory will have |
| 8530 | :term:`UBOOT_SIGN_KEYNAME` set to "dev". | 8530 | :term:`UBOOT_SIGN_KEYNAME` set to "dev". |
| 8531 | 8531 | ||
| 8532 | UBOOT_SUFFIX | 8532 | :term:`UBOOT_SUFFIX` |
| 8533 | Points to the generated U-Boot extension. For example, ``u-boot.sb`` | 8533 | Points to the generated U-Boot extension. For example, ``u-boot.sb`` |
| 8534 | has a ``.sb`` extension. | 8534 | has a ``.sb`` extension. |
| 8535 | 8535 | ||
| 8536 | The default U-Boot extension is ``.bin`` | 8536 | The default U-Boot extension is ``.bin`` |
| 8537 | 8537 | ||
| 8538 | UBOOT_TARGET | 8538 | :term:`UBOOT_TARGET` |
| 8539 | Specifies the target used for building U-Boot. The target is passed | 8539 | Specifies the target used for building U-Boot. The target is passed |
| 8540 | directly as part of the "make" command (e.g. SPL and AIS). If you do | 8540 | directly as part of the "make" command (e.g. SPL and AIS). If you do |
| 8541 | not specifically set this variable, the OpenEmbedded build process | 8541 | not specifically set this variable, the OpenEmbedded build process |
| 8542 | passes and uses "all" for the target during the U-Boot building | 8542 | passes and uses "all" for the target during the U-Boot building |
| 8543 | process. | 8543 | process. |
| 8544 | 8544 | ||
| 8545 | UNKNOWN_CONFIGURE_WHITELIST | 8545 | :term:`UNKNOWN_CONFIGURE_WHITELIST` |
| 8546 | Specifies a list of options that, if reported by the configure script | 8546 | Specifies a list of options that, if reported by the configure script |
| 8547 | as being invalid, should not generate a warning during the | 8547 | as being invalid, should not generate a warning during the |
| 8548 | :ref:`ref-tasks-configure` task. Normally, invalid | 8548 | :ref:`ref-tasks-configure` task. Normally, invalid |
| @@ -8560,7 +8560,7 @@ system and gives an overview of their function and contents. | |||
| 8560 | :ref:`insane <ref-classes-insane>` class and is only enabled if the | 8560 | :ref:`insane <ref-classes-insane>` class and is only enabled if the |
| 8561 | recipe inherits the :ref:`autotools <ref-classes-autotools>` class. | 8561 | recipe inherits the :ref:`autotools <ref-classes-autotools>` class. |
| 8562 | 8562 | ||
| 8563 | UPDATERCPN | 8563 | :term:`UPDATERCPN` |
| 8564 | For recipes inheriting the | 8564 | For recipes inheriting the |
| 8565 | :ref:`update-rc.d <ref-classes-update-rc.d>` class, ``UPDATERCPN`` | 8565 | :ref:`update-rc.d <ref-classes-update-rc.d>` class, ``UPDATERCPN`` |
| 8566 | specifies the package that contains the initscript that is enabled. | 8566 | specifies the package that contains the initscript that is enabled. |
| @@ -8569,7 +8569,7 @@ system and gives an overview of their function and contents. | |||
| 8569 | install initscripts package them in the main package for the recipe, | 8569 | install initscripts package them in the main package for the recipe, |
| 8570 | you rarely need to set this variable in individual recipes. | 8570 | you rarely need to set this variable in individual recipes. |
| 8571 | 8571 | ||
| 8572 | UPSTREAM_CHECK_GITTAGREGEX | 8572 | :term:`UPSTREAM_CHECK_GITTAGREGEX` |
| 8573 | You can perform a per-recipe check for what the latest upstream | 8573 | You can perform a per-recipe check for what the latest upstream |
| 8574 | source code version is by calling ``bitbake -c checkpkg`` recipe. If | 8574 | source code version is by calling ``bitbake -c checkpkg`` recipe. If |
| 8575 | the recipe source code is provided from Git repositories, the | 8575 | the recipe source code is provided from Git repositories, the |
| @@ -8583,7 +8583,7 @@ system and gives an overview of their function and contents. | |||
| 8583 | 8583 | ||
| 8584 | UPSTREAM_CHECK_GITTAGREGEX = "git_tag_regex" | 8584 | UPSTREAM_CHECK_GITTAGREGEX = "git_tag_regex" |
| 8585 | 8585 | ||
| 8586 | UPSTREAM_CHECK_REGEX | 8586 | :term:`UPSTREAM_CHECK_REGEX` |
| 8587 | Use the ``UPSTREAM_CHECK_REGEX`` variable to specify a different | 8587 | Use the ``UPSTREAM_CHECK_REGEX`` variable to specify a different |
| 8588 | regular expression instead of the default one when the package | 8588 | regular expression instead of the default one when the package |
| 8589 | checking system is parsing the page found using | 8589 | checking system is parsing the page found using |
| @@ -8592,7 +8592,7 @@ system and gives an overview of their function and contents. | |||
| 8592 | 8592 | ||
| 8593 | UPSTREAM_CHECK_REGEX = "package_regex" | 8593 | UPSTREAM_CHECK_REGEX = "package_regex" |
| 8594 | 8594 | ||
| 8595 | UPSTREAM_CHECK_URI | 8595 | :term:`UPSTREAM_CHECK_URI` |
| 8596 | You can perform a per-recipe check for what the latest upstream | 8596 | You can perform a per-recipe check for what the latest upstream |
| 8597 | source code version is by calling ``bitbake -c checkpkg`` recipe. If | 8597 | source code version is by calling ``bitbake -c checkpkg`` recipe. If |
| 8598 | the source code is provided from tarballs, the latest version is | 8598 | the source code is provided from tarballs, the latest version is |
| @@ -8604,7 +8604,7 @@ system and gives an overview of their function and contents. | |||
| 8604 | 8604 | ||
| 8605 | UPSTREAM_CHECK_URI = "recipe_url" | 8605 | UPSTREAM_CHECK_URI = "recipe_url" |
| 8606 | 8606 | ||
| 8607 | USE_DEVFS | 8607 | :term:`USE_DEVFS` |
| 8608 | Determines if ``devtmpfs`` is used for ``/dev`` population. The | 8608 | Determines if ``devtmpfs`` is used for ``/dev`` population. The |
| 8609 | default value used for ``USE_DEVFS`` is "1" when no value is | 8609 | default value used for ``USE_DEVFS`` is "1" when no value is |
| 8610 | specifically set. Typically, you would set ``USE_DEVFS`` to "0" for a | 8610 | specifically set. Typically, you would set ``USE_DEVFS`` to "0" for a |
| @@ -8614,7 +8614,7 @@ system and gives an overview of their function and contents. | |||
| 8614 | the Yocto Project Development Tasks Manual for information on how to | 8614 | the Yocto Project Development Tasks Manual for information on how to |
| 8615 | use this variable. | 8615 | use this variable. |
| 8616 | 8616 | ||
| 8617 | USE_VT | 8617 | :term:`USE_VT` |
| 8618 | When using | 8618 | When using |
| 8619 | :ref:`SysVinit <new-recipe-enabling-system-services>`, | 8619 | :ref:`SysVinit <new-recipe-enabling-system-services>`, |
| 8620 | determines whether or not to run a | 8620 | determines whether or not to run a |
| @@ -8628,7 +8628,7 @@ system and gives an overview of their function and contents. | |||
| 8628 | display attached and therefore do not need virtual terminal | 8628 | display attached and therefore do not need virtual terminal |
| 8629 | functionality. | 8629 | functionality. |
| 8630 | 8630 | ||
| 8631 | USER_CLASSES | 8631 | :term:`USER_CLASSES` |
| 8632 | A list of classes to globally inherit. These classes are used by the | 8632 | A list of classes to globally inherit. These classes are used by the |
| 8633 | OpenEmbedded build system to enable extra features (e.g. | 8633 | OpenEmbedded build system to enable extra features (e.g. |
| 8634 | ``buildstats``, ``image-mklibs``, and so forth). | 8634 | ``buildstats``, ``image-mklibs``, and so forth). |
| @@ -8641,7 +8641,7 @@ system and gives an overview of their function and contents. | |||
| 8641 | For more information, see | 8641 | For more information, see |
| 8642 | ``meta-poky/conf/local.conf.sample`` in the :term:`Source Directory`. | 8642 | ``meta-poky/conf/local.conf.sample`` in the :term:`Source Directory`. |
| 8643 | 8643 | ||
| 8644 | USERADD_ERROR_DYNAMIC | 8644 | :term:`USERADD_ERROR_DYNAMIC` |
| 8645 | If set to ``error``, forces the OpenEmbedded build system to produce | 8645 | If set to ``error``, forces the OpenEmbedded build system to produce |
| 8646 | an error if the user identification (``uid``) and group | 8646 | an error if the user identification (``uid``) and group |
| 8647 | identification (``gid``) values are not defined in any of the files | 8647 | identification (``gid``) values are not defined in any of the files |
| @@ -8686,7 +8686,7 @@ system and gives an overview of their function and contents. | |||
| 8686 | This saves you from having to add static IDs for recipes that you | 8686 | This saves you from having to add static IDs for recipes that you |
| 8687 | know will never be built. | 8687 | know will never be built. |
| 8688 | 8688 | ||
| 8689 | USERADD_GID_TABLES | 8689 | :term:`USERADD_GID_TABLES` |
| 8690 | Specifies a password file to use for obtaining static group | 8690 | Specifies a password file to use for obtaining static group |
| 8691 | identification (``gid``) values when the OpenEmbedded build system | 8691 | identification (``gid``) values when the OpenEmbedded build system |
| 8692 | adds a group to the system during package installation. | 8692 | adds a group to the system during package installation. |
| @@ -8709,7 +8709,7 @@ system and gives an overview of their function and contents. | |||
| 8709 | gid | 8709 | gid |
| 8710 | values. | 8710 | values. |
| 8711 | 8711 | ||
| 8712 | USERADD_PACKAGES | 8712 | :term:`USERADD_PACKAGES` |
| 8713 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, | 8713 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, |
| 8714 | this variable specifies the individual packages within the recipe | 8714 | this variable specifies the individual packages within the recipe |
| 8715 | that require users and/or groups to be added. | 8715 | that require users and/or groups to be added. |
| @@ -8733,7 +8733,7 @@ system and gives an overview of their function and contents. | |||
| 8733 | GROUPMEMS_PARAM | 8733 | GROUPMEMS_PARAM |
| 8734 | variables. | 8734 | variables. |
| 8735 | 8735 | ||
| 8736 | USERADD_PARAM | 8736 | :term:`USERADD_PARAM` |
| 8737 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, | 8737 | When inheriting the :ref:`useradd <ref-classes-useradd>` class, |
| 8738 | this variable specifies for a package what parameters should pass to | 8738 | this variable specifies for a package what parameters should pass to |
| 8739 | the ``useradd`` command if you add a user to the system when the | 8739 | the ``useradd`` command if you add a user to the system when the |
| @@ -8750,7 +8750,7 @@ system and gives an overview of their function and contents. | |||
| 8750 | standard Linux shell command ``useradd``, see | 8750 | standard Linux shell command ``useradd``, see |
| 8751 | http://linux.die.net/man/8/useradd. | 8751 | http://linux.die.net/man/8/useradd. |
| 8752 | 8752 | ||
| 8753 | USERADD_UID_TABLES | 8753 | :term:`USERADD_UID_TABLES` |
| 8754 | Specifies a password file to use for obtaining static user | 8754 | Specifies a password file to use for obtaining static user |
| 8755 | identification (``uid``) values when the OpenEmbedded build system | 8755 | identification (``uid``) values when the OpenEmbedded build system |
| 8756 | adds a user to the system during package installation. | 8756 | adds a user to the system during package installation. |
| @@ -8772,7 +8772,7 @@ system and gives an overview of their function and contents. | |||
| 8772 | uid | 8772 | uid |
| 8773 | values. | 8773 | values. |
| 8774 | 8774 | ||
| 8775 | USERADDEXTENSION | 8775 | :term:`USERADDEXTENSION` |
| 8776 | When set to "useradd-staticids", causes the OpenEmbedded build system | 8776 | When set to "useradd-staticids", causes the OpenEmbedded build system |
| 8777 | to base all user and group additions on a static ``passwd`` and | 8777 | to base all user and group additions on a static ``passwd`` and |
| 8778 | ``group`` files found in :term:`BBPATH`. | 8778 | ``group`` files found in :term:`BBPATH`. |
| @@ -8798,7 +8798,7 @@ system and gives an overview of their function and contents. | |||
| 8798 | Additionally, you should also set the | 8798 | Additionally, you should also set the |
| 8799 | :term:`USERADD_ERROR_DYNAMIC` variable. | 8799 | :term:`USERADD_ERROR_DYNAMIC` variable. |
| 8800 | 8800 | ||
| 8801 | VOLATILE_LOG_DIR | 8801 | :term:`VOLATILE_LOG_DIR` |
| 8802 | Specifies the persistence of the target's ``/var/log`` directory, | 8802 | Specifies the persistence of the target's ``/var/log`` directory, |
| 8803 | which is used to house postinstall target log files. | 8803 | which is used to house postinstall target log files. |
| 8804 | 8804 | ||
| @@ -8806,14 +8806,14 @@ system and gives an overview of their function and contents. | |||
| 8806 | file is not persistent. You can override this setting by setting the | 8806 | file is not persistent. You can override this setting by setting the |
| 8807 | variable to "no" to make the log directory persistent. | 8807 | variable to "no" to make the log directory persistent. |
| 8808 | 8808 | ||
| 8809 | WARN_QA | 8809 | :term:`WARN_QA` |
| 8810 | Specifies the quality assurance checks whose failures are reported as | 8810 | Specifies the quality assurance checks whose failures are reported as |
| 8811 | warnings by the OpenEmbedded build system. You set this variable in | 8811 | warnings by the OpenEmbedded build system. You set this variable in |
| 8812 | your distribution configuration file. For a list of the checks you | 8812 | your distribution configuration file. For a list of the checks you |
| 8813 | can control with this variable, see the | 8813 | can control with this variable, see the |
| 8814 | ":ref:`insane.bbclass <ref-classes-insane>`" section. | 8814 | ":ref:`insane.bbclass <ref-classes-insane>`" section. |
| 8815 | 8815 | ||
| 8816 | WKS_FILE | 8816 | :term:`WKS_FILE` |
| 8817 | Specifies the location of the Wic kickstart file that is used by the | 8817 | Specifies the location of the Wic kickstart file that is used by the |
| 8818 | OpenEmbedded build system to create a partitioned image | 8818 | OpenEmbedded build system to create a partitioned image |
| 8819 | (image\ ``.wic``). For information on how to create a partitioned | 8819 | (image\ ``.wic``). For information on how to create a partitioned |
| @@ -8822,7 +8822,7 @@ system and gives an overview of their function and contents. | |||
| 8822 | section in the Yocto Project Development Tasks Manual. For details on | 8822 | section in the Yocto Project Development Tasks Manual. For details on |
| 8823 | the kickstart file format, see the ":doc:`../ref-manual/ref-kickstart`" Chapter. | 8823 | the kickstart file format, see the ":doc:`../ref-manual/ref-kickstart`" Chapter. |
| 8824 | 8824 | ||
| 8825 | WKS_FILE_DEPENDS | 8825 | :term:`WKS_FILE_DEPENDS` |
| 8826 | When placed in the recipe that builds your image, this variable lists | 8826 | When placed in the recipe that builds your image, this variable lists |
| 8827 | build-time dependencies. The ``WKS_FILE_DEPENDS`` variable is only | 8827 | build-time dependencies. The ``WKS_FILE_DEPENDS`` variable is only |
| 8828 | applicable when Wic images are active (i.e. when | 8828 | applicable when Wic images are active (i.e. when |
| @@ -8847,7 +8847,7 @@ system and gives an overview of their function and contents. | |||
| 8847 | previous example, some-native-tool would be replaced with an actual | 8847 | previous example, some-native-tool would be replaced with an actual |
| 8848 | native tool on which the build would depend. | 8848 | native tool on which the build would depend. |
| 8849 | 8849 | ||
| 8850 | WORKDIR | 8850 | :term:`WORKDIR` |
| 8851 | The pathname of the work directory in which the OpenEmbedded build | 8851 | The pathname of the work directory in which the OpenEmbedded build |
| 8852 | system builds a recipe. This directory is located within the | 8852 | system builds a recipe. This directory is located within the |
| 8853 | :term:`TMPDIR` directory structure and is specific to | 8853 | :term:`TMPDIR` directory structure and is specific to |
| @@ -8887,7 +8887,7 @@ system and gives an overview of their function and contents. | |||
| 8887 | 8887 | ||
| 8888 | poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 | 8888 | poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 |
| 8889 | 8889 | ||
| 8890 | XSERVER | 8890 | :term:`XSERVER` |
| 8891 | Specifies the packages that should be installed to provide an X | 8891 | Specifies the packages that should be installed to provide an X |
| 8892 | server and drivers for the current machine, assuming your image | 8892 | server and drivers for the current machine, assuming your image |
| 8893 | directly includes ``packagegroup-core-x11-xserver`` or, perhaps | 8893 | directly includes ``packagegroup-core-x11-xserver`` or, perhaps |
