From patchwork Tue Apr 11 10:25:57 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 22524 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 33F5DC77B72 for ; Tue, 11 Apr 2023 10:26:31 +0000 (UTC) Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web10.10186.1681208781655822403 for ; Tue, 11 Apr 2023 03:26:22 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=WYcTGLYS; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: michael.opdenacker@bootlin.com) Received: (Authenticated sender: michael.opdenacker@bootlin.com) by mail.gandi.net (Postfix) with ESMTPSA id 85D4CFF808; Tue, 11 Apr 2023 10:26:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1681208780; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=L8Xn9PEO28UUAWlqWPFmcLTN2uQj4W6kq+3r/pgtRxA=; b=WYcTGLYSdcZnBycNd2N1K9yR6YlNRi00mKR6ddGCLLl/7k8W9Wxsq+pr473FTOyyoNuRja sIiNEbIahpz0YAsAhEWsk4k1/g7YrSbROTI9Qou/NMHkyjLebepSVneiXClEgY2cbwrX/R Y0lLPPi/OcJ5nN6HrnGcp1BurpRUAEysiaUFGZpOoAYiOW3vIs4Ltn36VtsgkqC2nTF7u6 YzTLGfdjk1f8MwxjlrgY6NJ609piJUsnaURI8f0CFbAhMY1956XO4m+lQD5QZsS22tRM3C VLrGO6KLf13i89GxhjX0Ey97VTke0PL3LrkpoCo3B/wPlCE+2dcEGmfmxqQCLQ== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: openembedded-core@lists.openembedded.org, alexis.lothore@bootlin.com, Michael Opdenacker , Frederic Martinsons , Marta Rybczynska , Paul Eggleton , Alex Kiernan Subject: [PATCH v4] migration-guides: update 4.2 migration and release notes Date: Tue, 11 Apr 2023 12:25:57 +0200 Message-Id: <20230411102557.461391-1-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <17539E6A97252C13.11304@lists.openembedded.org> References: <17539E6A97252C13.11304@lists.openembedded.org> MIME-Version: 1.0 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 ; Tue, 11 Apr 2023 10:26:31 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3834 From: Michael Opdenacker Signed-off-by: Michael Opdenacker CC: Frederic Martinsons CC: Marta Rybczynska CC: Paul Eggleton CC: Alex Kiernan CC: Alexis Lothoré ` +for example. + +The ``cargo-update-recipe-crates`` utility +:yocto_git:`has been extended ` +to include such checksums. So, in case you need to add the list of checksums +to a recipe just inheriting the :ref:`ref-classes-cargo` class so far, you can +follow these steps: + +#. Make the recipe inherit :ref:`ref-classes-cargo-update-recipe-crates` +#. Remove all ``crate://`` lines from the recipe +#. Create an empty ``${BPN}-crates.inc`` file and make your recipe require it +#. Execute ``bitbake -c update_crates your_recipe`` +#. Copy and paste the output of BitBake about the missing checksums into the + ``${BPN}-crates.inc`` file. + .. _migration-4.2-qa-checks: QA check changes ~~~~~~~~~~~~~~~~ +.. _migration-4.2-supported-distributions: + +Supported distributions +~~~~~~~~~~~~~~~~~~~~~~~ + +This release supports running BitBake on new GNU/Linux distributions: + +- Fedora 36 and 37 +- AlmaLinux 8.7 and 9.1 +- OpenSuse 15.4 + +On the other hand, some earlier distributions are no longer supported: + +- Debian 10.x +- Fedora 34 and 35 +- AlmaLinux 8.5 + +See :ref:`all supported distributions `. + .. _migration-4.2-misc-changes: Miscellaneous changes @@ -30,6 +97,7 @@ Miscellaneous changes - The ``OEBasic`` signature handler (see :term:`BB_SIGNATURE_HANDLER`) has been removed. + .. _migration-4.2-removed-variables: @@ -38,7 +106,7 @@ Removed variables The following variables have been removed: -- ``SERIAL_CONSOLE``, deprecated since version 2.6, replaced by :term:``SERIAL_CONSOLES``. +- ``SERIAL_CONSOLE``, deprecated since version 2.6, replaced by :term:`SERIAL_CONSOLES`. .. _migration-4.2-removed-recipes: @@ -47,3 +115,17 @@ Removed recipes The following recipes have been removed in this release: +- ``python3-picobuild``: after switching to ``python3-build`` +- ``python3-strict-rfc3339``: unmaintained and not needed by anything in + :oe_git:`openembedded-core ` + or :oe_git:`meta-openembedded `. + +.. _migration-4.2-removed-classes: + +Removed classes +~~~~~~~~~~~~~~~ + +The following classes have been removed in this release: + +- ``rust-bin``: no longer used in Poky + diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst index edafe378b0..b6e278ee5d 100644 --- a/documentation/migration-guides/release-notes-4.2.rst +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -6,23 +6,90 @@ Release notes for 4.2 (mickledore) New Features / Enhancements in 4.2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- Python 3.8 is the minimum Python version required on the build host. - For host distributions that do not provide it, this is included as part of the - :term:`buildtools` tarball. +- Python 3.8 is the minimum Python version required on the build host. + For host distributions that do not provide it, this is included as part of the + :term:`buildtools` tarball. -- This release now supports a new ``addpylib`` directive to enable - Python libraries within layers. +- BitBake in this release now supports a new ``addpylib`` directive to enable + Python libraries within layers. - This directive should be added to your layer configuration, - as in the below example from ``meta/conf/layer.conf``:: + This directive should be added to your layer configuration + as in the below example from ``meta/conf/layer.conf``:: - addpylib ${LAYERDIR}/lib oe + addpylib ${LAYERDIR}/lib oe + +- BitBake has seen multiple internal changes that may impact + memory and disk usage as well as parsing time, in particular: + + - BitBake's Cooker server is now multithreaded. + + - BitBake's cache has been extended to include more hash + debugging data, but has also been optimized to :yocto_git:`compress + cache data `. + + - BitBake's Cooker server :yocto_git:`can now be pinged + https://git.yoctoproject.org/poky/commit/?h=mickledore&id=26f255da09>` + from the UI. - Architecture-specific enhancements: + - This release adds initial support for the + :wikipedia:`LoongArch ` + (``loongarch64``) architecture, though there is no testing for it yet. + - Kernel-related enhancements: - QEMU/runqemu enhancements: - Image-related enhancements: +- New variables: + + - :term:`VOLATILE_TMP_DIR` allows to specify + whether ``/tmp`` should be on persistent storage + or in RAM. + +- Rust improvements: + + - This release adds Cargo support on the target, and includes + automated QA tests for this functionality. + + - It also supports checksums for Rust crates and makes + them mandatory for each crate in a recipe. + +- Testing: + + - The ptest images have changed structure in this release. The + underlying ``core-image-ptest`` recipe now uses :term:`BBCLASSEXTEND` to + create a variant for each ptest enabled recipe in OE-Core. + + For example, this means that ``core-image-ptest-bzip2``, + ``core-image-ptest-lttng-tools`` and many more image targets now exist + and can be built/tested individually. + + The ``core-image-ptest-all`` and ``core-image-ptest-fast`` targets are now + wrappers that target groups of individual images and means that the tests + can be executed in parallel during our automated testing. This also means + the dependencies are more accurately tested. + + - It is now possible to track regression changes between releases using + :oe_git:`yocto_testresults_query.py `, + which is a thin wrapper over :oe_git:`resulttool + `. Here is an example + command, which allowed to spot and fix a regression in the + ``quilt`` ptest:: + + yocto_testresults_query.py regression-report 4.2_M1 4.2_M2 + + See this `blog post about regression detection + `__. + + - This release adds support for parallel ptest execution with a ptest per image. + This takes ptest execution time from 3.5 hours to around 45 minutes on the autobuilder. + +- Miscellaneous changes: + + - Supporting 64 bit dates on 32 bit platforms: several packages have been + updated to pass Y2038 tests. + + - Many packages were updated to add large file support.