diff options
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r-- | documentation/overview-manual/overview-manual-concepts.xml | 66 |
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 |