summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/overview-manual/overview-manual-concepts.xml66
1 files changed, 52 insertions, 14 deletions
diff --git a/documentation/overview-manual/overview-manual-concepts.xml b/documentation/overview-manual/overview-manual-concepts.xml
index a9cff85066..4797878312 100644
--- a/documentation/overview-manual/overview-manual-concepts.xml
+++ b/documentation/overview-manual/overview-manual-concepts.xml
@@ -1312,7 +1312,8 @@
1312 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename> 1312 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename>
1313 (i.e. <filename>recipe-sysroot</filename> and 1313 (i.e. <filename>recipe-sysroot</filename> and
1314 <filename>recipe-sysroot-native</filename>) so that 1314 <filename>recipe-sysroot-native</filename>) so that
1315 the sysroots contain the contents of the 1315 during the packaging phase the sysroots can contain
1316 the contents of the
1316 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink> 1317 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
1317 tasks of the recipes on which the recipe 1318 tasks of the recipes on which the recipe
1318 containing the tasks depends. 1319 containing the tasks depends.
@@ -1398,37 +1399,74 @@
1398 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-packagedata'><filename>do_packagedata</filename></ulink> 1399 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-packagedata'><filename>do_packagedata</filename></ulink>
1399 tasks combine to analyze the files found in the 1400 tasks combine to analyze the files found in the
1400 <ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink> 1401 <ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink>
1401 directory (i.e. the staging area) and split them into 1402 directory and split them into subsets based on available
1402 subsets based on available packages and files. 1403 packages and files.
1403 Analysis involves the following as well as other items: 1404 Analysis involves the following as well as other items:
1404 splitting out debugging symbols, looking at shared library 1405 splitting out debugging symbols, looking at shared library
1405 dependencies between packages, and looking at package 1406 dependencies between packages, and looking at package
1406 relationships. 1407 relationships.
1408 </para>
1409
1410 <para>
1407 The <filename>do_packagedata</filename> task creates 1411 The <filename>do_packagedata</filename> task creates
1408 package metadata based on the analysis such that the 1412 package metadata based on the analysis such that the
1409 build system can generate the final packages. 1413 build system can generate the final packages.
1414 The
1415 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
1416 task stages (copies) a subset of the files installed by
1417 the
1418 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-install'><filename>do_install</filename></ulink>
1419 task into the appropriate sysroot.
1410 Working, staged, and intermediate results of the analysis 1420 Working, staged, and intermediate results of the analysis
1411 and package splitting process use these areas: 1421 and package splitting process use several areas:
1412 <itemizedlist> 1422 <itemizedlist>
1413 <listitem><para> 1423 <listitem><para>
1414 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGD'><filename>PKGD</filename></ulink>: 1424 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGD'><filename>PKGD</filename></ulink>:
1415 The destination directory for packages before they 1425 The destination directory
1416 are split. 1426 (i.e. <filename>package</filename>) for packages
1427 before they are split into individual packages.
1428 </para></listitem>
1429 <listitem><para>
1430 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDESTWORK'><filename>PKGDESTWORK</filename></ulink>:
1431 A temporary work area (i.e.
1432 <filename>pkgdata</filename>) used by the
1433 <filename>do_package</filename> task to save
1434 package metadata.
1435 </para></listitem>
1436 <listitem><para>
1437 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDEST'><filename>PKGDEST</filename></ulink>:
1438 The parent directory (i.e.
1439 <filename>packages-split</filename>) for packages
1440 after they have been split.
1417 </para></listitem> 1441 </para></listitem>
1418 <listitem><para> 1442 <listitem><para>
1419 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></ulink>: 1443 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></ulink>:
1420 A shared, global-state directory that holds data 1444 A shared, global-state directory that holds
1421 generated during the packaging process. 1445 packaging metadata generated during the packaging
1446 process.
1447 The packaging process copies metadata from
1448 <filename>PKGDESTWORK</filename> to the
1449 <filename>PKGDATA_DIR</filename> area where it
1450 becomes globally available.
1422 </para></listitem> 1451 </para></listitem>
1423 <listitem><para> 1452 <listitem><para>
1424 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDESTWORK'><filename>PKGDESTWORK</filename></ulink>: 1453 <ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_HOST'><filename>STAGING_DIR_HOST</filename></ulink>:
1425 A temporary work area used by the 1454 The path for the sysroot for the system on which
1426 <filename>do_package</filename> task. 1455 a component is built to run (i.e.
1456 <filename>recipe-sysroot</filename>).
1427 </para></listitem> 1457 </para></listitem>
1428 <listitem><para> 1458 <listitem><para>
1429 <ulink url='&YOCTO_DOCS_REF_URL;#var-PKGDEST'><filename>PKGDEST</filename></ulink>: 1459 <ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_NATIVE'><filename>STAGING_DIR_NATIVE</filename></ulink>:
1430 The parent directory for packages after they have 1460 The path for the sysroot used when building
1431 been split. 1461 components for the build host (i.e.
1462 <filename>recipe-sysroot-native</filename>).
1463 </para></listitem>
1464 <listitem><para>
1465 <ulink url='&YOCTO_DOCS_REF_URL;#var-STAGING_DIR_TARGET'><filename>STAGING_DIR_TARGET</filename></ulink>:
1466 The path for the sysroot used when a component that
1467 is built to execute on a system and it generates
1468 code for yet another machine (e.g. cross-canadian
1469 recipes).
1432 </para></listitem> 1470 </para></listitem>
1433 </itemizedlist> 1471 </itemizedlist>
1434 The 1472 The