diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 30 |
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 d5c97c0..7fa9149 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -4333,15 +4333,15 @@ to a specific target. Using Toaster, you can do the following: <itemizedlist> - <listitem><para>Understand why a task fails or was - reused from the shared state cache when you thought it - should have been rebuilt from scratch.</para></listitem> + <listitem><para>See information about the tasks executed + and reused during the build.</para></listitem> <listitem><para>See what is built (recipes and packages) and what packages were installed into the final image.</para></listitem> <listitem><para>See performance-related information such - as size, build time, CPU usage, disk input, and disk - output.</para></listitem> + as build time, CPU usage, and disk I/O.</para></listitem> + <listitem><para>Examine error, warning and trace messages + to aid in debugging.</para></listitem> </itemizedlist> </para> @@ -4393,6 +4393,10 @@ <literallayout class='monospaced'> $ source toaster start </literallayout></para></listitem> + <note> + The Toaster must be started and running in order + for it to collect data. + </note> </orderedlist> </para> @@ -4446,6 +4450,19 @@ <para> The Toaster database is persistent regardless of whether you 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 builds into areas: <itemizedlist> @@ -4458,8 +4475,6 @@ <listitem><para>All builds, which appear in row format at the end of the page.</para></listitem> </itemizedlist> - </para> - <para> Each entry is linked to more detail on the particular build or recipe. @@ -4477,6 +4492,7 @@ task, and package information along with directory structure, build time, CPU usage, and disk I/O information. </para> +--> </section> <section id='stopping-toaster'> |