summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2017-04-13 10:18:33 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-04-18 15:51:44 +0100
commit3db33448592f737515289edef6ed25d407fd8039 (patch)
treeb1d5e4cc2ca19d4827210f304c244506bfc74853 /documentation/dev-manual
parent1fa1a7f174593e41b8bcf6c2f19565d6da44e991 (diff)
downloadpoky-3db33448592f737515289edef6ed25d407fd8039.tar.gz
ref-manual, dev-manual: Updates to support recipe-specific sysroots
Changes covered several areas. Version 2.3 of the YP now supports recipe-specific sysroots and is not limited to machine-specific as was prior releases. Manual changes were as follows: dev-manual: "Sharing Files Between Recipes" - Wordings were changed to support the new functionality. ref-manual: do_prepare_recipe_sysroot task added to the list of tasks described in "Configuration and Compilation". ref-manual: Extensive re-write of the "staging.bbclass" section. ref-manual: Added a section to the build structure for build/tmp/work/tunearch/recipename/version/. This section breaks down the recipe-specific subdirectories used to create (stage) the sysroot. ref-manual: New section (entry) for the do_prepare_recipe_sysroot task in the task chapter. ref-manual: Added a variable glossary description for the SSTATE_SCAN_FILES variable. In addition to these changes, I sprinkled in a liberal amount of cross-referencing for the readers pleasure. (From yocto-docs rev: 3a8ca96861f4c5d3badb91d0cdc5a3df513d4e59) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml34
1 files changed, 17 insertions, 17 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index d2bd56dc13..e12fa32516 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -3193,10 +3193,11 @@
3193 access to the library itself and its associated headers. 3193 access to the library itself and its associated headers.
3194 The way this access is accomplished is by populating sysroot 3194 The way this access is accomplished is by populating sysroot
3195 with files. 3195 with files.
3196 One sysroot exists per "machine" for which the image is 3196 Each recipe has two sysroots in its work directory, one for
3197 being built. 3197 target files
3198 In practical terms, this means a sysroot exists for the target 3198 (<filename>recipe-sysroot</filename>) and one for files that
3199 machine, and a sysroot exists for the build host. 3199 are native to the build host
3200 (<filename>recipe-sysroot-native</filename>).
3200 <note> 3201 <note>
3201 You could find the term "staging" used within the Yocto 3202 You could find the term "staging" used within the Yocto
3202 project regarding files populating sysroot (e.g. the 3203 project regarding files populating sysroot (e.g. the
@@ -3214,12 +3215,6 @@
3214 task within the 3215 task within the
3215 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename> 3216 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename>
3216 directory. 3217 directory.
3217 </para>
3218
3219 <para>
3220 A subset of these files, as defined by the
3221 the <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>
3222 variable, automatically populates the sysroot.
3223 The reason for this limitation is that almost all files that 3218 The reason for this limitation is that almost all files that
3224 populate the sysroot are cataloged in manifests in order to 3219 populate the sysroot are cataloged in manifests in order to
3225 ensure the files can be removed later when a recipe is either 3220 ensure the files can be removed later when a recipe is either
@@ -3228,6 +3223,13 @@
3228 </para> 3223 </para>
3229 3224
3230 <para> 3225 <para>
3226 A subset of the files installed by the
3227 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-install'><filename>do_install</filename></ulink>
3228 task are used by the
3229 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
3230 task as defined by the the
3231 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>
3232 variable to automatically populate the sysroot.
3231 It is possible to modify the list of directories that populate 3233 It is possible to modify the list of directories that populate
3232 the sysroot. 3234 the sysroot.
3233 The following example shows how you could add the 3235 The following example shows how you could add the
@@ -3239,13 +3241,11 @@
3239 </para> 3241 </para>
3240 3242
3241 <para> 3243 <para>
3242 For information on variables you can use to help control how 3244 for a more complete description of the
3243 files sysroot is populated, see the 3245 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
3244 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>, 3246 task and its associated functions, see the
3245 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS_NATIVE'><filename>SYSROOT_DIRS_NATIVE</filename></ulink>, 3247 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-staging'><filename>staging</filename></ulink>
3246 and 3248 class.
3247 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS_BLACKLIST'><filename>SYSROOT_DIRS_BLACKLIST</filename></ulink>
3248 variables.
3249 </para> 3249 </para>
3250 </section> 3250 </section>
3251 3251