diff options
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 55 |
1 files changed, 8 insertions, 47 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index ffed3e2728..c59e8e45b7 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
| @@ -6574,18 +6574,6 @@ | |||
| 6574 | or | 6574 | or |
| 6575 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>). | 6575 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>). |
| 6576 | </para></listitem> | 6576 | </para></listitem> |
| 6577 | <listitem><para><emphasis>Prepare your local configuration file:</emphasis> | ||
| 6578 | Toaster needs the | ||
| 6579 | <ulink url='&YOCTO_DOCS_REF_URL;#toaster'><filename>toaster</filename></ulink> | ||
| 6580 | class enabled | ||
| 6581 | in Bitbake in order to record target image package | ||
| 6582 | information. | ||
| 6583 | You can enable it by adding the following line to your | ||
| 6584 | <filename>conf/local.conf</filename> file: | ||
| 6585 | <literallayout class='monospaced'> | ||
| 6586 | INHERIT += "toaster" | ||
| 6587 | </literallayout> | ||
| 6588 | </para></listitem> | ||
| 6589 | <listitem><para><emphasis>Start Toaster:</emphasis> | 6577 | <listitem><para><emphasis>Start Toaster:</emphasis> |
| 6590 | Start the Toaster service using this | 6578 | Start the Toaster service using this |
| 6591 | command from within your | 6579 | command from within your |
| @@ -6643,8 +6631,7 @@ | |||
| 6643 | tool from the shell and pass it the same URL. | 6631 | tool from the shell and pass it the same URL. |
| 6644 | </para></listitem> | 6632 | </para></listitem> |
| 6645 | </itemizedlist> | 6633 | </itemizedlist> |
| 6646 | Either method opens the home page for the Toaster interface, | 6634 | Either method opens the home page for the Toaster interface. |
| 6647 | which is temporary for this release. | ||
| 6648 | </para> | 6635 | </para> |
| 6649 | 6636 | ||
| 6650 | <note><title>Notes</title> | 6637 | <note><title>Notes</title> |
| @@ -6678,50 +6665,24 @@ | |||
| 6678 | You can click on any build to see related information. | 6665 | You can click on any build to see related information. |
| 6679 | This information includes configuration details, information | 6666 | This information includes configuration details, information |
| 6680 | about tasks, all recipes and packages built and their | 6667 | about tasks, all recipes and packages built and their |
| 6681 | dependencies, packages installed in your final image, | 6668 | dependencies, packages and their directory structure as |
| 6669 | installed in your final image, | ||
| 6682 | execution time, CPU usage and disk I/O per task. | 6670 | execution time, CPU usage and disk I/O per task. |
| 6683 | </para> | 6671 | </para> |
| 6684 | 6672 | ||
| 6685 | <para> | 6673 | <para> |
| 6686 | The home page of the interface into the database organizes | 6674 | For details on the interface, see the |
| 6687 | builds into areas: | 6675 | <ulink url='https://www.yoctoproject.org/documentation/toaster-manual'>Toaster Manual</ulink>. |
| 6688 | <itemizedlist> | ||
| 6689 | <listitem><para>Recent successful builds, which appear | ||
| 6690 | in row format in a green area.</para></listitem> | ||
| 6691 | <listitem><para>Recent failed builds, which appear | ||
| 6692 | in row format in a red area.</para></listitem> | ||
| 6693 | <listitem><para>Recent builds in progress, which appear | ||
| 6694 | in row format in a yellow area.</para></listitem> | ||
| 6695 | <listitem><para>All builds, which appear in row format at | ||
| 6696 | the end of the page.</para></listitem> | ||
| 6697 | </itemizedlist> | ||
| 6698 | </para> | ||
| 6699 | |||
| 6700 | <para> | ||
| 6701 | Each entry is linked to more detail on the particular build | ||
| 6702 | or recipe. | ||
| 6703 | You can click on the links to learn more information. | ||
| 6704 | </para> | 6676 | </para> |
| 6705 | |||
| 6706 | <para> | ||
| 6707 | When you click on a failed recipe link, you can find out | ||
| 6708 | information such as the work directory, the pathname to the | ||
| 6709 | failing recipe, the exact error message, and precursor tasks. | ||
| 6710 | </para> | ||
| 6711 | |||
| 6712 | <para> | ||
| 6713 | Clicking on a successful build provides you with configuration, | ||
| 6714 | task, and package information along with directory structure, | ||
| 6715 | build time, CPU usage, and disk I/O information. | ||
| 6716 | </para> | ||
| 6717 | |||
| 6718 | </section> | 6677 | </section> |
| 6719 | 6678 | ||
| 6720 | <section id='stopping-toaster'> | 6679 | <section id='stopping-toaster'> |
| 6721 | <title>Stopping Toaster</title> | 6680 | <title>Stopping Toaster</title> |
| 6722 | 6681 | ||
| 6723 | <para> | 6682 | <para> |
| 6724 | Stop the Toaster service with the following command: | 6683 | Stop the Toaster service with the following command |
| 6684 | from with the | ||
| 6685 | <link linkend='build-directory'>Build Directory</link>: | ||
| 6725 | <literallayout class='monospaced'> | 6686 | <literallayout class='monospaced'> |
| 6726 | $ source toaster stop | 6687 | $ source toaster stop |
| 6727 | </literallayout> | 6688 | </literallayout> |
