summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-03-10 09:03:03 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-03-11 23:06:06 +0000
commitaf1517cbfea725ac09f7edb8b9a42afc1ff41065 (patch)
tree92e32d3d769eebb2962a2d4cdb81053b9c642b1c /documentation
parentd9fc04b47c0277e226f4e4bdb366ab661f1c6589 (diff)
downloadpoky-af1517cbfea725ac09f7edb8b9a42afc1ff41065.tar.gz
ref-manual: Updated "Build History SDK Information" section.
Applied review edits to adjust this section for the extensible SDK stuff. (From yocto-docs rev: d386fca0b4e54ae2d5e610b37089fb058d80a746) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/usingpoky.xml65
1 files changed, 41 insertions, 24 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 223d4cfe48..d1a0a29eff 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -800,16 +800,17 @@
800 <section id='build-history-sdk-information'> 800 <section id='build-history-sdk-information'>
801 <title>Build History SDK Information</title> 801 <title>Build History SDK Information</title>
802 802
803The files that get copied in are controlled by the BUILDHISTORY_SDK_FILES variable. Default is to copy the local.conf, bblayers.conf, auto.conf, lockdef.inc, devtool.conf. There is a "conf" directory under "sdk" that has these files.
804
805
806
807 <para> 803 <para>
808 Build history collects similar information on the contents 804 Build history collects similar information on the contents
809 of SDKs (e.g. <filename>meta-toolchain</filename> 805 of SDKs (e.g. <filename>meta-toolchain</filename>
810 or <filename>bitbake -c populate_sdk imagename</filename>) 806 or <filename>bitbake -c populate_sdk imagename</filename>)
811 as compared to information it collects for images. 807 as compared to information it collects for images.
812 The following list shows the files produced for each SDK: 808 Furthermore, this information differs depending on whether an
809 extensible or standard SDK is being produced.
810 </para>
811
812 <para>
813 The following list shows the files produced for SDKs:
813 <itemizedlist> 814 <itemizedlist>
814 <listitem><para><filename>files-in-sdk.txt:</filename> 815 <listitem><para><filename>files-in-sdk.txt:</filename>
815 A list of files in the SDK with permissions, 816 A list of files in the SDK with permissions,
@@ -822,33 +823,49 @@ The files that get copied in are controlled by the BUILDHISTORY_SDK_FILES varia
822 about the SDK. 823 about the SDK.
823 See the following listing example for more information. 824 See the following listing example for more information.
824 </para></listitem> 825 </para></listitem>
825 <listitem><para><filename>sstate-task-sizes:</filename> 826 <listitem><para><filename>sstate-task-sizes.txt:</filename>
826 A folder containing files that show the sizes of task 827 A text file containing name-value pairs with information
827 groups (e.g. <filename>do_sysroot</filename> tasks has 828 about task group sizes
828 a total size). 829 (e.g. <filename>do_populate_sysroot</filename> tasks
830 have a total size).
831 The <filename>sstate-task-sizes.txt</filename> file
832 exists only when an extensible SDK is created.
829 </para></listitem> 833 </para></listitem>
830 <listitem><para><filename>sstate-package-sizes:</filename> 834 <listitem><para><filename>sstate-package-sizes.txt:</filename>
831 A folder containing files that show the shared-state 835 A text file containing name-value pairs with information
832 packages in the SDK. 836 for the shared-state packages and sizes in the SDK.
837 The <filename>sstate-package-sizes.txt</filename> file
838 exists only when an extensible SDK is created.
833 </para></listitem> 839 </para></listitem>
834 <listitem><para><filename>conf:</filename> 840 <listitem><para><filename>sdk-files:</filename>
835 A folder containing the 841 A folder that contains copies of the files mentioned in
836 <filename>local.conf</filename>, 842 <filename>BUILDHISTORY_SDK_FILES</filename> if the
837 <filename>bblayers.conf</filename>, 843 files are present in the output.
838 <filename>auto.conf</filename>, 844 Additionally, the default value of
839 <filename>lockdef.inc</filename>, and 845 <filename>BUILDHISTORY_SDK_FILES</filename> is specific
840 <filename>devtool.conf</filename> files. 846 to the extensible SDK although you can set it
841 By default, these files get copied into the 847 differently if you would like to pull in specific files
842 <filename>sdk</filename> directory. 848 from the standard SDK.</para>
843 You can control the files that get copied into this 849 <para>The default files are
844 directory by setting the 850 <filename>conf/local.conf</filename>,
845 <filename>BUILDHISTORY_SDK_FILES</filename> variable. 851 <filename>conf/bblayers.conf</filename>,
852 <filename>conf/auto.conf</filename>,
853 <filename>conf/locked-sigs.inc</filename>, and
854 <filename>conf/devtool.conf</filename>.
855 Thus, for an extensible SDK, these files get copied
856 into the <filename>sdk-files</filename> directory.
846 </para></listitem> 857 </para></listitem>
847 <listitem><para>The following information appears under 858 <listitem><para>The following information appears under
848 each of the <filename>host</filename> 859 each of the <filename>host</filename>
849 and <filename>target</filename> directories 860 and <filename>target</filename> directories
850 for the portions of the SDK that run on the host and 861 for the portions of the SDK that run on the host and
851 on the target, respectively: 862 on the target, respectively:
863 <note>
864 The following files for the most part are empty
865 when producing an extensible SDK because this
866 type of SDK is not constructed from packages as is
867 the standard SDK.
868 </note>
852 <itemizedlist> 869 <itemizedlist>
853 <listitem><para><filename>depends.dot:</filename> 870 <listitem><para><filename>depends.dot:</filename>
854 Dependency graph for the SDK that is 871 Dependency graph for the SDK that is