mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-09-19 18:49:32 +02:00
Code Issues Packages Projects Releases Wiki Activity

overview-manual: Updated the "Package Splitting" section.

Browse Source 
Rewrite included the "do_populate_sysroot" task and a bunch of
STAGING_DIR_* variables.

(From yocto-docs rev: 53484d4982a41f83ac9355aada46526b5d05f64a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-05-09 10:07:30 -07:00
committed by Richard Purdie
parent 6a70c9db88
commit 173f158121
1 changed files with 53 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
documentation/overview-manual/overview-manual-concepts.xml
View File

@@ -1312,7 +1312,8 @@
<filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename> <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename>
(i.e. <filename>recipe-sysroot</filename> and (i.e. <filename>recipe-sysroot</filename> and
<filename>recipe-sysroot-native</filename>) so that <filename>recipe-sysroot-native</filename>) so that
the sysroots contain the contents of the during the packaging phase the sysroots can contain
the contents of the
<ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
tasks of the recipes on which the recipe tasks of the recipes on which the recipe
containing the tasks depends. containing the tasks depends.
@@ -1398,37 +1399,74 @@
<ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-packagedata'><filename>do_packagedata</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-packagedata'><filename>do_packagedata</filename></ulink>
tasks combine to analyze the files found in the tasks combine to analyze the files found in the
<ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink>
directory (i.e. the staging area) and split them into directory and split them into subsets based on available
subsets based on available packages and files. packages and files.
Analysis involves the following as well as other items: Analysis involves the following as well as other items:
splitting out debugging symbols, looking at shared library splitting out debugging symbols, looking at shared library
dependencies between packages, and looking at package dependencies between packages, and looking at package
relationships. relationships.
</para>
<para>
The <filename>do_packagedata</filename> task creates The <filename>do_packagedata</filename> task creates
package metadata based on the analysis such that the package metadata based on the analysis such that the
build system can generate the final packages. build system can generate the final packages.
The
<ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
task stages (copies) a subset of the files installed by
the
<ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-install'><filename>do_install</filename></ulink>
task into the appropriate sysroot.
Working, staged, and intermediate results of the analysis Working, staged, and intermediate results of the analysis
and package splitting process use these areas: and package splitting process use several areas:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-PKGD'><filename>PKGD</filename></ulink>: <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGD'><filename>PKGD</filename></ulink>:
The destination directory for packages before they The destination directory
are split. (i.e. <filename>package</filename>) for packages
</para></listitem> before they are split into individual packages.
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></ulink>:
A shared, global-state directory that holds data
generated during the packaging process.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDESTWORK'><filename>PKGDESTWORK</filename></ulink>: <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDESTWORK'><filename>PKGDESTWORK</filename></ulink>:
A temporary work area used by the A temporary work area (i.e.
<filename>do_package</filename> task. <filename>pkgdata</filename>) used by the
<filename>do_package</filename> task to save
package metadata.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDEST'><filename>PKGDEST</filename></ulink>: <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDEST'><filename>PKGDEST</filename></ulink>:
The parent directory for packages after they have The parent directory (i.e.
been split. <filename>packages-split</filename>) for packages
after they have been split.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></ulink>:
A shared, global-state directory that holds
packaging metadata generated during the packaging
process.
The packaging process copies metadata from
<filename>PKGDESTWORK</filename> to the
<filename>PKGDATA_DIR</filename> area where it
becomes globally available.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_HOST'><filename>STAGING_DIR_HOST</filename></ulink>:
The path for the sysroot for the system on which
a component is built to run (i.e.
<filename>recipe-sysroot</filename>).
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_NATIVE'><filename>STAGING_DIR_NATIVE</filename></ulink>:
The path for the sysroot used when building
components for the build host (i.e.
<filename>recipe-sysroot-native</filename>).
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_TARGET'><filename>STAGING_DIR_TARGET</filename></ulink>:
The path for the sysroot used when a component that
is built to execute on a system and it generates
code for yet another machine (e.g. cross-canadian
recipes).
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
The The