summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-01-21 11:16:25 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-02-17 15:16:52 +0000
commit84647d586e5d6493e3c2fbb4a2a0d6cc9b170863 (patch)
tree26d3a004503430cad2a5c57191b066ef07be22f3 /documentation
parent84ee65aef0ac79b2b8294daa3a5ea3932c5a1c6f (diff)
downloadpoky-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>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/usingpoky.xml129
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"