Re: Syntax of multiconfig


Khem Raj
 

On Sat, Nov 7, 2020 at 5:53 AM Manuel Wagesreither <ManWag@fastmail.fm> wrote:

Hello all,

I'm trying the become acquainted with the multiconfig feature. I read the relevant chapters in the BitBake User Manual, but some questions I have suggest I did not yet get the whole picture.


1.)
In [1] the following examples are given:

`$ bitbake mc::target mc:target1:target mc:target2:target`

What does the `mc::target` stand for? If I omit the multiconfigname, is the target getting built for all configured multibuildnames?
bitbake mc:target1:target

mc = qualifier keyword used to identify a multiconfig build by bitbake
target1 = name of multiconfig ( e.g. first machine )
target = Firmware image name to be built for this multiconfig



[1] https://www.yoctoproject.org/docs/latest/bitbake-user-manual/bitbake-user-manual.html#executing-a-multiple-configuration-build
The sample there seems to be wrong, it should just be bitbake
mc:target1:image1 mc:target2:image2


2.)
In [2], the following example is given:

`task_or_package[mcdepends] = "mc:from_multiconfig:to_multiconfig:recipe_name:task_on_which_to_depend"`
`image_task[mcdepends] = "mc:target1:target2:image2:rootfs_task"`

I do not understand why the `from_multiconfig` needs to be given at all. Isn't this redundant information? Per my understanding, when I'm having bitbake bake an image `my-image`, and this image includes a recipe which has such a multiconfig dependency, `from_multiconfig` must be `my-image` as well. So why the need for `from_multiconfig` at all?

I think it wouldn't just add any value, but would actively prevent this recipe/package to be included in images getting built in other configurations.
assuming the default to be current mc target for from_multiconfig is
troublesome when say you build same image but for mc:target2 in such a
case there will be circular dependency. So being explicit enables to
specify m to n dependencies.


So I probably my understanding here is wrong.

[2] https://www.yoctoproject.org/docs/latest/bitbake-user-manual/bitbake-user-manual.html#bb-enabling-multiple-configuration-build-dependencies


3.)
The links above are using `target_1` and `target_2` for as configuration names. I think this is misleading, as target already refers to the recipe/package or image bitbake is building. How can I contribute to the BitBake documentation?
now documentation has moved to sphinx there is separate mailing list
for docs so git format-patch and send them to
docs@lists.yoctoproject.org

here are archives for this month
https://lists.yoctoproject.org/g/docs/messages?start=11:2020:480

I checked [3] but couldn't see anything referencing the documentation.

[3] https://wiki.yoctoproject.org/wiki/Newcomers#How_to_Contribute


Best regards
Manuel


Join yocto@lists.yoctoproject.org to automatically receive all group messages.