mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-01 00:59:48 +00:00
Code Issues Projects Releases Wiki Activity

documentation: Update multiconfig syntax and explanation on BBMULTICONFIG

Browse Source 
The syntax to use multiconfig builds changed from multiconfig:foo:target
to mc:foo:target.

Clarify that BBMULTICONFIG defines additional configurations along with
the one coming from local.conf.

Fix these changes on both the dev manual and the reference manual.

(From yocto-docs rev: 9e79e96cad66316c1b4ee608723edfa763f0f9ef)

Signed-off-by: Alejandro Enedino Hernandez Samaniego <aehs29@gmail.com>
Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Alejandro Enedino Hernandez Samaniego
2019-10-08 17:36:11 -07:00
committed by Richard Purdie
parent 704c3e623e
commit 677bfa6a69
2 changed files with 19 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/dev-manual/dev-manual-common-tasks.xml
+17 -9
View File
@@ -5420,26 +5420,34 @@
<literallayout class='monospaced'> <literallayout class='monospaced'>
BBMULTICONFIG = "x86 arm" BBMULTICONFIG = "x86 arm"
</literallayout> </literallayout>
</para>
<para>Please note, that a "default" configuration already exists by definition,
this configuration is named: "" (empty string) and is defined by the variables
coming from your local.conf file. So, the previous example actually adds two
additional configurations to your build "arm" and "x86" along with "".
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Launch BitBake</emphasis>: <emphasis>Launch BitBake</emphasis>:
Use the following BitBake command form to launch the Use the following BitBake command form to launch the
multiple configuration build: multiple configuration build:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ bitbake [multiconfig:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable> [[[multiconfig:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable>] ... ] $ bitbake [mc:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable> [[[mc:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable>] ... ]
</literallayout> </literallayout>
For the example in this section, the following For the example in this section, the following
command applies: command applies:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ bitbake multiconfig:x86:core-image-minimal multiconfig:arm:core-image-sato $ bitbake mc:x86:core-image-minimal mc:arm:core-image-sato mc::core-image-base
</literallayout> </literallayout>
The previous BitBake command builds a The previous BitBake command builds a
<filename>core-image-minimal</filename> image that <filename>core-image-minimal</filename> image that
is configured through the is configured through the
<filename>x86.conf</filename> configuration file <filename>x86.conf</filename> configuration file,
and builds a <filename>core-image-sato</filename> a <filename>core-image-sato</filename>
image that is configured through the image that is configured through the
<filename>arm.conf</filename> configuration file. <filename>arm.conf</filename> configuration file and a
<filename>core-image-base</filename> that is configured
through your <filename>local.conf</filename> configuration file.
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
<note> <note>
@@ -5479,7 +5487,7 @@
build, you must declare the dependencies in the recipe build, you must declare the dependencies in the recipe
using the following statement form: using the following statement form:
<literallayout class='monospaced'> <literallayout class='monospaced'>
<replaceable>task_or_package</replaceable>[mcdepends] = "multiconfig:<replaceable>from_multiconfig</replaceable>:<replaceable>to_multiconfig</replaceable>:<replaceable>recipe_name</replaceable>:<replaceable>task_on_which_to_depend</replaceable>" <replaceable>task_or_package</replaceable>[mcdepends] = "mc:<replaceable>from_multiconfig</replaceable>:<replaceable>to_multiconfig</replaceable>:<replaceable>recipe_name</replaceable>:<replaceable>task_on_which_to_depend</replaceable>"
</literallayout> </literallayout>
To better show how to use this statement, consider the To better show how to use this statement, consider the
example scenario from the first paragraph of this section. example scenario from the first paragraph of this section.
@@ -5487,7 +5495,7 @@
that builds the <filename>core-image-sato</filename> that builds the <filename>core-image-sato</filename>
image: image:
<literallayout class='monospaced'> <literallayout class='monospaced'>
do_image[mcdepends] = "multiconfig:x86:arm:core-image-minimal:do_rootfs" do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_rootfs"
</literallayout> </literallayout>
In this example, the In this example, the
<replaceable>from_multiconfig</replaceable> is "x86". <replaceable>from_multiconfig</replaceable> is "x86".
@@ -5502,7 +5510,7 @@
Once you set up this dependency, you can build the Once you set up this dependency, you can build the
"x86" multiconfig using a BitBake command as follows: "x86" multiconfig using a BitBake command as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ bitbake multiconfig:x86:core-image-sato $ bitbake mc:x86:core-image-sato
</literallayout> </literallayout>
This command executes all the tasks needed to create This command executes all the tasks needed to create
the <filename>core-image-sato</filename> image for the the <filename>core-image-sato</filename> image for the
@@ -5518,7 +5526,7 @@
Consider this change to the statement in the Consider this change to the statement in the
<filename>core-image-sato</filename> recipe: <filename>core-image-sato</filename> recipe:
<literallayout class='monospaced'> <literallayout class='monospaced'>
do_image[mcdepends] = "multiconfig:x86:arm:core-image-minimal:do_image" do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_image"
</literallayout> </literallayout>
In this case, BitBake must create the In this case, BitBake must create the
<filename>core-image-minimal</filename> image for the <filename>core-image-minimal</filename> image for the
documentation/ref-manual/ref-variables.xml
+2 -2
View File
@@ -1344,12 +1344,12 @@
<glossentry id='var-BBMULTICONFIG'><glossterm>BBMULTICONFIG</glossterm> <glossentry id='var-BBMULTICONFIG'><glossterm>BBMULTICONFIG</glossterm>
<info> <info>
BBMULTICONFIG[doc] = "Specifies each separate configuration when you are building targets with multiple configurations." BBMULTICONFIG[doc] = "Specifies each additional separate configuration when you are building targets with multiple configurations."
</info> </info>
<glossdef> <glossdef>
<para role="glossdeffirst"> <para role="glossdeffirst">
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
Specifies each separate configuration when you are Specifies each additional separate configuration when you are
building targets with multiple configurations. building targets with multiple configurations.
Use this variable in your Use this variable in your
<filename>conf/local.conf</filename> configuration file. <filename>conf/local.conf</filename> configuration file.