diff options
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 33 |
1 files changed, 29 insertions, 4 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 0dbbe4dcc8..bb35c28f25 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
@@ -584,17 +584,42 @@ | |||
584 | you can build the toolchain installer one of two ways if you have a | 584 | you can build the toolchain installer one of two ways if you have a |
585 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>: | 585 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>: |
586 | <itemizedlist> | 586 | <itemizedlist> |
587 | <listitem><para>Use <filename>bitbake meta-toolchain</filename>. | 587 | <listitem><para> |
588 | Use <filename>bitbake meta-toolchain</filename>. | ||
588 | This method requires you to still install the target | 589 | This method requires you to still install the target |
589 | sysroot by installing and extracting it separately. | 590 | sysroot by installing and extracting it separately. |
590 | For information on how to install the sysroot, see the | 591 | For information on how to install the sysroot, see the |
591 | "<link linkend='extracting-the-root-filesystem'>Extracting the Root Filesystem</link>" | 592 | "<link linkend='extracting-the-root-filesystem'>Extracting the Root Filesystem</link>" |
592 | section.</para></listitem> | 593 | section. |
593 | <listitem><para>Use | 594 | </para></listitem> |
594 | <filename>bitbake image -c populate_sdk</filename>. | 595 | <listitem><para> |
596 | Use <filename>bitbake image -c populate_sdk</filename>. | ||
595 | This method has significant advantages over the previous method | 597 | This method has significant advantages over the previous method |
596 | because it results in a toolchain installer that contains the | 598 | because it results in a toolchain installer that contains the |
597 | sysroot that matches your target root filesystem. | 599 | sysroot that matches your target root filesystem. |
600 | </para> | ||
601 | |||
602 | <para>Another powerful feature is that the toolchain is | ||
603 | completely self-contained. | ||
604 | The binaries are linked against their own copy of | ||
605 | <filename>libc</filename>, which results in no dependencies | ||
606 | on the target system. | ||
607 | To achieve this, the pointer to the dynamic loader is | ||
608 | configured at install time since that path cannot be dynamically | ||
609 | altered. | ||
610 | This is the reason for a wrapper around the | ||
611 | <filename>populate_sdk</filename> archive.</para> | ||
612 | |||
613 | <para>Another feature is that only one set of cross-canadian | ||
614 | toolchain binaries are produced per architecture. | ||
615 | This feature takes advantage of the fact that the target | ||
616 | hardware can be passed to <filename>gcc</filename> as a set of | ||
617 | compiler options. | ||
618 | Those options are set up by the environment script and | ||
619 | contained in variables like CC and LD. | ||
620 | This reduces the space needed for the tools. | ||
621 | Understand, however, that a sysroot is still needed for every | ||
622 | target since those binaries are target-specific. | ||
598 | </para></listitem> | 623 | </para></listitem> |
599 | </itemizedlist> | 624 | </itemizedlist> |
600 | </para> | 625 | </para> |