From c5b4f69821c7b5ef9047c41198535eb900ea7b94 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 16 Feb 2016 15:42:55 -0800 Subject: ref-manual, dev-manual: Clarification of "native" and "sdknative" Fixes [YOCTO #8620] I went through and made some judgement calls on the use of "native" and "sdknative". I tried to make sure that the reader understood the real meaning of these terms. (From yocto-docs rev: d711e8c6dfb32a4ad79e9d11dbf44fbc759d0245) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 72 +++++++++++++++++------------- 1 file changed, 41 insertions(+), 31 deletions(-) (limited to 'documentation/ref-manual/ref-variables.xml') diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 4ca4e51d5d..71f4ca680c 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -1396,15 +1396,22 @@ 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-". + 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-. The exact list of suffixes removed is specified by the - SPECIAL_PKGSUFFIX variable. + SPECIAL_PKGSUFFIX + variable. The exact list of prefixes removed is specified by the - MLPREFIX variable. + MLPREFIX + variable. Prefixes are removed for multilib - and nativesdk cases. + and nativesdk- cases. @@ -1467,7 +1474,7 @@ 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. - When building in the native context, + When building in the -native context, CPPFLAGS is set to the value of this variable by default. @@ -1483,7 +1490,7 @@ Specifies the flags to pass to the C++ compiler when building for the build host. - When building in the native context, + When building in the -native context, CXXFLAGS is set to the value of this variable by default. @@ -1558,7 +1565,7 @@ The OpenEmbedded build system uses the BUILD_PREFIX value to set the TARGET_PREFIX - when building for native recipes. + when building for native recipes. @@ -1839,7 +1846,7 @@ Specifies the flags to pass to the C compiler when building for the SDK. - When building in the nativesdk + When building in the nativesdk- context, CFLAGS is set to the value of this variable by default. @@ -1857,7 +1864,7 @@ 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. - When building in the nativesdk + When building in the nativesdk- context, CPPFLAGS is set to the value of this variable by default. @@ -1874,7 +1881,7 @@ Specifies the flags to pass to the C++ compiler when building for the SDK. - When building in the nativesdk + When building in the nativesdk- context, CXXFLAGS is set to the value of this variable by default. @@ -2031,7 +2038,7 @@ and then can be used as an override. Here is an example where "python-native" is added to DEPENDS - only when building for the native case: + only when building for the -native case: DEPENDS_append_class-native = " python-native" @@ -2567,7 +2574,7 @@ BUILDSDK_CXXFLAGS when building for an SDK (i.e. - nativesdk) + nativesdk-) @@ -4736,12 +4743,12 @@ BUILD_CC_ARCH when building for the build host (i.e. - native) + -native) BUILDSDK_CC_ARCH when building for an SDK (i.e. - nativesdk) + nativesdk-) @@ -11898,14 +11905,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" For recipes building for the target machine, the value is "${STAGING_DIR}/${MACHINE}". - For native - recipes building + For native recipes building for the build host, the value is empty given the assumption that when building for the build host, the build host's own directories should be used. - For nativesdk - recipes that build for the SDK, the value is + For native SDK + recipes that build for the SDK + (nativesdk), the value is "${STAGING_DIR}/${MULTIMACH_HOST_SYS}". @@ -12713,12 +12720,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" "${TARGET_SYS}-". - For native recipes, the build - system sets the variable to the value of + For native recipes, the build system sets the + variable to the value of BUILD_PREFIX. - For nativesdk recipes, the + For native SDK recipes + (nativesdk), the build system sets the variable to the value of SDK_PREFIX. @@ -12757,9 +12765,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" Consider these two examples: - Given a native recipe on a - 32-bit, x86 machine running Linux, the value is - "i686-linux". + Given a native recipe on a 32-bit, x86 machine + running Linux, the value is "i686-linux". Given a recipe being built for a little-endian, @@ -13365,11 +13372,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" toolchain set that runs on the SDKMACHINE, and each package should usually have the prefix - "nativesdk-". - When building an SDK using - bitbake -c populate_sdk <imagename>, - a default list of packages is set in this variable, but - you can add additional packages to the list. + nativesdk-. + For example, consider the following command when + building an SDK: + + $ bitbake -c populate_sdk imagename + + In this case, a default list of packages is set in this + variable, but you can add additional packages to the list. -- cgit v1.2.3-54-g00ecf