summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorPaul Eggleton <paul.eggleton@linux.intel.com>2013-04-04 07:14:28 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-04-10 16:20:53 +0100
commit58122bf0630b9d72eadd7e6e06862f15abd64711 (patch)
tree0815b6d3f1daee3b551097dfe633ff5efc68db55 /documentation/ref-manual
parentca6321fff4bec91cb4a32c51b48df088932c5070 (diff)
downloadpoky-58122bf0630b9d72eadd7e6e06862f15abd64711.tar.gz
ref-manual: buildhistory patch 1 of 5 applied.
New section titled "Build History SDK Information" added. (From yocto-docs rev: aaa9ee5690a68f72b21ca3ab731942d80acac2f3) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/usingpoky.xml62
1 files changed, 62 insertions, 0 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index de672b51e4..c8bee36e96 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -631,6 +631,68 @@
631 </para> 631 </para>
632 </section> 632 </section>
633 633
634 <section id='build-history-sdk-information'>
635 <title>Build History SDK Information</title>
636 <para>
637 Build history collects similar information on the contents
638 of SDKs (for example, <filename>meta-toolchain</filename>
639 or <filename>bitbake -c populate_sdk imagename</filename>)
640 to that which it collects for images.
641 The files produced for each SDK are as follows:
642 <itemizedlist>
643 <listitem><para><filename>files-in-sdk.txt:</filename>
644 A list of files in the SDK with permissions,
645 owner, group, size, and symlink information.
646 This includes both the host and target parts
647 of the SDK.
648 </para></listitem>
649 <listitem><para><filename>sdk-info.txt:</filename>
650 A text file containing name-value pairs with information
651 about the SDK.
652 See the following listing example for more information.
653 </para></listitem>
654 <listitem><para>Under each of the <filename>host</filename> and
655 <filename>target</filename> directories (for the portions of the
656 SDK that run on the host and on the target respectively):
657 <itemizedlist>
658 <listitem><para><filename>depends.dot:</filename>
659 Dependency graph for the SDK that is
660 compatible with <filename>graphviz</filename>.
661 </para></listitem>
662 <listitem><para><filename>installed-package-names.txt:</filename>
663 A list of installed packages by name only.</para></listitem>
664 <listitem><para><filename>installed-package-sizes.txt:</filename>
665 A list of installed packages ordered by size.
666 </para></listitem>
667 <listitem><para><filename>installed-packages.txt:</filename>
668 A list of installed packages with full package
669 filenames.</para></listitem>
670 </itemizedlist>
671 </para></listitem>
672 </itemizedlist>
673 </para>
674
675 <para>
676 Here is an example of <filename>sdk-info.txt</filename>:
677 <literallayout class='monospaced'>
678DISTRO = poky
679DISTRO_VERSION = 1.3+snapshot-20130327
680SDK_NAME = poky-eglibc-i686-arm
681SDK_VERSION = 1.3+snapshot
682SDKMACHINE =
683SDKIMAGE_FEATURES = dev-pkgs dbg-pkgs
684BAD_RECOMMENDATIONS =
685SDKSIZE = 352712
686 </literallayout>
687 Other than <filename>SDKSIZE</filename>, which is the
688 total size of the files in the SDK in Kbytes, the
689 name-value pairs are variables that may have influenced the
690 content of the SDK.
691 This information is often useful when you are trying to determine
692 why a change in the package or file listings has occurred.
693 </para>
694 </section>
695
634 <section id='examining-build-history-information'> 696 <section id='examining-build-history-information'>
635 <title>Examining Build History Information</title> 697 <title>Examining Build History Information</title>
636 698