diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-10-03 09:08:10 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-10-11 08:51:21 +0100 |
commit | 2083e83455cbf77da57b97cdda393bdb27bbce39 (patch) | |
tree | 3f8e5304ceadab67b4c23f60671b4c24f6bc506d /documentation | |
parent | c2c052e34a669db13586647ec6dea7324e8901c4 (diff) | |
download | openembedded-core-contrib-2083e83455cbf77da57b97cdda393bdb27bbce39.tar.gz |
ref-manual: Updated the STAGING_DIR_HOST variable description.
Fixes [YOCTO #10348]
Added a note clarifying that -native recipes are not installed
into host paths.
(From yocto-docs rev: c0b4265350b558eec296c93f0829c3d687950c52)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 33 |
1 files changed, 32 insertions, 1 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 6551ff6b90..753279cb5b 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -12696,9 +12696,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" Specifies the path to the sysroot directory for the system that the component is built to run on (the system that hosts the component). - This sysroot is the one that the recipe's + For most recipes, this sysroot is the one that the recipe's <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> task copies files into. + Exceptions include <filename>-native</filename> recipes, + where the <filename>do_populate_sysroot</filename> task + instead uses + <link linkend='var-STAGING_DIR_NATIVE'><filename>STAGING_DIR_NATIVE</filename></link>. Depending on the type of recipe and the build target, <filename>STAGING_DIR_HOST</filename> can have the following values: @@ -12718,6 +12722,33 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" "${STAGING_DIR}/${<link linkend='var-MULTIMACH_HOST_SYS'>MULTIMACH_HOST_SYS</link>}". </para></listitem> </itemizedlist> + <note><para> + <filename>-native</filename> recipes are not installed + into host paths like such as <filename>/usr</filename>. + Rather, these recipes are installed into + <filename>STAGING_DIR_NATIVE</filename>. + When compiling <filename>-native</filename> recipes, + standard build environment variables such as + <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link> + and + <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> + are set up so that both host paths and + <filename>STAGING_DIR_NATIVE</filename> are searched + for libraries and headers using, for example, + GCC's <filename>-isystem</filename> option.</para> + + <para>This emphasizes that the + <filename>STAGING_DIR*</filename> variables should be + viewed as input variables by tasks such as + <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>, + <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>, + and + <link linkend='ref-tasks-install'><filename>do_install</filename></link>. + Having the real system root correspond to + <filename>STAGING_DIR_HOST</filename> makes conceptual + sense for <filename>-native</filename> recipes, as + they make use of host headers and libraries.</para> + </note> </para> </glossdef> </glossentry> |