From a0a1f173dfb4f611a3a2aa3f8654a80db661ae66 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 17 Feb 2015 14:32:47 -0800 Subject: ref-manual: Repositioned PNG files for context image. I moved the PNG file for the context to be the first item displayed for a given glossary term. The PNG file must be negatively indented though to look decent. Fixes [YOCTO #5601] These reformatting changes were needed because of brower incompatibilities discovered with the existing solution for displaying these PNG files with glossary terms. (From yocto-docs rev: 06aeb6540c1343825369dd02006cb19e5a318d48) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 2359 ++++++++++++++++------------ 1 file changed, 1321 insertions(+), 1038 deletions(-) diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 84c5295046..8d444a4687 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -46,12 +46,12 @@ A - ABIEXTENSION + ABIEXTENSION ABIEXTENSION[doc] = "Extension to the Application Binary Interface (ABI) field of the GNU canonical architecture name (e.g. "eabi")." - + Extension to the Application Binary Interface (ABI) field of the GNU canonical architecture name (e.g. "eabi"). @@ -69,12 +69,12 @@ - ALLOW_EMPTY + ALLOW_EMPTY ALLOW_EMPTY[doc] = "Specifies if an output package should still be produced if it is empty." - + Specifies if an output package should still be produced if it is empty. By default, BitBake does not produce empty packages. This default behavior can cause issues when there is an @@ -94,12 +94,12 @@ - ALTERNATIVE + ALTERNATIVE ALTERNATIVE[doc] = "Lists commands in a package that need an alternative binary naming scheme." - + Lists commands in a package that need an alternative binary naming scheme. Sometimes the same command is provided in multiple packages. @@ -124,12 +124,12 @@ - ALTERNATIVE_LINK_NAME + ALTERNATIVE_LINK_NAME ALTERNATIVE_LINK_NAME[doc] = "Used by the alternatives system to map duplicated commands to actual locations." - + Used by the alternatives system to map duplicated commands to actual locations. For example, if the bracket command @@ -140,6 +140,9 @@ ALTERNATIVE_LINK_NAME[bracket] = "/usr/bin/[" + + + In this example, the binary for the bracket command (i.e. [) from the @@ -160,12 +163,12 @@ - ALTERNATIVE_PRIORITY + ALTERNATIVE_PRIORITY ALTERNATIVE_PRIORITY[doc] = "Used by the alternatives system to create default priorities for duplicated commands." - + Used by the alternatives system to create default priorities for duplicated commands. You can use the variable to create a single default @@ -188,12 +191,12 @@ - ALTERNATIVE_TARGET + ALTERNATIVE_TARGET ALTERNATIVE_TARGET[doc] = "Used by the alternatives system to create default link locations for duplicated commands." - + Used by the alternatives system to create default link locations for duplicated commands. You can use the variable to create a single default @@ -242,12 +245,12 @@ - APPEND + APPEND APPEND[doc] = "An override list of append strings for each LABEL." - + An override list of append strings for each LABEL. @@ -260,36 +263,36 @@ - AR + AR AR[doc] = "Minimal command and arguments to run 'ar'." - + The minimal command and arguments used to run ar. - AS + AS AS[doc] = "Minimal command and arguments to run the assembler." - + The minimal command and arguments used to run the assembler. - ASSUME_PROVIDED + ASSUME_PROVIDED ASSUME_PROVIDED[doc] = "Lists recipe names (PN values) BitBake does not attempt to build." - + Lists recipe names (PN values) BitBake does not attempt to build. @@ -307,12 +310,12 @@ - ASSUME_SHLIBS + ASSUME_SHLIBS ASSUME_SHLIBS[doc] = Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system." - + Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system. @@ -341,24 +344,24 @@ - AUTHOR + AUTHOR AUTHOR[doc] = "Email address used to contact the original author or authors in order to send patches and forward bugs." - + The email address used to contact the original author or authors in order to send patches and forward bugs. - AUTO_LIBNAME_PKGS + AUTO_LIBNAME_PKGS AUTO_LIBNAME_PKGS[doc] = "Specifies which packages should be checked for libraries and renamed according to Debian library package naming." - + When the debian class is inherited, which is the default behavior, @@ -375,12 +378,12 @@ - AUTO_SYSLINUXMENU + AUTO_SYSLINUXMENU AUTO_SYSLINUXMENU[doc] = "Enables creating an automatic menu for the syslinux bootloader." - + Enables creating an automatic menu for the syslinux bootloader. You must set this variable in your recipe. @@ -391,12 +394,12 @@ - AUTOREV + AUTOREV AUTOREV[doc] = "When SRCREV is set to the value of this variable, it specifies to use the latest source revision in the repository." - + When SRCREV is set to the value of this variable, it specifies to use @@ -426,12 +429,12 @@ - AVAILTUNES + AVAILTUNES AVAILTUNES[doc] = "The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system." - + The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system. @@ -453,11 +456,6 @@ "Basic Syntax" section in the BitBake User Manual for more information. - @@ -465,12 +463,12 @@ meta/conf/machine/include//arch-.inc B - B + B B[doc] = "The Build Directory. The OpenEmbedded build system places generated objects into the Build Directory during a recipe's build process." - + The directory within the Build Directory in which the OpenEmbedded build system places generated @@ -480,6 +478,9 @@ meta/conf/machine/include//arch-.inc S = "${WORKDIR}/${BP}/" + + + You can separate the (S) directory and the directory pointed to by the B variable. @@ -491,12 +492,12 @@ meta/conf/machine/include//arch-.inc - BAD_RECOMMENDATIONS + BAD_RECOMMENDATIONS BAD_RECOMMENDATIONS[doc] = "A list of packages not to install despite being recommended by a recipe. Support for this variable exists only when using the IPK packaging backend." - + Lists "recommended-only" packages to not install. Recommended-only packages are packages installed only through the @@ -508,6 +509,9 @@ meta/conf/machine/include//arch-.inc BAD_RECOMMENDATIONS = "package_name package_name package_name ..." + + + You can set this variable globally in your local.conf file or you can attach it to a specific image recipe by using the recipe name override: @@ -542,12 +546,12 @@ meta/conf/machine/include//arch-.inc - BASE_LIB + BASE_LIB BASE_LIB[doc] = "The library directory name for the CPU or Application Binary Interface (ABI) tune." - + The library directory name for the CPU or Application Binary Interface (ABI) tune. The BASE_LIB applies only in the @@ -567,24 +571,24 @@ meta/conf/machine/include//arch-.inc - BASE_WORKDIR + BASE_WORKDIR BASE_WORKDIR[doc] = "Points to the base of the work directory for all recipes." - + Points to the base of the work directory for all recipes. The default value is "${TMPDIR}/work". - BB_DANGLINGAPPENDS_WARNONLY + BB_DANGLINGAPPENDS_WARNONLY BB_DANGLINGAPPENDS_WARNONLY[doc] = "Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb)." - + Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb). @@ -616,12 +620,12 @@ meta/conf/machine/include//arch-.inc - BB_DISKMON_DIRS + BB_DISKMON_DIRS BB_DISKMON_DIRS[doc] = "Monitors disk space and available inodes during the build and allows you to control the build based on these parameters." - + Monitors disk space and available inodes during the build and allows you to control the build based on these parameters. @@ -714,12 +718,12 @@ meta/conf/machine/include//arch-.inc - BB_DISKMON_WARNINTERVAL + BB_DISKMON_WARNINTERVAL BB_DISKMON_WARNINTERVAL[doc] = "Defines the disk space and free inode warning intervals. To set these intervals, define the variable in the conf/local.conf file in the Build Directory." - + Defines the disk space and free inode warning intervals. To set these intervals, define the variable in your conf/local.conf file in the @@ -785,12 +789,12 @@ meta/conf/machine/include//arch-.inc - BB_GENERATE_MIRROR_TARBALLS + BB_GENERATE_MIRROR_TARBALLS BB_GENERATE_MIRROR_TARBALLS[doc] = "Causes tarballs of the Git repositories to be placed in the DL_DIR directory." - + Causes tarballs of the Git repositories, including the Git metadata, to be placed in the DL_DIR @@ -811,12 +815,12 @@ meta/conf/machine/include//arch-.inc - BB_NUMBER_THREADS + BB_NUMBER_THREADS BB_NUMBER_THREADS[doc] = "The maximum number of tasks BitBake should run in parallel at any one time. This variable is automatically configured to be equal to the number of build system cores." - + The maximum number of tasks BitBake should run in parallel at any one time. The OpenEmbedded build system automatically configures @@ -828,12 +832,12 @@ meta/conf/machine/include//arch-.inc - BBCLASSEXTEND + BBCLASSEXTEND BBCLASSEXTEND[doc] = "Allows you to extend a recipe so that it builds variants of the software. Common variants for recipes are 'native', 'cross', 'nativesdk' and multilibs." - + Allows you to extend a recipe so that it builds variants of the software. Common variants for recipes exist such as "natives" like quilt-native, which is a copy of Quilt built to run on the build system; @@ -855,12 +859,13 @@ meta/conf/machine/include//arch-.inc - BBFILE_COLLECTIONS + BBFILE_COLLECTIONS BBFILE_COLLECTIONS[doc] = "Lists the names of configured layers. These names are used to find the other BBFILE_* variables." - Lists the names of configured layers. + + Lists the names of configured layers. These names are used to find the other BBFILE_* variables. Typically, each layer will append its name to this variable in its @@ -869,27 +874,33 @@ meta/conf/machine/include//arch-.inc - BBFILE_PATTERN + BBFILE_PATTERN BBFILE_PATTERN[doc] = "Variable that expands to match files from BBFILES in a particular layer. This variable is used in the layer.conf file and must be suffixed with the name of a layer." - Variable that expands to match files from + + Variable that expands to match files from BBFILES in a particular layer. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer (e.g. - BBFILE_PATTERN_emenlow). + BBFILE_PATTERN_emenlow). + - BBFILE_PRIORITY + BBFILE_PRIORITY BBFILE_PRIORITY[doc] = "Assigns the priority for recipe files in each layer. Setting this variable allows you to prioritize a layer against other layers that contain the same recipe." - Assigns the priority for recipe files in each layer. - This variable is useful in situations where the same recipe appears in + + Assigns the priority for recipe files in each layer. + + + + This variable is useful in situations where the same recipe appears in more than one layer. Setting this variable allows you to prioritize a layer against other layers that contain the same recipe - effectively @@ -899,8 +910,11 @@ meta/conf/machine/include//arch-.inc (PV variable). For example, a layer that has a recipe with a higher PV value but for which the BBFILE_PRIORITY is set to have a lower precedence still has a - lower precedence. - A larger value for the BBFILE_PRIORITY variable results in a higher + lower precedence. + + + + A larger value for the BBFILE_PRIORITY variable results in a higher precedence. For example, the value 6 has a higher precedence than the value 5. If not specified, the BBFILE_PRIORITY variable is set based on layer @@ -909,7 +923,8 @@ meta/conf/machine/include//arch-.inc more information. The default priority, if unspecified for a layer with no dependencies, is the lowest defined priority + 1 - (or 1 if no priorities are defined). + (or 1 if no priorities are defined). + You can use the command bitbake-layers show-layers to list all configured layers along with their priorities. @@ -917,30 +932,34 @@ meta/conf/machine/include//arch-.inc - BBFILES + BBFILES BBFILES[doc] = "List of recipe files used by BitBake to build software." - List of recipe files used by BitBake to build software. + + List of recipe files used by BitBake to build software. + - BBINCLUDELOGS + BBINCLUDELOGS BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure." - Variable that controls how BitBake displays logs on build failure. + + Variable that controls how BitBake displays logs on build failure. + - BBINCLUDELOGS_LINES + BBINCLUDELOGS_LINES BBINCLUDELOGS_LINES[doc] = "Amount of log lines printed on failure." - + If BBINCLUDELOGS is set, specifies the maximum number of lines from the @@ -951,12 +970,13 @@ meta/conf/machine/include//arch-.inc - BBLAYERS + BBLAYERS BBLAYERS[doc] = "Lists the layers to enable during the build. This variable is defined in the bblayers.conf configuration file." - Lists the layers to enable during the build. + + Lists the layers to enable during the build. This variable is defined in the bblayers.conf configuration file in the Build Directory. Here is an example: @@ -973,18 +993,22 @@ meta/conf/machine/include//arch-.inc /home/scottrif/poky/meta-yocto \ " + + + This example enables four layers, one of which is a custom, user-defined layer named meta-mykernel. - BBLAYERS_NON_REMOVABLE + BBLAYERS_NON_REMOVABLE BBLAYERS_NON_REMOVABLE[doc] = "Lists core layers that cannot be removed from the bblayers.conf file." - Lists core layers that cannot be removed from the + + Lists core layers that cannot be removed from the bblayers.conf file during a build using the Hob. @@ -992,6 +1016,9 @@ meta/conf/machine/include//arch-.inc When building an image outside of Hob, this variable is ignored. + + + In order for BitBake to build your image using Hob, your bblayers.conf file must include the meta and meta-yocto @@ -1015,12 +1042,12 @@ meta/conf/machine/include//arch-.inc - BBMASK + BBMASK BBMASK[doc] = "Prevents BitBake from processing specific recipes or recipe append files. Use the BBMASK variable from within conf/local.conf." - + Prevents BitBake from processing recipes and recipe append files. Use the BBMASK variable from within the @@ -1078,12 +1105,12 @@ meta/conf/machine/include//arch-.inc - BBPATH + BBPATH BBPATH[doc] = "Used by BitBake to locate .bbclass and configuration files. This variable is analogous to the PATH variable." - + Used by BitBake to locate .bbclass and configuration files. This variable is analogous to the @@ -1106,12 +1133,12 @@ meta/conf/machine/include//arch-.inc - BBSERVER + BBSERVER BBSERVER[doc] = "Points to the server that runs memory-resident BitBake." - + Points to the server that runs memory-resident BitBake. This variable is set by the oe-init-build-env-memres @@ -1122,6 +1149,9 @@ meta/conf/machine/include//arch-.inc export BBSERVER=localhost:$port + + + For more information on how the BBSERVER is used, see the oe-init-build-env-memres script, which @@ -1131,12 +1161,12 @@ meta/conf/machine/include//arch-.inc - BINCONFIG + BINCONFIG BINCONFIG[doc] = "When inheriting the binconfig-disabled class, this variable specifies binary configuration scripts to disable in favor of using pkg-config to query the information." - + When inheriting the binconfig-disabled class, this variable specifies binary configuration @@ -1158,12 +1188,12 @@ meta/conf/machine/include//arch-.inc - BINCONFIG_GLOB + BINCONFIG_GLOB BINCONFIG_GLOB[doc] = "When inheriting binconfig.bbclass from a recipe, this variable specifies a wildcard for configuration scripts that need editing." - + When inheriting the binconfig class, this variable specifies a wildcard for @@ -1185,27 +1215,30 @@ meta/conf/machine/include//arch-.inc - BP + BP BP[doc] = "The base recipe name and version but without any special recipe name suffix (i.e. -native, lib64-, and so forth). BP is comprised of ${BPN}-${PV}" - The base recipe name and version but without any special + + The base recipe name and version but without any special recipe name suffix (i.e. -native, lib64-, and so forth). BP is comprised of the following: ${BPN}-${PV} - + + - BPN + BPN BPN[doc] = "The bare name of the recipe. This variable is a version of the PN variable but removes common suffixes and prefixes." - The bare name of the recipe. + + The bare name of the recipe. This variable is a version of the PN variable but removes common suffixes such as "-native" and "-cross" as well as removes common prefixes such as multilib's "lib64-" and "lib32-". @@ -1214,16 +1247,17 @@ meta/conf/machine/include//arch-.inc The exact list of prefixes removed is specified by the MLPREFIX variable. Prefixes are removed for multilib - and nativesdk cases. + and nativesdk cases. + - BUGTRACKER + BUGTRACKER BUGTRACKER[doc] = "Specifies a URL for an upstream bug tracking website for a recipe." - + Specifies a URL for an upstream bug tracking website for a recipe. The OpenEmbedded build system does not use this variable. @@ -1233,12 +1267,12 @@ meta/conf/machine/include//arch-.inc - BUILD_ARCH + BUILD_ARCH BUILD_ARCH[doc] = "The name of the building architecture (e.g. i686)." - + Specifies the architecture of the build host (e.g. i686). The OpenEmbedded build system sets the value of @@ -1248,12 +1282,12 @@ meta/conf/machine/include//arch-.inc - BUILD_CFLAGS + BUILD_CFLAGS BUILD_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the build host." - + Specifies the flags to pass to the C compiler when building for the build host. When building in the -native context, @@ -1263,12 +1297,12 @@ meta/conf/machine/include//arch-.inc - BUILD_CPPFLAGS + BUILD_CPPFLAGS BUILD_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the build host." - + Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the build host. @@ -1279,12 +1313,12 @@ meta/conf/machine/include//arch-.inc - BUILD_CXXFLAGS + BUILD_CXXFLAGS BUILD_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the build host." - + Specifies the flags to pass to the C++ compiler when building for the build host. When building in the native context, @@ -1294,12 +1328,12 @@ meta/conf/machine/include//arch-.inc - BUILD_LDFLAGS + BUILD_LDFLAGS BUILD_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the build host." - + Specifies the flags to pass to the linker when building for the build host. When building in the -native context, @@ -1309,12 +1343,12 @@ meta/conf/machine/include//arch-.inc - BUILD_OPTIMIZATION + BUILD_OPTIMIZATION BUILD_OPTIMIZATION[doc] = "Specifies the optimization flags passed to the C compiler when building for the build host or the SDK." - + Specifies the optimization flags passed to the C compiler when building for the build host or the SDK. The flags are passed through the @@ -1332,12 +1366,12 @@ meta/conf/machine/include//arch-.inc - BUILD_OS + BUILD_OS BUILD_OS[doc] = "The operating system (in lower case) of the building architecture (e.g. Linux)." - + Specifies the operating system in use on the build host (e.g. "linux"). The OpenEmbedded build system sets the value of @@ -1348,12 +1382,12 @@ meta/conf/machine/include//arch-.inc - BUILD_PREFIX + BUILD_PREFIX BUILD_PREFIX[doc] = "The toolchain binary prefix used for native recipes." - + The toolchain binary prefix used for native recipes. The OpenEmbedded build system uses the BUILD_PREFIX value to set the @@ -1363,12 +1397,12 @@ meta/conf/machine/include//arch-.inc - BUILD_SYS + BUILD_SYS BUILD_SYS[doc] = "The toolchain binary prefix used for native recipes." - + Specifies the system, including the architecture and the operating system, to use when building for the build host (i.e. when building native @@ -1388,12 +1422,12 @@ meta/conf/machine/include//arch-.inc - BUILD_VENDOR + BUILD_VENDOR BUILD_VENDOR[doc] = "The vendor name to use when building for the build host." - + Specifies the vendor name to use when building for the build host. The default value is an empty string (""). @@ -1401,12 +1435,12 @@ meta/conf/machine/include//arch-.inc - BUILDDIR + BUILDDIR BUILDDIR[doc] = "Points to the location of the Build Directory." - + Points to the location of the Build Directory. You can define this directory indirectly through the @@ -1422,12 +1456,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_COMMIT + BUILDHISTORY_COMMIT BUILDHISTORY_COMMIT[doc] = "When inheriting the buildhistory class, this variable specifies whether or not to commit the build history output in a local Git repository." - + When inheriting the buildhistory class, this variable specifies whether or not to commit the @@ -1453,12 +1487,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_COMMIT_AUTHOR + BUILDHISTORY_COMMIT_AUTHOR BUILDHISTORY_COMMIT_AUTHOR[doc] = "When inheriting the buildhistory class, this variable specifies the author to use for each Git commit." - + When inheriting the buildhistory class, this variable specifies the author to use for each @@ -1487,12 +1521,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_DIR + BUILDHISTORY_DIR BUILDHISTORY_DIR[doc] = "When inheriting the buildhistory class, this variable specifies the directory in which build history information is kept." - + When inheriting the buildhistory class, this variable specifies the directory in which @@ -1511,12 +1545,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_FEATURES + BUILDHISTORY_FEATURES BUILDHISTORY_FEATURES[doc] = "When inheriting the buildhistory class, this variable specifies the build history features to be enabled." - + When inheriting the buildhistory class, this variable specifies the build history features @@ -1555,12 +1589,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_IMAGE_FILES + BUILDHISTORY_IMAGE_FILES BUILDHISTORY_IMAGE_FILES[doc] = "When inheriting the buildhistory class, this variable specifies a list of paths to files copied from the image contents into the build history directory under an "image-files" directory in the directory for the image, so that you can track the contents of each file." - + When inheriting the buildhistory class, this variable specifies a list of paths to files @@ -1587,12 +1621,12 @@ meta/conf/machine/include//arch-.inc - BUILDHISTORY_PUSH_REPO + BUILDHISTORY_PUSH_REPO BUILDHISTORY_PUSH_REPO[doc] = "When inheriting the buildhistory class, this variable optionally specifies a remote repository to which build history pushes Git changes." - + When inheriting the buildhistory class, this variable optionally specifies a remote @@ -1621,12 +1655,12 @@ meta/conf/machine/include//arch-.inc - BUILDSDK_CFLAGS + BUILDSDK_CFLAGS BUILDSDK_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the SDK." - + Specifies the flags to pass to the C compiler when building for the SDK. When building in the nativesdk @@ -1637,12 +1671,12 @@ meta/conf/machine/include//arch-.inc - BUILDSDK_CPPFLAGS + BUILDSDK_CPPFLAGS BUILDSDK_CPPFLAGS[doc] = "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." - + 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. @@ -1654,12 +1688,12 @@ meta/conf/machine/include//arch-.inc - BUILDSDK_CXXFLAGS + BUILDSDK_CXXFLAGS BUILDSDK_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the SDK." - + Specifies the flags to pass to the C++ compiler when building for the SDK. When building in the nativesdk @@ -1670,12 +1704,12 @@ meta/conf/machine/include//arch-.inc - BUILDSDK_LDFLAGS + BUILDSDK_LDFLAGS BUILDSDK_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the SDK." - + Specifies the flags to pass to the linker when building for the SDK. When building in the nativesdk- @@ -1686,12 +1720,12 @@ meta/conf/machine/include//arch-.inc - BUILDSTATS_BASE + BUILDSTATS_BASE BUILDSTATS_BASE[doc] = "Points to the location of the directory that holds build statistics when you use and enable the buildstats class." - + Points to the location of the directory that holds build statistics when you use and enable the buildstats @@ -1703,12 +1737,12 @@ meta/conf/machine/include//arch-.inc - BUSYBOX_SPLIT_SUID + BUSYBOX_SPLIT_SUID BUSYBOX_SPLIT_SUID[doc] = "For the BusyBox recipe, specifies whether to split the output executable file into two parts: one for features that require setuid root, and one for the remaining features." - + For the BusyBox recipe, specifies whether to split the output executable file into two parts: one for features that require setuid root, and one for @@ -1729,12 +1763,12 @@ meta/conf/machine/include//arch-.inc C - CACHE + CACHE CACHE[doc] = "The directory BitBake uses to store a cache of the metadata." - + Specifies the directory BitBake uses to store a cache of the Metadata @@ -1744,24 +1778,24 @@ meta/conf/machine/include//arch-.inc - CC + CC CC[doc] = "Minimum command and arguments to run the C compiler." - + The minimal command and arguments used to run the C compiler. - CFLAGS + CFLAGS CFLAGS[doc] = "Flags passed to the C compiler for the target system. This variable evaluates to the same as TARGET_CFLAGS." - + 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 @@ -1791,12 +1825,12 @@ meta/conf/machine/include//arch-.inc - CLASSOVERRIDE + CLASSOVERRIDE CLASSOVERRIDE[doc] = "An internal variable specifying the special class override that should currently apply (e.g. "class-target", "class-native", and so forth)." - + An internal variable specifying the special class override that should currently apply (e.g. "class-target", "class-native", and so forth). @@ -1820,12 +1854,12 @@ meta/conf/machine/include//arch-.inc - CLEANBROKEN + CLEANBROKEN CLEANBROKEN[doc] = "Prevents the build system from running 'make clean' during the do_configure task." - + If set to "1" within a recipe, CLEANBROKEN specifies that the make clean command does @@ -1838,12 +1872,12 @@ meta/conf/machine/include//arch-.inc - COMBINED_FEATURES + COMBINED_FEATURES COMBINED_FEATURES[doc] = "A set of features common between MACHINE_FEATURES and DISTRO_FEATURES." - + Provides a list of hardware features that are enabled in both MACHINE_FEATURES @@ -1867,12 +1901,12 @@ meta/conf/machine/include//arch-.inc - COMMON_LICENSE_DIR + COMMON_LICENSE_DIR COMMON_LICENSE_DIR[doc] = "Points to meta/files/common-licenses in the Source Directory, which is where generic license files reside." - + Points to meta/files/common-licenses in the Source Directory, @@ -1881,12 +1915,13 @@ meta/conf/machine/include//arch-.inc - COMPATIBLE_HOST + COMPATIBLE_HOST COMPATIBLE_HOST[doc] = "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." - A regular expression that resolves to one or more hosts + + 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. The regular expression is matched against @@ -1897,16 +1932,18 @@ meta/conf/machine/include//arch-.inc Stopping these builds is particularly useful with kernels. The variable also helps to increase parsing speed since the build system skips parsing recipes not - compatible with the current system. + compatible with the current system. + - COMPATIBLE_MACHINE + COMPATIBLE_MACHINE COMPATIBLE_MACHINE[doc] = "A regular expression that resolves to one or more target machines with which a recipe is compatible." - A regular expression that resolves to one or more + + A regular expression that resolves to one or more target machines with which a recipe is compatible. The regular expression is matched against MACHINEOVERRIDES. @@ -1915,16 +1952,17 @@ meta/conf/machine/include//arch-.inc Stopping these builds is particularly useful with kernels. The variable also helps to increase parsing speed since the build system skips parsing recipes not - compatible with the current machine. + compatible with the current machine. + - COMPLEMENTARY_GLOB + COMPLEMENTARY_GLOB COMPLEMENTARY_GLOB[doc] = "Defines wildcards to match when installing a list of complementary packages for all the packages installed in an image." - + Defines wildcards to match when installing a list of complementary packages for all the packages explicitly (or implicitly) installed in an image. @@ -1949,12 +1987,12 @@ meta/conf/machine/include//arch-.inc - CONF_VERSION + CONF_VERSION CONF_VERSION[doc] = "Tracks the version of local.conf. Increased each time build/conf/ changes incompatibly." - + Tracks the version of the local configuration file (i.e. local.conf). The value for CONF_VERSION @@ -1963,12 +2001,13 @@ meta/conf/machine/include//arch-.inc - CONFFILES + + CONFFILES CONFFILES[doc] = "Identifies editable or configurable files that are part of a package." - + 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 @@ -2016,12 +2055,12 @@ meta/conf/machine/include//arch-.inc - CONFIG_INITRAMFS_SOURCE + CONFIG_INITRAMFS_SOURCE CONFIG_INITRAMFS_SOURCE[doc] = "Identifies the initial RAM disk (initramfs) source files. The OpenEmbedded build system receives and uses this kernel Kconfig variable as an environment variable." - + Identifies the initial RAM disk (initramfs) source files. The OpenEmbedded build system receives and uses this kernel Kconfig variable as an environment variable. @@ -2051,12 +2090,12 @@ meta/conf/machine/include//arch-.inc - CONFIG_SITE + CONFIG_SITE CONFIG_SITE[doc] = "A list of files that contains autoconf test results relevant to the current build. This variable is used by the Autotools utilities when running configure." - + A list of files that contains autoconf test results relevant to the current build. This variable is used by the Autotools utilities when running @@ -2065,23 +2104,23 @@ meta/conf/machine/include//arch-.inc - CONFIGURE_FLAGS + CONFIGURE_FLAGS CONFIGURE_FLAGS[doc] = "The minimal arguments for GNU configure." - + The minimal arguments for GNU configure. - CONFLICT_DISTRO_FEATURES + CONFLICT_DISTRO_FEATURES CONFLICT_DISTRO_FEATURES[doc] = "When a recipe inherits the distro_features_check class, this variable identifies distribution features that would be in conflict should the recipe be built." - + When inheriting the distro_features_check class, this @@ -2098,12 +2137,12 @@ meta/conf/machine/include//arch-.inc - COPY_LIC_DIRS + COPY_LIC_DIRS COPY_LIC_DIRS[doc] = "If set to "1" along with the COPY_LIC_MANIFEST variable, the OpenEmbedded build system copies into the image the license files, which are located in /usr/share/common-licenses, for each package." - + If set to "1" along with the COPY_LIC_MANIFEST variable, the OpenEmbedded build system copies @@ -2112,16 +2151,16 @@ meta/conf/machine/include//arch-.inc for each package. The license files are placed in directories within the image itself. - + - COPY_LIC_MANIFEST + COPY_LIC_MANIFEST COPY_LIC_MANIFEST[doc] = "If set to "1", the OpenEmbedded build system copies the license manifest for the image to /usr/share/common-licenses/license.manifest within the image itself." - + If set to "1", the OpenEmbedded build system copies the license manifest for the image to /usr/share/common-licenses/license.manifest @@ -2130,12 +2169,12 @@ meta/conf/machine/include//arch-.inc - CORE_IMAGE_EXTRA_INSTALL + CORE_IMAGE_EXTRA_INSTALL CORE_IMAGE_EXTRA_INSTALL[doc] = "Specifies the list of packages to be added to the image. You should only set this variable in the conf/local.conf file in the Build Directory." - + Specifies the list of packages to be added to the image. You should only set this variable in the local.conf configuration file found @@ -2149,12 +2188,12 @@ meta/conf/machine/include//arch-.inc - COREBASE + COREBASE COREBASE[doc] = "Specifies the parent directory of the OpenEmbedded Core Metadata layer (i.e. meta)." - + Specifies the parent directory of the OpenEmbedded Core Metadata layer (i.e. meta). @@ -2174,24 +2213,24 @@ meta/conf/machine/include//arch-.inc - CPP + CPP CPP[doc] = "Minimum command and arguments to run the C preprocessor." - + The minimal command and arguments used to run the C preprocessor. - CPPFLAGS + CPPFLAGS CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers)." - + 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 @@ -2222,12 +2261,12 @@ meta/conf/machine/include//arch-.inc - CROSS_COMPILE + CROSS_COMPILE CROSS_COMPILE[doc] = "The toolchain binary prefix for the target tools." - + The toolchain binary prefix for the target tools. The CROSS_COMPILE variable is the same as the @@ -2243,36 +2282,36 @@ meta/conf/machine/include//arch-.inc - CVSDIR + CVSDIR CVSDIR[doc] = "The directory where cvs checkouts will be stored in." - + The directory in which files checked out under the CVS system are stored. - CXX + CXX CXX[doc] = "Minimum command and arguments to run the C++ compiler." - + The minimal command and arguments used to run the C++ compiler. - CXXFLAGS + CXXFLAGS CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler." - + 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 @@ -2306,12 +2345,12 @@ meta/conf/machine/include//arch-.inc D - D + D D[doc] = "The destination directory." - + The destination directory. The location in the Build Directory where components are installed by the @@ -2325,12 +2364,12 @@ meta/conf/machine/include//arch-.inc - DATE + DATE DATE[doc] = "The date the build was started using YMD format." - + The date the build was started. Dates appear using the year, month, and day (YMD) format (e.g. "20150209" for February 9th, 2015). @@ -2338,24 +2377,24 @@ meta/conf/machine/include//arch-.inc - DATETIME + DATETIME DATETIME[doc] = "The date and time the build was started." - + The date and time on which the current build started. The format is suitable for timestamps. - DEBIAN_NOAUTONAME + DEBIAN_NOAUTONAME DEBIAN_NOAUTONAME[doc] = "Prevents a particular package from being renamed according to Debian package naming." - + When the debian class is inherited, which is the default behavior, @@ -2373,12 +2412,12 @@ meta/conf/machine/include//arch-.inc - DEBIANNAME + DEBIANNAME DEBIANNAME[doc] = "Allows you to override the library name for an individual package for Debian library package renaming." - + When the debian class is inherited, which is the default behavior, @@ -2396,12 +2435,12 @@ meta/conf/machine/include//arch-.inc - DEBUG_BUILD + DEBUG_BUILD DEBUG_BUILD[doc] = "Specifies to build packages with debugging information. This influences the value of the SELECTED_OPTIMIZATION variable." - + Specifies to build packages with debugging information. This influences the value of the SELECTED_OPTIMIZATION @@ -2410,12 +2449,12 @@ meta/conf/machine/include//arch-.inc - DEBUG_OPTIMIZATION + DEBUG_OPTIMIZATION DEBUG_OPTIMIZATION[doc] = "The options to pass in TARGET_CFLAGS and CFLAGS when compiling a system for debugging. This variable defaults to '-O -fno-omit-frame-pointer -g'." - + The options to pass in TARGET_CFLAGS and CFLAGS when compiling @@ -2425,14 +2464,15 @@ meta/conf/machine/include//arch-.inc - DEFAULT_PREFERENCE + DEFAULT_PREFERENCE DEFAULT_PREFERENCE[doc] = "Specifies a weak bias for recipe selection priority." - + Specifies a weak bias for recipe selection priority. + The most common usage of this is variable is to set it to "-1" within a recipe for a development version of a @@ -2442,6 +2482,7 @@ meta/conf/machine/include//arch-.inc PREFERRED_VERSION being used to build the development version. + The bias provided by DEFAULT_PREFERENCE is weak and is overridden by @@ -2452,12 +2493,12 @@ meta/conf/machine/include//arch-.inc - DEFAULTTUNE + DEFAULTTUNE DEFAULTTUNE[doc] = "The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system." - + The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system. @@ -2476,12 +2517,12 @@ meta/conf/machine/include//arch-.inc - DEPENDS + DEPENDS DEPENDS[doc] = "Lists a recipe's build-time dependencies (i.e. other recipe files)." - + Lists a recipe's build-time dependencies (i.e. other recipe files). The system ensures that all the dependencies listed @@ -2514,12 +2555,12 @@ meta/conf/machine/include//arch-.inc - DEPLOY_DIR + DEPLOY_DIR DEPLOY_DIR[doc] = "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." - + 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. @@ -2542,12 +2583,12 @@ meta/conf/machine/include//arch-.inc - DEPLOY_DIR_IMAGE + DEPLOY_DIR_IMAGE DEPLOY_DIR_IMAGE[doc] = "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." - + 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. @@ -2572,12 +2613,12 @@ meta/conf/machine/include//arch-.inc - DEPLOYDIR + DEPLOYDIR DEPLOYDIR[doc] = "For recipes that inherit the deploy class, the DEPLOYDIR points to a temporary work area for deployed files." - + When inheriting the deploy class, the DEPLOYDIR points to a @@ -2586,6 +2627,9 @@ meta/conf/machine/include//arch-.inc DEPLOYDIR = "${WORKDIR}/deploy-${PN}" + + + Recipes inheriting the deploy class should copy files to be deployed into DEPLOYDIR, and the class will take @@ -2596,26 +2640,27 @@ meta/conf/machine/include//arch-.inc - DESCRIPTION + DESCRIPTION DESCRIPTION[doc] = "The package description used by package managers. If not set, DESCRIPTION takes the value of the SUMMARY variable." - The package description used by package managers. - If not set, DESCRIPTION takes - the value of the - SUMMARY - variable. + + The package description used by package managers. + If not set, DESCRIPTION takes + the value of the + SUMMARY + variable. - DISK_SIGNATURE + DISK_SIGNATURE DISK_SIGNATURE[doc] = "A 32-bit MBR disk signature used by directdisk images." - + A 32-bit MBR disk signature used by directdisk images. @@ -2663,12 +2708,12 @@ meta/conf/machine/include//arch-.inc - DISTRO + DISTRO DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used." - + The short name of the distribution. This variable corresponds to a distribution configuration file whose root name is the same as the @@ -2708,23 +2753,23 @@ meta/conf/machine/include//arch-.inc - DISTRO_CODENAME + DISTRO_CODENAME DISTRO_CODENAME[doc] = "Specifies a codename for the distribution being built." - + Specifies a codename for the distribution being built. - DISTRO_EXTRA_RDEPENDS + DISTRO_EXTRA_RDEPENDS DISTRO_EXTRA_RDEPENDS[doc] = "Specifies a list of distro-specific packages to add to all images. The variable only applies to the images that include packagegroup-base." - + Specifies a list of distro-specific packages to add to all images. This variable takes affect through packagegroup-base so the @@ -2738,12 +2783,12 @@ meta/conf/machine/include//arch-.inc - DISTRO_EXTRA_RRECOMMENDS + DISTRO_EXTRA_RRECOMMENDS DISTRO_EXTRA_RRECOMMENDS[doc] = "Specifies a list of distro-specific packages to add to all images if the packages exist. The list of packages are automatically installed but you can remove them." - + 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). @@ -2753,12 +2798,12 @@ meta/conf/machine/include//arch-.inc - DISTRO_FEATURES + DISTRO_FEATURES DISTRO_FEATURES[doc] = "The features enabled for the distribution." - + The software support you want in your distribution for various features. You define your distribution features in the distribution @@ -2789,12 +2834,13 @@ meta/conf/machine/include//arch-.inc - DISTRO_FEATURES_BACKFILL + DISTRO_FEATURES_BACKFILL DISTRO_FEATURES_BACKFILL[doc] = "Features to be added to DISTRO_FEATURES if not also present in DISTRO_FEATURES_BACKFILL_CONSIDERED. This variable is set in the meta/conf/bitbake.conf file and it is not intended to be user-configurable." - Features to be added to + + Features to be added to DISTRO_FEATURES if not also present in DISTRO_FEATURES_BACKFILL_CONSIDERED. @@ -2811,28 +2857,29 @@ meta/conf/machine/include//arch-.inc - DISTRO_FEATURES_BACKFILL_CONSIDERED + DISTRO_FEATURES_BACKFILL_CONSIDERED DISTRO_FEATURES_BACKFILL_CONSIDERED[doc] = "Features from DISTRO_FEATURES_BACKFILL that should not be backfilled (i.e. added to DISTRO_FEATURES) during the build." - Features from + + Features from DISTRO_FEATURES_BACKFILL that should not be backfilled (i.e. added to DISTRO_FEATURES) during the build. See the "Feature Backfilling" section for more information. - + - DISTRO_FEATURES_DEFAULT + DISTRO_FEATURES_DEFAULT DISTRO_FEATURES_DEFAULT[doc] = "Provides the default list of distro features with the exception of any libc-specific features." - + A convenience variable that gives you the default list of distro features with the exception of any features specific to the C library @@ -2854,12 +2901,12 @@ meta/conf/machine/include//arch-.inc - DISTRO_FEATURES_LIBC + DISTRO_FEATURES_LIBC DISTRO_FEATURES_LIBC[doc] = "Specifies the list of distro features that are specific to the C library (libc)." - + A convenience variable that specifies the list of distro features that are specific to the C library (libc). @@ -2870,30 +2917,34 @@ meta/conf/machine/include//arch-.inc - DISTRO_NAME + DISTRO_NAME DISTRO_NAME[doc] = "The long name of the distribution." - The long name of the distribution. + + The long name of the distribution. + - DISTRO_VERSION + DISTRO_VERSION DISTRO_VERSION[doc] = "The version of the distribution." - The version of the distribution. + + The version of the distribution. + - DISTROOVERRIDES + DISTROOVERRIDES DISTROOVERRIDES[doc] = "Lists overrides specific to the current distribution. By default, the variable list includes the value of the DISTRO variable." - + This variable lists overrides specific to the current distribution. By default, the variable list includes the value of the @@ -2907,12 +2958,12 @@ meta/conf/machine/include//arch-.inc - DL_DIR + DL_DIR DL_DIR[doc] = "The central download directory used by the build process to store downloads. By default, the directory is 'downloads' in the Build Directory." - + The central download directory used by the build process to store downloads. By default, DL_DIR gets files @@ -2966,12 +3017,12 @@ meta/conf/machine/include//arch-.inc - DOC_COMPRESS + DOC_COMPRESS DOC_COMPRESS[doc] = "When inheriting the compress_doc class, this variable sets the compression policy used when the OpenEmbedded build system compresses man pages and info pages." - + When inheriting the compress_doc class, this variable sets the compression policy used when @@ -2993,12 +3044,12 @@ meta/conf/machine/include//arch-.inc E - EFI_PROVIDER + EFI_PROVIDER EFI_PROVIDER[doc] = "When building bootable images (i.e. where hddimg or vmdk is in IMAGE_FSTYPES), the EFI_PROVIDER variable specifies the EFI bootloader to use." - + When building bootable images (i.e. where hddimg or vmdk is in @@ -3017,24 +3068,26 @@ meta/conf/machine/include//arch-.inc - ENABLE_BINARY_LOCALE_GENERATION + ENABLE_BINARY_LOCALE_GENERATION ENABLE_BINARY_LOCALE_GENERATION[doc] = "Controls which locales for glibc are generated during the build. The variable is useful if the target device has 64Mbytes of RAM or less." - Variable that controls which locales for + + Variable that controls which locales for glibc are generated during the build (useful if the target device has 64Mbytes - of RAM or less). + of RAM or less). + - ERR_REPORT_DIR + ERR_REPORT_DIR ERR_REPORT_DIR[doc] = "When used with the report-error class, specifies the path used for storing the debug files created by the error reporting tool, which allows you to submit build errors you encounter to a central database." - + When used with the report-error class, specifies the path used for storing the debug files @@ -3057,12 +3110,12 @@ meta/conf/machine/include//arch-.inc - ERROR_QA + ERROR_QA ERROR_QA[doc] = "Specifies the quality assurance checks whose failures are reported as errors by the OpenEmbedded build system." - + Specifies the quality assurance checks whose failures are reported as errors by the OpenEmbedded build system. You set this variable in your distribution configuration @@ -3075,12 +3128,12 @@ meta/conf/machine/include//arch-.inc - EXCLUDE_FROM_WORLD + EXCLUDE_FROM_WORLD EXCLUDE_FROM_WORLD[doc] = "Directs BitBake to exclude a recipe from world builds (i.e. bitbake world)." - + Directs BitBake to exclude a recipe from world builds (i.e. bitbake world). During world builds, BitBake locates, parses and builds all @@ -3104,12 +3157,12 @@ meta/conf/machine/include//arch-.inc - EXTENDPE + EXTENDPE EXTENDPE[doc] = "Used with file and pathnames to create a prefix for a recipe's version based on the recipe's PE value. If PE is set and greater than zero for a recipe, EXTENDPE becomes that value." - + Used with file and pathnames to create a prefix for a recipe's version based on the recipe's PE value. @@ -3125,12 +3178,12 @@ meta/conf/machine/include//arch-.inc - EXTENDPKGV + EXTENDPKGV EXTENDPKGV[doc] = "The full package version specification as it appears on the final packages produced by a recipe." - + 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 @@ -3149,12 +3202,12 @@ meta/conf/machine/include//arch-.inc - EXTERNALSRC + EXTERNALSRC EXTERNALSRC[doc] = "If externalsrc.bbclass is inherited, this variable points to the source tree, which is outside of the OpenEmbedded build system." - + When inheriting the externalsrc class, this variable points to the source tree, which is @@ -3178,12 +3231,12 @@ meta/conf/machine/include//arch-.inc - EXTERNALSRC_BUILD + EXTERNALSRC_BUILD EXTERNALSRC_BUILD[doc] = "If externalsrc.bbclass is inherited, this variable points to the directory in which the recipe's source code is built, which is outside of the OpenEmbedded build system." - + When inheriting the externalsrc class, this variable points to the directory in which the @@ -3208,12 +3261,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_AUTORECONF + EXTRA_AUTORECONF EXTRA_AUTORECONF[doc] = "Extra options passed to the autoreconf command, which is executed during do_configure." - + For recipes inheriting the autotools class, you can use EXTRA_AUTORECONF to @@ -3230,12 +3283,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_IMAGE_FEATURES + EXTRA_IMAGE_FEATURES EXTRA_IMAGE_FEATURES[doc] = "The list of additional features to include in an image. Configure this variable in the conf/local.conf file in the Build Directory." - + The list of additional features to include in an image. Typically, you configure this variable in your local.conf file, which is found in the @@ -3308,12 +3361,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_IMAGECMD + EXTRA_IMAGECMD EXTRA_IMAGECMD[doc] = "Specifies additional options for the image creation command that has been specified in IMAGE_CMD. When setting this variable, you should use an override for the associated type." - + Specifies additional options for the image creation command that has been specified in IMAGE_CMD. @@ -3327,20 +3380,24 @@ meta/conf/machine/include//arch-.inc - EXTRA_IMAGEDEPENDS + EXTRA_IMAGEDEPENDS EXTRA_IMAGEDEPENDS[doc] = "A list of recipes to build that do not provide packages for installing into the root filesystem. Use this variable to list recipes that are required to build the final image, but not needed in the root filesystem." - A list of recipes to build that do not provide packages + + A list of recipes to build that do not provide packages for installing into the root filesystem. - Sometimes a recipe is required to build the final image but is not + + + Sometimes a recipe is required to build the final image but is not needed in the root filesystem. You can use the EXTRA_IMAGEDEPENDS variable to list these recipes and thus specify the dependencies. A typical example is a required bootloader in a machine configuration. + To add packages to the root filesystem, see the various *RDEPENDS @@ -3350,39 +3407,45 @@ meta/conf/machine/include//arch-.inc - EXTRA_OECMAKE + EXTRA_OECMAKE EXTRA_OECMAKE[doc] = "Additional cmake options." - Additional cmake options. + + Additional cmake options. + - EXTRA_OECONF + EXTRA_OECONF EXTRA_OECONF[doc] = "Additional configure script options." - Additional configure script options. + + Additional configure script options. + - EXTRA_OEMAKE + EXTRA_OEMAKE EXTRA_OEMAKE[doc] = "Additional GNU make options." - Additional GNU make options. + + Additional GNU make options. + - EXTRA_OESCONS + EXTRA_OESCONS EXTRA_OESCONS[doc] = "When a recipe inherits the scons class, this variable specifies additional configuration options you want to pass to the scons command line." - + When inheriting the scons class, this variable specifies additional configuration @@ -3392,12 +3455,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_QMAKEVARS_POST + EXTRA_QMAKEVARS_POST EXTRA_QMAKEVARS_POST[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be after the .pro file list on the command line." - + Configuration variables or options you want to pass to qmake. Use this variable when the arguments need to be after the @@ -3413,12 +3476,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_QMAKEVARS_PRE + EXTRA_QMAKEVARS_PRE EXTRA_QMAKEVARS_PRE[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be before the .pro file list on the command line." - + Configuration variables or options you want to pass to qmake. Use this variable when the arguments need to be before the @@ -3434,12 +3497,12 @@ meta/conf/machine/include//arch-.inc - EXTRA_USERS_PARAMS + EXTRA_USERS_PARAMS EXTRA_USERS_PARAMS[doc] = "When a recipe inherits the extrausers class, this variable provides image level user and group operations." - + When inheriting the extrausers class, this variable provides image level user and group @@ -3475,12 +3538,12 @@ meta/conf/machine/include//arch-.inc F - FEATURE_PACKAGES + FEATURE_PACKAGES FEATURE_PACKAGES[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES. When setting the value, FEATURE_PACKAGES should have the name of the feature item as an override." - + Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES. @@ -3490,6 +3553,9 @@ meta/conf/machine/include//arch-.inc FEATURE_PACKAGES_widget = "package1 package2" + + + In this example, if "widget" were added to IMAGE_FEATURES, package1 and package2 would be included in the image. @@ -3506,12 +3572,12 @@ meta/conf/machine/include//arch-.inc - FEED_DEPLOYDIR_BASE_URI + FEED_DEPLOYDIR_BASE_URI FEED_DEPLOYDIR_BASE_URI[doc] = "Allow to serve ipk deploy directory as an ad hoc feed (bogofeed). Set to base URL of the directory as exported by HTTP. Set of ad hoc feed configs will be generated in the image." - + 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 @@ -3536,12 +3602,12 @@ meta/conf/machine/include//arch-.inc - FILES + FILES FILES[doc] = "The list of directories or files that are placed in packages." - + The list of directories or files that are placed in packages. @@ -3586,12 +3652,12 @@ meta/conf/machine/include//arch-.inc - FILESEXTRAPATHS + FILESEXTRAPATHS FILESEXTRAPATHS[doc] = "Extends the search path the OpenEmbedded build system uses when looking for files and patches as it processes recipes and append files." - + Extends the search path the OpenEmbedded build system uses when looking for files and patches as it processes recipes and append files. @@ -3656,12 +3722,12 @@ meta/conf/machine/include//arch-.inc - FILESOVERRIDES + FILESOVERRIDES FILESOVERRIDES[doc] = "A subset of OVERRIDES used by the OpenEmbedded build system for creating FILESPATH." - + A subset of OVERRIDES used by the OpenEmbedded build system for creating FILESPATH. @@ -3687,12 +3753,12 @@ meta/conf/machine/include//arch-.inc - FILESPATH + FILESPATH FILESPATH[doc] = "The default set of directories the OpenEmbedded build system uses when searching for patches and files. It is defined in the base.bbclass class found in meta/classes in the Source Directory. Do not hand-edit the FILESPATH variable." - + 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 @@ -3733,18 +3799,20 @@ meta/conf/machine/include//arch-.inc - FILESYSTEM_PERMS_TABLES + FILESYSTEM_PERMS_TABLES FILESYSTEM_PERMS_TABLES[doc] = "Allows you to define your own file permissions settings table as part of your configuration for the packaging process." - Allows you to define your own file permissions settings table as part of + + 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 a set of groups and users across an entire work project. It is best to do this in the packages themselves but this is not always possible. + By default, the OpenEmbedded build system uses the fs-perms.txt, which is located in the meta/files folder in the @@ -3752,6 +3820,7 @@ meta/conf/machine/include//arch-.inc If you create your own file permissions setting table, you should place it in your layer or the distro's layer. + You define the FILESYSTEM_PERMS_TABLES variable in the conf/local.conf file, which is found in the @@ -3761,6 +3830,7 @@ meta/conf/machine/include//arch-.inc The paths you specify to these files must be defined within the BBPATH variable. + For guidance on how to create your own file permissions settings table file, examine the existing fs-perms.txt. @@ -3768,12 +3838,12 @@ meta/conf/machine/include//arch-.inc - FONT_EXTRA_RDEPENDS + FONT_EXTRA_RDEPENDS FONT_EXTRA_RDEPENDS[doc] = "When a recipe inherits the fontcache class, this variable specifies runtime dependencies for font packages. This variable defaults to 'fontconfig-utils'." - + When inheriting the fontcache class, this variable specifies the runtime dependencies @@ -3784,12 +3854,12 @@ meta/conf/machine/include//arch-.inc - FONT_PACKAGES + FONT_PACKAGES FONT_PACKAGES[doc] = "When a recipe inherits the fontcache class, this variable identifies packages containing font files that need to be cached by Fontconfig." - + When inheriting the fontcache class, this variable identifies packages containing font @@ -3803,12 +3873,12 @@ meta/conf/machine/include//arch-.inc - FULL_OPTIMIZATION + FULL_OPTIMIZATION FULL_OPTIMIZATION[doc]= "The options to pass in TARGET_CFLAGS and CFLAGS when compiling an optimized system. This variable defaults to '-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2'." - + The options to pass in TARGET_CFLAGS and CFLAGS @@ -3822,35 +3892,35 @@ meta/conf/machine/include//arch-.inc G - GDB + GDB GDB[doc] = "The minimal command and arguments to run the GNU Debugger." - + The minimal command and arguments to run the GNU Debugger. - GITDIR + GITDIR GITDIR[doc] = "The directory where Git clones will be stored." - + The directory in which a local copy of a Git repository is stored when it is cloned. - GLIBC_GENERATE_LOCALES + GLIBC_GENERATE_LOCALES GLIBC_GENERATE_LOCALES[doc]= "Specifies the list of GLIBC locales to generate should you not wish generate all LIBC locals, which can be time consuming." - + Specifies the list of GLIBC locales to generate should you not wish generate all LIBC locals, which can be time consuming. @@ -3860,6 +3930,9 @@ meta/conf/machine/include//arch-.inc IMAGE_LINGUAS appropriately. + + + You can set GLIBC_GENERATE_LOCALES in your local.conf file. By default, all locales are generated. @@ -3870,12 +3943,12 @@ meta/conf/machine/include//arch-.inc - GROUPADD_PARAM + GROUPADD_PARAM GROUPADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupadd command if you wish to add a group to the system when the package is installed." - + When inheriting the useradd class, this variable @@ -3898,12 +3971,12 @@ meta/conf/machine/include//arch-.inc - GROUPMEMS_PARAM + GROUPMEMS_PARAM GROUPMEMS_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupmems command if you wish to modify the members of a group when the package is installed." - + When inheriting the useradd class, this variable @@ -3921,12 +3994,12 @@ meta/conf/machine/include//arch-.inc - GRUB_GFXSERIAL + GRUB_GFXSERIAL GRUB_GFXSERIAL[doc] = "Configures the GNU GRand Unified Bootloader (GRUB) to have graphics and serial in the boot menu." - + Configures the GNU GRand Unified Bootloader (GRUB) to have graphics and serial in the boot menu. Set this variable to "1" in your @@ -3943,12 +4016,12 @@ meta/conf/machine/include//arch-.inc - GRUB_OPTS + GRUB_OPTS GRUB_OPTS[doc] = "Additional options to add to the GNU GRand Unified Bootloader (GRUB) configuration." - + Additional options to add to the GNU GRand Unified Bootloader (GRUB) configuration. Use a semi-colon character (;) to @@ -3964,12 +4037,12 @@ meta/conf/machine/include//arch-.inc - GRUB_TIMEOUT + GRUB_TIMEOUT GRUB_TIMEOUT[doc] = "Specifies the timeout before executing the default LABEL in the GNU GRand Unified Bootloader (GRUB)." - + Specifies the timeout before executing the default LABEL in the GNU GRand Unified Bootloader (GRUB). @@ -3984,12 +4057,12 @@ meta/conf/machine/include//arch-.inc - GTKIMMODULES_PACKAGES + GTKIMMODULES_PACKAGES GTKIMMODULES_PACKAGES[doc] = "For recipes that inherit the gtk-immodules-cache class, this variable specifies the packages that contain the GTK+ input method modules being installed when the modules are in packages other than the main package." - + When inheriting the gtk-immodules-cache class, this variable specifies the packages that contain the @@ -3999,12 +4072,12 @@ meta/conf/machine/include//arch-.inc - GUMMIBOOT_CFG + GUMMIBOOT_CFG GUMMIBOOT_CFG[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_CFG variable specifies the configuration file that should be used." - + When EFI_PROVIDER is set to "gummiboot", the @@ -4026,12 +4099,12 @@ meta/conf/machine/include//arch-.inc - GUMMIBOOT_ENTRIES + GUMMIBOOT_ENTRIES GUMMIBOOT_ENTRIES[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_ENTRIES variable specifies a list of entry files (*.conf) to be installed containing one boot entry per file." - + When EFI_PROVIDER is set to "gummiboot", the @@ -4055,12 +4128,12 @@ meta/conf/machine/include//arch-.inc - GUMMIBOOT_TIMEOUT + GUMMIBOOT_TIMEOUT GUMMIBOOT_TIMEOUT[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_TIMEOUT variable specifies the boot menu timeout in seconds." - + When EFI_PROVIDER is set to "gummiboot", the @@ -4086,23 +4159,25 @@ meta/conf/machine/include//arch-.inc H - HOMEPAGE + HOMEPAGE HOMEPAGE[doc] = "Website where more information about the software the recipe is building can be found." - Website where more information about the software the recipe is building - can be found. + + Website where more information about the software the recipe is building + can be found. + - HOST_ARCH + HOST_ARCH HOST_ARCH[doc] = "The name of the target architecture. Normally same as the TARGET_ARCH." - + The name of the target architecture, which is normally the same as TARGET_ARCH. @@ -4124,12 +4199,12 @@ meta/conf/machine/include//arch-.inc - HOST_CC_ARCH + HOST_CC_ARCH HOST_CC_ARCH[doc] = "The name of the host architecture. Normally same as the TARGET_CC_ARCH." - + Specifies architecture-specific compiler flags that are passed to the C compiler. @@ -4157,12 +4232,12 @@ meta/conf/machine/include//arch-.inc - HOST_OS + HOST_OS HOST_OS[doc] = "The name of the target operating system. Normally the same as the TARGET_OS." - + Specifies the name of the target operating system, which is normally the same as the TARGET_OS. @@ -4174,12 +4249,12 @@ meta/conf/machine/include//arch-.inc - HOST_PREFIX + HOST_PREFIX HOST_PREFIX[doc] = "The prefix for the cross compile toolchain. Normally same as the TARGET_PREFIX." - + Specifies the prefix for the cross-compile toolchain. HOST_PREFIX is normally the same as TARGET_PREFIX. @@ -4187,12 +4262,12 @@ meta/conf/machine/include//arch-.inc - HOST_SYS + HOST_SYS HOST_SYS[doc] = "Specifies the system, including the architecture and the operating system, for with the build is occurring in the context of the current recipe." - + Specifies the system, including the architecture and the operating system, for which the build is occurring in the context of the current recipe. @@ -4227,12 +4302,12 @@ meta/conf/machine/include//arch-.inc - HOST_VENDOR + HOST_VENDOR HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR." - + Specifies the name of the vendor. HOST_VENDOR is normally the same as TARGET_VENDOR. @@ -4244,12 +4319,12 @@ meta/conf/machine/include//arch-.inc I - ICECC_DISABLED + ICECC_DISABLED ICECC_DISABLED[doc] = "Disables or enables the icecc (Icecream) function." - + Disables or enables the icecc (Icecream) function. For more information on this function and best practices @@ -4272,12 +4347,12 @@ meta/conf/machine/include//arch-.inc - ICECC_ENV_EXEC + ICECC_ENV_EXEC ICECC_ENV_EXEC[doc] = "Points to the icecc-create-env script that you provide." - + Points to the icecc-create-env script that you provide. This variable is used by the @@ -4297,12 +4372,12 @@ meta/conf/machine/include//arch-.inc - ICECC_PARALLEL_MAKE + ICECC_PARALLEL_MAKE ICECC_PARALLEL_MAKE[doc] = "Extra options passed to the make command during the do_compile task that specify parallel compilation." - + Extra options passed to the make command during the do_compile @@ -4341,12 +4416,12 @@ meta/conf/machine/include//arch-.inc - ICECC_PATH + ICECC_PATH ICECC_PATH[doc] = "The location of the icecc binary." - + The location of the icecc binary. You can set this variable in your local.conf file. @@ -4359,12 +4434,12 @@ meta/conf/machine/include//arch-.inc - ICECC_USER_CLASS_BL + ICECC_USER_CLASS_BL ICECC_USER_CLASS_BL[doc] = "Identifies user classes that you do not want the Icecream distributed compile support to consider." - + Identifies user classes that you do not want the Icecream distributed compile support to consider. This variable is used by the @@ -4384,12 +4459,12 @@ meta/conf/machine/include//arch-.inc - ICECC_USER_PACKAGE_BL + ICECC_USER_PACKAGE_BL ICECC_USER_PACKAGE_BL[doc] = "Identifies user recipes that you do not want the Icecream distributed compile support to consider." - + Identifies user recipes that you do not want the Icecream distributed compile support to consider. This variable is used by the @@ -4409,12 +4484,12 @@ meta/conf/machine/include//arch-.inc - ICECC_USER_PACKAGE_WL + ICECC_USER_PACKAGE_WL ICECC_USER_PACKAGE_WL[doc] = "Identifies user recipes that use an empty PARALLEL_MAKE variable that you want to force remote distributed compilation on using the Icecream distributed compile support." - + Identifies user recipes that use an empty PARALLEL_MAKE variable that you want to force remote distributed @@ -4429,12 +4504,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_BASENAME + IMAGE_BASENAME IMAGE_BASENAME[doc] = "The base name of image output files." - + The base name of image output files. This variable defaults to the recipe name (${PN}). @@ -4442,12 +4517,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_BOOT_FILES + IMAGE_BOOT_FILES IMAGE_BOOT_FILES[doc] = "Whitespace separated list of files from ${DEPLOY_DIR_IMAGE} to place in boot partition. Entries will be installed under a same name as the source file. To change the destination file name, pass a desired name after a semicolon (eg. u-boot.img;uboot)." - + A space-separated list of files installed into the boot partition when preparing an image using the wic tool with the @@ -4465,6 +4540,9 @@ meta/conf/machine/include//arch-.inc IMAGE_BOOT_FILES = "u-boot.img uImage;kernel" IMAGE_BOOT_FILES = "u-boot.${UBOOT_SUFFIX} ${KERNEL_IMAGETYPE}" + + + Alternatively, source files can be picked up using a glob pattern. In this case, the destination file @@ -4488,12 +4566,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_CLASSES + IMAGE_CLASSES IMAGE_CLASSES[doc] = "A list of classes that all images should inherit." - + 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 @@ -4516,12 +4594,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_CMD + IMAGE_CMD IMAGE_CMD[doc] = "Specifies the command to create the image file for a specific image type, which corresponds to the value set set in IMAGE_FSTYPES, (e.g. ext3, btrfs, and so forth)." - + Specifies the command to create the image file for a specific image type, which corresponds to the value set set in @@ -4536,6 +4614,9 @@ meta/conf/machine/include//arch-.inc --faketime --output=${DEPLOY_DIR_IMAGE}/${IMAGE_NAME}.rootfs.jffs2 \ ${EXTRA_IMAGECMD}" + + + You typically do not need to set this variable unless you are adding support for a new image type. For more examples on how to set this variable, see the @@ -4546,12 +4627,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_DEVICE_TABLES + IMAGE_DEVICE_TABLES IMAGE_DEVICE_TABLES[doc] = "Specifies one or more files that contain custom device tables that are passed to the makedevs command as part of creating an image." - + Specifies one or more files that contain custom device tables that are passed to the makedevs command as part of creating @@ -4569,12 +4650,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_FEATURES + IMAGE_FEATURES IMAGE_FEATURES[doc] = "The primary list of features to include in an image. Configure this variable in an image recipe." - + 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 @@ -4586,6 +4667,9 @@ meta/conf/machine/include//arch-.inc use the EXTRA_IMAGE_FEATURES variable. + + + For a list of image features that ships with the Yocto Project, see the "Image Features" @@ -4601,12 +4685,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_FSTYPES + IMAGE_FSTYPES IMAGE_FSTYPES[doc] = "Formats of root filesystem images that you want to have created." - + Specifies the formats the OpenEmbedded build system uses during the build when creating the root filesystem. For example, setting IMAGE_FSTYPES @@ -4616,6 +4700,9 @@ meta/conf/machine/include//arch-.inc IMAGE_FSTYPES = "ext3 tar.bz2" + + + For the complete list of supported image formats from which you can choose, see IMAGE_TYPES. @@ -4639,12 +4726,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_INSTALL + IMAGE_INSTALL IMAGE_INSTALL[doc] = "Specifies the packages to install into an image. Image recipes set IMAGE_INSTALL to specify the packages to install into an image through image.bbclass." - + Specifies the packages to install into an image. The IMAGE_INSTALL variable is a mechanism for an image recipe and you should use it @@ -4705,12 +4792,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_LINGUAS + IMAGE_LINGUAS IMAGE_LINGUAS[doc] = "Specifies the list of locales to install into the image during the root filesystem construction process." - + Specifies the list of locales to install into the image during the root filesystem construction process. The OpenEmbedded build system automatically splits locale @@ -4724,6 +4811,9 @@ meta/conf/machine/include//arch-.inc IMAGE_LINGUAS = "pt-br de-de" + + + In this example, the build system ensures any Brazilian Portuguese and German locale files that correspond to packages in the image are installed (i.e. @@ -4743,12 +4833,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_MANIFEST + IMAGE_MANIFEST IMAGE_MANIFEST[doc] = "The manifest file for the image. This file lists all the installed packages that make up the image." - + The manifest file for the image. This file lists all the installed packages that make up the image. @@ -4779,12 +4869,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_NAME + IMAGE_NAME IMAGE_NAME[doc] = "The name of the output image files minus the extension." - + The name of the output image files minus the extension. This variable is derived using the IMAGE_BASENAME, @@ -4799,12 +4889,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_OVERHEAD_FACTOR + IMAGE_OVERHEAD_FACTOR IMAGE_OVERHEAD_FACTOR[doc] = "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 IMAGE_ROOTFS_SIZE and IMAGE_ROOTFS_EXTRA_SPACE." - + 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 @@ -4844,12 +4934,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_PKGTYPE + IMAGE_PKGTYPE IMAGE_PKGTYPE[doc] = "Defines the package type (DEB, RPM, IPK, or TAR) used by the OpenEmbedded build system." - + Defines the package type (DEB, RPM, IPK, or TAR) used by the OpenEmbedded build system. The variable is defined appropriately by the @@ -4895,18 +4985,21 @@ meta/conf/machine/include//arch-.inc - IMAGE_POSTPROCESS_COMMAND + IMAGE_POSTPROCESS_COMMAND IMAGE_POSTPROCESS_COMMAND[doc] = "Added by classes to run post processing commands once the OpenEmbedded build system has created the image." - + Added by classes to run post processing commands once the OpenEmbedded build system has created the image. You can specify shell commands separated by semicolons: IMAGE_POSTPROCESS_COMMAND += "shell_command; ... " + + + If you need to pass the path to the root filesystem within the command, you can use ${IMAGE_ROOTFS}, which points to @@ -4915,12 +5008,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_ROOTFS + IMAGE_ROOTFS IMAGE_ROOTFS[doc] = "The location of the root filesystem while it is under construction (i.e. during do_rootfs)." - + The location of the root filesystem while it is under construction (i.e. during the do_rootfs @@ -4931,12 +5024,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_ROOTFS_ALIGNMENT + IMAGE_ROOTFS_ALIGNMENT IMAGE_ROOTFS_ALIGNMENT[doc] = "Specifies the alignment for the output image file in Kbytes." - + Specifies the alignment for the output image file in Kbytes. If the size of the image is not a multiple of @@ -4950,12 +5043,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_ROOTFS_EXTRA_SPACE + IMAGE_ROOTFS_EXTRA_SPACE IMAGE_ROOTFS_EXTRA_SPACE[doc] = "Defines additional free disk space created in the image in Kbytes. By default, this variable is set to '0'." - + 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 @@ -4984,12 +5077,12 @@ meta/conf/machine/include//arch-.inc - IMAGE_ROOTFS_SIZE + IMAGE_ROOTFS_SIZE IMAGE_ROOTFS_SIZE[doc] = "Defines the size in Kbytes for the generated image." - + 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 @@ -5017,8 +5110,11 @@ meta/conf/machine/include//arch-.inc xspace = IMAGE_ROOTFS_EXTRA_SPACE - See the IMAGE_OVERHEAD_FACTOR - and IMAGE_ROOTFS_EXTRA_SPACE + + + + See the IMAGE_OVERHEAD_FACTOR + and IMAGE_ROOTFS_EXTRA_SPACE variables for related information.