diff options
Diffstat (limited to 'external/poky/documentation/ref-manual/ref-variables.xml')
| -rw-r--r-- | external/poky/documentation/ref-manual/ref-variables.xml | 1059 |
1 files changed, 291 insertions, 768 deletions
diff --git a/external/poky/documentation/ref-manual/ref-variables.xml b/external/poky/documentation/ref-manual/ref-variables.xml index c7c5f27b..364cd09e 100644 --- a/external/poky/documentation/ref-manual/ref-variables.xml +++ b/external/poky/documentation/ref-manual/ref-variables.xml @@ -52,7 +52,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extension to the Application Binary Interface (ABI) field of the GNU canonical architecture name (e.g. "eabi"). @@ -76,7 +75,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies whether to produce an output package even if it is empty. By default, BitBake does not produce empty packages. @@ -103,7 +101,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists commands in a package that need an alternative binary naming scheme. Sometimes the same command is provided in multiple packages. @@ -134,7 +131,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used by the alternatives system to map duplicated commands to actual locations. For example, if the <filename>bracket</filename> command @@ -174,7 +170,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used by the alternatives system to create default priorities for duplicated commands. You can use the variable to create a single default @@ -203,7 +198,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used by the alternatives system to create default link locations for duplicated commands. You can use the variable to create a single default @@ -258,7 +252,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An override list of append strings for each target specified with <link linkend='var-LABELS'><filename>LABELS</filename></link>. @@ -278,7 +271,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments used to run <filename>ar</filename>. </para> @@ -291,7 +283,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used with the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> class, determines the type of information used to create @@ -334,8 +325,7 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - The minimal command and arguments used to run the + Minimal command and arguments needed to run the assembler. </para> </glossdef> @@ -347,7 +337,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists recipe names (<link linkend='var-PN'><filename>PN</filename></link> values) BitBake does not attempt to build. @@ -367,11 +356,10 @@ <glossentry id='var-ASSUME_SHLIBS'><glossterm>ASSUME_SHLIBS</glossterm> <info> - ASSUME_SHLIBS[doc] = Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system." + ASSUME_SHLIBS[doc] = "Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Provides additional <filename>shlibs</filename> provider mapping information, which adds to or overwrites the information provided automatically by the system. @@ -406,7 +394,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The email address used to contact the original author or authors in order to send patches and forward bugs. </para> @@ -419,7 +406,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When the <link linkend='ref-classes-debian'><filename>debian</filename></link> class is inherited, which is the default behavior, @@ -442,7 +428,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Enables creating an automatic menu for the syslinux bootloader. You must set this variable in your recipe. @@ -459,7 +444,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When <filename><link linkend='var-SRCREV'>SRCREV</link></filename> is set to the value of this variable, it specifies to use @@ -495,13 +479,35 @@ </glossdef> </glossentry> + <glossentry id='var-AVAILABLE_LICENSES'><glossterm>AVAILABLE_LICENSES</glossterm> + <info> + AVAILABLE_LICENSES[doc] = "List of licenses found in the directories specified by COMMON_LICENSE_DIR and LICENSE_PATH." + </info> + <glossdef> + <para role="glossdeffirst"> + + List of licenses found in the directories specified + by <link linkend='var-COMMON_LICENSE_DIR'><filename>COMMON_LICENSE_DIR</filename></link> + and <link linkend='var-LICENSE_PATH'><filename>LICENSE_PATH</filename></link>. + + <note> + It is assumed that all changes + to <filename>COMMON_LICENSE_DIR</filename> + and <filename>LICENSE_PATH</filename> have been done + before <filename>AVAILABLE_LICENSES</filename> is + defined + (in <link linkend='ref-classes-license'>license.bbclass</link>). + </note> + </para> + </glossdef> + </glossentry> + <glossentry id='var-AVAILTUNES'><glossterm>AVAILTUNES</glossterm> <info> AVAILTUNES[doc] = "The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system. @@ -536,7 +542,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory within the <link linkend='build-directory'>Build Directory</link> in which the OpenEmbedded build system places generated @@ -566,7 +571,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists "recommended-only" packages to not install. Recommended-only packages are packages installed only through the @@ -621,7 +625,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The library directory name for the CPU or Application Binary Interface (ABI) tune. The <filename>BASE_LIB</filename> applies only in the @@ -647,7 +650,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the base of the work directory for all recipes. The default value is "${TMPDIR}/work". </para> @@ -727,7 +729,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines how BitBake handles situations where an append file (<filename>.bbappend</filename>) has no corresponding recipe file (<filename>.bb</filename>). @@ -765,7 +766,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Monitors disk space and available inodes during the build and allows you to control the build based on these parameters. @@ -863,7 +863,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the disk space and free inode warning intervals. To set these intervals, define the variable in your <filename>conf/local.conf</filename> file in the @@ -931,20 +930,20 @@ <glossentry id='var-BB_GENERATE_MIRROR_TARBALLS'><glossterm>BB_GENERATE_MIRROR_TARBALLS</glossterm> <info> - BB_GENERATE_MIRROR_TARBALLS[doc] = "Causes tarballs of the Git repositories to be placed in the DL_DIR directory." + BB_GENERATE_MIRROR_TARBALLS[doc] = "Causes tarballs of the source control repositories to be placed in the DL_DIR directory." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - Causes tarballs of the Git repositories, including the - Git metadata, to be placed in the + Causes tarballs of the source control repositories + (e.g. Git repositories), including metadata, to be placed + in the <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> directory. </para> <para> For performance reasons, creating and placing tarballs of - the Git repositories is not the default action by the + these repositories is not the default action by the OpenEmbedded build system. <literallayout class='monospaced'> BB_GENERATE_MIRROR_TARBALLS = "1" @@ -953,6 +952,13 @@ file in the <link linkend='build-directory'>Build Directory</link>. </para> + + <para> + Once you have the tarballs containing your source files, + you can clean up your <filename>DL_DIR</filename> + directory by deleting any Git or other source control + work directories. + </para> </glossdef> </glossentry> @@ -962,7 +968,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The maximum number of tasks BitBake should run in parallel at any one time. The OpenEmbedded build system automatically configures @@ -998,7 +1003,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the time (in seconds) after which to unload the BitBake server due to inactivity. Set <filename>BB_SERVER_TIMEOUT</filename> to determine how @@ -1024,7 +1028,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Allows you to extend a recipe so that it builds variants of the software. Common variants for recipes exist such as "natives" like <filename>quilt-native</filename>, which is a copy of Quilt built to run on the build system; @@ -1075,7 +1078,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists the names of configured layers. These names are used to find the other <filename>BBFILE_*</filename> variables. @@ -1091,7 +1093,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Variable that expands to match files from <link linkend='var-BBFILES'><filename>BBFILES</filename></link> in a particular layer. @@ -1108,7 +1109,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Assigns the priority for recipe files in each layer. </para> @@ -1151,7 +1151,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of recipe files BitBake uses to build software. </para> @@ -1173,7 +1172,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Activates content when identified layers are present. You identify the layers by the collections that the layers define. @@ -1220,7 +1218,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Variable that controls how BitBake displays logs on build failure. </para> </glossdef> @@ -1232,7 +1229,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If <link linkend='var-BBINCLUDELOGS'><filename>BBINCLUDELOGS</filename></link> is set, specifies the maximum number of lines from the @@ -1249,7 +1245,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists the layers to enable during the build. This variable is defined in the <filename>bblayers.conf</filename> configuration file in the @@ -1278,7 +1273,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Prevents BitBake from processing recipes and recipe append files. </para> @@ -1336,13 +1330,12 @@ <glossentry id='var-BBMULTICONFIG'><glossterm>BBMULTICONFIG</glossterm> <info> - BBMULTICONFIG[doc] = "Specifies each separate configuration when you are building targets with multiple configurations." + BBMULTICONFIG[doc] = "Specifies each additional separate configuration when you are building targets with multiple configurations." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - Specifies each separate configuration when you are - building targets with multiple configurations. + Specifies each additional separate configuration when you + are building targets with multiple configurations. Use this variable in your <filename>conf/local.conf</filename> configuration file. Specify a <replaceable>multiconfigname</replaceable> for @@ -1376,7 +1369,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used by BitBake to locate <filename>.bbclass</filename> and configuration files. This variable is analogous to the @@ -1405,7 +1397,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If defined in the BitBake environment, <filename>BBSERVER</filename> points to the BitBake remote server. @@ -1415,7 +1406,7 @@ Use the following format to export the variable to the BitBake environment: <literallayout class='monospaced'> - export BBSERVER=localhost:$port" + export BBSERVER=localhost:$port </literallayout> </para> @@ -1434,7 +1425,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-binconfig-disabled'><filename>binconfig-disabled</filename></link> class, this variable specifies binary configuration @@ -1462,7 +1452,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link> class, this variable specifies a wildcard for @@ -1501,7 +1490,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base recipe name and version but without any special recipe name suffix (i.e. <filename>-native</filename>, <filename>lib64-</filename>, and so forth). @@ -1519,7 +1507,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable is a version of the <link linkend='var-PN'><filename>PN</filename></link> variable with common prefixes and suffixes @@ -1544,7 +1531,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a URL for an upstream bug tracking website for a recipe. The OpenEmbedded build system does not use this variable. @@ -1560,7 +1546,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the architecture of the build host (e.g. <filename>i686</filename>). The OpenEmbedded build system sets the value of @@ -1576,7 +1561,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the architecture-specific assembler flags for the build host. By default, the value of <filename>BUILD_AS_ARCH</filename> is empty. @@ -1590,7 +1574,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the architecture-specific C compiler flags for the build host. By default, the value of <filename>BUILD_CC_ARCH</filename> is empty. @@ -1604,7 +1587,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the linker command to be used for the build host when the C compiler is being used as the linker. By default, <filename>BUILD_CCLD</filename> points to GCC and passes as @@ -1621,7 +1603,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C compiler when building for the build host. When building in the <filename>-native</filename> context, @@ -1637,7 +1618,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C preprocessor (i.e. to both the C and the C++ compilers) when building for the build host. @@ -1654,7 +1634,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C++ compiler when building for the build host. When building in the <filename>-native</filename> context, @@ -1670,7 +1649,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the Fortran compiler command for the build host. By default, <filename>BUILD_FC</filename> points to Gfortran and passes as arguments the value of @@ -1686,7 +1664,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the linker command for the build host. By default, <filename>BUILD_LD</filename> points to the GNU linker (ld) and passes as arguments the value of @@ -1702,7 +1679,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific linker flags for the build host. By default, the value of <filename>BUILD_LD_ARCH</filename> is empty. @@ -1716,7 +1692,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the linker when building for the build host. When building in the <filename>-native</filename> context, @@ -1732,7 +1707,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the optimization flags passed to the C compiler when building for the build host or the SDK. The flags are passed through the @@ -1756,7 +1730,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the operating system in use on the build host (e.g. "linux"). The OpenEmbedded build system sets the value of @@ -1773,7 +1746,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The toolchain binary prefix used for native recipes. The OpenEmbedded build system uses the <filename>BUILD_PREFIX</filename> value to set the @@ -1789,7 +1761,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the command to be used to strip debugging symbols from binaries produced for the build host. By default, <filename>BUILD_STRIP</filename> points to @@ -1804,7 +1775,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the system, including the architecture and the operating system, to use when building for the build host (i.e. when building <filename>native</filename> @@ -1830,7 +1800,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the vendor name to use when building for the build host. The default value is an empty string (""). @@ -1844,7 +1813,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the location of the <link linkend='build-directory'>Build Directory</link>. You can define this directory indirectly through the @@ -1864,7 +1832,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable specifies whether or not to commit the @@ -1896,7 +1863,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable specifies the author to use for each @@ -1931,7 +1897,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable specifies the directory in which @@ -1956,7 +1921,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable specifies the build history features @@ -2009,7 +1973,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable specifies a list of paths to files @@ -2042,7 +2005,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> class, this variable optionally specifies a remote @@ -2077,7 +2039,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C compiler when building for the SDK. When building in the <filename>nativesdk-</filename> @@ -2094,7 +2055,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the SDK. @@ -2112,7 +2072,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C++ compiler when building for the SDK. When building in the <filename>nativesdk-</filename> @@ -2129,7 +2088,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the linker when building for the SDK. When building in the <filename>nativesdk-</filename> @@ -2146,7 +2104,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the location of the directory that holds build statistics when you use and enable the <link linkend='ref-classes-buildstats'><filename>buildstats</filename></link> @@ -2164,7 +2121,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For the BusyBox recipe, specifies whether to split the output executable file into two parts: one for features that require <filename>setuid root</filename>, and one for @@ -2174,9 +2130,10 @@ <para> The <filename>BUSYBOX_SPLIT_SUID</filename> variable - defaults to "1", which results in a single output + defaults to "1", which results in splitting the output executable file. - Set the variable to "0" to split the output file. + Set the variable to "0" to get a single output executable + file. </para> </glossdef> </glossentry> @@ -2191,7 +2148,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the directory BitBake uses to store a cache of the <link linkend='metadata'>Metadata</link> @@ -2207,7 +2163,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments used to run the C compiler. </para> @@ -2220,7 +2175,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C compiler. This variable is exported to an environment variable and thus made visible to the software being @@ -2256,7 +2210,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An internal variable specifying the special class override that should currently apply (e.g. "class-target", "class-native", and so forth). @@ -2300,7 +2253,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set to "1" within a recipe, <filename>CLEANBROKEN</filename> specifies that the <filename>make clean</filename> command does @@ -2319,7 +2271,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Provides a list of hardware features that are enabled in both <link linkend='var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></link> @@ -2342,7 +2293,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to <filename>meta/files/common-licenses</filename> in the <link linkend='source-directory'>Source Directory</link>, @@ -2357,7 +2307,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A regular expression that resolves to one or more hosts (when the recipe is native) or one or more targets (when the recipe is non-native) with which a recipe is compatible. @@ -2380,7 +2329,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A regular expression that resolves to one or more target machines with which a recipe is compatible. The regular expression is matched against @@ -2401,7 +2349,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines wildcards to match when installing a list of complementary packages for all the packages explicitly (or implicitly) installed in an image. @@ -2440,7 +2387,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Stores sysroot components for each recipe. The OpenEmbedded build system uses <filename>COMPONENTS_DIR</filename> when constructing @@ -2461,7 +2407,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Tracks the version of the local configuration file (i.e. <filename>local.conf</filename>). The value for <filename>CONF_VERSION</filename> @@ -2477,7 +2422,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Identifies editable or configurable files that are part of a package. If the Package Management System (PMS) is being used to update packages on the target system, it is possible that @@ -2531,7 +2475,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Identifies the initial RAM filesystem (initramfs) source files. The OpenEmbedded build system receives and uses @@ -2574,7 +2517,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of files that contains <filename>autoconf</filename> test results relevant to the current build. This variable is used by the Autotools utilities when running @@ -2589,7 +2531,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal arguments for GNU configure. </para> </glossdef> @@ -2601,7 +2542,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link> class, this @@ -2624,7 +2564,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of licenses to exclude from the source archived by the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> @@ -2656,7 +2595,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of licenses to include in the source archived by the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> @@ -2684,7 +2622,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recipes to exclude in the source archived by the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> @@ -2716,7 +2653,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recipes to include in the source archived by the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> @@ -2748,7 +2684,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of recipe types to include in the source archived by the <link linkend='ref-classes-archiver'><filename>archiver</filename></link> @@ -2778,7 +2713,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set to "1" along with the <link linkend='var-COPY_LIC_MANIFEST'><filename>COPY_LIC_MANIFEST</filename></link> variable, the OpenEmbedded build system copies @@ -2810,7 +2744,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set to "1", the OpenEmbedded build system copies the license manifest for the image to <filename>/usr/share/common-licenses/license.manifest</filename> @@ -2838,7 +2771,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the list of packages to be added to the image. You should only set this variable in the <filename>local.conf</filename> configuration file found @@ -2858,7 +2790,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the parent directory of the OpenEmbedded-Core Metadata layer (i.e. <filename>meta</filename>). </para> @@ -2884,7 +2815,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists files from the <link linkend='var-COREBASE'><filename>COREBASE</filename></link> directory that should be copied other than the layers @@ -2913,7 +2843,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments used to run the C preprocessor. </para> @@ -2926,7 +2855,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers). This variable is exported to an environment @@ -2963,7 +2891,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The toolchain binary prefix for the target tools. The <filename>CROSS_COMPILE</filename> variable is the same as the @@ -2985,7 +2912,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory in which files checked out under the CVS system are stored. </para> @@ -2998,7 +2924,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments used to run the C++ compiler. </para> @@ -3011,7 +2936,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C++ compiler. This variable is exported to an environment variable and thus made visible to the software being @@ -3051,7 +2975,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The destination directory. The location in the <link linkend='build-directory'>Build Directory</link> @@ -3077,7 +3000,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The date the build was started. Dates appear using the year, month, and day (YMD) format (e.g. "20150209" for February 9th, 2015). @@ -3091,7 +3013,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The date and time on which the current build started. The format is suitable for timestamps. </para> @@ -3104,7 +3025,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When the <link linkend='ref-classes-debian'><filename>debian</filename></link> class is inherited, which is the default behavior, @@ -3128,7 +3048,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When the <link linkend='ref-classes-debian'><filename>debian</filename></link> class is inherited, which is the default behavior, @@ -3152,7 +3071,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies to build packages with debugging information. This influences the value of the <filename><link linkend='var-SELECTED_OPTIMIZATION'>SELECTED_OPTIMIZATION</link></filename> @@ -3167,7 +3085,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The options to pass in <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> when compiling @@ -3183,7 +3100,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a weak bias for recipe selection priority. </para> @@ -3213,7 +3129,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system. @@ -3238,7 +3153,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists a recipe's build-time dependencies. These are dependencies on other recipes whose contents (e.g. headers and shared libraries) are needed @@ -3361,7 +3275,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the general area that the OpenEmbedded build system uses to place images, packages, SDKs, and other output files that are ready to be used outside of the build system. @@ -3393,7 +3306,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the area that the OpenEmbedded build system uses to place Debian packages that are ready to be used outside of the build system. @@ -3433,7 +3345,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the area that the OpenEmbedded build system uses to place images and other associated output files that are ready to be deployed onto the target machine. @@ -3466,7 +3377,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the area that the OpenEmbedded build system uses to place IPK packages that are ready to be used outside of the build system. @@ -3505,7 +3415,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the area that the OpenEmbedded build system uses to place RPM packages that are ready to be used outside of the build system. @@ -3544,7 +3453,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the area that the OpenEmbedded build system uses to place tarballs that are ready to be used outside of the build system. @@ -3583,7 +3491,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-deploy'><filename>deploy</filename></link> class, the <filename>DEPLOYDIR</filename> points to a @@ -3611,7 +3518,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The package description used by package managers. If not set, <filename>DESCRIPTION</filename> takes the value of the @@ -3621,67 +3527,12 @@ </glossdef> </glossentry> - <glossentry id='var-DISK_SIGNATURE'><glossterm>DISK_SIGNATURE</glossterm> - <info> - DISK_SIGNATURE[doc] = "A 32-bit MBR disk signature used by directdisk images." - </info> - <glossdef> - <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - A 32-bit MBR disk signature used by - <filename>directdisk</filename> images. - </para> - - <para> - By default, the signature is set to an automatically - generated random value that allows the OpenEmbedded - build system to create a boot loader. - You can override the signature in the image recipe - by setting <filename>DISK_SIGNATURE</filename> to an - 8-digit hex string. - You might want to override - <filename>DISK_SIGNATURE</filename> if you want the disk - signature to remain constant between image builds. - </para> - - <para> - When using Linux 3.8 or later, you can use - <filename>DISK_SIGNATURE</filename> to specify the root - by UUID to allow the kernel to locate the root device - even if the device name changes due to differences in - hardware configuration. - By default, <filename>ROOT_VM</filename> is set - as follows: - <literallayout class='monospaced'> - ROOT_VM ?= "root=/dev/sda2" - </literallayout> - However, you can change this to locate the root device - using the disk signature instead: - <literallayout class='monospaced'> - ROOT_VM = "root=PARTUUID=${DISK_SIGNATURE}-02" - </literallayout> - </para> - - <para> - As previously mentioned, it is possible to set the - <filename>DISK_SIGNATURE</filename> variable in your - <filename>local.conf</filename> file to a fixed - value if you do not want <filename>syslinux.cfg</filename> - changing for each build. - You might find this useful when you want to upgrade the - root filesystem on a device without having to recreate or - modify the master boot record. - </para> - </glossdef> - </glossentry> - <glossentry id='var-DISTRO'><glossterm>DISTRO</glossterm> <info> DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The short name of the distribution. For information on the long name of the distribution, see the @@ -3734,7 +3585,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a codename for the distribution being built. </para> </glossdef> @@ -3746,7 +3596,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of distro-specific packages to add to all images. This variable takes affect through <filename>packagegroup-base</filename> so the @@ -3766,7 +3615,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of distro-specific packages to add to all images if the packages exist. The packages might not exist or be empty (e.g. kernel modules). @@ -3782,7 +3630,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The software support you want in your distribution for various features. You define your distribution features in the distribution @@ -3819,7 +3666,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Features to be added to <filename><link linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></filename> if not also present in @@ -3831,7 +3677,7 @@ It is not intended to be user-configurable. It is best to just reference the variable to see which distro features are being backfilled for all distro configurations. - See the <link linkend='ref-features-backfill'>Feature Backfilling</link> section for + See the "<link linkend='ref-features-backfill'>Feature Backfilling</link>" section for more information. </para> </glossdef> @@ -3843,7 +3689,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Features from <filename><link linkend='var-DISTRO_FEATURES_BACKFILL'>DISTRO_FEATURES_BACKFILL</link></filename> that should not be backfilled (i.e. added to @@ -3861,7 +3706,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A convenience variable that gives you the default list of distro features with the exception of any features specific to the C library @@ -3877,7 +3721,7 @@ <filename>DISTRO_FEATURES_DEFAULT</filename> from a custom distro configuration file: <literallayout class='monospaced'> - DISTRO_FEATURES ?= "${DISTRO_FEATURES_DEFAULT} ${DISTRO_FEATURES_LIBC} myfeature" + DISTRO_FEATURES ?= "${DISTRO_FEATURES_DEFAULT} myfeature" </literallayout> </para> </glossdef> @@ -3889,7 +3733,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of features that if present in the target <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link> @@ -3910,7 +3753,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of features that if present in the target <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link> value should be included in @@ -3924,13 +3766,13 @@ </glossdef> </glossentry> +<!-- <glossentry id='var-DISTRO_FEATURES_LIBC'><glossterm>DISTRO_FEATURES_LIBC</glossterm> <info> DISTRO_FEATURES_LIBC[doc] = "Specifies the list of distro features that are specific to the C library (libc)." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A convenience variable that specifies the list of distro features that are specific to the C library (<filename>libc</filename>). @@ -3940,6 +3782,7 @@ </para> </glossdef> </glossentry> +--> <glossentry id='var-DISTRO_FEATURES_NATIVE'><glossterm>DISTRO_FEATURES_NATIVE</glossterm> <info> @@ -3947,7 +3790,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of features that should be included in <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link> when building native recipes. @@ -3965,7 +3807,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of features that should be included in <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link> when building nativesdk recipes. @@ -3983,7 +3824,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The long name of the distribution. For information on the short name of the distribution, see the @@ -4035,7 +3875,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The version of the distribution. </para> </glossdef> @@ -4047,7 +3886,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A colon-separated list of overrides specific to the current distribution. By default, this list includes the value of @@ -4075,7 +3913,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The central download directory used by the build process to store downloads. By default, <filename>DL_DIR</filename> gets files @@ -4138,7 +3975,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-compress_doc'><filename>compress_doc</filename></link> class, this variable sets the compression policy used when @@ -4166,7 +4002,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When building bootable images (i.e. where <filename>hddimg</filename>, <filename>iso</filename>, or <filename>wic.vmdk</filename> is in @@ -4193,7 +4028,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Variable that controls which locales for <filename>glibc</filename> are generated during the build (useful if the target device has 64Mbytes @@ -4208,7 +4042,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used with the <link linkend='ref-classes-report-error'><filename>report-error</filename></link> class, specifies the path used for storing the debug files @@ -4237,7 +4070,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the quality assurance checks whose failures are reported as errors by the OpenEmbedded build system. You set this variable in your distribution configuration @@ -4256,7 +4088,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Triggers the OpenEmbedded build system's shared libraries resolver to exclude an entire package when scanning for shared libraries. @@ -4295,7 +4126,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Directs BitBake to exclude a recipe from world builds (i.e. <filename>bitbake world</filename>). During world builds, BitBake locates, parses and builds all @@ -4325,7 +4155,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used with file and pathnames to create a prefix for a recipe's version based on the recipe's <link linkend='var-PE'><filename>PE</filename></link> value. @@ -4347,7 +4176,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The full package version specification as it appears on the final packages produced by a recipe. The variable's value is normally used to fix a runtime @@ -4372,7 +4200,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When set, the <filename>EXTERNAL_KERNEL_TOOLS</filename> variable indicates that these tools are not in the source tree. @@ -4398,7 +4225,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link> class, this variable points to the source tree, which is @@ -4428,7 +4254,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link> class, this variable points to the directory in which the @@ -4459,7 +4284,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For recipes inheriting the <link linkend='ref-classes-autotools'><filename>autotools</filename></link> class, you can use <filename>EXTRA_AUTORECONF</filename> to @@ -4482,7 +4306,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of additional features to include in an image. When listing more than one feature, separate them with a space. @@ -4563,7 +4386,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies additional options for the image creation command that has been specified in <link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>. @@ -4583,7 +4405,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recipes to build that do not provide packages for installing into the root filesystem. </para> @@ -4611,7 +4432,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of subdirectories of <filename>${</filename><link linkend='var-STAGING_BINDIR_NATIVE'><filename>STAGING_BINDIR_NATIVE</filename></link><filename>}</filename> added to the beginning of the environment variable @@ -4632,7 +4452,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Additional <ulink url='https://cmake.org/overview/'>CMake</ulink> options. @@ -4649,7 +4468,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Additional <filename>configure</filename> script options. See <link linkend='var-PACKAGECONFIG_CONFARGS'><filename>PACKAGECONFIG_CONFARGS</filename></link> @@ -4665,7 +4483,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Additional GNU <filename>make</filename> options. </para> @@ -4692,7 +4509,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-scons'><filename>scons</filename></link> class, this variable specifies additional configuration @@ -4708,7 +4524,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-extrausers'><filename>extrausers</filename></link> class, this variable provides image level user and group @@ -4750,7 +4565,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines one or more packages to include in an image when a specific item is included in <link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>. @@ -4785,7 +4599,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the base URL of the server and location within the document-root that provides the metadata and packages required by OPKG to support runtime package @@ -4816,7 +4629,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of files and directories that are placed in a package. The @@ -4887,7 +4699,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the file specification to match <link linkend='var-SOLIBSDEV'><filename>SOLIBSDEV</filename></link>. In other words, <filename>FILES_SOLIBSDEV</filename> @@ -4911,7 +4722,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extends the search path the OpenEmbedded build system uses when looking for files and patches as it processes recipes and append files. @@ -5008,13 +4818,20 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A subset of <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> used by the OpenEmbedded build system for creating <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>. - You can find more information on how overrides are handled - in the - <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>. + The <filename>FILESOVERRIDES</filename> variable uses + overrides to automatically extend the + <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> + variable. + For an example of how that works, see the + <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> + variable description. + Additionally, you find more information on how overrides + are handled in the + "<ulink url='&YOCTO_DOCS_BB_URL;#conditional-syntax-overrides'>Conditional Syntax (Overrides)</ulink>" + section of the BitBake User Manual. </para> <para> @@ -5040,12 +4857,14 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - The default set of directories the OpenEmbedded build system - uses when searching for patches and files. - During the build process, BitBake searches each directory in - <filename>FILESPATH</filename> in the specified order when - looking for files and patches specified by each + The default set of directories the OpenEmbedded build + system uses when searching for patches and files. + </para> + + <para> + During the build process, BitBake searches each directory + in <filename>FILESPATH</filename> in the specified order + when looking for files and patches specified by each <filename>file://</filename> URI in a recipe's <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> statements. @@ -5060,23 +4879,62 @@ FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", \ "${FILE_DIRNAME}/${BPN}", "${FILE_DIRNAME}/files"], d)}" </literallayout> - <note> - Do not hand-edit the <filename>FILESPATH</filename> - variable. - If you want the build system to look in directories - other than the defaults, extend the - <filename>FILESPATH</filename> variable by using the - <link linkend='var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></link> - variable. + The <filename>FILESPATH</filename> variable is automatically + extended using the overrides from the + <link linkend='var-FILESOVERRIDES'><filename>FILESOVERRIDES</filename></link> + variable. + <note><title>Notes</title> + <itemizedlist> + <listitem><para> + Do not hand-edit the + <filename>FILESPATH</filename> variable. + If you want the build system to look in + directories other than the defaults, extend the + <filename>FILESPATH</filename> variable by + using the + <link linkend='var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></link> + variable. + </para></listitem> + <listitem><para> + Be aware that the default + <filename>FILESPATH</filename> directories do + not map to directories in custom layers + where append files + (<filename>.bbappend</filename>) are used. + If you want the build system to find patches + or files that reside with your append files, + you need to extend the + <filename>FILESPATH</filename> variable by + using the <filename>FILESEXTRAPATHS</filename> + variable. + </para></listitem> + </itemizedlist> </note> - Be aware that the default <filename>FILESPATH</filename> - directories do not map to directories in custom layers - where append files (<filename>.bbappend</filename>) - are used. - If you want the build system to find patches or files - that reside with your append files, you need to extend - the <filename>FILESPATH</filename> variable by using - the <filename>FILESEXTRAPATHS</filename> variable. + </para> + + <para> + You can take advantage of this searching behavior in + useful ways. + For example, consider a case where the following + directory structure exists for general and machine-specific + configurations: + <literallayout class='monospaced'> + files/defconfig + files/MACHINEA/defconfig + files/MACHINEB/defconfig + </literallayout> + Also in the example, the <filename>SRC_URI</filename> + statement contains "file://defconfig". + Given this scenario, you can set + <link linkend='var-MACHINE'><filename>MACHINE</filename></link> + to "MACHINEA" and cause the build system to use files + from <filename>files/MACHINEA</filename>. + Set <filename>MACHINE</filename> to "MACHINEB" and the + build system uses files from + <filename>files/MACHINEB</filename>. + Finally, for any machine other than "MACHINEA" and + "MACHINEB", the build system uses files from + <filename>files/defconfig</filename>. </para> <para> @@ -5099,7 +4957,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Allows you to define your own file permissions settings table as part of your configuration for the packaging process. For example, suppose you need a consistent set of custom permissions for @@ -5139,7 +4996,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link> class, this variable specifies the runtime dependencies @@ -5156,7 +5012,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link> class, this variable identifies packages containing font @@ -5176,7 +5031,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Forces the removal of the packages listed in <filename>ROOTFS_RO_UNNEEDED</filename> during the generation of the root filesystem. @@ -5195,7 +5049,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The options to pass in <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> @@ -5215,7 +5068,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Enables Position Independent Executables (PIE) within the GNU C Compiler (GCC). Enabling PIE in the GCC makes Return Oriented Programming @@ -5239,7 +5091,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the default version of the GNU C Compiler (GCC) used for compilation. By default, <filename>GCCVERSION</filename> is set to @@ -5261,7 +5112,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run the GNU Debugger. </para> </glossdef> @@ -5273,7 +5123,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory in which a local copy of a Git repository is stored when it is cloned. </para> @@ -5286,7 +5135,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the list of GLIBC locales to generate should you not wish to generate all LIBC locals, which can be time consuming. @@ -5315,7 +5163,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-useradd'><filename>useradd</filename></link> class, this variable @@ -5344,7 +5191,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-useradd'><filename>useradd</filename></link> class, this variable @@ -5368,7 +5214,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Configures the GNU GRand Unified Bootloader (GRUB) to have graphics and serial in the boot menu. Set this variable to "1" in your @@ -5391,7 +5236,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Additional options to add to the GNU GRand Unified Bootloader (GRUB) configuration. Use a semi-colon character (<filename>;</filename>) to @@ -5413,7 +5257,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the timeout before executing the default <filename>LABEL</filename> in the GNU GRand Unified Bootloader (GRUB). @@ -5434,7 +5277,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-gtk-immodules-cache'><filename>gtk-immodules-cache</filename></link> class, this variable specifies the packages that contain the @@ -5454,7 +5296,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Website where more information about the software the recipe is building can be found. </para> @@ -5468,7 +5309,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The name of the target architecture, which is normally the same as <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>. @@ -5496,7 +5336,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific compiler flags that are passed to the C compiler. </para> @@ -5530,7 +5369,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the target operating system, which is normally the same as the <link linkend='var-TARGET_OS'><filename>TARGET_OS</filename></link>. @@ -5548,7 +5386,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the prefix for the cross-compile toolchain. <filename>HOST_PREFIX</filename> is normally the same as <link linkend='var-TARGET_PREFIX'><filename>TARGET_PREFIX</filename></link>. @@ -5562,7 +5399,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the system, including the architecture and the operating system, for which the build is occurring in the context of the current recipe. @@ -5603,7 +5439,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks. Using this filter helps reduce the possibility of host @@ -5627,7 +5462,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks. Using this filter helps reduce the possibility of host @@ -5650,7 +5484,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the vendor. <filename>HOST_VENDOR</filename> is normally the same as <link linkend='var-TARGET_VENDOR'><filename>TARGET_VENDOR</filename></link>. @@ -5668,7 +5501,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Disables or enables the <filename>icecc</filename> (Icecream) function. For more information on this function and best practices @@ -5697,7 +5529,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the <filename>icecc-create-env</filename> script that you provide. This variable is used by the @@ -5723,7 +5554,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extra options passed to the <filename>make</filename> command during the <link linkend='ref-tasks-compile'><filename>do_compile</filename></link> @@ -5769,7 +5599,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location of the <filename>icecc</filename> binary. You can set this variable in your <filename>local.conf</filename> file. @@ -5788,7 +5617,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Identifies user classes that you do not want the Icecream distributed compile support to consider. This variable is used by the @@ -5814,7 +5642,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Identifies user recipes that you do not want the Icecream distributed compile support to consider. This variable is used by the @@ -5840,7 +5667,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Identifies user recipes that use an empty <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link> variable that you want to force remote distributed @@ -5861,7 +5687,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of image output files. This variable defaults to the recipe name (<filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>). @@ -5875,7 +5700,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of files installed into the boot partition when preparing an image using the Wic tool with the <filename>bootimg-partition</filename> source @@ -5932,7 +5756,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of classes that all images should inherit. You typically use this variable to specify the list of classes that register the different types of images @@ -5961,7 +5784,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the command to create the image file for a specific image type, which corresponds to the value set set in @@ -5995,7 +5817,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies one or more files that contain custom device tables that are passed to the <filename>makedevs</filename> command as part of creating @@ -6019,7 +5840,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The primary list of features to include in an image. Typically, you configure this variable in an image recipe. Although you can use this variable from your @@ -6055,7 +5875,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the formats the OpenEmbedded build system uses during the build when creating the root filesystem. For example, setting <filename>IMAGE_FSTYPES</filename> @@ -6076,11 +5895,12 @@ <note><title>Notes</title> <itemizedlist> <listitem><para> - If you add "live" to - <filename>IMAGE_FSTYPES</filename> inside an image - recipe, be sure that you do so prior to the - "inherit image" line of the recipe or the live - image will not build. + If an image recipe uses the "inherit image" line + and you are setting + <filename>IMAGE_FSTYPES</filename> inside the + recipe, you must set + <filename>IMAGE_FSTYPES</filename> prior to + using the "inherit image" line. </para></listitem> <listitem><para> Due to the way the OpenEmbedded build system @@ -6102,7 +5922,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Used by recipes to specify the packages to install into an image through the <link linkend='ref-classes-image'><filename>image</filename></link> @@ -6188,7 +6007,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the list of locales to install into the image during the root filesystem construction process. The OpenEmbedded build system automatically splits locale @@ -6230,7 +6048,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The manifest file for the image. This file lists all the installed packages that make up the image. @@ -6267,7 +6084,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The name of the output image files minus the extension. This variable is derived using the <link linkend='var-IMAGE_BASENAME'><filename>IMAGE_BASENAME</filename></link>, @@ -6288,7 +6104,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines a multiplier that the build system applies to the initial image size for cases when the multiplier times the returned disk usage value for the image is greater than the sum of @@ -6334,7 +6149,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the package type (i.e. DEB, RPM, IPK, or TAR) used by the OpenEmbedded build system. The variable is defined appropriately by the @@ -6386,7 +6200,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call once the OpenEmbedded build system creates the final image output files. @@ -6414,7 +6227,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call before the OpenEmbedded build system creates the final image output files. @@ -6442,7 +6254,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location of the root filesystem while it is under construction (i.e. during the <link linkend='ref-tasks-rootfs'><filename>do_rootfs</filename></link> @@ -6459,7 +6270,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the alignment for the output image file in Kbytes. If the size of the image is not a multiple of @@ -6479,7 +6289,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines additional free disk space created in the image in Kbytes. By default, this variable is set to "0". This free disk space is added to the image after the build system determines @@ -6514,7 +6323,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the size in Kbytes for the generated image. The OpenEmbedded build system determines the final size for the generated image using an algorithm that takes into account the initial disk space used @@ -6564,7 +6372,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a dependency from one image type on another. Here is an example from the <link linkend='ref-classes-image-live'><filename>image-live</filename></link> @@ -6594,18 +6401,17 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the complete list of supported image types by default: <literallayout class='monospaced'> btrfs + container cpio cpio.gz cpio.lz4 cpio.lzma cpio.xz cramfs - elf ext2 ext2.bz2 ext2.gz @@ -6614,13 +6420,14 @@ ext3.gz ext4 ext4.gz - hdddirect + f2fs hddimg iso jffs2 jffs2.sum multiubi squashfs + squashfs-lz4 squashfs-lzo squashfs-xz tar @@ -6628,6 +6435,7 @@ tar.gz tar.lz4 tar.xz + tar.zst ubi ubifs wic @@ -6652,7 +6460,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Helps define the recipe revision for recipes that share a common <filename>include</filename> file. You can think of this variable as part of the recipe revision @@ -6718,7 +6525,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a space-separated list of license names (as they would appear in <link linkend='var-LICENSE'><filename>LICENSE</filename></link>) @@ -6740,6 +6546,25 @@ components that are required to produce a functional system image. </note> + + <note><title>Tips</title> + It is possible to define a list of licenses that are allowed + to be used instead of the licenses that are excluded. To do + this, define a + variable <filename>COMPATIBLE_LICENSES</filename> with the + names of the licences that are allowed. Then + define <filename>INCOMPATIBLE_LICENSE</filename> as: + <literallayout class='monospaced'> + INCOMPATIBLE_LICENSE = "${@' '.join(sorted(set(d.getVar('AVAILABLE_LICENSES').split()) - set(d.getVar('COMPATIBLE_LICENSES').split())))}" + </literallayout> + This will result + in <filename>INCOMPATIBLE_LICENSE</filename> containing the + names of all licences + from <link linkend='var-AVAILABLE_LICENSES'><filename>AVAILABLE_LICENSES</filename></link> + except the ones specified + in <filename>COMPATIBLE_LICENSES</filename>, thus only + allowing the latter licences to be used. + </note> </glossdef> </glossentry> @@ -6749,7 +6574,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Causes the named class or classes to be inherited globally. Anonymous functions in the class or classes are not executed for the @@ -6773,7 +6597,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists classes that will be inherited at the distribution level. It is unlikely that you want to edit this variable. @@ -6796,7 +6619,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Prevents the default dependencies, namely the C compiler and standard C library (libc), from being added to <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>. @@ -6817,7 +6639,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Prevents the OpenEmbedded build system from splitting out debug information during packaging. By default, the build system splits out debugging @@ -6848,7 +6669,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set to "1", causes the build to not strip binaries in resulting packages and prevents the <filename>-dbg</filename> package from containing the @@ -6866,13 +6686,49 @@ </glossdef> </glossentry> + <glossentry id='var-INHIBIT_SYSROOT_STRIP'><glossterm>INHIBIT_SYSROOT_STRIP</glossterm> + <info> + INHIBIT_SYSROOT_STRIP[doc] = "If set to "1", causes the build to not strip binaries in the resulting sysroot." + </info> + <glossdef> + <para role="glossdeffirst"> + If set to "1", causes the build to not strip binaries in + the resulting sysroot. + </para> + + <para> + By default, the OpenEmbedded build system strips + binaries in the resulting sysroot. + When you specifically set the + <filename>INHIBIT_SYSROOT_STRIP</filename> variable to + "1" in your recipe, you inhibit this stripping. + </para> + + <para> + If you want to use this variable, include the + <link linkend='ref-classes-staging'><filename>staging</filename></link> + class. + This class uses a <filename>sys_strip()</filename> + function to test for the variable and acts accordingly. + <note> + Use of the <filename>INHIBIT_SYSROOT_STRIP</filename> + variable occurs in rare and special circumstances. + For example, suppose you are building bare-metal + firmware by using an external GCC toolchain. + Furthermore, even if the toolchain's binaries are + strippable, other files exist that are needed for the + build that are not strippable. + </note> + </para> + </glossdef> + </glossentry> + <glossentry id='var-INITRAMFS_FSTYPES'><glossterm>INITRAMFS_FSTYPES</glossterm> <info> INITRAMFS_FSTYPES[doc] = "Defines the format for the output image of an initial RAM filesystem (initramfs), which is used during boot." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the format for the output image of an initial RAM filesystem (initramfs), which is used during boot. Supported formats are the same as those supported by the @@ -6901,7 +6757,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link> name of an image recipe that is used to build an initial @@ -6969,7 +6824,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Controls whether or not the image recipe specified by <link linkend='var-INITRAMFS_IMAGE'><filename>INITRAMFS_IMAGE</filename></link> is run through an extra pass @@ -7035,7 +6889,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The link name of the initial RAM filesystem image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7065,7 +6918,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of the initial RAM filesystem image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7090,7 +6942,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Indicates list of filesystem images to concatenate and use as an initial RAM disk (<filename>initrd</filename>). </para> @@ -7110,7 +6961,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When building a "live" bootable image (i.e. when <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link> contains "live"), <filename>INITRD_IMAGE</filename> @@ -7133,7 +6983,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The filename of the initialization script as installed to <filename>${sysconfdir}/init.d</filename>. </para> @@ -7151,7 +7000,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of the packages that contain initscripts. If multiple packages are specified, you need to append the package name to the other <filename>INITSCRIPT_*</filename> as an override. @@ -7171,7 +7019,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the options to pass to <filename>update-rc.d</filename>. Here is an example: <literallayout class='monospaced'> @@ -7209,7 +7056,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the QA checks to skip for a specific package within a recipe. For example, to skip the check for symbolic link @@ -7236,7 +7082,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> By default, the <filename>tzdata</filename> recipe packages an <filename>/etc/timezone</filename> file. Set the <filename>INSTALL_TIMEZONE_FILE</filename> @@ -7252,7 +7097,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When the IPK backend is in use and package management is enabled on the target, you can use this variable to set up <filename>opkg</filename> in the target image @@ -7312,7 +7156,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the kernel architecture used when assembling the configuration. Architectures supported for this release are: @@ -7339,7 +7182,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A regular expression used by the build process to explicitly identify the kernel branch that is validated, patched, and configured during a build. @@ -7380,7 +7222,6 @@ KBRANCH_genericx86-64 = "standard/base" KBRANCH_edgerouter = "standard/edgerouter" KBRANCH_beaglebone = "standard/beaglebone" - KBRANCH_mpc8315e-rdb = "standard/fsl-mpc8315e-rdb" </literallayout> The <filename>KBRANCH</filename> statements identify the kernel branch to use when building for each @@ -7395,7 +7236,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used with the <link linkend='ref-classes-kernel-yocto'><filename>kernel-yocto</filename></link> class, specifies an "in-tree" kernel configuration file @@ -7451,7 +7291,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies an alternate kernel image type for creation in addition to the kernel image type specified using the <link linkend='var-KERNEL_IMAGETYPE'><filename>KERNEL_IMAGETYPE</filename></link> @@ -7466,7 +7305,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of all of the build artifacts. You can change the name of the artifacts by changing the <filename>KERNEL_ARTIFACT_NAME</filename> variable. @@ -7505,7 +7343,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of classes defining kernel image types that the <link linkend='ref-classes-kernel'><filename>kernel</filename></link> class should inherit. @@ -7526,7 +7363,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the generated Linux kernel device tree (i.e. the <filename>.dtb</filename>) file. <note> @@ -7535,15 +7371,9 @@ However, providing just the <filename>.dtb</filename> file is preferred. </note> - In order to use this variable, you must have the include - files in your kernel recipe: - <literallayout class='monospaced'> - require recipes-kernel/linux/linux-dtb.inc - </literallayout> - or - <literallayout class='monospaced'> - require recipes-kernel/linux/linux-yocto.inc - </literallayout> + In order to use this variable, the + <link linkend='ref-classes-kernel-devicetree'><filename>kernel-devicetree</filename></link> + class must be inherited. </para> </glossdef> </glossentry> @@ -7554,7 +7384,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The link name of the kernel device tree binary (DTB). This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7584,7 +7413,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of the kernel device tree binary (DTB). This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7609,7 +7437,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies additional <filename>make</filename> command-line arguments the OpenEmbedded build system passes on when compiling the kernel. @@ -7623,7 +7450,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Includes additional kernel metadata. In the OpenEmbedded build system, the default Board Support Packages (BSPs) @@ -7672,7 +7498,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The link name of the kernel flattened image tree (FIT) image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7702,7 +7527,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of the kernel flattened image tree (FIT) image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7727,7 +7551,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The link name for the kernel image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7757,7 +7580,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the maximum size of the kernel image file in kilobytes. If <filename>KERNEL_IMAGE_MAXSIZE</filename> is set, @@ -7788,7 +7610,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of the kernel image. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -7813,7 +7634,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The type of kernel to build for a device, usually set by the machine configuration files and defaults to "zImage". This variable is used @@ -7835,7 +7655,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists kernel modules that need to be auto-loaded during boot. <note> @@ -7889,7 +7708,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Provides a list of modules for which the OpenEmbedded build system expects to find <filename>module_conf_</filename><replaceable>modname</replaceable> @@ -7908,7 +7726,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location of the kernel sources. This variable is set to the value of the <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> @@ -7940,7 +7757,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location of the kernel sources. This variable is set to the value of the <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> @@ -7972,7 +7788,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the version of the kernel as extracted from <filename>version.h</filename> or <filename>utsrelease.h</filename> within the kernel sources. @@ -7990,7 +7805,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies whether the data referenced through <link linkend='var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></link> is needed or not. @@ -8012,7 +7826,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Provides a short description of a configuration fragment. You use this variable in the <filename>.scc</filename> file that describes a configuration fragment file. @@ -8032,7 +7845,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The machine as known by the kernel. Sometimes the machine name used by the kernel does not match the machine name used by the OpenEmbedded build @@ -8079,7 +7891,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the kernel type to be used in assembling the configuration. The linux-yocto recipes define "standard", "tiny", @@ -8109,7 +7920,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Provides a list of targets for automatic configuration. </para> @@ -8127,7 +7937,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists the layers, separated by spaces, on which this recipe depends. Optionally, you can specify a specific layer version for a @@ -8158,7 +7967,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used inside the <filename>layer.conf</filename> configuration file, this variable provides the path of the current layer. This variable is not available outside of <filename>layer.conf</filename> @@ -8173,7 +7981,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists the layers, separated by spaces, recommended for use with this layer. </para> @@ -8206,7 +8013,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists the versions of the <link linkend='oe-core'>OpenEmbedded-Core</link> for which a layer is compatible. @@ -8253,7 +8059,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Optionally specifies the version of a layer as a single number. You can use this within <link linkend='var-LAYERDEPENDS'><filename>LAYERDEPENDS</filename></link> @@ -8272,7 +8077,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments used to run the linker. </para> @@ -8285,7 +8089,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the linker. This variable is exported to an environment variable and thus made visible to the software being @@ -8321,7 +8124,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the lead (or primary) compiled library file (i.e. <filename>.so</filename>) that the <link linkend='ref-classes-debian'><filename>debian</filename></link> @@ -8342,7 +8144,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Checksums of the license text in the recipe source code. </para> @@ -8371,7 +8172,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of source licenses for the recipe. Follow these rules: <itemizedlist> @@ -8436,7 +8236,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Setting <filename>LICENSE_CREATE_PACKAGE</filename> to "1" causes the OpenEmbedded build system to create an extra package (i.e. @@ -8479,7 +8278,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies additional flags for a recipe you must whitelist through <link linkend='var-LICENSE_FLAGS_WHITELIST'><filename>LICENSE_FLAGS_WHITELIST</filename></link> @@ -8507,7 +8305,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists license flags that when specified in <link linkend='var-LICENSE_FLAGS'><filename>LICENSE_FLAGS</filename></link> within a recipe should not prevent that recipe from being @@ -8527,7 +8324,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Path to additional licenses used during the build. By default, the OpenEmbedded build system uses <filename>COMMON_LICENSE_DIR</filename> to define the directory that holds common license text used during the build. @@ -8546,7 +8342,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the kernel type to be used in assembling the configuration. The linux-yocto recipes define "standard", "tiny", and @@ -8579,7 +8374,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The Linux version from <filename>kernel.org</filename> on which the Linux kernel image being built using the OpenEmbedded build system is based. @@ -8610,7 +8404,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A string extension compiled into the version string of the Linux kernel built with the OpenEmbedded build system. @@ -8643,7 +8436,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the directory to which the OpenEmbedded build system writes overall log files. The default directory is <filename>${TMPDIR}/log</filename>. @@ -8667,7 +8459,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the target device for which the image is built. You define <filename>MACHINE</filename> in the <filename>local.conf</filename> file found in the @@ -8704,7 +8495,6 @@ MACHINE ?= "genericx86" MACHINE ?= "genericx86-64" MACHINE ?= "beaglebone" - MACHINE ?= "mpc8315e-rdb" MACHINE ?= "edgerouter" </literallayout> The last five are Yocto Project reference hardware boards, which @@ -8723,7 +8513,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the machine-specific architecture. This variable is set automatically from <link linkend='var-MACHINE'><filename>MACHINE</filename></link> @@ -8741,7 +8530,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of required machine-specific packages to install as part of the image being built. The build process depends on these packages being present. @@ -8778,7 +8566,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recommended machine-specific packages to install as part of the image being built. The build process does not depend on these packages being present. @@ -8842,7 +8629,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of machine-specific packages to install as part of the image being built that are not essential for the machine to boot. However, the build process for more fully-featured images @@ -8888,7 +8674,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of machine-specific packages to install as part of the image being built that are not essential for booting the machine. The image being built has no build dependency on this list of packages. @@ -8933,7 +8718,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the list of hardware features the <link linkend='var-MACHINE'><filename>MACHINE</filename></link> is capable of supporting. @@ -8960,7 +8744,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Features to be added to <filename><link linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></filename> if not also present in @@ -8984,7 +8767,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Features from <filename><link linkend='var-MACHINE_FEATURES_BACKFILL'>MACHINE_FEATURES_BACKFILL</link></filename> that should not be backfilled (i.e. added to @@ -9002,7 +8784,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A colon-separated list of overrides that apply to the current machine. By default, this list includes the value of @@ -9043,7 +8824,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The email address of the distribution maintainer. </para> </glossdef> @@ -9055,7 +8835,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies additional paths from which the OpenEmbedded build system gets source code. When the build system searches for source code, it first @@ -9084,7 +8863,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a prefix has been added to <link linkend='var-PN'><filename>PN</filename></link> to create a special version of a recipe or package (i.e. a Multilib version). @@ -9136,7 +8914,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable has been replaced by the <filename>KERNEL_MODULE_AUTOLOAD</filename> variable. You should replace all occurrences of @@ -9165,7 +8942,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies <ulink url='http://linux.die.net/man/5/modprobe.d'><filename>modprobe.d</filename></ulink> syntax lines for inclusion in the @@ -9226,7 +9002,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Controls creation of the <filename>modules-*.tgz</filename> file. Set this variable to "0" to disable creation of this @@ -9242,7 +9017,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The link name of the kernel module tarball. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -9272,7 +9046,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name of the kernel module tarball. This variable is set in the <filename>meta/classes/kernel-artifact-names.bbclass</filename> @@ -9299,7 +9072,6 @@ <glossdef> <para role="glossdeffirst"> --> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> <!-- Serves the same purpose as <link linkend='var-MULTIMACH_TARGET_SYS'><filename>MULTIMACH_TARGET_SYS</filename></link>, @@ -9326,7 +9098,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Uniquely identifies the type of the target system for which packages are being built. This variable allows output for different types of target @@ -9365,7 +9136,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A string identifying the host distribution. Strings consist of the host distributor ID followed by the release, as reported by the @@ -9395,7 +9165,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run <filename>nm</filename>. </para> @@ -9408,7 +9177,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Avoids QA errors when you use a non-common, non-CLOSED license in a recipe. Packages exist, such as the linux-firmware package, with @@ -9442,7 +9210,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Prevents installation of all "recommended-only" packages. Recommended-only packages are packages installed only through the @@ -9503,7 +9270,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Disables auto package from splitting <filename>.debug</filename> files. If a recipe requires <filename>FILES_${PN}-dbg</filename> to be set manually, @@ -9529,7 +9295,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run <filename>objcopy</filename>. </para> @@ -9542,7 +9307,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run <filename>objdump</filename>. </para> @@ -9555,7 +9319,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link> class, this variable @@ -9589,7 +9352,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An internal variable used to tell the OpenEmbedded build system what Python modules to import for every Python function run by the system. @@ -9608,7 +9370,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The name of the build environment setup script for the purposes of setting up the environment within the extensible SDK. @@ -9630,7 +9391,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Controls how the OpenEmbedded build system spawns interactive terminals on the host development system (e.g. using the BitBake command with the @@ -9662,7 +9422,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory from which the top-level build environment setup script is sourced. The Yocto Project provides a top-level build environment @@ -9686,7 +9445,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Declares the oldest version of the Linux kernel that the produced binaries must support. This variable is passed into the build of the Embedded @@ -9709,7 +9467,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A colon-separated list of overrides that currently apply. Overrides are a BitBake mechanism that allows variables to be selectively overridden at the end of parsing. @@ -9773,7 +9530,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The recipe name and version. <filename>P</filename> is comprised of the following: <literallayout class='monospaced'> @@ -9789,7 +9545,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The architecture of the resulting package or packages. </para> @@ -9825,7 +9580,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of architectures compatible with the target machine. This variable is set automatically and should not @@ -9845,7 +9599,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Enables easily adding packages to <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> before <filename>${<link linkend='var-PN'>PN</link>}</filename> @@ -9861,7 +9614,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable, which is set in the <filename>local.conf</filename> configuration file found in the <filename>conf</filename> folder of the @@ -9911,7 +9663,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Determines how to split up the binary and debug information when creating <filename>*-dbg</filename> packages to be used with the GNU Project Debugger (GDB). @@ -9933,7 +9684,6 @@ <filename>/bin/.debug</filename>. Source files are placed in <filename>/usr/src/debug</filename>. - This is the default behavior. </para></listitem> <listitem><para> "debug-file-directory": Debug symbol files are @@ -9957,6 +9707,7 @@ ".debug" previously described with the exception that all source files are placed in a separate <filename>*-src</filename> pkg. + This is the default behavior. </para></listitem> </itemizedlist> </para> @@ -9976,7 +9727,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Prevents specific packages from being installed when you are installing complementary packages. </para> @@ -10002,7 +9752,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists packages that should not be installed into an image. For example: <literallayout class='monospaced'> @@ -10054,7 +9803,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the list of architectures compatible with the device CPU. This variable is useful when you build for several different devices that use miscellaneous processors such as XScale and ARM926-EJS. @@ -10068,7 +9816,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Optionally specifies the package architectures used as part of the package feed URIs during the build. When used, the <filename>PACKAGE_FEED_ARCHS</filename> @@ -10123,7 +9870,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the base path used when constructing package feed URIs. The <filename>PACKAGE_FEED_BASE_PATHS</filename> variable @@ -10170,7 +9916,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the front portion of the package feed URI used by the OpenEmbedded build system. Each final package feed URI is comprised of @@ -10209,35 +9954,12 @@ </glossdef> </glossentry> - <glossentry id='var-PACKAGE_GROUP'><glossterm>PACKAGE_GROUP</glossterm> - <info> - PACKAGE_GROUP[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES." - </info> - <glossdef> - <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - The <filename>PACKAGE_GROUP</filename> variable has been - renamed to - <link linkend='var-FEATURE_PACKAGES'><filename>FEATURE_PACKAGES</filename></link>. - See the variable description for - <filename>FEATURE_PACKAGES</filename> for information. - </para> - - <para> - If if you use the <filename>PACKAGE_GROUP</filename> - variable, the OpenEmbedded build system issues a warning - message. - </para> - </glossdef> - </glossentry> - <glossentry id='var-PACKAGE_INSTALL'><glossterm>PACKAGE_INSTALL</glossterm> <info> PACKAGE_INSTALL[doc] = "List of the packages to be installed into the image. The variable is generally not user-defined and uses IMAGE_INSTALL as part of the list." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The final list of packages passed to the package manager for installation into the image. </para> @@ -10272,7 +9994,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of packages the OpenEmbedded build system attempts to install when creating an image. If a listed package fails to install, the build system @@ -10288,7 +10009,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions run to pre-process the <link linkend='var-PKGD'><filename>PKGD</filename></link> directory prior to splitting the files out to individual @@ -10303,7 +10023,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of dependencies for post-installation and pre-installation scripts on native/cross tools. If your post-installation or pre-installation script can @@ -10328,18 +10047,25 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable provides a means of enabling or disabling features of a recipe on a per-recipe basis. <filename>PACKAGECONFIG</filename> blocks are defined in recipes when you specify features and then arguments that define feature behaviors. - Here is the basic block structure: + Here is the basic block structure (broken over multiple + lines for readability): <literallayout class='monospaced'> PACKAGECONFIG ??= "f1 f2 f3 ..." - PACKAGECONFIG[f1] = "--with-f1,--without-f1,build-deps-f1,rt-deps-f1,rt-recs-f1" - PACKAGECONFIG[f2] = "--with-f2,--without-f2,build-deps-f2,rt-deps-f2,rt-recs-f2" - PACKAGECONFIG[f3] = "--with-f3,--without-f3,build-deps-f3,rt-deps-f3,rt-recs-f3" + PACKAGECONFIG[f1] = "\ + --with-f1, \ + --without-f1, \ + build-deps-for-f1, \ + runtime-deps-for-f1, \ + runtime-recommends-for-f1, \ + packageconfig-conflicts-for-f1 \ + " + PACKAGECONFIG[f2] = "\ + ... and so on and so on ... </literallayout> </para> @@ -10348,7 +10074,7 @@ variable itself specifies a space-separated list of the features to enable. Following the features, you can determine the behavior of - each feature by providing up to five order-dependent + each feature by providing up to six order-dependent arguments, which are separated by commas. You can omit any argument you like but must retain the separating commas. @@ -10378,6 +10104,10 @@ (<link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>) that should be added if the feature is enabled. </para></listitem> + <listitem><para>Any conflicting (that is, mutually + exclusive) <filename>PACKAGECONFIG</filename> + settings for this feature. + </para></listitem> </orderedlist> </para> @@ -10385,25 +10115,23 @@ Consider the following <filename>PACKAGECONFIG</filename> block taken from the <filename>librsvg</filename> recipe. - In this example the feature is <filename>croco</filename>, + In this example the feature is <filename>gtk</filename>, which has three arguments that determine the feature's behavior. <literallayout class='monospaced'> - PACKAGECONFIG ??= "croco" - PACKAGECONFIG[croco] = "--with-croco,--without-croco,libcroco" + PACKAGECONFIG[gtk] = "--with-gtk3,--without-gtk3,gtk+3" </literallayout> - The <filename>--with-croco</filename> and - <filename>libcroco</filename> arguments apply only if + The <filename>--with-gtk3</filename> and + <filename>gtk+3</filename> arguments apply only if the feature is enabled. - In this case, <filename>--with-croco</filename> is + In this case, <filename>--with-gtk3</filename> is added to the configure script argument list and - <filename>libcroco</filename> is added to + <filename>gtk+3</filename> is added to <filename>DEPENDS</filename>. On the other hand, if the feature is disabled say through a <filename>.bbappend</filename> file in another layer, then - the second argument <filename>--without-croco</filename> is - added to the configure script rather than - <filename>--with-croco</filename>. + the second argument <filename>--without-gtk3</filename> is + added to the configure script instead. </para> <para> @@ -10457,7 +10185,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A space-separated list of configuration options generated from the <link linkend='var-PACKAGECONFIG'><filename>PACKAGECONFIG</filename></link> @@ -10488,7 +10215,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For recipes inheriting the <link linkend='ref-classes-packagegroup'><filename>packagegroup</filename></link> class, setting @@ -10509,7 +10235,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of packages the recipe creates. The default value is the following: <literallayout class='monospaced'> @@ -10550,7 +10275,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A promise that your recipe satisfies runtime dependencies for optional modules that are found in other recipes. <filename>PACKAGES_DYNAMIC</filename> @@ -10593,7 +10317,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions run to perform additional splitting of files into individual packages. Recipes can either prepend to this variable or prepend @@ -10615,7 +10338,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extra options passed to the <filename>make</filename> command during the <link linkend='ref-tasks-compile'><filename>do_compile</filename></link> @@ -10672,7 +10394,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extra options passed to the <filename>make install</filename> command during the <link linkend='ref-tasks-install'><filename>do_install</filename></link> @@ -10709,7 +10430,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Determines the action to take when a patch fails. You can set this variable to one of two values: "noop" and "user". @@ -10737,7 +10457,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the utility used to apply patches for a recipe during the <link linkend='ref-tasks-patch'><filename>do_patch</filename></link> @@ -10768,7 +10487,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The epoch of the recipe. By default, this variable is unset. The variable is used to make upgrades possible when the @@ -10790,7 +10508,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the recipe or package name and includes all version and revision numbers (i.e. <filename>glibc-2.13-r20+svnr15508/</filename> and <filename>bash-4.2-r1/</filename>). @@ -10808,7 +10525,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-pixbufcache'><filename>pixbufcache</filename></link> class, this variable identifies packages that contain @@ -10829,7 +10545,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The name of the resulting package created by the OpenEmbedded build system. <note> @@ -10853,7 +10568,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The path to <filename>pkg-config</filename> files for the current build context. <filename>pkg-config</filename> reads this variable @@ -10868,7 +10582,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the destination directory for files to be packaged before they are split into individual packages. This directory defaults to the following: @@ -10889,7 +10602,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to a shared, global-state directory that holds data generated during the packaging process. During the packaging process, the @@ -10920,7 +10632,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the parent directory for files to be packaged after they have been split into individual packages. This directory defaults to the following: @@ -10944,7 +10655,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to a temporary work area where the <link linkend='ref-tasks-package'><filename>do_package</filename></link> task saves package metadata. @@ -10973,7 +10683,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The epoch of the package(s) built by the recipe. By default, <filename>PKGE</filename> is set to <link linkend='var-PE'><filename>PE</filename></link>. @@ -10987,7 +10696,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The revision of the package(s) built by the recipe. By default, <filename>PKGR</filename> is set to <link linkend='var-PR'><filename>PR</filename></link>. @@ -11001,7 +10709,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The version of the package(s) built by the recipe. By default, <filename>PKGV</filename> is set to @@ -11012,11 +10719,10 @@ <glossentry id='var-PN'><glossterm>PN</glossterm> <info> - PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package. + PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable can have two separate functions depending on the context: a recipe name or a resulting package name. </para> @@ -11053,7 +10759,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists recipes you do not want the OpenEmbedded build system to build. This variable works in conjunction with the @@ -11080,7 +10785,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call once the OpenEmbedded build system has created the host part of the SDK. @@ -11109,7 +10813,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call once the OpenEmbedded build system has created the target part of the SDK. @@ -11138,7 +10841,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The revision of the recipe. The default value for this variable is "r0". Subsequent revisions of the recipe conventionally have the @@ -11194,7 +10896,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If multiple recipes provide the same item, this variable determines which recipe is preferred and thus provides the item (i.e. the preferred provider). @@ -11244,7 +10945,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If multiple versions of recipes exist, this variable determines which version is given preference. You must always suffix the variable with the @@ -11264,7 +10964,7 @@ Here are two examples: <literallayout class='monospaced'> PREFERRED_VERSION_python = "3.4.0" - PREFERRED_VERSION_linux-yocto = "4.12%" + PREFERRED_VERSION_linux-yocto = "5.0%" </literallayout> <note><title>Important</title> The use of the "<filename>%</filename>" character @@ -11310,14 +11010,14 @@ to set a machine-specific override. Here is an example: <literallayout class='monospaced'> - PREFERRED_VERSION_linux-yocto_qemux86 = "4.12%" + PREFERRED_VERSION_linux-yocto_qemux86 = "5.0%" </literallayout> Although not recommended, worst case, you can also use the "forcevariable" override, which is the strongest override possible. Here is an example: <literallayout class='monospaced'> - PREFERRED_VERSION_linux-yocto_forcevariable = "4.12%" + PREFERRED_VERSION_linux-yocto_forcevariable = "5.0%" </literallayout> <note> The <filename>_forcevariable</filename> override is @@ -11336,7 +11036,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies additional paths from which the OpenEmbedded build system gets source code. When the build system searches for source code, it first @@ -11385,7 +11084,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Indicates the importance of a package. </para> @@ -11411,7 +11109,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies libraries installed within a recipe that should be ignored by the OpenEmbedded build system's shared library resolver. @@ -11453,29 +11150,40 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of aliases by which a particular recipe can be known. By default, a recipe's own <filename><link linkend='var-PN'>PN</link></filename> is implicitly already in its <filename>PROVIDES</filename> - list. + list and therefore does not need to mention that it provides itself. If a recipe uses <filename>PROVIDES</filename>, the additional aliases are synonyms for the recipe and can - be useful satisfying dependencies of other recipes during + be useful for satisfying dependencies of other recipes during the build as specified by <filename><link linkend='var-DEPENDS'>DEPENDS</link></filename>. </para> <para> Consider the following example - <filename>PROVIDES</filename> statement from a recipe - file <filename>libav_0.8.11.bb</filename>: + <filename>PROVIDES</filename> statement from the recipe + file <filename>eudev_3.2.9.bb</filename>: <literallayout class='monospaced'> - PROVIDES += "libpostproc" + PROVIDES = "udev" </literallayout> The <filename>PROVIDES</filename> statement results in - the "libav" recipe also being known as "libpostproc". + the "eudev" recipe also being available as simply "udev". + + <note> + Given that a recipe's own recipe name is already + implicitly in its own <filename>PROVIDES</filename> list, + it is unnecessary to add aliases with the "+=" operator; + using a simple assignment will be sufficient. In other + words, while you could write: + <literallayout class='monospaced'> + PROVIDES += "udev" + </literallayout> + in the above, the "+=" is overkill and unnecessary. + </note> </para> <para> @@ -11530,7 +11238,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The network based <link linkend='var-PR'><filename>PR</filename></link> service host and port. @@ -11560,7 +11267,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies whether or not <ulink url='&YOCTO_DOCS_DEV_URL;#testing-packages-with-ptest'>Package Test</ulink> (ptest) functionality is enabled when building a recipe. @@ -11579,7 +11285,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The version of the recipe. The version is normally extracted from the recipe filename. For example, if the recipe is named @@ -11605,7 +11310,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used by recipes that inherit the <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>, <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>, @@ -11641,7 +11345,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When used by recipes that inherit the <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>, <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>, @@ -11649,8 +11352,7 @@ or <link linkend='ref-classes-setuptools'><filename>setuptools</filename></link> classes, specifies the major Python version being built. - For Python 2.x, <filename>PYTHON_PN</filename> would - be "python2". For Python 3.x, the variable would be + For Python 3.x, <filename>PYTHON_PN</filename> would be "python3". You do not have to set this variable as the OpenEmbedded build system automatically sets it for you. @@ -11678,7 +11380,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run <filename>ranlib</filename>. </para> @@ -11691,7 +11392,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of packages that conflict with packages. Note that packages will not be installed if conflicting packages are not first removed. @@ -11740,7 +11440,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists runtime dependencies of a package. These dependencies are other packages that must be installed in order for the package to function correctly. @@ -11903,7 +11602,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link> class, this @@ -11926,7 +11624,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> With <filename>rm_work</filename> enabled, this variable specifies a list of recipes whose work directories should not be removed. @@ -11942,7 +11639,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the root home directory. By default, this directory is set as follows in the BitBake configuration file: @@ -11979,7 +11675,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Indicates a filesystem image to include as the root filesystem. </para> @@ -11999,7 +11694,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call after the OpenEmbedded build system has installed packages. You can specify functions separated by semicolons: @@ -12026,7 +11720,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call once the OpenEmbedded build system has created the root filesystem. You can specify functions separated by semicolons: @@ -12053,7 +11746,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call after the OpenEmbedded build system has removed unnecessary packages. @@ -12086,7 +11778,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call before the OpenEmbedded build system has created the root filesystem. You can specify functions separated by semicolons: @@ -12113,7 +11804,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of package name aliases that a package also provides. These aliases are useful for satisfying runtime dependencies of other packages both during the build and on the target @@ -12142,7 +11832,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of packages that extends the usability of a package being built. The package being built does not depend on this list of @@ -12235,7 +11924,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of packages replaced by a package. The package manager uses this variable to determine which package should be installed to replace other package(s) @@ -12291,7 +11979,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of additional packages that you can suggest for installation by the package manager at the time a package is installed. @@ -12320,7 +12007,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location in the <link linkend='build-directory'>Build Directory</link> where unpacked recipe source code resides. @@ -12373,7 +12059,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of command-line utilities that should be checked for during the initial sanity checking process when running BitBake. @@ -12389,7 +12074,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of the host distribution identifiers that the build system has been tested against. Identifiers consist of the host distributor ID @@ -12414,7 +12098,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The target architecture for the SDK. Typically, you do not directly set this variable. Instead, use @@ -12429,7 +12112,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory set up and used by the <link linkend='ref-classes-populate-sdk'><filename>populate_sdk_base</filename></link> class to which the SDK is deployed. @@ -12448,7 +12130,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The parent directory used by the OpenEmbedded build system when creating SDK output. The @@ -12474,7 +12155,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Controls whether or not shared state artifacts are copied into the extensible SDK. The default value of "full" copies all of the required @@ -12498,7 +12178,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The manifest file for the host part of the SDK. This file lists all the installed packages that make up the host part of the SDK. @@ -12531,7 +12210,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When set to "1", specifies to include the packagedata for all recipes in the "world" target in the extensible SDK. Including this data allows the @@ -12556,7 +12234,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When set to "1", specifies to include the toolchain in the extensible SDK. Including the toolchain is useful particularly when @@ -12564,7 +12241,7 @@ is set to "minimal" to keep the SDK reasonably small but you still want to provide a usable toolchain. For example, suppose you want to use the toolchain from an - IDE (e.g. Eclipse) or from other tools and you do not + IDE or from other tools and you do not want to perform additional steps to install the toolchain. </para> @@ -12583,7 +12260,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of classes to remove from the <link linkend='var-INHERIT'><filename>INHERIT</filename></link> value globally within the extensible SDK configuration. @@ -12617,7 +12293,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of variables not allowed through from the OpenEmbedded build system configuration into the extensible SDK configuration. @@ -12661,7 +12336,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of variables allowed through from the OpenEmbedded build system configuration into the extensible SDK configuration. @@ -12697,7 +12371,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The base name for SDK output files. The name is derived from the <link linkend='var-DISTRO'><filename>DISTRO</filename></link>, @@ -12720,7 +12393,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the operating system for which the SDK will be built. The default value is the value of @@ -12735,7 +12407,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location used by the OpenEmbedded build system when creating SDK output. The @@ -12765,7 +12436,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of architectures compatible with the SDK machine. This variable is set automatically and should not @@ -12785,7 +12455,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of functions to call once the OpenEmbedded build system creates the SDK. You can specify functions separated by semicolons: @@ -12813,7 +12482,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The toolchain binary prefix used for <filename>nativesdk</filename> recipes. The OpenEmbedded build system uses the @@ -12831,7 +12499,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of shared state tasks added to the extensible SDK. By default, the following tasks are added: <literallayout class='monospaced'> @@ -12858,7 +12525,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the system, including the architecture and the operating system, for which the SDK will be built. </para> @@ -12882,7 +12548,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The manifest file for the target part of the SDK. This file lists all the installed packages that make up the target part of the SDK. @@ -12915,7 +12580,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of targets to install from shared state as part of the standard or extensible SDK installation. The default value is "${PN}" (i.e. the image from which @@ -12935,7 +12599,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The title to be printed when running the SDK installer. By default, this title is based on the <link linkend='var-DISTRO_NAME'><filename>DISTRO_NAME</filename></link> @@ -12968,7 +12631,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An optional URL for an update server for the extensible SDK. If set, the value is used as the default update server when @@ -12984,7 +12646,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the SDK vendor. </para> </glossdef> @@ -12996,13 +12657,12 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the version of the SDK. The distribution configuration file (e.g. <filename>/meta-poky/conf/distro/poky.conf</filename>) defines the <filename>SDK_VERSION</filename> as follows: <literallayout class='monospaced'> - SDK_VERSION := "${@'${DISTRO_VERSION}'.replace('snapshot-${DATE}','snapshot')}" + SDK_VERSION = "${@d.getVar('DISTRO_VERSION').replace('snapshot-${DATE}','snapshot')}" </literallayout> </para> @@ -13022,7 +12682,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The default installation directory for the Extensible SDK. By default, this directory is based on the <link linkend='var-DISTRO'><filename>DISTRO</filename></link> @@ -13052,7 +12711,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Equivalent to <filename><link linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></filename>. However, this variable applies to the SDK generated from an @@ -13070,7 +12728,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The machine for which the SDK is built. In other words, the SDK is built such that it runs on the target you specify with the @@ -13102,7 +12759,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the path offered to the user for installation of the SDK that is generated by the OpenEmbedded build system. @@ -13120,7 +12776,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The full path to the sysroot used for cross-compilation within an SDK as it will be when installed into the default @@ -13135,7 +12790,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The section in which packages should be categorized. Package management utilities can make use of this variable. </para> @@ -13148,7 +12802,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the optimization flags passed to the C compiler when building for the target. The flags are passed through the default value of the @@ -13173,7 +12826,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines a serial console (TTY) to enable using <ulink url='https://en.wikipedia.org/wiki/Getty_(Unix)'>getty</ulink>. Provide a value that specifies the baud rate followed by @@ -13199,7 +12851,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines a serial console (TTY) to enable using <ulink url='https://en.wikipedia.org/wiki/Getty_(Unix)'>getty</ulink>. Provide a value that specifies the baud rate followed by @@ -13218,7 +12869,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies serial consoles, which must be listed in <link linkend='var-SERIAL_CONSOLES'><filename>SERIAL_CONSOLES</filename></link>, to check against <filename>/proc/console</filename> @@ -13244,7 +12894,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recipe dependencies that should not be used to determine signatures of tasks from one recipe when they depend on tasks from another recipe. @@ -13296,7 +12945,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of recipes that are completely stable and will never change. The ABI for the recipes in the list are presented by @@ -13320,7 +12968,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the number of bits for the target system CPU. The value should be either "32" or "64". </para> @@ -13333,7 +12980,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the endian byte order of the target system. The value should be either "le" for little-endian or "be" for big-endian. </para> @@ -13342,12 +12988,10 @@ <glossentry id='var-SKIP_FILEDEPS'><glossterm>SKIP_FILEDEPS</glossterm> <info> - SKIP_FILEDEPS[doc] = "Enables you to remove all files from - the "Provides" section of an RPM package." + SKIP_FILEDEPS[doc] = "Enables you to remove all files from the 'Provides' section of an RPM package." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Enables removal of all files from the "Provides" section of an RPM package. Removal of these files is required for packages containing @@ -13374,7 +13018,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Groups together machines based upon the same family of SOC (System On Chip). You typically set this variable in a common @@ -13396,7 +13039,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the suffix for shared libraries used on the target platform. By default, this suffix is ".so.*" for all Linux-based @@ -13418,7 +13060,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines the suffix for the development symbolic link (symlink) for shared libraries on the target platform. By default, this suffix is ".so" for Linux-based @@ -13440,7 +13081,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When you are fetching files to create a mirror of sources (i.e. creating a source mirror), setting <filename>SOURCE_MIRROR_FETCH</filename> to "1" in your @@ -13472,7 +13112,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Defines your own <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> from which to first fetch source before attempting to fetch @@ -13503,7 +13142,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Maps commonly used license names to their SPDX counterparts found in <filename>meta/files/common-licenses/</filename>. For the default <filename>SPDXLICENSEMAP</filename> @@ -13525,7 +13163,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of prefixes for <link linkend='var-PN'><filename>PN</filename></link> used by the OpenEmbedded build system to create variants of recipes or packages. The list specifies the prefixes to strip off during certain circumstances @@ -13540,7 +13177,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The file type for the Secondary Program Loader (SPL). Some devices use an SPL from which to boot (e.g. the BeagleBone development board). @@ -13582,7 +13218,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The list of source files - local or remote. This variable tells the OpenEmbedded build system which bits to pull in for the build and how to pull them in. @@ -13677,6 +13312,9 @@ a secure shell.</para></listitem> <listitem><para><emphasis><filename>svn://</filename> -</emphasis> Fetches files from a Subversion (<filename>svn</filename>) revision control repository.</para></listitem> + <listitem><para><emphasis><filename>npm://</filename> -</emphasis> Fetches JavaScript + modules from a registry. + </para></listitem> </itemizedlist> </para> @@ -13771,7 +13409,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> By default, the OpenEmbedded build system automatically detects whether <filename><link linkend='var-SRC_URI'>SRC_URI</link></filename> contains files that are machine-specific. @@ -13788,7 +13425,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The date of the source code used to build the package. This variable applies only if the source was fetched from a Source Code Manager (SCM). </para> @@ -13801,7 +13437,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Returns the version string of the current package. This string is used to help define the value of <link linkend='var-PV'><filename>PV</filename></link>. @@ -13839,7 +13474,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The revision of the source code used to build the package. This variable applies to Subversion, Git, Mercurial, and Bazaar only. @@ -13869,7 +13503,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory for the shared state cache. </para> </glossdef> @@ -13881,7 +13514,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set to "1", allows fetches from mirrors that are specified in <link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link> @@ -13904,7 +13536,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Configures the OpenEmbedded build system to search other mirror locations for prebuilt cache data objects before building out the data. @@ -13927,7 +13558,7 @@ <para> When pointing to sstate build artifacts on another machine that uses a different GCC version for native builds, - you must configure <filename>SSTATE_MIRROR</filename> + you must configure <filename>SSTATE_MIRRORS</filename> with a regular expression that maps local search paths to server paths. The paths need to take into account @@ -13965,7 +13596,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Controls the list of files the OpenEmbedded build system scans for hardcoded installation paths. The variable uses a space-separated list of filenames (not paths) with standard @@ -14000,7 +13630,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/lib</filename> subdirectory of the sysroot directory for the build host. @@ -14014,7 +13643,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/lib</filename> subdirectory of the sysroot directory for the target for which the current recipe is being built @@ -14029,7 +13657,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/bin</filename> subdirectory of the sysroot directory for the target for which the current @@ -14045,7 +13672,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the directory containing binary configuration scripts. These scripts provide configuration information for @@ -14071,7 +13697,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/bin</filename> subdirectory of the sysroot directory for the build host. @@ -14085,7 +13710,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/share</filename> subdirectory of the sysroot directory for the target for which the current recipe is being built @@ -14100,7 +13724,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/share</filename> subdirectory of the sysroot directory for the build host. </para> @@ -14113,7 +13736,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Helps construct the <filename>recipe-sysroots</filename> directory, which is used during packaging. </para> @@ -14152,7 +13774,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the sysroot directory for the system on which the component is built to run (the system that hosts the component). @@ -14223,7 +13844,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the sysroot directory used when building components that run on the build host itself. </para> @@ -14236,7 +13856,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the sysroot used for the system for which the component generates code. For components that do not generate code, which is the @@ -14268,7 +13887,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/etc</filename> subdirectory of the sysroot directory for the build host. @@ -14282,7 +13900,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr</filename> subdirectory of the sysroot directory for the target for which the current recipe is being built @@ -14297,7 +13914,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/include</filename> subdirectory of the sysroot directory for the target for which the current @@ -14313,7 +13929,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/include</filename> subdirectory of the sysroot directory for the build host. </para> @@ -14326,7 +13941,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the directory containing the kernel build artifacts. Recipes building software that needs to access kernel @@ -14345,7 +13959,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory with kernel headers that are required to build out-of-tree modules. </para> @@ -14358,7 +13971,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/lib</filename> subdirectory of the sysroot directory for the target for which the current recipe is being built @@ -14373,7 +13985,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the path to the <filename>/usr/lib</filename> subdirectory of the sysroot directory for the build host. </para> @@ -14386,7 +13997,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the base path used to create recipe stamp files. The path to an actual stamp file is constructed by evaluating this string and then appending additional information. @@ -14423,7 +14033,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the base directory in which the OpenEmbedded build system places stamps. The default directory is @@ -14438,7 +14047,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The minimal command and arguments to run <filename>strip</filename>, which is used to strip symbols. @@ -14452,7 +14060,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The short (72 characters or less) summary of the binary package for packaging systems such as <filename>opkg</filename>, <filename>rpm</filename>, or <filename>dpkg</filename>. @@ -14470,7 +14077,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory in which files checked out of a Subversion system are stored. </para> @@ -14483,7 +14089,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the kernel boot default console. If you want to use a console other than the default, set this variable in your recipe as follows where "X" is @@ -14508,7 +14113,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Lists additional options to add to the syslinux file. You need to set this variable in your recipe. If you want to list multiple options, separate the options @@ -14529,7 +14133,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the alternate serial port or turns it off. To turn off serial, set this variable to an empty string in your recipe. @@ -14553,7 +14156,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An <filename>.LSS</filename> file used as the background for the VGA boot menu when you use the boot menu. You need to set this variable in your recipe. @@ -14574,7 +14176,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the alternate console=tty... kernel boot argument. The variable's default value is set in the <link linkend='ref-classes-syslinux'><filename>syslinux</filename></link> @@ -14596,7 +14197,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the temporary directory under the work directory (default "<filename>${</filename><link linkend='var-WORKDIR'><filename>WORKDIR</filename></link><filename>}/sysroot-destdir</filename>") @@ -14614,7 +14214,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Directories that are staged into the sysroot by the <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> task. @@ -14638,7 +14237,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Directories that are not staged into the sysroot by the <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> task. @@ -14668,7 +14266,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Extra directories staged into the sysroot by the <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> task for <filename>-native</filename> recipes, in addition @@ -14703,7 +14300,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of functions to execute after files are staged into the sysroot. These functions are usually used to apply additional @@ -14719,7 +14315,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-systemd'><filename>systemd</filename></link> class, this variable specifies whether the specified service @@ -14749,7 +14344,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> is set to "systemd-boot", the @@ -14777,7 +14371,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> is set to "systemd-boot", the @@ -14807,7 +14400,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> is set to "systemd-boot", the @@ -14835,7 +14427,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-systemd'><filename>systemd</filename></link> class, this variable locates the systemd unit files when @@ -14865,7 +14456,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-systemd'><filename>systemd</filename></link> class, this variable specifies the systemd service name for @@ -14890,7 +14480,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When using <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>, specifies a space-separated list of the virtual terminals @@ -14919,7 +14508,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable points to a directory were BitBake places temporary files, which consist mostly of task logs and scripts, when building a particular recipe. @@ -14948,7 +14536,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The target machine's architecture. The OpenEmbedded build system supports many architectures. @@ -14981,7 +14568,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific assembler flags for the target system. <filename>TARGET_AS_ARCH</filename> is initialized from @@ -15001,7 +14587,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific C compiler flags for the target system. <filename>TARGET_CC_ARCH</filename> is initialized from @@ -15025,7 +14610,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This is a specific kernel compiler flag for a CPU or Application Binary Interface (ABI) tune. The flag is used rarely and only for cases where a @@ -15050,7 +14634,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C compiler when building for the target. When building in the target context, @@ -15074,7 +14657,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the target. @@ -15099,7 +14681,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the C++ compiler when building for the target. When building in the target context, @@ -15123,7 +14704,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the method for handling FPU code. For FPU-less targets, which include most ARM CPUs, the variable must be set to "soft". @@ -15138,7 +14718,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific linker flags for the target system. <filename>TARGET_LD_ARCH</filename> is initialized from @@ -15158,7 +14737,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the flags to pass to the linker when building for the target. When building in the target context, @@ -15184,7 +14762,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the target's operating system. The variable can be set to "linux" for glibc-based systems (GNU C Library) and to "linux-musl" for musl libc. @@ -15200,7 +14777,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the prefix used for the toolchain binary target tools. </para> @@ -15236,7 +14812,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the system, including the architecture and the operating system, for which the build is occurring in the context of the current recipe. @@ -15279,7 +14854,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the name of the target vendor. </para> </glossdef> @@ -15287,11 +14861,10 @@ <glossentry id='var-TCLIBC'><glossterm>TCLIBC</glossterm> <info> - TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc', 'musl' or "newlib." + TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc', 'musl' or 'newlib'." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the GNU standard C library (<filename>libc</filename>) variant to use during the build process. @@ -15311,7 +14884,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a suffix to be appended onto the <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link> value. @@ -15342,7 +14914,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the toolchain selector. <filename>TCMODE</filename> controls the characteristics of the generated packages and images by telling the @@ -15414,7 +14985,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The location the OpenEmbedded build system uses to export tests when the <link linkend='var-TEST_EXPORT_ONLY'><filename>TEST_EXPORT_ONLY</filename></link> @@ -15434,7 +15004,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies to export the tests only. Set this variable to "1" if you do not want to run the tests but you want them to be exported in a manner that @@ -15449,7 +15018,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Holds the SSH log and the boot log for QEMU machines. The <filename>TEST_LOG_DIR</filename> variable defaults to <filename>"${WORKDIR}/testimage"</filename>. @@ -15468,7 +15036,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For automated hardware testing, specifies the command to use to control the power of the target machine under test. Typically, this command would point to a script that @@ -15488,7 +15055,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For automated hardware testing, specifies additional arguments to pass through to the command specified in <link linkend='var-TEST_POWERCONTROL_CMD'><filename>TEST_POWERCONTROL_CMD</filename></link>. @@ -15507,7 +15073,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The time in seconds allowed for an image to boot before automated runtime tests begin to run against an image. @@ -15531,7 +15096,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For automated hardware testing, specifies the command to use to connect to the serial console of the target machine under test. @@ -15557,7 +15121,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For automated hardware testing, specifies additional arguments to pass through to the command specified in <link linkend='var-TEST_SERIALCONTROL_CMD'><filename>TEST_SERIALCONTROL_CMD</filename></link>. @@ -15576,7 +15139,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The IP address of the build machine (host machine). This IP address is usually automatically detected. However, if detection fails, this variable needs to be set @@ -15599,12 +15161,11 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the target controller to use when running tests against a test image. - The default controller to use is "QemuTarget": + The default controller to use is "qemu": <literallayout class='monospaced'> - TEST_TARGET = "QemuTarget" + TEST_TARGET = "qemu" </literallayout> </para> @@ -15623,21 +15184,21 @@ You can provide the following arguments with <filename>TEST_TARGET</filename>: <itemizedlist> - <listitem><para><emphasis>"QemuTarget":</emphasis> + <listitem><para><emphasis>"qemu":</emphasis> Boots a QEMU image and runs the tests. See the "<ulink url='&YOCTO_DOCS_DEV_URL;#qemu-image-enabling-tests'>Enabling Runtime Tests on QEMU</ulink>" section in the Yocto Project Development Tasks Manual for more information. </para></listitem> - <listitem><para><emphasis>"SimpleRemoteTarget":</emphasis> + <listitem><para><emphasis>"simpleremote":</emphasis> Runs the tests on target hardware that is already up and running. The hardware can be on the network or it can be a device running an image on QEMU. You must also set <link linkend='var-TEST_TARGET_IP'><filename>TEST_TARGET_IP</filename></link> - when you use "SimpleRemoteTarget". + when you use "simpleremote". <note> This argument is defined in <filename>meta/lib/oeqa/controllers/simpleremote.py</filename>. @@ -15660,7 +15221,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The IP address of your hardware under test. The <filename>TEST_TARGET_IP</filename> variable has no effect when @@ -15690,7 +15250,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An ordered list of tests (modules) to run against an image when performing automated runtime testing. </para> @@ -15749,7 +15308,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Automatically runs the series of automated tests for images when an image is successfully built. Setting <filename>TESTIMAGE_AUTO</filename> to "1" @@ -15790,7 +15348,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The directory in which the file BitBake is currently parsing is located. Do not manually set this variable. @@ -15804,7 +15361,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The time the build was started. Times appear using the hour, minute, and second (HMS) format (e.g. "140159" for one minute and fifty-nine @@ -15819,7 +15375,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable is the base directory the OpenEmbedded build system uses for all build output and intermediate files (other than the shared state cache). @@ -15861,7 +15416,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable lists packages the OpenEmbedded build system uses when building an SDK, which contains a cross-development environment. @@ -15903,7 +15457,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable defines the name used for the toolchain output. The @@ -15929,7 +15482,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> This variable lists packages the OpenEmbedded build system uses when it creates the target part of an SDK (i.e. the part built for the target hardware), which @@ -15962,7 +15514,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The top-level <link linkend='build-directory'>Build Directory</link>. BitBake automatically sets this variable when you @@ -15978,7 +15529,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A sanitized version of <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>. This variable is used where the architecture is needed in @@ -16000,7 +15550,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The GNU canonical architecture for a specific architecture (i.e. <filename>arm</filename>, <filename>armeb</filename>, @@ -16059,7 +15608,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific assembler flags for the target system. The set of flags is based on the selected tune features. @@ -16090,7 +15638,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific C compiler flags for the target system. The set of flags is based on the selected tune features. @@ -16115,7 +15662,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies architecture-specific linker flags for the target system. The set of flags is based on the selected tune features. @@ -16146,7 +15692,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Features used to "tune" a compiler for optimal use given a specific processor. The features are defined within the tune files and allow @@ -16180,7 +15725,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The package architecture understood by the packaging system to define the architecture, ABI, and tuning of output packages. @@ -16211,7 +15755,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> An underlying Application Binary Interface (ABI) used by a particular tuning in a given toolchain layer. Providers that use prebuilt libraries can use the @@ -16239,7 +15782,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> If set, the OpenEmbedded system ignores the <link linkend='var-TUNEABI_WHITELIST'><filename>TUNEABI_WHITELIST</filename></link> variable. @@ -16266,7 +15808,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A whitelist of permissible <link linkend='var-TUNEABI'><filename>TUNEABI</filename></link> values. @@ -16294,7 +15835,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies CPU or Application Binary Interface (ABI) tuning features that conflict with <replaceable>feature</replaceable>. </para> @@ -16320,7 +15860,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a valid CPU or Application Binary Interface (ABI) tuning feature. The specified feature is stored as a flag. @@ -16350,7 +15889,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Configures the <link linkend='var-UBOOT_MACHINE'><filename>UBOOT_MACHINE</filename></link> and can also define @@ -16393,7 +15931,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the entry point for the U-Boot image. During U-Boot image creation, the <filename>UBOOT_ENTRYPOINT</filename> variable is passed @@ -16409,7 +15946,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the load address for the U-Boot image. During U-Boot image creation, the <filename>UBOOT_LOADADDRESS</filename> variable is passed @@ -16425,11 +15961,10 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Appends a string to the name of the local version of the U-Boot image. For example, assuming the version of the U-Boot image - built was "2013.10, the full version string reported by + built was "2013.10", the full version string reported by U-Boot would be "2013.10-yocto" given the following statement: <literallayout class='monospaced'> @@ -16445,7 +15980,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the value passed on the <filename>make</filename> command line when building a U-Boot image. @@ -16469,7 +16003,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the target called in the <filename>Makefile</filename>. The default target is "all". @@ -16483,7 +16016,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Points to the generated U-Boot extension. For example, <filename>u-boot.sb</filename> has a <filename>.sb</filename> extension. @@ -16502,7 +16034,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the target used for building U-Boot. The target is passed directly as part of the "make" command (e.g. SPL and AIS). @@ -16519,7 +16050,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a list of options that, if reported by the configure script as being invalid, should not generate a warning during the @@ -16557,7 +16087,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> For recipes inheriting the <link linkend='ref-classes-update-rc.d'><filename>update-rc.d</filename></link> class, <filename>UPDATERCPN</filename> specifies @@ -16580,17 +16109,16 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - When the - <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link> - class is enabled globally, you can perform a per-recipe - check for what the latest upstream source code version is - by calling + You can perform a per-recipe check for what the latest + upstream source code version is by calling <filename>bitbake -c checkpkg</filename> <replaceable>recipe</replaceable>. If the recipe source code is provided from Git repositories, the OpenEmbedded build system determines the latest upstream version by picking the latest tag from the list of all repository tags. + </para> + + <para> You can use the <filename>UPSTREAM_CHECK_GITTAGREGEX</filename> variable to provide a regular expression to filter only the @@ -16609,12 +16137,8 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - When the - <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link> - class is enabled globally, use the - <filename>UPSTREAM_CHECK_REGEX</filename> variable to - specify a different regular expression instead of the + Use the <filename>UPSTREAM_CHECK_REGEX</filename> variable + to specify a different regular expression instead of the default one when the package checking system is parsing the page found using <link linkend='var-UPSTREAM_CHECK_URI'><filename>UPSTREAM_CHECK_URI</filename></link>. @@ -16631,13 +16155,9 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - When the - <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link> - class is enabled globally, you can perform a per-recipe - check for what the latest upstream source code version is - by calling <filename>bitbake -c checkpkg</filename> - <replaceable>recipe</replaceable>. + You can perform a per-recipe check for what the latest + upstream source code version is by calling + <filename>bitbake -c checkpkg</filename> <replaceable>recipe</replaceable>. If the source code is provided from tarballs, the latest version is determined by fetching the directory listing where the tarball is and attempting to find a later tarball. @@ -16658,7 +16178,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Determines if <filename>devtmpfs</filename> is used for <filename>/dev</filename> population. The default value used for <filename>USE_DEVFS</filename> @@ -16683,7 +16202,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When using <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>, determines whether or not to run a @@ -16709,7 +16227,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> A list of classes to globally inherit. These classes are used by the OpenEmbedded build system to enable extra features (e.g. @@ -16733,18 +16250,20 @@ <glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm> <info> - USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in files/passwd and files/group files. If set to 'warn', a warning will be issued instead." + USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in any of the files listed in USERADD_UID_TABLES and USERADD_GID_TABLES. If set to 'warn', a warning will be issued instead." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> - If set to "error", forces the OpenEmbedded build system to - produce an error if the user identification - (<filename>uid</filename>) and group identification - (<filename>gid</filename>) values are not defined - in <filename>files/passwd</filename> - and <filename>files/group</filename> files. - If set to "warn", a warning will be issued instead. + + If set to <filename>error</filename>, forces the + OpenEmbedded build system to produce an error if the user + identification (<filename>uid</filename>) and group + identification (<filename>gid</filename>) values are not + defined in any of the files listed + in <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link> + and <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>. If + set to <filename>warn</filename>, a warning will be issued + instead. </para> <para> @@ -16771,6 +16290,20 @@ <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link> variables. </para> + + <note> + There is a difference in behavior between + setting <filename>USERADD_ERROR_DYNAMIC</filename> + to <filename>error</filename> and setting it + to <filename>warn</filename>. When it is set + to <filename>warn</filename>, the build system will report a + warning for every undefined <filename>uid</filename> and + <filename>gid</filename> in any recipe. But when it is set + to <filename>error</filename>, it will only report errors + for recipes that are actually built. This saves you from + having to add static IDs for recipes that you know will + never be built. + </note> </glossdef> </glossentry> @@ -16780,7 +16313,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a password file to use for obtaining static group identification (<filename>gid</filename>) values when the OpenEmbedded build system adds a group to the @@ -16816,7 +16348,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-useradd'><filename>useradd</filename></link> class, this variable @@ -16853,7 +16384,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When inheriting the <link linkend='ref-classes-useradd'><filename>useradd</filename></link> class, this variable @@ -16884,7 +16414,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies a password file to use for obtaining static user identification (<filename>uid</filename>) values when the OpenEmbedded build system adds a user to the @@ -16920,7 +16449,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> When set to "useradd-staticids", causes the OpenEmbedded build system to base all user and group additions on a static @@ -16973,7 +16501,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the persistence of the target's <filename>/var/log</filename> directory, which is used to house postinstall target log files. @@ -16998,7 +16525,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the quality assurance checks whose failures are reported as warnings by the OpenEmbedded build system. You set this variable in your distribution configuration @@ -17070,7 +16596,7 @@ "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-partitioned-images-using-wic'>Creating Partitioned Images Using Wic</ulink>" section in the Yocto Project Development Tasks Manual. For details on the kickstart file format, see the - "<link linkend='ref-kickstart'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link> + "<link linkend='ref-kickstart'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>" Chapter. </para> </glossdef> @@ -17082,7 +16608,6 @@ </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> The pathname of the work directory in which the OpenEmbedded build system builds a recipe. This directory is located within the @@ -17140,12 +16665,10 @@ <glossentry id='var-XSERVER'><glossterm>XSERVER</glossterm> <info> - XSERVER[doc] = "Specifies the packages that should be installed - to provide an X server and drivers for the current machine." + XSERVER[doc] = "Specifies the packages that should be installed to provide an X server and drivers for the current machine." </info> <glossdef> <para role="glossdeffirst"> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> Specifies the packages that should be installed to provide an X server and drivers for the current machine, assuming your image directly includes |