From patchwork Tue May 9 12:40: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: 23683 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 80F28C7EE24 for ; Tue, 9 May 2023 12:40:52 +0000 (UTC) Received: from relay8-d.mail.gandi.net (relay8-d.mail.gandi.net [217.70.183.201]) by mx.groups.io with SMTP id smtpd.web10.31182.1683636048248864451 for ; Tue, 09 May 2023 05:40:49 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=GLYPFgQa; spf=pass (domain: bootlin.com, ip: 217.70.183.201, mailfrom: michael.opdenacker@bootlin.com) Received: (Authenticated sender: michael.opdenacker@bootlin.com) by mail.gandi.net (Postfix) with ESMTPSA id 42D4D1BF20D; Tue, 9 May 2023 12:40:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1683636046; 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=g+y0XxtA7rZKdfIyzsUMM0Ltd0cqSNzWHOM2kqumN+E=; b=GLYPFgQawLIoVQE2wdnkLgPfAWy5nsUwzoVqU2cZTuqW6DCfuSFHQOXO7CcYjHhcX37U4L IrLjDVcf5Bdj/J4rnlYKZkUwBFWZfDA9ijSYBsTgi/OQlAeYj3Zzf7BtIZjp3MT2HxTjm5 iqyP+QcYokdE8tHpfEdGx7v4w+x3G7tquuXyPKb+KzKpc0W64i+l/tiZfCY+PJ9mzn0GSQ NwB/34ry+4hoE7VVJSRc/YmmmIlcXWHN3peXOQO3r/AiHWdUvVsrng5QsPoCszgtP/IsAo Z56Cx5dp7wjNqMbDeFK/YYqOmBsW3m+D9fkHw1ZF59gp4B1fP3OR/KIIKGP6ag== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH 1/4] [mickledore] migration-guides: release-notes-4.2: add doc improvement highlights Date: Tue, 9 May 2023 14:40:35 +0200 Message-Id: <20230509124038.2265185-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 ; Tue, 09 May 2023 12:40:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3924 From: Michael Opdenacker Signed-off-by: Michael Opdenacker --- documentation/dev-manual/new-recipe.rst | 2 ++ .../migration-guides/release-notes-4.2.rst | 18 ++++++++++++++++++ .../ref-manual/system-requirements.rst | 2 ++ 3 files changed, 22 insertions(+) diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst index 4e74246a4e..ab3e193aaf 100644 --- a/documentation/dev-manual/new-recipe.rst +++ b/documentation/dev-manual/new-recipe.rst @@ -1289,6 +1289,8 @@ as described in the ":ref:`dev-manual/licenses:tracking license changes`" section in the Yocto Project Overview and Concepts Manual. You can quickly create Autotool-based recipes in a manner similar to the previous example. +.. _ref-building-meson-package: + Building a Meson Package ------------------------ diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst index 473ea984c3..e13bbde1b3 100644 --- a/documentation/migration-guides/release-notes-4.2.rst +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -271,6 +271,24 @@ New Features / Enhancements in 4.2 - ``xinetd``: move ``xconv.pl`` script to separate package - ``perf``: enable debug/source packaging +- Prominent documentation updates: + + - Substantially expanded the ":doc:`/dev-manual/vulnerabilities`" section. + - Added a new ":doc:`/dev-manual/sbom`" section about SPDX SBoM generation. + - Expanded ":ref:`init-manager`" documentation. + - New section about :ref:`ref-long-term-support-releases`. + - System Requirements: details about :ref:`system-requirements-minimum-ram`. + - Details about :ref:`ref-building-meson-package` and the + :ref:`ref-classes-meson` class. + - Documentation about how to write recipes for Rust programs. See the + :ref:`ref-classes-cargo` class. + - Documentation about how to write recipes for Go programs. See the + :ref:`ref-classes-go` class. + - Variable index: added references to variables only documented in the + BitBake manual. All variables should be easy to access through the Yocto + Manual variable index. + - Expanded the description of the :term:`BB_NUMBER_THREADS` variable. + - Miscellaneous changes: - Supporting 64 bit dates on 32 bit platforms: several packages have been diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 91ed6d8d6d..d6e8b4583c 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -40,6 +40,8 @@ to run multiple builds and to cache build artifacts, improving build efficiency. If you have a shortage of disk space, see the ":doc:`/dev-manual/disk-space`" section of the Development Tasks Manual. +.. _system-requirements-minimum-ram: + Minimum System RAM ================== From patchwork Tue May 9 12:40:36 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 23682 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 80006C77B7C for ; Tue, 9 May 2023 12:40:52 +0000 (UTC) Received: from relay8-d.mail.gandi.net (relay8-d.mail.gandi.net [217.70.183.201]) by mx.groups.io with SMTP id smtpd.web11.31079.1683636051451073295 for ; Tue, 09 May 2023 05:40:51 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=Q5d4w73A; spf=pass (domain: bootlin.com, ip: 217.70.183.201, mailfrom: michael.opdenacker@bootlin.com) Received: (Authenticated sender: michael.opdenacker@bootlin.com) by mail.gandi.net (Postfix) with ESMTPSA id 62D011BF20B; Tue, 9 May 2023 12:40:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1683636049; 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=Utx1V7VLjucT8xcNJftIAAdQvwboVQ6axWbF/PvMK/A=; b=Q5d4w73AQnYEQFhavW2jerIHjKTymN9U0wwt1PYmIsNtX/5OEvwvrl1gvsB/d212a8kVUA Ex2UPBhoU3N3i395H3YnMRstJZnRXVaLE7HMGECEk4cB8JCoN6rnbBQkfGg1iZxb9TMWwz J/HyXZLYrZ8HdSFNZu8gFTjTjWhgOPURKpprw5nqM/srxf7aplfOGLb9ZMQKCmkhmCPIIS 7E0aE8aSoJfqmsZeUe0epwDE3pNFuIRsqDUnt1e2BCspdbxDVYe2Lax/iBdL/GJ66IJx9V FJD2vXmqexqMsORZ66WWMQKM4eiP7XtOHYiSMaPy5kZFIeZqYJRanAPoiDnKMw== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: Michael Opdenacker , Lee Chee Yang Subject: [PATCH 2/4] [mickledore] release-notes-4.2: update known issues and Repositories/Downloads Date: Tue, 9 May 2023 14:40:36 +0200 Message-Id: <20230509124038.2265185-2-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> References: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> 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, 09 May 2023 12:40:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3925 From: Michael Opdenacker From: Lee Chee Yang Signed-off-by: Lee Chee Yang Reviewed-by: Michael Opdenacker --- .../migration-guides/release-notes-4.2.rst | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst index e13bbde1b3..27d51a574a 100644 --- a/documentation/migration-guides/release-notes-4.2.rst +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -334,6 +334,8 @@ New Features / Enhancements in 4.2 Known Issues in 4.2 ~~~~~~~~~~~~~~~~~~~ +- N/A + Recipe License changes in 4.2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -921,3 +923,62 @@ Thanks to the following people who contributed to this release: - Zoltan Boszormenyi - 张忠山 + +Repositories / Downloads for Yocto-4.2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +poky + +- Repository Location: :yocto_git:`/poky` +- Branch: :yocto_git:`mickledore ` +- Tag: :yocto_git:`yocto-4.2 ` +- Git Revision: :yocto_git:`21790e71d55f417f27cd51fae9dd47549758d4a0 ` +- Release Artefact: poky-21790e71d55f417f27cd51fae9dd47549758d4a0 +- sha: 38606076765d912deec84e523403709ef1249122197e61454ae08818e60f83c2 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-4.2/poky-21790e71d55f417f27cd51fae9dd47549758d4a0.tar.bz2 + http://mirrors.kernel.org/yocto/yocto/yocto-4.2/poky-21790e71d55f417f27cd51fae9dd47549758d4a0.tar.bz2 + +openembedded-core + +- Repository Location: :oe_git:`/openembedded-core` +- Branch: :oe_git:`mickledore ` +- Tag: :oe_git:`yocto-4.2 ` +- Git Revision: :oe_git:`c57d1a561db563ed2f521bbac5fc12d4ac8e11a7 ` +- Release Artefact: oecore-c57d1a561db563ed2f521bbac5fc12d4ac8e11a7 +- sha: e8cdd870492017be7e7b74b8c2fb73ae6771b2d2125b2aa1f0e65d0689f96af8 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-4.2/oecore-c57d1a561db563ed2f521bbac5fc12d4ac8e11a7.tar.bz2 + http://mirrors.kernel.org/yocto/yocto/yocto-4.2/oecore-c57d1a561db563ed2f521bbac5fc12d4ac8e11a7.tar.bz2 + +meta-mingw + +- Repository Location: :yocto_git:`/meta-mingw` +- Branch: :yocto_git:`mickledore ` +- Tag: :yocto_git:`yocto-4.2 ` +- Git Revision: :yocto_git:`250617ffa524c082b848487359b9d045703d59c2 ` +- Release Artefact: meta-mingw-250617ffa524c082b848487359b9d045703d59c2 +- sha: 873a97dfd5ed6fb26e1f6a2ddc2c0c9d7a7b3c7f5018588e912294618775c323 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-4.2/meta-mingw-250617ffa524c082b848487359b9d045703d59c2.tar.bz2 + http://mirrors.kernel.org/yocto/yocto/yocto-4.2/meta-mingw-250617ffa524c082b848487359b9d045703d59c2.tar.bz2 + +bitbake + +- Repository Location: :oe_git:`/bitbake` +- Branch: :oe_git:`2.4 ` +- Tag: :oe_git:`yocto-4.2 ` +- Git Revision: :oe_git:`d97d62e2cbe4bae17f0886f3b4759e8f9ba6d38c ` +- Release Artefact: bitbake-d97d62e2cbe4bae17f0886f3b4759e8f9ba6d38c +- sha: 5edcb97cb545011226b778355bb840ebcc790552d4a885a0d83178153697ba7a +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-4.2/bitbake-d97d62e2cbe4bae17f0886f3b4759e8f9ba6d38c.tar.bz2 + http://mirrors.kernel.org/yocto/yocto/yocto-4.2/bitbake-d97d62e2cbe4bae17f0886f3b4759e8f9ba6d38c.tar.bz2 + +yocto-docs + +- Repository Location: :yocto_git:`/yocto-docs` +- Branch: :yocto_git:`mickledore ` +- Tag: :yocto_git:`yocto-4.2 ` +- Git Revision: :yocto_git:`4d6807e34adf5d92d9b6e5852736443a867c78fa ` + From patchwork Tue May 9 12:40:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 23685 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 64D10C77B7C for ; Tue, 9 May 2023 12:41:02 +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.web11.31082.1683636054411604653 for ; Tue, 09 May 2023 05:40:54 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=X7WyaAKg; 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 4CB2DFF80D; Tue, 9 May 2023 12:40:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1683636052; 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: in-reply-to:in-reply-to:references:references; bh=XQd3zjJTLqbYMoR0upt7+399Vx9DSPdeVStoAuNLV/c=; b=X7WyaAKgnxZkipu6AjFpHwPTQMQutbROh92zQW2+o7PvsxWcjv7HpZtO+YSYcA0SZay1HV XmeWaDeooWfEbTD9ZUVD9NBD5K0Mr1CliMDCbD++j8JdLErLWQKEsuOfj44xUqH/Qmvs1E UGkAlI3oOLfv93VMcbl7hRUwRwOQayIqddCwUcpw0dXnxnEywJus2Emdadbys10iqbm/UN uH5l/7murBvelUlK51uFJ2VzNxm6tJ9lxp6AVJh+2Tkr87Vey0R8Zs3cu3U4RAcMUdm/uI hAI1PPBrCUfYoCwyhMFd1ZoJhkIPshIIC4qQDnPDY9XHqppInGsrszHnQf30cg== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: Michael Opdenacker , Luca Ceresoli Subject: [PATCH 3/4] ref-manual: classes: kernel: remove incorrect sentence opening Date: Tue, 9 May 2023 14:40:37 +0200 Message-Id: <20230509124038.2265185-3-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> References: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> 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, 09 May 2023 12:41:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3926 From: Michael Opdenacker From: Luca Ceresoli "This means that" implies that this sentence is a consequence of the previous, but this is not the case, the two sentences being quite unrelated to each other. Signed-off-by: Luca Ceresoli Reviewed-by: Michael Opdenacker --- documentation/ref-manual/classes.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index a78368b380..de2d97de30 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -1532,11 +1532,11 @@ code to build all kernel trees. All needed headers are staged into the :term:`STAGING_KERNEL_DIR` directory to allow out-of-tree module builds using the :ref:`ref-classes-module` class. -This means that each built kernel module is packaged separately and -inter-module dependencies are created by parsing the ``modinfo`` output. -If all modules are required, then installing the ``kernel-modules`` -package installs all packages with modules and various other kernel -packages such as ``kernel-vmlinux``. +Each built kernel module is packaged separately and inter-module +dependencies are created by parsing the ``modinfo`` output. If all modules +are required, then installing the ``kernel-modules`` package installs all +packages with modules and various other kernel packages such as +``kernel-vmlinux``. The :ref:`ref-classes-kernel` class contains logic that allows you to embed an initial RAM filesystem (:term:`Initramfs`) image when you build the kernel image. For From patchwork Tue May 9 12:40:38 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 23684 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 650B3C7EE24 for ; Tue, 9 May 2023 12:41:02 +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.31189.1683636055741074439 for ; Tue, 09 May 2023 05:40:56 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=UthxJMYV; 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 D0C30E0009; Tue, 9 May 2023 12:40:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1683636054; 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: in-reply-to:in-reply-to:references:references; bh=wj5IdP2cEA2/sC4hsghWI6I7Fsm1yS95ZKSVyyEm8fE=; b=UthxJMYVmK8fxKy8MfjuokI3T6oS5NQlC57Kg6lADTmZ4pLXLmNLC9MnZIDpBjgkD/tdE6 IhFS6Lrr6o/47XHfwhBTUz2AXEZ/aFtfrJiCd2nY1GNvmvH/+JLIinnJOtxuiXit7aIb4Y NBADSfgf6/U6O6Ryf4VU0rkjW2Td06A9OfrRZcJGSJc4zvKAhbWHiujMnD/cykj9lFRhuB N+vNp6Ho/hd0v4zOQuV1pCFtnWH44w98M4pAdyQbXn9uvMUyIeP9aGAG6fhfv9QRbvBlmi DyliijJuRkZdpnG8KfAfqL0HxbAmDvdnj6/1sdT3YN9ZRGNEbq2iwehUWLHyGg== From: michael.opdenacker@bootlin.com To: docs@lists.yoctoproject.org Cc: Michael Opdenacker , Luca Ceresoli Subject: [PATCH 4/4] ref-manual: classes: kernel: document automatic defconfig usage Date: Tue, 9 May 2023 14:40:38 +0200 Message-Id: <20230509124038.2265185-4-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> References: <20230509124038.2265185-1-michael.opdenacker@bootlin.com> 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, 09 May 2023 12:41:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3927 From: Michael Opdenacker From: Luca Ceresoli Since a very long time the kernel bbclass uses a defconfig file from SRC_URI automatically. Document this feature. Signed-off-by: Luca Ceresoli Reviewed-by: Michael Opdenacker --- documentation/ref-manual/classes.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index de2d97de30..8f7cbf2b45 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -1532,6 +1532,13 @@ code to build all kernel trees. All needed headers are staged into the :term:`STAGING_KERNEL_DIR` directory to allow out-of-tree module builds using the :ref:`ref-classes-module` class. +If a file named ``defconfig`` is listed in :term:`SRC_URI`, then by default +:ref:`ref-tasks-configure` copies it as ``.config`` in the build directory, +so it is automatically used as the kernel configuration for the build. This +copy is not performed in case ``.config`` already exists there: this allows +recipes to produce a configuration by other means in +``do_configure:prepend``. + Each built kernel module is packaged separately and inter-module dependencies are created by parsing the ``modinfo`` output. If all modules are required, then installing the ``kernel-modules`` package installs all