summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-common-tasks.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-08-13 08:46:21 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-08-13 13:18:58 +0100
commit56e0326d42468bfaba640fa1d63664c5fd983639 (patch)
treefc0cbf728d765ec447b7f7ac9317eb49aa76a845 /documentation/dev-manual/dev-manual-common-tasks.xml
parent9de2165affcab337b683e7a054b2cac2bcb28ad3 (diff)
downloadpoky-56e0326d42468bfaba640fa1d63664c5fd983639.tar.gz
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>
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml30
1 files changed, 23 insertions, 7 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index d5c97c0538..7fa9149d07 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -4333,15 +4333,15 @@
4333 to a specific target. 4333 to a specific target.
4334 Using Toaster, you can do the following: 4334 Using Toaster, you can do the following:
4335 <itemizedlist> 4335 <itemizedlist>
4336 <listitem><para>Understand why a task fails or was 4336 <listitem><para>See information about the tasks executed
4337 reused from the shared state cache when you thought it 4337 and reused during the build.</para></listitem>
4338 should have been rebuilt from scratch.</para></listitem>
4339 <listitem><para>See what is built (recipes and 4338 <listitem><para>See what is built (recipes and
4340 packages) and what packages were installed into the final 4339 packages) and what packages were installed into the final
4341 image.</para></listitem> 4340 image.</para></listitem>
4342 <listitem><para>See performance-related information such 4341 <listitem><para>See performance-related information such
4343 as size, build time, CPU usage, disk input, and disk 4342 as build time, CPU usage, and disk I/O.</para></listitem>
4344 output.</para></listitem> 4343 <listitem><para>Examine error, warning and trace messages
4344 to aid in debugging.</para></listitem>
4345 </itemizedlist> 4345 </itemizedlist>
4346 </para> 4346 </para>
4347 4347
@@ -4393,6 +4393,10 @@
4393 <literallayout class='monospaced'> 4393 <literallayout class='monospaced'>
4394 $ source toaster start 4394 $ source toaster start
4395 </literallayout></para></listitem> 4395 </literallayout></para></listitem>
4396 <note>
4397 The Toaster must be started and running in order
4398 for it to collect data.
4399 </note>
4396 </orderedlist> 4400 </orderedlist>
4397 </para> 4401 </para>
4398 4402
@@ -4446,6 +4450,19 @@
4446 <para> 4450 <para>
4447 The Toaster database is persistent regardless of whether you 4451 The Toaster database is persistent regardless of whether you
4448 start or stop the service. 4452 start or stop the service.
4453 </para>
4454
4455 <para>
4456 Toaster's interface shows you a list of builds
4457 (successful and unsuccessful) for which it has data.
4458 You can click on any build to see related information.
4459 This information includes configuration details, information
4460 about tasks, all recipes and packages built and their
4461 dependencies, packages installed in your final image,
4462 execution time, CPU usage and disk I/O per task.
4463 </para>
4464
4465<!--
4449 The home page of the interface into the database organizes 4466 The home page of the interface into the database organizes
4450 builds into areas: 4467 builds into areas:
4451 <itemizedlist> 4468 <itemizedlist>
@@ -4458,8 +4475,6 @@
4458 <listitem><para>All builds, which appear in row format at 4475 <listitem><para>All builds, which appear in row format at
4459 the end of the page.</para></listitem> 4476 the end of the page.</para></listitem>
4460 </itemizedlist> 4477 </itemizedlist>
4461 </para>
4462
4463 <para> 4478 <para>
4464 Each entry is linked to more detail on the particular build 4479 Each entry is linked to more detail on the particular build
4465 or recipe. 4480 or recipe.
@@ -4477,6 +4492,7 @@
4477 task, and package information along with directory structure, 4492 task, and package information along with directory structure,
4478 build time, CPU usage, and disk I/O information. 4493 build time, CPU usage, and disk I/O information.
4479 </para> 4494 </para>
4495-->
4480 </section> 4496 </section>
4481 4497
4482 <section id='stopping-toaster'> 4498 <section id='stopping-toaster'>