sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: udates to toaster section. 

Fixes [YOCTO #4730]

Edits to the new section on toaster.  These are from Belen's review.

(From yocto-docs rev: f1462bd53bf39c706a87af86830a92b451b3e00c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-08-13 08:46:21 +03:00 committed by Richard Purdie
parent 9de2165aff
commit 56e0326d42
1 changed files with 23 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -4333,15 +4333,15 @@
to a specific target. to a specific target.
Using Toaster, you can do the following: Using Toaster, you can do the following:
<itemizedlist> <itemizedlist>
<listitem><para>Understand why a task fails or was <listitem><para>See information about the tasks executed
reused from the shared state cache when you thought it and reused during the build.</para></listitem>
should have been rebuilt from scratch.</para></listitem>
<listitem><para>See what is built (recipes and <listitem><para>See what is built (recipes and
packages) and what packages were installed into the final packages) and what packages were installed into the final
image.</para></listitem> image.</para></listitem>
<listitem><para>See performance-related information such <listitem><para>See performance-related information such
as size, build time, CPU usage, disk input, and disk as build time, CPU usage, and disk I/O.</para></listitem>
output.</para></listitem> <listitem><para>Examine error, warning and trace messages
to aid in debugging.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@ -4393,6 +4393,10 @@
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ source toaster start $ source toaster start
</literallayout></para></listitem> </literallayout></para></listitem>
<note>
The Toaster must be started and running in order
for it to collect data.
</note>
</orderedlist> </orderedlist>
</para> </para>
@ -4446,6 +4450,19 @@
<para> <para>
The Toaster database is persistent regardless of whether you The Toaster database is persistent regardless of whether you
start or stop the service. start or stop the service.
</para>
<para>
Toaster's interface shows you a list of builds
(successful and unsuccessful) for which it has data.
You can click on any build to see related information.
This information includes configuration details, information
about tasks, all recipes and packages built and their
dependencies, packages installed in your final image,
execution time, CPU usage and disk I/O per task.
</para>
<!--
The home page of the interface into the database organizes The home page of the interface into the database organizes
builds into areas: builds into areas:
<itemizedlist> <itemizedlist>
@ -4458,8 +4475,6 @@
<listitem><para>All builds, which appear in row format at <listitem><para>All builds, which appear in row format at
the end of the page.</para></listitem> the end of the page.</para></listitem>
</itemizedlist> </itemizedlist>
</para>
<para> <para>
Each entry is linked to more detail on the particular build Each entry is linked to more detail on the particular build
or recipe. or recipe.
@ -4477,6 +4492,7 @@
task, and package information along with directory structure, task, and package information along with directory structure,
build time, CPU usage, and disk I/O information. build time, CPU usage, and disk I/O information.
</para> </para>
-->
</section> </section>
<section id='stopping-toaster'> <section id='stopping-toaster'>