1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK 2 3**************** 4Variable Context 5**************** 6 7While you can use most variables in almost any context such as 8``.conf``, ``.bbclass``, ``.inc``, and ``.bb`` files, some variables are 9often associated with a particular locality or context. This chapter 10describes some common associations. 11 12.. _ref-varlocality-configuration: 13 14Configuration 15============= 16 17The following subsections provide lists of variables whose context is 18configuration: distribution, machine, and local. 19 20.. _ref-varlocality-config-distro: 21 22Distribution (Distro) 23--------------------- 24 25This section lists variables whose configuration context is the 26distribution, or distro. 27 28- :term:`DISTRO` 29 30- :term:`DISTRO_NAME` 31 32- :term:`DISTRO_VERSION` 33 34- :term:`MAINTAINER` 35 36- :term:`PACKAGE_CLASSES` 37 38- :term:`TARGET_OS` 39 40- :term:`TARGET_FPU` 41 42- :term:`TCMODE` 43 44- :term:`TCLIBC` 45 46.. _ref-varlocality-config-machine: 47 48Machine 49------- 50 51This section lists variables whose configuration context is the machine. 52 53- :term:`TARGET_ARCH` 54 55- :term:`SERIAL_CONSOLES` 56 57- :term:`PACKAGE_EXTRA_ARCHS` 58 59- :term:`IMAGE_FSTYPES` 60 61- :term:`MACHINE_FEATURES` 62 63- :term:`MACHINE_EXTRA_RDEPENDS` 64 65- :term:`MACHINE_EXTRA_RRECOMMENDS` 66 67- :term:`MACHINE_ESSENTIAL_EXTRA_RDEPENDS` 68 69- :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` 70 71.. _ref-varlocality-config-local: 72 73Local 74----- 75 76This section lists variables whose configuration context is the local 77configuration through the ``local.conf`` file. 78 79- :term:`DISTRO` 80 81- :term:`MACHINE` 82 83- :term:`DL_DIR` 84 85- :term:`BBFILES` 86 87- :term:`EXTRA_IMAGE_FEATURES` 88 89- :term:`PACKAGE_CLASSES` 90 91- :term:`BB_NUMBER_THREADS` 92 93- :term:`BBINCLUDELOGS` 94 95- :term:`ENABLE_BINARY_LOCALE_GENERATION` 96 97.. _ref-varlocality-recipes: 98 99Recipes 100======= 101 102The following subsections provide lists of variables whose context is 103recipes: required, dependencies, path, and extra build information. 104 105.. _ref-varlocality-recipe-required: 106 107Required 108-------- 109 110This section lists variables that are required for recipes. 111 112- :term:`LICENSE` 113 114- :term:`LIC_FILES_CHKSUM` 115 116- :term:`SRC_URI` --- used in recipes that fetch local or remote files. 117 118.. _ref-varlocality-recipe-dependencies: 119 120Dependencies 121------------ 122 123This section lists variables that define recipe dependencies. 124 125- :term:`DEPENDS` 126 127- :term:`RDEPENDS` 128 129- :term:`RRECOMMENDS` 130 131- :term:`RCONFLICTS` 132 133- :term:`RREPLACES` 134 135.. _ref-varlocality-recipe-paths: 136 137Paths 138----- 139 140This section lists variables that define recipe paths. 141 142- :term:`WORKDIR` 143 144- :term:`S` 145 146- :term:`FILES` 147 148.. _ref-varlocality-recipe-build: 149 150Extra Build Information 151----------------------- 152 153This section lists variables that define extra build information for 154recipes. 155 156- :term:`DEFAULT_PREFERENCE` 157 158- :term:`EXTRA_OECMAKE` 159 160- :term:`EXTRA_OECONF` 161 162- :term:`EXTRA_OEMAKE` 163 164- :term:`PACKAGECONFIG_CONFARGS` 165 166- :term:`PACKAGES` 167