From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id CB785C4332F for ; Mon, 6 Nov 2023 10:59:09 +0000 (UTC) Received: from metis.whiteo.stw.pengutronix.de (metis.whiteo.stw.pengutronix.de [185.203.201.7]) by mx.groups.io with SMTP id smtpd.web11.51080.1699268347195817868 for ; Mon, 06 Nov 2023 02:59:08 -0800 Authentication-Results: mx.groups.io; dkim=none (message not signed); spf=pass (domain: pengutronix.de, ip: 185.203.201.7, mailfrom: u.oelmann@pengutronix.de) Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.whiteo.stw.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qzxJw-00012o-Co; Mon, 06 Nov 2023 11:59:04 +0100 Received: from [2a0a:edc0:2:b01:1d::c5] (helo=pty.whiteo.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qzxJv-0070Qq-Pc; Mon, 06 Nov 2023 11:59:03 +0100 Received: from uol by pty.whiteo.stw.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1qzxJv-008lSd-GW; Mon, 06 Nov 2023 11:59:03 +0100 References: <76de363e7d3d18d38be8d63cbd683e22337f7af6.1699266393.git.bluelightning@bluelightning.org> User-agent: mu4e 1.6.9; emacs 29.0.50 From: Ulrich =?utf-8?Q?=C3=96lmann?= To: Paul Eggleton Cc: michael.opdenacker@bootlin.com, docs@lists.yoctoproject.org Subject: Re: [docs] [PATCH 12/12] migration-4.3: additional migration items Date: Mon, 06 Nov 2023 11:58:02 +0100 In-reply-to: <76de363e7d3d18d38be8d63cbd683e22337f7af6.1699266393.git.bluelightning@bluelightning.org> Message-ID: <6rbkc7i1vs.fsf@pengutronix.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-SA-Exim-Connect-IP: 2a0a:edc0:0:c01:1d::a2 X-SA-Exim-Mail-From: u.oelmann@pengutronix.de X-SA-Exim-Scanned: No (on metis.whiteo.stw.pengutronix.de); SAEximRunCond expanded to false X-PTX-Original-Recipient: docs@lists.yoctoproject.org List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 06 Nov 2023 10:59:09 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/4602 Hi Paul, just a small typo. On Mon, Nov 06 2023 at 23:29 +1300, "Paul Eggleton" wrote: > Add the following: > > * Removed recipes > * One removed class > * Output file name changes > * Versioning changes > * tunctl removal > > Signed-off-by: Paul Eggleton > --- > .../migration-guides/migration-4.3.rst | 77 ++++++++++++++++++- > 1 file changed, 76 insertions(+), 1 deletion(-) > > diff --git a/documentation/migration-guides/migration-4.3.rst b/documenta= tion/migration-guides/migration-4.3.rst > index 17ea4e71276..fcad9ef5eef 100644 > --- a/documentation/migration-guides/migration-4.3.rst > +++ b/documentation/migration-guides/migration-4.3.rst > @@ -135,7 +135,15 @@ Removed recipes >=20=20 > The following recipes have been removed in this release: >=20=20 > -- ``glide``, as explained in :ref:`migration-4.3-go-changes`. > +- ``apmd``: obsolete (``apm`` in :term:`MACHINE_FEATURES` also removed). > +- ``cve-update-db-native``: functionally replaced by ``cve-update-nvd2-= native`` > +- ``gcr3``: no longer needed by core recipes, moved to meta-gnome (gcr,= i.e. version 4.x, is still provided). > +- ``glide``: as explained in :ref:`migration-4.3-go-changes`. > +- ``libdmx``: obsolete > +- ``linux-yocto`` version 5.15 (versions 6.1 and 6.5 provided instead). > +- ``python3-async``: obsolete - no longer needed by ``python3-gitdb`` o= r any other core recipe > +- ``rust-hello-world``: there are sufficient other Rust recipes and tes= t cases such that this is no longer needed. > + >=20=20 > .. _migration-4.3-removed-classes: >=20=20 > @@ -144,6 +152,68 @@ Removed classes >=20=20 > The following classes have been removed in this release: >=20=20 > +- ``glide``: as explained in :ref:`migration-4.3-go-changes`. > + > + > +Output file naming changes > +~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +In 4.3 there are some minor differences in image and SDK output file nam= es. > +If you rely on the existing naming (e.g. in external scripts) you may ne= ed to > +either modify configuration or adapt to the new naming. Further details: > + > +- :term:`IMAGE_NAME` and :term:`IMAGE_LINK_NAME` now include the > + :term:`IMAGE_NAME_SUFFIX` value directly. In practical terms, this me= ans > + that ``.rootfs`` will now appear in image output file names. If you d= o not > + wish to have the ``.rootfs`` suffix used, you can just set > + :term:`IMAGE_NAME_SUFFIX` to "" and this will now be consistently res= pected > + in both the image file and image file symlink names. As part of this = change, > + support for the ``imgsuffix`` task varflag has been dropped (mostly > + an internal implementation detail, but if you were implementing a cus= tom > + image construction with a task in a similar manner to ``do_bootimg`` > + you may have been using this). > + > +- :term:`SDK_NAME` now includes the values of :term:`IMAGE_BASENAME` and > + :term:`MACHINE` so that they are unique when building SDKs for differ= ent > + images and machines. > + > + > + > +.. _migration-4.3-pr-pe: > + > +Versioning changes > +~~~~~~~~~~~~~~~~~~ > + > +- :term:`PR` values have been removed from all core recipes - distro ma= intainers > + who make use of :term:`PR` values would need to curate these already = so the > + sparsely set base values would not be that useful anymore. If you hav= e been > + relying on these (i.e. you are maintaining a binary package feed wher= e package > + versions should only ever increase), double-check the output (perhaps= with the > + help of the :ref:`ref-classes-buildhistory` class) to ensure that pac= kage > + versions are consistent. > + > +- The :term:`PR` value can no longer be set from the recipe file name -= this > + was rarely used, but in any case is no longer supported. > + > +- :term:`PE` and :term:`PR` are no longer included in the work director= y path > + (:term:`WORKDIR`). This may break some tool assumptions about directo= ry paths, > + but those should really be querying paths from the build system (or n= ot poking > + into :term:`WORKDIR` externally). > + > +- Source revision information has been moved from :term:`PV` to :term:`= PKGV`. > + The user visible effect of this change is that :term:`PV` will no lon= ger have > + revision information in it and this will now be appended to the :term= :`PV` > + value through :term:`PKGV` when the packages are written out (as long= as "+" > + is present in the :term:`PKGV` value). Since :term:`PV` is used in > + :term:`STAMP` and :term:`WORKDIR`, you may notice small directory nam= ing and > + stamp naming changes. > + > +- The :term:`SRCPV` variable is no longer be needed in :term:`PV`, but = since s/is no longer be needed/is no longer needed/ Best regards Ulrich > + the default :term:`SRCPV` value is now "", using it is effectively no= w just a > + null operation - you can remove it (leaving behind the "+") , but it = is not > + yet required to do so. > + > + > .. _migration-4.3-qemu-changes: >=20=20 > QEMU changes > @@ -162,6 +232,11 @@ QEMU changes > This change was made to avoid exceeding two serial ports, which inter= feres > with automated testing. >=20=20 > +- ``runqemu`` now uses the ``ip tuntap`` command instead of ``tunctl``,= and > + thus ``tunctl`` is no longer built by the ``qemu-helper-native`` reci= pe; if > + for some reason you were calling ``tunctl`` directly from your own sc= ripts > + you should switch to calling ``ip tuntap`` instead. > + > .. _migration-4.3-misc-changes: >=20=20 > Miscellaneous changes --=20 Pengutronix e.K. | Ulrich =C3=96lmann = | Industrial Linux Solutions | http://www.pengutronix.de/ | Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 | Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |