diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2015-01-21 11:16:25 -0800 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-02-17 15:16:52 +0000 |
commit | 84647d586e5d6493e3c2fbb4a2a0d6cc9b170863 (patch) | |
tree | 26d3a004503430cad2a5c57191b066ef07be22f3 | |
parent | 84ee65aef0ac79b2b8294daa3a5ea3932c5a1c6f (diff) | |
download | poky-84647d586e5d6493e3c2fbb4a2a0d6cc9b170863.tar.gz |
ref-manual: scrubbed eglibc
Removed the references to eglibc and replaced them with glibc.
This involved updating the example buildhistory output with
current examples as well
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: b44cce9817191d616d51d6b1d067efc730423198)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r-- | documentation/ref-manual/usingpoky.xml | 129 |
1 files changed, 75 insertions, 54 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml index e9f4283766..a7bff18b01 100644 --- a/documentation/ref-manual/usingpoky.xml +++ b/documentation/ref-manual/usingpoky.xml | |||
@@ -283,12 +283,12 @@ | |||
283 | <ulink url='&YOCTO_RELEASE_NOTES;'>Release Notes</ulink> | 283 | <ulink url='&YOCTO_RELEASE_NOTES;'>Release Notes</ulink> |
284 | for a look at all release-related issues. | 284 | for a look at all release-related issues. |
285 | <itemizedlist> | 285 | <itemizedlist> |
286 | <listitem><para><emphasis><filename>eglibc-initial</filename> fails to build</emphasis>: | 286 | <listitem><para><emphasis><filename>glibc-initial</filename> fails to build</emphasis>: |
287 | If your development host system has the unpatched | 287 | If your development host system has the unpatched |
288 | <filename>GNU Make 3.82</filename>, | 288 | <filename>GNU Make 3.82</filename>, |
289 | the | 289 | the |
290 | <link linkend='ref-tasks-install'><filename>do_install</filename></link> | 290 | <link linkend='ref-tasks-install'><filename>do_install</filename></link> |
291 | task fails for <filename>eglibc-initial</filename> during | 291 | task fails for <filename>glibc-initial</filename> during |
292 | the build.</para> | 292 | the build.</para> |
293 | <para>Typically, every distribution that ships | 293 | <para>Typically, every distribution that ships |
294 | <filename>GNU Make 3.82</filename> as | 294 | <filename>GNU Make 3.82</filename> as |
@@ -564,19 +564,22 @@ | |||
564 | <para> | 564 | <para> |
565 | The history for each package contains a text file that has | 565 | The history for each package contains a text file that has |
566 | name-value pairs with information about the package. | 566 | name-value pairs with information about the package. |
567 | For example, <filename>buildhistory/packages/core2-poky-linux/busybox/busybox/latest</filename> | 567 | For example, <filename>buildhistory/packages/i586-poky-linux/busybox/busybox/latest</filename> |
568 | contains the following: | 568 | contains the following: |
569 | <literallayout class='monospaced'> | 569 | <literallayout class='monospaced'> |
570 | PV = 1.19.3 | 570 | PV = 1.22.1 |
571 | PR = r3 | 571 | PR = r32 |
572 | RDEPENDS = update-rc.d eglibc (>= 2.13) | 572 | RPROVIDES = |
573 | RRECOMMENDS = busybox-syslog busybox-udhcpc | 573 | RDEPENDS = glibc (>= 2.20) update-alternatives-opkg |
574 | PKGSIZE = 564701 | 574 | RRECOMMENDS = busybox-syslog busybox-udhcpc update-rc.d |
575 | FILES = /usr/bin/* /usr/sbin/* /usr/libexec/* /usr/lib/lib*.so.* \ | 575 | PKGSIZE = 540168 |
576 | /etc /com /var /bin/* /sbin/* /lib/*.so.* /usr/share/busybox \ | 576 | FILES = /usr/bin/* /usr/sbin/* /usr/lib/busybox/* /usr/lib/lib*.so.* \ |
577 | /usr/lib/busybox/* /usr/share/pixmaps /usr/share/applications \ | 577 | /etc /com /var /bin/* /sbin/* /lib/*.so.* /lib/udev/rules.d \ |
578 | /usr/share/idl /usr/share/omf /usr/share/sounds /usr/lib/bonobo/servers | 578 | /usr/lib/udev/rules.d /usr/share/busybox /usr/lib/busybox/* \ |
579 | FILELIST = /etc/busybox.links /etc/init.d/hwclock.sh /bin/busybox /bin/sh | 579 | /usr/share/pixmaps /usr/share/applications /usr/share/idl \ |
580 | /usr/share/omf /usr/share/sounds /usr/lib/bonobo/servers | ||
581 | FILELIST = /bin/busybox /bin/busybox.nosuid /bin/busybox.suid /bin/sh \ | ||
582 | /etc/busybox.links.nosuid /etc/busybox.links.suid | ||
580 | </literallayout> | 583 | </literallayout> |
581 | Most of these name-value pairs correspond to variables used | 584 | Most of these name-value pairs correspond to variables used |
582 | to produce the package. | 585 | to produce the package. |
@@ -589,15 +592,16 @@ | |||
589 | <para> | 592 | <para> |
590 | There is also a file corresponding to the recipe from which the | 593 | There is also a file corresponding to the recipe from which the |
591 | package came (e.g. | 594 | package came (e.g. |
592 | <filename>buildhistory/packages/core2-poky-linux/busybox/latest</filename>): | 595 | <filename>buildhistory/packages/i586-poky-linux/busybox/latest</filename>): |
593 | <literallayout class='monospaced'> | 596 | <literallayout class='monospaced'> |
594 | PV = 1.19.3 | 597 | PV = 1.22.1 |
595 | PR = r3 | 598 | PR = r32 |
596 | DEPENDS = virtual/i586-poky-linux-gcc virtual/i586-poky-linux-compilerlibs \ | 599 | DEPENDS = initscripts kern-tools-native update-rc.d-native \ |
597 | virtual/libc update-rc.d-native | 600 | virtual/i586-poky-linux-compilerlibs virtual/i586-poky-linux-gcc \ |
598 | PACKAGES = busybox-httpd busybox-udhcpd busybox-udhcpc busybox-syslog \ | 601 | virtual/libc virtual/update-alternatives |
599 | busybox-mdev busybox-dbg busybox busybox-doc busybox-dev \ | 602 | PACKAGES = busybox-ptest busybox-httpd busybox-udhcpd busybox-udhcpc \ |
600 | busybox-staticdev busybox-locale | 603 | busybox-syslog busybox-mdev busybox-hwclock busybox-dbg \ |
604 | busybox-staticdev busybox-dev busybox-doc busybox-locale busybox | ||
601 | </literallayout> | 605 | </literallayout> |
602 | </para> | 606 | </para> |
603 | 607 | ||
@@ -611,31 +615,44 @@ | |||
611 | is set to | 615 | is set to |
612 | <filename>${<link linkend='var-AUTOREV'>AUTOREV</link>}</filename>. | 616 | <filename>${<link linkend='var-AUTOREV'>AUTOREV</link>}</filename>. |
613 | Here is an example assuming | 617 | Here is an example assuming |
614 | <filename>buildhistory/packages/emenlow-poky-linux/linux-yocto/latest_srcrev</filename>): | 618 | <filename>buildhistory/packages/qemux86-poky-linux/linux-yocto/latest_srcrev</filename>): |
615 | <literallayout class='monospaced'> | 619 | <literallayout class='monospaced'> |
616 | # SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf" | 620 | # SRCREV_machine = "38cd560d5022ed2dbd1ab0dca9642e47c98a0aa1" |
617 | SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf" | 621 | SRCREV_machine = "38cd560d5022ed2dbd1ab0dca9642e47c98a0aa1" |
618 | # SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02" | 622 | # SRCREV_meta = "a227f20eff056e511d504b2e490f3774ab260d6f" |
619 | SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02" | 623 | SRCREV_meta = "a227f20eff056e511d504b2e490f3774ab260d6f" |
620 | # SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24" | ||
621 | SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24" | ||
622 | </literallayout> | 624 | </literallayout> |
623 | You can use the <filename>buildhistory-collect-srcrevs</filename> | 625 | You can use the <filename>buildhistory-collect-srcrevs</filename> |
624 | command to collect the stored <filename>SRCREV</filename> values | 626 | command with the <filename>-a</filename> option to |
625 | from build history and report them in a format suitable for use in | 627 | collect the stored <filename>SRCREV</filename> values |
626 | global configuration (e.g., <filename>local.conf</filename> | 628 | from build history and report them in a format suitable for |
627 | or a distro include file) to override floating | 629 | use in global configuration (e.g., |
628 | <filename>AUTOREV</filename> values to a fixed set of revisions. | 630 | <filename>local.conf</filename> or a distro include file) to |
631 | override floating <filename>AUTOREV</filename> values to a | ||
632 | fixed set of revisions. | ||
629 | Here is some example output from this command: | 633 | Here is some example output from this command: |
630 | <literallayout class='monospaced'> | 634 | <literallayout class='monospaced'> |
631 | # emenlow-poky-linux | 635 | $ buildhistory-collect-srcrevs -a |
632 | SRCREV_machine_pn-linux-yocto = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf" | 636 | # i586-poky-linux |
633 | SRCREV_emgd_pn-linux-yocto = "caea08c988e0f41103bbe18eafca20348f95da02" | 637 | SRCREV_pn-glibc = "b8079dd0d360648e4e8de48656c5c38972621072" |
634 | SRCREV_meta_pn-linux-yocto = "c2ed0f16fdec628242a682897d5d86df4547cf24" | 638 | SRCREV_pn-glibc-initial = "b8079dd0d360648e4e8de48656c5c38972621072" |
635 | # core2-poky-linux | 639 | SRCREV_pn-opkg-utils = "53274f087565fd45d8452c5367997ba6a682a37a" |
636 | SRCREV_pn-kmod = "62081c0f68905b22f375156d4532fd37fa5c8d33" | 640 | SRCREV_pn-kmod = "fd56638aed3fe147015bfa10ed4a5f7491303cb4" |
637 | SRCREV_pn-blktrace = "d6918c8832793b4205ed3bfede78c2f915c23385" | 641 | # x86_64-linux |
638 | SRCREV_pn-opkg = "649" | 642 | SRCREV_pn-gtk-doc-stub-native = "1dea266593edb766d6d898c79451ef193eb17cfa" |
643 | SRCREV_pn-dtc-native = "65cc4d2748a2c2e6f27f1cf39e07a5dbabd80ebf" | ||
644 | SRCREV_pn-update-rc.d-native = "eca680ddf28d024954895f59a241a622dd575c11" | ||
645 | SRCREV_glibc_pn-cross-localedef-native = "b8079dd0d360648e4e8de48656c5c38972621072" | ||
646 | SRCREV_localedef_pn-cross-localedef-native = "c833367348d39dad7ba018990bfdaffaec8e9ed3" | ||
647 | SRCREV_pn-prelink-native = "faa069deec99bf61418d0bab831c83d7c1b797ca" | ||
648 | SRCREV_pn-opkg-utils-native = "53274f087565fd45d8452c5367997ba6a682a37a" | ||
649 | SRCREV_pn-kern-tools-native = "23345b8846fe4bd167efdf1bd8a1224b2ba9a5ff" | ||
650 | SRCREV_pn-kmod-native = "fd56638aed3fe147015bfa10ed4a5f7491303cb4" | ||
651 | # qemux86-poky-linux | ||
652 | SRCREV_machine_pn-linux-yocto = "38cd560d5022ed2dbd1ab0dca9642e47c98a0aa1" | ||
653 | SRCREV_meta_pn-linux-yocto = "a227f20eff056e511d504b2e490f3774ab260d6f" | ||
654 | # all-poky-linux | ||
655 | SRCREV_pn-update-rc.d = "eca680ddf28d024954895f59a241a622dd575c11" | ||
639 | </literallayout> | 656 | </literallayout> |
640 | <note> | 657 | <note> |
641 | Here are some notes on using the | 658 | Here are some notes on using the |
@@ -660,7 +677,7 @@ | |||
660 | However, the script does place a | 677 | However, the script does place a |
661 | comment before each set of values that specifies | 678 | comment before each set of values that specifies |
662 | which triplet to which they belong as shown above | 679 | which triplet to which they belong as shown above |
663 | (e.g., <filename>emenlow-poky-linux</filename>). | 680 | (e.g., <filename>i586-poky-linux</filename>). |
664 | </para></listitem> | 681 | </para></listitem> |
665 | </itemizedlist> | 682 | </itemizedlist> |
666 | </note> | 683 | </note> |
@@ -717,17 +734,21 @@ | |||
717 | Here is an example of <filename>image-info.txt</filename>: | 734 | Here is an example of <filename>image-info.txt</filename>: |
718 | <literallayout class='monospaced'> | 735 | <literallayout class='monospaced'> |
719 | DISTRO = poky | 736 | DISTRO = poky |
720 | DISTRO_VERSION = 1.1+snapshot-20120207 | 737 | DISTRO_VERSION = 1.7 |
721 | USER_CLASSES = image-mklibs image-prelink | 738 | USER_CLASSES = buildstats image-mklibs image-prelink |
722 | IMAGE_CLASSES = image_types | 739 | IMAGE_CLASSES = image_types |
723 | IMAGE_FEATURES = debug-tweaks x11-base apps-x11-core \ | 740 | IMAGE_FEATURES = debug-tweaks |
724 | package-management ssh-server-dropbear package-management | 741 | IMAGE_LINGUAS = |
725 | IMAGE_LINGUAS = en-us en-gb | 742 | IMAGE_INSTALL = packagegroup-core-boot run-postinsts |
726 | IMAGE_INSTALL = packagegroup-core-boot packagegroup-base-extended | ||
727 | BAD_RECOMMENDATIONS = | 743 | BAD_RECOMMENDATIONS = |
728 | ROOTFS_POSTPROCESS_COMMAND = buildhistory_get_image_installed ; rootfs_update_timestamp ; | 744 | NO_RECOMMENDATIONS = |
729 | IMAGE_POSTPROCESS_COMMAND = buildhistory_get_imageinfo ; | 745 | PACKAGE_EXCLUDE = |
730 | IMAGESIZE = 171816 | 746 | ROOTFS_POSTPROCESS_COMMAND = write_package_manifest; license_create_manifest; \ |
747 | write_image_manifest ; buildhistory_list_installed_image ; \ | ||
748 | buildhistory_get_image_installed ; ssh_allow_empty_password; \ | ||
749 | postinst_enable_logging; rootfs_update_timestamp ; ssh_disable_dns_lookup ; | ||
750 | IMAGE_POSTPROCESS_COMMAND = buildhistory_get_imageinfo ; | ||
751 | IMAGESIZE = 6900 | ||
731 | </literallayout> | 752 | </literallayout> |
732 | Other than <filename>IMAGESIZE</filename>, which is the | 753 | Other than <filename>IMAGESIZE</filename>, which is the |
733 | total size of the files in the image in Kbytes, the | 754 | total size of the files in the image in Kbytes, the |
@@ -811,7 +832,7 @@ | |||
811 | <literallayout class='monospaced'> | 832 | <literallayout class='monospaced'> |
812 | DISTRO = poky | 833 | DISTRO = poky |
813 | DISTRO_VERSION = 1.3+snapshot-20130327 | 834 | DISTRO_VERSION = 1.3+snapshot-20130327 |
814 | SDK_NAME = poky-eglibc-i686-arm | 835 | SDK_NAME = poky-glibc-i686-arm |
815 | SDK_VERSION = 1.3+snapshot | 836 | SDK_VERSION = 1.3+snapshot |
816 | SDKMACHINE = | 837 | SDKMACHINE = |
817 | SDKIMAGE_FEATURES = dev-pkgs dbg-pkgs | 838 | SDKIMAGE_FEATURES = dev-pkgs dbg-pkgs |
@@ -858,12 +879,12 @@ | |||
858 | Here is an example: | 879 | Here is an example: |
859 | <literallayout class='monospaced'> | 880 | <literallayout class='monospaced'> |
860 | $ ~/poky/poky/scripts/buildhistory-diff . HEAD^ | 881 | $ ~/poky/poky/scripts/buildhistory-diff . HEAD^ |
861 | Changes to images/qemux86_64/eglibc/core-image-minimal (files-in-image.txt): | 882 | Changes to images/qemux86_64/glibc/core-image-minimal (files-in-image.txt): |
862 | /etc/anotherpkg.conf was added | 883 | /etc/anotherpkg.conf was added |
863 | /sbin/anotherpkg was added | 884 | /sbin/anotherpkg was added |
864 | * (installed-package-names.txt): | 885 | * (installed-package-names.txt): |
865 | * anotherpkg was added | 886 | * anotherpkg was added |
866 | Changes to images/qemux86_64/eglibc/core-image-minimal (installed-package-names.txt): | 887 | Changes to images/qemux86_64/glibc/core-image-minimal (installed-package-names.txt): |
867 | anotherpkg was added | 888 | anotherpkg was added |
868 | packages/qemux86_64-poky-linux/v86d: PACKAGES: added "v86d-extras" | 889 | packages/qemux86_64-poky-linux/v86d: PACKAGES: added "v86d-extras" |
869 | * PR changed from "r0" to "r1" | 890 | * PR changed from "r0" to "r1" |