From d5ae7d902a40f26a8c26f4c6d300226689738716 Mon Sep 17 00:00:00 2001 From: Brad Bishop Date: Thu, 14 Jun 2018 09:52:03 -0700 Subject: Sumo refresh Update external subtrees to latest Yocto sumo. Change-Id: I8364f32bef079841c6e57f1c587f4b1bedf62fef Signed-off-by: Brad Bishop --- poky/documentation/ref-manual/ref-variables.xml | 134 +++++++++++++++++++++--- 1 file changed, 119 insertions(+), 15 deletions(-) (limited to 'poky/documentation/ref-manual/ref-variables.xml') diff --git a/poky/documentation/ref-manual/ref-variables.xml b/poky/documentation/ref-manual/ref-variables.xml index 1c55a92d1..e88389647 100644 --- a/poky/documentation/ref-manual/ref-variables.xml +++ b/poky/documentation/ref-manual/ref-variables.xml @@ -3636,10 +3636,17 @@ The short name of the distribution. - This variable corresponds to a distribution - configuration file whose root name is the same as the - variable's argument and whose filename extension is - .conf. + For information on the long name of the distribution, see + the + DISTRO_NAME + variable. + + + + The DISTRO variable corresponds to a + distribution configuration file whose root name is the + same as the variable's argument and whose filename + extension is .conf. For example, the distribution configuration file for the Poky distribution is named poky.conf and resides in the @@ -3664,9 +3671,9 @@ The value for DISTRO must not contain spaces, and is typically all lower-case. - If the DISTRO variable is blank, a set - of default configurations are used, which are specified - within + If the DISTRO variable is blank, + a set of default configurations are used, which are + specified within meta/conf/distro/defaultsetup.conf also in the Source Directory. @@ -3931,6 +3938,46 @@ The long name of the distribution. + For information on the short name of the distribution, see + the + DISTRO + variable. + + + + The DISTRO_NAME variable corresponds + to a distribution configuration file whose root name is the + same as the variable's argument and whose filename + extension is .conf. + For example, the distribution configuration file for the + Poky distribution is named poky.conf + and resides in the + meta-poky/conf/distro directory of + the + Source Directory. + + + + Within that poky.conf file, the + DISTRO_NAME variable is set as + follows: + + DISTRO_NAME = "Poky (Yocto Project Reference Distro)" + + + + + Distribution configuration files are located in a + conf/distro directory within the + Metadata + that contains the distribution configuration. + + If the DISTRO_NAME variable is + blank, a set of default configurations are used, which + are specified within + meta/conf/distro/defaultsetup.conf + also in the Source Directory. + @@ -9917,7 +9964,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" execute at rootfs creation time rather than on the target but depends on a native tool in order to execute, you need to list the tools in - PACKAGE_WRITE_DEPENDS. + PACKAGE_WRITE_DEPS. @@ -12175,13 +12222,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" A list of classes to remove from the INHERIT value globally within the extensible SDK configuration. - The default value is "buildhistory icecc". + The + populate-sdk-ext + class sets the default value: + + SDK_INHERIT_BLACKLIST ?= "buildhistory icecc" + Some classes are not generally applicable within - the extensible SDK context and you can use this variable - to disable them. + the extensible SDK context. + You can use this variable to disable those classes. + + + + For additional information on how to customize the + extensible SDK's configuration, see the + "Configuring the Extensible SDK" + section in the Yocto Project Application Development and + the Extensible Software Development Kit (eSDK) manual. @@ -12193,12 +12253,40 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" - A list of variables not allowed through from the build - system configuration into the extensible SDK configuration. + A list of variables not allowed through from the + OpenEmbedded build system configuration into the extensible + SDK configuration. Usually, these are variables that are specific to the machine on which the build system is running and thus would be potentially problematic within the extensible SDK. + + + By default, + SDK_LOCAL_CONF_BLACKLIST is set in the + populate-sdk-ext + class and excludes the following variables: + + CONF_VERSION + BB_NUMBER_THREADS + BB_NUMBER_PARSE_THREADS + PARALLEL_MAKE + PRSERV_HOST + SSTATE_MIRRORS + DL_DIR + SSTATE_DIR + TMPDIR + BB_SERVER_TIMEOUT + + + + For additional information on how to customize the + extensible SDK's configuration, see the + "Configuring the Extensible SDK" + section in the Yocto Project Application Development and + the Extensible Software Development Kit (eSDK) manual. + + @@ -12209,8 +12297,16 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" - A list of variables allowed through from the build system - configuration into the extensible SDK configuration. + A list of variables allowed through from the OpenEmbedded + build system configuration into the extensible SDK + configuration. + By default, the list of variables is empty and is set in + the + populate-sdk-ext + class. + + + This list overrides the variables specified using the SDK_LOCAL_CONF_BLACKLIST variable as well as any variables identified by automatic @@ -12219,6 +12315,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" path and thus might not be valid on the system where the SDK is installed. + + + For additional information on how to customize the + extensible SDK's configuration, see the + "Configuring the Extensible SDK" + section in the Yocto Project Application Development and + the Extensible Software Development Kit (eSDK) manual. + -- cgit v1.2.1