From d5abcfb25877d8dbc71e3c57a476b696d980cc99 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 1 Apr 2015 14:45:56 -0700 Subject: toaster-manual: Applied final review edits. This should be it unless there are late coming comments. (From yocto-docs rev: cb32e3330a6fe2d26425f8765689749afcd989e9) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../toaster-manual/toaster-manual-reference.xml | 90 +++++++++++----------- 1 file changed, 47 insertions(+), 43 deletions(-) (limited to 'documentation/toaster-manual/toaster-manual-reference.xml') diff --git a/documentation/toaster-manual/toaster-manual-reference.xml b/documentation/toaster-manual/toaster-manual-reference.xml index 05184fa1eb..cc118643cd 100644 --- a/documentation/toaster-manual/toaster-manual-reference.xml +++ b/documentation/toaster-manual/toaster-manual-reference.xml @@ -12,19 +12,18 @@ This final chapter provides conceptual information on layer sources, releases, and JSON configuration files. Also provided is a quick look at some useful - manage.py commands. + manage.py commands that are Toaster-specific. Information on manage.py commands does exist across the Web and the information in this manual by no means - attempts to provide a command reference. - However, having relevant command useful for the Toaster context - is helpful. + attempts to provide a command comprehensive reference.
Layer Source - In general, a layer source is some source of existing layers. + In general, a "layer source" is a source of information about + existing layers. In particular, we are concerned with layers that you can use with the Yocto Project and Toaster. This chapter describes a particular type of layer source called @@ -145,7 +144,7 @@
- Select the <filename>toasterconf.json</filename> File + Select for Use the <filename>toasterconf.json</filename> File If you do not want to use the Administration @@ -155,8 +154,8 @@ - When you set up Toaster in Build Mode, you are prompted to - select a Toaster configuration file. + When you set up Toaster in Build Mode, you are prompted + to select a Toaster configuration file. This configuration file is used to set up the initial configuration values within the Toaster database including the layer sources. @@ -309,9 +308,8 @@ $ bitbake/lib/toaster/manage.py loadconf /home/scottrif/poky/meta-yocto/conf/toasterconf.json After entering this command, you need to update the - information from the layer index to populate the - Toaster database with the information from your layer - index. + Toaster database with the information coming from your + new layer source. To do that, you should run the "lsupdates" command from the directory that contains the Toaster database. @@ -329,7 +327,7 @@ information is available by using the Toaster web interface. To do that, visit the "All compatible layers" page inside a Toaster project. - The layers from your layer index should be listed there. + The layers from your layer source should be listed there.
@@ -340,6 +338,8 @@ Releases + When you create a Toaster project using the web interface, + you are asked to choose a "Release." In the context of Toaster, the term "Release" refers to a set of layers and a BitBake version the OpenEmbedded build system uses to build something. @@ -347,8 +347,6 @@ correspond to Yocto Project release branches. However, you can modify, delete, and create new releases according to your needs. - When you create a Toaster project using the web interface, - you are asked to choose a "Release." This section provides some background information on releases. @@ -461,7 +459,7 @@ This name is never exposed through Toaster. Git URL: - The URL giturl + The URL (giturl) for the BitBake Git repository cloned for Toaster projects. @@ -493,9 +491,6 @@ (defaultlayers) automatically added to the project configuration when a project is created. - You can download the recommended configuration - for this case from - . Layer Source Priorities A specification of @@ -522,9 +517,11 @@ To summarize what comprises a release, consider the following example from a Toaster JSON file. - The configuration names the release "master" and sets it to - use the master branch of the - openembedded-core layer. + The configuration names the release "master" and uses the + "master" branch provided by the layer source of type + "layerindex", which is called "OpenEmbedded", and sets + the openembedded-core layer as the one + to be added by default to any projects created in Toaster. The BitBake version used would be defined as shown earlier in the previous list: @@ -548,13 +545,13 @@ JSON Files - If you are going to be using the Toaster in Build Mode, it must + If you are going to be using Toaster in Build Mode, it must be initially configured before use. Configuration customizes layer source settings and Toaster defaults for all users and is performed by the person responsible for Toaster Configuration (i.e the Toaster Administrator). The Toaster Administrator performs this configuration through the - admin web interface. + Django administration interface. @@ -575,10 +572,10 @@ toasterconf.json. The Toaster Administrator can customize the file prior to loading it into Toaster. - In the Local Toaster Build Mode, the system startup script - actively looks for compatible configuration files and prompts - you to select a file to load if it detects that the database has - not been configured. + When you set up Toaster locally to run in Build Mode, the system + startup script actively looks for compatible configuration files + and prompts you to select a file to load if it detects that the + database has not been configured.
@@ -630,7 +627,7 @@ The toasterconf.json file consists of easily readable areas: configuration, layer sources, BitBake, - default, and releases. + default release, and releases.
@@ -760,8 +757,13 @@ This area of the JSON file defines the version of BitBake Toaster uses. - As shipped, Toaster is configured to recognize three + As shipped, Toaster is configured to recognize four versions of BitBake: master, dizzy, and HEAD. + + HEAD is a special option that builds whatever is + available on disk, without checking out any remote + Git repositories. + @@ -937,14 +939,16 @@ using the builddelete command. - For example, assuming default repository and build directory - names, the following two commands put you in the - Build Directory - and then return a list of the current builds, which would - be one in this case: + Here is an example that assumes default repository and build + directory names: - $ cd $HOME/poky/build + $ cd ~/poky/build $ python ../bitbake/lib/toaster/manage.py buildslist + + If your Toaster database had only one build, the above + buildslist command would return something + like the following: + 1: qemux86 poky core-image-minimal @@ -1000,7 +1004,7 @@ $ bitbake/lib/toaster/manage.py checksettings - In Managed Mode, Toaster uses settings that are based on the + In Build Mode, Toaster uses settings that are based on the database to configure the building tasks. The checksettings command verifies that the database settings are valid in the sense that they have @@ -1026,8 +1030,8 @@ <filename>loadconf</filename> - The loadconf command loads a Toaster - configuration file (JSON file). + The loadconf command loads an + existing Toaster configuration file (JSON file). You must run this on a new database that does not have any data. Running this command on an existing database that has data @@ -1037,8 +1041,8 @@ $ bitbake/lib/toaster/manage.py loadconf filepath The loadconf command configures a database - based on the supplied toasterconf.json - file. + based on the supplied existing + toasterconf.json file. For information on the toasterconf.json, see the "JSON Files" @@ -1050,7 +1054,7 @@ <filename>runbuilds</filename> - The runbuilds command launched + The runbuilds command launches scheduled builds. Access the command as follows: @@ -1061,8 +1065,8 @@ per schedule. The command returns after the builds start but before they complete. - The "toasterui" build recorded updates the database when the - builds complete. + The Toaster Logging Interface records and updates the database + when the builds complete.
-- cgit v1.2.3-54-g00ecf