toaster-manual: New section on PREFERRED_VERSION
Added a new section in the interface use area that describes how to build a version of a recipe that is not the default version. Four new figures were added to support the description. (From yocto-docs rev: 232a875fb8fff97ce0578cf50b2a102bdaed1758) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
4b9daa8aa1
commit
d66cf202e8
Binary file not shown.
After Width: | Height: | Size: 108 KiB |
Binary file not shown.
After Width: | Height: | Size: 135 KiB |
Binary file not shown.
After Width: | Height: | Size: 109 KiB |
Binary file not shown.
After Width: | Height: | Size: 110 KiB |
|
@ -867,58 +867,113 @@
|
|||
CPU usage, and disk I/O.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
Following are several videos that show how to use the Toaster GUI:
|
||||
<itemizedlist>
|
||||
<listitem><para><emphasis>Build Configuration:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=qYgDZ8YzV6w'>video</ulink>
|
||||
overviews and demonstrates build configuration for Toaster.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Toaster Homepage and Table Controls:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=QEARDnrR1Xw'>video</ulink>
|
||||
goes over the Toaster entry page, and provides
|
||||
an overview of the data manipulation capabilities of
|
||||
Toaster, which include search, sorting and filtering by
|
||||
different criteria.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Build Dashboard:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=KKqHYcnp2gE'>video</ulink>
|
||||
shows you the build dashboard, a page providing an
|
||||
overview of the information available for a selected build.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Image Information:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=XqYGFsmA0Rw'>video</ulink>
|
||||
walks through the information Toaster provides
|
||||
about images: packages installed and root file system.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Configuration:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=UW-j-T2TzIg'>video</ulink>
|
||||
provides Toaster build configuration information.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Tasks:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=D4-9vGSxQtw'>video</ulink>
|
||||
shows the information Toaster provides about the
|
||||
tasks run by the build system.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Recipes and Packages Built:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=x-6dx4huNnw'>video</ulink>
|
||||
shows the information Toaster provides about recipes
|
||||
and packages built.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Performance Data:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=qWGMrJoqusQ'>video</ulink>
|
||||
shows the build performance data provided by
|
||||
Toaster.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<section id='web-interface-videos'>
|
||||
<title>Toaster Web Interface Videos</title>
|
||||
|
||||
<para>
|
||||
Following are several videos that show how to use the Toaster GUI:
|
||||
<itemizedlist>
|
||||
<listitem><para><emphasis>Build Configuration:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=qYgDZ8YzV6w'>video</ulink>
|
||||
overviews and demonstrates build configuration for Toaster.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Toaster Homepage and Table Controls:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=QEARDnrR1Xw'>video</ulink>
|
||||
goes over the Toaster entry page, and provides
|
||||
an overview of the data manipulation capabilities of
|
||||
Toaster, which include search, sorting and filtering by
|
||||
different criteria.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Build Dashboard:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=KKqHYcnp2gE'>video</ulink>
|
||||
shows you the build dashboard, a page providing an
|
||||
overview of the information available for a selected build.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Image Information:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=XqYGFsmA0Rw'>video</ulink>
|
||||
walks through the information Toaster provides
|
||||
about images: packages installed and root file system.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Configuration:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=UW-j-T2TzIg'>video</ulink>
|
||||
provides Toaster build configuration information.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Tasks:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=D4-9vGSxQtw'>video</ulink>
|
||||
shows the information Toaster provides about the
|
||||
tasks run by the build system.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Recipes and Packages Built:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=x-6dx4huNnw'>video</ulink>
|
||||
shows the information Toaster provides about recipes
|
||||
and packages built.
|
||||
</para></listitem>
|
||||
<listitem><para><emphasis>Performance Data:</emphasis>
|
||||
This
|
||||
<ulink url='https://www.youtube.com/watch?v=qWGMrJoqusQ'>video</ulink>
|
||||
shows the build performance data provided by
|
||||
Toaster.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id='toaster-web-interface-preferred-version'>
|
||||
<title>Building a Specific Recipe Given Multiple Versions</title>
|
||||
|
||||
<para>
|
||||
Occasionally, a layer might provide more than one version of
|
||||
the same recipe.
|
||||
For example, the <filename>openembedded-core</filename> layer
|
||||
provides two versions of the <filename>bash</filename> recipe
|
||||
(i.e. 3.2.48 and 4.3.30-r0) and two versions of the
|
||||
<filename>which</filename> recipe (i.e. 2.21 and 2.18).
|
||||
The following figure shows this exact scenario:
|
||||
<imagedata fileref="figures/bash-oecore.png" align="center" width="9in" depth="6in" />
|
||||
</para>
|
||||
|
||||
<para>
|
||||
By default, the OpenEmbedded build system builds one of the
|
||||
two recipes.
|
||||
For the <filename>bash</filename> case, version 4.3.30-r0 is
|
||||
built by default.
|
||||
Unfortunately, Toaster as it exists, is not able to override
|
||||
the default recipe version.
|
||||
If you would like to build bash 3.2.48, you need to set the
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></ulink>
|
||||
variable.
|
||||
You can do so from Toaster, using the "Add variable" form,
|
||||
which is available in the "BitBake variables" page of the
|
||||
project configuration section as shown in the following screen:
|
||||
<imagedata fileref="figures/add-variable.png" align="center" width="9in" depth="6in" />
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To specify <filename>bash</filename> 3.2.48 as the version to build,
|
||||
enter "PREFERRED_VERSION_bash" in the "Variable" field, and "3.2.48"
|
||||
in the "Value" field.
|
||||
Next, click the "Add variable" button:
|
||||
<imagedata fileref="figures/set-variable.png" align="center" width="9in" depth="6in" />
|
||||
</para>
|
||||
|
||||
<para>
|
||||
After clicking the "Add variable" button, the settings for
|
||||
<filename>PREFERRED_VERSION</filename> are added to the bottom
|
||||
of the BitBake variables list.
|
||||
With these settings, the OpenEmbedded build system builds the
|
||||
desired version of the recipe rather than the default version:
|
||||
<imagedata fileref="figures/variable-added.png" align="center" width="9in" depth="6in" />
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<!--
|
||||
|
|
Loading…
Reference in New Issue