| Message ID | 20250207-migration-5-2-updates-v3-2-9571efbb1cd0@bootlin.com |
|---|---|
| State | Under Review |
| Headers | show |
| Series | migration-5.2: Add entries for virtual provider and multiconfig changes | expand |
Hi Antonin, On 2/7/25 9:27 AM, Antonin Godard wrote: > The commit 4ccc3bc8266c ("classes/recipes: Switch virtual/XXX-gcc to > virtual/cross-cc (and c++/binutils)") in OE-Core changes the > virtual/XXX-gcc to virtual/cross-cc (and c++/binutils) syntax. Add it to > the migration manual. > > Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> > Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> > --- > documentation/migration-guides/migration-5.2.rst | 35 ++++++++++++++++++++++++ > 1 file changed, 35 insertions(+) > > diff --git a/documentation/migration-guides/migration-5.2.rst b/documentation/migration-guides/migration-5.2.rst > index a60e3e9a8..2e9095bfb 100644 > --- a/documentation/migration-guides/migration-5.2.rst > +++ b/documentation/migration-guides/migration-5.2.rst > @@ -105,6 +105,41 @@ some obscure bugs. > Any logic based on ``BB_CURRENT_MC`` equalling to ``default`` by default should > be changed to be equal to an empty string. > > +Virtual toolchain provider changes > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +Support was added for virtual providers on a per-recipe basis for specific > +key toolchain providers listed in ``BB_VIRTUAL_RECIPE_PROVIDERS``. As part of > +that support, the ``cross`` providers were simplified to remove the triplet > +prefix (:term:`TARGET_PREFIX`, :term:`SDK_PREFIX` and :term:`HOST_PREFIX`) and > +generalise the naming. Here are example of how references to these variables s/example/examples? With that changed, Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de> Thanks! Quentin
diff --git a/documentation/migration-guides/migration-5.2.rst b/documentation/migration-guides/migration-5.2.rst index a60e3e9a8..2e9095bfb 100644 --- a/documentation/migration-guides/migration-5.2.rst +++ b/documentation/migration-guides/migration-5.2.rst @@ -105,6 +105,41 @@ some obscure bugs. Any logic based on ``BB_CURRENT_MC`` equalling to ``default`` by default should be changed to be equal to an empty string. +Virtual toolchain provider changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Support was added for virtual providers on a per-recipe basis for specific +key toolchain providers listed in ``BB_VIRTUAL_RECIPE_PROVIDERS``. As part of +that support, the ``cross`` providers were simplified to remove the triplet +prefix (:term:`TARGET_PREFIX`, :term:`SDK_PREFIX` and :term:`HOST_PREFIX`) and +generalise the naming. Here are example of how references to these variables +can be changed to use the new ``cross`` syntax:: + + virtual/${HOST_PREFIX}binutils -> virtual/cross-binutils + virtual/${TARGET_PREFIX}binutils -> virtual/cross-binutils + + virtual/${HOST_PREFIX}gcc -> virtual/cross-cc + virtual/${TARGET_PREFIX}gcc -> virtual/cross-cc + virtual/${SDK_PREFIX}gcc -> virtual/nativesdk-cross-cc + + virtual/${HOST_PREFIX}compilerlibs -> virtual/compilerlibs + virtual/${TARGET_PREFIX}compilerlibs -> virtual/compilerlibs + virtual/nativesdk-${SDK_PREFIX}compilerlibs -> virtual/nativesdk-compilerlibs + + virtual/${TARGET_PREFIX}g++ -> virtual/cross-c++ + +A :term:`PREFERRED_PROVIDER` assignment can be transformed as follows:: + + PREFERRED_PROVIDER_virtual/${TARGET_PREFIX}binutils -> PREFERRED_PROVIDER_virtual/cross-binutils + PREFERRED_PROVIDER_virtual/${SDK_PREFIX}binutils -> PREFERRED_PROVIDER_virtual/cross-binutils:class-nativesdk + PREFERRED_PROVIDER_virtual/${SDK_PREFIX}g++ -> PREFERRED_PROVIDER_virtual/nativesdk-cross-c++ + +The above examples should cover most cases, but there might be situations where +replacing is not as straightforward. For more examples, see the commit +:oe_git:`"classes/recipes: Switch virtual/XXX-gcc to virtual/cross-cc (and +c++/binutils)" </openembedded-core/commit/?id=4ccc3bc8266c>` in +:term:`OpenEmbedded-Core (OE-Core)`. + Recipe changes ~~~~~~~~~~~~~~
The commit 4ccc3bc8266c ("classes/recipes: Switch virtual/XXX-gcc to virtual/cross-cc (and c++/binutils)") in OE-Core changes the virtual/XXX-gcc to virtual/cross-cc (and c++/binutils) syntax. Add it to the migration manual. Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> --- documentation/migration-guides/migration-5.2.rst | 35 ++++++++++++++++++++++++ 1 file changed, 35 insertions(+)