diff options
| -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 |
