From patchwork Wed Apr 5 17:46:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 22277 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 ED70BC761AF for ; Wed, 5 Apr 2023 17:47:09 +0000 (UTC) Received: from relay4-d.mail.gandi.net (relay4-d.mail.gandi.net [217.70.183.196]) by mx.groups.io with SMTP id smtpd.web10.137475.1680716827770841173 for ; Wed, 05 Apr 2023 10:47:08 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=YJ+BnW7C; spf=pass (domain: bootlin.com, ip: 217.70.183.196, mailfrom: michael.opdenacker@bootlin.com) Received: (Authenticated sender: michael.opdenacker@bootlin.com) by mail.gandi.net (Postfix) with ESMTPSA id D16F1E0002; Wed, 5 Apr 2023 17:47:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1680716825; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=l8mOpQa6CsC/KWi/gsHKY75SNHQWiina8t6/wFb/tnk=; b=YJ+BnW7CT/2sdrgGzUWr71P4QjUAQJVCN9k59j91Xihc4F24ILegWksUksG8zyvsHirUQf RLs1cwPmWBTDxkRehJQzZbywKnjE92MvWXbZ5XlZd06K1sWQ8kN7Mb/i2T55C+MZRfNxoR BujIc1fbuqnjjGdkFtHys3E0gYdANq18+/s7imjIMxjoYDFtnAPAVEqSve/z19Cs+GjB/4 lQssyGHBp/9uzsMteRPMHBc30Mrys/Qr5ROXc1I7f0W4us+OeQUApLBpwqEGzhMXhv1W5T 20Mufc8+PQF4BDoG7wf6xix1242/vBwLDHvqI2i3pHdUrgtYqHSVesrC2CXCLg== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: openembedded-core@lists.openembedded.org, Michael Opdenacker , Frederic Martinsons , Marta Rybczynska , Paul Eggleton , Alex Kiernan Subject: [PATCH] migration-guides: update 4.2 migration and release notes Date: Wed, 5 Apr 2023 19:46:35 +0200 Message-Id: <20230405174635.228857-1-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.34.1 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 ; Wed, 05 Apr 2023 17:47:09 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3827 From: Michael Opdenacker Signed-off-by: Michael Opdenacker CC: Frederic Martinsons CC: Marta Rybczynska CC: Paul Eggleton CC: Alex Kiernan --- .../migration-guides/migration-4.2.rst | 75 ++++++++++++++++++- .../migration-guides/release-notes-4.2.rst | 68 +++++++++++++++-- 2 files changed, 134 insertions(+), 9 deletions(-) diff --git a/documentation/migration-guides/migration-4.2.rst b/documentation/migration-guides/migration-4.2.rst index 1339411b3e..3b04e072cb 100644 --- a/documentation/migration-guides/migration-4.2.rst +++ b/documentation/migration-guides/migration-4.2.rst @@ -18,11 +18,69 @@ BitBake and OpenEmbedded-Core are now relying on Python 3.8, making it a requirement to use a distribution providing at least this version, or to use :term:`buildtools`. +.. _migration-4.2-gcc-8.0: + +gcc 8.0 is now the minumum required GNU C compiler version +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This version, released in 2018, is a minimum requirement +to build the ``mesa-native`` recipe. + +.. _migration-4.2-new-nvd-api: + +Fetching the NVD vulnerability database through the 2.0 API +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This new version adds a new fetcher for the NVD database using the 2.0 API, +as the 1.0 API will be retired in 2023. + +The implementation changes as little as possible, keeping the current +database format (but using a different database file for the transition +period), with a notable exception of not using the META table. + +Here are minor changes that you may notice: + +- The database starts in 1999 instead of 2002 +- The complete fetch is longer (30 minutes typically) + +.. _migration-4.2-rust-crate-checksums: + +Rust: mandatory checksums for crates +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This release now supports checksums for Rust crates and make +them mandatory for each crate in a recipe. See :yocto_git:`python3_bcrypt recipe changes +` +for example. + +The ``cargo-update-recipe-crates`` utility +:yocto_git:`has been extended ` +to include such checksums. + .. _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 +88,7 @@ Miscellaneous changes - The ``OEBasic`` signature handler (see :term:`BB_SIGNATURE_HANDLER`) has been removed. + .. _migration-4.2-removed-variables: @@ -38,7 +97,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 +106,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..1a60fe5490 100644 --- a/documentation/migration-guides/release-notes-4.2.rst +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -6,23 +6,75 @@ 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 ``test-results`` script has been substantially improved + to better process and help to interpret test results. + See `this example `__. + + - It is now possible to track regression changes between releases using + ``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 + + - 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.