Complete Yocto mirror with license table for TQMa6UL (2038-compliance)
- 264 license table entries with exact download URLs (224/264 resolved) - Complete sources/ directory with all BitBake recipes - Build configuration: tqma6ul-multi-mba6ulx, spaetzle (musl) - Full traceability for Softwarefreigabeantrag - GCC 13.4.0, Linux 6.6.102, U-Boot 2023.04, musl 1.2.4 - License distribution: GPL-2.0 (24), MIT (23), GPL-2.0+ (18), BSD-3 (16)
This commit is contained in:
102
sources/poky/documentation/toaster-manual/intro.rst
Normal file
102
sources/poky/documentation/toaster-manual/intro.rst
Normal file
@@ -0,0 +1,102 @@
|
||||
.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
|
||||
|
||||
************
|
||||
Introduction
|
||||
************
|
||||
|
||||
Toaster is a web interface to the Yocto Project's
|
||||
:term:`OpenEmbedded Build System`. The interface
|
||||
enables you to configure and run your builds. Information about builds
|
||||
is collected and stored in a database. You can use Toaster to configure
|
||||
and start builds on multiple remote build servers.
|
||||
|
||||
Toaster Features
|
||||
================
|
||||
|
||||
Toaster allows you to configure and run builds, and it provides
|
||||
extensive information about the build process.
|
||||
|
||||
- *Configure and Run Builds:* You can use the Toaster web interface to
|
||||
configure and start your builds. Builds started using the Toaster web
|
||||
interface are organized into projects. When you create a project, you
|
||||
are asked to select a release, or version of the build system you
|
||||
want to use for the project builds. As shipped, Toaster supports
|
||||
Yocto Project releases 1.8 and beyond. With the Toaster web
|
||||
interface, you can:
|
||||
|
||||
- Browse layers listed in the various
|
||||
:ref:`layer sources <toaster-manual/reference:layer source>`
|
||||
that are available in your project (e.g. the OpenEmbedded Layer Index at
|
||||
:oe_layerindex:`/`).
|
||||
|
||||
- Browse images, recipes, and machines provided by those layers.
|
||||
|
||||
- Import your own layers for building.
|
||||
|
||||
- Add and remove layers from your configuration.
|
||||
|
||||
- Set configuration variables.
|
||||
|
||||
- Select a target or multiple targets to build.
|
||||
|
||||
- Start your builds.
|
||||
|
||||
Toaster also allows you to configure and run your builds from the
|
||||
command line, and switch between the command line and the web
|
||||
interface at any time. Builds started from the command line appear
|
||||
within a special Toaster project called "Command line builds".
|
||||
|
||||
- *Information About the Build Process:* Toaster also records extensive
|
||||
information about your builds. Toaster collects data for builds you
|
||||
start from the web interface and from the command line as long as
|
||||
Toaster is running.
|
||||
|
||||
.. note::
|
||||
|
||||
You must start Toaster before the build or it will not collect
|
||||
build data.
|
||||
|
||||
With Toaster you can:
|
||||
|
||||
- See what was built (recipes and packages) and what packages were
|
||||
installed into your final image.
|
||||
|
||||
- Browse the directory structure of your image.
|
||||
|
||||
- See the value of all variables in your build configuration, and
|
||||
which files set each value.
|
||||
|
||||
- Examine error, warning, and trace messages to aid in debugging.
|
||||
|
||||
- See information about the BitBake tasks executed and reused during
|
||||
your build, including those that used shared state.
|
||||
|
||||
- See dependency relationships between recipes, packages, and tasks.
|
||||
|
||||
- See performance information such as build time, task time, CPU
|
||||
usage, and disk I/O.
|
||||
|
||||
For an overview of Toaster, see this
|
||||
`introduction video <https://youtu.be/BlXdOYLgPxA>`__.
|
||||
|
||||
Installation Options
|
||||
====================
|
||||
|
||||
You can set Toaster up to run as a local instance or as a shared hosted
|
||||
service.
|
||||
|
||||
When Toaster is set up as a local instance, all the components reside on
|
||||
a single build host. Fundamentally, a local instance of Toaster is
|
||||
suited for a single user developing on a single build host.
|
||||
|
||||
.. image:: figures/simple-configuration.png
|
||||
:align: center
|
||||
:width: 70%
|
||||
|
||||
Toaster as a hosted service is suited for multiple users developing
|
||||
across several build hosts. When Toaster is set up as a hosted service,
|
||||
its components can be spread across several machines:
|
||||
|
||||
.. image:: figures/hosted-service.png
|
||||
:align: center
|
||||
:width: 50%
|
||||
Reference in New Issue
Block a user