From patchwork Wed Dec 24 16:31:27 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77437 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 0EEA2E776CA for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123182.1766593908755359232 for ; Wed, 24 Dec 2025 08:31:49 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=NTHug5SB; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 424631A23E1 for ; Wed, 24 Dec 2025 16:31:47 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1990B6073D for ; Wed, 24 Dec 2025 16:31:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7961B10AB136F; Wed, 24 Dec 2025 17:31:46 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593906; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=2b60xFxDmvEZjUxiZOq+wco1w6UC5M1sfNQpMXeTWqc=; b=NTHug5SBSvlixwNci8O1qUpQOIJJyqJeRclx1o4I/Nshdh3oN2+zD11NeWqayTGjqUjrh7 +RcaeEreUof2LClp6eQ+IzPe2F0gxP3fowAGbPUWIlqE234nwv+011XYjwUCIoK7HWcY+L dp3kO/ORQBUoR8Ub98lxu7caCzfidw/IdKXBqZE1rirHePEVOwTw8YyaMfKB8rXE1KYr2M SHg4iU5mioOhG9KMyYSWzJCYJmtBavDkRz03ehQcAdaLm3kNP5+Gr7Fnz8k4cA2vsmU1Qy glFqKDKq53SJbwV44NMSHR2J7UH5TCEzKRR0xyhVA91Ok1cs6t84Jci21NJAaQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:27 +0100 Subject: [PATCH 01/53] transitioning-to-a-custom-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-1-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3345; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0lTEteHjsuziwK771asb+iE7y9lsxO1uNIROFhsaphM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVmFCTzPipI9vGdpzc3/8ScAGXlPzgUAMpnz ch3kz8owACJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZgAKCRDRgEFAKaOo Nqr1D/9fAopE7N2agcI0u8J5TnedR3vNZCNN8UjtbX9C9iuy3Ta4zw5mXKppOLRApA7sAX776h9 C/qVYrVzWR/xGLM6MhDzW5RGFRG7mYobG+U/I1BpasgETdY2pKDt6R/ogR29P1byed1adQ2O9oY 0HZVbBbjJQv44NUYhxa1aab6YUDeJeJ/k5ft/UHi/2B24TQJ1FmWOg+u7tAqVj9iRFTX625qf8K 2Ge0apwEbvIBeDqtnEj1IdfPXU9kxpBCbITcDobY/dSIMuMWQF/dmHFF/ZcKGxYwfqdi0EljHrz e8MgtjGYTD0tTOxz4FRJZ70/0NEfyUCIHU3lS3w90/vDpJlah9e5YT2ENO9wSUGj5QPZRil3V7g kl1XwiXeNGLgiewc9KBWTG1upIpJqdKpFz+7wkdKiIx/vF9VzdC2u9eqQ5ehy7fysyUEd2xATug jDThwFHUww6kLycvK/dr14NC6vlqFEtG3d3gwmX5Ng/NwYH7XD4+U21xoxe2ymoJFYkegpk9v3t GPBhNHbEE3Uo52hUc3iBDxmr6jJsof+i5XbIrzjDClDUDRB8WltJu0Ezmmy3c8zJqGZhWQ6Ag5U VsiDPLbjh/RZrH+qKoV8nuL1u3+5U++/JIYAICOpgs4a/gy3u8vpze/I3bZa2/apD2FIsbQRngs A5GI/ptWR5WHgJg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8330 - Use :term: for Poky. - Mention use of fragments instead of local.conf. - Remove Yocto < 2.4 reference. Signed-off-by: Antonin Godard --- .../transitioning-to-a-custom-environment.rst | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/documentation/transitioning-to-a-custom-environment.rst b/documentation/transitioning-to-a-custom-environment.rst index a5f55c567..e292399f4 100644 --- a/documentation/transitioning-to-a-custom-environment.rst +++ b/documentation/transitioning-to-a-custom-environment.rst @@ -39,7 +39,7 @@ Transitioning to a custom environment for systems development that you've downloaded. Be aware that some BSPs may not be immediately supported on the very latest release, but they will be eventually. - You might want to start with the build specification that Poky provides + You might want to start with the build specification that :term:`Poky` provides (which is reference embedded distribution) and then add your newly chosen layers to that. Here is the information :ref:`about adding layers `. @@ -48,16 +48,14 @@ Transitioning to a custom environment for systems development configuration**. For instance, you've chosen a machine type and added in the corresponding BSP layer. You'll then need to change the value of the :term:`MACHINE` variable in your - configuration file (build/local.conf) to point to that same machine - type. There could be other layer-specific settings you need to change as - well. Each layer has a ``README`` document that you can look at for this type of - usage information. + configuration (using the :ref:`ref-fragments-builtin-core-machine` + fragment) to point to that same machine type. There could be other + layer-specific settings you need to change as well. Each layer has a + ``README`` document that you can look at for this type of usage information. #. **Add a new layer for any custom recipes and metadata you create**. - Use the ``bitbake-layers create-layer`` tool for Yocto Project 2.4+ - releases. If you are using a Yocto Project release earlier than 2.4, use the - ``yocto-layer create`` tool. The ``bitbake-layers`` tool also provides a number - of other useful layer-related commands. See + Use the ``bitbake-layers create-layer`` command. The ``bitbake-layers`` tool + also provides a number of other useful layer-related commands. See :ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script` section. @@ -99,7 +97,7 @@ Transitioning to a custom environment for systems development Distribution settings define the packaging back-end (e.g. rpm or other) as well as the package feed and possibly the update solution. You would create - your own distribution in a new layer inheriting from Poky but overriding what + your own distribution in a new layer inheriting from :term:`Poky` but overriding what needs to change for your distribution. If you find yourself adding a lot of configuration to your local.conf file aside from paths and other typical local settings, it's time to :ref:`consider creating your own distribution From patchwork Wed Dec 24 16:31:28 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77442 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 38E3BE776D3 for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123712.1766593909678392747 for ; Wed, 24 Dec 2025 08:31:50 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=P1wium6R; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 28C6B1A23E2 for ; Wed, 24 Dec 2025 16:31:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id EF5C86073D for ; Wed, 24 Dec 2025 16:31:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1C54B10AB1370; Wed, 24 Dec 2025 17:31:47 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593907; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=K86dXRs8K8sARIroAaX0fKcloVRRAgTRLekLdFI1Ag4=; b=P1wium6Ra8yWAChQe/xGsBwVGVH5km9f41GjySwa9dbxMk7CoSLagpwmqw25YeBqitQACl mfcP9DOi07P7a87pnJg75JLI14/bmoXQV90BU51fW5ubrbw62VwUr+XNndvnOuFXXfmfno vBOvX3zhW/9MIZjxxmF/5lP49SqFEeUgnc01DI6j2zuGXS8pZNlchqtRee9NbXuRmdEjGw 3F+Cujlpi2GQAw5g8Jox/6U0UqN6BzaMlzv+KnbexxdZJZ8sjxzc5M/ab5LMy0vdLawJpU IWYbzHthUaahXaA59oJKpJT8BdRSKVC2gnY8H7X0er+dlx622ELBA7OlhokzKA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:28 +0100 Subject: [PATCH 02/53] dev-manual/start.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-2-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=26547; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=7Ov6GtJH1DeC9rmG84ZTyXRwOzUWxyIOQUjdsApZEAE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVmwt2/ci9u3HOTIQ+zOR05V1Yo+uzPxoQF1 lOokXbBmJWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZgAKCRDRgEFAKaOo Nn7mEACwtqMiB6kyLqpnaQVbu1vfUCgu0i0gJpkBuZ/vAJU9y7q2+pjR9Pc6g7l7N+dqq9c7NDr r3Np8mDTA+vLMIa215WhVXENeou/G7V4/WntgZ8YDmVp7cSkNwa6dVNcJ4sQH3BzZKhKrSlvC8R m9TxqWva4szfMpBhH1CUUsrlp705VkibTI8/f1bZF8RLcuK6KW03AX6rUSqL+uC0Akivw49iz9N P6NzWFcrYgegfqxV5rikVB72786r3pa9dPZLqqZw2/CRjrpLcQ8W7SdjMOHKS3I2ODVi9yZboOE qDPIajEB1r/WIQ2/2/HvNUzI6XpIblZ/t4DHgQktElm0NRbGaBVflMborH2dmRbVP82oPhooAFh CCiTtKQTvwzIXuVwx4dsi1U01FOOKyTWuOd+N7rUsQpyU6PxdQqFHhZcsM2SsXSXeiw6PSCPwuC vOfnBjH2IzJ/9kwwzHzlVZuQZstx9lCvhb/1+aCzbBtdGX/TJl06tLM9Bt+BmDacyXB3zka2miR ezKm8xf48n4vocf+pH+MxiXY8DhPxqwdcu4nfsc4EIMnJ8n7/02fwFaUclW4t0X5iZ3KrgyVRjC j/y1IwLv78RbLIf3JkrxFIsjSeoReB4zUb7l+MbxnutYcahXrvcsxwF353sNmp/Nu8HWDyH0rYl mquDrQ7BhSw2hhw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8331 The Poky repository has stopped being updated in favor of bitbake-setup or manual clones of the required repositories. Simplify the document by making references to these guides as well as removing sections that are covered in the references documents. Keep a "Initializing the Build Environment" as this task is common and referenced in different places in the documentation. Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 5 +- documentation/dev-manual/start.rst | 324 +++------------------ documentation/kernel-dev/common.rst | 36 +-- .../overview-manual/development-environment.rst | 21 +- documentation/ref-manual/structure.rst | 5 - documentation/sdk-manual/appendix-obtain.rst | 25 +- 6 files changed, 48 insertions(+), 368 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index a6444d9af..74912cdd6 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -204,10 +204,7 @@ section. .. note:: To see the available branch names in a cloned repository, use the ``git - branch -a`` command. See the - ":ref:`dev-manual/start:checking out by branch in poky`" - section in the Yocto Project Development Tasks Manual for more - information. + branch -a`` command. #. *Optionally Set Up an Alternative BSP Layer:* If your hardware can be more closely leveraged to an existing BSP not within the diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index b21cd4f0f..ca6753c94 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst @@ -76,7 +76,7 @@ particular working environment and set of practices. :term:`Metadata` (i.e. recipes, configuration files, classes, and so forth) and any software you are developing under the control of an SCM system that is compatible - with the OpenEmbedded build system is advisable. Of all of the SCMs + with the :term:`OpenEmbedded build system` is advisable. Of all of the SCMs supported by BitBake, the Yocto Project team strongly recommends using :ref:`overview-manual/development-environment:git`. Git is a distributed system @@ -218,7 +218,7 @@ particular working environment and set of practices. repositories. See the ":ref:`overview-manual/development-environment:yocto project source repositories`" section in the Yocto Project Overview and Concepts Manual for information on these repositories. See the - ":ref:`dev-manual/start:locating yocto project source files`" + ":doc:`/dev-manual/poky-manual-setup`" section for information on how to set up local Git repositories for related upstream Yocto Project Git repositories. @@ -338,7 +338,7 @@ Project Build Host: Once you have completed the previous steps, you are ready to continue using a given development path on your native Linux machine. If you are going to use BitBake, see the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" +":ref:`dev-manual/start:preparing the poky reference distro`" section. If you are going to use the Extensible SDK, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto Project Application Development and the Extensible Software Development @@ -433,7 +433,7 @@ as your Yocto Project build host: Once you have a container set up, everything is in place to develop just as if you were running on a native Linux machine. If you are going to use the Poky container, see the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" +":ref:`dev-manual/start:preparing the Poky reference distro`" section. If you are going to use the Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto Project Application Development and the Extensible Software Development @@ -576,302 +576,60 @@ the `Yocto Project BitBake `__ extension accordingly. -Locating Yocto Project Source Files -=================================== +Preparing the Poky Reference Distro +----------------------------------- -This section shows you how to locate, fetch, unpack, patch and configure the source -files you'll need to work with the Yocto Project. +Now that the :term:`Build Host` has been prepared to build images, the next step +can be to build the :term:`Poky` reference distro. There are two ways of setting +up the :term:`Poky` reference distro: -.. note:: - - - For concepts and introductory information about Git as it is used - in the Yocto Project, see the ":ref:`overview-manual/development-environment:git`" - section in the Yocto Project Overview and Concepts Manual. - - - For concepts on Yocto Project source repositories, see the - ":ref:`overview-manual/development-environment:yocto project source repositories`" - section in the Yocto Project Overview and Concepts Manual." - -Accessing Source Repositories ------------------------------ - -Working from a copy of the upstream :ref:`dev-manual/start:accessing source repositories` is the -preferred method for obtaining and using a Yocto Project release. You -can view the Yocto Project Source Repositories at -:yocto_git:`/`. In particular, you can find the ``poky`` -repository at :yocto_git:`/poky`. - -Use the following procedure to locate the latest upstream copy of the -``poky`` Git repository: - -#. *Access Repositories:* Open a browser and go to - :yocto_git:`/` to access the GUI-based interface into the - Yocto Project source repositories. +- Using the ``bitbake-setup`` command-line utility from :term:`BitBake`. + Follow: -#. *Select the Repository:* Click on the repository in which you are - interested (e.g. ``poky``). + :doc:`Setting Up The Environment With bitbake-setup ` -#. *Find the URL Used to Clone the Repository:* At the bottom of the - page, note the URL used to clone that repository - (e.g. :yocto_git:`/poky`). +- Manually cloning the required repositories. Follow: - .. note:: + :doc:`/dev-manual/poky-manual-setup` - For information on cloning a repository, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" section. +.. note:: -Accessing Source Archives -------------------------- + The :term:`Poky` distro is only a point that can be used to try the Yocto + Project. It should not be used in production environments! Instead, it is + recommended to create your own distro, see the + :doc:`/dev-manual/custom-distribution` section of the Yocto Project + Development Tasks Manual. -The Yocto Project also provides source archives of its releases, which -are available on :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory -containing the release you wish to use, for example -:yocto_dl:`&DISTRO_REL_LATEST_TAG; `. +Initializing the Build Environment +---------------------------------- -You will find there source archives of individual components (if you wish -to use them individually), and of the corresponding Poky release bundling -a selection of these components. +Initializing the build environment is a common task, as it needs to be done for +each new instance of the shell where the :term:`Poky` reference was set up: -.. note:: +- If ``bitbake-setup`` was used to setup the :term:`Poky` reference distro, you + need to source the ``init-build-env`` file of the :term:`bitbake:Setup` + directory that was created after the :ref:`bitbake:ref-bbsetup-command-init` + command execution: - The recommended method for accessing Yocto Project components is to - use Git to clone the upstream repository and work from within that - locally cloned repository. - -Using the Downloads Page ------------------------- - -The :yocto_home:`Yocto Project Website <>` uses a "RELEASES" page -from which you can locate and download tarballs of any Yocto Project -release. Rather than Git repositories, these files represent snapshot -tarballs similar to the tarballs located in the Index of Releases -described in the ":ref:`dev-manual/start:accessing source archives`" section. - -#. *Go to the Yocto Project Website:* Open The - :yocto_home:`Yocto Project Website <>` in your browser. - -#. *Get to the Downloads Area:* Select the "RELEASES" item from the - pull-down "DEVELOPMENT" tab menu near the top of the page. - -#. *Select a Yocto Project Release:* On the top of the "RELEASES" page, currently - supported releases are displayed; further down, past supported Yocto Project - releases are visible. The "Download" links in the rows of the table there - will lead to the download tarballs for the release. - - .. note:: - - For a "map" of Yocto Project releases to version numbers, see the - :yocto_home:`Releases ` page. - - You can use the "RELEASE ARCHIVE" link to reveal a menu of all Yocto - Project releases. - -#. *Download Tools or Board Support Packages (BSPs):* Next to the tarballs you - will find download tools or BSPs as well. Just select a Yocto Project - release and look for what you need. - -Cloning and Checking Out Branches -================================= - -To use the Yocto Project for development, you need a release locally -installed on your development system. This locally installed set of -files is referred to as the :term:`Source Directory` -in the Yocto Project documentation. - -The preferred method of creating your Source Directory is by using -:ref:`overview-manual/development-environment:git` to clone a local copy of the upstream -``poky`` repository. Working from a cloned copy of the upstream -repository allows you to contribute back into the Yocto Project or to -simply work with the latest software on a development branch. Because -Git maintains and creates an upstream repository with a complete history -of changes and you are working with a local clone of that repository, -you have access to all the Yocto Project development branches and tag -names used in the upstream repository. - -Cloning the ``poky`` Repository -------------------------------- - -Follow these steps to create a local version of the upstream -:term:`Poky` Git repository. - -#. *Set Your Directory:* Change your working directory to where you want - to create your local copy of ``poky``. - -#. *Clone the Repository:* The following example command clones the - ``poky`` repository and uses the default name "poky" for your local - repository:: - - $ git clone git://git.yoctoproject.org/poky - Cloning into 'poky'... - remote: Counting objects: 432160, done. - remote: Compressing objects: 100% (102056/102056), done. - remote: Total 432160 (delta 323116), reused 432037 (delta 323000) - Receiving objects: 100% (432160/432160), 153.81 MiB | 8.54 MiB/s, done. - Resolving deltas: 100% (323116/323116), done. - Checking connectivity... done. - - Unless you - specify a specific development branch or tag name, Git clones the - "master" branch, which results in a snapshot of the latest - development changes for "master". For information on how to check out - a specific development branch or on how to check out a local branch - based on a tag name, see the - ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" sections, respectively. - - Once the local repository is created, you can change to that - directory and check its status. The ``master`` branch is checked out - by default:: - - $ cd poky - $ git status - On branch master - Your branch is up-to-date with 'origin/master'. - nothing to commit, working directory clean - $ git branch - * master - - Your local repository of poky is initially identical to the - upstream poky repository from which it was cloned. As you - work with the local branch, you can periodically use the - ``git pull`` command to be sure you stay up-to-date - with the upstream poky branch. - -Checking Out by Branch in Poky ------------------------------- + .. code-block:: console -When you clone the upstream poky repository, you have access to all its -development branches. Each development branch in a repository is unique -as it forks off the "master" branch. To see and use the files of a -particular development branch locally, you need to know the branch name -and then specifically check out that development branch. + $ source /build/init-build-env -.. note:: - Checking out an active development branch by branch name gives you a - snapshot of that particular branch at the time you check it out. - Further development on top of the branch that occurs after check it - out can occur. - -#. *Switch to the Poky Directory:* If you have a local poky Git - repository, switch to that directory. If you do not have the local - copy of poky, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" - section. - -#. *Determine Existing Branch Names:* - :: - - $ git branch -a - * master - remotes/origin/1.1_M1 - remotes/origin/1.1_M2 - remotes/origin/1.1_M3 - remotes/origin/1.1_M4 - remotes/origin/1.2_M1 - remotes/origin/1.2_M2 - remotes/origin/1.2_M3 - . . . - remotes/origin/thud - remotes/origin/thud-next - remotes/origin/warrior - remotes/origin/warrior-next - remotes/origin/zeus - remotes/origin/zeus-next - ... and so on ... - -#. *Check out the Branch:* Check out the development branch in which you - want to work. For example, to access the files for the Yocto Project - &DISTRO; Release (&DISTRO_NAME;), use the following command:: - - $ git checkout -b &DISTRO_NAME_NO_CAP; origin/&DISTRO_NAME_NO_CAP; - Branch &DISTRO_NAME_NO_CAP; set up to track remote branch &DISTRO_NAME_NO_CAP; from origin. - Switched to a new branch '&DISTRO_NAME_NO_CAP;' - - The previous command checks out the "&DISTRO_NAME_NO_CAP;" development - branch and reports that the branch is tracking the upstream - "origin/&DISTRO_NAME_NO_CAP;" branch. - - The following command displays the branches that are now part of your - local poky repository. The asterisk character indicates the branch - that is currently checked out for work:: - - $ git branch - master - * &DISTRO_NAME_NO_CAP; - -Checking Out by Tag in Poky ---------------------------- - -Similar to branches, the upstream repository uses tags to mark specific -commits associated with significant points in a development branch (i.e. -a release point or stage of a release). You might want to set up a local -branch based on one of those points in the repository. The process is -similar to checking out by branch name except you use tag names. +- If the :term:`Poky` distro was setup using manual clones of the layers, you + need to source the ``oe-init-build-env`` script present in the + :term:`OpenEmbedded-Core (OE-Core)` layer: -.. note:: + .. code-block:: console - Checking out a branch based on a tag gives you a stable set of files - not affected by development on the branch above the tag. - -#. *Switch to the Poky Directory:* If you have a local poky Git - repository, switch to that directory. If you do not have the local - copy of poky, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" - section. - -#. *Fetch the Tag Names:* To checkout the branch based on a tag name, - you need to fetch the upstream tags into your local repository:: - - $ git fetch --tags - $ - -#. *List the Tag Names:* You can list the tag names now:: - - $ git tag - 1.1_M1.final - 1.1_M1.rc1 - 1.1_M1.rc2 - 1.1_M2.final - 1.1_M2.rc1 - . - . - . - yocto-2.5 - yocto-2.5.1 - yocto-2.5.2 - yocto-2.5.3 - yocto-2.6 - yocto-2.6.1 - yocto-2.6.2 - yocto-2.7 - yocto_1.5_M5.rc8 - - -#. *Check out the Branch:* - :: - - $ git checkout tags/yocto-&DISTRO; -b my_yocto_&DISTRO; - Switched to a new branch 'my_yocto_&DISTRO;' - $ git branch - master - * my_yocto_&DISTRO; - - The previous command creates and - checks out a local branch named "my_yocto_&DISTRO;", which is based on - the commit in the upstream poky repository that has the same tag. In - this example, the files you have available locally as a result of the - ``checkout`` command are a snapshot of the "&DISTRO_NAME_NO_CAP;" - development branch at the point where Yocto Project &DISTRO; was - released. + $ source openembedded-core/oe-init-build-env -Initializing the Build Environment -================================== +This will setup you current shell and change its current working directory to +the :term:`Build Directory`. -Before you can use Yocto you need to setup the build environment. -From within the ``poky`` directory, source the :ref:`ref-manual/structure:``oe-init-build-env``` environment -setup script to define Yocto Project's build environment on your build host:: +Where To Go From There +---------------------- - $ source oe-init-build-env +- Configure your build: follow :ref:`overview-manual/concepts:User Configuration`. -Note, that this step will have to be repeated every time you open a new shell. +- Learn how and what to build with :term:`BitBake`: follow :doc:`/dev-manual/building`. diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index c0df39e39..1e098c158 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -22,21 +22,13 @@ Preparing the Build Host to Work on the Kernel Before you can do any kernel development, you need to be sure your build host is set up to use the Yocto Project. For information on how to get set up, see the ":doc:`/dev-manual/start`" section in -the Yocto Project Development Tasks Manual. Part of preparing the system -is creating a local Git repository of the -:term:`Source Directory` (``poky``) on your system. Follow the steps in the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" -section in the Yocto Project Development Tasks Manual to set up your -Source Directory. +the Yocto Project Development Tasks Manual. .. note:: Be sure you check out the appropriate development branch or you create your local branch by checking out a specific tag to get the - desired version of Yocto Project. See the - ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" - sections in the Yocto Project Development Tasks Manual for more information. + desired version of Yocto Project. Kernel development is best accomplished using :ref:`devtool ` @@ -158,28 +150,8 @@ this procedure leaves you ready to make modifications to the kernel source as described in the ":ref:`kernel-dev/common:using traditional kernel development to patch the kernel`" section: -#. *Initialize the BitBake Environment:* Before you can do anything - using BitBake, you need to initialize the BitBake build environment - by sourcing the build environment script (i.e. - :ref:`structure-core-script`). - Also, for this example, be sure that the local branch you have - checked out for ``poky`` is the Yocto Project &DISTRO_NAME; branch. If - you need to checkout out the &DISTRO_NAME; branch, see the - ":ref:`dev-manual/start:checking out by branch in poky`" - section in the Yocto Project Development Tasks Manual:: - - $ cd poky - $ git branch - master - * &DISTRO_NAME_NO_CAP; - $ source oe-init-build-env - - .. note:: - - The previous commands assume the - :ref:`overview-manual/development-environment:yocto project source repositories` - (i.e. ``poky``) have been cloned using Git and the local repository is named - "poky". +#. *Initialize the BitBake Environment:* Follow the steps in the + :doc:`/dev-manual/start` section of the Yocto Project Development Tasks Manual. #. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable is set to "qemux86-64", which is fine if you are building for the QEMU emulator diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index 066d78431..ab9bd084c 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -184,15 +184,6 @@ development: .. image:: figures/source-repos.png :width: 100% - For steps on how to view and access these upstream Git repositories, - see the ":ref:`dev-manual/start:accessing source repositories`" - Section in the Yocto Project Development Tasks Manual. - -- :yocto_dl:`Yocto release archives: ` This is where you can - download tarballs corresponding to each Yocto Project release. Downloading - and extracting these files does not produce a local copy of a Git repository - but rather a snapshot corresponding to a particular release. - - :yocto_home:`DOWNLOADS page `: The :yocto_home:`Yocto Project website <>` includes a "DOWNLOADS" page accessible through the "SOFTWARE" menu that allows you to download any Yocto @@ -203,10 +194,6 @@ development: .. image:: figures/yp-download.png :width: 100% - For steps on how to use the "DOWNLOADS" page, see the - ":ref:`dev-manual/start:using the downloads page`" - section in the Yocto Project Development Tasks Manual. - Git Workflows and the Yocto Project =================================== @@ -372,10 +359,6 @@ commands. Ubuntu, use the Ubuntu Software feature). For the Git download page, see https://git-scm.com/download. - - For information beyond the introductory nature in this section, - see the ":ref:`dev-manual/start:locating yocto project source files`" - section in the Yocto Project Development Tasks Manual. - Repositories, Tags, and Branches -------------------------------- @@ -403,9 +386,7 @@ You can create a local copy of any repository by "cloning" it with the ``git clone`` command. When you clone a Git repository, you end up with an identical copy of the repository on your development system. Once you have a local copy of a repository, you can take steps to develop -locally. For examples on how to clone Git repositories, see the -":ref:`dev-manual/start:locating yocto project source files`" -section in the Yocto Project Development Tasks Manual. +locally. It is important to understand that Git tracks content change and not files. Git uses "branches" to organize different development efforts. diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index c0eae9b7b..d567cade0 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -10,11 +10,6 @@ contents is key to using the Yocto Project effectively. This chapter describes the Source Directory and gives information about those files and directories. -For information on how to establish a local Source Directory on your -development system, see the -":ref:`dev-manual/start:locating yocto project source files`" -section in the Yocto Project Development Tasks Manual. - .. note:: The OpenEmbedded build system does not support file or directory diff --git a/documentation/sdk-manual/appendix-obtain.rst b/documentation/sdk-manual/appendix-obtain.rst index a42cbc31b..33787a225 100644 --- a/documentation/sdk-manual/appendix-obtain.rst +++ b/documentation/sdk-manual/appendix-obtain.rst @@ -85,34 +85,11 @@ As an alternative to locating and downloading an SDK installer, you can build the SDK installer. Follow these steps: #. *Set Up the Build Environment:* Be sure you are set up to use BitBake - in a shell. See the ":ref:`dev-manual/start:preparing the build host`" section + in a shell. See the ":doc:`/dev-manual/start`" section in the Yocto Project Development Tasks Manual for information on how to get a build host ready that is either a native Linux machine or a machine that uses CROPS. -#. *Clone the ``poky`` Repository:* You need to have a local copy of the - Yocto Project :term:`Source Directory` - (i.e. a local - ``poky`` repository). See the ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and - possibly the ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" sections - all in the Yocto Project Development Tasks Manual for information on - how to clone the ``poky`` repository and check out the appropriate - branch for your work. - -#. *Initialize the Build Environment:* While in the root directory of - the Source Directory (i.e. ``poky``), run the - :ref:`structure-core-script` environment - setup script to define the OpenEmbedded build environment on your - build host:: - - $ source oe-init-build-env - - Among other things, the script creates the :term:`Build Directory`, which - is ``build`` in this case and is located in the Source Directory. After - the script runs, your current working directory is set to the ``build`` - directory. - #. *Make Sure You Are Building an Installer for the Correct Machine:* Check to be sure that your :term:`MACHINE` variable in the ``local.conf`` file in your :term:`Build Directory` matches the architecture From patchwork Wed Dec 24 16:31:29 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77440 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 38EADE776D4 for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123713.1766593910450713533 for ; Wed, 24 Dec 2025 08:31:50 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=wh8Z0nHe; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id E99A11A23E4 for ; Wed, 24 Dec 2025 16:31:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BF82D6073D for ; Wed, 24 Dec 2025 16:31:48 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E436910AB1371; Wed, 24 Dec 2025 17:31:47 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593908; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=iPGQVNDjVAySEcJxQ7DkLx7wEZuzw6P1Zfxd9RYwhXs=; b=wh8Z0nHewiu6CJIEdqBfJnOjAaZy9lu1zmp7aKDFFus/xVlWItKllQUKIQBzAV6snAWxvJ LE2ShBYCGP5XklGBoXxfzLolXUNvp7ZA4Gq3QIpDOchQlx3ngxqLoNjEll54jeNufqlrfy QsIZrzzEmwj6tlXIr2t6cZDr8v0fTg/KGcg43Epq/bLVgo3sRu+qL4Vu4vc1oeHqzyceYO e0TKeUAJn+/Ji9u7XapHoWaKtj8rsyYjMJ7lOkxTE16eUne8Ofcw9kEryz615wHkEegl0H i+DJSq/JW7gtPDV55AEzQw2LrbNvq97PldxioYLfaOrCI/Ai4no+b+ao3BlIiQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:29 +0100 Subject: [PATCH 03/53] dev-manual/poky-manual-setup.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-3-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2513; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=NaBf5yNyEwypvQ/CtYyRaWs8vEWPzn7RFW9zoolx3mo=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVm0vsNL6yg/8EeEany6QSpVF1p6zBonAuO0 GcmzPB5OpKJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZgAKCRDRgEFAKaOo NqNbD/9cr3LBRJG9PPahSQTTQ6xEfIc+SFNO8ZqYxbYD18/TljvAEiskppoRR02UHJpHkppx7yW 0JjsJJlusl2q9T1cC9I2/vdrzbPZc+9/qlFVKktX3n86db3/maf3bHM8DHIm8TciRQA3iSJW5I3 Angd/64jjen7OjZ9UtAHg0KOFHFsHv2gVhCmr22hyV0jWXlgNMRIh37Sow/l27WQDXgjbb0nLtQ GIIEkDT4yeEQdKJbKdg6hmKSxEHeZH54Fvj2wOo6h3D1uwUrVWycd1HrcfVC0broELPB6PPxeRN pOCz7vmzIKLOPyOdvWJVThJjX9QItQBRC1OHx0F0q9euGYIMEps1to0OU1eogpBQfrJQqhJZt74 t6S/QjlYAsxUBThUt8++rear3IE9Dw3qVzEZ5QzGz7uLc92VL5PSmiO/iXFY+dhP1WnWloYteuJ G8FOHyRIpcQOfREAa+0acYMo+b9gDhG7W65uLnvVIGsObwBfV4FJV1KLqeV7xJiH1x7et+RucHa s4VqqyaSv7ZkalFwvcliXjFQ0JYd813muPdjY4rQEVSBbuchgFaPRJ5gwTn7CEIhT31OKvxHna8 uaCFPRQWcf4PD1XsloLJxlveOODJ3RifyUJD69bXopsc5jxWwiFXT1gVrVkJKWxLjxyVKw0lDNZ gfzuOth3kaQ45aw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8332 The commit "dev-manual/start.rst: simplify the document after poky obsolescence" removed some of the information related to source archives published on downloads.yoctoproject.org. Mention it in this document as it makes sense to use those when manually setting up a Poky build. Signed-off-by: Antonin Godard --- documentation/dev-manual/poky-manual-setup.rst | 28 +++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/documentation/dev-manual/poky-manual-setup.rst b/documentation/dev-manual/poky-manual-setup.rst index 7ee084007..c4e36ce8b 100644 --- a/documentation/dev-manual/poky-manual-setup.rst +++ b/documentation/dev-manual/poky-manual-setup.rst @@ -13,8 +13,15 @@ document guides through this setup step-by-step. :doc:`/brief-yoctoprojectqs/index`, which shows how to setup :term:`Poky` with ``bitbake-setup``. +Obtaining The Source Repositories +================================= + +You can obtain the source repositories required to build the Poky reference +distro in two ways described below: cloning the repositories with Git, or +downloading the released archives. + Use Git to Clone The Layers -=========================== +--------------------------- Go to the :yocto_home:`Releases ` page, and choose a release (such as ``&DISTRO_REL_LATEST_TAG;``), corresponding to either the latest stable @@ -41,6 +48,25 @@ following commands: $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.openembedded.org/openembedded-core ./layers/openembedded-core $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.yoctoproject.org/meta-yocto ./layers/meta-yocto + +Using the Source Archives +------------------------- + +The Yocto Project also provides source archives of its releases, which +are available on :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory +containing the release you wish to use, for example +:yocto_dl:`&DISTRO_REL_LATEST_TAG; `. + +You will find there source archives of individual components (if you wish +to use them individually), and of the corresponding Poky release bundling +a selection of these components. + +.. note:: + + The recommended method for accessing Yocto Project components is to + use Git to clone the upstream repository and work from within that + locally cloned repository. + Building Your Image =================== From patchwork Wed Dec 24 16:31:30 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77441 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 1FE25E776CD for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123714.1766593910998522691 for ; Wed, 24 Dec 2025 08:31:51 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=RPIKem//; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 72A681A23E5 for ; Wed, 24 Dec 2025 16:31:49 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 4B53C6073D for ; Wed, 24 Dec 2025 16:31:49 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9C14210AB1372; Wed, 24 Dec 2025 17:31:48 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593908; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=oVzwD24nQIYcTZX+ZTDvX860/qvI6V8KV9R5vMcJunA=; b=RPIKem//kgU53hvRdhPmzFJYl1ZIZf9BHX8HSxtJIv/Io+Pq1Tf4ZlDva19l/HqtK/TGvH vWXOwRdRvcikLbozyK2D0imbcYrKkJ9RAkTETqNnAjWZ9NEV4lD/kH6xyEH/YL3n5cUiAD r3F0vyjUivWLUcia9kQwd2My7z6zuV1HT6v7/EVoLpq19kQKxJPMwC4nbfqkyF8h6h7ZgD qQkLh3trGKc5FuHptKqRgnEZSQ6uVKhTbKRKv/GLPWm1mtcl0U79hXr5EsP+Ap/csS2+ez F65lGOPu2rPitpB7j/PJiFNBzlgrvbJwf5WA+liH8LW/T76+hMrmxmDWHR+80Q== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:30 +0100 Subject: [PATCH 04/53] bsp-guide/bsp.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-4-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=14316; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=HyX01m2+x4+F6v9083Y9/sRtW4JuA4RoQ3eLUZlOKio=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVn79F4mOXUw8mzsJBNFzN6wX97adwPhcJ2I JsOW8LhH9CJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZwAKCRDRgEFAKaOo Nhv3D/wKgmdS+7JyNR/MN5Bo2t29DLJ3W54/diPbQ+dmQtXMTqz6rsrxGp8q9xDKtG04uUGuLWX YcswK+UEDZADIkx18Oy9XQdGVPPkO2UNTwK0xuXxCiIzdq3ZL4TqGe6uWms5vg4k2NDYlN3Wtb6 Z5MCMRktWCIdKS1rJfZ/YSYeLVbF1WX6Vsm8FtNlniHWCYYUPhRwcp70c3IDyia5JGOdmjmtfdi AY7LC+A3kP5TRUr69hoMOfqYKHLBLbK1wMYaPtAS4HO4V5MKWe9i4ki8hm0ZJpNwWa5nNCd6i5m cVaS6xjUOZLyc2BlxqUQ0NmVGwHJRJfi5cWcVVAWsWdmuHODwxDq79byAoXA6iY8ghxJHS0ukc/ 6fEJelqR8aZ3NrXa0bTYnU/ZslsEezzZzFsZ1sVXDHGpHXP38TYsmkMKAqECNiBow+p58ejdxiW WiHaw73MmSeSWMOKe5ELY1WkoTT3D/hK2XbmB3NlE3f0aW4EjRoRsCz8HJiJ1CcujFmFr678vtQ OXuk/SMn8kjgrF1oZl/+F+XFjnU6C+r1PJtilKoPXNQYoOqyhTM9mFU2nNRFrF4NbhyaoxdmTCh 2ulwEnprpT0TiTrK+Sy2mfPFWBzsHSZb7+nL/6LCFwCsoKm97RhNVM0viboeTlqdfINfd9++MXe 9MbAmGKvmuzMYnQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8333 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases, and refer to bitbake-setup or the manual setup in the intro. Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 151 +++++++++++++--------------------------- 1 file changed, 48 insertions(+), 103 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 74912cdd6..2a451b213 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -62,8 +62,8 @@ Here is an example that clones the Raspberry Pi BSP layer:: $ git clone git://git.yoctoproject.org/meta-raspberrypi -In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of the -shipped ``poky`` repository. The ``meta-yocto-bsp`` layer maintains +In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of +:yocto_git:`meta-yocto `. The ``meta-yocto-bsp`` layer maintains several "reference" BSPs including the ARM-based Beaglebone and generic versions of both 32-bit and 64-bit IA machines. @@ -72,7 +72,7 @@ For information on typical BSP development workflow, see the section. For more information on how to set up a local copy of source files from a Git repository, see the -:ref:`dev-manual/start:locating yocto project source files` +:doc:`/dev-manual/poky-manual-setup` section in the Yocto Project Development Tasks Manual. The BSP layer's base directory (``meta-bsp_root_name``) is the root @@ -150,24 +150,23 @@ section. to get a build host ready that is either a native Linux machine or a machine that uses CROPS. -#. *Clone the poky Repository:* You need to have a local copy of the - Yocto Project :term:`Source Directory` (i.e. a local - ``poky`` repository). See the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and - possibly the - ":ref:`dev-manual/start:checking out by branch in poky`" or - ":ref:`dev-manual/start:checking out by tag in poky`" - sections - all in the Yocto Project Development Tasks Manual for information on - how to clone the ``poky`` repository and check out the appropriate - branch for your work. +#. *Prepare the Source Repositories*: + + There are two ways of setting up the :term:`Poky` reference distro: + + - Using the ``bitbake-setup`` command-line utility from :term:`BitBake`. + Follow: + + :doc:`Setting Up The Environment With bitbake-setup ` + + - Manually cloning the required repositories. Follow: + + :doc:`/dev-manual/poky-manual-setup` #. *Determine the BSP Layer You Want:* The Yocto Project supports many BSPs, which are maintained in their own layers or in layers designed - to contain several BSPs. To get an idea of machine support through - BSP layers, you can look at the - :yocto_dl:`index of machines ` - for the release. + to contain several BSPs. The :oe_layerindex:`Layer Index <>` can help finding + BSP layers to use. #. *Optionally Clone the meta-intel BSP Layer:* If your hardware is based on current Intel CPUs and devices, you can leverage this BSP @@ -175,10 +174,7 @@ section. :yocto_git:`README ` file. #. *Navigate to Your Source Directory:* Typically, you set up the - ``meta-intel`` Git repository inside the :term:`Source Directory` (e.g. - ``poky``). :: - - $ cd /home/you/poky + ``meta-intel`` Git repository next to the other layers in your build. #. *Clone the Layer:* :: @@ -224,18 +220,21 @@ section. Resolving deltas: 100% (2447/2447), done. Checking connectivity... done. -#. *Initialize the Build Environment:* While in the root directory of - the Source Directory (i.e. ``poky``), run the - :ref:`ref-manual/structure:``oe-init-build-env``` environment - setup script to define the OpenEmbedded build environment on your - build host. :: +#. *Initialize the Build Environment:* While in the directory where the + different layers are cloned, run the :ref:`ref-manual/structure:``oe-init-build-env``` + environment setup script located in :term:`OpenEmbedded-Core (OE-Core)` to + define the OpenEmbedded build environment on your build host. :: $ source oe-init-build-env Among other things, the script creates the :term:`Build Directory`, which is - ``build`` in this case and is located in the :term:`Source Directory`. After - the script runs, your current working directory is set to the ``build`` - directory. + ``build``. After the script runs, your current working directory is set to + the ``build`` directory. + + .. note:: + + Alternatively, you can source the ``init-build-env`` file provided by + :doc:`bitbake-setup ` Example Filesystem Layout ========================= @@ -597,10 +596,10 @@ optimization flags, which are carefully chosen to give best performance on a given processor. Tuning files are found in the ``meta/conf/machine/include`` directory -within the :term:`Source Directory`. +within :term:`OpenEmbedded-Core (OE-Core)`. For example, many ``tune-*`` files (e.g. ``tune-arm1136jf-s.inc``, ``tune-1586-nlp.inc``, and so forth) reside in the -``poky/meta/conf/machine/include`` directory. +``meta/conf/machine/include`` directory. To use an include file, you simply include them in the machine configuration file. For example, the Raspberry Pi BSP @@ -636,7 +635,7 @@ directory. Here is the ``machconfig`` file for the Raspberry Pi BSP:: according to the formfactor configuration file that is installed by the main formfactor recipe ``meta/recipes-bsp/formfactor/formfactor_0.0.bb``, which is found in - the :term:`Source Directory`. + :term:`OpenEmbedded-Core (OE-Core)`. Display Support Files --------------------- @@ -664,7 +663,7 @@ types of files although, in practice, it is likely that you would have one or the other. For your BSP, you typically want to use an existing Yocto Project kernel -recipe found in the :term:`Source Directory` +recipe found in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/recipes-kernel/linux``. You can append machine-specific changes to the kernel recipe by using a similarly named append file, which is @@ -767,19 +766,22 @@ workflow. .. note:: - There are three hardware reference BSPs in the Yocto - Project release, located in the ``poky/meta-yocto-bsp`` + Project release, located in the :yocto_git:`meta-yocto-bsp + ` BSP layer: - Texas Instruments Beaglebone (``beaglebone-yocto``) - Two generic IA platforms (``genericx86`` and ``genericx86-64``) + - A generic ARM 64 platforma (``genericarm64``) + When you set up a layer for a new BSP, you should follow a standard layout. This layout is described in the ":ref:`bsp-guide/bsp:example filesystem layout`" section. In the standard layout, notice the suggested structure for recipes and configuration information. You can see the standard layout for a BSP by examining any supported - BSP found in the ``meta-intel`` layer inside the Source Directory. + BSP found in the ``meta-intel`` layer. #. *Make Configuration Changes to Your New BSP Layer:* The standard BSP layer structure organizes the files you need to edit in ``conf`` and @@ -861,9 +863,7 @@ The requirements for a released BSP that conform to the Yocto Project are: - *File System Layout:* When possible, use the same directory names in your BSP layer as listed in the ``recipes.txt`` file, which is found - in ``poky/meta`` directory of the :term:`Source Directory` - or in the OpenEmbedded-Core Layer (``openembedded-core``) at - :oe_git:`/openembedded-core/tree/meta`. + in ``meta`` directory of :term:`OpenEmbedded-Core (OE-Core)`. You should place recipes (``*.bb`` files) and recipe modifications (``*.bbappend`` files) into ``recipes-*`` subdirectories by @@ -872,8 +872,8 @@ The requirements for a released BSP that conform to the Yocto Project are: up your own ``recipes-*`` subdirectory. Within any particular ``recipes-*`` category, the layout should match - what is found in the OpenEmbedded-Core Git repository - (``openembedded-core``) or the Source Directory (``poky``). In other + what is found in the :term:`OpenEmbedded-Core (OE-Core)` Git repository. + In other words, make sure you place related files in appropriately-related ``recipes-*`` subdirectories specific to the recipe's function, or within a subdirectory containing a set of closely-related recipes. @@ -1169,7 +1169,7 @@ Use these steps to create a BSP layer: - *Create a Machine Configuration File:* Create a ``conf/machine/bsp_root_name.conf`` file. See - :yocto_git:`meta-yocto-bsp/conf/machine ` + :yocto_git:`meta-yocto-bsp/conf/machine ` for sample ``bsp_root_name.conf`` files. There are other samples such as :yocto_git:`meta-ti ` and @@ -1187,7 +1187,7 @@ Use these steps to create a BSP layer: The remainder of this section provides a description of the Yocto Project reference BSP for Beaglebone, which resides in the -:yocto_git:`meta-yocto-bsp ` +:yocto_git:`meta-yocto-bsp ` layer. BSP Layer Configuration Example @@ -1235,63 +1235,8 @@ There are one or more machine configuration files in the For example, the machine configuration file for the `BeagleBone and BeagleBone Black development boards `__ is -located in :yocto_git:`poky/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf -`:: - - #@TYPE: Machine - #@NAME: Beaglebone-yocto machine - #@DESCRIPTION: Reference machine configuration for http://beagleboard.org/bone and http://beagleboard.org/black boards - - PREFERRED_PROVIDER_virtual/xserver ?= "xserver-xorg" - - MACHINE_EXTRA_RRECOMMENDS = "kernel-modules" - - EXTRA_IMAGEDEPENDS += "virtual/bootloader" - - DEFAULTTUNE ?= "cortexa8hf-neon" - include conf/machine/include/arm/armv7a/tune-cortexa8.inc - - IMAGE_FSTYPES += "tar.bz2 jffs2 wic wic.bmap" - EXTRA_IMAGECMD:jffs2 = "-lnp " - WKS_FILE ?= "beaglebone-yocto.wks" - MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "kernel-image kernel-devicetree" - do_image_wic[depends] += "mtools-native:do_populate_sysroot dosfstools-native:do_populate_sysroot virtual/bootloader:do_deploy" - - SERIAL_CONSOLES ?= "115200;ttyS0 115200;ttyO0 115200;ttyAMA0" - - PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto" - PREFERRED_VERSION_linux-yocto ?= "6.12%" - - KERNEL_IMAGETYPE = "zImage" - DTB_FILES = "am335x-bone.dtb am335x-boneblack.dtb am335x-bonegreen.dtb" - KERNEL_DEVICETREE = '${@' '.join('ti/omap/%s' % d for d in '${DTB_FILES}'.split())}' - - PREFERRED_PROVIDER_virtual/bootloader ?= "u-boot" - - SPL_BINARY = "MLO" - UBOOT_SUFFIX = "img" - UBOOT_MACHINE = "am335x_evm_defconfig" - - MACHINE_FEATURES = "usbgadget usbhost vfat alsa" - - IMAGE_BOOT_FILES ?= "u-boot.${UBOOT_SUFFIX} ${SPL_BINARY} ${KERNEL_IMAGETYPE} ${DTB_FILES}" - - # support runqemu - EXTRA_IMAGEDEPENDS += "qemu-native qemu-helper-native" - IMAGE_CLASSES += "qemuboot" - QB_DEFAULT_FSTYPE = "wic" - QB_FSINFO = "wic:no-kernel-in-fs" - QB_KERNEL_ROOT = "/dev/vda2" - QB_SYSTEM_NAME = "qemu-system-arm" - QB_MACHINE = "-machine virt" - QB_CPU = "-cpu cortex-a15" - QB_KERNEL_CMDLINE_APPEND = "console=ttyAMA0 systemd.mask=systemd-networkd" - QB_OPT_APPEND = "-device virtio-rng-device" - QB_TAP_OPT = "-netdev tap,id=net0,ifname=@TAP@,script=no,downscript=no" - QB_NETWORK_DEVICE = "-device virtio-net-device,netdev=net0,mac=@MAC@" - QB_ROOTFS_OPT = "-drive id=disk0,file=@ROOTFS@,if=none,format=raw -device virtio-blk-device,drive=disk0" - QB_SERIAL_OPT = "" - QB_TCPSERIAL_OPT = "-device virtio-serial-device -chardev socket,id=virtcon,port=@PORT@,host=127.0.0.1 -device virtconsole,chardev=virtcon" +located in :yocto_git:`/meta-yocto/tree/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf +`. The variables used to configure the machine define machine-specific properties; for example, machine-dependent packages, machine tunings, the type of kernel @@ -1309,7 +1254,7 @@ Project Reference Manual. The recipe that provides "virtual/xserver" when more than one provider is found. In this case, the recipe that provides "virtual/xserver" is "xserver-xorg", available in - ``poky/meta/recipes-graphics/xorg-xserver``. + ``meta/recipes-graphics/xorg-xserver`` in :term:`OpenEmbedded-Core (OE-Core)`. - :term:`MACHINE_EXTRA_RRECOMMENDS`: A list of machine-dependent packages not essential for booting the @@ -1400,7 +1345,7 @@ Project Reference Manual. .. note:: For more information on how the SPL variables are used, see the - :yocto_git:`u-boot.inc ` + :oe_git:`u-boot.inc ` include file. - :term:`UBOOT_* `: Defines @@ -1438,7 +1383,7 @@ The ``meta-yocto-bsp/recipes-kernel/linux`` directory in the layer contains metadata used to build the kernel. In this case, a kernel append file (i.e. ``linux-yocto_6.1.bbappend``) is used to override an established kernel recipe (i.e. ``linux-yocto_6.1.bb``), which is located in -:yocto_git:`/poky/tree/meta/recipes-kernel/linux`. +:oe_git:`/openembedded-core/tree/meta/recipes-kernel/linux`. The contents of the append file are:: From patchwork Wed Dec 24 16:31:31 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77438 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 1C42BE776CF for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123715.1766593911672020465 for ; Wed, 24 Dec 2025 08:31:51 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LCuWPvwP; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 1BF1D1A23E0 for ; Wed, 24 Dec 2025 16:31:50 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E7A206073D for ; Wed, 24 Dec 2025 16:31:49 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 40DE9102F0CD4; Wed, 24 Dec 2025 17:31:49 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593909; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=kkraAZueWcGsZEJC6hjLmE5GZNu3+wuX38UIxVi1YQw=; b=LCuWPvwPAdzYS3izhAWTTsvxNxojVaAJz7DBwHoQC7EtnKGayC/lX5NBwzf2YCFjBRemwQ FTOLk0wJAsC9UA4f4hHD+HeWM2pYaOf7/5IupN7Quko+DtSyX8I8SlqkJcPVDaNWAIHLAK QZEJMlqDuRI/u0Lz7LLazvpjYSBo+ozXkfsd+4YsY/uhoHUvJTGYKT0sj3WmYPczdCvd9y +oGrO604Ab34QdI5lDvjpoOT8cfRtV6Df2xx0j10bG9z13aPZab/49cRl50OXqSxedjEWH o8t2XWXdv1v1prJcRLOjntRzGh7M38P8ysqkL1SbwVU3uZCyFAIJdU32c3ibkw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:31 +0100 Subject: [PATCH 05/53] kernel-dev/advanced.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-5-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2521; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=qjh2FEXVqCBX2EsrJwdx2mtrwJ8Z4McFcnh3cBpk0No=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVndZy0sJTzgYYt/Plb3P/y/pnd2m1NmJGpl QN13YrKEfGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZwAKCRDRgEFAKaOo NgAwD/0cQz2PJaNF9gJCh/oaIcGKVuKaCIRqQP1RlVa9n9jA+e0+vxOtk1mce9msijyBDXF/dxe aciRRLR2HMsaWlPqjBt5vPixg1kiKH2chcBpo07LqmuL6oNadyiPxkU71gYJvFaFbqKyMI7zxuh ixQz8G38l9RLlVtkeMlCcku7t4Wl3HYuWdHzi9z8UcSEu4+ANWR4XFsbEMVFTfDt3h1eMRRFcDk RHtqaRJPh9iaEDQjIlzuILN6KJeMwUBkP6+iPTorX3XDizcOJBgUdZZBJgAh92j6vcV+wB+5gwc FlzcpoP8s8EPyxvLXqJ7VI72eKXvCKY0RVDPRvbxncxj7Q0j5MKWFb89D7oiyHFmJndFSunkQOV f2ptCnMsETL1CnMXSje+OnrnhlU1KF21bss6fvnEAvXdTEgX7oMyv4HnPUdWgI/ATvR9QQ/LcHH +mU8PkNjXNeAIdoO5RNXuzEndRcLtHlawychbXgXo9hzr7mQzxwA1iK0XOBdY7DMIzZoHhoEspP jDOBgX9J2se6GHU35KbTm77vx8I2ha8L/MHbr8M/DajNWkv6xlyGhq5dWWb8OSmopYHzSi8hUDR D67skGLm+fwpiqXIoEy/FfKqEe3I+85zpkGKUVW0vfjeka8GkUDeFfwiF3VtUqmLVHtnqG49/Up NDoZpJc1Wg00DpQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8334 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases, and refer to bitbake-setup or the manual setup in the intro. Signed-off-by: Antonin Godard --- documentation/kernel-dev/advanced.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/documentation/kernel-dev/advanced.rst b/documentation/kernel-dev/advanced.rst index 4c463503f6..97cb663222 100644 --- a/documentation/kernel-dev/advanced.rst +++ b/documentation/kernel-dev/advanced.rst @@ -24,9 +24,8 @@ grouped under the "Yocto Linux Kernel" heading in the Kernel development tools ("kern-tools") are also available in the Yocto Project Source Repositories under the "Yocto Linux Kernel" heading in the ``yocto-kernel-tools`` Git repository. The recipe that builds these -tools is ``meta/recipes-kernel/kern-tools/kern-tools-native_git.bb`` in -the :term:`Source Directory` (e.g. -``poky``). +tools is ``recipes-kernel/kern-tools/kern-tools-native_git.bb`` in +:term:`OpenEmbedded-Core (OE-Core)`. Using Kernel Metadata in a Recipe ================================= @@ -357,9 +356,9 @@ kernel of a specific type (e.g. a real-time kernel). Syntactically, kernel types are no different than features as described in the ":ref:`kernel-dev/advanced:features`" section. The :term:`LINUX_KERNEL_TYPE` variable in the kernel recipe selects the kernel type. For example, in the -``linux-yocto_4.12.bb`` kernel recipe found in ``poky/meta/recipes-kernel/linux``, a +``linux-yocto_4.12.bb`` kernel recipe found in ``meta/recipes-kernel/linux``, a :ref:`require ` -directive includes the ``poky/meta/recipes-kernel/linux/linux-yocto.inc`` file, +directive includes the ``meta/recipes-kernel/linux/linux-yocto.inc`` file, which has the following statement that defines the default kernel type:: LINUX_KERNEL_TYPE ??= "standard" @@ -373,8 +372,7 @@ type as follows:: .. note:: You can find kernel recipes in the ``meta/recipes-kernel/linux`` directory - of the :ref:`overview-manual/development-environment:yocto project source repositories` - (e.g. ``poky/meta/recipes-kernel/linux/linux-yocto_4.12.bb``). See the + of the :ref:`overview-manual/development-environment:yocto project source repositories`. See the ":ref:`kernel-dev/advanced:using kernel metadata in a recipe`" section for more information. From patchwork Wed Dec 24 16:31:32 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77439 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 139B5E776CC for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123716.1766593912136379981 for ; Wed, 24 Dec 2025 08:31:52 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=eZhJ3zMk; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id A28001A23E1 for ; Wed, 24 Dec 2025 16:31:50 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 784E26073D for ; Wed, 24 Dec 2025 16:31:50 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D9CAA10AB133F; Wed, 24 Dec 2025 17:31:49 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593910; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=qX9C/5S9UJSUDWPqJhesQtWAkgVaF+BvPRkULXzbZIw=; b=eZhJ3zMkGDlXK7QBjl/L2dkDKdtBo++H9isLSwYyCHPQL2QLPhURcDE8cLxJrGE58Fmooj VpO6ik8VGzzF9ABAsGn8oFJpa6GUFAy7+NRNQP1njVkb5/H1SL14SQPbZOYMwvywoBwifJ gelGgvR5kSqu9wDgnFbRtAU24mkIDImSc1MuoBrJyK3TIRMWuTif/ewyChhfGyuLkNugEf /wA6hARqfnJjkVpOmhPU1Aw2xDLcnJeJT1YS9J3B02wB+TJFuaRxOQie8eNlPPWY8mFpXO PKo2fRdfn8kAwDim7WjwybJw44MoSdAuxfLnhEh9sKNl36LcwHlaXCG0Adi7Gg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:32 +0100 Subject: [PATCH 06/53] contributor-guide/submit-changes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-6-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4790; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=OD0nP/H8yBmEwQY7ixfPUgCLYMfamZTW6lLBevy0S+A=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVnSNXFLPo9HjaGiCUkE32pf09jeZEMe+xcC TkCJdXLDmyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZwAKCRDRgEFAKaOo NhcKD/4wPnFnzJyzcbgNPCRIrdfH2m8n/MrmqzekAzIuGyP9xQgYob/Pt3v5A1KzQxSAC2M/bUR TdzsESU7vQ0py5e2SVIM5uhv8bcENXb/+DcO3Gw9+hK4ns9GjuYlXZRhONBbAJ0mm2Tw6xQEFYf VyjCCMcuVy1TVxEEFs6dvxjCPCmIC/J7+aoLCwcUL5QO3QLzXdmYBpYzfUWoGf2i7357KXtR9xN YYEKCenuDc3pvXHTXlY2EJPqq3Le/SPfZ48vkNwVs1NMU2583Ns/8ha7vJjQeXdn+OFqyBec/tF ECWYmn39UB6xlGck/fjCvlnWNDQBgNYH2aS9+gc6Fr0EjvYgMVdezUW+JfUDrwTPf/FRS3SLejH eGoksuBWiULOBhhwt29O/MKkXqJFJPVFs0YJLNyoVvqO/My9hD8JQVYn1ePFdt/ZMPr7kEWCyLn GIeKimq57PRUsBnCpnzKs22oMc1tLAwaOE4d/Jg/HevEQffbUEfvr0Kf7BSy/wl4US2QJn+agHw sZtOozg/e6c4agUPOXidCThHbvvDBwngjtu77ZWhGqElJtaYUEi0S7O7X96o7gmz3JK+3CDfQYK cywBm2R5F41adkEUn2fwbpRVDlsVu3g0wBnkbjynsfZzMPHejzWDMyKbe57BEGxNIs7iRjfdx8p 2PxalFl55GG27fw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:31:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8335 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Signed-off-by: Antonin Godard --- documentation/contributor-guide/submit-changes.rst | 29 +++++++++------------- 1 file changed, 12 insertions(+), 17 deletions(-) diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst index 6306ed45b..d282cdf75 100644 --- a/documentation/contributor-guide/submit-changes.rst +++ b/documentation/contributor-guide/submit-changes.rst @@ -429,11 +429,7 @@ and then based on successful testing, merges them. In general, each component (e.g. layer) should have a ``README`` file that indicates where to send the changes and which process to follow. -The "poky" repository, which is the Yocto Project's reference build -environment, is a hybrid repository that contains several individual -pieces (e.g. BitBake, Metadata, documentation, and so forth) built using -the combo-layer tool. The upstream location used for submitting changes -varies by component: +The upstream location used for submitting changes varies by component: - *Core Metadata:* Send your patches to the :oe_lists:`openembedded-core ` @@ -620,7 +616,7 @@ have been followed: methods to find out: - *Maintenance File:* Examine the ``maintainers.inc`` file, which is - located in the :term:`Source Directory` at + located in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/conf/distro/include``, to see who is responsible for code. - *Search by File:* Using :ref:`overview-manual/development-environment:git`, you can @@ -645,9 +641,8 @@ have been followed: The Yocto Project provides two scripts that conveniently let you generate and send pull requests to the Yocto Project. These scripts are ``create-pull-request`` and ``send-pull-request``. You can find - these scripts in the ``scripts`` directory within the - :term:`Source Directory` (e.g. - ``poky/scripts``). + these scripts in the ``scripts`` directory within + :term:`OpenEmbedded-Core (OE-Core)`. Using these scripts correctly formats the requests without introducing any whitespace or HTML formatting. The maintainer that @@ -660,7 +655,7 @@ have been followed: directory into which you pushed the change, and provides a subject line in the created patch files:: - $ poky/scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" + $ ./scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" Running this script forms ``*.patch`` files in a folder named ``pull-``\ `PID` in the current directory. One of the patch files is a @@ -673,7 +668,7 @@ have been followed: and email address. In this example, the email address is a mailing list:: - $ poky/scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org + $ ./scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org You need to follow the prompts as the script is interactive. @@ -682,8 +677,8 @@ have been followed: For help on using these scripts, simply provide the ``-h`` argument as follows:: - $ poky/scripts/create-pull-request -h - $ poky/scripts/send-pull-request -h + $ ./scripts/create-pull-request -h + $ ./scripts/send-pull-request -h Submitting Changes to Stable Release Branches ============================================= @@ -857,14 +852,14 @@ used testing branches for OpenEmbedded-Core are as follows: :oe_git:`openembedded-core ` repository and contains proposed changes to the core metadata. -- *poky "master-next" branch:* This branch is part of the - :yocto_git:`poky ` repository and combines proposed - changes to BitBake, the core metadata and the poky distro. +- *meta-yocto "master-next" branch:* This branch is part of the + :yocto_git:`meta-yocto ` repository and combines proposed + changes to meta-yocto. Similarly, stable branches maintained by the project may have corresponding ``-next`` branches which collect proposed changes. For example, ``&DISTRO_NAME_NO_CAP;-next`` and ``&DISTRO_NAME_NO_CAP_MINUS_ONE;-next`` -branches in both the "openembdedded-core" and "poky" repositories. +branches in both the "openembedded-core" and "meta-yocto" repositories. Other layers may have similar testing branches but there is no formal requirement or standard for these so please check the documentation for the From patchwork Wed Dec 24 16:31:33 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77443 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 33193E776CC for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123717.1766593912833050633 for ; Wed, 24 Dec 2025 08:31:53 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=1UdLTDhK; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 4283D1A23E2 for ; Wed, 24 Dec 2025 16:31:51 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 199106073D for ; Wed, 24 Dec 2025 16:31:51 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7915210AB136F; Wed, 24 Dec 2025 17:31:50 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593910; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=JJfWGA8BpMiqUIl2g/x/ZXWO8TM6zTiWa8ImoSd1QX0=; b=1UdLTDhKFGj5Q6be6x72LCJGubIxCT8Vv3KGrdtuTIOjngBZ3IxWXEpjeECV0glsjMYH3e WRahYXg6gVbR+AyTpRZiL4jhTCLH+8rfIwUjUzAp93S1TI0RA0azcaVBEZOP/oFdhPoEVB X22rzTXrhT7ppvE0giUkUrQboip24BBscz/kj1ZVT5Y30v65nJzk92/51g9dmHxDLuJ2Js AYhpwW0edar02aQw4pHymB+70Pwaz1rYqj0uPMUmunehNtILTTWmWt6OSp+JGJDj85w05H 7hxlBAXrztTfMFTjFGo6k57dLZxvRepnr/dDUOt12yAQ3eYmGoGDTlqR3tSACQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:33 +0100 Subject: [PATCH 07/53] dev-manual/building.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-7-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4697; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=wXWyQuikG9ztPn0xZgLvEornbB0Um9+rD0vKEdE3LHI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVnYSz4DPv/j10QQy3NKJbvm/OQHOIOwlHHM llu59JehYiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZwAKCRDRgEFAKaOo NkOkD/4qqmPG/fP4MjfrUajPxCKRyxKfkVl055RupV18QAhq33iLUFK88ou2e5fLFOPq0M50iWx fKY5cuRajZUWNrB9NtIy82r5yAaV4qUiOb7OU00QW9Estef7cj9JD2a9E8GT56lXX9Wcaa0K2kg VbSSO3GZHn8uKaLVYvcOZi9hub6+JFQjlcktA2pZo42oj8F4XWPLv89ml1TMr8HxYRep4wQ58Uv CKH6mHn8qDGhfYBg7yb+eEeE2Xd2HBstilhhQurVOUbnUdg1mqQlmcgc1iLoO8q/iAtXYfRC0bg G/brIU5B3VRVc4Ilk9Z5t55E+KYa3960Pge1JNTQsYpcb54d3cdS2BbYktaMejD7LcO5zJkOGoz +N5wU/B8kNo/SEVF1tJ2yLjgE68JAC2zlg+efEYWxI+70wQFXqDyKfAk6vCJYIq8beNnHpUVaaH UkalQfxpfufoXovgws8pNOVi7zvJdzXWv6IqELYAfQflfwhDTaWmTfJfoNLtXXmMej/XO9RlTtm ZPdofDE0Xso47nm2NFObUmwPnhuKNV5lb64OM5275s9/awWDAsKzgNDFg8eIE6oNepOF4kU+nb/ JS/ctuCfNtIFCUgInhrwICx7S1OcdW3Qf85oQrEpyi4+quU/RlL3y4rvdTr8Jcdx0iitLKB6SwY +D+4ETHisLJp8Nw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8336 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Signed-off-by: Antonin Godard --- documentation/dev-manual/building.rst | 40 +++++++--------------------------- documentation/ref-manual/fragments.rst | 2 ++ 2 files changed, 10 insertions(+), 32 deletions(-) diff --git a/documentation/dev-manual/building.rst b/documentation/dev-manual/building.rst index 60ad11f52..c153eb9de 100644 --- a/documentation/dev-manual/building.rst +++ b/documentation/dev-manual/building.rst @@ -51,32 +51,9 @@ The following figure and list overviews the build process: Yocto Project*: See the ":doc:`/dev-manual/start`" section for options on how to get a build host ready to use the Yocto Project. -#. *Initialize the Build Environment:* Initialize the build environment - by sourcing the build environment script (i.e. - :ref:`structure-core-script`):: - - $ source oe-init-build-env [build_dir] - - When you use the initialization script, the OpenEmbedded build system - uses ``build`` as the default :term:`Build Directory` in your current work - directory. You can use a `build_dir` argument with the script to - specify a different :term:`Build Directory`. - - .. note:: - - A common practice is to use a different :term:`Build Directory` for - different targets; for example, ``~/build/x86`` for a ``qemux86`` - target, and ``~/build/arm`` for a ``qemuarm`` target. In any - event, it's typically cleaner to locate the :term:`Build Directory` - somewhere outside of your source directory. - -#. *Make Sure Your* ``local.conf`` *File is Correct*: Ensure the - ``conf/local.conf`` configuration file, which is found in the - :term:`Build Directory`, is set up how you want it. This file defines many - aspects of the build environment including the target machine architecture - through the :term:`MACHINE` variable, the packaging format used during - the build (:term:`PACKAGE_CLASSES`), and a centralized tarball download - directory through the :term:`DL_DIR` variable. +#. *Make Sure Your Configuration is Correct*: Use :ref:`bitbake-config-build ` to + define the :term:`MACHINE` or :term:`DISTRO`, and open your + :ref:`structure-build-conf-site.conf` file to set site-specific settings. #. *Build the Image:* Build the image using the ``bitbake`` command:: @@ -88,8 +65,8 @@ The following figure and list overviews the build process: The target is the name of the recipe you want to build. Common targets are the images in ``meta/recipes-core/images``, - ``meta/recipes-sato/images``, and so forth all found in the - :term:`Source Directory`. Alternatively, the target + ``meta/recipes-sato/images``, and so forth all found in + :term:`OpenEmbedded-Core (OE-Core)`. Alternatively, the target can be the name of a recipe for a specific piece of software such as BusyBox. For more details about the images the OpenEmbedded build system supports, see the @@ -127,7 +104,7 @@ Follow these steps to create an :term:`Initramfs` image: #. *Create the Initramfs Image Recipe:* You can reference the ``core-image-minimal-initramfs.bb`` recipe found in the - ``meta/recipes-core`` directory of the :term:`Source Directory` + ``meta/recipes-core`` directory in :term:`OpenEmbedded-Core (OE-Core)` as an example from which to work. The ``core-image-minimal-initramfs`` recipe is based on the :ref:`initramfs-framework ` recipe described below. @@ -366,9 +343,8 @@ memory used for decompressing the kernel and for the ``__init__`` functions. To help you see where you currently are with kernel and root filesystem -sizes, you can use two tools found in the :term:`Source Directory` -in the -``scripts/tiny/`` directory: +sizes, you can use two tools found in :term:`OpenEmbedded-Core (OE-Core)` +in the ``scripts/tiny/`` directory: - ``ksize.py``: Reports component sizes for the kernel build objects. diff --git a/documentation/ref-manual/fragments.rst b/documentation/ref-manual/fragments.rst index 42fba41e9..9449f4648 100644 --- a/documentation/ref-manual/fragments.rst +++ b/documentation/ref-manual/fragments.rst @@ -22,6 +22,8 @@ System` core repositories. :doc:`/dev-manual/creating-fragments` section of the Yocto Project Development Tasks Manual. +.. _ref-bitbake-config-build-qf: + ``bitbake-config-build`` Quick Reference ======================================== From patchwork Wed Dec 24 16:31:34 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77448 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 3F1C0E776D1 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123718.1766593913447938800 for ; Wed, 24 Dec 2025 08:31:53 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ZL7GPuC6; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id EC82E1A23E4 for ; Wed, 24 Dec 2025 16:31:51 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C366C6073D for ; Wed, 24 Dec 2025 16:31:51 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1A4A010AB1370; Wed, 24 Dec 2025 17:31:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593911; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=dafVX1PRfkns+41er/td1RMSSybhHzVSFhWFftRC/8M=; b=ZL7GPuC6yzMCYOY0n4yDrD8nTv/aogy7r3JKn0mHaRlbmlqIa9+D0z2HxmTGm7Xjl4N9Ew XwlR2fWrlsTb1KkM5IHRhmaevc3EFyVgWUUdWMOpCnDoUtfQsqKm4wC7k5hUyhxOqTYqog OxxxO3odpx8AuLBtUtYsZzqyxhRufa8YMat4CsrhSr4tqUTjt01F8rp6X9FFI+DKFZuqnt z5qaZVU5rNRdMkjeEhbLO7THz0AHzhZZh+6/gmVfMv/jU0avtsblPzxM0yZad5iKiSw9OL bN5A5wUu77Qo+hysChgnt3rx9eVeDRBBikRngSe+w89kto+FkzJHR4+FlZEWHA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:34 +0100 Subject: [PATCH 08/53] dev-manual/debugging.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-8-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3058; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=HuqmZQLoxQ0/wk6rBcyYqzahusvtemdyxUSiQuEJFXQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVn46XLrMpx84ixP6BD0twd4UM+I4Tp/he18 KTcQv0WUy+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVZwAKCRDRgEFAKaOo NrO5D/92Glzw1eCDkf/ceJNXGAwq1bl3ljC6r3AB+X8E76gWk/b1qP7A8EFwWy59odZchRAOr05 U+7/QJOeWXQJ4S0SN7vjBaQJVfN+KWOzrjZesgHfqe7EqonF+iAeBTpKhNNWqhO0Hrd8Grx9w2A YU/WtxXOv4nP92P3YHDU2LaouG9RatUq5naRBGuk6UJbbfC58/9udkhH5MYYOsmtpoFyrbeJWHx cdMZOFnAcxON+Ip++shzPROwzGtt0xqN31yuld3UVqBDjlxBmU4dgbgyUqc0/QJCa0jWsxNO+hN G9+JJgTRB6eTe50io/2fEKo4tgmp3L540fJNAr69IEbiE/T+IM73WlOEs8djLFmJOmwou5Cjwph AjIuZiPLCrWRTdDAyhpF7U1HhPmvQCC8IN4Zvk+RwrWMxEVDJQWGaFvl1M6cmtzSelXp28/KtKs B3PQ47VrfVuKnKu6K3Ga090eep6Yka2WJjjfe1I0xO9FqagSlY6enK92wIIVw3zLIyZH6Mch7KB nGhj3fuIcKMxnD9yEO2Qihr4ku1Womci+/qHG2sYns9lEVn7WtRz2AQHndrdD5/auWVzJRVLuJJ L2PO/nDH2b73op7s3zPbHY/p4gkKrS/ga7voVIzFrit9mb5tfp3OGLumUMuDLjEBo/W4yZNNjf9 hwPFDPOJnKaxvoQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8337 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/debugging.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst index 0202f1b32..21fb10537 100644 --- a/documentation/dev-manual/debugging.rst +++ b/documentation/dev-manual/debugging.rst @@ -439,7 +439,7 @@ the build system to run the task again. For an example of a commit that makes a cosmetic change to invalidate shared state, see this - :yocto_git:`commit `. + :oe_git:`commit `. Running Specific Tasks ====================== @@ -522,7 +522,7 @@ task dependency mechanisms. .. code-block:: none - WARNING: /home/ulf/poky/meta/recipes-sato/matchbox-desktop/matchbox-desktop_2.1.bb.do_compile is tainted from a forced run + WARNING: /home/ulf/openembedded-core/meta/recipes-sato/matchbox-desktop/matchbox-desktop_2.1.bb.do_compile is tainted from a forced run The purpose of the warning is to let you know that the work directory @@ -615,7 +615,7 @@ The same logging functions are also available in shell functions, under the names ``bbplain``, ``bbnote``, ``bbdebug``, ``bbwarn``, ``bberror``, and ``bbfatal``. The :ref:`ref-classes-logging` class implements these functions. See that class in the ``meta/classes`` -folder of the :term:`Source Directory` for information. +folder of :term:`OpenEmbedded-Core (OE-Core)` for information. Logging With Python ------------------- @@ -852,10 +852,10 @@ patch:: Refreshed patch patches/parallelmake.patch Once the patch file is created, you need to add it back to the originating -recipe folder. Here is an example assuming a top-level -:term:`Source Directory` named ``poky``:: +recipe folder. Here is an example assuming :term:`OpenEmbedded-Core (OE-Core)` +is named ``openembedded-core``:: - $ cp patches/parallelmake.patch poky/meta/recipes-connectivity/neard/neard + $ cp patches/parallelmake.patch openembedded-core/meta/recipes-connectivity/neard/neard The final thing you need to do to implement the fix in the build is to update the "neard" recipe (i.e. ``neard-0.14.bb``) so that the @@ -940,7 +940,9 @@ debug symbols from the server. To run a ``debuginfod`` server, you need to do the following: - Ensure that ``debuginfod`` is present in :term:`DISTRO_FEATURES` - (it already is in ``OpenEmbedded-core`` defaults and ``poky`` reference distribution). + (it already is in :term:`OpenEmbedded-Core (OE-Core)` defaults and + :term:`Poky` reference distribution). + If not, set in your distro config file or in ``local.conf``:: DISTRO_FEATURES:append = " debuginfod" From patchwork Wed Dec 24 16:31:35 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77454 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 89B88E776E6 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123719.1766593914552931917 for ; Wed, 24 Dec 2025 08:31:54 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=SWFPdjuP; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 14B1C1A23E0 for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E0B546073D for ; Wed, 24 Dec 2025 16:31:52 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B7C02102F0CD4; Wed, 24 Dec 2025 17:31:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593912; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=o9GgY//F61xZzwYDJzQwWl7Hpn53VhrETwgAski38lE=; b=SWFPdjuPuJArrgJy44R5Ltgu6mf6W5KvyK7kJMD718T41l2E4zQ6rUC/GFVK3mchp+FyQ8 zpQYU14vYKOaFPsTNS7NKpQwfYT79RiCUDEJZggwBWiuJtFbJYRbyZAjbzl1hpsKsFy/4T FEUsW1bSvu7BbLBKw7iLiga2eUhKTDql0izYcNrIWIGrcZcE5cpeBB6DFmnRvYYeQME888 iSM3vMoLjWVg6c3RiUSFlq2Tmek/J86pLid8q/eM2GgmTnrRbIhHCWCRuJAWewg/fGxph9 9y6a7ngg3U16RbnnYFtclcyE/1ZLDNzbRZ4OhqaWlinQvx+REZrY77ArM4oIoQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:35 +0100 Subject: [PATCH 09/53] dev-manual/error-reporting-tool.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-9-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1116; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=lmN2JmHeLlCUdtBG+GbzjZODfu7J9BDtjbctkvXVVmA=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVoDEurI6wjDzKFHausAm/e7lVXmoYDdJO/x MLoWIm0WZqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaAAKCRDRgEFAKaOo NrMRD/sGWRcBQNezRgrFRfEkb1g0HNbJNC9oS1cokCcGb6NM9elsCcmirFn7dK/QSkl3y6SKf6c IeXoMquEZf1aBbnVUpzfvnlQsjwlCVxiWw9B14qOBJ5OWsr+/bxTK8jsH6tVJXyzMNeaATdueup ayndF9iV5RTbtqsoPOwIOOPGiRcxxKAn0YGkbkqoQGyUey86ZQURlnbItFwxeuze1OctX+5ehTQ nWp5iiXT1ghypT5o1CoonJvJC6ojlKz9VDH+3gPckj+MQH3htDnvZ8KPAwMpsJN0YRV/rWSiHhA e2n5MUieyLhIbztbuiFybKxASZcVqAS28tgZ99di73lWCV/7Z3S6MDyNDMVSxNZ0n9ULsWtKD8+ kJQLdjelDhC9QE/Ug+IFJjcaBXubkdeoGgukzc4qFXcYJb0dy5VlZqo4ZOGSUY5Y/Agm9ZfDj7P cyR7wtxmyDR/Ud9N4a/sH//wyX1lYAJ46bAR6F6ssUKWMM18eBs0YQ4IpZt8g6JURJ6EnCddIw0 CuWH8HEUd2l0bXpP9mS3dB+AMjXDdEwIPaCPb5518l+iN02ZWSYL87XQOk75BKv+G8rVHQZ6nqC yPgSofnqgPwLY/AC+cKtTbhjEdMSJv2q52pHBByDWiD72w5CFTeMxu+3Rclu+TWhGxtWmjI82WA 3kn9oM9wo1pTMbQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8338 Remove the single poky repository reference in this document, after the poky repository was obsoleted. Signed-off-by: Antonin Godard --- documentation/dev-manual/error-reporting-tool.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/documentation/dev-manual/error-reporting-tool.rst b/documentation/dev-manual/error-reporting-tool.rst index 84f3d9cd1e..30d1ce2b31 100644 --- a/documentation/dev-manual/error-reporting-tool.rst +++ b/documentation/dev-manual/error-reporting-tool.rst @@ -7,8 +7,7 @@ The error reporting tool allows you to submit errors encountered during builds to a central database. Outside of the build environment, you can use a web interface to browse errors, view statistics, and query for errors. The tool works using a client-server system where the client -portion is integrated with the installed Yocto Project -:term:`Source Directory` (e.g. ``poky``). +portion is integrated in :term:`OpenEmbedded-Core (OE-Core)`. The server receives the information collected and saves it in a database. From patchwork Wed Dec 24 16:31:36 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77452 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 926E2E776E8 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123186.1766593915138630602 for ; Wed, 24 Dec 2025 08:31:55 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=2rhUsIlz; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id A341C1A23E1 for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 745AA6073D for ; Wed, 24 Dec 2025 16:31:53 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id CE9FF10AB1372; Wed, 24 Dec 2025 17:31:52 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593913; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=hKe1eKOgd4ZxF012XKNjxP+1ZsA/T6hlxtkiQFicYrQ=; b=2rhUsIlzwR4bf9GlRaa3h2FJHx6uRY8xwfROOG9A2hPyWMV3JakPevvrbrvGGwhDdHtS/k 949xbW7UmaoER4oYMQfJJr7ZfhVN7+3QCctJUqJ89cjtz2kL/p0286RdD0jRtnG6J7+w+M JhUA1N2ZB+6A0+n18i9/0kBDIcD65uhMO+NdZyJpU7OTJQfVan5YDeucDezewfFktTd431 wZEIVfVRjlB8dQYC5cl8qqzIOs6PSfdjO8co9vZIDABLgMiE6Wd19qsxW0UmkrpMB/Ngtf LZaV7mRclsPklh5jUAz0U5NHX4ZnXknNbjMLuvQMo+/0Mk6kgMeB5JP9lPHaQw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:36 +0100 Subject: [PATCH 10/53] dev-manual/external-toolchain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-10-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1088; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=ydswT1KflFqZ+IoyWWLYD+stQ5zbFL2iOwCQImwD1nA=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVoRfgiwCFq+OZUoMD+wNCReVh3Wvn3YqqCL FFXPaQQWTOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaAAKCRDRgEFAKaOo NtfQEACScl1UFemSvJv68LmePOeZ6NGY/3t/Fnhq723bFYi0q+xOIz8W+rNZKaJW8a5o01p/+/E g8TNkOovVE5jEtpmMHWXQ61dOVzQ+TDYehuHAnFrQKOx8bzfS4v+jjh8v269NIjl+dlkd5SIOCY FY46akevrAOwQmjGFSIMv6mNZ519gzK9SW6zvspZiP+q7Sme31fmjhPsPbuZ+e8xZu7e66Sh27I Po43B8jbcekXTbn4owladzhonFaX2cgqzb77gbCOPVBDBgawIPI8LL9/tKRRao3pv78wMgCn+yd kRtiLS3lNqlzQ2xo0Io7Jp5WEuCJPZMLGGzVJubrZPKO/b7DovDJ52N/S7jzjOzRc0phUlKYNK8 UHHYd/1Bx8443CYK9s94zXo1zAxGVt8tC8S5ib3OtQRwMk6LV07ChFyYRKEGJw75DqxgdFaRieC xqQrNqnlmEGlfEoaloRW/p8i976DqvYIf+dlX3lfQj6DaqhpgVJhL6z+0pOOa/mbYk86Xt8XvKe CNGqzsT77glBWulgmOco4oWmUjzw79mqjIE6HW7ojDISuZiAFkNMYDcScDoqQeclCDnMTT4RaOY CLF604qk0A5q45OTea1IvUVHn7/Ge9kePozNt/upQWWZwa9S4rSjdDzZ4K6HI4/Y7Jucv5CZyy/ cUGOqdkQo6mcDEg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8339 Remove the single poky repository reference in this document, after the poky repository was obsoleted. Signed-off-by: Antonin Godard --- documentation/dev-manual/external-toolchain.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/external-toolchain.rst b/documentation/dev-manual/external-toolchain.rst index 238f8cf467..29459ea120 100644 --- a/documentation/dev-manual/external-toolchain.rst +++ b/documentation/dev-manual/external-toolchain.rst @@ -21,7 +21,7 @@ follows: The toolchain configuration is very flexible and customizable. It is primarily controlled with the :term:`TCMODE` variable. This variable controls which ``tcmode-*.inc`` file to include from the -``meta/conf/distro/include`` directory within the :term:`Source Directory`. +``meta/conf/distro/include`` directory within :term:`OpenEmbedded-Core (OE-Core)`. The default value of :term:`TCMODE` is "default", which tells the OpenEmbedded build system to use its internally built toolchain (i.e. From patchwork Wed Dec 24 16:31:37 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77456 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 75E7AE776E4 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123720.1766593916205837905 for ; Wed, 24 Dec 2025 08:31:56 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=g8P1XiDI; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id AE37F1A23E2 for ; Wed, 24 Dec 2025 16:31:54 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 86D846073D for ; Wed, 24 Dec 2025 16:31:54 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 57E7A10AB1373; Wed, 24 Dec 2025 17:31:53 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593913; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=YdutaXlj/mRa99wKdt0cx5Pc+lKMOqeDC4EoqhQRvMc=; b=g8P1XiDIjnqp9dKzf3+MkJvmn08gSCN65Ul91eZkd5aOrReM1fD0t+do9OqVElfjC0ZHR9 0yBtrP6ioeXPV/YoXlbneEKnJpGue+LM/jsD6SyBJSiOjs0n+wrWyFgBb8JAMBWbMYhnyg ztB0w2t0W8mmdNoG/R504IdiAas2Rss66DU0LoqmSx/umatjObMXJIn21EEJbAWxKrRfSy UB81vCCGYHhV+bMp5fS6ccsWOyh89yz5us8PeS0jFGMq+ZZAo0Pv2w5xbJ1Z0gub5FxuV9 aOgvnS00qqDbd9QJY9vVCDumf7RqmLpGyrnY+1u9cwZ2Q6vh9u2pHzaScGNr1A== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:37 +0100 Subject: [PATCH 11/53] dev-manual/layers.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-11-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=19764; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=g9raN+ku2/HXwZ+UHBlN0+i6NIJXqX+/M75SZ6ynZuc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVo5+ucx5MqaHkC7xGLGFh6uaRnt8LI+ncpk 1hZyfK5GS6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaAAKCRDRgEFAKaOo NqM1EACj2LZV75v/I3HhDJ8l7qibpFrfusx+BEpbptEGwJTP6Uw9slJDdwumldD5VWimUzLWPtC OrcZe6aiFHz04Nu8P5t0n0ta7QB7Eh/bK1Cy7tL6om9FheI2BZveuQnSSLMVe+mXPioweT3kFSl yJcYJ/FvCBnyUf2bmydxYtGrG78anyQ35XJ4kTu+zcuF0i94Y0tyZM9mdzVZfPMdNLhutlfsdi6 BI4mHvrtlNRFkHNLz2+G2EYJGYyHE05Cb2Rbq1cpAqclLUZqwa4YVB2XIBKcedn1CdKHJqbRKFp RwgkxS+2MRrGy5ToInWkMm2cneMKjBa2Qf4slqHlo4vaBmMN9MRlyFWlpp7AEGznVYLk1Dldm1j hdEfOJCSG/dKunsEKUiXb0+5feMBsHhvJt7sGR7SKis/0WnyaSX+24y2lFOH4Mn8DrdyUH0euQY wX/kXQGoACK81M299rTW9ERgK6t1h9v+ykXkx98L5rxYSRJaF23KhhuVrK1R9EnTXkCznArILSW xpoIX0xisN1d+4Rfr70pdW/CwIBnlKD8KvweBWK81QJvLK7G2Tx+VjA6rdtoE+P5NPGa0SuSYOU hD5JEyRoN6TWanFphgEZflDeGdQiEsm5jMIcUm+SpnPBMSIAj+2WwySQmMx2NUkJpzFizeJ75xq EKdm9d3ugTs+6/w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8340 The first section of the layers document shows how to manually create a layer step-by-step, and references bitbake-layers create-layer at the end. Change the approach of this section to show how to use the bitbake-layers create-layer command to create a layer, and then explain how a layer is organized and configured. This avoids repetition, and we should encourage users to use pre-built tools when they can do things in a less error-prone way. Signed-off-by: Antonin Godard --- documentation/brief-yoctoprojectqs/index.rst | 2 +- documentation/bsp-guide/bsp.rst | 2 +- documentation/dev-manual/custom-distribution.rst | 2 +- documentation/dev-manual/layers.rst | 266 +++++++-------------- documentation/kernel-dev/common.rst | 6 +- .../transitioning-to-a-custom-environment.rst | 3 +- 6 files changed, 99 insertions(+), 182 deletions(-) diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 84eb63c937..903dc242eb 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst @@ -452,7 +452,7 @@ The following commands run the tool to create a layer named For more information on layers and how to create them, see the -:ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script` +:ref:`dev-manual/layers:Creating Your Own Layer` section in the Yocto Project Development Tasks Manual. Where To Go Next diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 2a451b2139..8e332aec07 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -1154,7 +1154,7 @@ Use these steps to create a BSP layer: ``create-layer`` subcommand to create a new general layer. For instructions on how to create a general layer using the ``bitbake-layers`` script, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. - *Create a Layer Configuration File:* Every layer needs a layer diff --git a/documentation/dev-manual/custom-distribution.rst b/documentation/dev-manual/custom-distribution.rst index 0bc386d606..55854f00ea 100644 --- a/documentation/dev-manual/custom-distribution.rst +++ b/documentation/dev-manual/custom-distribution.rst @@ -27,7 +27,7 @@ layer. The following steps provide some more detail: just placing configurations in a ``local.conf`` configuration file makes it easier to reproduce the same build configuration when using multiple build machines. See the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section for information on how to quickly set up a layer. - *Create the distribution configuration file:* The distribution diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst index 667708e32b..15d54cc021 100644 --- a/documentation/dev-manual/layers.rst +++ b/documentation/dev-manual/layers.rst @@ -14,18 +14,6 @@ section in the Yocto Project Overview and Concepts Manual. Creating Your Own Layer ======================= -.. note:: - - It is very easy to create your own layers to use with the OpenEmbedded - build system, as the Yocto Project ships with tools that speed up creating - layers. This section describes the steps you perform by hand to create - layers so that you can better understand them. For information about the - layer-creation tools, see the - ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`" - section in the Yocto Project Board Support Package (BSP) Developer's - Guide and the ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" - section further down in this manual. - Follow these general steps to create your layer without using tools: #. *Check Existing Layers:* Before creating a new layer, you should be @@ -35,10 +23,23 @@ Follow these general steps to create your layer without using tools: the Yocto Project. You could find a layer that is identical or close to what you need. -#. *Create a Directory:* Create the directory for your layer. When you - create the layer, be sure to create the directory in an area not - associated with the Yocto Project :term:`Source Directory` - (e.g. the cloned ``poky`` repository). + .. note:: + + For information on BSP layers, see the ":ref:`bsp-guide/bsp:bsp layers`" + section in the Yocto Project Board Specific (BSP) Developer's Guide. + +#. *Create a new Layer:* Create the directory for your layer. The + ``bitbake-layers`` script with the ``create-layer`` subcommand simplifies + creating a new general layer. Place it next to the other layers in your + :term:`Source Directory`. + + In its simplest form, you can use the following command form to create a + layer. The command creates a layer whose name corresponds to + "your_layer_name" in the current directory: + + .. code-block:: console + + $ bitbake-layers create-layer your_layer_name While not strictly required, prepend the name of the directory with the string "meta-". For example:: @@ -58,88 +59,84 @@ Follow these general steps to create your layer without using tools: "meta-" string are appended to several variables used in the configuration. -#. *Create a Layer Configuration File:* Inside your new layer folder, - you need to create a ``conf/layer.conf`` file. It is easiest to take - an existing layer configuration file and copy that to your layer's - ``conf`` directory and then modify the file as needed. - - The ``meta-yocto-bsp/conf/layer.conf`` file in the Yocto Project - :yocto_git:`Source Repositories ` - demonstrates the required syntax. For your layer, you need to replace - "yoctobsp" with a unique identifier for your layer (e.g. "machinexyz" - for a layer named "meta-machinexyz"):: - - # We have a conf and classes directory, add to BBPATH - BBPATH .= ":${LAYERDIR}" - - # We have recipes-* directories, add to BBFILES - BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \ - ${LAYERDIR}/recipes-*/*/*.bbappend" - - BBFILE_COLLECTIONS += "yoctobsp" - BBFILE_PATTERN_yoctobsp = "^${LAYERDIR}/" - BBFILE_PRIORITY_yoctobsp = "5" - LAYERVERSION_yoctobsp = "4" - LAYERSERIES_COMPAT_yoctobsp = "walnascar" - - Here is an explanation of the layer configuration file: - - - :term:`BBPATH`: Adds the layer's - root directory to BitBake's search path. Through the use of the - :term:`BBPATH` variable, BitBake locates class files (``.bbclass``), - configuration files, and files that are included with ``include`` - and ``require`` statements. For these cases, BitBake uses the - first file that matches the name found in :term:`BBPATH`. This is - similar to the way the ``PATH`` variable is used for binaries. It - is recommended, therefore, that you use unique class and - configuration filenames in your custom layer. - - - :term:`BBFILES`: Defines the - location for all recipes in the layer. - - - :term:`BBFILE_COLLECTIONS`: - Establishes the current layer through a unique identifier that is - used throughout the OpenEmbedded build system to refer to the - layer. In this example, the identifier "yoctobsp" is the - representation for the container layer named "meta-yocto-bsp". - - - :term:`BBFILE_PATTERN`: - Expands immediately during parsing to provide the directory of the - layer. - - - :term:`BBFILE_PRIORITY`: - Establishes a priority to use for recipes in the layer when the - OpenEmbedded build finds recipes of the same name in different - layers. - - - :term:`LAYERVERSION`: - Establishes a version number for the layer. You can use this - version number to specify this exact version of the layer as a - dependency when using the - :term:`LAYERDEPENDS` - variable. - - - :term:`LAYERDEPENDS`: - Lists all layers on which this layer depends (if any). - - - :term:`LAYERSERIES_COMPAT`: - Lists the :yocto_home:`Yocto Project releases ` - for which the current version is compatible. This variable is a good - way to indicate if your particular layer is current. + As an example, the following command creates a layer named ``meta-scottrif`` + in your home directory: + .. code-block:: console + + $ bitbake-layers create-layer meta-scottrif + NOTE: Starting bitbake server... + Add your new layer with 'bitbake-layers add-layer meta-scottrif' + + In order to use a layer with the OpenEmbedded build system, you + need to add the layer to your ``bblayers.conf`` configuration + file. See the ":ref:`dev-manual/layers:adding a layer using the + \`\`bitbake-layers\`\` script`" section for more information. + + The default mode of the script's operation with this subcommand is to + create a layer with the following: + + - A ``conf/layer.conf`` configuration file with default definitions. + + Here is an explanation of the layer configuration file: + + - :term:`BBPATH`: Adds the layer's root directory to BitBake's search + path. Through the use of the :term:`BBPATH` variable, BitBake locates + class files (``.bbclass``), configuration files, and files that are + included with ``include`` and ``require`` statements. For these cases, + BitBake uses the first file that matches the name found in + :term:`BBPATH`. This is similar to the way the ``PATH`` variable is + used for binaries. It is recommended, therefore, that you use unique + class and configuration filenames in your custom layer. + + - :term:`BBFILES`: Defines the location for all recipes in the layer. + + - :term:`BBFILE_COLLECTIONS`: Establishes the current layer through a + unique identifier that is used throughout the OpenEmbedded build system + to refer to the layer. In this example, the identifier "yoctobsp" is + the representation for the container layer named "meta-yocto-bsp". + + - :term:`BBFILE_PATTERN`: Expands immediately during parsing to provide + the directory of the layer. + + - :term:`BBFILE_PRIORITY`: Establishes a priority to use for recipes in + the layer when the OpenEmbedded build finds recipes of the same name in + different layers. + + - :term:`LAYERVERSION`: Establishes a version number for the layer. You + can use this version number to specify this exact version of the layer + as a dependency when using the :term:`LAYERDEPENDS` variable. + + - :term:`LAYERDEPENDS`: Lists all layers on which this layer depends (if + any). + + - :term:`LAYERSERIES_COMPAT`: Lists the :yocto_home:`Yocto Project + releases ` for which the current version is + compatible. This variable is a good way to indicate if your particular + layer is current. + + - A ``recipes-example`` subdirectory that contains a further + subdirectory named ``example``, which contains an ``example.bb`` + recipe file. + + - A ``COPYING.MIT``, which is the license statement for the layer. The + script assumes you want to use the MIT license, which is typical for + most layers, for the contents of the layer itself. + + - A ``README`` file, which is a file describing the contents of your + new layer. - .. note:: - A layer does not have to contain only recipes ``.bb`` or append files - ``.bbappend``. Generally, developers create layers using - ``bitbake-layers create-layer``. - See ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`", - explaining how the ``layer.conf`` file is created from a template located in - ``meta/lib/bblayers/templates/layer.conf``. - In fact, none of the variables set in ``layer.conf`` are mandatory, - except when :term:`BBFILE_COLLECTIONS` is present. In this case - :term:`LAYERSERIES_COMPAT` and :term:`BBFILE_PATTERN` have to be - defined too. + If you want to set the priority of the layer to other than the default value + of "6", you can either use the ``--priority`` option or you can edit the + :term:`BBFILE_PRIORITY` value in the ``conf/layer.conf`` after the script + creates it. Furthermore, if you want to give the example recipe file some + name other than the default, you can use the ``--example-recipe-name`` + option. + + The easiest way to see how the ``bitbake-layers create-layer`` command + works is to experiment with the script. You can also read the usage + information by running ``bitbake-layers --help``. #. *Add Content:* Depending on the type of layer, add the content. If the layer adds support for a machine, add the machine configuration @@ -874,85 +871,6 @@ The following list describes the available commands: - ``show-machines``: Lists the machines available in the currently configured layers. -Creating a General Layer Using the ``bitbake-layers`` Script -============================================================ - -The ``bitbake-layers`` script with the ``create-layer`` subcommand -simplifies creating a new general layer. - -.. note:: - - - For information on BSP layers, see the ":ref:`bsp-guide/bsp:bsp layers`" - section in the Yocto - Project Board Specific (BSP) Developer's Guide. - - - In order to use a layer with the OpenEmbedded build system, you - need to add the layer to your ``bblayers.conf`` configuration - file. See the ":ref:`dev-manual/layers:adding a layer using the \`\`bitbake-layers\`\` script`" - section for more information. - -The default mode of the script's operation with this subcommand is to -create a layer with the following: - -- A layer priority of 6. - -- A ``conf`` subdirectory that contains a ``layer.conf`` file. - -- A ``recipes-example`` subdirectory that contains a further - subdirectory named ``example``, which contains an ``example.bb`` - recipe file. - -- A ``COPYING.MIT``, which is the license statement for the layer. The - script assumes you want to use the MIT license, which is typical for - most layers, for the contents of the layer itself. - -- A ``README`` file, which is a file describing the contents of your - new layer. - -In its simplest form, you can use the following command form to create a -layer. The command creates a layer whose name corresponds to -"your_layer_name" in the current directory:: - - $ bitbake-layers create-layer your_layer_name - -As an example, the following command creates a layer named ``meta-scottrif`` -in your home directory:: - - $ cd /usr/home - $ bitbake-layers create-layer meta-scottrif - NOTE: Starting bitbake server... - Add your new layer with 'bitbake-layers add-layer meta-scottrif' - -If you want to set the priority of the layer to other than the default -value of "6", you can either use the ``--priority`` option or you -can edit the -:term:`BBFILE_PRIORITY` value -in the ``conf/layer.conf`` after the script creates it. Furthermore, if -you want to give the example recipe file some name other than the -default, you can use the ``--example-recipe-name`` option. - -The easiest way to see how the ``bitbake-layers create-layer`` command -works is to experiment with the script. You can also read the usage -information by entering the following:: - - $ bitbake-layers create-layer --help - NOTE: Starting bitbake server... - usage: bitbake-layers create-layer [-h] [--priority PRIORITY] - [--example-recipe-name EXAMPLERECIPE] - layerdir - - Create a basic layer - - positional arguments: - layerdir Layer directory to create - - optional arguments: - -h, --help show this help message and exit - --priority PRIORITY, -p PRIORITY - Layer directory to create - --example-recipe-name EXAMPLERECIPE, -e EXAMPLERECIPE - Filename of the example recipe - Adding a Layer Using the ``bitbake-layers`` Script ================================================== diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 1e098c158f..2142d31c09 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -95,7 +95,7 @@ section: Support (BSP) Developer's Guide, respectively. For information on how to use the ``bitbake-layers create-layer`` command to quickly set up a layer, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. #. *Inform the BitBake Build Environment About Your Layer:* As directed @@ -190,7 +190,7 @@ section: Support (BSP) Developer's Guide, respectively. For information on how to use the ``bitbake-layers create-layer`` command to quickly set up a layer, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. #. *Inform the BitBake Build Environment About Your Layer:* As directed @@ -276,7 +276,7 @@ section in the Yocto Project Development Tasks Manual. The Yocto Project comes with many tools that simplify tasks you need to perform. One such tool is the ``bitbake-layers create-layer`` command, which simplifies creating a new layer. See the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual for information on how to use this script to quick set up a new layer. diff --git a/documentation/transitioning-to-a-custom-environment.rst b/documentation/transitioning-to-a-custom-environment.rst index e292399f43..bc37345b98 100644 --- a/documentation/transitioning-to-a-custom-environment.rst +++ b/documentation/transitioning-to-a-custom-environment.rst @@ -56,8 +56,7 @@ Transitioning to a custom environment for systems development #. **Add a new layer for any custom recipes and metadata you create**. Use the ``bitbake-layers create-layer`` command. The ``bitbake-layers`` tool also provides a number of other useful layer-related commands. See - :ref:`dev-manual/layers:creating a general layer using the - \`\`bitbake-layers\`\` script` section. + :ref:`dev-manual/layers:Creating Your Own Layer` section. #. **Create your own layer for the BSP you're going to use**. It is not common that you would need to create an entire BSP from scratch From patchwork Wed Dec 24 16:31:38 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77449 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 5D0E0E776E0 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123188.1766593916825596319 for ; Wed, 24 Dec 2025 08:31:57 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=BW9Bb/RS; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 542731A23E0 for ; Wed, 24 Dec 2025 16:31:55 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2C2386073D for ; Wed, 24 Dec 2025 16:31:55 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7618110AB1366; Wed, 24 Dec 2025 17:31:54 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593914; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=8doD9MXUF/cmtB32RchDFBrW7OUWWb2kwT/TlYo13FI=; b=BW9Bb/RSOGwWEJ2KAN6ea3+CLHa72u7F03IRuiN86Pyl1akaC9LYjXZfA0ol5dR82EW4ul Kba2vcymUEeD3WnGWNSOx5R7ul3J/0Q1meUbBrLp9bQLSHQeSShiwRpbaXwXc+JSRyztnp JQONOEyojELMAb3hHLCGFdZ4WMIC5ea8D5+ORqBDzKZ4VWzVgCaXuSDtfvxEFG09mm2bJf RFv1Xxx6WjwzDTRbWt3nTPapi4AKK0paYH4Kk2xPppWNy4ccrUc5fOLhYYkq7CcaskS7A4 RX2CusAB1+S9WKSTTUSMqXqxwOH5tcQ4TF92VtVc9CyWDNw5vJlaZmLD4JZXjA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:38 +0100 Subject: [PATCH 12/53] dev-manual/layers.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-12-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4242; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=JMSddOH0bYa1FREUbxXrBhCgxuUzRyhv+DpG09TSyF8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVoUO4QIVWQYXUuprQO6fU7YcwyBnRNV3RJO SIETdrZJuaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaAAKCRDRgEFAKaOo NgTqD/97G8gpIYosNxUp9DL/5dtLGlev6MJKU2u8e8oQWdc/5P4KnLmLxxCNJClZFbNg0GFEbix ykkg/Z+OZhEkF5RTLdvqReVl4dJQEufFrrXUDLgtQV7/7+UZpA5nd4JjLC/YAnrht270bUZK/De PVr7U5VBlRI5oCV8abcIvrxfdGi1GILddWmxXk7moMLCkk0j5ojYiyJ6YpxzH/IRbBasfrQZLDZ 030c7+I1L8G/z0upiK4Maz1ZYx4rii3CwWmficQm/+96kgV9ULVkNlJK/nYm/Z4DgxEGFa1hhr8 nXb6IqpvyAcCslTSsVhxHFEakgHqUTGdrjjKuZgfi19lmqdxw3nBJblJCKJ9Y827+Hw1icPdm9+ XDV6THDlyWnICk6P1o6WwWcf+h39ANTrXEWiJ9y6Jlo1Jpf8UGvoVrsbN6z7pH2mvtpyFMZWMS7 wU/rP5Z/M41+PHBIh9q3PslnUSzeYnVownruN0ErB8MVDNlbAvO5aozQI0LGmZw62/3OFRbaA/I 9UJGSavCUW6U7UtXnpDUgikkAaXJbvfHQE1BHMeE+UEZO+9cuyu3KaMKW0tXigXAQiPFdY3gj1m vrsjqhjdKshdfUgowxFXkEKbhTd1Sr+klcDQqlaWeOCFTlV+YNObOnvXasHJj8dM5VwQ9gzFDBQ Kb9+E6HSa4AjR9Q== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8341 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/layers.rst | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst index 15d54cc02..49e17c0fb 100644 --- a/documentation/dev-manual/layers.rst +++ b/documentation/dev-manual/layers.rst @@ -279,7 +279,7 @@ following list: repository that use the ``meta-layer_name`` format. - *Group Your Layers Locally:* Clone your repository alongside other - cloned ``meta`` directories from the :term:`Source Directory`. + layers in your :term:`Source Directory`. Making Sure Your Layer is Compatible With Yocto Project ======================================================= @@ -518,10 +518,10 @@ possible. Overlaying a File Using Your Layer ---------------------------------- -As an example, consider the main formfactor recipe and a corresponding -formfactor append file both from the :term:`Source Directory`. +As an example, consider the main ``formfactor`` recipe and a corresponding +``formfactor`` append file both from :term:`OpenEmbedded-Core (OE-Core)`. Here is the main -formfactor recipe, which is named ``formfactor_0.0.bb`` and located in +``formfactor`` recipe, which is named ``formfactor_0.0.bb`` and located in the "meta" layer at ``meta/recipes-bsp/formfactor``:: SUMMARY = "Device formfactor information" @@ -598,8 +598,8 @@ Installing Additional Files Using Your Layer -------------------------------------------- As another example, consider the main ``xserver-xf86-config`` recipe and a -corresponding ``xserver-xf86-config`` append file both from the :term:`Source -Directory`. Here is the main ``xserver-xf86-config`` recipe, which is named +corresponding ``xserver-xf86-config`` append file both from +:term:`OpenEmbedded-Core (OE-Core)`. Here is the main ``xserver-xf86-config`` recipe, which is named ``xserver-xf86-config_0.1.bb`` and located in the "meta" layer at ``meta/recipes-graphics/xorg-xserver``:: @@ -886,7 +886,9 @@ Add your layer by using the ``bitbake-layers add-layer`` command:: Here is an example that adds a layer named ``meta-scottrif`` to the configuration file. Following the command that adds the layer is another ``bitbake-layers`` command that -shows the layers that are in your ``bblayers.conf`` file:: +shows the layers that are in your ``bblayers.conf`` file: + +.. code-block:: console $ bitbake-layers add-layer meta-scottrif NOTE: Starting bitbake server... @@ -894,14 +896,13 @@ shows the layers that are in your ``bblayers.conf`` file:: Parsing of 1441 .bb files complete (0 cached, 1441 parsed). 2055 targets, 56 skipped, 0 masked, 0 errors. $ bitbake-layers show-layers NOTE: Starting bitbake server... - layer path priority - ========================================================================== - meta /home/scottrif/poky/meta 5 - meta-poky /home/scottrif/poky/meta-poky 5 - meta-yocto-bsp /home/scottrif/poky/meta-yocto-bsp 5 - workspace /home/scottrif/poky/build/workspace 99 - meta-scottrif /home/scottrif/poky/build/meta-scottrif 6 - + layer path priority + ========================================================================================== + meta /home/scottrif/project/layers/openembedded-core/meta 5 + meta-poky /home/scottrif/project/layers/meta-yocto/meta-poky 5 + meta-yocto-bsp /home/scottrif/project/layers/meta-yocto/meta-yocto-bsp 5 + workspace /home/scottrif/project/build/workspace 99 + meta-scottrif /home/scottrif/project/build/meta-scottrif 6 Adding the layer to this file enables the build system to locate the layer during the build. From patchwork Wed Dec 24 16:31:39 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77453 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 66B3AE776E2 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123190.1766593917852923655 for ; Wed, 24 Dec 2025 08:31:58 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=NTq9N1m+; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 5C5961A23E1 for ; Wed, 24 Dec 2025 16:31:56 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2D3316073D for ; Wed, 24 Dec 2025 16:31:56 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 186CB10AB1371; Wed, 24 Dec 2025 17:31:55 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593915; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=sYANjGp7xZngddTZryLBh53DHF1xFrsLNgQtAhIN/Fk=; b=NTq9N1m+BU/ZVGPMw/J1oKUxCYJX6aGfhj+TYIK5rdiAgaEjh5Njni15hhRmeD+SelcmjP GByFkfAs6RXzuAxpOnsowjerhnMqhb5ulqHVRVmq4cMvXzIZbd5GWP1WolE4lNhpokgt1/ +dE+EfHu5x5gOUV/58mahEZUSpkvL25fqE0o0nk7kgTPGxcG7atuoWpm4yDMNZQ17ywpQd 3YXvoGYpUrYXgwDCxHV7iMaC8kyUyeN4mhbpA4rHkpR6KAP3gOj90tALlLFbQyUbuhaOIH LkaTINQYNtSi32O2OQlmvanH8azEEFHL9c4wDDn5SGnqgNB5ESQM6HA3Ko9BeA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:39 +0100 Subject: [PATCH 13/53] dev-manual/libraries.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-13-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1583; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=hIpMky2f0WYKueMG+OJk7gMtjppBoTXKU+VAUH2LICY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVoh9rb4kh2lycIfSqbjVdUrUgbOLt39WDIQ nqtkmCWdaiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaAAKCRDRgEFAKaOo Ntc8EACjbOCqW2070/GZdbKYXs8dXstshLCzkcPy3xY7eOGEqhwnTRkn99+fzGuOy3+KEf+fk6P CTJ1TO6I/pyExDaJ4Umr6zXnWJhYzhUEKxqnlHD1CJaf5Fl3RGIef1Zv0UZI3Ehpy7+ZWfeOk6N VFC4EXMnUEwJw/mYmUbLO+56q9olv70Agzt06W1l+crnPhBmGwwfNhrWookki1q1SvBYXTK9+1I +HWB5EQ/xdTA4ZABMjZZ0ilrzWbbU+K40ewFMoYjxX0uDL92e89QVk5HsL0xhQxFhllvhuTF9QC Az0Va6u5osuUbZui42mRA8K6d+9oGcblslnx/KLZTYzruZm4tWe5R0y8JqDVdhkv4zVgbulTPQK JNnTZt8HAyyBz56c+p4/YrvAsbbUPYR2hcEb/pEILFz5r5gB+mA6/4FhRgaKjYJ58M9FLIPNCpi xWKmGiDE0C/Ag6RZkOHLUIAGR3U23/ZfgU3NLX21LNY1mxEW6V2kAx/UWZSpZA8hT11ipUOrI8w DPwZj4JTlwyzWSKFrgteK88qaHGJY3YdYegcM82gmUs59IXdDH1QzKbWoItxRkjjaQisX7j5gc6 PdDty4a9LDkM9LBzqgYOlDxNEeB6WiptGDwvG1epMm0o/7Kd4xD9ZyNhrWT79ZXWt49gk1yLvon CMJF/+qU8oCmG0w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8342 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/libraries.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/libraries.rst b/documentation/dev-manual/libraries.rst index a8c38128e..697ea48e4 100644 --- a/documentation/dev-manual/libraries.rst +++ b/documentation/dev-manual/libraries.rst @@ -68,8 +68,8 @@ libraries and other binaries to use a different set of libraries. The libraries could differ in architecture, compiler options, or other optimizations. -There are several examples in the ``meta-skeleton`` layer found in the -:term:`Source Directory`: +There are several examples in the ``meta-skeleton`` layer found in +:term:`OpenEmbedded-Core (OE-Core)`: - :oe_git:`conf/multilib-example.conf ` configuration file. @@ -90,8 +90,8 @@ meet your needs. In order to enable Multilib, you first need to ensure your recipe is extended to support multiple libraries. Many standard recipes are already extended and support multiple libraries. You can check in the -``meta/conf/multilib.conf`` configuration file in the -:term:`Source Directory` to see how this is +``meta/conf/multilib.conf`` configuration file in +:term:`OpenEmbedded-Core (OE-Core)` to see how this is done using the :term:`BBCLASSEXTEND` variable. Eventually, all recipes will be covered and this list will not be From patchwork Wed Dec 24 16:31:40 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77451 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 59BFFE776DE for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123191.1766593918562805266 for ; Wed, 24 Dec 2025 08:31:58 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IBXtAyMo; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 19CE21A23E2 for ; Wed, 24 Dec 2025 16:31:57 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E4A726073D for ; Wed, 24 Dec 2025 16:31:56 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1E62E10AB1378; Wed, 24 Dec 2025 17:31:56 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593916; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=9rXbmi+pXbwoBsZf9sie/zVf3pxqpn3q0xT9aueXStw=; b=IBXtAyMoVhq7cAT0xk30jw9oWrI7iCKAk6sQc0jYdLBX2qiVQ4Ujqa28v3NNa7Uzp83gak IfgZvHuUYF+QOuoa5YYlPxgadz7QKlHhCZmUtDnFmrJspc6RIwfphhf5iMuGGWpYRWqD6e 0uPpW0KnITKgiecjMb/xC0Naa/vmvJlNwXBre3qNBaEcflklfgvvbaa0Mq0R7c593T5pxq COAhrsXjsWkQrdrUze2cViNWjHYQOScqBwtJI97Z24MMla+5OfQ8nGil618TzMgLBr2uBE AOGPeWvqGXfFUtw2vm3SmrB05xzbj79yIOX9HUNAcWmyMZIguXBvwMb2Z75Cpg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:40 +0100 Subject: [PATCH 14/53] dev-manual/new-recipe.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-14-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2996; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Ez/DYSVz6JaaGbF1LP3kFPpnvBj8qaqVV6JWU1IkQLY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVpmUsgyScYk1PxoEYyiPviEv1iwRWEybueN l6RSEV/rO6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaQAKCRDRgEFAKaOo NsXCD/9iTG7PPKKvgOQTu8MqLyjEcv6hk2oXjRuc1wqAIjPQ6hn08KKCRDDeEp+hEQyZUXYcoMv ESP3TEvpJ8PZvRJnKTop924qSAgJ8rVbjLbk8cXTOxG03evdxDR/VrDnjuD/GLxIK8qrnKym/m1 Bvq/p2oEhJ7wqX7tCo8hF/knQ8KEBszGHplqxO3es/MLA3X/kwUnidEsdD+vm6lx5Y6nUEkqAEZ FuB+ept9R42vuDoob4TUjznaMxaBk6aCZWe4yrp5zq32xxlMbCOD9kOR/29ut45Y1L8WbxxqejC rvemIlFQ2qn4fjQft9HetSnXW27/nLyZ7do9bA0XYOsVaYZJFo3AMFF0Y+nZ7apmhXqiuULkR5+ 9i878ljnttJEpieS4CByxE2aKiTIqjZiPQ4MnK5SGbfpwI7U/UaDksomrnA8IBd/MCkpV0izs4d BiySx1yjBk/5so3emugv5PjcxdKCDGxM0w6tnG3cD+EysaGLrj/JScPln37VJFp/mmFT4g5+zbT RtQQRCwiJJ8vv/8sOagpsWSqYlT1Rk9F2SVIP0UmPFRsckNDJBsOkE8h9UepIYPT4RjldHVu14v l/xCAqQM6dr8OM9IS9a2TrP1TlxEEiaObHg195sTj3vpeVMch6cJMmJY+fZAwJUQlgg+xy9uTdR 3BSyXCSfEMyQL4Q== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8343 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/new-recipe.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst index ee0f6aaf6..38485da7e 100644 --- a/documentation/dev-manual/new-recipe.rst +++ b/documentation/dev-manual/new-recipe.rst @@ -224,14 +224,14 @@ is to use the ``bitbake-getvar`` utility:: $ bitbake-getvar -r basename WORKDIR -As an example, assume a Source Directory -top-level folder named ``poky``, a default :term:`Build Directory` at -``poky/build``, and a ``qemux86-poky-linux`` machine target system. +As an example, assume a :term:`Source Directory` +top-level folder named ``work``, a default :term:`Build Directory` at +``project/build``, and a ``qemux86-poky-linux`` machine target system. Furthermore, suppose your recipe is named ``foo_1.3.0.bb``. In this case, the work directory the build system uses to build the package would be as follows:: - poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 + project/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 Inside this directory you can find sub-directories such as ``image``, ``packages-split``, and ``temp``. After the build, you can examine these @@ -240,7 +240,7 @@ to determine how well the build went. .. note:: You can find log files for each task in the recipe's ``temp`` - directory (e.g. ``poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0/temp``). + directory (e.g. ``project/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0/temp``). Log files are named ``log.taskname`` (e.g. ``log.do_configure``, ``log.do_fetch``, and ``log.do_compile``). @@ -830,7 +830,7 @@ different ways: To enable a service using systemd, your recipe needs to inherit the :ref:`ref-classes-systemd` class. See the ``systemd.bbclass`` file - located in your :term:`Source Directory` section for more information. + located in :term:`OpenEmbedded-Core (OE-Core)` section for more information. Packaging ========= @@ -974,8 +974,8 @@ being able to provide the ``virtual/kernel`` item. Now comes the time to actually build an image and you need a kernel recipe, but which one? You can configure your build to call out the kernel recipe you want by using the :term:`PREFERRED_PROVIDER` variable. As -an example, consider the :yocto_git:`x86-base.inc -` include file, which is a +an example, consider the :oe_git:`x86-base.inc +` include file, which is a machine (i.e. :term:`MACHINE`) configuration file. This include file is the reason all x86-based machines use the ``linux-yocto`` kernel. Here are the relevant lines from the include file:: From patchwork Wed Dec 24 16:31:41 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77445 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 5248FE776DC for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123721.1766593919315974244 for ; Wed, 24 Dec 2025 08:31:59 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=0+g1OQ/4; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id BCD821A23E0 for ; Wed, 24 Dec 2025 16:31:57 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 92AD06073D for ; Wed, 24 Dec 2025 16:31:57 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E573A10AB1374; Wed, 24 Dec 2025 17:31:56 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593917; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=cActp0qE5HPAVpUObn5O1e0jNRNpUZO6CuJ76Ks9FbI=; b=0+g1OQ/4Wga1HlUigrcr5+do2QPdJxBa6JfnAK36Sn3GbZFNS7kvb3e9+Yt5iCOoVcut5e sS3+nEqUdwn9HblV4fFWWRfk5HKwWarUxBvLjKB4H3BGDzVPQ9zhHG98xazwSVYe49FmCx h7bQLoPUR/f9fmcVqfNx/iiN6uObr5YD7BDm+t9X/dDZXOs7TY2W2ZfBEOBDxMPWQqqM7l 5XeAs5j9I87yv1bkhGjovz692BETsvfXh6YaqH10YenOhneP53SlVREa6wcH4Ta9k4MRzW /BzTtgDD0EGeW+PwUKgeZp3U6eLPQWCbpGROGBiUKkt3D2yvZj46NtMhigPmXA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:41 +0100 Subject: [PATCH 15/53] dev-manual/securing-images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-15-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1353; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=krmMZC0FI55+Y1aYcMdMHagYGDWQ96yeNFo4ks4blTc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVpjgvRDuy2fl/Bs6ErcNivlVrai4VXBXGhf /Op8BvDfb2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaQAKCRDRgEFAKaOo NoeREAC4cZG1CkdlSgDugEtTNm/jCVW6fu17qTf62VIGETDaRzutisMIul7hAfQnihxKRfUPxVT osSjVzL04kJeLQ0x+4xx/iUmV8+NUHZyT6fNqRbL5YqfE1bp9Z1txKZzzvagluV6v4hUL4NHmQf DFW64nrehgxsyhLp8vrWviAdh0N2Qa3ligUOjJ0BD5RnX/pG4oXMlJp+A3b3McsuwmZsKFN9civ uZ01duDHaOqWSg2ANs5NAWAiJz86EACI4NH0h5+uRprLTPwVP3Gvr1aEsmVPAF4HX8h5E/2Zl1q fYtB1RUUsIQVb7VGnIdyDJRAA5921r4ciGYivDSuCHLLTYy7GE3KPN1fIDRxv6jQycGhSc6gaFM mQT7eTm5KwEup3RS3lqSZQCfOE2QrReOeILtOTga0JD+GQqdEI3srG+Sly5Y/ppAoUlymxns7Jy wbt8nMEvpaLUN564Uzx3eWYgFZK5cmu1CTVma8a3v+pWDblIRYUDGh4cOC4nI3oMNjrXJw7Vob6 zffPe7zZaZ90luxMNLuZAemdTt5lJfO+doocqElYNSvRLvuLflIIwVOqA4sAh1kKK9K75u/UNOG MWx8FIrtWjln06RcMSSfG0UuE+QGSatRNSk5MoNP6LaFR5+pDrJo3iO8xWgSSupTTyEV3i0wLF0 YNORCeHLj5kqNnw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8344 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/securing-images.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/dev-manual/securing-images.rst b/documentation/dev-manual/securing-images.rst index f4b528e55..31c945367 100644 --- a/documentation/dev-manual/securing-images.rst +++ b/documentation/dev-manual/securing-images.rst @@ -66,7 +66,7 @@ more secure: - Regularly scan and apply fixes for CVE security issues affecting all software components in the product, see ":ref:`dev-manual/vulnerabilities:checking for vulnerabilities`". -- Regularly update your version of Poky and OE-Core from their upstream +- Regularly update your version of :term:`Poky` and :term:`OpenEmbedded-Core (OE-Core)` from their upstream developers, e.g. to apply updates and security fixes from stable and :term:`LTS` branches. @@ -88,7 +88,7 @@ Security Flags The Yocto Project has security flags that you can enable that help make your build output more secure. The security flags are in the ``meta/conf/distro/include/security_flags.inc`` file in your -:term:`Source Directory` (e.g. ``poky``). +:term:`OpenEmbedded-Core (OE-Core)`. .. note:: From patchwork Wed Dec 24 16:31:42 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77447 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 4D42AE776DA for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123192.1766593920344891774 for ; Wed, 24 Dec 2025 08:32:00 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=yskUYDOh; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id BD20F1A23E1 for ; Wed, 24 Dec 2025 16:31:58 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 958366073D for ; Wed, 24 Dec 2025 16:31:58 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 88C9C10AB1376; Wed, 24 Dec 2025 17:31:57 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593918; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=kZjamFuUo+c8/fIQjVlrN5ziCHXULm2JdPyKNfaNbow=; b=yskUYDOhYlrJizYcYLDSAo6AHrI0XRAdvjzaqS78Iyc6cfEGggVktElJLhW0X6tCOcb2eT q5b8308HzQVwZfxxKL7+qE6RQ0iQhGrQszA+9i3IqnujNee80sjNvkx+xFs2Cg4qb7dWar DC9FS7AX+UOJp1dmE7SW3WLDkChrdezAgrlAdhvN9zsaOAc5HutZat1BNVBgUTMRvQ6X6P m6qX8E/B6jnIaEEMwW/puOQqqvtyuWFZHtlD9qWAWGHTkbZyQldBZa2pDRNlIr+yZQSasz QRrfF0k4aqy0uIC2WP+s5BhKm/zJp/mF2+ZS+b5s82mxKslgADxLJVJnKSkmAQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:42 +0100 Subject: [PATCH 16/53] dev-manual/temporary-source-code.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-16-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1065; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0YY3dfY1jC83tdYBcBJtKiK8BumJMfizXZjvaJN1zeQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVpNmLRELEMVNJ365P+onVSfRlpek2JjHn4L 491BJ8uDYeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaQAKCRDRgEFAKaOo Nv+QD/4xEmGGJNvycZnA90mw1baRBTCt9+0O5y3z81WA2pGyQcaqECUDHc4s+9V3EakOVbI9+8Y yI6Z0IxWYK/JKC8hbFleTncNCzbSuKPyvCO+YccpPClDo1KgYSUwXACR1welEHyN497d97Lofz0 Lbqtlwc6wUhQMmsG+n2Qaf13kfTGhMCphwjA6v/8iO1JNMgEfinJG4bCtcoxiKYFX6qr4wCwg5p NinmnmfB3Bbt1rG6vqCneM/NDgLNrP0uelBz6aYqYS2IfK3X8kJT6uK6ccg180ZJlmqRWa1VAyF /u+LemDkdSKbc7MDht75fHNVz+XJ6a/88IZJQrB0rCEWyRJDXEDtogK+V3WLB2dtnmxUtt/CnKb k8QUvBlOO30pFu3X6EzGWJcDjb1nrSqIA5eow1pPkN3bD9eVlcf1D7E01/mAXopO9NqOXaOiR93 e5bLCka6++DpwPodlvfgc6279UDzWlHmLW21YqCcgBjSIL7frTxy6jdPDrVaEclOmUfBP0ZIwrA AKNn3j69lANr2UUZC029jFplfjBja/OIl4Wr85vcqRwQYNjEa0/Dd4AccKX6eUwjFcntQ4Yvh3V gp9FGWMe04GmhxpJikLR1X9zGLEbMoOUtd+Mch9mrpE/uTi0YXbvA6G/+jg5k8Gmi+aMi2zYiLg d9KIlriDGKUVLVA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8345 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/temporary-source-code.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/dev-manual/temporary-source-code.rst b/documentation/dev-manual/temporary-source-code.rst index 977edbc3f..aecd34099 100644 --- a/documentation/dev-manual/temporary-source-code.rst +++ b/documentation/dev-manual/temporary-source-code.rst @@ -15,8 +15,8 @@ your changes in the form of patches. During a build, the unpacked temporary source code used by recipes to build packages is available in the :term:`Build Directory` as defined by the :term:`S` variable. Below is the default value for the :term:`S` variable as -defined in the ``meta/conf/bitbake.conf`` configuration file in the -:term:`Source Directory`:: +defined in the ``meta/conf/bitbake.conf`` configuration file in +:term:`OpenEmbedded-Core (OE-Core)`:: S = "${UNPACKDIR}/${BP}" From patchwork Wed Dec 24 16:31:43 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77446 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 460C0E776D8 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123193.1766593920756845286 for ; Wed, 24 Dec 2025 08:32:01 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=VT19K6Uv; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 403681A23E2 for ; Wed, 24 Dec 2025 16:31:59 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 11B636073D for ; Wed, 24 Dec 2025 16:31:59 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7D50710AB1375; Wed, 24 Dec 2025 17:31:58 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593918; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=hShQj0ajX7yakaZ9a8Q8qmsSW6JV8k9jW/Aw3tsqYJ4=; b=VT19K6Uv4IZAD0YDtOcYBOghE0uYYghrufWreoXnSUmzBctRGU+cgwThLgLDOSgfK0AV9z Q89UXpoCLYd3Dsr8dT6Swlju1w/lPZ7lliGXI5yZoBjXo8MPES/ZeTz4aO/MjZVG19njGn xfpBFxV7otHPkWUPVKp3ubsin2GeOX3Mc50iRXklerV3etigUhvOm9zm8jXjc+NHfoMOrk ikAIMj0nL9iDW8mBf+id7+qRMjeYjJJfWCybp3xekxfOQobupdY7xPuDsndaoJ1ZcjDIwH ncAa9N/UPn0UCD+c8a2u5Y2nZbtNIcFyoDAd48eRloC02CiGlurcWM53JAvaIQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:43 +0100 Subject: [PATCH 17/53] dev-manual/wayland.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-17-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=966; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=l5x8Azoxn1j61Nhg5mcFN7odGREhusIhwsltmvNoQ38=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVpA2RhbA31l62PbkyzpmL16srAueWI0aYCp Nn3cHVdCBuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaQAKCRDRgEFAKaOo NvBeD/wP/QtyuruUCRBGok+bS/sCyDxtEjyFIS4KgZMqWxKhBluFXM9QSc9G4WBwRaWrTSodoy0 jpDQOvUoTgtvdhPdJF7gAdtURXhpE58hxOM72++xIXmzjOqHigu8Rs6DhParwqpiQqpW6640V+W mmPQIIBKf9vFoVfxNaIu+gZE+/EE3k7ec35njzki5GGs39nwyVlbtImYGD4EjA8fURypyXUE/lL Q+TFJ0Xne02+ECJiwcxj6a5HgQ5KN18dorUs3QEyi2t/hvYWImOdP4jeyiWKA8evdfDDAEcfbzJ jKt3Akiw+LPK3buTeJui0g8kIY/H2FnQwdyyDxv9ofGp9fBwrxyZmZqX4j///Rd3cmGXScmpu++ mL6rxpxxktsiTtN4XeOE9baik48YvocUH/bEz0C6TydrbtNmO2BaOp0mRoPlM7k8dBju4VQSp+M HtBQBTyXc/9EcPZVe4eCBuKRfETupYg5j2il/Jove2dhSeQ91bacmqmWA7KaeYEMc/5dGymgzLq IZgeI/oW7i8KnWHBWjxkdU3FdD2dq6WG5rtAC12MO0yAMt1k6g02ZADX0Ap1nnNACZcnUpOPqms lySf2z9+pnQB5oe7KtZJXZvr+19GbbhOvBYrdjoLiqixPNgK0Fo82FdEJdFxntxVwY4TajBUty+ ZplBJ4RNEY8zuDQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8346 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/wayland.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/wayland.rst b/documentation/dev-manual/wayland.rst index 097be9cbde..18d1bfb0a6 100644 --- a/documentation/dev-manual/wayland.rst +++ b/documentation/dev-manual/wayland.rst @@ -14,7 +14,7 @@ might otherwise achieve. The Yocto Project provides the Wayland protocol libraries and the reference :wikipedia:`Weston ` compositor as part of its release. You can find the integrated packages -in the ``meta`` layer of the :term:`Source Directory`. +in the ``meta`` layer of :term:`OpenEmbedded-Core (OE-Core)`. Specifically, you can find the recipes that build both Wayland and Weston at ``meta/recipes-graphics/wayland``. From patchwork Wed Dec 24 16:31:44 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77444 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 392BFE776CA for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123723.1766593921718427503 for ; Wed, 24 Dec 2025 08:32:02 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=xBSHA8Vz; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 243E01A23E0 for ; Wed, 24 Dec 2025 16:32:00 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E9BFC6073D for ; Wed, 24 Dec 2025 16:31:59 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id F10A210AB1377; Wed, 24 Dec 2025 17:31:58 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593919; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Gf7yvHLtcjT3PBFqbIxQ8c/I43uDHaOIQrS1Ftro02M=; b=xBSHA8Vz+sNLhvTHlhm9xVGdCSwOlUD8ZblGAv/ZPJdksODyBWjsJDsnaGJoimvEBf8iXn Txn9QFUp0pv1UowvB9mDevs9fr/EARC5T38sQNkNAIFuUEWnEqzGIHNhfsAMymx6yQVPFN KkpA3eV9Z7/fEPkHAloa3UEc745VZTQLoTcCBJAeVh5n5GwXBxKjvJlceZKGy1gjfoz1Y7 gYr5fA9GRNLkloNcHthBwXVxHpWoPb8jTpDHi8lCy6BzIjrIaAckuTeET3xTPRQnWJOZXC 7LpjSG5rWoOanPyMDjNPNLWEP1bmbArawz/Ywelnq2XPwN+vb14sDCXdv1x5kA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:44 +0100 Subject: [PATCH 18/53] dev-manual/wic.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-18-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4336; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=ZMGJafFLdydo+qP/KjcapQWxeXXebc3LKsw8reGIWlQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVphMgbhzH//l77lBQ+1A6SOIU6imGytQ/tf u4g+PlHcg+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVaQAKCRDRgEFAKaOo Ni4uD/sG0PtqM+Af5OJ25Sj5qGAmmzPtBhVZvVpud81VNxKCRhYmFRarLrXgyEGTP1RwzCIvOcb /XJa6h5f8phEKG4MA+j0NE64whibJwRQ7RJo8E4LVV1Ip0OAZb4ZUJURmn7UyTISbX8MJmmCIiv 30kcLtT5IPX4UO72W8/asy/kRO2OZ2oB339HEk0RCNgsPiPGbAXOw1c6CNfsFzis9aEko5Rpv3a uK6IDyEzdxNV5CuwmlHmNvASmJIve3mRS3tR5pEoJrZCiM/NDsFENLcQUOTHN98Ju2Vr2Cdlox9 NnSKo3vQ9K5vHwcX3xnBLT7JaLe2UYmPW1PuPt3qPt6Wsr9AzYUgPUQCFjRw5G5ZiboPejeSUKh EzqA6Pw1E/ggqa/uWlXpj9KClcbf+58RU2fcskbctt1QItOYmAPxDy1rTuUXn+tCHIftJBW37Dp 2L7VTTMSX7oIyUUPSmnEK+ytERdKe35P2Jbvxs4lUJ7VzrEd0lbDu5MmMeyWAOrbOAelThuNIWS l1RSNpLCFZ5Idedx+c4hUOYvZR3FtrFAgIC+tdfZR8ynewT2JvSB5O8rzf7ik+UOSSvgAfiUa6h dZIleRtfb5JRY2dxf70o7NqeKUeVuGNGy5iD7akqZ4BqJkV6/GiGn1DCBAeAfQpFZMqU3Afz48g XfkFvBIbs+9rjwQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8347 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/wic.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst index 07170537b..a7c4ca06a 100644 --- a/documentation/dev-manual/wic.rst +++ b/documentation/dev-manual/wic.rst @@ -276,8 +276,8 @@ existing file provided by the Wic installation. As shipped, kickstart files can be found in the :ref:`overview-manual/development-environment:yocto project source repositories` in the following two locations:: - poky/meta-yocto-bsp/wic - poky/scripts/lib/wic/canned-wks + meta-yocto/meta-yocto-bsp/wic + meta-yocto/scripts/lib/wic/canned-wks Use the following command to list the available kickstart files:: @@ -342,12 +342,12 @@ partition. Source plugins are subclasses defined in plugin files. As shipped, the Yocto Project provides several plugin files. You can see the source plugin files that ship with the Yocto Project -:yocto_git:`here `. +:oe_git:`here `. Each of these plugin files contains source plugins that are designed to populate a specific Wic image partition. Source plugins are subclasses of the ``SourcePlugin`` class, which is -defined in the ``poky/scripts/lib/wic/pluginbase.py`` file. For example, +defined in the ``openembedded-core/scripts/lib/wic/pluginbase.py`` file. For example, the ``BootimgEFIPlugin`` source plugin found in the ``bootimg_efi.py`` file is a subclass of the ``SourcePlugin`` class, which is found in the ``pluginbase.py`` file. @@ -527,8 +527,8 @@ This next example demonstrates that through modification of the As mentioned earlier, you can use the command ``wic list images`` to show the list of existing kickstart files. The directory in which the ``directdisk-gpt.wks`` file resides is -``scripts/lib/image/canned-wks/``, which is located in the -:term:`Source Directory` (e.g. ``poky``). +``scripts/lib/image/canned-wks/``, which is located in +:term:`OpenEmbedded-Core (OE-Core)`. Because available files reside in this directory, you can create and add your own custom files to the directory. Subsequent use of the ``wic list images`` command would then include your kickstart files. @@ -542,8 +542,8 @@ The example begins by making a copy of the ``directdisk-gpt.wks`` file in the ``scripts/lib/image/canned-wks`` directory and then by changing the lines that specify the target disk from which to boot:: - $ cp /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ - /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks + $ cp /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ + /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks Next, the example modifies the ``directdisksdb-gpt.wks`` file and changes all instances of "``--ondisk sda``" to "``--ondisk sdb``". The @@ -580,7 +580,7 @@ Computing (nuc) :term:`MACHINE` the NATIVE_SYSROOT: /home/stephano/yocto/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native INFO: The image(s) were created using OE kickstart file: - /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks + /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks Continuing with the example, you can now directly ``dd`` the image to a USB stick, or whatever media for which you built your image, and boot @@ -717,7 +717,7 @@ the existing kernel, and then inserts a new kernel: kernel:: $ wic cp poky_sdk/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+git999-r0/linux-yocto-4.12.12+git999/arch/x86/boot/bzImage \ - poky/build/tmp/deploy/images/qemux86/core-image-minimal-qemux86.wic:1/vmlinuz + build/tmp/deploy/images/qemux86/core-image-minimal-qemux86.wic:1/vmlinuz Once the new kernel is added back into the image, you can use the ``dd`` command or :ref:`bmaptool From patchwork Wed Dec 24 16:31:45 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77450 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 392F9E776D3 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123194.1766593922325848218 for ; Wed, 24 Dec 2025 08:32:02 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=THx04s/9; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id D12F01A23E1 for ; Wed, 24 Dec 2025 16:32:00 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A233E6073D for ; Wed, 24 Dec 2025 16:32:00 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id DFD8B10AB137E; Wed, 24 Dec 2025 17:31:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593920; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=G26rqxh6dAvLt01E6u/zxoI/I5XVCZOgGtgt1JtmFjc=; b=THx04s/9MNgR1dlxtsGI+Bp2NhNYVYExqHPp79kKuogJiH74oCAhGUAQokOSBe2JuGkZRD Uf5wycQZpA534B0874sc13tFswHXzjT4bOTlzbzlBjphP97yJ6vxTJ0nBiBVr8AwDRPLC5 a/OINvzFYdYHR2WUmcG5T9EecMVmfyt//wWzFMx82Q8Izax966o7C7tnuW8EVivbQr/NV9 2jtWbO2K2qCoJ8s2sNG1pUGt0889kyFYs3lxgNCD6xhLqrgRrsSJ9bMJ2kx/EIn9uc9EMq xyBaGzPdGO9YJR9qtcpmxiicExuc8UuuGXR5BYi3ag7pWpuWV3s9a0aDyjzQzg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:45 +0100 Subject: [PATCH 19/53] kernel-dev/common.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-19-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=14646; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=wBjyQ3+fhgpC95Vce4TxapVIqTmoaujY9J0ksXunMQ4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVqTPRm15CTXhnZtwUzaoCOe6gEuClZGF8Wn PbR72CyFFGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVagAKCRDRgEFAKaOo NugzD/9X+sQ7b8V2RESixiHVnwsGpHceOL1kXUijgjLZGk2zxSL9UOETSO7hhPu3nHhX6XtnE13 BlVft9mmrbofFCDloSswZIBHadqNpSTKwI8AAzrn5qt7bR8hRrX9HLPvRj/IxUorW9utMS9aQkZ ua6s9y2AyW7z3E/nHnXxoMpBfg90UR+8NPxaYn275ydmKg/Ly8Cu8WHPhwyBlAcUfMxWipge1yA AyJBZ5CB53QwGoRsoH+sKKuPA2Y2seKJ5AQMhLwSOTNw5rsHhB+XOnx5M6XambfA1+9m+h/I2EP nbDmufVFLMScZ8/rrBKyASBxpkY1nncW0L1svzrxYlB0aT/0fDMarSdHivfdgNiuiMY2Bwex/Mf pwl7rfK/wz46gcG9ZHcia8AP1UQMXap5V0gKgUm7eMy7FgY79HA3u9KtFJyGF2WKJ5cVK0a0c28 SOSlZN+iqm9H0lZxYQWSAyrQBMz26fIwQLn8S+2n1mTUNFZrqyvzew3HSlIXcFK8COfvYBSdbLq ktkXinkOxe3/tmy9jsMaGCmeWA94WsZBQ1cFABQgxCM6xlqLANmwbv+waDwZRrtGDoIRVQ4v3cE dE2nWW40B2L4zXnBZ1hUYu7AvI6UfbwNnifnsUAGOBKg1/4J30OW96lrDfqNQSGKWRBUboRN7vL Ysdwx0YpS82VXTg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8348 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/kernel-dev/common.rst | 107 ++++++++++++++++-------------------- 1 file changed, 46 insertions(+), 61 deletions(-) diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 2142d31c0..ba3a09942 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -44,25 +44,15 @@ image and ready to make modifications as described in the ":ref:`kernel-dev/common:using \`\`devtool\`\` to patch the kernel`" section: -#. *Initialize the BitBake Environment:* - you need to initialize the BitBake build environment by sourcing - the build environment script (i.e. :ref:`structure-core-script`):: - - $ cd poky - $ source oe-init-build-env - - .. note:: - - The previous commands assume the - :ref:`overview-manual/development-environment:yocto project source repositories` - (i.e. ``poky``) have been cloned using Git and the local repository is named - "poky". +#. *Initialize the Build Environment:* Follow the :doc:`/dev-manual/start` + section of the Yocto Project Development Tasks Manual in order to have a + ready-to-use shell that can execute ``devtool``. #. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable is set to "qemux86-64", which is fine if you are building for the QEMU emulator in 64-bit mode. However, if you are not, you need to set the :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file - found in the :term:`Build Directory` (i.e. ``poky/build`` in this example). + found in the :term:`Build Directory` (i.e. ``project/build`` in this example). Also, since you are preparing to work on the kernel image, you need to set the :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` variable to include @@ -79,7 +69,7 @@ section: patches created for the kernel image. You can use the ``bitbake-layers create-layer`` command as follows:: - $ cd poky/build + $ cd project/build $ bitbake-layers create-layer ../../meta-mylayer NOTE: Starting bitbake server... Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' @@ -103,7 +93,7 @@ section: :term:`BBLAYERS` variable in the ``bblayers.conf`` file as follows:: - $ cd poky/build + $ cd project/build $ bitbake-layers add-layer ../../meta-mylayer NOTE: Starting bitbake server... $ @@ -157,7 +147,7 @@ section: set to "qemux86-64", which is fine if you are building for the QEMU emulator in 64-bit mode. However, if you are not, you need to set the :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file found in the - :term:`Build Directory` (i.e. ``poky/build`` in this example). + :term:`Build Directory` (i.e. ``project/build`` in this example). Also, since you are preparing to work on the kernel image, you need to set the @@ -175,7 +165,7 @@ section: patches created for the kernel image. You can use the ``bitbake-layers create-layer`` command as follows:: - $ cd poky/build + $ cd project/build $ bitbake-layers create-layer ../../meta-mylayer NOTE: Starting bitbake server... Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' @@ -198,7 +188,7 @@ section: :term:`BBLAYERS` variable in the ``bblayers.conf`` file as follows:: - $ cd poky/build + $ cd project/build $ bitbake-layers add-layer ../../meta-mylayer NOTE: Starting bitbake server ... $ @@ -210,8 +200,7 @@ section: For simplicity, it is recommended that you create your copy of the kernel Git repository outside of the - :term:`Source Directory`, which is - usually named ``poky``. Also, be sure you are in the + :term:`Source Directory`. Also, be sure you are in the ``standard/base`` branch. The following commands show how to create a local copy of the @@ -237,8 +226,7 @@ section: #. *Create a Local Copy of the Kernel Cache Git Repository:* For simplicity, it is recommended that you create your copy of the kernel cache Git repository outside of the - :term:`Source Directory`, which is - usually named ``poky``. Also, for this example, be sure you are in + :term:`Source Directory`. Also, for this example, be sure you are in the ``yocto-4.12`` branch. The following commands show how to create a local copy of the @@ -334,8 +322,7 @@ Modifying an Existing Recipe In many cases, you can customize an existing linux-yocto recipe to meet the needs of your project. Each release of the Yocto Project provides a few Linux kernel recipes from which you can choose. These are located in -the :term:`Source Directory` in -``meta/recipes-kernel/linux``. +:term:`OpenEmbedded-Core (OE-Core)` in ``meta/recipes-kernel/linux``. Modifying an existing recipe can consist of the following: @@ -430,9 +417,8 @@ Although this particular example does not use it, the :term:`KERNEL_FEATURES` variable could be used to enable features specific to the kernel. The append file points to specific commits in the -:term:`Source Directory` Git repository and -the ``meta`` Git repository branches to identify the exact kernel needed -to build the BSP. +:term:`OpenEmbedded-Core (OE-Core)` Git repository branches to identify the +exact kernel needed to build the BSP. One thing missing in this particular BSP, which you will typically need when developing a BSP, is the kernel configuration file (``.config``) @@ -677,7 +663,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio ERROR: Taskhash mismatch 2c793438c2d9f8c3681fd5f7bc819efa versus be3a89ce7c47178880ba7bf6293d7404 for - /path/to/esdk/layers/poky/meta/recipes-kernel/linux/linux-yocto_4.10.bb.do_unpack + /path/to/esdk/layers/openembedded-core/meta/recipes-kernel/linux/linux-yocto_4.10.bb.do_unpack You can safely ignore these messages. The source code is correctly @@ -688,11 +674,11 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio #. *Change the working directory*: In the previous step, the output noted where you can find the source files (e.g. - ``poky_sdk/workspace/sources/linux-yocto``). Change to where the + ``build/workspace/sources/linux-yocto``). Change to where the kernel source code is before making your edits to the ``calibrate.c`` file:: - $ cd poky_sdk/workspace/sources/linux-yocto + $ cd build/workspace/sources/linux-yocto #. *Edit the source file*: Edit the ``init/calibrate.c`` file to have the following changes:: @@ -758,7 +744,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio your working directory to where you modified the ``calibrate.c`` file and use these Git commands to stage and commit your changes:: - $ cd poky_sdk/workspace/sources/linux-yocto + $ cd build/workspace/sources/linux-yocto $ git status $ git add init/calibrate.c $ git commit -m "calibrate: Add printk example" @@ -784,7 +770,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio command from your :term:`Build Directory` in the terminal set up to run BitBake:: - $ cd poky/build + $ cd project/build $ bitbake core-image-minimal Using Traditional Kernel Development to Patch the Kernel @@ -868,7 +854,7 @@ Section. :term:`SRCREV` statements similar to the following to your ``local.conf``:: - $ cd poky/build/conf + $ cd project/build/conf Add the following to the ``local.conf``:: @@ -888,14 +874,14 @@ Section. committed, and the ``local.conf`` file pointing to the kernel files, you can now use BitBake to build the image:: - $ cd poky/build + $ cd project/build $ bitbake core-image-minimal #. *Boot the image*: Boot the modified image in the QEMU emulator using this command. When prompted to login to the QEMU console, use "root" with no password:: - $ cd poky/build + $ cd project/build $ runqemu qemux86 #. *Look for Your Changes:* As QEMU booted, you might have seen your @@ -959,14 +945,14 @@ Section. To build ``core-image-minimal`` again and see the effects of your patch, you can essentially eliminate the temporary source files saved in - ``poky/build/tmp/work/...`` and residual effects of the build by entering + ``project/build/tmp/work/...`` and residual effects of the build by entering the following sequence of commands:: - $ cd poky/build - $ bitbake -c cleanall linux-yocto - $ bitbake core-image-minimal -c cleanall - $ bitbake core-image-minimal - $ runqemu qemux86 + $ cd project/build + $ bitbake -c cleanall linux-yocto + $ bitbake core-image-minimal -c cleanall + $ bitbake core-image-minimal + $ runqemu qemux86 Configuring the Kernel @@ -1013,10 +999,10 @@ environment, you must do the following: The following commands initialize the BitBake environment, run the :ref:`ref-tasks-kernel_configme` task, and launch ``menuconfig``. These commands assume the Source -Directory's top-level folder is ``poky``:: +Directory's top-level folder is ``work``:: - $ cd poky - $ source oe-init-build-env + $ cd work + $ source layers/openembedded-core/oe-init-build-env $ bitbake linux-yocto -c kernel_configme -f $ bitbake linux-yocto -c menuconfig @@ -1063,7 +1049,7 @@ the ``.config`` file would be: .. code-block:: none - poky/build/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+gitAUTOINC+eda4d18... + project/build/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+gitAUTOINC+eda4d18... ...967-r0/linux-qemux86-standard-build/.config .. note:: @@ -1279,32 +1265,32 @@ Here is sample output from the :ref:`ref-tasks-kernel_configcheck` task: ---------- CONFIG_X86_TSC ----------------- Config: CONFIG_X86_TSC - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc-cpu.cfg + From: /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc-cpu.cfg Requested value: CONFIG_X86_TSC=y Actual value: ---------- CONFIG_X86_BIGSMP ----------------- Config: CONFIG_X86_BIGSMP - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: # CONFIG_X86_BIGSMP is not set Actual value: ---------- CONFIG_NR_CPUS ----------------- Config: CONFIG_NR_CPUS - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc.cfg + /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: CONFIG_NR_CPUS=8 Actual value: CONFIG_NR_CPUS=1 ---------- CONFIG_SCHED_SMT ----------------- Config: CONFIG_SCHED_SMT - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/project/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: CONFIG_SCHED_SMT=y Actual value: @@ -1461,9 +1447,9 @@ on a future, mutually-supported kernel version. To help you use your own sources, the Yocto Project provides a linux-yocto custom recipe that uses ``kernel.org`` sources and the Yocto Project Linux kernel tools for managing kernel Metadata. -You can find this recipe in the ``poky`` Git repository: -:yocto_git:`meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb -`. +You can find this recipe in :term:`OpenEmbedded-Core (OE-Core)`: +:oe_git:`meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb +`. Here are some basic steps you can use to work with your own sources: @@ -1600,10 +1586,9 @@ Linux kernel sources, if you need an external kernel module, the ``hello-mod.bb`` recipe is available as a template from which you can create your own out-of-tree Linux kernel module recipe. -This template recipe is located in the ``poky`` Git repository of the -Yocto Project: -:yocto_git:`meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb -`. +This template recipe is located in :term:`OpenEmbedded-Core (OE-Core)`: +:oe_git:`meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb +`. To get started, copy this recipe to your layer and give it a meaningful name (e.g. ``mymodule_1.0.bb``). In the same directory, create a new From patchwork Wed Dec 24 16:31:46 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77455 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 A4EDBE776E7 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123195.1766593922828894778 for ; Wed, 24 Dec 2025 08:32:03 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=0u6XDdIr; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 5A1D41A23E2 for ; Wed, 24 Dec 2025 16:32:01 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3027D6073D for ; Wed, 24 Dec 2025 16:32:01 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 99B4F10AB137A; Wed, 24 Dec 2025 17:32:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593920; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=So78ZnHq5jP0f+6ofLHRm5ScVdjjhEuBLSJzeTuV1xw=; b=0u6XDdIrYR+seLveWBg3ZtNuDxwxlIbksjL4I7ju5iLWnER8FBGRWz825xMX4Ox/qaRgSG XkJzujoTKDB+5iucA1cazJfgRZdWFNh4QRHKpC2WvA+vd91CPGYX6X65gC3pkzvaYANds1 KLi0SOaFbJEjJtTuhSB+ndBvfqyoYYiFK+5faxugTOMfpZDhTO0YFcLZ7GdEl47w7iLajf KcLsmAMTo2+jIzXxkmMJxME1lCJCT2RMVQMmOI+vbSeDMuJChgco54t2WDYO+53Px+XhgN 6XR26ea2W8HIeT0zd7Oyq9wmRz9a4UZ9MM4shCCKubBdziwUpA+a9fZ9wbhNFQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:46 +0100 Subject: [PATCH 20/53] migration-guides/migration-1.4.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-20-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1077; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=B6B79bLviy3ydUTQ7na/KCgKJmDtg8bi/wTNg+0MrLo=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVqRW4qW5d62dcRnu5GSYpTzMV35HC3pR5Mq q6Rgh6C3bWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVagAKCRDRgEFAKaOo NlHXEADElDaREBbjP5FrhKAvp/UbvKyhz6YEWFk+zDdAMMG4Q/0KbE641W2RsjGjHST7UAnAyfs DMcGoj5M8aLpZ7Y/LrFAqFIPYmFAgva+dhvE50JUd5jIlUCHVq1SN5D+6XwBHepqRALjGrBqccx l3j6Ik0VXG/R19QV6DFQhHzA5SUFLvd6i0WdDox8AJi4u4Hme0YyicsfQ0yGuIFB3nKLzdE9Vao 0eXIdNh3u00/aVi4B9B9QmfSxlodiuGftBGcMkEZ3y9AxQ9qg56scWzblxsKPk262rga0JCnVOf YNrCSh1p+tafYkhYJzvUL7pEdhAAMGarvFeqCinGv/vtsMXWZG4TbL/U09bswkmSN4HsOALz8DE 3VQFAjVxW6YFO2IkLewtSZwT6jXDaSZDHjPyasR1zNc1fSDlH9wrGzukuZrjrPOYo3l3V/d4760 bMkvKlHF8jtI/Rqs1a3Z2NRsoEr6qE1iveHZ4BcqdeZlUBi+Jrx53vUfI+V1BkkS/bVylxsEaIz 5wZTkYc9Og+Bvh2MvU+lE4qo6LlOYXRGuuCu4nKW86aCKMaAI8s0How4IjEGIUVeZIkyGu7a4II eqw/CbGmtuzt/OE6VUPUfQ37QSkWYhVzHRlx5xMOTsaXr9KzTCnatjQcuF73mfur3a49HUi5i3G j+GEMBVz8vj3QYQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:03 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8349 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/migration-guides/migration-1.4.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/migration-guides/migration-1.4.rst b/documentation/migration-guides/migration-1.4.rst index 6db2a035b8..5d8d0ffde8 100644 --- a/documentation/migration-guides/migration-1.4.rst +++ b/documentation/migration-guides/migration-1.4.rst @@ -82,7 +82,7 @@ Custom Interfaces File (netbase change) If you have created your own custom ``etc/network/interfaces`` file by creating an append file for the ``netbase`` recipe, you now need to create an append file for the ``init-ifupdown`` recipe instead, which -you can find in the :term:`Source Directory` at +you can find in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/recipes-core/init-ifupdown``. For information on how to use append files, see the ":ref:`dev-manual/layers:appending other layers metadata with your layer`" From patchwork Wed Dec 24 16:31:47 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77459 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 9C858E776D3 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123196.1766593923739643526 for ; Wed, 24 Dec 2025 08:32:04 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Brj13uB0; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 380541A23E0 for ; Wed, 24 Dec 2025 16:32:02 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 08FF16073D for ; Wed, 24 Dec 2025 16:32:02 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 22BA710AB137D; Wed, 24 Dec 2025 17:32:01 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593921; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=1kduOd3sQSlCuQH3io/fZFv0GxMpftpI6/ieai7rRlU=; b=Brj13uB0wmxvsE+sygUhdo9uUooPl959lRHWyK1Tt2DMQhn5Mre6cgbsabaw8UoAQUM4JI tvXjXIQmVR/2ocQY7nv1lhiJJQBkrayxG8rwOn4HRZ0O+cWR0MhQ/kJkjWW4sp7Zgz80NF om/ITeIsgfsOCeLf4AEiI/IlSRbIGCnYyez5xjxNIoq6gbkwS+vrOGbZypfkdjHAxujppw 0opnt93kpplOFrAbuL+2KzmsAIRaeQcFowmvrnc1P0/YTzOMkr9gcD4YzIqUNrvfWJeNZK 0JjmRw1Vn6nyiUq7qTereBlikP0Zco9pJoHAdBTGA9776pKlG9w0wg/XGdgHAg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:47 +0100 Subject: [PATCH 21/53] overview-manual/concepts.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-21-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6437; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=hIr24PLfSnEsZplsyjzBVuhC98/jlx7ZHgU6GXvP4zU=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVqQgFzMk4iHHyz4ONu9dvyZFAa6LtA8Whtk +aW936/3MyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVagAKCRDRgEFAKaOo Nn59EAC119tzoh+jGBZzK886UUbN5OqvwZGluCeQYCO+mrBTsI9Zf2u7HZLP/epFIHxmEdY9Gea eEPL33y59H6hIC8BQsY8i4dzZ7kTkIrddAvhGVTX3OzTS3Yf4eGlI56sU6CDiLjrp03zknn5afF eqXlnLARDuzc/C2TaKiH9lKs3zuSRipA7AYnNxv5wuGR4KSHkg+fJImvKGoDFR9vOFhO3t3NZdm RalsUN70zMCulJGRJ30780RuTK+HrxZYVDaK/RQPWjEYKkhn28of7rduAqyiioHLYLsljSB932v p2VHo2AymHOfTaoyE5e05Qxlmh2XxDUDXX6reHwCoYgeH/5SnSWDvmWC5ltU2gDimmxFwXuoNYl pJUG2URGRAKxX3OkFMwoV71PJEyEK2OXFNnzXt7TdjjHcYHRxHYikLtS42Bo9Dfd+cZcUXsPR8y 95XoDgf5via2Yw5EijHcraeoBTXQrlrQxl2XU7fhuRmPx2aR0T7BYMGt5zun7H3MD4IACTlwTOg Rjg47t5pmuQx2ENmSoPVLgrpZXQo6okM7GzDT1tWn3s09ZjTQLi+anbIz/cP2giDmaIIR8tXmNI 3hg6EE+7fMpV0fDtZAJ36g6H4Mik9/oDxWPUCty9CwKLXGqqtMBbSZ9j/XPKcroWpE42WJlSFEq Aj3z6S7osCZGF2g== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8350 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/overview-manual/concepts.rst | 75 +++++++++--------------------- 1 file changed, 21 insertions(+), 54 deletions(-) diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 04a08b7db..ec56031c4 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -211,62 +211,29 @@ figure `: BitBake needs some basic configuration files in order to complete a build. These files are ``*.conf`` files. The minimally necessary ones reside as example files in the ``build/conf`` directory of the -:term:`Source Directory`. For simplicity, -this section refers to the Source Directory as the "Poky Directory." +:term:`Build Directory`. -When you clone the :term:`Poky` Git repository -or you download and unpack a Yocto Project release, you can set up the -Source Directory to be named anything you want. For this discussion, the -cloned repository uses the default name ``poky``. +When you :ref:`initialize the build environment `, you can set up the :term:`Source Directory` to be named +anything you want. For this discussion, the cloned repository uses the default +name ``work``. -.. note:: - - The Poky repository is primarily an aggregation of existing - repositories. It is not a canonical upstream source. - -The ``meta-poky`` layer inside Poky contains a ``conf`` directory that -has example configuration files. These example files are used as a basis -for creating actual configuration files when you source -:ref:`structure-core-script`, which is the -build environment script. - -Sourcing the build environment script creates a :term:`Build Directory` +Setting up the build environment creates a :term:`Build Directory` if one does not already exist. BitBake uses the :term:`Build Directory` for all its work during builds. The Build Directory has a ``conf`` directory that contains default versions of your ``local.conf`` and ``bblayers.conf`` -configuration files. These default configuration files are created only -if versions do not already exist in the :term:`Build Directory` at the time you -source the build environment setup script. - -Because the Poky repository is fundamentally an aggregation of existing -repositories, some users might be familiar with running the -:ref:`structure-core-script` script in the context of separate -:term:`OpenEmbedded-Core (OE-Core)` and BitBake -repositories rather than a single Poky repository. This discussion -assumes the script is executed from within a cloned or unpacked version -of Poky. - -Depending on where the script is sourced, different sub-scripts are -called to set up the :term:`Build Directory` (Yocto or OpenEmbedded). -Specifically, the script ``scripts/oe-setup-builddir`` inside the poky -directory sets up the :term:`Build Directory` and seeds the directory (if -necessary) with configuration files appropriate for the Yocto Project -development environment. - -.. note:: +configuration files. These default :term:`configuration files ` are created only if versions do not already exist in the :term:`Build +Directory` at the time you source the build environment setup script. - The - ``scripts/oe-setup-builddir`` - script uses the - ``$TEMPLATECONF`` - variable to determine which sample configuration files to locate. +:term:`Configuration files ` provide many basic variables +that define a build environment. To see a list of possible variables to +configure from :term:`configuration files `, see the +:yocto_git:`local.conf.sample +` in the +``meta-poky`` layer: -The ``local.conf`` file provides many basic variables that define a -build environment. Here is a list of a few. To see the default -configurations in a ``local.conf`` file created by the build environment -script, see the -:yocto_git:`local.conf.sample ` -in the ``meta-poky`` layer: +Here is a list of a few: - *Target Machine Selection:* Controlled by the :term:`MACHINE` variable. @@ -371,18 +338,18 @@ figure `: configurations. This type of information is specific to a particular target architecture. A good example of a BSP layer from the :ref:`overview-manual/yp-intro:reference distribution (poky)` is the - :yocto_git:`meta-yocto-bsp ` + :yocto_git:`meta-yocto-bsp ` layer. - *Policy Configuration:* Distribution Layers (i.e. "Distro Layer" in the following figure) providing top-level or general policies for the images or SDKs being built for a particular distribution. For example, in the Poky Reference Distribution the distro layer is the - :yocto_git:`meta-poky ` + :yocto_git:`meta-poky ` layer. Within the distro layer is a ``conf/distro`` directory that contains distro configuration files (e.g. - :yocto_git:`poky.conf ` - that contain many policy configurations for the Poky distribution. + :yocto_git:`poky.conf ` + that contain many policy configurations for the :term:`Poky` distribution. The following figure shows an expanded representation of these three layers from the :ref:`general workflow figure @@ -840,7 +807,7 @@ This step in the build process consists of the following tasks: :term:`PACKAGECONFIG_CONFARGS` variables. For information on how this variable works within that class, see the :ref:`ref-classes-autotools` class - :yocto_git:`here `. + :oe_git:`here `. - *do_compile*: Once a configuration task has been satisfied, BitBake compiles the source using the From patchwork Wed Dec 24 16:31:48 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77463 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 AF65BE776E7 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123726.1766593924249012651 for ; Wed, 24 Dec 2025 08:32:04 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=fzXKA3pg; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id B83401A23E4 for ; Wed, 24 Dec 2025 16:32:02 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8EB866073D for ; Wed, 24 Dec 2025 16:32:02 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id DE98610AB1379; Wed, 24 Dec 2025 17:32:01 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593922; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=nIsvwk4n7TfBSPYFf6BgN3riN2MKZUrIYw+S5aWA66c=; b=fzXKA3pgz5pAm3zLuU2HueFkVKzWeVujqbvlbrBlU2zZf3EukNRWIsldhKGQ68ovnsMhX6 mU8e8PTakqjYBsjKkdX1maFVhlmoxbRHljzHa76gIp+3BeA0aBdLH9s8wlTOxqw1CSwTCP ZsLDqF7ngKAsRofG01LlcxPEqhLMgS3tkfgN0QcqC+Z+Ibvrd6a0FsaEILffOzmi4lqJlw DTqHdvYze0CQ8hNDbVwukneea/qnQxcU8fIWil9H99fVoyFCby19+hGoEJP7+Y5CikOprC AjsGtMxn1X3666ABv3UUAljgXfdAfWZeYevhyLG1AoCL7GV3lIP6sAW8FGxlSw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:48 +0100 Subject: [PATCH 22/53] overview-manual/development-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-22-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=10935; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=FWHWqb3P74YB6mGKNaGisndTENkIhsfCaLpjIHcGFSI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVqaJqEhXRpI5wWt7QRM6GsBj8W8hB87i+wI Acp0tkLh12JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVagAKCRDRgEFAKaOo NseCEACbn476AvJPsCEiQIOYRbbWGHzywQ/lmS6nUw9CkAMXtyuis9mi1OOnJFbKTbVXsRrVntZ W4r0BNy3AkSSbPxJJq3/5eEVwo7HcoQfB63LaBxPEtZlFYLOFHb1MFln2/Z3p3ezJbrLNqaWglW nqdugM4kM3bYne0qnVcGIbuSmCq0FDMfUX/uCJjlU+rmzpQdo8D6+y/whOldtUWoZwuMt0VeCG9 oIX4v9/cUO4gUlCfsaVblmBeiB5UChRJicKpcoz9RbRm6c8ECDbzTGQlteTsKEtHgGUKCyfvTeT gySr0UU+s0eD5CcQep2OcXlwt3pvYho8UphAMHYBYNJn4vv5TXAWWABYww28J134difrCp9fGVe 0ho3HVah9NPuZpVIpN9UDJ3MDRA5FNP2qxYU7Ovp1kwPnBA+hIAOeAHGL8cmhzaExqLk6+uszj5 p0EwC1t0fgsVU5Ph4uStKtO1xgF4PdjxWD40QoNyA5TEkat0ZwoupEnC1e/w7+H7WO89EFL7i+6 +weNjHtTMDzb/99La4QQ3wZ9p35/VL49UJqosdv6sBKJIYncrkczF2ouxIJkawEHlNxW4r8AaNi LBtQ2WLCA1FnvRFsQBgXwzVs5DLMCdPEXV1psZv63rAnxJ14JVMQJanU/runsYNgfGbT61sKMww zLzHBNA3sB0Cz9Q== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8351 Remove references to the Poky repository, replace by OpenEmbedded-Core. Replace the poky examples for the Git section by yocto-docs. Signed-off-by: Antonin Godard --- .../overview-manual/development-environment.rst | 74 ++++++++++------------ 1 file changed, 35 insertions(+), 39 deletions(-) diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index ab9bd084c..7eb57f12f 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -148,38 +148,35 @@ code browser is organized into categories by function such as IDE Plugins, Matchbox, Poky, Yocto Linux Kernel, and so forth. From the interface, you can click on any particular item in the "Name" column and see the URL at the bottom of the page that you need to clone a Git -repository for that particular item. Having a local Git repository of -the :term:`Source Directory`, which -is usually named "poky", allows you to make changes, contribute to the +repository for that particular item. Having a local Git clones of +these repositories allows you to make changes, contribute to the history, and ultimately enhance the Yocto Project's tools, Board Support Packages, and so forth. For any supported release of Yocto Project, you can also go to the :yocto_home:`Yocto Project Website <>` and select the "DOWNLOADS" -item from the "SOFTWARE" menu and get a released tarball of the ``poky`` -repository, any supported BSP tarball, or Yocto Project tools. Unpacking +item from the "SOFTWARE" menu and get a released tarball of the +repositories, any supported BSP tarball, or Yocto Project tools. Unpacking these tarballs gives you a snapshot of the released files. .. note:: - The recommended method for setting up the Yocto Project - :term:`Source Directory` and the files - for supported BSPs (e.g., ``meta-intel``) is to use - :ref:`overview-manual/development-environment:git` + is to use :ref:`overview-manual/development-environment:git` to create a local copy of the upstream repositories. - Be sure to always work in matching branches for both the selected - BSP repository and the Source Directory (i.e. ``poky``) - repository. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" - branch of ``poky`` and you are going to use ``meta-intel``, be + BSP repository and the :term:`OpenEmbedded-Core (OE-Core)` and + :term:`BitBake` repositories. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" + branch of :term:`OpenEmbedded-Core (OE-Core)` and you are going to use ``meta-intel``, be sure to checkout the "&DISTRO_NAME_NO_CAP;" branch of ``meta-intel``. In summary, here is where you can get the project files needed for development: -- :yocto_git:`Source Repositories: <>` This area contains Poky, Yocto - documentation, metadata layers, and Linux kernel. You can create local - copies of Git repositories for each of these areas. +- :yocto_git:`Source Repositories: <>` This area contains ``meta-yocto``, Yocto + documentation, metadata layers. You can create local copies of Git + repositories for each of these areas. .. image:: figures/source-repos.png :width: 100% @@ -230,11 +227,11 @@ and so forth. ":doc:`/contributor-guide/identify-component`" section of the Yocto Project and OpenEmbedded Contributor Guide. -The Yocto Project ``poky`` Git repository also has an upstream -contribution Git repository named ``poky-contrib``. You can see all the +The Yocto Project Git repositories may also have an upstream +contribution Git repository suffixed with ``-contrib``. You can see all the branches in this repository using the web interface of the -:yocto_git:`Source Repositories <>` organized within the "Poky Support" -area. These branches hold changes (commits) to the project that have +:yocto_git:`Source Repositories <>`. +These branches hold changes (commits) to the project that have been submitted or committed by the Yocto Project development team and by community members who contribute to the project. The maintainer determines if the changes are qualified to be moved from the "contrib" @@ -323,7 +320,7 @@ Book `__. software on which to develop. The Yocto Project has two scripts named ``create-pull-request`` and ``send-pull-request`` that ship with the release to facilitate this workflow. You can find these scripts in - the ``scripts`` folder of the :term:`Source Directory`. For information + the ``scripts`` folder of :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use these scripts, see the ":ref:`contributor-guide/submit-changes:using scripts to push a change upstream and request a pull`" section in the Yocto Project and OpenEmbedded Contributor Guide. @@ -377,7 +374,7 @@ local experimentation on projects as you develop changes or new features. A Git repository represents all development efforts for a given project. -For example, the Git repository ``poky`` contains all changes and +For example, the Git repository :yocto_git:`yocto-docs ` contains all changes and developments for that repository over the course of its entire life. That means that all changes that make up all releases are captured. The repository maintains a complete history of changes. @@ -390,10 +387,10 @@ locally. It is important to understand that Git tracks content change and not files. Git uses "branches" to organize different development efforts. -For example, the ``poky`` repository has several branches that include +For example, the :yocto_git:`yocto-docs ` repository has several branches that include the current "&DISTRO_NAME_NO_CAP;" branch, the "master" branch, and many branches for past Yocto Project releases. You can see all the branches -by going to :yocto_git:`/poky/` and clicking on the +by going to :yocto_git:`yocto-docs ` and clicking on the ``[...]`` link beneath the "Branch" heading. Each of these branches represents a specific area of development. The @@ -409,15 +406,15 @@ development branch in the repository. To help illustrate, consider the following example Git commands:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky -b &DISTRO_NAME_NO_CAP; + $ git clone git://git.yoctoproject.org/yocto-docs -b &DISTRO_NAME_NO_CAP; In the previous example after moving to the home directory, the ``git clone`` command creates a -local copy of the upstream ``poky`` Git repository and checks out a +local copy of the upstream ``yocto-docs`` Git repository and checks out a local branch named "&DISTRO_NAME_NO_CAP;", which tracks the upstream "origin/&DISTRO_NAME_NO_CAP;" branch. Changes you make while in this branch would ultimately affect the upstream "&DISTRO_NAME_NO_CAP;" branch -of the ``poky`` repository. +of the ``yocto-docs`` repository. It is important to understand that when you create and checkout a local working branch based on a branch name, your local environment matches @@ -432,13 +429,12 @@ Yocto Project Release. Git uses "tags" to mark specific changes in a repository branch structure. Typically, a tag is used to mark a special point such as the final change (or commit) before a project is released. You can see the -tags used with the ``poky`` Git repository by going to :yocto_git:`/poky/` +tags used with the ``yocto-docs`` Git repository by going to :yocto_git:`/yocto-docs/` and clicking on the ``[...]`` link beneath the "Tag" heading. -Some key tags for the ``poky`` repository are ``jethro-14.0.3``, -``morty-16.0.1``, ``pyro-17.0.0``, and -``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent Yocto Project -releases. +Some key tags for the ``yocto-docs`` repository are ``kirkstone-4.0.30``, +``scarthgap-5.0.1``, and ``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent +Yocto Project releases. When you create a local copy of the Git repository, you also have access to all the tags in the upstream repository. Similar to branches, you can @@ -449,19 +445,19 @@ The most common use is to checkout a working branch that matches a specific Yocto Project release. Here is an example:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky - $ cd poky + $ git clone git://git.yoctoproject.org/yocto-docs + $ cd yocto-docs $ git fetch --tags - $ git checkout tags/rocko-18.0.0 -b my_rocko-18.0.0 + $ git checkout tags/&DISTRO_NAME_NO_CAP;-&DISTRO; -b my_&DISTRO_NAME_NO_CAP;-&DISTRO; In this example, the name of the top-level directory of your local Yocto Project repository is -``poky``. After moving to the ``poky`` directory, the ``git fetch`` +``yocto-docs``. After moving to the ``yocto-docs`` directory, the ``git fetch`` command makes all the upstream tags available locally in your repository. Finally, the ``git checkout`` command creates and checks out -a branch named "my-rocko-18.0.0" that is based on the upstream branch +a branch named "my_&DISTRO_NAME_NO_CAP;-&DISTRO;" that is based on the upstream branch whose "HEAD" matches the commit in the repository associated with the -"rocko-18.0.0" tag. The files in your repository now exactly match that +"&DISTRO_NAME_NO_CAP;-&DISTRO;" tag. The files in your repository now exactly match that particular Yocto Project release as it is tagged in the upstream Git repository. It is important to understand that when you create and checkout a local working branch based on a tag, your environment matches @@ -596,7 +592,7 @@ MIT license :wikipedia:`here `. When you build an image using the Yocto Project, the build process uses a known list of licenses to ensure compliance. You can find this list in -the :term:`Source Directory` at ``meta/files/common-licenses``. Once the +:term:`OpenEmbedded-Core (OE-Core)` at ``meta/files/common-licenses``. Once the build completes, the list of all licenses found and used during that build are kept in the :term:`Build Directory` at ``tmp/deploy/licenses``. @@ -617,8 +613,8 @@ Source Definition and the effort for reviewing and approving licenses that conform to the Open Source Definition (OSD). You can find a list of the combined SPDX and OSI licenses that the Yocto -Project uses in the ``meta/files/common-licenses`` directory in your -:term:`Source Directory`. +Project uses in the ``meta/files/common-licenses`` directory in +:term:`OpenEmbedded-Core (OE-Core)`. For information that can help you maintain compliance with various open source licensing during the lifecycle of a product created using the From patchwork Wed Dec 24 16:31:49 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77470 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 03B32E776F7 for ; Wed, 24 Dec 2025 16:32:14 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123728.1766593925104066901 for ; Wed, 24 Dec 2025 08:32:05 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=gGVKtowO; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 945F31A23E1 for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 67BCB6073D for ; Wed, 24 Dec 2025 16:32:03 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8C8A410AB137B; Wed, 24 Dec 2025 17:32:02 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593922; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=dfCcZ9Se4LfTjoIK3eHmDD0+EZMNUi1tVwtGt0qFA3Y=; b=gGVKtowOtJeQFBVlgB9vFnYbUBKdj6o/9D8DUwR/Kcj3I53DgcLKO81qga5SB2gbytb6UM C6Euu89Pyi0b07epZeG24ys3zWUPVIsk5fMk/4QZkMCy9IByBOuHiUO9aVhPReX64AOn8T aefD8r4oIYc1UVITGzSbvU+LUhotTPFPbBdS3L67clu7LNIzox5SLniA6HUFDEenjaPxiB kjwh5/f93x1snDWt9iDg0qyQLmai82oxM1scJc867aU2kRZM9L7TcOar2lyia8MLw7l7Nd DEJDHgweE5iOJSmiwnjfIlPtDQU4rxlW0pqdwPk4iT0TOvCxZkFF1KSpyZ3eNQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:49 +0100 Subject: [PATCH 23/53] overview-manual/yp-intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-23-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=43571; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=6kaNJ1qod0OcEI40gsfrki6EwdCQ6q+nv5NGxUbfnmI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVqkfnJm8ayxZuiDxkzdI2gnFCxBxXpDwUjH LO/+KyFPXmJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVagAKCRDRgEFAKaOo NtCEEADC358z8V5/1KnYq9gSfXMmilJj7bVZAEAyRTqiOXWR0HYu50slD0w80qudf4vmozH79wB CbZJIh7OsQd5jmvJpeHVSziZjBkloSjEBbOcJzdzXxqGvXOAZgavSy2TwztVobP7LbwZjxxw59D KmogRTHh+QpnSh6P4hVV2V2Li+FI24jirBtqvNMy+A74L7tW0XvJZnAnldQCnUekws44HFBEBvQ t07y/XUZ7PYgjFkg9tz3TaxIzsKPYmr9sXv3W5vj4SJo5tJvf7DmDW7k1pV0nGJxSmgPFLoDrfD gTRcefezpPPNLcO2h6TuPhlsm5082+H+MLjsSuSVZQKHjhjAQ1ELobBWzc+mBdY4SHp4s1HJtbM P+GUBuEHQpWlih5ElIjG/gGFbKdB9J9/kNb9awL7xcFlCINKQmnW0tQPfgUJQY+QtATImfWRaa1 jK2k86RV6tIeZfSjHfHq8FIEhqEDPR16QzBDsZnobIRpxd+iX4kyrisAkIVd7Jw7DC2F1Y01iua 7RgsMmTeJRin0QqbclK6BjLI+0Q16ZN6opci6ICPNNn6j4ieGszg8+DWq32Kl51odgQJhU0wA5P 5zVvPagNZgy37bLqZbJ+MQWZ0FS1n/dyfwDSerrxCsWM+wP+rC/Q56DH+bBrJ4JSkn5mhMg2u1s s/OV4Nd4IxWDQVQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:14 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8352 Remove references to the Poky repository. This document had a lot of reference to it, so a lot was removed. The "Reference Distribution (Poky)" section was removed as there already was a "Reference Embedded Distribution (Poky)" below. This section was simplified as now Poky is just a distro, not a repo. The historical section was also updated to mention the obsolete Poky repo. Signed-off-by: Antonin Godard --- documentation/overview-manual/concepts.rst | 2 +- .../figures/poky-reference-distribution.png | Bin 23784 -> 0 bytes documentation/overview-manual/yp-intro.rst | 155 +++------------------ 3 files changed, 21 insertions(+), 136 deletions(-) diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index ec56031c4b..ab414c90c4 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -337,7 +337,7 @@ figure `: "BSP Layer" in the following figure) providing machine-specific configurations. This type of information is specific to a particular target architecture. A good example of a BSP layer from the - :ref:`overview-manual/yp-intro:reference distribution (poky)` is the + :ref:`overview-manual/yp-intro:reference embedded distribution (Poky)` is the :yocto_git:`meta-yocto-bsp ` layer. diff --git a/documentation/overview-manual/figures/poky-reference-distribution.png b/documentation/overview-manual/figures/poky-reference-distribution.png deleted file mode 100644 index 1be89ae68e36c6e37a4903d0688d5bd1ad36b87a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23784 zcmeAS@N?(olHy`uVBq!ia0y~yV7kk|z-Yt4#K6EXdFd>91_lP^VkgfK4i1jn5B(o7 zFfd4#xJHx&=ckpFCl;kLr03=5rs@_a7p11=6=&p^yl38T$H1V#;OXKRQZeVv-O?D5 zpVI6f($mT#cLfSK23RfSIl^?*VM9Ruj2kPKCsp5jIrrYnh4b#-TbYnJx0AK&u7X;J zuBM{w?a#lPZ_S7m;Qm;-{~dpR`LpQV2K<{he^%7!Vrmg^;#kPm@aGz{1BYUZz^ax~ zPA3k<7AdYZ-U3b>idO;>Vw*rp+L&Gofz+CcL`+v`5pY_u@W3t>#TEf4Ue;@>Ae~tn z8}uAG6k7tE8_|t0NR{6u_5aDg?mz48ML>r9wcwa^arNG{Q#<>PG;i8j8@o)FO&7Nxg!^_@9`QDzfWv)Tx>Al};KK}hV z^ZGYmS%V9EcJ2-f?oT`C-2SKR+0pjhi=%dBn@;_!U+~r2?#ewi28Jp2v(nV}<-4>0 zw=c8N5Ibp?`sQ-li?$Ue8`VTg0=MS(KW3d$BK|JQw_3mAM5xKunATunkWr@oV~CfzXM4?8*asC9fXV=W6PnY`G&G{-deZw7b6q|b@_W6p?o za_Q@Fc5AU^7$%)A`Fwr$vMuvBe7>?+=F*vShvU|NdHc6^zyB+XuSv@`B&GkGU0ZyM zZQae<$FcKPt?XW%DtvEsaWwy3?cmKt+Y2{rFWQh5RM--bo%k>z|LKFQ%Ra6Dw@foz zx>0w|o?AC(YEEB%&(^T`!KBObE|2_63(T*JiKxZ*NPNA#v*(o94*A=xnO80yym#v0 zy;BRf)^eK$UA%Hi)W`QvhK7&z-tSE8KEHn7)Y6W5a#D9j(Q;3-w?+$?x#Qkiep#@l zZv8v{uAgh!8w8wI{0o`up3iA{zc%~W#GA8!>8d}M(_=80vm^5hlA&d0AS2i9DYElU&$$}-cMEI&x3aA5W*eWp`k(9J(Q`ustk*U|lp9x8^|rs>Zs$oli`%j3h%j0`<)|Gs%kZ{5UgSpJhC!9I6O zGaDmAPuf1^HYxXfpYyvVCLjB{;fbA1aW6B&wc`4ZhHEV{gmQ%W%UNTm+O1sbYxXv8 z(WfuR&lfW=+?aLh(Q;LduKC{|xhgVj(0S7vS^A=Bo!-vP1v$U3@-QfDxxL=nU~#Y3 zl$t+RR0@pq_AX-JiS1pjrjkC9v+q!*(binus}C~2?R}C|aBX$=d;2~5anp0`r~lJ) zU$R{7_eW(Xj@p*zJDct|-4Js#s=xd114r+*{p+L)j6S@mX1MVE{+I6AVv48EXg*+U z=xW^P7OHvRirHmGkM>31k2(oVefFe~!QtkHseFs`{&sj}XHGu$w)5^5^|0Q{g&!=c zQx~k7|7smG1B2Gu_IEdK9PS95u9wjl8S-uSk{kwx1W8dYZK{`AM$Yu5To<#4O_FUwIiwLQJfF1gA2wg&T*aJ!|~ZmnjXC^2_J z_`eTvF>Kq*jnx9H#h-49-EzCk@l)}fDj#2==Cw%Ey;!_e^(gh7*-@PEM|Is+yQRbJ>O`S5GG~ z#HxFr-Nh@z2rhMdg$}Ry{b}bnpN8~ox0@AxZ{9u5xBvBqo#F4k&ChqOVqmzrP0%=g!dUnn1(7J~6S(Zg#_cmW{+iHGQuddu) zPjha@#pFi{<-V-PTcd9O$?#hH>+daR(FH#;Zmhii=hm(T8eL2b3Z9F8^{`I;tEc(1 zH0aaoCF%b2#JOHun-;E_#{B*zgzBGsn5aJ-U3eZGhR(Bdt5DHy=BGq`%hN{KG@gs;?>rNni)KH zWxwS8uj=0r4y~#!tKYx($c)LyuWeZy?%vcRTl@QL&5J$nu3bx*ToqgQo7uysUDiM9dv1r|?)lFd9VX{3mf2rW>9wLXqU^=XFGfMD_kEX5eDO2i z`rh27xpzdmC-paj8Vw8E{Ac|Clq$Dk>z7x?`frx=Nx8hOu90e5d-qPr@8ECwm-gIz zE`5%l1>6+jo!|C< zgihIE{U>jm0E5Gf%021JOZ#^ycyxaGcyrznVQJ5+!CfLDXO3P!bZvL*>z4aTpIaCd z&UF8MtuDU%U0C0~X>yP2cSnb9mHa#9Xs2C_-244@`~G}Bv*q29>n@C}*^73xTIoJ} zF1`H6wE3&E84jN2Ro=UO*~i!0%|nZ-Z$|9C#yD^C`X{Gq|Ej8K{GPYu(|Z3`+wJzP zsZ$0w>}H&8Yva}XQGNGjjNla2b-z>>y5G=nPgU4z?Q*BLa&n2qnFl2=W-Xbu*x>!y zwuPVlX87;_^W)IxmgMJRR?||ao%}Bw=fCLD5!;7_mQD-|ZFS2-XR}3WT-|RPwA=Z} z-51k6#UD+7DHl`p$yEN-`~108cWMr={d``2e!Y-P#ctq2U79(H$kHY@f`3xbyV%Ii4qiUhl5^Ty*=zyua&bT5sa&{$wOEPkX!nmrIHZZ9eu- zte@kdtE(Gc#5vPkqcA@vC~(95wQ6#gzx(;lHhp@xYsSkmhLD?|&nCCs_c^1Ne=+~} zxe4E{7B8?kIq|gfwWCizxMuk|Mw{~#UsOm@^ZIDPv~1lxDbA)tYlN8tKR0uSdhF2? zhc4@U-FSP~iwVzkW-@XHJy~~2D}L+rN4@J`&y@_@tTvH5^m?fN^(9OH`)mnY{VH-s z_12=Do0N9*?|J*+n8(=@KB*;lHWYg_R&aaE8mY3sSNSjdN%a`#qCcNQqor=_{3zTJ zYIu3>4Wrub{f26~f72J4T89?JJye`0rD`62R$6}EqMVeA2lq@Vnw;SWZa90gPVqmJe~tD35v z8XoQ8oNuJ{%P%Xl`@o02iu0m!vhCZiCvM-&TqRxi=O#a>fy%*fgKzTl?_XvbXDEL;^evI zw;0UdZoT)cgZ*3O?O%WLD~{Zm(Y^f3`}J?Wyq-BF*C)zVhu`>S{NMX@j#@ch!7U;pmh{@T9WPnFy6Wv}`2d*<}H$+q@M-AgAK{Pp;=`V=Qu zP+URq{MGBaJMJH|H?Dhf>4oBQwwIc-cbnCU{@$}^`@&g^RF}4bY7s^TfmdaZ-L~{p z8E@I`_%zXZN`3N<+2*s8%s%tnGP>&(S(EMcs!Ax(?@n#v^~iaFYtl6!g6K$^Dd0KSF=ID|adFxmh((K+!Y?e#seiIeIy8Zh4 zh|-UH13FLChu&~L_mned^E&4k6Az&nChLvQY|hOJ2$b(EdLL6cC&p@Lybh;BVOM4D zXV!q==@V|rmfefF9_u`%zBso3q;yrxoa=tKYa?^M?5Hl+i`^|~nVRur%H8MgUOttN zk8FxpYxPa}^5*jCK#gEzFy-gkRbXZzsmF9snd~5 ztJmkLpEl8R)7Thed;jyonQvCICCuLTI_D5m!j^(ddNt7+AJ$Z!e8INd3F&nJ%B>zFwX5C!p`y-!oeo%eueW zEi;if-FS94UrC6%=fcU$9UtCyVtk>waqCw__0@BjOm9vu+X}8mv?lsYO1bh!O10GL z&EC!HcC#^jm~_o|!`*p@(xY`Pwwawc7FC-3C)@A%wNsyND{(M2Bxo6G%}ScUW7f=| z;KAk?D8iungj<7w!AnCRh=HMXdbobYm6s_c^~GWL4*pBd_n2;1GM6EQf4Y$1uYLRH z+<&lYRR(|1^3wEhzZ+Y5>a4xR46a0P`?yRXhWfI!&j_?lA~HC)urUe2(?_wZ2t{9V3>pdX>d7usE;$wAWk9 za7h-U=<|~sH{M+pcWSGkTafT-=a&uwA`AzE(k|tC8))xRk?>*C5}Wy`xTR>@I^MYN zT>?&9gEr0mmw)NE>Ih1HH~Ybx^k@=S4F9r^3$?fT!y&ai0H^zWBfE^C{`)2VyfIOy}%HB~&ae~F1E z<_DkF{N=}5`90~~K0W0xv2$IfFP0bSTrugn`=TK2{p$jM=EUyX>++()!<=u;E7OUQ zdK<52Y}t6nSvv4?(;-pel=-oH|5nU;B&;#t>YSnOjHJgCuW!xa-sHh-F8=A+TJso& zxU?LfRZp&0Er~nDQ)>S5`zoJCU#Sy&<{#a@P;#4!x=zfdHVN?sGgfvMHgN4?=yAf3R>9TiJp8S;7Z%3m9pjD9jBLk zzca1z|GQ0rj7@h-WB%Vg{hLMV)ykLVrb)t5=MKv%xs`BSc)#Ppm70yRzH7YA{Yz#} zIchBbZG}>@JUW7S9t@+xYw@FdO8Y_P^xXl#cidgpdf5ffm z`Ah6lWPVp3-LhSV$z|0w+yD0-EOn0&mR1NYu&+7szWg(T%PFzP*S20=`R{W0)v5)- z-%c)1t=)Si!|H17&cbKA%9fY=7s>42_I-|F?w=dSro~-rd!^+g#9$G6ewLSrKRU}rcUr`{U3-fhUR~KzkT$pEx1a9nZIAc&+m+m1^nb>#Ek89MuaWDY zS1lfzaG})qMd{kwWjXB+uHF^z`MN(jWx=}S1=>F&yT5p6zPJ$fYp>Sj1)KIR`o8&x z(Y!gT)-r){hh*c9bFO{$_3NT8;Vz+FKGp)3yQj|j^xSglr_<}&Yh{CPZPodsvsSUC zE+V*pi}d}&Hx?cZ|6lYQ2FZchi{|;*N{J;4|_xtWmy&GSjcl%+NbYsyUd$ZQ4 zQ+15qPDxg8I(~jQ9~1wP{bLQM6UV~-#m~&jKA!$zBlkkf!e8-EL6zH!_Ejzls-neV)R0PAWUlJ5Y%qG{X61tD$eRUfiE+%|AqV?)EwF zzP`i@g@?<ou@Z&=H* z(fia&JI}z0x3`DcY+t|H&N)PAd*-tCV1H@%|MR-nrExh-5PJF6GC%DDM>>1{@(0f4 zdO30zR`&1wI^n`+`5l@QWACci-NiPV9|sSX=zyg6?;} zmbbm$Rzh#g59K??)V;eJ8O*o;31i69Z##GXy7l#b%+6%iuE~4q3$Jhc$G5I7xB0u8 z$m#X6N33tnit+j=rz?4W*Kx_^DRnQin%`7mezd4bXP_s4Sn%bpd}U*VlMUphB0{>D>d&+@R+-Lhup z+a|2?sN%l+O(F67lQUlrE6-ZLuj19myzQ&&=X(k==&N6^`*-Sp-#d=?CE3?zr9Taj zJTF%MJLS<=S26c8k$$;ndD0SfRp(!(zMJ((cB$HG|C>en?_Tgd_r9!M#?mm0WA9}D zNBsGlt*w)vTg#nLym#@T>Hk!t+_rCGvX;M_*aK$mFpjDYY1r7Y&NQy9@9Urai~DrH z)d>l{{gHm>?qbgE-`Bib)yppQMe^bI7C|SD2fNR{J-sqIZ$8URnH>}TY@1A-zpM4l znqK~6R^)^AZ4;^+)h@5I+U9G-es0D#;g(nIpnmMCFO|i=AFO`zEp&Bti<~c?%;uHx z8v-4U@a~?Ya{S_FUJsAynZ6S~tpV#>r*?^dp?~}G`vO@8UH89~MyyWUogT|o7kB@{ z74_}@AOHI956qK4ak5dFcNfpL{hLbe1yAREYuXtVHCg&)`-SDd&z+mTr2EZvH|d(! zfeYAr876M`O!EJIC*Ow8?^($F=7*J6|DQK1-8$=I@p41HoIlwQc7LyZ_KnrDJV}^g zL5gWvl*28ql`MdzFQ@1LhnTWQx_-u|~UV&T2{ z&)a>?kG^u1diJe0a?bPmFMsB4)veiAdRS68>xqg!tyeqGD1 zcl z;@_UU{d2b*S;SJCd_O+6>B4vSBmVwpPBJniWN8U6`ePp4KF>CU;gy*#`-|u9vGseC zit;j_bZiI1R*u6)a!EaNxkt zBmWvY-a3CPOJ)>lZBL&T@-A@0*X5J{FEO}N$7Lg!w8XP%TJ-CKzZllfldIF#@vSOb z$#UT2#_fXtJ}9+FDcZz0U6_8<%slII%gQCI(q5(+eyd-bGsX2}W~vf{K~~l&HiZb? zw^trI)n%r6cCL7IiZjv8j$!vrj{j=2M7OqkP2SiT^*>MdM!nMM)jwkG1m3pKFi);I zY^m6CVR}<3r&Ij2)BcRht58`WY&jfC1ueh;ZiM7kAbLkaL$sN<~t=zNOm}mC4zsiB{Y+s1> z$C#~;IB4;bO{ZdK;*#&zOzPfFUZL`deX7hJZT)4#rthzfo<8`i zB=~m8ia)O>|61Fxzq(ld#cps2NUywHba|hg;@d4Nj$HpAdp0;T)h;{v!Tfbzrd!#( zlP_#y^o}xK@ua$Txr)tG27@crtg}}#F&OM-oB84~|GVd^>i!XoA2-Awec{~sQmOK_ zoRrS?@>LIR-AfS;KX~&0y;It&U)dE^+L_*oNP5>4K5=*OA9jnC3?JgwOK&r{mV5E8 z`}6tsH%$HiK6v2y+=#_wvQmkS+OA`NW#_hkm(Q8<;kvX_eA}jrZPE*mdM-2+l7AEu zl$*M{==zH@OD;TGa^cE~efxiBY+`gc{O8Ez3y+ovUiS5LI-212)DP@>CkUx(nq@co+Gr%vFD*)is@moo$s(=KK7)vDMZUEL$YEl|G&{Yr}n|nJS4= zKDFoL&VD|({(XSx$!d+Q0a^Nqr5PJ?j5ajgJ8C8P^j^0|S;Uv)4&QcOKEH#3;m(q? z^Xl4zSQ!rZ$Jw5#{`~lI;?|xRt@RPRTGwXEY%F-Zs;@h5-JF#C_s_58Ui;;~ROEt> zqfOtBfU3~QBmTB^F&B2vR^(pr=ionC*V?c)i;Rg3Yt(G(`En<3_7U$NW*L?jGnHr0iNK|Q4xakB(0cEpn)9b$$M$IaKJ`&t@36I{ zdHrIsUG{}V+2SWpBr_A%B|2)gG8?snx0{qUx!@#gt9ABMoVPoIrGe@qK?R=W~iX7Hy#d+Ox5 z-o~1##n+duPntjd`?`NWgiWO)rYl@|!0Da5JwE<7+n2kyTH2)^zJI9iqT?@7v}nnp z#`{a7?rVLYck}E7MuwbR-L%ZFbtRsM_C;MSUn#@`w=a&cF)Z+kyMM;?-6}D4>y_VDF^J4pp0a() zi{EY6rz^Bf5V_=FC3EA?M?{lhCywx|($PG-a`ElW*;kw(~bo17G7HbIY z>zCN3@xR}9q5TyvQ@36fe+k7FDfxGw?=m<0na$s}@hE@UiqK-|-9J)m+Z3fE8D`?uUn@6&wAeD6!QHR>^;S#P zx`SrY6boB6ZG3)yHTwsp@5iT}diJR3Q9bXQZ~1Ku3=Q8?UOwo1J!!sI>i@9Gp07oh zxRjO7wo$A2b%0U%7XPgx+jtd^&M)8Qm>XBLY;N8j{9&QBxEcS8E649tdA#_^?=)fh zDeKy-6KCoe9rOO0-`6=|E$=p8cTIwXNq>movpW$FUEne3Q%6tUK2`tutdpQ`!X_t^#jBFz41e(@#x@1i z1{{sttsK1B{&K#(W0ceNf7@SIERwEe%?TFg{&)L1>!MW|_Ypmj>eCMA7yVzijFVwU zKHvOcz74x`-8@l@w$3cS^yKCz1 zi{&LAFI%(S{`cfJOEwj+dH!Fv^iBVQXFLoHLCf2ptk|*ge5iU}SN(_kuhi0~yFH(N z`i%F(>i8+j##*qWXacUFD~4T;bb^dbIUNz_8b@6w#w)G%2u&- zmlR&uo^ko$6jy<1YiCbA@|4RZ=T=DE<+8cH5ez+Iez#ilxmo9Rr7NA9CUJ;~@SEs+Wy5gY5>CO6DT$lbI3>GdO?z7;D|^46Z6aP}zc1KxLWW`FNUfA5ig z)wtS6LVT&2K-#{=`BM}a8iYQviZC#!iiE_lIT}pW>WZG^Xmo>zsX;+fR8Vot$~^}X z!sZ-P@N5#Q{WDc$(?i=N!$Vrpj=vV-jLd=l+|DS$tzJ{@>J5r+dG|l9J*;*!X!)eL4-BU^mBj_|zFXPqdNSN)>hilB zvn!{3-LGJ7dNU)QkJT%T*{bl{|J{%F9Gfujm|IbE@zW(=_w5#uj8_p7JubWJQ2yf^ zAs6qrZP|M|;ba=Ox5*_JGwH~@DTbl*CeB))dNujQ3;Q$+akV8=y}vJ4V2fm0m=VIm znt7O~cDdiG@84s7D=<7rzt^>6`MsOI?drCxcCF?4WoLSBm&*)cX~RRc3t~?*mYGdn z_V4$iZQZLxPTHHTT^VJ*dD-5xv%i_;n-$&5?R&H?*v$9Ut}nT<`XUdOuX}Hic{;ms zk^8Gn;tUNh4sShCIIr>AGUhqC?qBBCsjXac@A5LcIZ>~^dk0xM{M(qxmbKSy{`v?f zt@lrAgiYT!rh8?6*Xpw0`?{!3cY4f;xeFfMUAdOLc9SM$uHJXeizWE% zRkyQ;uAiC0nx#8ia{9CVUDaQIxITI!_}iM-%0_oq@Vr1h!@9(uZ*v3Z{(kpXLZv=Q^=ymRS7v+5CYmAKJk|H@j%cTtsPD4hZ>0a_kxp%O4!Tfb`mrYAR!zvw z#1$ua9hPyuYv+IW;QfPl?|05HFRP1|owGebZ|cGJagu6TH2>q=%P#+JO=dZnvey~LWo zAX=)>?)UkB@gFpN4J1VEg;bhTv?j7JI8I`5?bJB5Aba}@gXE3HU*%VQ*V|GB_nZU0FRbK%rV{E(3$Y)-ShSJ&Enr zpO>(B^`Q$dgqPfWen9&79i8P1*0J?|KHtvfcKdlwn#^6{oYRW?<7AY6&Y1LcQFUSW zle`P>?_BMwU$OiD7OQ{DXQ{I=w5)o%WUlu0@OajR!X+P*j_#jg8z$4cO6ttY+jd1# z>+j7ok=y#%ih+UW@ADS{vnCp!b^d0@!oaXH@dO`F&#Gg0(l1`MGs$gSb$Z(F*)P7E zu9cf4F>T_F6}L|I%}fi`7L+>Yth~;{$D=tdge#1#_P*3ZeVcR5yz1R;zVn|f^kdpE zYwQ2YnP=}_6%YP-Xo|1mx;k$+-Wj*=XO}#f#9pbi;MBdhvn3uSS})mJ`eDV_lSii* zqy~4~ZkQ^}e)iqvGMD>D`?)gT$*cI>G+BA~gX!WuZMRJMrMA93*?P3t>K02xFae+;p``5JD>tlYd&iX!o{j@Io(2GnfX8fvL@_zS>@b+q} z+Ps#&?wQBFR<{SUFeqr8>Gl_9=sx;r+VoBah6>e~MV-?cg*Z0dldCw!o^ZoY;?J93 zE!Q{xJw9s!!vWt~(Vr8vg$f_{?SHmg;^r>1^cep=GyMaf?qu(uZc%a}j7=eAc3a-3 zQk%-6I~Sew1lZ!v@tNzL^E8|HU|~^e@0vV* zX|2cbVe{swbNBZ@x^eWrb!^1$XO5nq+MZ6Fwt2mZoKHu5LV3d1KJglcgY7b(cmDp@ zx69)8pBw8wTZ%ADt*=|yy>b82jr*5AowHZdi6Jg(QP_)}wfyVZ(*Er-*z>ff+mroU z$)5e69Mt3)8m9jWc)Hwp_hWh8oZ2MOSpB8`VQXxXjNgY{diQv9i157v#tNhU52@d@ zCf{^Ry5`AmscS9iU3ckp^{$%8ipwj*<7M`hZ#cX5g0K1MA2(+%vzL!4u327wGwtTi z@C97*M?@oTONGT>T5v6ELin?TuURdppL_nJWb2wY&Q&eDKiNL>-@H}!`|X>rUr%HI zn}2+(ZMiW2{X0oT8Fe|!0?L{g7;2-#k)1;kdWkgr!$Ol<1KmTo--SS0u_k@?NT4N(2b&Pv^ zN$$4iN3Lu>%5*kO`L4&^cYS$T@s;ada3{@Ti``>!P;9?Z(}bGdkHs=kA`A_aX6E0X zc8cM`n%Vrx&)#m=T^y$-uFr4b$H1_?;kubS#{r|Sg@%Dl2@+N>r|vl`%phQ8`%mDv zjQb2GFWuiI+rrf&mTYZa=qVkqtjeTwTY5^2wm^d-!|65a*LRCKHhopFKbCVdZj;@S zyDanfzuoG|bf@ae<_eZYOgG)%dAy&hy|?#`%+hlUIX=I?D^R(<;EF2ehS&e>7k}Pf zboI=x?U@JJ1fF?spRdfay35NYU_#KUTRyRG)*jp@eaEWw=hNglPV)_f%W6^|8|hw& zDN_9LA?5Cwz2ZTxUM?3`*PK67^u4{LdHS6-dw--#Uef)rU?$hWYuA?4J=xWNmLJbw>=*tg__WchJ*o^2`}3y%>dZeUw=M0;hE@L~_e2Le*)CjUpISS= z*VJ8k+wU6Oq@b?gt6NhP1?|Qw&j9V5P&0~C@ zf7uko#;~AENIpfl zFnPo3eb-Xdx zJJt8{_S=aai)OFXO}&jXB(0n z9$RymksEV}<7TMe&~- zrqsGDk6l~sdG6NF<@=(3hppc=vX+OJ zdZfSb+8%FQ-Zrn<(B9HJ$#BZqd5-ru_DY7 zYiq8_Z82Dy*?-FZe|K`QDiedl*4Ovu?!SI*e`oQ}WAhHHE&F)pW%b5ybBr&SKM~sB z{fjMX7MpJbgBRbW{tY?lS9VQLS#S2=dIS5jbF&j>A5xE$`qsF38h`M%IlB|C+(@05 zc65r@XUA-@(u&`=`%cZToAu3iHQ$d_e)s$&!{<*cc^C0nR%M#!`~!sy3|H?9EX!P& z+aAYvT6}Byg*@wfpa1qqGW%}5!c#hXCBt17Mvk}Z?8`ej*52#6ka7QX;@d^vzTJ|& zzCKpzqX+{-N7uXKpZ3-n9y|Z+;&jKX@{S#w*X{N?ck<+6=j%U?=x$!WXQ_m$5Yx#Y zPd=A`S1I1ibG~ho$l$#H@+x1M&;6Cg;Y&U;a@@<|efPcU-doYWt#>}YQEp!n@$^wf zN6~rR4^c%$6~`02Pu_QwH(k8zyLP!sY4yxkcB}j)g?{bP%G1(VczO%-#LdwwHS6c? zzfyPe>xT8oUc0Alxxe~<#%&>+&8}&Ct8ZLSj!!(bY`&Z58SDSul5#h)g6qn^osqqF zdi%F!`%Mp;EBe^Vnyf2$xpLvOt$XVJe41n*KBs%uqz|RXTKCOb>3*yCed3!7k1q2c zFX7VrRXL9byufB^bQg`0E zS>|>&t~XCCYOcJMyuI|I;#pVE*}KnOv#&_nz&UyT9;=E;uReVi{u=j=n>(`hJ#+KQ ztgF>Ce(k*9FCJ+jY5sA>zVfW73lqwSXVwo&`Ozu29r zLF50KFBcEFaH6Z^m)9%*+(M9n$hjcYn>YT_5L~ ziJq*nHrw(je!gK%aLrr@>_Jto(Ie9 z!ehk+_xIMP{W-DpqH~{x?EInwC4ZN?_Gvxk59{N<`%=_4_SbpOo6|G9mkNO+}CHJpGDd*vmQ`5ZfR|(wbb`zeS$h`lnf{MVbb+&Bv zuN^ynF4|cu!S%y8Y#*9o6$o*q-q|`P7-4`m?L2Gu$h-+2Semruo;l z9h%GczOmkZYHxa(aS8)Nbac08@$3{!!-}AjH4D^>*ZkR&S@T8t;g77)`LmU_TEE$| zbKUMXjsMSf$xSvdxf}7iSIyP(V`-#nL%-)&=AHVJh5ja4F*O)GUl-CWe@Qi7is1ma zw^X0}3Oz@UjrtRAt5^Iee^L_rU*aRnzKL4=s?NWAJnAk@ywMpQWN+Xh%6(4_pvzI}U_f4IB;a#H{E30?;Z=G!K8-z|<` zdBWjs+vk%p&Cah%Zd9koeqY7BZb5{fOswm_IYCdS@}yj~Z-CE37|Bn#9_ZRKFU2T+ z?yO&XGHWL7?p7>~DldE55_|SVMEl80YlYsHmHK^c-nHK+DR=_sPvNDlr{#HnUHec} z-;!1H?vCBEw+_-1Q<&xlsBP*0tfW_=ZTkDbjOB*Oc`Y|h(pP?2k@Y7c;TO-Wmin5|;`MGc2Un-8y*~Z~8Mbd8T?G0HAKo|1LR<>pmGw)K9CfBi7A`&eST?$E@LnyO2Oc6ER4h|c{#TA^(BRs*Q<{`TX*(VO=hTV5VQR@ z?vS_KPrkAK@K*b<)T{hw;A3IceEToy)t>s*#LPGD^;e4Z-*!-|WMP}p^bC2&Meumb@nxKqH ztgb)#4_EPR+${OfxZvrHYl=y+7jkr@**mhnYwoP&Imu$T$TNH81v^>ca^tJn{Q4=~ z3=NaxugP2a(tL=_-opdKcS9R5oZ`&GvZmeBg#l+BYN_hJpyQgbDKT~GD zG22O5H$DDl*217)HLdSg$=aH?MQwcYJ$m~7fYnBC7sZ^2p1u3avt8cjRR8~R5>GZ` zWLRakKQ`vpN~OpTkLHB!X0v3J$!@$(F_o(Cy3EVcd7&k%0@Sa4f;``25U7w$d(vS%AJ-?3l4*RBKyPd@ur z*<^NaiSqjwVQL>VK^@4Vx|;cKSw$`%x?f$co|<|o_xX__^4PCiMrVYZ z-dlJ1m13vy5wmGldk>lA1#NoV@%c^Cyp@;tOY`g~*XN6yIEh^$>2-f}+A3$2FgLby zn$NZs+}gPC{;|c>xzNtxm_(6-fevG?cz46LyM&M`_0|5;qOw@ zveMgU8dZhG(-{tZIbq)v{pD_X%7(o~el2%)Sl?n>n=QY_AU;uHeooecluZeFekXMo zozC+1ZDLS=&%nKM^4cKj=hL*M{`0@{e)_GDOI7HH$IJ_M2{(D)6~;b_zA!7PH`*gl z$MC`F=P@dBpWfE_zF~81GP!xep+z9;f>e5JQ0u~%kJ1lw`g%OSskzH;ahmbwa+AVB z9$o9|zfXQ|5BhyGTB~FC;@k^T9s-=&`+U`fPINPd2%K=gT_Zb*^=VGb_K%CtvkCtY zaC))Wdzhzm#H>gwo46;cB}Dy`0OI8RJkvg zDc)9zSJt`M=_|NpGw`Z(cwLxUh3Z2`M-cS1F7s}66cz*8F#OAfKRS}k7KF<4h ze{mAmk)$+xy>DS&2VL!Vzcf5LzkJVpKQ*48tCxS}vcD5=oj7Byuer8({r7+MZ!50_ z{0ll%@i6}d`>D6tdsyxid3m`iQ5Y6x4A;~A~SAZkEp$Q$L`+i&|0TO zf5YTwy;`7p#_o5vM@HC*sj~an-uHiznYP!gYSY)>C*&4)o6nmYaQ(CYqmSE6GmGaZ zub8iSU&7%-(cu}KYf_(UKlR*|9sxZ1G^&rdyl zKAp9<(9`u`-FBWF8P+*}K4>n^O3L5rvA`ne&OuJunA?g0|{cEP2V_%kebJkp~$$o1B zmBc6sY~`VzempI*Y&K4)vMX}l(UsD&5<(x zm9#I@NKyYX;OTgt%a&LYf*APCO|3!I`LQupX&BSYy z;~swsmwWl*PQs-5`~4T~dGb8<+2gaTrcDgUzqv5;+*^~Yo}q@Duf12cuD&bSzt`5( zqyK-+{E$y?XZ{P2&DY*;zOC}a{@vnP8&^DX-~ToGbNqp4|9Ri)&MNqJbVp~|pCfZG z-dfxz(LL||r29t3#s6DOH~lYt`Aj&g=YMr(RcFE6%XP=(U3Ajnn$q zEPjM&tqq^@U1#T-r!2)Mx9jB|Fd}86(tP=nh1Y7H9X6^wn*Pf>PuTcLgzugW8pZ!v zW|^dYIhqjL6u=vFy5{@OefwS=I9c=i`WKD=iyFhzOn$1VFA#Cz>b5_6A$Mn5>j4>m z(|W~8^NYNX-4o+-Q2*YS^GP@4=Z98T08aHX-p^b1m!_y9AzD9}=~`=xyd+28BtH?ff&hrfY_; z*>I(mrDWqVvjb-D?_BqrnlMq1@0VDv)r?IXhc=aNp0p#T(Q>zI`@3ge3<=LJ_Zhyv zxLIuLGvnv!7oUipPO+#C<6o(ldFDm&pb;qKW^MGLR z>0^HvmKChutm!;s&(jAkqWd@Bjr+bT*`#pB>|jTy?H4t_opZVMdy&Ydr^|fb+FrGI zzFN6;u1w5*TdQcMs z9DZZdo|=SN(;ThlMiicT@4obF*maSwTyIoMbJv6(y*5YA(c$Q+@HdAQBy-pp9VYa2 ztyb1l+;5cWs38!fP`fwfsDf&^gW39s37>o%+lp&1&A6z3z&MEGVzRmUHjyW``b#Xf zsxe&tD{<9yRzR2x3of4b;-ic zMj;NPe7TCCxSJu<4}J@ucCPxB(ZaoIf!?P-eQL~%o+i2Z&y4t15f;AFePLD`rt5i2 zhRkU`mg#ynqSkyezr#nPJh?dO&yLIeHXbwG@m|mMn0Tkl(Zcq1A8uRR+_tjxyVc&T zr1iV+n52DaeehGL<;emqzsKP%zskN{QRKKFeaXM}{?|Vt-Q`bZt;5wBoW;)G3%z(` z$?D!&t*d8ha(7HS+v6P^fApzM-ND&5k61Y!3N2%{7cn*jeHNQL+mOK{xcccKkv@hi zS$2B`r`^9-_VRu9Q75s9|EFCxj1fWYpQq!_$1jmfJ$dX**YQ86*sgXRy&bmr6PH^wJe$wp)-`%r-YZDN)Owx?dt80z3<+>ygcLL^v3y*6lJl&AnwD=u+{p-M*Ic*cJX%||tn~GKJ55IEb!QVLP)%w-@!&@$dyI1cI z|0BbWd4|uz{=Q3VdwoLmomS+5S70$PfH!T=F!yXf%;VR-&U4XTZAqsW-iJXOIF5w4 zyi|KS&RlKb>Z(q4~dPz#&Z@>LttUm_N-+0XJ*V)q2DK8dP z-P|O(=YCZZhiL(5aovQRDSEzX>vK}_pj~Vw>8skZ`P~9R9QMcYEdb^WD{-3vv02ZD~kSo zyjXbF@9g{CpJuy$@9Yx(-g5lug{!KM{0+ZYuf1h*!s(@UKi@)qZqQa1A$JYw>VJEx z81#$kV>Dww$c4_^@_qZcb$exPm~Qdd|M;@8q$Yd2&zh zz%|Q)7uTKyExZxT{peHi`g602eyH}RO)xpD^kwdW-=MX&Cfinav(~@<%rx=%>$!@8 zzfSAV{}@)cb5;C{I}y+8efWBihFBjhc|ZB?+}Yov@{5l!|Ng(d{P{z}yT6%_+o!7; zM^2oep{TN=<_w<8@gU=-QHc5TcSc-m%duG<(B*@*SFT8u5Wk$ zSZOv%Als}n$GG^Nyod5+!I%0kYd+T5{+ng|{P$m;dFuJkd!DPDd-uiZ{d)J@d%JFZ zzc6Lm1>d;f#w)&_1o^m_83V*lP56_1fbakvQm-N(lkaK-OSZr2xhMMzV zt9_=kmAq+rRhxJ^VjrwMnLEf{c?UGg}UacW^AKf|X>#*ga%Rs1Nr%&l+s!Q{u&`VVnePx;QO z%8B0fbdsyfc^{umQ%-*Wvak9=&7n{Bf7Ty}x!@zWY|WFB)$`^~OIsoEAYIJ+(7U7R zMxSI({Vw~hSZSpomk^`R$RH>fed+vO=`G(b90{=6P&(gpHCyYB?vA_7-|zI)KI5Bf zvLW_(Alv5fjQOs`x1U#6-M5|5^!r)$kNCR{O!v}0th~Sb+#S2KyMCCxyZG?Z6TiFK zQ$ByGU9%{Ap7Y$==$`1>=NE1AzWKB7i8!<0@<6=X<+pn8TlpjRWVn?2Z-2CN%BOFC z7RSCiX0~!#kk0C}c6YvX>27d#$=JB2tv$%k?beZ#(%1fc-msb7(XhHWa&ow`*434- z-o0^T5a|yVPr3K(b+Oylv%i(T7cww3XuS|(U|7Jli-mzn!vB4J$A!z^xI_)S40?PX+CCja8i%NYVTdF}E3 zwdGrWr1|O{VbSH6X2r#1KU94BYSGSJ5^c8eH*YpCm{GY)N^7dIbu|}*>gprAk6c}H z^-H<-x~p}6OqKWEP-5p-Z+0}6SR(QN8Y9C$qniD6_3)ectccY~&pZErzusSDzl!~5 z*xE<0-e@k^@D%Pr5(j z(#oAP_uTQltz2zYEx_O~u~43!jxja>i3G*Uo#M7%AKdzBJ!#Fkd4~L*UsLr9QaU=k>Nq&rxT@}re;|Ilkd&{ zn)}awtM>jI<=;AW<$H1hR~Mh%kSVQq`^)U-`=x(WMR=^QI{5e3Ig80frRR?u`^}&C z+wu3a{NB4W=M@&jeLq$!b@g4`_J6lG_oclkU!U!5YrFaR>C#o@{JfQ)=aydAN$Tyb z`g^iZ_*a?q)vcBP-wF4r+)}y!%e*8z=gMo|UA~exl3kV`tKC&optJPBcMF*x*RGlO z>%YCf#{chud9ijH1>zf3uk0@`EamstGNH{`Bw_gOqejC ze$V#0@Fz>A&0Dv1*V*5h5BCLom!IeQQFmrr%kFiHQs)18vY54h@6OL}F8%eEdMo+s z=QWpDmFK6PW+neC|J1ei{q{RXe>W>I|36v$sh;Ms?XI@v z_d+oS2Gz4iZ!%jn?u=R}ib$wtQ^=G;b=2 zy7)B4-nyp0SW;z&yZd8~-?4h}_8X#a`S5-<%ebWQ=%>{2Bhym8dwtSxoyW@H&{-|A z+oflno1mbfM6X-8xZp(-ao_DP&6@p>oH?IvR=)eQTlAlmcP3w|laVc5^LUHy-@m@$ zX62R7X6S0CRXv}$`Fzx!c`x>V`hD!@whJbL7j-SeVqILer$v`;jK42c?b5R>`fvuD z@Aj8`_Z}xC?Dk*Q`B(4S>G({x&D~|$!kfF*7J2>)fA?I6fx+w6;tKiWjB7&{bM)uV z&--f|?6Su5;>C^TrJJXFhb1iwb@?(!TCfWQ=D*ryzi-V42b9YC z=@t)!Y;q3mRnUu8V)A`8Tb8T4|82CljO=naeV(=llNiW86}xt!mAk>9tgx1 z$$$B>L;haKaMIrlKYX8d%oqxwUSa2 z->MgpM%4@q3*^>K7dbR-L(Q=z@j6POZF$k#-Y?fLbE*Fy`u&oU=jrzPVvWD&)=s`~ zQhwjBs14ye=EuLUGhP&&tE99jeO|QL>h!&SPi+tX-Lrdpee%_h(z~AA%jKN=>Ei-( zC$HAuKll77y0Wvx_WiQ0_BSlbkKe1b{&w#6mKD*wo0qJUeDz%N-S_R16P?+ve&PAf zFK1d?e&-wK;rSZE@19?OzIA=l`(2SqJ9pK+nQ-A!Wm};^XT;?CSr(h-mG6kZDPHAk zH7Vol=8nbAebaV*&thP>Bfe{ifaLN2#YXNfQu{u5%~-Ccq_;1(ecNgkrSNb0r~b;h zpV@Wv`l~Osdkb4U*@`?JcC--tBudjRF(NXQXKd8KJeaxxQFM@)e`=`__ zH#)U#_TGXMJ666w|1LI4CG+YXWAogTx9x8i#i~45yD|9qUJJXd0O7?;*2Zp8`*%(= zZtb&mQubd@C)(D!s^sPSgw2cns-2#^$p5&@{C|Hx%-mwX&U%OW%+JYJKIQ*^r?2$r zZvNBh+1K~~oin}T>7Rc$-q@eh6Wy0^dWt^VBt0RBE z|FyLZ|4nfGr`VonNKb$?~1N3(!am+NRXw) ziD2Q?(UJZWv#0rZ-;=g1{U`go@_JGIp9KHCwO$zonP*=-eXOb!w6b!;ZVB5{l^sj& z*6yl5>)`Ke(!b!>zD-KDZx1cKFU&nlMN#$lEMFHb^DpJ%hQC;@YU=;i@9yX@{p-}& zzQ$apZiN>g*yS%KIqkUqHtcrlCAP(oFdCqR01>SYsu=Dj|uH(D=vnOxOcaQ0tUH_Y3-8bju z%FeKLe@~cxuC|NS&HTHjHF){jdj+Rd*Mx6gweI`o)OX*#ll

&kwrt|Hh|^?}q;A z|2Em0{r+YUw~y6-(bV@=zg`FW|B`+b=J)?$M#AroO*_3UtV;U%OZ%@fFzoQ3weEH6 zes9T%tNY`9&b|>4eD%ihoky(wqO|YK*Csgr{`Q5-$g*0hqa$LIj<9dgtU8Wbi26jI_+uG@onBaV7QS zHmhnDh6D4zG?aR}>^-%3-yO^6cS6(onU-$l(^K^;Io fk~)B0|C#J21=sCy5{Y17U|{fc^>bP0l+XkKwQa?z diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst index dc4d5125d7..117a8b55b3 100644 --- a/documentation/overview-manual/yp-intro.rst +++ b/documentation/overview-manual/yp-intro.rst @@ -264,10 +264,9 @@ with the string ``meta-``. ``meta-``, but it is a commonly accepted standard in the Yocto Project community. -For example, if you were to examine the :yocto_git:`tree view ` -of the ``poky`` repository, you will see several layers: ``meta``, -``meta-skeleton``, ``meta-selftest``, ``meta-poky``, and -``meta-yocto-bsp``. Each of these repositories represents a distinct +For example, if you were to examine the :oe_git:`tree view ` +of the ``openembedded-core`` repository, you will see several layers: ``meta``, +``meta-skeleton``, and ``meta-selftest``. Each of these repositories represents a distinct layer. For procedures on how to create layers, see the @@ -385,7 +384,8 @@ Yocto Project: - *AutoBuilder:* AutoBuilder is a project that automates build tests and quality assurance (QA). By using the public AutoBuilder, anyone - can determine the status of the current development branch of Poky. + can determine the status of the current development branch of the core + repositories (:term:`OpenEmbedded-Core (OE-Core)` and :term:`BitBake`). .. note:: @@ -437,12 +437,12 @@ Here are components associated with the :term:`OpenEmbedded Build System`: You can learn more about BitBake in the :doc:`BitBake User Manual `. -- *OpenEmbedded-Core:* OpenEmbedded-Core (OE-Core) is a common layer of +- *OpenEmbedded-Core:* :term:`OpenEmbedded-Core (OE-Core)` is a common layer of metadata (i.e. recipes, classes, and associated files) used by OpenEmbedded-derived systems, which includes the Yocto Project. The Yocto Project and the OpenEmbedded Project both maintain the - OpenEmbedded-Core. You can find the OE-Core metadata in the Yocto - Project :yocto_git:`Source Repositories `. + OpenEmbedded-Core. You can find the OE-Core metadata in the OpenEmbedded + :oe_git:`Source Repositories `. Historically, the Yocto Project integrated the OE-Core metadata throughout the Yocto Project source repository reference system @@ -455,34 +455,10 @@ Here are components associated with the :term:`OpenEmbedded Build System`: Project objective of achieving a smaller number of fully featured tools as compared to many different ones. - Sharing a core set of metadata results in Poky as an integration - layer on top of OE-Core. You can see that in this - :ref:`figure `. - The Yocto Project combines various components such as BitBake, OE-Core, - script "glue", and documentation for its build system. - -Reference Distribution (Poky) ------------------------------ - -Poky is the Yocto Project reference distribution. It contains the -:term:`OpenEmbedded Build System` -(BitBake and OE-Core) as well as a set of metadata to get you started -building your own distribution. See the figure in -":ref:`overview-manual/yp-intro:what is the yocto project?`" -section for an illustration that shows Poky and its relationship with -other parts of the Yocto Project. - -To use the Yocto Project tools and components, you can download -(``clone``) Poky and use it to bootstrap your own distribution. - -.. note:: - - Poky does not contain binary files. It is a working example of how to - build your own custom Linux distribution from source. - -You can read more about Poky in the -":ref:`overview-manual/yp-intro:reference embedded distribution (poky)`" -section. + Nowadays, the :term:`Poky` **repository** is no longer updated as + :doc:`bitbake-setup ` + became the preferred way of setting up the repositories in order to build the + :term:`Poky` distro. Packages for Finished Targets ----------------------------- @@ -631,103 +607,18 @@ Reference Embedded Distribution (Poky) ====================================== "Poky", which is pronounced *Pock*-ee, is the name of the Yocto -Project's reference distribution or Reference OS Kit. Poky contains the -:term:`OpenEmbedded Build System` (:term:`BitBake` and -:term:`OpenEmbedded-Core (OE-Core)`) as well as a set of -:term:`Metadata` to get you started building your own distro. In other -words, Poky is a base specification of the functionality needed for a -typical embedded system as well as the components from the Yocto Project -that allow you to build a distribution into a usable binary image. - -Poky is a combined repository of BitBake, OpenEmbedded-Core (which is -found in ``meta``), ``meta-poky``, ``meta-yocto-bsp``, and documentation -provided all together and known to work well together. You can view -these items that make up the Poky repository in the -:yocto_git:`Source Repositories `. - -.. note:: - - If you are interested in all the contents of the - poky - Git repository, see the ":ref:`ref-manual/structure:top-level core components`" - section in the Yocto Project Reference Manual. - -The following figure illustrates what generally comprises Poky: - -.. image:: figures/poky-reference-distribution.png - :width: 100% +Project's reference distribution or Reference OS Kit. This reference +distribution is represented by a :term:`DISTRO` configuration file found in +:yocto_git:`meta-poky `. -- BitBake is a task executor and scheduler that is the heart of the - OpenEmbedded build system. - -- ``meta-poky``, which is Poky-specific metadata. - -- ``meta-yocto-bsp``, which are Yocto Project-specific Board Support - Packages (BSPs). - -- OpenEmbedded-Core (OE-Core) metadata, which includes shared - configurations, global variable definitions, shared classes, - packaging, and recipes. Classes define the encapsulation and - inheritance of build logic. Recipes are the logical units of software - and images to be built. - -- Documentation, which contains the Yocto Project source files used to - make the set of user manuals. - -.. note:: +.. warning:: While Poky is a "complete" distribution specification and is tested and put through QA, you cannot use it as a product "out of the box" in its current form. -To use the Yocto Project tools, you can use Git to clone (download) the -Poky repository then use your local copy of the reference distribution -to bootstrap your own distribution. - -.. note:: - - Poky does not contain binary files. It is a working example of how to - build your own custom Linux distribution from source. - -Poky has a regular, well established, six-month release cycle under its -own version. Major releases occur at the same time major releases (point -releases) occur for the Yocto Project, which are typically in the Spring -and Fall. For more information on the Yocto Project release schedule and -cadence, see the ":doc:`/ref-manual/release-process`" chapter in the -Yocto Project Reference Manual. - -Much has been said about Poky being a "default configuration". A default -configuration provides a starting image footprint. You can use Poky out -of the box to create an image ranging from a shell-accessible minimal -image all the way up to a Linux Standard Base-compliant image that uses -a GNOME Mobile and Embedded (GMAE) based reference user interface called -Sato. - -One of the most powerful properties of Poky is that every aspect of a -build is controlled by the metadata. You can use metadata to augment -these base image types by adding metadata :ref:`layers -` that extend -functionality. -These layers can provide, for example, an additional software stack for -an image type, add a board support package (BSP) for additional -hardware, or even create a new image type. - -Metadata is loosely grouped into configuration files or package recipes. -A recipe is a collection of non-executable metadata used by BitBake to -set variables or define additional build-time tasks. A recipe contains -fields such as the recipe description, the recipe version, the license -of the package and the upstream source repository. A recipe might also -indicate that the build process uses autotools, make, distutils or any -other build process, in which case the basic functionality can be -defined by the classes it inherits from the OE-Core layer's class -definitions in ``./meta/classes``. Within a recipe you can also define -additional tasks as well as task prerequisites. Recipe syntax through -BitBake also supports both ``:prepend`` and ``:append`` operators as a -method of extending task functionality. These operators inject code into -the beginning or end of a task. For information on these BitBake -operators, see the -":ref:`bitbake-user-manual/bitbake-user-manual-metadata:appending and prepending (override style syntax)`" -section in the BitBake User's Manual. +Poky has a regular, well established, six-month release cycle detailed in the +:doc:`/ref-manual/release-process` of the Yocto Project Reference Manual. The OpenEmbedded Build System Workflow ====================================== @@ -868,21 +759,15 @@ helpful for getting started: - *Poky:* Poky is a reference embedded distribution and a reference test configuration. Poky provides the following: - - A base-level functional distro used to illustrate how to customize - a distribution. + - A base-level functional distro (:term:`DISTRO`) used to illustrate how to + customize a distribution. - A means by which to test the Yocto Project components (i.e. Poky is used to validate the Yocto Project). - - A vehicle through which you can download the Yocto Project. - Poky is not a product level distro. Rather, it is a good starting point for customization. - .. note:: - - Poky is an integration layer on top of OE-Core. - - *Recipe:* The most common form of metadata. A recipe contains a list of settings and tasks (i.e. instructions) for building packages that are then used to build the binary image. A recipe describes where you From patchwork Wed Dec 24 16:31:50 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77467 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 084D0E776F5 for ; Wed, 24 Dec 2025 16:32:14 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123199.1766593925905127120 for ; Wed, 24 Dec 2025 08:32:06 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=CDEet0YV; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 54DDA1A23E0 for ; Wed, 24 Dec 2025 16:32:04 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2D1386073D for ; Wed, 24 Dec 2025 16:32:04 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 615E610AB1384; Wed, 24 Dec 2025 17:32:03 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593923; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=UgLyueh8X/9Gn33TscFMLN5imSv1eRgr70bb4TR3xC8=; b=CDEet0YVnKGhlKgsRzOYRBOzzsbJUSkTWDYitUQUdkGmlo+9jrnuQPFH6jrNkCM5T3fSaZ h7/OoU0Ezt3ZGLbKtj4BFphLJdQ49xFcI2tpsepQQn3wV9Iv9DOjX4hVhsl2g6Ef3ZmY+u y+itvvO8Hd4d0MH55FoVfAwPZYHe9cZ9vVeqk1WFULj7cUawnM0rUm1SWE8V3ofnteLW5y V9HvhaPNglQbodAm9xaTrH1rPv5hG88A6qvSsL+Sd3f8QcNbame+f1g/PxrngZA5xaBJWk qF1TWvoynOrOm+iWMVm2VLOodifQlCzvvZA+RCp97+K2PyVTL8mPodzdATOWXw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:50 +0100 Subject: [PATCH 24/53] ref-manual/classes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-24-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6191; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Wx67zJJweKrxnKziIHi0SdDE/LOGEemZ9NyZy/o0CdE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVrPAT4tXsJOrg1qwpK9A65g1D/tuimBMgOp IgV3D0RzweJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVawAKCRDRgEFAKaOo NqASD/9dVYCcTZQZu7IvJhXQAEtyv/s7Ae9M+8n5xHLyCT/Sejj3zTydqO9HGdwPhDDB4rX/vM7 /8FuerEO4zysb3+sccECll+X8TyazUSMy6LiLkZzixoFNp6c5QPHBKfrgv/YicCcMQlHkLjR52B RuPHR+4lAioyvVyBZkB8Ir9Gobge9O/mO3wS4TDSDaAf7YKYIuN/TRLwiWvNgG2D4Kdh4ob+v+1 1dHTA7jVcXU/azGcd8cyIHYv4qy98RMV9hOVSjdBiu8PEBMtAHvHZLlt3zilid30X5LcE9J/azG uIFQLqZZ9Gngc4jBzQtcsWID9L2qRH+6C715nP/7K0Z79B+/jyWmJWAvwIbpc3gS3YoyDxs7Sej wyUHrPSBXuEY6mOfwZjjsoWlxjGgCq15Ifzlb6v5VyL0jplNIXK94XNw4/8muwfBZXL45EJfTLl ddaTsp8H402f+Vz3zk345KI1qtsqVyqO+eRsRxEnTde5E1OQ6l+2JrKMiQTyP+YEEIH9uaoArxA revxSwQmGAqTD/1mY7k0u6kIPFndbs3iu/Ojor3+XpALHQUW2oQST3BUNPATJLDQM+toYvcO6kr vkLbLctccZgdNafO9xEj8oOzC5gUBUkNzHefUD/K5ABbJRo4b4iNWby7thgMDrUlYnZIV6Tv2uP 9r6idt7JuW+pnjw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:14 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8353 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/ref-manual/classes.rst | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index eae15fd62..bc98e2575 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -9,12 +9,13 @@ amongst multiple recipe (``.bb``) files. To use a class file, you simply make sure the recipe inherits the class. In most cases, when a recipe inherits a class it is enough to enable its features. There are cases, however, where in the recipe you might need to set variables or override -some default behavior. +some default behavior. A class can also be inherit globally (in every recipe) +with the :term:`INHERIT` variable. Any :term:`Metadata` usually found in a recipe can also be placed in a class file. Class files are identified by the extension -``.bbclass`` and are usually placed in one of a set of subdirectories -beneath the ``meta*/`` directory found in the :term:`Source Directory`: +``.bbclass`` and are usually placed in one of the following subdirectories +of a :term:`layer`: - ``classes-recipe/`` - classes intended to be inherited by recipes individually @@ -28,9 +29,9 @@ in :term:`BBPATH` using the same method by which ``.conf`` files are searched. This chapter discusses only the most useful and important classes. Other -classes do exist within the ``meta/classes*`` directories in the Source -Directory. You can reference the ``.bbclass`` files directly for more -information. +classes do exist within the ``meta/classes*`` directories of +:term:`OpenEmbedded-Core (OE-Core)`. You can reference the ``.bbclass`` files +directly for more information. .. _ref-classes-allarch: @@ -338,8 +339,8 @@ The :ref:`ref-classes-cargo_c` class can be inherited by a recipe to generate a Rust library that can be called by C/C++ code. The recipe which inherits this class has to only replace ``inherit cargo`` by ``inherit cargo_c``. -See the :yocto_git:`rust-c-lib-example_git.bb -` +See the :oe_git:`rust-c-lib-example_git.bb +` example recipe. .. _ref-classes-cargo_common: @@ -602,8 +603,9 @@ inherited globally from a configuration file:: INHERIT += "cve-check" -To filter out obsolete CVE database entries which are known not to impact software from Poky and OE-Core, -add following line to the build configuration file:: +To filter out obsolete CVE database entries which are known not to impact +software from :term:`OpenEmbedded-Core (OE-Core)`, add the following line to the +build configuration file:: include cve-extra-exclusions.inc @@ -827,7 +829,7 @@ See these variables for more information: :term:`PV`, For more information on the :ref:`ref-classes-externalsrc` class, see the comments in -``meta/classes/externalsrc.bbclass`` in the :term:`Source Directory`. +``meta/classes/externalsrc.bbclass`` in :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use the :ref:`ref-classes-externalsrc` class, see the ":ref:`dev-manual/building:building software from an external source`" section in the Yocto Project Development Tasks Manual. @@ -1009,7 +1011,7 @@ this class is controlled by the mandatory :term:`GO_IMPORT` variable, and by the optional :term:`GO_INSTALL` and :term:`GO_INSTALL_FILTEROUT` ones. To build a Go program with the Yocto Project, you can use the -:yocto_git:`go-helloworld_0.1.bb ` +:oe_git:`go-helloworld_0.1.bb ` recipe as an example. .. _ref-classes-go-mod: @@ -3471,10 +3473,10 @@ is one reason we don't use static linking for our :ref:`ref-classes-native` binaries. With this class enabled, a tarball containing a pre-built C library is -downloaded at the start of the build. In the Poky reference distribution this is +downloaded at the start of the build. In :term:`OpenEmbedded-Core (OE-Core)` this is enabled by default through :oe_git:`meta/conf/distro/include/yocto-uninative.inc `. Other distributions that do -not derive from Poky can also "``require conf/distro/include/yocto-uninative.inc``" +not derive from :term:`Poky` can also "``require conf/distro/include/yocto-uninative.inc``" to use this. Alternatively if you prefer, you can build the uninative-tarball recipe yourself, publish the resulting tarball (e.g. via HTTP) and set :term:`UNINATIVE_URL` and :term:`UNINATIVE_CHECKSUM` appropriately. For an @@ -3516,7 +3518,7 @@ To use this class, you need to define a number of variables: These variables list alternative commands needed by a package, provide pathnames for links, default links for targets, and so forth. For details on how to use this class, see the comments in the -:yocto_git:`update-alternatives.bbclass ` +:oe_git:`update-alternatives.bbclass ` file. .. note:: @@ -3549,7 +3551,7 @@ that contain system services that should be run under their own user or group, you can use these classes to enable creation of the user or group. The :oe_git:`meta-skeleton/recipes-skeleton/useradd/useradd-example.bb ` -recipe in the :term:`Source Directory` provides a simple +recipe in :term:`OpenEmbedded-Core (OE-Core)` provides a simple example that shows how to add three users and groups to two packages. The :ref:`useradd_base ` class provides basic functionality for user or From patchwork Wed Dec 24 16:31:51 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77466 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 DEDA9E776F4 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123200.1766593926411396934 for ; Wed, 24 Dec 2025 08:32:06 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=VHA/P7HE; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id CFFDB1A23E2 for ; Wed, 24 Dec 2025 16:32:04 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A81746073D for ; Wed, 24 Dec 2025 16:32:04 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1B51B10AB1381; Wed, 24 Dec 2025 17:32:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593924; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=iJMse+PMZ0ZvdJjvEtjln5vrldS7UvpTMDTMuKpMFEY=; b=VHA/P7HEs39whNX6gYHLOUuuPupIXenV3DTkMpRMq0RdFDUJQXc3V3CxYjBESa/XMWrcOs 2C/mmTY477ZGKacij2ZnGP7oSSsp7a/jJH4DMVxccb8zlgQf32IsDyhIPHwXlPyEdd3n7O O82f4j9J6jf4EIfOsKtXxRXKNOPG6snTJnf+bVLVGKVmqIUjCInTu1qHs16UGmoPlUeO8x nbPHNtSMSPFw3U3ZZajFkFS1uqKt1ANQ6OjU2jlWvjqk3j0Yr43HS/GOCA6p3PN84iIZc/ S8HvhOQFkEwyMC/9Sd8p4DbFSobO3aN/SH2RuHxz8dx7mtkl/S5s1w2GLmk9RQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:51 +0100 Subject: [PATCH 25/53] ref-manual/images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-25-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=981; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=LkpDi8B5kDGnHrRMfCQ2dMIRYGVyaKI4i8q+mC6QV+o=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVrtIE3zsVRdL5Wv3ovKdoEa1sYyit555lV1 vkQNlN0g3+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVawAKCRDRgEFAKaOo NqjBD/wJAD5U2r2RUwq2RThkGnwyY6cEIfiY/cRh8ejpXpsaNr4CVS3fSVeTr/finnp0Ij9VkyX obWq1neoA+FraJzbDPpAT2AUmA5MBTL64K6TjHLrTvGG1nG0A3oaM8+o9uukDodxHGVrOwv7QeL icnxd1vIvS70fdgUe0qNrG+ciMHjnxIsjzbdheLIBcR+sZ/NphvhtUMW1L9J/ms0m3h0LTMP2Cd /c2ZJexIU0qHrGeCjCe/g5ggmEr3SR74AKjy48KM504KOCNCGNxiATh7G07Y5EpuXh6YeOKrYhM PwbqKPyp3iEjuQnoN07QgKpQG64Tx4E+GbDnEhXR+iK3OxV7siVYUjoVUlPjMTF43s5dPcRmnjt jajzcOuLnSGlVE/v3LZSttt2yGaurwGFphin1W3qcahS17yxZieWr1gar2OxrPx4RbwnK5k9x4p ko8BHSHlcZJDOuQZzol95Q7lEf74rwzl1UX/mXfdgL4zVQRLsUNoWBvROMzP1swrc+XE5P8Yizr 6khTkWkhWRFx1O3FfNtdjqEPFVo8PhPnGUC+X4Qc/3DUPcriIsRH2aZiJ6XMEDHYJ1MLnLiP3SP L0mznIRfm3RRIZuRjGLH0JDbpvo8YJvVqOf99IWf+mVcQUBzHtTAMM8XmQ481uDUIYlBIiY83zn Ta7zU45ox7MWMKA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8354 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/ref-manual/images.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/ref-manual/images.rst b/documentation/ref-manual/images.rst index c9d898926..94e412de3 100644 --- a/documentation/ref-manual/images.rst +++ b/documentation/ref-manual/images.rst @@ -26,9 +26,8 @@ image you want. INCOMPATIBLE_LICENSE:pn-your-image-name = "GPL-3.0* LGPL-3.0*" -From within the ``poky`` Git repository, you can use the following -command to display the list of directories within the :term:`Source Directory` -that contain image recipe files:: +From within the :term:`OpenEmbedded-Core (OE-Core)` Git repository, you can use the following +command to display the list of directories that contain image recipe files:: $ ls meta*/recipes*/images/*.bb From patchwork Wed Dec 24 16:31:52 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77468 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 CDB39E776F0 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123729.1766593927358459602 for ; Wed, 24 Dec 2025 08:32:07 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=fxMJW8Uz; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id B2FDA1A23E4 for ; Wed, 24 Dec 2025 16:32:05 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 83F5E6073D for ; Wed, 24 Dec 2025 16:32:05 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8D41310AB1382; Wed, 24 Dec 2025 17:32:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593924; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=cdpcN/U81r2664r47pxtl4brbK7USOLYrt90PEyF5jk=; b=fxMJW8UzlNCotN+blWDwDyIMym5ikZsdqgMSJM/6D4cqHSmWQ9MvFNiTB/slvcZy7j92pH fd7KIzU0718+hibMB+AoYauHFrFVmVtKXjdw/oKgw6I9mV4dF+yw7s1HXlRL9uRHh8MGlJ /lGA7eA0H48y6E1dwRVp6KIrWTbevfQEFYU9xN52xYN+uUWcP1PRchhgCDN6+iBJPvFyVj IUBOHy6XK200LZ+IhgIwMiJe86Ap6DwKfavbieVVmKTbV4DuPDLTOylWzL1F5b6E2pw82H Wh0bU1CBuSdJRcNyxVDPP0QvLHMrx5hyrp40efitGkJMVWx4ScbyRYFGxXgk7w== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:52 +0100 Subject: [PATCH 26/53] ref-manual/structure.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-26-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=15141; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=KX5JlF81HFtZ+GqIXWw9Sc0fHs88iUQQjxhxS7YNMlY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVrssszfEub9xU7yl3HWHpquouPZUMXAQDax OVpuw3Aw9uJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVawAKCRDRgEFAKaOo NmuEEACwOzq7TbeHqlaoTiWd9tXdt3wyvXvbn8uLrzD2QqR8d0RVAUF1zMi8npxbOv/pxjcH5fw 4MTUzKqsFmBzsANN+R2seYQ/SLoc/Ag8gIsisNwUFMNmkDFel1PaXy0HePAWYmFORi2BujEQ9KM 6mAcdlq5HiEt+Fm/1i6TMVcbgtjYeibV5AHLIRq6ksK2k9EKUl3cdabPv4bcLoXllFAgTbKixza i9+x6MMOwPobv/dEJBszNjnfFN13inwpAdr0g2b4u5H+ul5NmU2HSDyef+ibzJ3SlpCk7lxkVIv RdiPmDwZjTYnma8CYCLBW4WOjpsfBtwphMPxL5CiAQY7Qcdv54vTHo6dCCrYFUgre7JJhl6qSSR qNyBailMbxYmQc0SOT89ukSISyC51m2T/0/MiVeZi9q2ZdCH/zlSFxXy/QXhyUP9ckiYfhmnHsL wGXbMyktEtK1uSC5dKtpr/F1LAcFK50LLTVPAxzPK3QFp1HmboAOAcgXaehKzQYsO0kkqvdGYDv tA+dIFHmejDniveSzuU5OZxSa79FXjiAaiUWI1eDUIjvKSTi7khHL4mwhd6KjWeqI+AnQOlNTjc 1K6PD60w8UUhQpJN+PXoCuHEUgU9GGX5d4BkcdkQs+SV9q5345hCNadIDSZ2Ew4vXDVZc1sXwcj Tv1qotzb55MJhUQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8355 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Add a introductory directory layout at the top that is reflected in the following section. This document no longer uses Poky as its source directory, so all paths are explicitly mentioned, to highlight the separation between core components. This lead to some re-organization of some sections. Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 4 +- documentation/ref-manual/structure.rst | 150 +++++++++++++++++++-------------- documentation/ref-manual/terms.rst | 2 +- 3 files changed, 90 insertions(+), 66 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 8e332aec0..9da8400d2 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -81,7 +81,7 @@ directory of that Layer. This directory is what you add to the ``conf/bblayers.conf`` file found in your :term:`Build Directory`, which is established after you run the OpenEmbedded build environment setup -script (i.e. :ref:`ref-manual/structure:``oe-init-build-env```). +script (i.e. :ref:`structure-core-script`). Adding the root directory allows the :term:`OpenEmbedded Build System` to recognize the BSP layer and from it build an image. Here is an example:: @@ -221,7 +221,7 @@ section. Checking connectivity... done. #. *Initialize the Build Environment:* While in the directory where the - different layers are cloned, run the :ref:`ref-manual/structure:``oe-init-build-env``` + different layers are cloned, run the :ref:`structure-core-script` environment setup script located in :term:`OpenEmbedded-Core (OE-Core)` to define the OpenEmbedded build environment on your build host. :: diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index d567cade0..3b8fb0263 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -16,6 +16,19 @@ and directories. names that contain spaces. Be sure that the Source Directory you use does not contain these types of names. +For the following sections, we assume the core components of the :term:`Source +Directory` are organized as follows: + +.. code-block:: text + + ├── build/ + │   └── ... + └── layers/ + ├── bitbake/ + ├── meta-yocto/ + ├── openembedded-core/ + └── yocto-docs/ + .. _structure-core: Top-Level Core Components @@ -67,8 +80,8 @@ about the contents of the :term:`Build Directory`. .. _handbook: -``documentation/`` ------------------- +``layers/yocto-docs/`` +---------------------- This directory holds the source for the Yocto Project documentation as well as templates and tools that allow you to generate PDF and HTML @@ -76,37 +89,22 @@ versions of the manuals. Each manual is contained in its own sub-folder; for example, the files for this reference manual reside in the ``ref-manual/`` directory. +This directory is not mandatory for building with :term:`BitBake`. + .. _structure-core-meta: -``meta/`` ---------- +``layers/openembedded-core/meta/`` +---------------------------------- This directory contains the minimal, underlying OpenEmbedded-Core metadata. The directory holds recipes, common classes, and machine configuration for strictly emulated targets (``qemux86``, ``qemuarm``, and so forth.) -.. _structure-core-meta-poky: - -``meta-poky/`` --------------- - -Designed above the ``meta/`` content, this directory adds just enough -metadata to define the Poky reference distribution. - -.. _structure-core-meta-yocto-bsp: - -``meta-yocto-bsp/`` -------------------- - -This directory contains the Yocto Project reference hardware Board -Support Packages (BSPs). For more information on BSPs, see the -:doc:`/bsp-guide/index`. - .. _structure-meta-selftest: -``meta-selftest/`` ------------------- +``layers/openembedded-core/meta-selftest/`` +------------------------------------------- This directory adds additional recipes and append files used by the OpenEmbedded selftests to verify the behavior of the build system. You @@ -115,15 +113,15 @@ want to run the selftests. .. _structure-meta-skeleton: -``meta-skeleton/`` ------------------- +``layers/openembedded-core/meta-skeleton/`` +------------------------------------------- This directory contains template recipes for BSP and kernel development. .. _structure-core-scripts: -``scripts/`` ------------- +``layers/openembedded-core/scripts/`` +------------------------------------- This directory contains various integration scripts that implement extra functionality in the Yocto Project environment (e.g. QEMU scripts). The @@ -136,8 +134,8 @@ back to the Yocto Project, such as ``create-pull-request`` and .. _structure-core-script: -``oe-init-build-env`` ---------------------- +``layers/openembedded-core/oe-init-build-env`` +---------------------------------------------- This script sets up the OpenEmbedded build environment. Running this script with the ``source`` command in a shell makes changes to ``PATH`` @@ -166,16 +164,27 @@ targets to build. Here is an example:: You can also run generated QEMU images with a command like 'runqemu qemux86-64' +.. note:: + + When using :doc:`bitbake-setup `, + this script is indirectly sourced when sourcing the ``init-build-env`` + located in the :term:`bitbake:Setup`'s build directory. However, compared to + ``oe-init-build-env``, the bitbake-setup ``init-build-env`` does not take any + argument, as it is already located in a :term:`Build Directory`. + + See :doc:`bitbake:bitbake-user-manual/bitbake-user-manual-environment-setup` + for more information. + The default output of the ``oe-init-build-env`` script is from the -``conf-summary.txt`` and ``conf-notes.txt`` files, which are found in the ``meta-poky`` directory -within the :term:`Source Directory`. If you design a -custom distribution, you can include your own versions of these -configuration files where you can provide a brief summary and detailed usage -notes, such as a list of the targets defined by your distribution. -See the -":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`" -section in the Yocto Project Development Tasks Manual for more -information. +``conf-summary.txt`` and ``conf-notes.txt`` files, which are found in the +``meta/conf/templates/default`` directory of :term:`OpenEmbedded-Core +(OE-Core)`. If you design a custom distribution, you can include your own +versions of these configuration files where you can provide a brief summary and +detailed usage notes, such as a list of the targets defined by your +distribution. See the +":ref:`dev-manual/custom-template-configuration-directory:creating a custom +template configuration directory`" section in the Yocto Project Development +Tasks Manual for more information. By default, running this script without a :term:`Build Directory` argument creates the ``build/`` directory in your current working directory. If @@ -188,8 +197,8 @@ your choice. For example, the following command creates a $ source oe-init-build-env ~/mybuilds The OpenEmbedded build system uses the template configuration files, which -are found by default in the ``meta-poky/conf/templates/default`` directory in the Source -Directory. See the +are found by default in the ``meta/conf/templates/default`` directory in +:term:`OpenEmbedded-Core (OE-Core)`. See the ":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`" section in the Yocto Project Development Tasks Manual for more information. @@ -198,17 +207,30 @@ information. The OpenEmbedded build system does not support file or directory names that contain spaces. If you attempt to run the ``oe-init-build-env`` - script from a Source Directory that contains spaces in either the + script from a :term:`Source Directory` that contains spaces in either the filenames or directory names, the script returns an error indicating - no such file or directory. Be sure to use a Source Directory free of + no such file or directory. Be sure to use a :term:`Source Directory` free of names containing spaces. -.. _structure-basic-top-level: +.. _structure-core-meta-poky: + +``layers/meta-yocto/meta-poky/`` +-------------------------------- + +Dependent on the :term:`OpenEmbedded-Core (OE-Core)` metadata, this directory +adds just enough metadata to define the Poky reference distribution. -``LICENSE, README, and README.hardware`` ----------------------------------------- +Namely, it contains the distro :term:`configuration file` for Poky: +``conf/distro/poky.conf``. + +.. _structure-core-meta-yocto-bsp: -These files are standard top-level files. +``layers/meta-yocto/meta-yocto-bsp/`` +------------------------------------- + +This directory contains the Yocto Project reference hardware Board +Support Packages (BSPs). For more information on BSPs, see the +:doc:`/bsp-guide/index`. .. _structure-build: @@ -257,7 +279,7 @@ This directory should not be shared between builds. you need to share the :ref:`overview-manual/concepts:Hash Equivalence` database, don't share this file and instead refer to the :doc:`/dev-manual/hashequivserver` document of the Yocto Project Development - Tasks Manual to setup Hash Equivalence server. + Tasks Manual to setup a Hash Equivalence server. .. _structure-build-conf-local.conf: @@ -275,9 +297,9 @@ file, it is recommended to put them into a distro :term:`configuration file`, or to create layer :term:`configuration fragments ` from changes made here. -The :term:`OpenEmbedded Build System` can create it from a ``local.conf.sample`` -file when you ``source`` the top-level build environment setup script -:ref:`structure-core-script`. +The :term:`OpenEmbedded Build System` can create the ``local.conf`` file from a +``local.conf.sample`` file when you ``source`` the top-level build environment +setup script :ref:`structure-core-script`. The source ``local.conf.sample`` file used depends on the :term:`TEMPLATECONF` script variable, which defaults to ``meta-poky/conf/templates/default`` @@ -298,8 +320,8 @@ file, it uses ``sed`` to substitute final .. note:: You can see how the :term:`TEMPLATECONF` variable is used by looking at the - ``scripts/oe-setup-builddir`` script in the :term:`Source Directory`. - You can find the Yocto Project version of the ``local.conf.sample`` file in + ``scripts/oe-setup-builddir`` script in :term:`OpenEmbedded-Core (OE-Core)`. + You can find the :term:`Poky` version of the ``local.conf.sample`` file in the ``meta-poky/conf/templates/default`` directory. .. _structure-build-conf-bblayers.conf: @@ -319,9 +341,9 @@ when you ``source`` the top-level build environment setup script (i.e. As with the :ref:`structure-build-conf-local.conf` file, the source ``bblayers.conf.sample`` file used depends on the :term:`TEMPLATECONF` script variable, which -defaults to ``meta-poky/conf/templates/default`` when you are building from the Yocto -Project development environment, and to ``meta/conf/templates/default`` when you are -building from the OpenEmbedded-Core environment. Because the script +defaults to ``meta-poky/conf/templates/default`` when you are building using the +:term:`Poky` reference distro, and to ``meta/conf/templates/default`` when you are +building from the OpenEmbedded-Core environment (default). Because the script variable points to the source of the ``bblayers.conf.sample`` file, this implies that you can base your build from any layer by setting the variable in the top-level build environment setup script as follows:: @@ -329,12 +351,12 @@ variable in the top-level build environment setup script as follows:: TEMPLATECONF=your_layer/conf/templates/your_template_name Once the build process gets the sample file, it uses ``sed`` to substitute final -``${``\ :term:`OEROOT`\ ``}`` values for all ``##OEROOT##`` values. +``${``\ :term:`OEROOT`\ ``}`` values for all ``##OEROOT##`` occurrences. .. note:: You can see how the :term:`TEMPLATECONF` variable is defined by the ``scripts/oe-setup-builddir`` - script in the :term:`Source Directory`. You can find the Yocto Project + script in the :term:`Source Directory`. You can find the :term:`Poky` version of the ``bblayers.conf.sample`` file in the ``meta-poky/conf/templates/default`` directory. @@ -351,8 +373,9 @@ You could for example edit this file to limit the number of threads used by want to access downloaded files (:term:`DL_DIR`). This file can be shared for multiple build directories. For example, -``bitbake-setup`` makes the :ref:`structure-build-conf-site.conf` file a -symbolic link to a common ``site.conf`` file:: +:doc:`bitbake-setup ` +makes the :ref:`structure-build-conf-site.conf` file a symbolic link to a common +``site.conf`` file:: ├── poky-master-poky-distro_poky-machine_qemux86-64/ │   └── build/ @@ -757,11 +780,12 @@ space if they were to be shared with the standard :term:`Sysroot` mechanism. .. _structure-meta: -The Metadata --- ``meta/`` -========================== +The OpenEmbedded-Core (OE-Core) Metadata --- ``meta/`` +====================================================== -As mentioned previously, :term:`Metadata` is the core of the -Yocto Project. Metadata has several important subdivisions: +As mentioned previously, the :term:`OpenEmbedded-Core (OE-Core)` +:term:`metadata` is the core of the Yocto Project. This metadata has several +important subdivisions: .. _structure-meta-classes: diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst index ea674eff6..729c9746c 100644 --- a/documentation/ref-manual/terms.rst +++ b/documentation/ref-manual/terms.rst @@ -63,7 +63,7 @@ universal, the list includes them just in case: This term refers to the area used by the OpenEmbedded build system for builds. The area is created when you ``source`` the setup environment script that is found in the Source Directory - (i.e. :ref:`ref-manual/structure:``oe-init-build-env```, or + (i.e. :ref:`structure-core-script`, or ``init-build-env`` when using :doc:`bitbake-setup `). The :term:`TOPDIR` variable points to the :term:`Build Directory`. From patchwork Wed Dec 24 16:31:53 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77465 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 DAD35E776F2 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123201.1766593927736277951 for ; Wed, 24 Dec 2025 08:32:08 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ZU717Hqz; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 421CF1A23E1 for ; Wed, 24 Dec 2025 16:32:06 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1998E6073D for ; Wed, 24 Dec 2025 16:32:06 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6B35910AB1388; Wed, 24 Dec 2025 17:32:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593925; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=6Cnh/Wt2dcdvmyLZInkfixkd/4S0ArgcW4CYwjtIroQ=; b=ZU717HqzYzN0kQFc10Lhw1n0y5rix8IIlrLMKs43ChbjiUB3umEIBiNfNTDYlXhkYsfiB3 WDe7Wp1pEnmH+7CQRw2iu+UjQ3xJlSeoAY0YuWLyin0LSxDmR+YBjkvgIaGwkrCAfiZhW5 G2BGzYiP1J1Nimgx/dGIDt2vY+mtQZqTHTUrToxEfRaYfj39GtCqOzYFQIM5fiNrovj/dh bPkdJG+V8+9lYuMs4xQ2Pa/iz69kKcnkQaRqFV34SNt8oeIo9XjFl0iyW9tybVApOncZv8 6pR+vLR3k+/HccUPefLYx5DZf5Ew4fJHhw9iS5/82fpZMJ3rbXQRUmp7m6qFKw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:53 +0100 Subject: [PATCH 27/53] ref-manual/tasks.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-27-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1760; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Udaab9fURKCsNLW/vircBr/PebTIffJnvRw4mTqT4/8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVrTv/actRT5HvuGTw3TEroEcvdUMqkGOmsQ /TUvu2AIVqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVawAKCRDRgEFAKaOo NoBuD/4jO6E5p9cPH3sgxZX/0Nv3Y7kp2FMxxmYdLlaIFtG3ArehxLcsCc5+3Cx1nbRpVk3hAQC DnHcAQX+cBGSFcZwW42kgiOq4CyMfnwZymAEOYveRWiOsmRJuqtpHWuTSf2F5WHRN8DlCNTQ6jt 1dRvV8RGIST9Nb5rnFhYmCSUqGwXM3wroa9uMI3E58j+W3IGGk0RldrfpGfxtHQwcw7ELsMgirM vRCxO3XRK3ekNFMKPKYSyyX4nqk4lpPmu9IGr1uD3L84FSK7ctvn4tRht/B3sH4SUtu+CvqhkF+ wZYc0C8GLIG096J6p8MMIC9uPC2QenyEtrkMMtxJb3Jh6gYZbTjQ1Ic+7XJ/9RjymU4cY9XS7v+ yEb8xRiY3V8NpHkz0sSKLa0ZdVbRfKDbncmLekdvmNIJeBocRfdLLO6Yf8y5diXg+3vUGUHEkk6 YyPpneBp4d3vcEEd6915gmbDeR4KkRfQWTwDXl8LJU4o5r+OqfD0CqC2/4c3EPOCIauaIW20HZy bph/uLStPN3UsAMxmZ/KNdur1G77kZws4jTg+BMTFjRB0f3+wKJ+KCoKunJE0WCQHvzRgePI/dS 2UGv7wRE/02ASZx5wDK61EF15ca3MJ2bcbV+avNW7SbN7FjmJ38S+RLI0Ott0/FT5ukNeAp+H9d VlyousR/PXzLBkA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8356 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/ref-manual/tasks.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst index 8651f219f..e6301e708 100644 --- a/documentation/ref-manual/tasks.rst +++ b/documentation/ref-manual/tasks.rst @@ -191,7 +191,7 @@ that either directly or indirectly depend on the installed files (e.g. - The ``tar`` command with the ``--no-same-owner`` option. See the ``bin_package.bbclass`` file in the ``meta/classes-recipe`` - subdirectory of the :term:`Source Directory` for an example. + subdirectory of :term:`OpenEmbedded-Core (OE-Core)` for an example. .. _ref-tasks-install_ptest_base: @@ -288,14 +288,14 @@ to locate and apply patch files to the source code. Patch files, by default, are ``*.patch`` and ``*.diff`` files created and kept in a subdirectory of the directory holding the recipe file. For example, consider the -:yocto_git:`bluez5 ` -recipe from the OE-Core layer (i.e. ``poky/meta``):: +:oe_git:`bluez5 ` +recipe from the :term:`OpenEmbedded-Core (OE-Core)` layer:: - poky/meta/recipes-connectivity/bluez5 + meta/recipes-connectivity/bluez5 This recipe has two patch files located here:: - poky/meta/recipes-connectivity/bluez5/bluez5 + meta/recipes-connectivity/bluez5/bluez5 In the ``bluez5`` recipe, the :term:`SRC_URI` statements point to the source and patch files needed to build the package. From patchwork Wed Dec 24 16:31:54 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77469 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 CDAD3E776EF for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123730.1766593928512424162 for ; Wed, 24 Dec 2025 08:32:08 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=YvCPKOes; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 07C3C1A23E0 for ; Wed, 24 Dec 2025 16:32:07 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D31D26073D for ; Wed, 24 Dec 2025 16:32:06 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id F17CF10AB1386; Wed, 24 Dec 2025 17:32:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593926; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=dGuapXYbKioo55hZYojInooXRmJjjwEa6cHwxSO2loE=; b=YvCPKOesXrp9YAfK3CgqzLiCt1CpNTIJAcdlriCo8b8MtfcJRjZ5Sog+ib0enm693DHIGm 3NKB5NC/QsCXuronjjByhMO6g+qiCDWnWwUlyeDQ/+c/B14jRrcWBWUSKxZFHK8f5ucEMo bH/MJARHQLIyMhJsM6zNwMpUmkxsD3Q1UjtyaHvkThRnccCOOUUpsJB96JfQ98B7fN5kGX 2sS/bKdrilGECwLoFKrOE0XCw12zUfP4nmfUeOhnHwYcFtRzqR5SqmZQSvIy4GV68EGIoU EYxs81TZBh5j25TWANAOy/SNcMNH+XLDSRfc2bAeedOr73kSN/tldAXEz/rK9Q== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:54 +0100 Subject: [PATCH 28/53] ref-manual/variables.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-28-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=24675; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=RfQt4mDHTVGIOkol/2wG9wobM74bSHOa7fezCeH+8Ps=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVrYLV3dY5gGPVtzp111lA6JfSww1ozEys97 WHRsdL/Xh6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVawAKCRDRgEFAKaOo NnlkD/9IA7L4we+eqNj2JGpgFez7R7R6PS7fZ/R/5/jcW/T/evH+zpxXsOXrDPZA8cWvN98ZEqw xshK+Guz2sxVtZjq/9t6D2UgYocemtC35psUQBD2tyiK/p3sOUyZUG8P0ddkU0Qbi+sKB6BmD4M +O3uIwNIG/1826iWt61ahuBorucq23SONI3l9ghocNYWiP+kGvRdjRt1auI/pU84no3MtCtiQs+ nTimYSperjAmU2PuUqKdH9TDMUeFEhy4c7swFxhMEo3RJvixN5UZ4qdpl7kVKSh5KaFgolrEdXk 9hK93SgbyDKfw4eDROzvijRaQQ7Ga48sxUHwVV0dU7YCqYu2BV6mlXbwESviScCurhbIYaNs3EV zX6KbPLsf8TAeXTEaiiLESEljEqGcCSnwBOhyORWXj0y/YA9i4EF+lI5okb0Ts+W0lZYcPqaJ4x 3eoV7XOnCUI7aVYkr0gRlXpreju2c5V6oyYqcBQnMPC7SvhwocQudQEkXWl4wdcL45vosvRi2jJ bM5uFIggPjhN02kahl/zzqpu3xw9mHkPgWMZAy11JAu6xT+qu0I/PtgsuWkl5CJc2dA68o1yjwK uJCtaOTf8G2BwvtpFjg2fkip7cRuKl3s7NHRv0q1+K5sL+44jADn2oqjCF5RzOcYCaJtEyen2F0 w39nO+mHSMTtq+g== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8357 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 149 ++++++++++++++++----------------- 1 file changed, 73 insertions(+), 76 deletions(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index ee776c110..b994c62a2 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -168,7 +168,8 @@ system and gives an overview of their function and contents. ARCHIVER_MODE[srpm] = "1" # Uses RPM package files. For information on how the variable works, see the - ``meta/classes/archiver.bbclass`` file in the :term:`Source Directory`. + ``meta/classes/archiver.bbclass`` file in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`AS` Minimal command and arguments needed to run the :manpage:`assembler @@ -343,7 +344,7 @@ system and gives an overview of their function and contents. on Multilib. The :term:`BASE_LIB` variable is defined in the machine include files in - the :term:`Source Directory`. If Multilib is not + :term:`OpenEmbedded-Core (OE-Core)`. If Multilib is not being used, the value defaults to "lib". :term:`BASE_WORKDIR` @@ -889,10 +890,10 @@ system and gives an overview of their function and contents. Here is an example:: BBLAYERS = " \ - /home/scottrif/poky/meta \ - /home/scottrif/poky/meta-poky \ - /home/scottrif/poky/meta-yocto-bsp \ - /home/scottrif/poky/meta-mykernel \ + /home/scottrif/project/layers/meta \ + /home/scottrif/project/layers/meta-poky \ + /home/scottrif/project/layers/meta-yocto-bsp \ + /home/scottrif/project/layers/meta-mykernel \ " This example enables four layers, one of which is a custom, @@ -1007,8 +1008,8 @@ system and gives an overview of their function and contents. and `glob `__. For more information on how this variable works, see - ``meta/classes-recipe/binconfig.bbclass`` in the :term:`Source Directory`. - You can also find general + ``meta/classes-recipe/binconfig.bbclass`` in :term:`OpenEmbedded-Core + (OE-Core)`. You can also find general information on the class in the ":ref:`ref-classes-binconfig`" section. @@ -1611,8 +1612,8 @@ system and gives an overview of their function and contents. Bluetooth but you do not ever intend to use it. :term:`COMMERCIAL_AUDIO_PLUGINS` - This variable is specific to the :yocto_git:`GStreamer recipes - `. + This variable is specific to the :oe_git:`GStreamer recipes + `. It allows to build the GStreamer `"ugly" `__ and `"bad" `__ audio plugins. @@ -1621,8 +1622,8 @@ system and gives an overview of their function and contents. section for usage details. :term:`COMMERCIAL_VIDEO_PLUGINS` - This variable is specific to the :yocto_git:`GStreamer recipes - `. + This variable is specific to the :oe_git:`GStreamer recipes + `. It allows to build the GStreamer `"ugly" `__ and `"bad" `__ video plugins. @@ -1631,8 +1632,8 @@ system and gives an overview of their function and contents. section for usage details. :term:`COMMON_LICENSE_DIR` - Points to ``meta/files/common-licenses`` in the - :term:`Source Directory`, which is where generic license + Points to ``meta/files/common-licenses`` in + :term:`OpenEmbedded-Core (OE-Core)`, which is where generic license files reside. :term:`COMPATIBLE_HOST` @@ -1757,8 +1758,8 @@ system and gives an overview of their function and contents. good practice to use appropriate path variables. For example, ``${sysconfdir}`` rather than ``/etc`` or ``${bindir}`` rather than ``/usr/bin``. You can find a list of these variables at - the top of the ``meta/conf/bitbake.conf`` file in the - :term:`Source Directory`. + the top of the ``meta/conf/bitbake.conf`` file in + :term:`OpenEmbedded-Core (OE-Core)`. :term:`CONFIG_INITRAMFS_SOURCE` Identifies the initial RAM filesystem (:term:`Initramfs`) source files. The @@ -1928,15 +1929,8 @@ system and gives an overview of their function and contents. supported. :term:`COREBASE` - Specifies the parent directory of the OpenEmbedded-Core Metadata - layer (i.e. ``meta``). - - It is an important distinction that :term:`COREBASE` points to the parent - of this layer and not the layer itself. Consider an example where you - have cloned the Poky Git repository and retained the ``poky`` name - for your local copy of the repository. In this case, :term:`COREBASE` - points to the ``poky`` folder because it is the parent directory of - the ``poky/meta`` layer. + Specifies the parent directory of the :term:`OpenEmbedded-Core (OE-Core)` + metadata layer (i.e. ``meta``). :term:`COREBASE_FILES` Lists files from the :term:`COREBASE` directory that @@ -2425,8 +2419,8 @@ system and gives an overview of their function and contents. file whose root name is the same as the variable's argument and whose filename extension is ``.conf``. For example, the distribution configuration file for the Poky distribution is named ``poky.conf`` - and resides in the ``meta-poky/conf/distro`` directory of the - :term:`Source Directory`. + and resides in the ``meta-poky/conf/distro`` directory of + :yocto_git:`meta-poky `. Within that ``poky.conf`` file, the :term:`DISTRO` variable is set as follows:: @@ -2442,7 +2436,8 @@ system and gives an overview of their function and contents. If the :term:`DISTRO` variable is blank, a set of default configurations are used, which are specified within - ``meta/conf/distro/defaultsetup.conf`` also in the Source Directory. + ``meta/conf/distro/defaultsetup.conf`` also in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`DISTRO_CODENAME` Specifies a codename for the distribution being built. @@ -2561,7 +2556,7 @@ system and gives an overview of their function and contents. argument and whose filename extension is ``.conf``. For example, the distribution configuration file for the Poky distribution is named ``poky.conf`` and resides in the ``meta-poky/conf/distro`` directory - of the :term:`Source Directory`. + of :yocto_git:`meta-poky `. Within that ``poky.conf`` file, the :term:`DISTRO_NAME` variable is set as follows:: @@ -2576,7 +2571,8 @@ system and gives an overview of their function and contents. If the :term:`DISTRO_NAME` variable is blank, a set of default configurations are used, which are specified within - ``meta/conf/distro/defaultsetup.conf`` also in the Source Directory. + ``meta/conf/distro/defaultsetup.conf`` also in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`DISTRO_VERSION` The version of the distribution. @@ -2594,7 +2590,7 @@ system and gives an overview of their function and contents. :term:`OVERRIDES`. Here is an example from :yocto_git:`meta-poky/conf/distro/poky-tiny.conf - `:: + `:: DISTROOVERRIDES = "poky:poky-tiny" @@ -3156,7 +3152,7 @@ system and gives an overview of their function and contents. use ``${sysconfdir}`` rather than ``/etc``, or ``${bindir}`` rather than ``/usr/bin``. You can find a list of these variables at the top of the ``meta/conf/bitbake.conf`` file in - the :term:`Source Directory`. You will also + :term:`OpenEmbedded-Core (OE-Core)`. You will also find the default values of the various ``FILES:*`` variables in this file. @@ -3273,8 +3269,8 @@ system and gives an overview of their function and contents. :term:`SRC_URI` statements. The default value for the :term:`FILESPATH` variable is defined in the - :ref:`ref-classes-base` class found in ``meta/classes-global`` in the - :term:`Source Directory`:: + :ref:`ref-classes-base` class found in ``meta/classes-global`` in + :term:`OpenEmbedded-Core (OE-Core)`:: FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", \ "${FILE_DIRNAME}/${BPN}", "${FILE_DIRNAME}/files"], d)}" @@ -3329,7 +3325,7 @@ system and gives an overview of their function and contents. By default, the OpenEmbedded build system uses the ``fs-perms.txt``, ``fs-perms-volatile-log.txt`` and ``fs-perms-volatile-tmp.txt`` which are - located in the ``meta/files`` folder in the :term:`Source Directory`. If + located in the ``meta/files`` folder in :term:`OpenEmbedded-Core (OE-Core)`. If you create your own permission setting table files, you should place those in your layer. @@ -3632,7 +3628,7 @@ system and gives an overview of their function and contents. Other Go programs importing this package will use this path. Here is an example setting from the - :yocto_git:`go-helloworld_0.1.bb ` + :oe_git:`go-helloworld_0.1.bb ` recipe:: GO_IMPORT = "golang.org/x/example" @@ -4494,7 +4490,8 @@ system and gives an overview of their function and contents. - wic.zst For more information about these types of images, see - ``meta/classes-recipe/image_types*.bbclass`` in the :term:`Source Directory`. + ``meta/classes-recipe/image_types*.bbclass`` in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`IMAGE_VERSION_SUFFIX` Version suffix that is part of the default :term:`IMAGE_NAME` and @@ -4712,7 +4709,7 @@ system and gives an overview of their function and contents. With ``sysvinit``, the init manager is set to :wikipedia:`SysVinit `, the traditional UNIX init - system. This is the default choice in the Poky distribution, together with + system. This is the default choice in the :term:`Poky` distribution, together with the Udev device manager (see the ":ref:`device-manager`" section). With ``systemd``, the init manager becomes :wikipedia:`systemd `, @@ -4726,7 +4723,7 @@ system and gives an overview of their function and contents. More concretely, this is used to include ``conf/distro/include/init-manager-${INIT_MANAGER}.inc`` into the global configuration. You can have a look at the - :yocto_git:`meta/conf/distro/include/init-manager-*.inc ` + :oe_git:`meta/conf/distro/include/init-manager-*.inc ` files for more information, and also the ":ref:`init-manager`" section in the Yocto Project Development Tasks Manual. @@ -4745,8 +4742,8 @@ system and gives an overview of their function and contents. :term:`IMAGE_FSTYPES` variable. The default value of this variable, which is set in the - ``meta/conf/bitbake.conf`` configuration file in the - :term:`Source Directory`, is "cpio.gz". The Linux kernel's + ``meta/conf/bitbake.conf`` configuration file in + :term:`OpenEmbedded-Core (OE-Core)`, is "cpio.gz". The Linux kernel's :term:`Initramfs` mechanism, as opposed to the initial RAM filesystem :wikipedia:`initrd ` mechanism, expects an optionally compressed cpio archive. @@ -4768,14 +4765,14 @@ system and gives an overview of their function and contents. .. note:: See the ``meta/recipes-core/images/core-image-minimal-initramfs.bb`` - recipe in the :term:`Source Directory` + recipe in :term:`OpenEmbedded-Core (OE-Core)` for an example :term:`Initramfs` recipe. To select this sample recipe as the one built to provide the :term:`Initramfs` image, set :term:`INITRAMFS_IMAGE` to "core-image-minimal-initramfs". You can also find more information by referencing the - ``meta-poky/conf/templates/default/local.conf.sample.extended`` - configuration file in the Source Directory, the :ref:`ref-classes-image` + ``conf/templates/default/local.conf.sample.extended`` + configuration file in :yocto_git:`meta-poky `, the :ref:`ref-classes-image` class, and the :ref:`ref-classes-kernel` class to see how to use the :term:`INITRAMFS_IMAGE` variable. @@ -4835,7 +4832,7 @@ system and gives an overview of their function and contents. configuration file. You cannot set the variable in a recipe file. See the - :yocto_git:`local.conf.sample.extended ` + :yocto_git:`local.conf.sample.extended ` file for additional information. Also, for information on creating an :term:`Initramfs`, see the ":ref:`dev-manual/building:building an initial ram filesystem (Initramfs) image`" section in the Yocto Project Development Tasks Manual. @@ -5849,7 +5846,7 @@ system and gives an overview of their function and contents. name, through which machine-specific configurations are set. Thus, when :term:`MACHINE` is set to "qemux86", the corresponding ``qemux86.conf`` machine configuration file can be found in - the :term:`Source Directory` in + :term:`OpenEmbedded-Core (OE-Core)` in ``meta/conf/machine``. The list of machines supported by the Yocto Project as shipped @@ -6363,8 +6360,8 @@ system and gives an overview of their function and contents. ``sysroots/`` directory so that all builds that use the script will use the correct directories for the cross compiling layout. - See the ``meta/classes-recipe/binconfig.bbclass`` in the - :term:`Source Directory` for details on how this class + See the ``meta/classes-recipe/binconfig.bbclass`` in + :term:`OpenEmbedded-Core (OE-Core)` for details on how this class applies these additional sed command arguments. :term:`OE_FRAGMENTS` @@ -6443,7 +6440,7 @@ system and gives an overview of their function and contents. :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE` Set the package manager(s) for build reproducibility testing. - See :yocto_git:`reproducible.py ` + See :oe_git:`reproducible.py ` and :doc:`/test-manual/reproducible-builds`. :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS` @@ -6713,7 +6710,7 @@ system and gives an overview of their function and contents. ``*-dbg`` package as with the ``.debug`` value, while source is placed in a separate ``*-src`` package, which can be installed independently. This is the default setting for this variable, - as defined in Poky's ``bitbake.conf`` file. + as defined in :term:`OE-Core `'s ``bitbake.conf`` file. - "``debug-without-src``": The same behavior as with the ``.debug`` setting, but no source is packaged at all. @@ -7671,8 +7668,8 @@ system and gives an overview of their function and contents. The network based :term:`PR` service host and port. The ``conf/templates/default/local.conf.sample.extended`` configuration - file in the :term:`Source Directory` shows how the :term:`PRSERV_HOST` - variable is set:: + file in :yocto_git:`meta-poky ` shows how the + :term:`PRSERV_HOST` variable is set:: PRSERV_HOST = "localhost:0" @@ -8318,11 +8315,11 @@ system and gives an overview of their function and contents. to find the unpacked source. As an example, assume a :term:`Source Directory` - top-level folder named ``poky`` and a default :term:`Build Directory` at - ``poky/build``. In this case, the work directory the build system + top-level folder named ``project`` and a default :term:`Build Directory` at + ``project/build``. In this case, the work directory the build system uses to keep the unpacked recipe for ``db`` is the following:: - poky/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/sources/db-5.1.19 + project/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/sources/db-5.1.19 The unpacked source code resides in the ``db-5.1.19`` folder. @@ -8574,7 +8571,7 @@ system and gives an overview of their function and contents. SDK_TITLE ??= "${@d.getVar('DISTRO_NAME') or d.getVar('DISTRO')} SDK" - For the default distribution "poky", + For the :term:`poky` reference distribution, :term:`SDK_TITLE` is set to "Poky (Yocto Project Reference Distro)". For information on how to change this default title, see the @@ -8620,7 +8617,7 @@ system and gives an overview of their function and contents. SDKEXTPATH ??= "~/${@d.getVar('DISTRO')}_sdk" For the - default distribution "poky", the :term:`SDKEXTPATH` is set to "poky_sdk". + :term:`Poky` reference distro, the :term:`SDKEXTPATH` is set to "poky_sdk". For information on how to change this default directory, see the ":ref:`sdk-manual/appendix-customizing:changing the default sdk installation directory`" @@ -9294,8 +9291,8 @@ system and gives an overview of their function and contents. .. note:: The :term:`SRCPV` variable used to be defined in the - ``meta/conf/bitbake.conf`` configuration file in the :term:`Source - Directory` as follows:: + ``meta/conf/bitbake.conf`` configuration file in + :term:`OpenEmbedded-Core (OE-Core)` as follows:: SRCPV = "${@bb.fetch2.get_srcrev(d)}" @@ -10000,8 +9997,8 @@ system and gives an overview of their function and contents. compatible with the kernel compilation. The :term:`TARGET_CC_KERNEL_ARCH` variable allows the kernel (and associated modules) to use a different configuration. See the - ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in the - :term:`Source Directory` for an example. + ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in + :term:`OpenEmbedded-Core (OE-Core)` for an example. :term:`TARGET_CFLAGS` Specifies the flags to pass to the C compiler when building for the @@ -10402,10 +10399,10 @@ system and gives an overview of their function and contents. ``tmp`` within the :term:`Build Directory`. If you want to establish this directory in a location other than the - default, you can uncomment and edit the following statement in the - ``conf/local.conf`` file in the :term:`Source Directory`:: + default, you can set it to another value in your + :ref:`structure-build-conf-site.conf` configuration file:: - #TMPDIR = "${TOPDIR}/tmp" + TMPDIR = "/another/location" An example use for this scenario is to set :term:`TMPDIR` to a local disk, which does not use NFS, while having the :term:`Build Directory` use NFS. @@ -10536,8 +10533,8 @@ system and gives an overview of their function and contents. definitions can be a single static definition, or can be dynamically adjusted. You can see details for a given CPU family by looking at the architecture's ``README`` file. For example, the - ``meta/conf/machine/include/mips/README`` file in the - :term:`Source Directory` provides information for + ``meta/conf/machine/include/mips/README`` file in + :term:`OpenEmbedded-Core (OE-Core)` provides information for :term:`TUNE_ARCH` specific to the ``mips`` architecture. :term:`TUNE_ARCH` is tied closely to @@ -10639,7 +10636,7 @@ system and gives an overview of their function and contents. that conflict with feature. Known tuning conflicts are specified in the machine include files in - the :term:`Source Directory`. Here is an example from + :term:`OpenEmbedded-Core (OE-Core)`. Here is an example from the ``meta/conf/machine/include/mips/arch-mips.inc`` include file that lists the "o32" and "n64" features as conflicting with the "n32" feature:: @@ -10655,7 +10652,7 @@ system and gives an overview of their function and contents. TUNEVALID[bigendian] = "Enable big-endian mode." - See the machine include files in the :term:`Source Directory` + See the machine include files in :term:`OpenEmbedded-Core (OE-Core)` for these features. :term:`UBOOT_BINARY` @@ -11298,8 +11295,8 @@ system and gives an overview of their function and contents. USER_CLASSES ?= "buildstats" For more information, see - ``meta-poky/conf/templates/default/local.conf.sample`` in the - :term:`Source Directory`. + ``conf/templates/default/local.conf.sample`` in + :yocto_git:`meta-poky `. :term:`USERADD_DEPENDS` Specifies a list of recipes that create users / groups (via @@ -11448,13 +11445,13 @@ system and gives an overview of their function and contents. VIRTUAL-RUNTIME_base-utils = "packagegroup-core-base-utils" Here are two examples using this virtual runtime package. The - first one is in :yocto_git:`initramfs-framework_1.0.bb - `:: + first one is in :oe_git:`initramfs-framework_1.0.bb + `:: RDEPENDS:${PN} += "${VIRTUAL-RUNTIME_base-utils}" - The second example is in the :yocto_git:`core-image-initramfs-boot - ` + The second example is in the :oe_git:`core-image-initramfs-boot + ` image definition:: PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" @@ -11580,13 +11577,13 @@ system and gives an overview of their function and contents. - :term:`PR`: The recipe revision As an example, assume a Source Directory top-level folder name - ``poky``, a default :term:`Build Directory` at ``poky/build``, and a + ``project``, a default :term:`Build Directory` at ``project/build``, and a ``qemux86-poky-linux`` machine target system. Furthermore, suppose your recipe is named ``foo_1.3.0-r0.bb``. In this case, the work directory the build system uses to build the package would be as follows:: - poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 + project/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 :term:`XSERVER` Specifies the packages that should be installed to provide an X From patchwork Wed Dec 24 16:31:55 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77464 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 C5844E776EC for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123202.1766593929211834332 for ; Wed, 24 Dec 2025 08:32:09 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=JE5YTZh9; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id B5D391A23E2 for ; Wed, 24 Dec 2025 16:32:07 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8CCC76073D for ; Wed, 24 Dec 2025 16:32:07 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id BC4ED10AB1387; Wed, 24 Dec 2025 17:32:06 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593927; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=MRPXv4yB5I83cN9z/3xnhL4oRtgY0gv8CA+EyfwgzVg=; b=JE5YTZh9VjRMYgCuHGgKOMaVboR7+fLmjnizRixTNGwWXJjKpoYCUaqwluX0sKW2/wSMDC JQyUyni1TPsIJ6edGgQ99YTTbNveA47h8EJXLfph8IV0WfHUY2gVHxwApIwuPTf8KkSO0T 5mhvkGV6iT7hf4noKcpAeRO75OJKpgHVmQRkcrospy3FfH+ptr7iACvClrlARBDIQXjkCX 0E39K0v41qeJVxXSeHTEpeYH/cbV9nOkqaM2K7sKOhZgzb+G8/Smad7FI+xV8PDwqHMzP/ y9TEAxVDarBL1AUpI3Ckn6aezMzaAOnErLpLJ6YHf7UYW6nVE7TRApWB94AV5Q== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:55 +0100 Subject: [PATCH 29/53] sdk-manual/appendix-obtain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-29-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=972; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=lShLrZcwEQtoUFO51nQEmpuD7RBiBS3EfVEtL7k0uQg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVsJjS26rvrZ507ha5lsi9JAYcWwvJXGj4kC iqZhCXgjROJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbAAKCRDRgEFAKaOo NtMNEACl2/Wq3RArDqXTX5lC9m2cFDXsDgxK1iZ8s5tHiun98J8L5n01I25a/D5Z4xph3mWVnqv clNzp4swcAM2LA5EFo4Vx0vnZuoUP7gDNzkaI17kfB46e0ZXq5Oo20h0CsjkmM45VR7Cg8qcajE DqF77QvWWQ1WtPuxKUMTDCKoch4k+PybOGAUXmpJf6I0sfDsrCZfg88LI7cTBWtPt73qORZEHIs B5qfQg4QA08gIMMp+Ys3dcKoY9e9h58wsILGQScdKJUY57N9fHn2ZVHyhx2ElI2KsdwKSX15Xu2 Sanujn0wEXMM5wEPUnrOd+x8WNKvv/6mSI1c58hWMTYIIHl1A71uzvF4gnrwZTnZvL19E/Tggt9 ZftpX0QbXLrinPViC4a5oEuoGGz+mDL3OWfVynG8h6ZabSv/J8oZ7LWNeNDO0ljBqh+fHQvgFWf TMyMoG7IwFj9L0cul+fHeKKrbJhy4VgaW2wftzgD6BKE7qgAkGjZc2KOgUKE2AuH04zd7q6VKXf E0X/VZIOrzCIlHOfINRO1ckK88zG+5VnJyOmOJn/PSAZH+Nc0/2t3SzKgcl8Z6IE9DZFjUZlX99 S8chvj+4UkKjfPfyGmT6afgyy6LqfKjJQMAEQo06cbfXUH9vGTo0mi6G8N4B+oAyTLbZMeyBn+p ucUHpS1hZ78sDUw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8358 Rename the source directory to project, as specified in its new definition in terms.rst. Signed-off-by: Antonin Godard --- documentation/sdk-manual/appendix-obtain.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/sdk-manual/appendix-obtain.rst b/documentation/sdk-manual/appendix-obtain.rst index 33787a225..cc11c97df 100644 --- a/documentation/sdk-manual/appendix-obtain.rst +++ b/documentation/sdk-manual/appendix-obtain.rst @@ -149,7 +149,7 @@ build the SDK installer. Follow these steps: #. *Run the Installer:* You can now run the SDK installer from ``tmp/deploy/sdk`` in the :term:`Build Directory`. Here is an example:: - $ cd poky/build/tmp/deploy/sdk + $ cd project/build/tmp/deploy/sdk $ ./poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh During execution of the script, you choose the root location for the From patchwork Wed Dec 24 16:31:56 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77461 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 BBD83E776EA for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123203.1766593929708123597 for ; Wed, 24 Dec 2025 08:32:10 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=iTuuRKwF; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 31E521A23E1 for ; Wed, 24 Dec 2025 16:32:08 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 09F286073D for ; Wed, 24 Dec 2025 16:32:08 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6E42110AB138B; Wed, 24 Dec 2025 17:32:07 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593927; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=9faE2Bv7fE1wsgdf1/55d58X6aInYhxzsYndn1rdNMs=; b=iTuuRKwFDhi/9SBid9ebSkXWdKE5yjoqSzGFntBwx8nW8RM7qnAAa6uBV+AJ2Cbf8KfBu5 7n5RNfh/agMzGFJXo6sRlhCrZgd0YLgYaI6VPfMQ9b3w2JsVGxJGpxOdAubs6W5lm3wRPY SjO3jxcWZ8hyEF1aNcQc2WP7zBA96MfNYH+TAUzphz9LkvKoTR1em4Rhe4wTxgZmpysSXs f7kupvGMH6s+g4V+xh5farH7Ir9O4rviAmcNb/L4vlJDUh1g2PfZvoBjdkp7RBNOPDN/an +H6kRWTqCRBJTS6akAVKBPl3rCLY0dYU7P9eivgPSxo1AoBxNK3pzv2MLUOpuA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:56 +0100 Subject: [PATCH 30/53] sdk-manual/intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-30-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1161; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=wCgmFVbTf9KgpJJS5bYRFZEB/lu3IyiMBRtLBlORDJQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVsxvq45v3jwpMVge+Vau0hYYKaRHPpwEuuB XlsPlcykdiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbAAKCRDRgEFAKaOo Nm1XEAC6gCdxyW/Z89LTHZsvnleddsoJId/yyuZE034s6kgb7auFEd7neLfHkmMb9zzfSs14hk4 66JXrztYsegnAMHY7ZjjRaS8bGU+0E8pVyFFOafSK1DPNXjgCLwUqfGoU5gMZqnToE9RB79/cyF D8bevSZDjRIDI91teAK6yB+k+vy0F/a9mZxLYRxsFosGy+5twUyBRW0LuJR3BzJt63EL7uKDRBd Bv99BIOxzkjqCW5ykD3r+5sASstsises0+zk4kAWeDHBL0t4b6g1BWxsCNlEnQLLkF8l1YC5dRY P/g+vfKAC9Hsk1EfpS1HFr/p986+TLGNkvhrs5DjkJd4rGYKZEUjd9UiyvLkUCrP5E52TkJM+Xw fYNSEH7yR8IIHeZyL9+zUXAJskIEURWjKSLx28ZZ3FVcTTT4vZ6Q35hQmQGiY/OutM6V0LU4RFR +pHC01bU0R0klLUtuqON98XtO/rrkZRiBZjnS9Ct7O0w0WB/a7tlPVLLqxoJtQyKjt6hdgXABCn NMt4ixE06r0XOwni2cYTPKLgZ0eeYZRcYZ1zZhLptgfFTJ2bmP14Ex8gbDLU9S9r0Oth9HW4Au+ cI6mFoPW7RMsOD4WSD63kD7A2sx9yfYcFoALfABVWQ35PTouA9mfeiH+ZQBRUshIbqIViXl5tln juxav3bsmhx36Tg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8359 Remove the mention of the Poky git repository. Refer to the existing setup instructions. Signed-off-by: Antonin Godard --- documentation/sdk-manual/intro.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index fbfc8c2ac..68be2ca5d 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -133,12 +133,8 @@ your application or image. QEMU is not part of the SDK but is automatically installed and available if you have done any one of the following: -- cloned the ``poky`` Git repository to create a - :term:`Source Directory` and sourced the environment setup script. - -- downloaded a Yocto Project release and unpacked it to - create a Source Directory and sourced the environment setup - script. +- Setup your :term:`Build Host` as described in the :doc:`/dev-manual/start` + section of the Yocto Project Development Tasks Manual. - installed the cross-toolchain tarball and sourced the toolchain's setup environment script. From patchwork Wed Dec 24 16:31:57 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77460 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 AF30FE776E0 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123732.1766593930245111663 for ; Wed, 24 Dec 2025 08:32:10 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=U3ckdI0t; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id BFB391A23E4 for ; Wed, 24 Dec 2025 16:32:08 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 968316073D for ; Wed, 24 Dec 2025 16:32:08 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id F3AF410AB1383; Wed, 24 Dec 2025 17:32:07 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593928; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=np3G/2jWr/x9RyTvolpNyi73VF2cRebSkTbQum2fA8Q=; b=U3ckdI0tBzjuDpTldVLKfJclzDQpyn8ZgQIF4nNlaFTPYHuQ57u0la5omm69Cu9MXxDf/P WT+3hSq3R6Tk5pmkhoCqNru4ew7YbMMldaDdQYlrMOlf+eAVIhll26FNaaSxm7b/wXtIOm K4TGtJKv2lFXEfl228X+32CKLUxnOASwFSu27jvqC6CsZGDaCuLbV25yrNAOhoeXF+J7+4 fjINWntxUvaAacGlttCmY9DbpAOcrEjXPcHsdkVDusR2VR82vywtgAS1CSanbViICB8esu 2cIm/GRJ/awMcErcMIKolaqjM35vhpZaWZNWJUaLtrpe7P+67Z9QMOIw+f4cJg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:57 +0100 Subject: [PATCH 31/53] test-manual/runtime-testing.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-31-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1080; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=jSCfL8jZhg+TJ+NO8yVMAlClRtA0a5PryuNSGR3rq/s=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVs9X274+aazACeiMahkmpIGfr0uBOyVQI3z 99DwQRKKG2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbAAKCRDRgEFAKaOo NtAKD/90JmISyDLrpotPUEQOoUEKlfIQpWB7yI88bOClsIrJxHE3WfcOC3etUSZkK0Ok50uZcFn Utf5jXFXreir+KW/0wD5zKlOUWKQIoP+wijggpJVuKTvF8eXYXTjxIBUCUJMSTbaW8ZopP+WGhK TEOK3HdMk15ghiztbkfV1hPhQjeklryo3Z7+HqtOgXrutebQ6ItwaCuvSEbK0waDpEZXK5wKc50 g6/2BAyNLjchX9KWCCOzEdEFAVnWbslM0SLiWusuTsV2vzaYysHwjE/cuTYZ3iTRCbln+C68HwW R3O36LCnSavIROqMiwkK2FClAr1GYBSdhIzb4yPbF9bXAWu0mUlEp3PIs7/EgaHA+ubCge+dbKs hIcfRtpLn9AP74Aw65FI8BSpwztZeiEVbzzFLhiSYxqHK2a9YFJXgJqHvccy37g/qad1UY8BxqV 4TfyA25BSkJeks1gH98sAWFE98OC2XqMhSGQVOj2KnIeSLM83XBlwoJ+Mz8CZHL9JnRNfx1XG0n yUbtybPQjZAdV7ZI1N58daPkSXJqLxmvqPKpIZGm+rTVAWp1hCIHxXV4T6MMtXufLU7tUqW+k2W wu8f5385Qk5VdO4fO4oIR4m7guIE6ibpl8zayO5jmZWA7eZYxO/eH6mCACZB0mgfldrjdWxrJqQ qLT1aBVnFPWIUDg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8360 Remove reference to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/test-manual/runtime-testing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/test-manual/runtime-testing.rst b/documentation/test-manual/runtime-testing.rst index 909448ab2..a64a97c80 100644 --- a/documentation/test-manual/runtime-testing.rst +++ b/documentation/test-manual/runtime-testing.rst @@ -338,8 +338,8 @@ You can start the tests automatically or manually: bitbake -c testimage image -All test files reside in ``meta/lib/oeqa/runtime/cases`` in the -:term:`Source Directory`. A test name maps +All test files reside in ``meta/lib/oeqa/runtime/cases`` in +:term:`OpenEmbedded-Core (OE-Core)`. A test name maps directly to a Python module. Each test module may contain a number of individual tests. Tests are usually grouped together by the area tested (e.g tests for systemd reside in ``meta/lib/oeqa/runtime/cases/systemd.py``). From patchwork Wed Dec 24 16:31:58 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77462 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 A8FCCE776DC for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123205.1766593931329256963 for ; Wed, 24 Dec 2025 08:32:11 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=eP+bfCor; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id D23A41A23E0 for ; Wed, 24 Dec 2025 16:32:09 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A92C96073D for ; Wed, 24 Dec 2025 16:32:09 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9746610AB138D; Wed, 24 Dec 2025 17:32:08 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593929; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=nKYnosNRceZWcnrrqUB73rHteYrs9lpNxgCT75LWylQ=; b=eP+bfCorYY+eP6A8ARvVY2hZw9AZfIEKVoBTqcpTzhSv/f+1cBARy9MOMcrP/vALb7YZCr gSi9Uo8/svwYgfF7XgHkN9MMW2h9gYzBmBtIzrA/jgK695AQtp3yvLXlmSFzo2ZzKbN8NY UWlmJtjsy5f67H8bIxOyiNLnhsqmZuVV0ZJjfeCZ7PNkt9DAL/j7r2v3QV9VmsPXQ0ZDke YrgiZw3tYUeHqvWx1VwYgJIJ5YDH5lnNnmOV7baFbJOc+nhkcuwKiKNhSZwibKw79gRFCJ fz2BVsO3WIqcNCjGlRCccaZJaM84+7A46HejBBvGRXJ05mlLxjSsstHFGjJJgQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:58 +0100 Subject: [PATCH 32/53] toaster-manual: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-32-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=10866; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=CBQksE9kWZ6YhL7f79cjiPY/GjtSbydq9nB/HlDE2x0=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVsz7ceDGsUJlamAnob9tYSeCXPIYymylt9m OMtSwhSHNaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbAAKCRDRgEFAKaOo Ns3KEACf+ODH009QtLIX8z3Y6JIgAli6nr4pgaOaZO1WTJROZaZ0Ex0njaVWS8f98ebk7rDQkbB q4GJL5hJox04iIgmKk1KQKU1Hx9iDE9YVPFkqku5a313xs2/As+bzrzuPV0ORIax07NxO1hbUhu oc4h88H2KzaWwFWy/ZzOtvMx8h8OemFpCuVO0Esyq1nUdy2EC7qGX23HXa27A8bLCK8YvAppfsg AL8whvH1ppY10oMuWV0uU89oqwMqEwTbv5wagInaaqYKwIHqllycIY1PrAqpvz3uIyB52ix7V7P vRSJPue0UqtYCoCNigx95/lM1GXxv4o8UrwOQSazsQzUplE4tos+na5Ac16dWqHVi+pG24meZMf oSufbxcZ7XMaSLaBk9H3518g3H4Waw4sjTOpshcv0wcuU6jRZnplcetdyirukHrNYnm+3WO57IR CgdWovHOJG/NEorkOEzPHn04BZ1v9LMHxnACgHxVEmCHhwZOPrGHrCjKsaPyCNbQdiKAHqiTOmn SUKhtPfx8o51NaNjl0iHNhWSM3K85kb7LVYelz+CzL1sTh39gOoa7QYY6SWdHnvuWIYxOY/Sof2 UpsfFAKDweahCrKv+3hNF4dapcXdKclZCXpQ0+xPeNORXTLW5D5a2CYHvzWSw9o2yPW1B9ubSJu iuJ80yoS3eK3ihA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8361 Adapt the Toaster documentation after the Poky became obsolete. Signed-off-by: Antonin Godard --- documentation/toaster-manual/reference.rst | 12 +++--- documentation/toaster-manual/setup-and-use.rst | 56 ++++++++++++++------------ documentation/toaster-manual/start.rst | 6 +-- 3 files changed, 37 insertions(+), 37 deletions(-) diff --git a/documentation/toaster-manual/reference.rst b/documentation/toaster-manual/reference.rst index 3050b5d0f5..4dbcda37ff 100644 --- a/documentation/toaster-manual/reference.rst +++ b/documentation/toaster-manual/reference.rst @@ -161,16 +161,15 @@ As shipped, Toaster is configured to work with the following releases: - *Yocto Project &DISTRO; "&DISTRO_NAME;" or OpenEmbedded "&DISTRO_NAME;":* This release causes your Toaster projects to build against the head of the &DISTRO_NAME_NO_CAP; branch at - :yocto_git:`/poky/log/?h=&DISTRO_NAME_NO_CAP;` or :oe_git:`/openembedded-core/commit/?h=&DISTRO_NAME_NO_CAP;`. - *Yocto Project "Master" or OpenEmbedded "Master":* This release causes your Toaster Projects to build against the head of the master branch, which is where active development takes place, at - :yocto_git:`/poky/log/` or :oe_git:`/openembedded-core/log/`. + :oe_git:`/openembedded-core/log/`. - *Local Yocto Project or Local OpenEmbedded:* This release causes your - Toaster Projects to build against the head of the ``poky`` or + Toaster Projects to build against the head of the ``openembedded-core`` clone you have local to the machine running Toaster. @@ -277,7 +276,7 @@ release selection: &DISTRO_NAME_NO_CAP; - git://git.yoctoproject.org/poky + git://git.openembedded.org/bitbake &DISTRO_NAME_NO_CAP; bitbake @@ -513,8 +512,7 @@ at the `Django `__ site. However, several ``manage.py`` commands have been created that are specific to Toaster and are used to control configuration and back-end -tasks. You can locate these commands in the -:term:`Source Directory` (e.g. ``poky``) at +tasks. You can locate these commands in :term:`BitBake` at ``bitbake/lib/manage.py``. This section documents those commands. .. note:: @@ -551,7 +549,7 @@ example that assumes default repository and :term:`Build Directory` names: .. code-block:: shell - $ cd poky/build + $ cd project/build $ python ../bitbake/lib/toaster/manage.py buildslist If your Toaster database had only one build, the above diff --git a/documentation/toaster-manual/setup-and-use.rst b/documentation/toaster-manual/setup-and-use.rst index a0c27499ba..6ca5d252a3 100644 --- a/documentation/toaster-manual/setup-and-use.rst +++ b/documentation/toaster-manual/setup-and-use.rst @@ -15,15 +15,15 @@ Toaster`" chapter, you are ready to start Toaster. Navigate to the root of your -:term:`Source Directory` (e.g. ``poky``):: +:term:`Source Directory` (e.g. ``project``):: - $ cd poky + $ cd project Once in that directory, source the build environment script:: - $ source oe-init-build-env + $ source layers/openembedded-core/oe-init-build-env -Next, from the :term:`Build Directory` (e.g. ``poky/build``), start Toaster +Next, from the :term:`Build Directory` (e.g. ``project/build``), start Toaster using this command:: $ source toaster start @@ -112,8 +112,8 @@ This example binds to a specific IP address on the host's NIC:: The Directory for Cloning Layers ================================ -Toaster creates a ``_toaster_clones`` directory inside your Source -Directory (i.e. ``poky``) to clone any layers needed for your builds. +Toaster creates a ``_toaster_clones`` directory inside your :term:`Source +Directory` to clone any layers needed for your builds. Alternatively, if you would like all of your Toaster related files and directories to be in a particular location other than the default, you @@ -124,8 +124,8 @@ causes Toaster to create and use ``$TOASTER_DIR./_toaster_clones``. The Build Directory =================== -Toaster creates a :term:`Build Directory` within your Source Directory (e.g. -``poky``) to execute the builds. +Toaster creates a :term:`Build Directory` within your :term:`Source Directory` +to execute the builds. Alternatively, if you would like all of your Toaster related files and directories to be in a particular location, you can set the @@ -155,8 +155,8 @@ superuser by following these steps: is the :term:`Build Directory`, invoke the ``createsuperuser`` command from ``manage.py``:: - $ cd poky/build - $ ../bitbake/lib/toaster/manage.py createsuperuser + $ cd project/build + $ ../layers/bitbake/lib/toaster/manage.py createsuperuser #. Django prompts you for the username, which you need to provide. @@ -233,17 +233,21 @@ Perform the following steps to install Toaster: $ sudo /usr/sbin/useradd toaster -md /var/www/toaster -s /bin/false $ sudo su - toaster -s /bin/bash -#. Checkout a copy of ``poky`` into the web server directory. You will +#. Checkout a copy of :term:`BitBake` into the web server directory. You will be using ``/var/www/toaster``:: - $ git clone git://git.yoctoproject.org/poky - $ git checkout &DISTRO_NAME_NO_CAP; + $ git clone git://git.openembedded.org/bitbake + +#. Checkout a version of :term:`BitBake` matching the current Yocto Project + &DISTRO_NAME; release:: + + $ git checkout &BITBAKE_SERIES; #. Install Toaster dependencies using the ``--user`` flag which keeps the Python packages isolated from your system-provided packages:: $ cd /var/www/toaster/ - $ pip3 install --user -r ./poky/bitbake/toaster-requirements.txt + $ pip3 install --user -r ./bitbake/toaster-requirements.txt $ pip3 install --user mysqlclient .. note:: @@ -253,7 +257,7 @@ Perform the following steps to install Toaster: manager to install the packages. #. Configure Toaster by editing - ``/var/www/toaster/poky/bitbake/lib/toaster/toastermain/settings.py`` + ``/var/www/toaster/bitbake/lib/toaster/toastermain/settings.py`` as follows: - Edit the @@ -298,9 +302,9 @@ Perform the following steps to install Toaster: #. Get Toaster to create the database schema, default data, and gather the statically-served files:: - $ cd /var/www/toaster/poky/ + $ cd /var/www/toaster/ $ ./bitbake/lib/toaster/manage.py migrate - $ TOASTER_DIR=`pwd\` TEMPLATECONF='poky' \ + $ TOASTER_DIR=`pwd` TEMPLATECONF='poky' \ ./bitbake/lib/toaster/manage.py checksettings $ ./bitbake/lib/toaster/manage.py collectstatic @@ -322,12 +326,12 @@ Perform the following steps to install Toaster: directory is created on the file system. In the example above, ``TOASTER_DIR`` is set as follows:: - /var/www/toaster/poky + /var/www/toaster/ This setting causes the Toaster :term:`Build Directory` to be:: - /var/www/toaster/poky/build + /var/www/toaster/build Finally, the ``collectstatic`` command is a Django framework command that collects all the statically served files into a designated @@ -380,14 +384,14 @@ Perform the following steps to install Toaster: - + Require all granted - WSGIDaemonProcess toaster_wsgi python-path=/var/www/toaster/poky/bitbake/lib/toaster:/var/www/toaster/.local/lib/python3.4/site-packages - WSGIScriptAlias / "/var/www/toaster/poky/bitbake/lib/toaster/toastermain/wsgi.py" + WSGIDaemonProcess toaster_wsgi python-path=/var/www/toaster/bitbake/lib/toaster:/var/www/toaster/.local/lib/python3.4/site-packages + WSGIScriptAlias / "/var/www/toaster/bitbake/lib/toaster/toastermain/wsgi.py" WSGIProcessGroup toaster_wsgi @@ -419,16 +423,16 @@ Perform the following steps to install Toaster: [Service] Type=forking User=toaster - ExecStart=/usr/bin/screen -d -m -S runbuilds /var/www/toaster/poky/bitbake/lib/toaster/runbuilds-service.sh start + ExecStart=/usr/bin/screen -d -m -S runbuilds /var/www/toaster/bitbake/lib/toaster/runbuilds-service.sh start ExecStop=/usr/bin/screen -S runbuilds -X quit - WorkingDirectory=/var/www/toaster/poky + WorkingDirectory=/var/www/toaster [Install] WantedBy=multi-user.target Prepare the ``runbuilds-service.sh`` script that you need to place in the - ``/var/www/toaster/poky/bitbake/lib/toaster/`` directory by setting + ``/var/www/toaster/bitbake/lib/toaster/`` directory by setting up executable permissions:: #!/bin/bash @@ -436,7 +440,7 @@ Perform the following steps to install Toaster: #export http_proxy=http://proxy.host.com:8080 #export https_proxy=http://proxy.host.com:8080 #export GIT_PROXY_COMMAND=$HOME/bin/gitproxy - cd poky/ + cd /var/www/toaster/ source ./oe-init-build-env build source ../bitbake/bin/toaster $1 noweb [ "$1" == 'start' ] && /bin/bash diff --git a/documentation/toaster-manual/start.rst b/documentation/toaster-manual/start.rst index 2d6474852a..ed7b0e1644 100644 --- a/documentation/toaster-manual/start.rst +++ b/documentation/toaster-manual/start.rst @@ -25,10 +25,8 @@ Establishing Toaster System Dependencies Toaster requires extra Python dependencies in order to run. A Toaster requirements file named ``toaster-requirements.txt`` defines the Python -dependencies. The requirements file is located in the ``bitbake`` -directory, which is located in the root directory of the -:term:`Source Directory` (e.g. -``poky/bitbake/toaster-requirements.txt``). The dependencies appear in a +dependencies. The requirements file is located in the :term:`BitBake` +repository, (``bitbake/toaster-requirements.txt``). The dependencies appear in a ``pip``, install-compatible format. Install Toaster Packages From patchwork Wed Dec 24 16:31:59 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77457 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 A1E30E776CC for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123206.1766593932047556297 for ; Wed, 24 Dec 2025 08:32:12 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=qlkGFi6i; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 75A281A23E1 for ; Wed, 24 Dec 2025 16:32:10 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 4D5E66073D for ; Wed, 24 Dec 2025 16:32:10 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8FFA410AB1389; Wed, 24 Dec 2025 17:32:09 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593929; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=xNY//6xemVq01iKazb6TN9+rWF1GeTGpg00fSb1H7Us=; b=qlkGFi6ibkpgmSjFJ9BW07mjHXYUoKscy/AGsxoDaQr5oklN1cdXim3z0J112q5mNxTta9 Cq5TylviNxahV9eVanueVogenL/jXUOHhSpf0Z7kv97FqUQT8z98qJ7DxsTIx2+JlXtPFw Q5D2lb1Ec0Ru7Cb7NgJetkwHqBNjsfMhChc+qARAKaDmXDG9yRN16c+a85Hmlzj1p4Ye5/ KabPGnBPDvWCUOG2dxTevTlPV9Bvg2M8A9ipSpfcgLpzE6aMc/P2Rb9aB7BVjH9dHV1a5M AbiEf8rnS1KfY/Cw/0uOg3dN7gxAz5DJQZcPwMy3TkkkscduPjcsL7XJwcOnBA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:31:59 +0100 Subject: [PATCH 33/53] README: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-33-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3024; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=WtWoQKg3SyODHtu/nyL4Xk4pYOVrsHpZDGLmSD53WKE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVst/bv1iO+ybMP/lq+3dVtqPbpDQqw6CgZx EGtmz6g14eJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbAAKCRDRgEFAKaOo Nj8VEAC9NKp7lwZ4wPaHy6nMoeOa9zI7ZWcviYy2CcMgb2oPIkCdywWHljXbgyFjsAuXFruvA6o DKYijPJfxVgy8ceiF/doodcO/QOjHcBcdOiEQ0nEbzwLz1pzfmeA/5SFp66L4jet3fuHahVvcMF FQNHXPVIz4iQffVQIzzuq8ueDT6vIT4ie3F4LUJ6HT8xe3/E5QDM08MFVBdNvvWceCOzTy1zAa9 DEIufasdwvmqFUWVPmzSghw8KKNoowKpvIR24OH+LEP72ILT3T6v2RqUu6Mk1ncz1yIFqnGVFlA eA6ak8KMntT8mJWJRHspUS6NsRFuCyGuH7AwwJetuB/qKwRJkcmf+ciETomZ0O8oI2oFHguFNxl yYyUq7eApqg5CDwIpFYFdfT0EYW3N3FGBonvuapAx3G3gZCk1X9g2vOdVWiGTXqgJMMVZj3Mw7v LD/NZbhr8waplnE2Y5cEyT4IQh3VEXGBjuPJOK/vjbBcajp/HxF250aRAXn6NFiHPcVuse9wZVX SHIJ6ta0oGUw/Je+4SvjekGEmnZWKhRcnfjpY+m9dtaOahWa8i6fiVDi+64dA5drdJamMGYfTsh ufWgg+UjeOR9PxYgMGFecnC23YXJQhCFccfxuZPhZswl6xmrQ/IQ1hddtJJgLisxreoKDDCRFRe HHSE4i6zQmn7H+w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8362 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/README | 39 ++++++++++----------------------------- 1 file changed, 10 insertions(+), 29 deletions(-) diff --git a/documentation/README b/documentation/README index 56eac7ca1..58b00ff5c 100644 --- a/documentation/README +++ b/documentation/README @@ -1,33 +1,14 @@ documentation ============= -This is the directory that contains the Yocto Project documentation. The Yocto -Project source repositories at https://git.yoctoproject.org/cgit.cgi have two -instances of the "documentation" directory. You should understand each of -these instances. - - poky/documentation - The directory within the poky Git repository containing - the set of Yocto Project manuals. When you clone the - poky Git repository, the documentation directory - contains the manuals. The state of the manuals in this - directory is guaranteed to reflect the latest Yocto - Project release. The manuals at the tip of this - directory will also likely contain most manual - development changes. - - yocto-docs/documentation - The Git repository for the Yocto Project manuals. - This repository is where manual development - occurs. If you plan on contributing back to the - Yocto Project documentation, you should set up - a local Git repository based on this upstream - repository as follows: - - git clone git://git.yoctoproject.org/yocto-docs - - Changes and patches are first pushed to the - yocto-docs Git repository. Later, they make it - into the poky Git repository found at - git://git.yoctoproject.org/poky. +This is the directory that contains the Yocto Project documentation. The Yocto +Project documentation is hosted at https://git.yoctoproject.org/yocto-docs: + +This repository is where manual development occurs. If you plan on contributing +back to the Yocto Project documentation, you should set up a local Git +repository based on this upstream repository as follows: + + git clone git://git.yoctoproject.org/yocto-docs Manual Organization =================== @@ -261,9 +242,9 @@ For example, the following .rst content will produce the 'expected' content: .. code-block:: - $ mkdir poky-&DISTRO; + $ mkdir project-&DISTRO; or - $ git clone &YOCTO_GIT_URL;/git/poky -b &DISTRO_NAME_NO_CAP; + $ git clone &YOCTO_GIT_URL;/git/yocto-docs -b &DISTRO_NAME_NO_CAP; Variables can be nested, like it was the case for DocBook: From patchwork Wed Dec 24 16:32:00 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77458 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 9C898E776D8 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123207.1766593933124592395 for ; Wed, 24 Dec 2025 08:32:13 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=x96SUS+T; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id A63481A23E2 for ; Wed, 24 Dec 2025 16:32:11 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 7D1706073D for ; Wed, 24 Dec 2025 16:32:11 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 43F8D102F0CD4; Wed, 24 Dec 2025 17:32:10 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593931; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=6f3v4mLInx1X/WGe58Xb8U80/YIH3XFvpTI7vXB+pt8=; b=x96SUS+Tg31WIZuwnemnOxET71rvaeUm9LdIYkaw3O9b6Ztpe5X9XpXIbWdIbADzwhp1Yr +Aw5HPfs1sfR1o70T2iUlE4WFY/92943WDxS10hJ8bW0+0XhyYWjCddowKIkBnH07q3TVQ 86TwxalP5/lQwrt7ShCzYUP+SzxlDW+V9a0JZyFeGmXj4jMHbhNXqUjghWgnxIfQkZL8Lx 75v9RtcpxbbSZ7qoB3IYySNjq6QifdlN+RFKWAvBWMyZrHKEJvP8K0iH3fmvm2mGxEy4H0 4BkVxO3SSbjopk3EiI1NQZaxEcQUBhDf/nocvNaGSyeg0LUmFO/WRV9fKq89Pw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:00 +0100 Subject: [PATCH 34/53] contributor-guide/identify-component.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-34-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1322; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=oIB9K+6BA2oq3PaXV0DFPAWhJUfLobhT7/H7NPlBgaQ=; b=kA0DAAoB0YBBQCmjqDYByyZiAGlMFWyg6gyfZBB0AR3dpGqaXrvUDu+KbfTr6bND2X7kMjzQn 4kCMwQAAQoAHRYhBIZIclGI3UAbuaDT/9GAQUApo6g2BQJpTBVsAAoJENGAQUApo6g2rVIP/2jn KpthBcrV37WU0BQm6Jb9DHcxc5eTWO5zkVZNVZMKVh896S4spiXnwz1F84khbQbwD+QsBjEQG4G KMaN28YM0SfC5JVvCxoBLLUQtDALL+KfWFow9svTR9JRmp5CUbmL6/YIW/UH1iQ/GbnDScWuCnn cn4B+1EQV+YvBiuuvR6WyPftf+O3NWwb6mkgcmlpP8vnU+Yl2bLqRE3jMkXaCL3oEyDVmb5ap5A VCSOUKVoDLBmb7S0Metn+1P3i8yBS5LUYTet+vfVieLu4wnt1RCRNDuLGMITqAvzhMMnudCbS/J icXRe9IG6EvlB4jJuoRZmgMNNUXslQW0kDioet53hHHO9Cs//1xkzcSgb491DSa4rrjOOCrzfNH cxH01YUb/1fGpHCroYY3oNJ+z7AbiIubUWp+EFer4B4nGY+6XAh1tcE6Z46Zi6SQwbtGOcWCMPo 0eTvR9bB+bcHx+SKXI7JKUPWPfc8w74GsdVimEP2x8d9aWqrwjhqqrM9eYd0v3Z0usu7Gw15tEH uaKZuAIFuCNiDmD1AFKVY+5NkzSkn7DxSoRNUSzb4S7jDIEviB0mtMVnSVu8NnjcWcgbY9TxXq0 J7hlUn+ArtYZHhyvBXAnZICX0kWid5W8fMfAuLWJrtBtja19Bpd2DCx+NtsVIcXw+faWmpSejry Fdk8j X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8363 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/contributor-guide/identify-component.rst | 9 --------- 1 file changed, 9 deletions(-) diff --git a/documentation/contributor-guide/identify-component.rst b/documentation/contributor-guide/identify-component.rst index a28391a66a..6cf8ed9858 100644 --- a/documentation/contributor-guide/identify-component.rst +++ b/documentation/contributor-guide/identify-component.rst @@ -20,12 +20,3 @@ If the issue is in the core metadata layer (OpenEmbedded-Core) or in BitBake, issues can be reported in the :yocto_bugs:`Yocto Project Bugzilla <>`. The :yocto_lists:`yocto ` mailing list is a general “catch-all” location where questions can be sent if you can’t work out where something should go. - -:term:`Poky` is a commonly used “combination” repository where multiple -components have been combined (:oe_git:`bitbake `, -:oe_git:`openembedded-core `, -:yocto_git:`meta-yocto ` and -:yocto_git:`yocto-docs `). Patches should be submitted against the -appropriate individual component rather than :term:`Poky` itself as detailed in -the appropriate ``README`` file. - From patchwork Wed Dec 24 16:32:01 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77471 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 0A075E776DC for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123734.1766593934030443053 for ; Wed, 24 Dec 2025 08:32:14 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=EVhzWiDh; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 711091A23E0 for ; Wed, 24 Dec 2025 16:32:12 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 465CD6073D for ; Wed, 24 Dec 2025 16:32:12 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5DDA910AB1371; Wed, 24 Dec 2025 17:32:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593931; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=TMMHrMWHOEBL9IN2NSA9WLtFyits+4nHy8QQU37mBQo=; b=EVhzWiDhjh9g1ptW/ObS83ed535RWbmmpHwgpjUVOdtye7Ae1mPuQjvp+3dlQ5WXUUnOxP 4mS8FHTBcdVFv3RcFdJRRnsLdM/Hp3jkGsLKNLHnoBKS9MplB4t99Pk4st/Ol3UW0z/trK ycYLpP1yJavumhliDW95MCPWpg/wvo4t2wkzDug6Yv+7l3NqodAhyop9mwnPB1RAjNblda 7zqHnvayNOYz5niYxHetZ6VZYegzk0rfqCDEBzLWWYZWSJd2kJoYxocxkA9lDwaq3o5Khy JvT5byRpjrB4o0V3ZRfv8ZlSTYeU6xjeA3iNlfkl3cht8+a7E7FQwZ1/AJqwGQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:01 +0100 Subject: [PATCH 35/53] dev-manual/build-quality.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-35-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=988; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=pNuNmYq5QUQfhZIfre06iuVv8VtubfmfZrdtGW+6P3Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVtxoIvUVV5kqsVA3Xw3ksSLCYlyFOntLW2g gcUmGT5oh+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbQAKCRDRgEFAKaOo Ntb2D/47G5Xz88TB+Lu8Vs2DBfhUaCLX6ZyiTRvljtjrA4/PmL/5p7k0GdiGrnAleU2Oic4ufMn VzfqxgIlnqQS7iuCdC7aj53EKxRObF26wZL9Au9xcgLjqfZamgifMtcfEunojRNKyrCue9t1XJt GWLkZR/Snba5lU8FwqCNB1X4LWyoSg+CLKTeJgw8NyT9IdMyQV2TVR9sRkw3WcN68mtHIP7D/g2 SfzHEDk5EJNfo9y7OfMBk81JWh//ykM/UT/ay0ix0tQXW/aKqG8/u7W4Se2Tzq97+HBDkJDkB2s w366pb+KO1d8U24SR5X/xCqusPDTvk1hc7CvNpEbjD2EVi8AiSEcx1AY8XnKrEZxEOZVrgjHZuz 4wzFg5Dan4/3y2Mbu1aoiOAQTES5bWRfj7ZNgZzUVqJpBitrWzWh/qkyIOaOtWoef4cJaxh6Xd9 MrZN+AmIXaqvJ72OLWIGFd2foCdlixaX7hVEEjNKojINzQYmHCBtLzxV+XVKkZgOuwastKoE3T1 XAGCrHtdorD/GuGHgO0Y8z798VtkyPjT8UOWM/xD5enEaTvoTOKX1I3l+Z6mRSnbxr6pKPQm8Ar TVjh1Ol7vnlCOdy3wWuyGhSDl+lxwqZ5qWanGOZLFjuHt6zEYK5t8lsTAdFU5j/cqLJbDL72UtH L/MsR/XVw/X0EmQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8364 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/build-quality.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/build-quality.rst b/documentation/dev-manual/build-quality.rst index fbe5fb6f0..8867f6dcb 100644 --- a/documentation/dev-manual/build-quality.rst +++ b/documentation/dev-manual/build-quality.rst @@ -372,7 +372,7 @@ There is a command-line tool called ``buildhistory-diff``, though, that queries the Git repository and prints just the differences that might be significant in human-readable form. Here is an example:: - $ poky/poky/scripts/buildhistory-diff . HEAD^ + $ project/openembedded-core/scripts/buildhistory-diff . HEAD^ Changes to images/qemux86_64/glibc/core-image-minimal (files-in-image.txt): /etc/anotherpkg.conf was added /sbin/anotherpkg was added From patchwork Wed Dec 24 16:32:02 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77475 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 1A787E776EC for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123208.1766593935461574240 for ; Wed, 24 Dec 2025 08:32:15 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=BG8RKtUH; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id F33461A23E1 for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C471A6073D for ; Wed, 24 Dec 2025 16:32:13 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2B6CF10AB1373; Wed, 24 Dec 2025 17:32:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593932; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Cm9MWeGzWSVGQGms11BYPEx3F2TTwAdAAuM8wdbwZsE=; b=BG8RKtUHknD2eIUpo3vEKze0gqtNa8sDr7cFzSY6cgbApJxEcvZTRSS09vg6OnNav1c8EG /+kTy4YIT95TxqjAq4RTbuNjWH0VLVkH4UV3sZKUIWuqPDuLWjpp26//w9qLefv/QzQd/0 bM6WzQIwoLYCbiowv3ed2mSa8y186kmhWpBhmBq4RKtB0kkOOml/tbG8KDLroMBPcoEItr nce3+akAcakznvuvIQ3KzatsIFnvFwldSTS5OnOcGvvlQ6NClwkt5AdpeturkSGJ9dl6/a kyiT5qZwGsaq6CzngPRl5fC6jj4NdXurOsHar/B1ej/iHah1qdiKrM3DfILk+w== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:02 +0100 Subject: [PATCH 36/53] dev-manual/custom-distribution.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-36-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1135; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=5r3QNSo5SsZMeRHR3ih1bLMXtiHP5WPc1Z7/wBgppcM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVtjjH/hzAso1Bnq+cMh7HsZ+CSdBQnRllOf P7qWN6mXm+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbQAKCRDRgEFAKaOo Nj68D/44k+rh98ujOpaxENBSQ2T9KvOul4kJHk/Wn5rGSFrZP35F/mvlcLrPYn0mme3JQXrTVo8 MoZ8sfd3u027l2NEzRetVQ9EV7Z/iYulKNY+688uk25dutoPxd/GPy7mAa427TiHhjxDn4TA7rx Q2Z5xULZsJv19mTyqVfonbUYMoOuBw3ujhKCBymJmijBm1MBhd2qWVqvz0oS0XNQSf14kzdkN5z mav9csHE/9+kDOqzT2kmdT8Yos7R4RyvT2C7wn4KJv3/VZKQNHJ3VKDO0Ra1Q0IGy16Hwrk39Lq OgKSsrENqJHJQRYQzkILXqZfShUmDbtbqD/fUKVBJ+xIaqRzUUjsiFBHSEOjhDKYMJuRPxjk/33 I9Ez08SypWZ71xzd6JEW6vAuxRK9hB35k/LONR0YvxcKwbXZvRigDX0rM3N2bqL0jlowLXqnU2V Di6IuKdiBx3v7PhSqAM5DhnOL7uqSNFHjyC1S6ztWjU4zwHYnm0ZdnB4zn/UFBx4DBgRzDXR93j XOqf021UUS3x+4HxC+rO/EewioMfe/rrA/Hsb8+MBIAqsI4rIrjk/h8S0u/CJKH1PklNrI4ZYNi Z5AczaY4QvWkp1tOPMJEI7LqoDwKYZ/MEQALkeupeYfw2OSvs1bR3OZiCtouRw+DdjhXbbMEGdl hS2ef5nrNAZzHyg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8365 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/custom-distribution.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/documentation/dev-manual/custom-distribution.rst b/documentation/dev-manual/custom-distribution.rst index 55854f00e..4dafd2725 100644 --- a/documentation/dev-manual/custom-distribution.rst +++ b/documentation/dev-manual/custom-distribution.rst @@ -3,8 +3,10 @@ Creating Your Own Distribution ****************************** -When you build an image using the Yocto Project and do not alter any -distribution :term:`Metadata`, you are using the Poky distribution. +When you build an image using the Yocto Project and follow the default setup +showcased in :doc:`/dev-manual/start`, you are using the :term:`Poky` reference +distribution. + Poky is explicitly a *reference* distribution for testing and development purposes. It enables most hardware and software features so that they can be tested, but this also means that from a security From patchwork Wed Dec 24 16:32:03 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77482 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 6EA17E78484 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123209.1766593936071331147 for ; Wed, 24 Dec 2025 08:32:16 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=txlfE2dZ; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 7DC401A23E0 for ; Wed, 24 Dec 2025 16:32:14 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 541C96073D for ; Wed, 24 Dec 2025 16:32:14 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9AE4F10AB1370; Wed, 24 Dec 2025 17:32:13 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593933; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=kWakI1MCIj77bMq0pvxzMc4jl03f3LkRTh6wIC/mKLw=; b=txlfE2dZ1rdIys89xgx88UhMo2RgFyt9yTfHwo4yUKRQDxaKQlO4kGkUmQWgut3TXNg+iW Pmz2DcMfx569ZBKqBQ2K/2VtK46J2egZyyoxjQuaNNX+5aTFVV9yNZKQ4Ts7nEc7+BEXPe SgLzI+v2NaqU03jORZAH6txHHjoIaO4H8LPqn2IQAh5mLb91Z/ZOUAyQbGAEgqAt/sld8C OY/HNci5SZ3ReCm+ucPyNNWcYCPwlJ3D9PkQapwWVjP9w8Q2rD5LQt2uvE469en2SbicgW SDP9ZQ1PfuKplNpg9TKQlDzf3MhKmY02qlD7+cD75b/NSJACY2IGGM9S8RGOQg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:03 +0100 Subject: [PATCH 37/53] dev-manual/custom-template-configuration-directory.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-37-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2540; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=d/0q2LDjws/ihTqbTSv8U0pT6EFBt5UX0ulcD3sxvjI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVt95DpCGyjzArJio1Pdx/d38H1MEI5bCul3 PX3IAS4+F2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbQAKCRDRgEFAKaOo NqtBD/0amEkD4BucU5JIPP/yNRL+pypjgxdxADQnaYgjLDXQPFK6LPKXZLdBzJMTMOb6/HWIKxa q5KnQ4LOAlnocYsa10NMx3awl/m+I27grFjWJRJ+Nykvy/o6Olkz+hSompEiv8Ogwb3zBF8i97E WdGU+aLXrV5doBl09HgtaKHnM7hTJ/A4JsKDo9A2X/kUZtMqQs+7wJ4el7MrQ6IVCD7ZLwCJfhd 0reg9y3q1EgewZUYKupq3Yb3BtMckFF7TDB/QtdfIn4u65FsvUKR3GPdj4XifVo3BWHDmUIcnHc Fvu4dGrJe3pXwMGe1zepSb71LJMwtb3du9dfIxJJ1nDhQH/hrTWhyp0T+XdyshRoo7C2/KpgjPo ewEpSTFAisTRoQKTu6TL2qCnMxL/5FGgM9p0/UbY5Mp2JNrg3S3N0LgUoCRuOM42hwnSTSRryGs KPrSyMhLFhZD7Hl3sTkwH/Du+gNZo0yegiv1nl95To/hpYGymJqTZ/TQmZC46TBzbL1EwyCOjEe 5uu+g6xz+BYD90fRRYY3rgzPEJH5gC7ejW2DMNIl5zdmdfmBHs3RomRQZZ9r7tdpDmpRZS88ve7 u+gJozBzmheWnEy1TbEt1na+PDXbbiO8Rqy9ox/10tk+Exu9MmnxFEzJ8hiaAmTUeNrJ8D08jfd Y+GS3S9Ry+YmcMw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8366 Refresh the document now that the Poky repository is obsolete. Adapt paths to match to encouraged Source Directory layout. Signed-off-by: Antonin Godard --- .../dev-manual/custom-template-configuration-directory.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/custom-template-configuration-directory.rst b/documentation/dev-manual/custom-template-configuration-directory.rst index 06fcada822..0750420abf 100644 --- a/documentation/dev-manual/custom-template-configuration-directory.rst +++ b/documentation/dev-manual/custom-template-configuration-directory.rst @@ -15,10 +15,10 @@ This can be done by using ``bitbake-layers save-build-conf``:: $ bitbake-layers save-build-conf ../../meta-alex/ test-1 NOTE: Starting bitbake server... - NOTE: Configuration template placed into /srv/work/alex/meta-alex/conf/templates/test-1 - Please review the files in there, and particularly provide a configuration description in /srv/work/alex/meta-alex/conf/templates/test-1/conf-notes.txt + NOTE: Configuration template placed into /srv/project/layers/meta-alex/conf/templates/test-1 + Please review the files in there, and particularly provide a configuration description in /srv/project/meta-alex/conf/templates/test-1/conf-notes.txt You can try out the configuration with - TEMPLATECONF=/srv/work/alex/meta-alex/conf/templates/test-1 . /srv/work/alex/poky/oe-init-build-env build-try-test-1 + TEMPLATECONF=/srv/project/layers/meta-alex/conf/templates/test-1 . /srv/project/layers/openembedded-core/oe-init-build-env build-try-test-1 The above command takes the config files from the currently active :term:`Build Directory` under ``conf``, replaces site-specific paths in ``bblayers.conf`` with ``##OECORE##``-relative paths, and copies @@ -27,7 +27,7 @@ the config files into a specified layer under a specified template name. To use those saved templates as a starting point for a build, users should point to one of them with :term:`TEMPLATECONF` environment variable:: - TEMPLATECONF=/srv/work/alex/meta-alex/conf/templates/test-1 . /srv/work/alex/poky/oe-init-build-env build-try-test-1 + TEMPLATECONF=/srv/project/layers/meta-alex/conf/templates/test-1 . /srv/project/layers/openembedded-core/oe-init-build-env build-try-test-1 The OpenEmbedded build system uses the environment variable :term:`TEMPLATECONF` to locate the directory from which it gathers From patchwork Wed Dec 24 16:32:04 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77484 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 73E32E78486 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123210.1766593936555394552 for ; Wed, 24 Dec 2025 08:32:16 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=TB27LqAW; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 183E51A23E2 for ; Wed, 24 Dec 2025 16:32:15 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E4B416073D for ; Wed, 24 Dec 2025 16:32:14 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 3A0C910AB1372; Wed, 24 Dec 2025 17:32:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593934; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=wm5yK5G9iaR47BYXuZoiirQ5zbqRNKBaMmEtu4wLyuo=; b=TB27LqAWimNu+hmZxhwHGAQq/EVrC27qbnrOZUlugcbTD15hmKHX7VC+aM/fHyAUS1I6mz 24Q822VGepTiOkz7Wk8fGdWE+ZSlu3Jvo3GTRhFoOtMuarNOfmwuFzKuIH32FzCIJTTj++ I2OClwNbNwBN9GKuDdpmeX6gxAMm2yz+yd5j4Iq1W8JQlcaBw/z5AqwIjc7TD7Mwe7X232 t8znJNFTmys2ImqDOQdX3y4a/TTBQXgTi8LOkRQJeWsEzh6DAOT3F91UgRxzaiHjJq32v/ t6xNQePQqVH2Hg3DTcoDJM/IIFVRqCAa502Kdn/yw4J3BWCEzTIKiGnP0CRYNA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:04 +0100 Subject: [PATCH 38/53] dev-manual/init-manager.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-38-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1312; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=kbovHoN1yoqGn9WkEW4GZKvw0fJ0boTr1zQv/a41PNM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVtk7MSoH29hgSwGeyiQIkzmxPbEdKZ26sJO +Lbv8fphTiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbQAKCRDRgEFAKaOo NljeD/0QYHaccrXBnM0GudMdRVenauiQ1djXKnIXJyrJn+L69BZ7YVJDHv4/eYfxpxssBRGetHi VJFLRisuxvQYqClyUVKO5lUwvQo/ucw0snxFu2Q6yTJXZrugfvbdMxdrnnoXZrIYZ9Gq8O4EcKW pGMfOBV6/fq6+JHpPd9+b4p9+XfgWCMEUwpXxXcpngvHoU/hz4Tl9rbmuetW5ufwj3czrDKERP+ 4SURSBSWQIKkLzaS3RCdNlJoZNdzuucdg6luErFQTJjkGu1Gb1/eVqH9XV1WlLhpirlQcRxIBbB t4w14PF7tsrfhK4eOEK/QFziPCbpsNCwMtz2bj05rxqUUwn1iy6R+fNL7A/8fh+PwOFD0QNPxLZ D3PvrNnHbbmXMtLOvOn3jWFGIxls4Ww4SmyoCiL+ZUiTovQ/UxjnxdYyFcRaTnehT4/RP6Q/8k3 M+/yYMpI5Yr5eTnaHzFhDQ2+bHKv2E7WINslk7oAsVol4pJwHJH/bGoRSy90PvIzmb79iryROsX cI/058G4yryLXrLgwDjSr9NRLdPh6N9mWoImtIuSPkmnQ6e0vt7LtuPQzMTquAvXvf7X/wVjrs3 Ko0x1AaSl1l/vXq90Dm0FZvVmscI0Q9ZRsd+cSnSRCdoEdbxIGE6u4vYfId8W2uwCDZcnhYb3We NOculXm8uEAzTCw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8367 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/init-manager.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/dev-manual/init-manager.rst b/documentation/dev-manual/init-manager.rst index d0fdfdf77..670810310 100644 --- a/documentation/dev-manual/init-manager.rst +++ b/documentation/dev-manual/init-manager.rst @@ -54,7 +54,7 @@ Using SysVinit with udev ========================= SysVinit with the udev device manager corresponds to the -default setting in Poky. This corresponds to setting:: +default setting in :term:`Poky`. This corresponds to setting:: INIT_MANAGER = "sysvinit" @@ -77,8 +77,8 @@ for more complex systems:: INIT_MANAGER = "systemd" This will enable systemd and remove sysvinit components from the image. -See :yocto_git:`meta/conf/distro/include/init-manager-systemd.inc -` for exact +See :oe_git:`meta/conf/distro/include/init-manager-systemd.inc +` for exact details on what this does. Controling systemd from the target command line From patchwork Wed Dec 24 16:32:05 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77483 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 596BAE78482 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123738.1766593937149658310 for ; Wed, 24 Dec 2025 08:32:17 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=c+6VJg4P; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id A4A5F1A23E4 for ; Wed, 24 Dec 2025 16:32:15 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 756656073D for ; Wed, 24 Dec 2025 16:32:15 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D2F0110AB1376; Wed, 24 Dec 2025 17:32:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593935; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=GPnz7KACrwzllAwYZz7TRBcoznpW/O7GEwKF+qfbCbQ=; b=c+6VJg4PlFzbsQG477Wnrnlck4Ej9vZhMffoig9QHqbS5SmYeenFB2qEQ/gEfaHPqhGwgr ZpYH24Y0l8RO2pifySILejy8XjAKjmtPIDOgFyIcqa1XHlScRvBxwMwfKzrl8PBhpi0cU7 zE/qwGUyd85BOxlHqLZuhQOPV1IeAd4+Zhy7Ww7cvi9lWh0m+8OqfPkAV+B2p7XOdoktT3 kqP28XjnGiLIaUhuQViql5ugFBoSUZ3p0nkx3BsXPg/nimgDmX+FCBqXwdXEdk/2i9MHit eEfUJfMz6g/eXl0gpxBb/ekrPBHJ0LQ3fJRwyV6lg4DEbbi6V0L1psvZAVdghg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:05 +0100 Subject: [PATCH 39/53] dev-manual/licenses.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-39-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3413; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=cg1kb2OEUwrliiSQuQXjkSXlpUozeC4ZLp/3Su6ErbA=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVur/aN4s2Fi+f5kkc/KiiUnSNUOrknwyym+ Ffde1ohvbOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo NrJbEADOJAszHmyfr+oqJHB5r5Px7eOfSyWCq2796Cu5bndoRtfv95dNk03AuTXUGc4VeTZm5Zb MT1VTEkSS0vu3Lmd5w+vnnDF5lauRRpb0ufojSJuGrROh3+VXqRox9XHtyn1iIPIFvG/s/ibG1Q ZQBGBD84yH1OUai/ALcIdITxOCtp4eDmBjz2CHRUcjacmm+TseI+oRq1VGpy5Nrp0LVIi6N0K9z Ay1NcPwRinnxrQ79qlRH/jEQTBQ/eheHVp6uHoSTUb+aPTiUrXz8CwhJSA2dNakRLEMB6ScvMC7 o9YFXEj4nUhrOMf0kmcUBOLxPdOvVE7xZx+hCfk4a4QfblaLAOQx4ApgFaYWm0yPCr9GSQTEY+0 jaK5uveo8x0FVy+aCirlyPYCEjeRkHFTKEsg9u1MBknjvkuqIQcf8OG0GzS4PD83Y6JQB3+uZGr E4lJw/5lQVaQ79PFP0lzUnrCPa7KW6dUtqbLhZ/0xAmmbdmk1Wq5BK2dSdSTk/EH+UHLpc3W1Om qFhx7+eWcbMeAMK5EhzDahSLJdWV3tcD+oDCnO/xmaxfzq072VTBuG1iXAIWVg0MI2A+Pw/3v5G JXs8RVtryLtvmRwzwFolyQcm6jABQblSZAXz/88+It3WyHK/nyabK7X/VvlBj8Y1fLe2a9LtZ0q CROqMzUd22kA5Iw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8368 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/licenses.rst | 28 +++++++++++----------------- 1 file changed, 11 insertions(+), 17 deletions(-) diff --git a/documentation/dev-manual/licenses.rst b/documentation/dev-manual/licenses.rst index 7d6636eef..edd503bd6 100644 --- a/documentation/dev-manual/licenses.rst +++ b/documentation/dev-manual/licenses.rst @@ -112,8 +112,8 @@ commercial or other special licensing requirements. Such requirements are defined on a recipe-by-recipe basis through the :term:`LICENSE_FLAGS` variable definition in the affected recipe. For instance, the -``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` recipe -contains the following statement:: +``meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` of +:term:`OpenEmbedded-Core (OE-Core)` recipe contains the following statement:: LICENSE_FLAGS = "commercial" @@ -136,7 +136,8 @@ needs to have a matching entry in the global :term:`LICENSE_FLAGS_ACCEPTED` variable, which is a variable typically defined in your ``local.conf`` file. For example, to enable the -``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` package, you +``meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` of +:term:`OpenEmbedded-Core (OE-Core)` package, you could add either the string "commercial_gst-plugins-ugly" or the more general string "commercial" to :term:`LICENSE_FLAGS_ACCEPTED`. See the ":ref:`dev-manual/licenses:license flag matching`" section for a full @@ -244,7 +245,7 @@ Other Variables Related to Commercial Licenses There are other helpful variables related to commercial license handling, defined in the -``poky/meta/conf/distro/include/default-distrovars.inc`` file:: +``meta/conf/distro/include/default-distrovars.inc`` file in :term:`OpenEmbedded-Core (OE-Core)`:: COMMERCIAL_AUDIO_PLUGINS ?= "" COMMERCIAL_VIDEO_PLUGINS ?= "" @@ -464,18 +465,11 @@ those layers are used to patch, compile, package, or modify (in any way) any open source software included in your released images, you might be required to release those layers under section 3 of GPLv2 or section 1 of GPLv3. One way of doing that is with a clean checkout of the version -of the Yocto Project and layers used during your build. Here is an -example: +of the Yocto Project and layers used during your build. Removing the Git +objects can be done like so: -.. code-block:: shell +.. code-block:: console - # We built using the dunfell branch of the poky repo - $ git clone -b dunfell git://git.yoctoproject.org/poky - $ cd poky - # We built using the release_branch for our layers - $ git clone -b release_branch git://git.mycompany.com/meta-my-bsp-layer - $ git clone -b release_branch git://git.mycompany.com/meta-my-software-layer - # clean up the .git repos $ find . -name ".git" -type d -exec rm -rf {} \; One thing a development organization might want to consider for end-user @@ -494,9 +488,9 @@ automatically:: BBLAYERS ?= " \ ##OEROOT##/meta \ - ##OEROOT##/meta-poky \ - ##OEROOT##/meta-yocto-bsp \ - ##OEROOT##/meta-mylayer \ + ##OEROOT##/../meta-poky \ + ##OEROOT##/../meta-yocto-bsp \ + ##OEROOT##/../meta-mylayer \ " Creating and From patchwork Wed Dec 24 16:32:06 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77481 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 41E49E776FE for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123739.1766593937983446850 for ; Wed, 24 Dec 2025 08:32:18 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=sdXrw7MZ; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 470CF4E41D8E for ; Wed, 24 Dec 2025 16:32:16 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 061486073D for ; Wed, 24 Dec 2025 16:32:16 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5F33F102F0CD4; Wed, 24 Dec 2025 17:32:15 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593935; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=/WV1VM6qL4Eei5VCCpZaR1LG/xORxtjP4ChxaBiN934=; b=sdXrw7MZTQUfk0lhtIvmN2dK7wyKCM1BeFZKh5fd8O1Ccnq1bB8n0RDUr9uSflrxS7zxWt e64KQI9G228B9skFc+9MZuGvJnOC5gtVIkRJv8FXTDd+cfiDOD3gREJ0Kffn8LPNSsLan1 bQibPWFx8ERCCrHoANhg6PZtv6f6qxxHqxVdTcIXhk7SzSlYqZu5DIQ2AWUulJ62hgGj79 69Xb6EnAoENRKdeMFZ5AdJNa9v/06r9Cn0DU76lto/KfbXPuCUPP/+mQL/kMxOl6g3Hw9M gQYok/xs6QfdB/t7zlESKhdszvudPUzwFTs/KSPgPRGiHGSe1O3UsZo47G8Kzg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:06 +0100 Subject: [PATCH 40/53] dev-manual/packages.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-40-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1978; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=EPCa9C7yxCx05IP3i8YHKGbklM4tP03LJPiuC1Ochik=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVuI0PkG6vyOB0m9wP4wfEwoUmlnIYbj6zJg nXZS3C6Dt6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo Nk6MD/4uXvKt2295FrzbvOCuHcB2hb+phgkjgj7/WtC5FbX6Fjn065sB5g6x+c00gv+8MVw1yEl pgwk5+AJI0ZVRcy7jqD9keC2nbwALQJlnrIv5byO1IMCFRMebQnU46OCPrqVb5dO9pQ9GE0B48U 0oOBr31IV2hCVWwSByQlH4m6fo4XHrJZClKVKeCIks9eX24BtQKqr5NGY/kgM2tli3V8qCSv+Du zE1uJZXhRAfxcVg0l3X5tKoiAnfWEy3t4tQCK29k3aanfG19WfODKz4EfmywpXuS+KAr76yakQg 6xIZS8mD9cnGLQpKwhtc0ckATEH7EO2y/B6UR1QCz7PiyYsNkS0WW/tt4/6J+2vSIqEM4BaOkGz swX8z/Td0Ni6vbrCJluvlbn593AswlfkpwH4iGUrWSbYr+Vu/QqGE8PupCeQ3n0V03iWKa42FEZ yyhAx03Wa4Tr64lo1nkp6/1kF4lpJoOBT+yF3hsZTLHXK7PfUZ8A5twb6dYerZNi3syEFjTbE/o RpRTKERnm5dKYysidaZHAYtEqT1PsRGqalj6MzM5FrUWZIYWi6tDkwTE2vi+1Lgqx8Yi16ijjet vQYVOT7P1YE7SHuHytULBiyNWenlPKMR96DqiJxPu40U84mihfa5nM1s2f4h+FilZy+5QbYiJtH DuMSRHSfeBYqaJg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8369 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/packages.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/packages.rst b/documentation/dev-manual/packages.rst index 8bd48c8e8..a27c076c3 100644 --- a/documentation/dev-manual/packages.rst +++ b/documentation/dev-manual/packages.rst @@ -362,7 +362,7 @@ multiple times if you have more than one set of modules to package. For more examples that show how to use ``do_split_packages``, see the ``connman.inc`` file in the ``meta/recipes-connectivity/connman/`` -directory of the ``poky`` :ref:`source repository `. You can +directory of :term:`OpenEmbedded-Core (OE-Core)`. You can also find examples in ``meta/classes-recipe/kernel.bbclass``. Here is a reference that shows ``do_split_packages`` mandatory and @@ -543,7 +543,7 @@ to use. In your configuration, you use the variable to specify the format: #. Open the ``local.conf`` file inside your :term:`Build Directory` (e.g. - ``poky/build/conf/local.conf``). + ``project/build/conf/local.conf``). #. Select the desired package format as follows:: @@ -637,10 +637,10 @@ Lighttpd, or Nginx), take the appropriate steps to do so. From within the :term:`Build Directory` where you have built an image based on your packaging choice (i.e. the :term:`PACKAGE_CLASSES` setting), simply start -the server. The following example assumes a :term:`Build Directory` of ``poky/build`` +the server. The following example assumes a :term:`Build Directory` of ``project/build`` and a :term:`PACKAGE_CLASSES` setting of ":ref:`ref-classes-package_rpm`":: - $ cd poky/build/tmp/deploy/rpm + $ cd project/build/tmp/deploy/rpm $ python3 -m http.server Target Setup From patchwork Wed Dec 24 16:32:07 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77479 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 4A977E776FC for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123211.1766593938578705639 for ; Wed, 24 Dec 2025 08:32:18 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=HIJI/ceo; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id E119A4E41D8F for ; Wed, 24 Dec 2025 16:32:16 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id B7C9A6073D for ; Wed, 24 Dec 2025 16:32:16 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id F185310AB1374; Wed, 24 Dec 2025 17:32:15 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593936; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=kWIHDATJke9Nt1ELfsGrqORG16eOhr3tBHpWXY9OQOs=; b=HIJI/ceoahNmjQdAFO4KKF60acjetDHnNDklzNf6tizCO3e+GMsTyDq6IltQ3I6JwdSyrr kfoo617wDcq9te6TmRGdeUEeaMyqWSqZ8qwO64hRgwmmSqiwdytwHmkGrGgzxdk8r/zQ3B k/Yt/uZ2xGrxxm7JEeWt+R1ByN+N2qfQ8Z5W2zZO2PYJE8Jik042ve5WQ9NYEr60COI2tx eFy3N5MSDy/OPLoYn+ugV3sTYuI3Q+Z6uzzGiBicxn/wsUrfqQaBwGBn3V4Nyhm9QRpcpk f2UZDUxkhYiQfmg9UyGnxNmWLrn285TsrqjaKcK6co/H+u+gMtaNAwUgPlj+lQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:07 +0100 Subject: [PATCH 41/53] dev-manual/python-development-shell.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-41-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=893; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=1Hnz67XNcNyBn9pT8rZfqmSl6GHmXl5U7hQa97OuKyg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVuHR3do6ZHFngt7FUs8K7ClFYnsUnd01cbn fxNwqkDnseJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo Nr8HEADJV9KnvFp52bFJBpHZlehVCBcnOZ092BlJOekOeimR41U6Zb3v6w4ddKr08GrQBV/UVGy W3AAl+nISKPg3teR0NLtSz/vZx2AvQpC7F+Rc2YeH5sFN5/3QrN4Y8czRSRmFDxsqizpIQA6gJK PXKsf+0y9Xiw0oVFtkA2Mule0WqjjzipNkI0F+gweMLy+0q9dboiuODij6Lg6OzP2weGjzHwO4Z GkE46UqI/zOWDthnMsg4xU3JjdqgPP6tda8z7j2KOdpCxviqd2Hr3ZF0nBnMy4Ievavgjalm/KJ 2iceJl87ZtNj8Y23BAK6l2WBVK2QAhZP6Uq7dLrgGRQy8gYUXVufxUo5ZldEYdW8zdKFfYn65/w uPIIAIOlIaSXxbrSGD+DJUtm+A3/J0qO4KVnxY9l8XNJu9k910ZGFW+jY6pwWOrYXodmJFFTuFR z3E8ZelseQn31OJEdka64NW0oiRhgqdROMxdsRQOdGWEi3Pp6Q9pVAstEgxZjkGNefMka5Y2cAA N/vVkv/eMM9LE1ePy7OjcyYYI/GNE29Tq1JwvK6GfWo81OQa0pefFGG1tyrJy74mD0FfEbmda4c HK1Phb7lSrXQLxAt5khm20v1KhBi/JNmcIsGgMFaoLA2Q2e8gGaweOnPK/rnYTl4S01QnzwpclV sLGc/OlUzmfbAKw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8370 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/python-development-shell.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/python-development-shell.rst b/documentation/dev-manual/python-development-shell.rst index 81a5c43472..e03d2a6032 100644 --- a/documentation/dev-manual/python-development-shell.rst +++ b/documentation/dev-manual/python-development-shell.rst @@ -16,7 +16,7 @@ the following are useful when exploring the data store and running functions:: pydevshell> d.getVar("STAGING_DIR") - '/media/build1/poky/build/tmp/sysroots' + '/media/build1/project/build/tmp/sysroots' pydevshell> d.getVar("STAGING_DIR", False) '${TMPDIR}/sysroots' pydevshell> d.setVar("FOO", "bar") From patchwork Wed Dec 24 16:32:08 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77480 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 40003E776FD for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123212.1766593938944278309 for ; Wed, 24 Dec 2025 08:32:19 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=qJwtpfnc; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 607294E41D90 for ; Wed, 24 Dec 2025 16:32:17 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 34FE16073D for ; Wed, 24 Dec 2025 16:32:17 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9F13910AB1379; Wed, 24 Dec 2025 17:32:16 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593936; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=CrLdO16+ZlVWFx2yVL0Qq3Y5tGe8wVpIXmeVgaL28MA=; b=qJwtpfnc4i3nXiYc8TvIkxPahQBwUQoAyAgFNlY0hILl+PxhIhRQpY0XUh1KF8eET6fz0/ 3nrsu3hAkUTptpYPBqD29Y+NLGXPgD2kX5+rCkLjMbI1QBiJRuD08zGfhNyOfVAEr73n0+ Isx4HNAjkX1fBl5unX7W8Pycx3rnbtepRO40ExFsdJzvwE6DAeihdTP+plC1Ev13VWoR5I 05mwlIPquOTvVa6VuXct/baNtzUUsbCsh9OR9Q+Wwz5KHKtjNyuatfmyHpqFVcuV6LuRVn sYYfeA5ESwrB3d9uCsY6R4MJTFG3D60qVDdw349hPyF2u382qeMWBeOubnwGIQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:08 +0100 Subject: [PATCH 42/53] dev-manual/qemu.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-42-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1310; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=WamXF01pwAU1SpCueL5dT7JowofkF5ezglIbLsVqU1Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVuksZ8RmLYdYlIqC9lmI0nt2hlPBc5QHiIR 0tCaaRF2TeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo NlIoEACTZIPjXma6TTZhGEbKW6i1jXuAqNjF6E3kz18HYTsqSscN1ri1xGn4W5a8/uV1D1z9lzu Fwbkjt1x6PUIPWBJ/d46Awj5cWcogjblgHGyebLzi9uZL9GGYasQ0Z3MPTZXgeovznTTOncjDrI Qjb55/wwieAsJiqfihkPV5WxKBfpO+R7DcfWds4sli4SzYnovj16YK2S3WSrhm+wSJtYJeL36CQ fsbzQYpGowy5h+nMR7GfIDnH7mvghQqeUiFqNhVUn+pGLpl92KRzr34SDzvXmVS+umH8XgAVWF2 vgOeIInGQTnOHzaR7JQFRSQQ6+lANY79odO+FxvauBnQTkJIz5BRDvMNCIxkWAnO3icxKjaYTKV gPin5xc15q2GrsnzWdqvwUTmjEYz9Qyjp2AAX1FHmxfRt9y7LER5bAS3/CkH6ZY51r9AH/ZaI10 vkYzPW/DEGd+RFEITGlTJAP1wGqUVy8BA0Nsih/ZyqCUV5iqX4cfeGy+oO79oML5HBuQIm5J+ei 6MT75lQjBZNz9S6tbfg1NxBgzZr7TsfeIR4Scblk2dvZTPBikrBgya3b4a3uJwxgTjkuYF9me7R saeUKceEOcLENlRXrqNan3iRaIFGnllI7OPXB8VKg4xYHjK7zd5w4EvcYMvfCcPMguhEUa9PPjO w+D07aShxKqVwdg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8371 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/qemu.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/qemu.rst b/documentation/dev-manual/qemu.rst index 9e0b8b813..2442b6dac 100644 --- a/documentation/dev-manual/qemu.rst +++ b/documentation/dev-manual/qemu.rst @@ -53,12 +53,13 @@ available. Follow these general steps to run QEMU: #. *Setting Up the Environment:* How you set up the QEMU environment depends on how you installed QEMU: - - If you cloned the ``poky`` repository or you downloaded and - unpacked a Yocto Project release tarball, you can source the build - environment script (i.e. :ref:`structure-core-script`):: + - If you followed :doc:`/dev-manual/start`, use ``bitbake-setup`` or source + the environment setup script manually:: - $ cd poky - $ source oe-init-build-env + .. code-block:: console + + $ cd project + $ source layers/openembedded-core/oe-init-build-env - If you installed a cross-toolchain, you can run the script that initializes the toolchain. For example, the following commands run From patchwork Wed Dec 24 16:32:09 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77478 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 3631EE776FA for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123213.1766593940011212274 for ; Wed, 24 Dec 2025 08:32:20 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=vxYKn913; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 640E64E41D8E for ; Wed, 24 Dec 2025 16:32:18 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3BC016073D for ; Wed, 24 Dec 2025 16:32:18 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 35A1D10AB1366; Wed, 24 Dec 2025 17:32:17 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593937; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ivrJax4TGo4ppFCXX+he3VbZqsFjeqTwOAY0+TYYhKU=; b=vxYKn913OW2we24l0XFcTXZVzhaiJxjKEArHKxDLPm7jAfuqhrU97rmY5U23Gh+nKl5a3X jxQNpEArZ2144Id2V9nhdr2COmyYx7t/7m9MtcmWpDpziLaWPGRyUrnQrXjB3VJzK8qWGu e10c4FSp3MH3sA2ogq7PTty7xGyJ2OjFeKcTPjiHJCvEJ5WknsZu72v8gcxeGdtxu6MuRP AN+/4wL9Z/kdnEbs053nHsJ5RnxpVcYIR/SVWmLdfvNSee28aG10W06CzgxLUZDNJJtF/t i6Gc2WGXUuOhd6zR6MC0W9fzk6WDurnib56ZNPr0KSYF4oz+Zx3NNaz1QCp+pQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:09 +0100 Subject: [PATCH 43/53] dev-manual/upgrading-recipes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-43-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4893; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=sDplMkXp3EwNnka1++/SvKytpxiqpdyC6kFx3A9Vlss=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVuwd0+lqCXcBx9sdJz7X4wLLK5TbYkvrfGH KnLgwKi6gyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo Nkh1D/48RMd205ZgPjIl/NLHJzbiZf/z7n9G8gJ6FVNt7+RvzmuE7aDxQbpJy3vqdnrq6vsszPL N+cLAWNMukR6WqSl8Yl0yDv68hMsaCTGm4OYy0Sxxpqc60EuuaebxyM4xNi79XPUX71bM1JYbFq smjDI3rh3NCTcEyB8BAKEIjc82aE2OrhMLEzpTN41k9I2n50L9Yi25N2TYX0zrgfMFBmr24A7fU jQlG4oTja9dfaXIMg38WKlnMxulHswBu5Sq1qfcKTYlZnqtJ9dvk8dPBcld1U0si60C2DCNHkxx RlRkNxmqVAvjv0y3naWk3OyaafJb4NEBvlxcz9myrTQrbrc+cNQt3ipcRJYekMKUsH0rcwaDOan LpzOJz+t2VfFhf1qk4SfTJV1M22iqlRKeroLppbNTdYXlequPqpftdoPgYeWQR+b2F23WFvWDrO EWcOL25O07xUey0g75Etx+zETv7h418VyMoOYeqoHjZlsYqt52h88cfnSZVljM4cCxqcPWX/ULV QGCKAqlu4dVf4kFxR6ipCpUdg8kNBttnQVoU/hdJrKS/McIS7qKl9YWhxfs9fzrR3pTuKvKNTzG 4cwnc5dAIf4wiYFmetr9ArNL17QoUFGVjN+cs+3Hxam20s+KNJ9NALw3Xplr+ks4C3z1luO20vk kOMtqYx0QW+RZFw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8372 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/dev-manual/upgrading-recipes.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/dev-manual/upgrading-recipes.rst b/documentation/dev-manual/upgrading-recipes.rst index 2e6567867..f86f515f7 100644 --- a/documentation/dev-manual/upgrading-recipes.rst +++ b/documentation/dev-manual/upgrading-recipes.rst @@ -84,12 +84,12 @@ The following steps describe how to set up the AUH utility: AUH is not part of the :term:`OpenEmbedded-Core (OE-Core)` or :term:`Poky` repositories. -#. *Create a Dedicated Build Directory:* Run the :ref:`structure-core-script` +#. *Create a Dedicated Build Directory:* Create a new :term:`bitbake:Setup` with + ``bitbake-setup`` or manually run the :ref:`structure-core-script` script to create a fresh :term:`Build Directory` that you use exclusively for running the AUH utility:: - $ cd poky - $ source oe-init-build-env your_AUH_build_directory + $ source layers/openembedded-core/oe-init-build-env your_AUH_build_directory Re-using an existing :term:`Build Directory` and its configurations is not recommended as existing settings could cause AUH to fail or behave @@ -121,7 +121,7 @@ The following steps describe how to set up the AUH utility: .. note:: - If your distro does not enable by default ptest, which Poky + If your distro does not enable by default ptest, which :term:`Poky` does, you need the following in your ``local.conf`` file:: DISTRO_FEATURES:append = " ptest" @@ -143,7 +143,7 @@ The following steps describe how to set up the AUH utility: described earlier, you must enable it in ``upgrade-helper.conf``. Also, if you are using the default ``maintainers.inc`` file supplied - with Poky and located in ``meta-yocto`` and you do not set a + in :term:`OpenEmbedded-Core (OE-Core)` and you do not set a "maintainers_whitelist" or "global_maintainer_override" in the ``upgrade-helper.conf`` configuration, and you specify "-e all" on the AUH command-line, the utility automatically sends out emails to @@ -263,7 +263,7 @@ directory automatically upgrades the recipe for you:: $ devtool upgrade nano -V 2.9.3 NOTE: Starting bitbake server... - NOTE: Creating workspace layer in /home/scottrif/poky/build/workspace + NOTE: Creating workspace layer in /home/scottrif/project/build/workspace Parsing recipes: 100% |##########################################| Time: 0:00:46 Parsing of 1431 .bb files complete (0 cached, 1431 parsed). 2040 targets, 56 skipped, 0 masked, 0 errors. NOTE: Extracting current version source... @@ -275,8 +275,8 @@ directory automatically upgrades the recipe for you:: NOTE: Executing RunQueue Tasks NOTE: Tasks Summary: Attempted 74 tasks of which 72 didn't need to be rerun and all succeeded. Adding changed files: 100% |#####################################| Time: 0:00:00 - NOTE: Upgraded source extracted to /home/scottrif/poky/build/workspace/sources/nano - NOTE: New recipe is /home/scottrif/poky/build/workspace/recipes/nano/nano_2.9.3.bb + NOTE: Upgraded source extracted to /home/scottrif/project/build/workspace/sources/nano + NOTE: New recipe is /home/scottrif/project/build/workspace/recipes/nano/nano_2.9.3.bb .. note:: @@ -298,7 +298,7 @@ newly upgraded recipe:: . NOTE: Executing SetScene Tasks NOTE: Executing RunQueue Tasks - NOTE: nano: compiling from external source tree /home/scottrif/poky/build/workspace/sources/nano + NOTE: nano: compiling from external source tree /home/scottrif/project/build/workspace/sources/nano NOTE: Tasks Summary: Attempted 520 tasks of which 304 didn't need to be rerun and all succeeded. Within the ``devtool upgrade`` workflow, you can @@ -320,8 +320,8 @@ directory:: NOTE: Adding new patch 0001-nano.bb-Stuff-I-changed-when-upgrading-nano.bb.patch NOTE: Updating recipe nano_2.9.3.bb NOTE: Removing file /home/scottrif/meta-openembedded/meta-oe/recipes-support/nano/nano_2.7.4.bb - NOTE: Moving recipe file to /home/scottrif/meta-openembedded/meta-oe/recipes-support/nano - NOTE: Leaving source tree /home/scottrif/poky/build/workspace/sources/nano as-is; if you no longer need it then please delete it manually + NOTE: Moving recipe file to /home/scottrif/layers/meta-openembedded/meta-oe/recipes-support/nano + NOTE: Leaving source tree /home/scottrif/project/build/workspace/sources/nano as-is; if you no longer need it then please delete it manually Using the ``devtool finish`` command cleans up the workspace and creates a patch From patchwork Wed Dec 24 16:32:10 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77474 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 27F93E776F8 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123214.1766593940626305063 for ; Wed, 24 Dec 2025 08:32:21 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=YGUfw3qt; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 1D8C84E41D8F for ; Wed, 24 Dec 2025 16:32:19 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E8A396073D for ; Wed, 24 Dec 2025 16:32:18 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 3A85110AB137B; Wed, 24 Dec 2025 17:32:18 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593938; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=fetN6nSR+EXGCAVpSDdXqx6sakAT6hejOKHguroSrGg=; b=YGUfw3qtBcDa9QTMEh/oyrD5fBSQck/P7P93ElcTgwaRQnFPgdczXdMjvFo3EDzi2u8GHg wc9Pb4Eu7qC2mRXDCsjt9Nbdx2RG1RvWLc3AsYlkoXM2PEpZN7deWwAzGWh8EIcbj6A0BQ j4GhHaLGNiHhAYB6fD4UubLUaPvXMHM96UweArt9ownM6+8ddvCeXunn43WDWhiA6wHzME Myvrjwpc/RBYJntLymZuEMA9grm8GaP49vTAEoow3VnGb7Q48tMw54RlFu4psynLibw7vC 2smu7SSBRBeFjCWwmIEckmtdHyiSzv6PTtYvybEzHpSiso8VvBuMDcAefeYYhg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:10 +0100 Subject: [PATCH 44/53] dev-manual/vulnerabilities.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-44-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4454; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=axMkZ/RIWW00HYRkvttZEweYrQJQJ2YYVciiilSrkgI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVujaR2jxPFhuw9VLEf8euczM17pfonVstly o9MlkPWRuiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbgAKCRDRgEFAKaOo NnY0D/4+An8qTViC7V7DpFgEKWOwNzrN4O3GOEe/M27HVmou+5M/IpjEX/kKPQbFpRAjnfeJ3DW +coRLqc0SA2//fvSBm36p0pJQjxjMrgSgOUvjuT1Jkx2PCYLm9w0SohaiwyZuyVlNOAXjBMEj0K Zgi98PyHIXJRSbUNN0SOfPCF7YsM28f9qJ4FRhuOo3BzQ7SxHgHoLyycKTaFat12CWtmnFz8GVG v+AxtJFIcldqdIsJszuoHi6/m/zDFheAbnWcNq2eIioxVyCJxMY88lT/72532Kb9GijPkKVzy5a MlCsW2Tov1eo7J7q+L6jsmNdc69ef7pFARamfL8lbs1EmMsYApYF34GZ3lHwQ8K2+auN/YyAap/ hqUnyyvW+7tN1Pbp+nzsanEDax5cW9vKGN/Pk8XS89bPcUGmk4rbl0R1My8NSahMVCNBAhS8McW 4Ny9BrJmbduiLcksKUYxofO7iLxTc5VBN9wBFFLwPjM+55MmeLap/4SQhxBpN+3Z5xesN4kfTkl bmuPDomYATp0EBq3hteIgV84m8rXlJPWOHxglYmZCmd8H/tN5GZ8RoFS+meTG4wOKo0ibmx5gjb NtZ98IcJe2grTWqvlEXv/T65FktR/fkv09KO4j+ybocw7SEwNc8rUscWmYf0nt4RV8kp1z6mulS W1VRluPsgFTNM4w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8373 Refresh the document now that the Poky repository is obsolete. Mention that only vulnerabilities in OpenEmbedded-Core are tracked as that's where the packages are. Signed-off-by: Antonin Godard --- documentation/dev-manual/vulnerabilities.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/dev-manual/vulnerabilities.rst b/documentation/dev-manual/vulnerabilities.rst index 6eaf75758..e6135a525 100644 --- a/documentation/dev-manual/vulnerabilities.rst +++ b/documentation/dev-manual/vulnerabilities.rst @@ -3,8 +3,8 @@ Checking for Vulnerabilities **************************** -Vulnerabilities in Poky and OE-Core -=================================== +Vulnerabilities in OpenEmbedded-Core (OE-Core) +============================================== The Yocto Project has an infrastructure to track and address unfixed known security vulnerabilities, as tracked by the public @@ -13,15 +13,15 @@ database. The Yocto Project maintains a `list of known vulnerabilities `__ -for packages in Poky and OE-Core, tracking the evolution of the number of +for packages in :term:`OpenEmbedded-Core (OE-Core)`, tracking the evolution of the number of unpatched CVEs and the status of patches. Such information is available for the current development version and for each supported release. Security is a process, not a product, and thus at any time, a number of security -issues may be impacting Poky and OE-Core. It is up to the maintainers, users, +issues may be impacting :term:`OpenEmbedded-Core (OE-Core)`. It is up to the maintainers, users, contributors and anyone interested in the issues to investigate and possibly fix them by updating software components to newer versions or by applying patches to address them. -It is recommended to work with Poky and OE-Core upstream maintainers and submit +It is recommended to work with :term:`OpenEmbedded-Core (OE-Core)` upstream maintainers and submit patches to fix them, see ":doc:`/contributor-guide/submit-changes`" for details. Vulnerability check at build time @@ -34,7 +34,7 @@ add the following setting to your configuration:: INHERIT += "cve-check" The CVE database contains some old incomplete entries which have been -deemed not to impact Poky or OE-Core. These CVE entries can be excluded from the +deemed not to impact :term:`OpenEmbedded-Core (OE-Core)`. These CVE entries can be excluded from the check using build configuration:: include conf/distro/include/cve-extra-exclusions.inc @@ -167,7 +167,7 @@ the :term:`CVE_VERSION` variable. Note that if the CVE entries in the NVD database contain bugs or have missing or incomplete information, it is recommended to fix the information there directly instead of working -around the issues possibly for a long time in Poky and OE-Core side recipes. Feedback to +around the issues possibly for a long time in :term:`OpenEmbedded-Core (OE-Core)` side recipes. Feedback to NVD about CVE entries can be provided through the `NVD contact form `__. Fixing vulnerabilities in recipes @@ -175,7 +175,7 @@ Fixing vulnerabilities in recipes Suppose a CVE security issue impacts a software component. In that case, it can be fixed by updating to a newer version, by applying a patch, or by marking it -as patched via :term:`CVE_STATUS` variable flag. For Poky and OE-Core master +as patched via :term:`CVE_STATUS` variable flag. For OE-Core master branches, updating to a more recent software component release with fixes is the best option, but patches can be applied if releases are not yet available. @@ -276,8 +276,8 @@ The entry should have the format like:: CVE_STATUS[CVE-2016-10642] = "cpe-incorrect: This is specific to the npm package that installs cmake, so isn't relevant to OpenEmbedded" As mentioned previously, if data in the CVE database is wrong, it is recommended -to fix those issues in the CVE database (NVD in the case of OE-core and Poky) -directly. +to fix those issues in the CVE database (NVD in the case of +:term:`OpenEmbedded-Core (OE-Core)`) directly. Note that if there are many CVEs with the same status and reason, those can be shared by using the :term:`CVE_STATUS_GROUPS` variable. From patchwork Wed Dec 24 16:32:11 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77477 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 1ED95E776F5 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123741.1766593941262908475 for ; Wed, 24 Dec 2025 08:32:21 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=oopedrWp; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id BB3514E41D90 for ; Wed, 24 Dec 2025 16:32:19 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8E56E6073D for ; Wed, 24 Dec 2025 16:32:19 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D2EF010AB1375; Wed, 24 Dec 2025 17:32:18 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593939; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=8Y3pXgqgK2JNGP2rnsQcOlAzBDhMCho05PbyZ0r6bjs=; b=oopedrWpK0uzBSVYhL2VnTGxTu0ROnQ7R5theZmZTo8YhaBf+tP0eR+LK0XYmHipx4uHMd isSB+5y9kycjIkRxNl3ATwCh0t2Z08xcQD3JF74TPo1W+sH6C/JVgKY72Ax3kQ/iVxesn1 tsVJyZ7ukarDMW6HuRxab9zvQ6J5QDy4kElwOPLyZ4k70wATi548wZimym7yCB5s0HCPr0 O+zznJ7Ag1K86HUojnmBQI2mdGDzrP4aEt5mPBXbJoEgS1eXXMsY1JM251mu39t3UPP9Ph Cnk1p44gbWpE/wsdrbpweNMjRMBIFM2sHJJrx+nBxh5h6jgUsFce15kJWBbZNA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:11 +0100 Subject: [PATCH 45/53] ref-manual/devtool-reference.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-45-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2651; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=HypVyfUQTsdfrr6PYUszF0J/+gwlzUcMUVliVCg3Cdw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVv4aNmkqpM2Kiq4GpRXZLBfMG8a18JALagB 4J34tL0stiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbwAKCRDRgEFAKaOo Nr0CEACXMhRo1WGXv7dLeT2Fu0/Nh51bILqmFa5FRJEKtOQndXb5AUokDVmCooEGUD4jpSDzqVe IEXokqA6TlCh/WLpk/fc1Nu+sRVttgwembjBQuifRBvyNMoJDzB+urRqEt0orU9srdpDBu6xTD6 T5z59Yykbrkk8Fho+qPFmG6i0fdaY7GpU75GM74uU7FCHVwFmJT6mYVRChUgGIX8pyG5pPTiwWA I7LdXelFDzRVXL1BZX3vTKL83FlmQRhQ0/njRn/7+ch1PQURmDLgBzkYI67eqrO7lulHap2ipXI slOFohy0QeNjkdx6BARBizFuc5IB3csjhJ8Sxv7zWn6rei+R8/YJY7T6CEAhCuyMJ9w/gmz5tdD ifyh1XhSnnwPBr6m9wQCkX0VOWK224wklg2bTKzhl1YDBXa+peBXWe2ZhrCjFC83wHTCKpkJGYJ pFxQ58AXHR1kxe2dsyWkPU0Br64UwRraJIxiUgC/5dAGffueXeMiDajCQM/HiiVGDh1MsOvCxgh 9EJPNH18sjpnvc9uHSACVrcIUhH2aw/xhHwgXGbBP1r8iOmM6m6HEQ64t50bb0mrNhH6YPDEp0j Rc2SNLDx7tVg4rkbakS3DCgbpki/nnVEcPPRq+op5uwjvlsdLbkDGrxU4sIUinm+shTVXCseaV6 +ddM5xupvzBJifg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8374 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/ref-manual/devtool-reference.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/ref-manual/devtool-reference.rst b/documentation/ref-manual/devtool-reference.rst index 5ac567591..69288744a 100644 --- a/documentation/ref-manual/devtool-reference.rst +++ b/documentation/ref-manual/devtool-reference.rst @@ -346,7 +346,7 @@ variables in package recipes. mechanisms cannot find the new upstream versions. - For the ``oe-core`` layer, recipe maintainers come from the - :yocto_git:`maintainers.inc ` + :oe_git:`maintainers.inc ` file. - If the recipe is using the :ref:`bitbake-user-manual/bitbake-user-manual-fetching:git fetcher (\`\`git://\`\`)` @@ -390,7 +390,7 @@ In this example, while a new version is available upstream, you do not want to use it because the dependency on ``cdebconf`` is not easily satisfied. Maintainers can explicit the reason that is shown by adding the :term:`RECIPE_NO_UPDATE_REASON` variable to the corresponding recipe. -See :yocto_git:`base-passwd.bb ` +See :oe_git:`base-passwd.bb ` for an example:: RECIPE_NO_UPDATE_REASON = "Version 3.5.38 requires cdebconf for update-passwd utility" @@ -460,7 +460,7 @@ Here is an example that resets the workspace directory that contains the $ devtool reset mtr NOTE: Cleaning sysroot for recipe mtr... - NOTE: Leaving source tree /home/scottrif/poky/build/workspace/sources/mtr as-is; if you no longer need it then please delete it manually + NOTE: Leaving source tree /home/scottrif/project/build/workspace/sources/mtr as-is; if you no longer need it then please delete it manually $ .. _devtool-finish-working-on-a-recipe: @@ -633,7 +633,7 @@ Here is sample output after using to create and add the ``mtr_0.86.bb`` recipe to the ``workspace`` directory:: $ devtool status - mtr:/home/scottrif/poky/build/workspace/sources/mtr (/home/scottrif/poky/build/workspace/recipes/mtr/mtr_0.86.bb) + mtr:/home/scottrif/project/build/workspace/sources/mtr (/home/scottrif/project/build/workspace/recipes/mtr/mtr_0.86.bb) $ .. _devtool-search-for-available-target-recipes: From patchwork Wed Dec 24 16:32:12 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77473 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 177A1E776F0 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123215.1766593942110174214 for ; Wed, 24 Dec 2025 08:32:22 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=kiQLdx9f; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 8BD934E41D91 for ; Wed, 24 Dec 2025 16:32:20 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 63ACF6073D for ; Wed, 24 Dec 2025 16:32:20 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7432D10AB137D; Wed, 24 Dec 2025 17:32:19 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593940; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=y7CA3V7uznE+fphFZ+WLkpoaTi/BmIfw9byjefTreg0=; b=kiQLdx9fqJU1DFRGjMcrsa15aa2EnViwAql2ANrRTXZ6N3x6PKXp6MB7HEAx40XLHZN3Px lnpKEQqRubc79P/YrNCYoPCvGhHrx2Dsdd1Ey621TfgpZifxXamK9OpBEaaC4IUaFBfDOr XMscSidH676mrCqR4S+BwhEfyqRqREQpyaBJvg3LSoKY6LmH4RXqPJd17iK+H2EpuDwpm7 qegPG+cnJybqPBh2nXmHtzrWfN07/da45Zq4eT+jZOX1MTEZenj7oILmmb42FHtoXuUmiT 9hgouqigW95tcmF/MIruCgzT0vRnZNVM7oN072GUdR0JM9/iye6+FigQruzgPA== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:12 +0100 Subject: [PATCH 46/53] ref-manual/faq.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-46-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3877; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=lrsV/HgK4Z6z9JNo9fzZOF9sPtr2fn5IUsAmiEO8e10=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVv43ZtQouLvT8fTiUFtTrrQnqGC/y1ELjwH LsbmRr6iRiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbwAKCRDRgEFAKaOo NrapD/94LlTlvhxz7NilMy3Uafo6efZ647mQ1hQZEWaLDeuUX/2jg0KQKarC4H5g6suI1IF2yTP GAC50zxhYd92tPF3bprqJPGlb9uEZ3DMHuSMHSGVEOT4uJhcfhq981rIPAVpg5dJzbTIqbWzYw4 L7NqRcPJQEDCZqiMbL1kOttzT9HYM/RLP/Ya161tjQqMZtayK1X67YDAlIMSOot+Iwu6r785S61 bBrsRoRCNzufuZCCKbjJu7Ep2s5TNPLbwCwIkI1iy3Ydm2h//Yj59dkwubBgr/MW1zAD8/lxxfW e28CMECfzlWlttLBMIM2zotWPKSoRpNZ9tvLE2Yv3+PH9uji49jzD47xSe5vycj6y6jbBIAeaCm dx0EyFNH/svdrw4O2h26/hIV1oaBQm/QBDcussInpR2iGJIUaJU6RiSmgr0udLCzB/nA1ds4OoJ 1mDRQuPkHALnuphMY7kgQ626n4b2LKlGAklkNf1E2CxA4ENgiF/+aTTNK3fqePa4i/yYDgY9TNc BOOkskNh6JCLqYYG4CGM1OJMbeoV7LakisE8sBf+fncAvGbfxfDsVGeMG06TMAOXFMVstR9dSge lcM2WiBZ+na+3Tp/Z6twJwi71t+FmxXEy+tJp+lJWeqHMuONNjDdusqioN48vaOmc/uYzGgUbFY SRswi8IA6LPizZg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8375 Refresh the document now that the Poky repository is obsolete. Rework the difference between Poky and OpenEmbedded. Copy the note from terms.rst regarding the now obsolete Poky repository. Signed-off-by: Antonin Godard --- documentation/ref-manual/faq.rst | 43 ++++++++++++++++++++++++++++++---------- 1 file changed, 32 insertions(+), 11 deletions(-) diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst index 406b2c388..cd4801baa 100644 --- a/documentation/ref-manual/faq.rst +++ b/documentation/ref-manual/faq.rst @@ -12,14 +12,35 @@ General questions How does Poky differ from OpenEmbedded? --------------------------------------- -The term ``Poky`` refers to the specific reference build -system that the Yocto Project provides. Poky is based on -:term:`OpenEmbedded-Core (OE-Core)` and :term:`BitBake`. Thus, the -generic term used here for the build system is the "OpenEmbedded build -system." Development in the Yocto Project using Poky is closely tied to -OpenEmbedded, with changes always being merged to OE-Core or BitBake -first before being pulled back into Poky. This practice benefits both -projects immediately. +The term :term:`Poky` refers to the reference distribution that the Yocto +Project provides, and a reference test configuration. + +The :term:`Poky` distribution is built using the :term:`OpenEmbedded Build +System` and :term:`BitBake`. The :term:`metadata` used involved to build the +:term:`Poky` reference distribution is: + +- :term:`OpenEmbedded-Core (OE-Core)`, which is hosted at + :oe_git:`/openembedded-core`. + +- :yocto_git:`meta-poky `, which defines the + ``poky`` distro configuration file (:term:`DISTRO`). + +.. note:: + + Poky also used to be a repository containing the combination of + :term:`BitBake`, :term:`OpenEmbedded-Core (OE-Core)`, the + :yocto_git:`meta-yocto ` repository and the Yocto Project + documentation -- which were combined with the :yocto_git:`combo-layer + ` tool. + + This repository is still hosted at :yocto_git:`/poky` and is still + updated for maintained releases that are older than Whinlatter (5.3). + Newer releases now use ``bitbake-setup`` to clone and setup the initial + :term:`OpenEmbedded Build System` environment. For more information on + how to use ``bitbake-setup``, see the :doc:`/brief-yoctoprojectqs/index` + document. An alternative can be to setup the above repositories + manually, by following the :doc:`/dev-manual/poky-manual-setup` + section of the Yocto Project Development Tasks Manual. How can you claim Poky / OpenEmbedded-Core is stable? ----------------------------------------------------- @@ -27,7 +48,7 @@ How can you claim Poky / OpenEmbedded-Core is stable? There are three areas that help with stability; - The Yocto Project team keeps :term:`OpenEmbedded-Core (OE-Core)` small and - focused, containing around 830 recipes as opposed to the thousands + focused, containing around a thousand recipes as opposed to the thousands available in other OpenEmbedded community layers. Keeping it small makes it easy to test and maintain. @@ -87,8 +108,8 @@ configurable. You can setup the build system to get source code in most environments if HTTP transport is available. When the build system searches for source code, it first tries the local -download directory. If that location fails, Poky tries -:term:`PREMIRRORS`, the upstream source, and then +download directory. If that location fails, the :term:`OpenEmbedded Build +System` tries :term:`PREMIRRORS`, the upstream source, and then :term:`MIRRORS` in that order. Assuming your distribution is "poky", the OpenEmbedded build system uses From patchwork Wed Dec 24 16:32:13 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77476 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 11524E776EA for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123742.1766593942632902171 for ; Wed, 24 Dec 2025 08:32:22 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=L0bYjBWw; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 1D93C4E41D8E for ; Wed, 24 Dec 2025 16:32:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E98AA6073D for ; Wed, 24 Dec 2025 16:32:20 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6088C10AB1377; Wed, 24 Dec 2025 17:32:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593940; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=a04Tfue2Xvmq0JNgEzmm1iAsBMgHcNowRjo8vrqjLsQ=; b=L0bYjBWwBzU/Xx1IITr5KKwNcRcp2q5/r7QE+RcFoQhhgdTT7xG+kD8rHzTI57kD/7XT1A EqXnLD+kTOAjwy8D32/F2beGG+2r9Vi3953Fp8tPPRYCo1B+bpw5N0w5wp+HDaVZidzt0n Olh5hEnh53+wd7UksRv2L/kF7odeKel24CHjxKU+w8CFedHfYDrMifc8hnv1QmXLeM8rdJ 32G3s3/Vkaats7oMoggFjL76lDXXLwgxB0FqSHg5sRke869Dv7G4+mQlTrkDaW1ShHO4BX H1F2vkXiI1DsZ1TmGLFfCqi+T4akdLWDF6EF+dnhGP9uorof22pjGtFCRwAThw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:13 +0100 Subject: [PATCH 47/53] ref-manual/features.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-47-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=766; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=tk69mRejmnYqmjmImzWP9Z8jwxVIEeZZkWqVFiLiveg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVvNmVOGu2hmKFVA/FFnFPmFbm3aaHHND3KJ MUpdDHW3DWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbwAKCRDRgEFAKaOo NqbQD/4xEmNdTSr+doz3/XVxU6vcLJtQPVzD++spwE8tzb+JQTABBYR8AY3F+IdnZUJNb7lyR+W S0ZvkxREd42EpRtxOlzv0NmHgQqR56tYsPoeEXIDSUGbL6VfWobNY8QM4BfBLQY9w8fG4id3kPD TMUdzrsjEfm2VRkjD7K2d8Fdve/7jAFcU9ewiEpp5cx+ODqV4lBBz2WrGIxKCeS6xiZTRsJqrmo t0L4CN3GRmYDGpCCEzKjL/u4fLZ/igPT73GFbRmEp1FypykKPTjhqnszc/15CtexvqjUKeN9rE0 U6fRc1hxPTneq7SDjp0CZQINxUkpkh9Hj4MSEIDs0heh1R6PV/H879FqEX+aW0Flm2uBLIV9nDO sAgL5Oir1kgPi+ckCamVatkxWYLPKTSqMuJfMN576rvGWHifqM1KgcZK0b/COTLB3LdAvkuHZUY YqkKOlMIr/ieMjqgcu29noFtqLai+bWFEvDg8kx0jjeTjbcRTsO2vVBPOZ6W9xyyxJcUCAFI+ZN 6pQ3xZPCimW07jpujNJTbkPWUVski8P/J0QvBKNdaAc4jPhlCZ+gFvcXvZthsAJSuBep6PXoZT+ AWvw9zUWXrGhYGvqRkNIAlKOVt83dviWV6SBRWg/h4ZGIiiJLiWFeH6VSCja74qdPUApU8MBj64 VkQOXy4lBmxVoMw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8376 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/ref-manual/features.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/ref-manual/features.rst b/documentation/ref-manual/features.rst index 40651a4c9..d59c53b0f 100644 --- a/documentation/ref-manual/features.rst +++ b/documentation/ref-manual/features.rst @@ -28,7 +28,7 @@ a particular feature is contained or not is to ``grep`` through the discovers the recipes whose build is potentially changed based on a given feature:: - $ cd poky + $ cd openembedded-core $ git grep 'contains.*MACHINE_FEATURES.*feature' .. _ref-features-machine: From patchwork Wed Dec 24 16:32:14 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77472 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 0A0D4E776E0 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123743.1766593943296070182 for ; Wed, 24 Dec 2025 08:32:23 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=qoGTLb81; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id C52754E41D8F for ; Wed, 24 Dec 2025 16:32:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 968E46073D for ; Wed, 24 Dec 2025 16:32:21 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id DD55410AB137A; Wed, 24 Dec 2025 17:32:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593941; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=SUfp+NmCxe7v5jgZfmb0TgQgksv/FMEq4y4YvwoIsYg=; b=qoGTLb81KxblE3hm+iDDCRKGBiyMBrkTVMGajv7EMJOActnI3S7fcqkqbBjftbyPGwynas nFtSLz8Ikfna9FuY83mr4H4qluC3PmJDRrkUM3rXVLvzCUfbStobqzIbhFItLqZdYFMGce EnKxFr1at0yYpE1Ad4kq/qsegULV7aEof/ux4izWtT3b/Z9EnNAHv62Sq+MqlKvKwVXNP7 mTGqcfKymt7Jgu3DaYQi7uiT7vfNv/6p+GNKokLv1zanXrtRunIrYrqt+Lgr8afON9Cbao zr1DYWm7GYHf+qp5n+m2KkTTRoROmionp8akDpjnZ/y63UBGS3dANRgjCvt4/A== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:14 +0100 Subject: [PATCH 48/53] ref-manual/release-process.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-48-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1292; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=H+Ntvzf3Vi7OfOF5h8PanRpQYwdzRLL6iQDwArbbJEs=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVv/071CofPHa7YTvUkz/n7+nMspA8TyVrsi dL3N3/imoSJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbwAKCRDRgEFAKaOo NlmED/90GdCbfGFk8jwk1Nr82QI2LBO44mn54anQrg7tZKJ5ggubbt0txp3pZg4Xo+j/215y8Qb jV1dN+rk0tyMH//aBSpjNDLnwmlXyk6Czbq18JYEuMp5VzRkOJOZrkKwtYRspEMm/M3pQ13uCfO XZeBqugAjInnTXDDINTfobINKl4goOHuUAVAIq2anew2seV0XMngu9LReVaqG/oQHiWYA5GHwSq G0HsyjJkPvYE7SJtIJd/kTkvpEFCxw06rF9bvKX0+L9LequJYvisE8x7hA8HbOYkKr4vDmPh2TU Qt0hfnKFca3/l9cRSpxcZydoTtMXvHzoteCVTiAcpowm6v6efZ4LtmhQq/NHQKU3WTKUG3YL17/ GnqnnsX1F2zXDICskyIThAN3PmlcZfIRifcWUnsz10Yd0pfRpd6armyLg/kZZ8eau5Mhl86AQ0I TlOYd2HNqIJckfzbujt6leZgFiWdo5u8SG0mk+W7RwUVis6yxTKSa+r6TzlEohoGE6W+AfjhoDQ +8fQHfTDeL8jblazdJtocJesr32H4ACZG+Reqm4oyCK0A+/hDKskH5bnctETaL0vP3/HW0+0JZM aMPDUnhjcrvfi+UyAEtBuq/r6CUNIAo/sNSxfAPZfLJ5BXl4LmvT8NKCmxePthW/E5KsubHFlw/ t+TQNaamB/7F5fw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8377 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/ref-manual/release-process.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst index 826354844..7b428efad 100644 --- a/documentation/ref-manual/release-process.rst +++ b/documentation/ref-manual/release-process.rst @@ -193,10 +193,12 @@ efficiently. The Yocto Project's main :yocto_ab:`Autobuilder <>` publicly tests each Yocto Project release's code in the :oe_git:`openembedded-core `, -:yocto_git:`poky ` and :oe_git:`bitbake ` repositories. The +:yocto_git:`meta-yocto ` and :oe_git:`bitbake ` repositories. The testing occurs for both the current state of the "master" branch and also for submitted patches. Testing for submitted patches usually occurs in the -in the "master-next" branch in the :yocto_git:`poky ` repository. +in the "master-next" branch in the :oe_git:`openembedded-core +`, :yocto_git:`meta-yocto ` and +:oe_git:`bitbake ` repository. .. note:: From patchwork Wed Dec 24 16:32:15 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77485 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 7F2CDE78488 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123745.1766593943925703645 for ; Wed, 24 Dec 2025 08:32:24 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=xe5JFyGc; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 674304E41D90 for ; Wed, 24 Dec 2025 16:32:22 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3DBA26073D for ; Wed, 24 Dec 2025 16:32:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9946B10AB1384; Wed, 24 Dec 2025 17:32:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593941; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=gyNqx1JRkMKL0mkrm3lb2dFCBrEO8orMqmdPDd0ZUCg=; b=xe5JFyGclvRaGZH40+tj57Dd5x9ZS2UhY4Wb7K6u5+WMAJ3M/rYGXbmojeX6m0QYgBH/q7 HwnGZTMJgzSQk+09oO62S5eoqR0mNlEBPic8sYTaCrhVmei5rR3DHk6Vx7Cx9go8Rx1WZn 2Tpo8WT7gI/qd7del/cJm8dscd/jFOlZye6GPuVDyzO7QbvLrUrurdmrMj9cLxwbKmjYMh EP8+cklBAuTyJynhp6DmLcPoVNJWEPwnk/Vk+6EOaplOkgh39a6Chk80+0Teml02hBw4vo zD23RLabsSkQN1EbaAgFiH3nU9PAVuwy6bt/XZ7hBsSIa7oP0frxY0pH/IMW0A== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:15 +0100 Subject: [PATCH 49/53] ref-manual/system-requirements.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-49-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2257; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=wweFFD6YCicxokDpT0Wh6UYsTmj6vQrmP0Ud7axlHpw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVvLgPxLGEGAAujLxfYWaR/lxaZ44guCAn06 MILsr6f7TOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVbwAKCRDRgEFAKaOo NogtEACoJbGPT2kgck1rcYHkg1aun5JA7QpmJXBORol27Y8O6M1rYjLqbCtAtux+TiPFQWXr0OP hRaTM1kPe4jHInzYOnEOgJxMf+1i0uHBpWmq+fACzDwinv/f1yN3jk3BUWAPB3b0pAzi3hBc/Fu CxG3BEb/vWsDqPf6yJIQUo52Nmx6mFGcJq47aoCXODIj9/e8NwD3h3wFlNugkNZfYOXCjYwQYrv 62Qh9gCq9xoAB5E4mO2XkjF0gQ0al331XWoPNbbRxLUrf53eR5Pc7uNxF4MYyFqdAlSIDqGNTDg bdt2hHdKaPSfZ25qaQSykYQZznSZZbYF0M1dqtLJIZJCbXWEMKdhw0LvbiOKIrCAc15NM0BOBS+ MoyT1WJdMXEe5EJDzjC4XxjmtA7TUBD1/xvNi356ZpGXBcGaRpTCpmxwLM5iawV7/3MhD6BVJga xQWOElcutkd4e2LhhIT1Z4H3J/1Kj8SSMqWwO7sHGaAI33qRvJcQIr+xgqxHUOMwnPBq3PhaQHc BvfLz7WZjeJzFOO48p/68o1F+RnF3Lud0KSjukCTUwsJMyP/1U4JlVly44RVEte/gV4iMAwOY3Y ustXo9xHrC/hCOSuMx8K1oX1+Ia+T0nFhNYfYI0wUqfXjUJ+kEp0ng1icHhILkCqOr1amD4VVNr X3QO20cvX27rndQ== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8378 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/ref-manual/system-requirements.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index a56e683ca..e8d6830b1 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -405,8 +405,8 @@ installer and automatically installs the tools for you: #. Execute the ``install-buildtools`` script. Here is an example:: - $ cd poky - $ scripts/install-buildtools \ + $ cd /path/to/project + $ ./layers/openembedded-core/scripts/install-buildtools \ --without-extended-buildtools \ --base-url &YOCTO_DL_URL;/releases/yocto \ --release yocto-&DISTRO; \ @@ -420,26 +420,26 @@ installer and automatically installs the tools for you: To avoid the need of ``sudo`` privileges, the ``install-buildtools`` script will by default tell the installer to install in:: - /path/to/poky/buildtools + /path/to/project/buildtools If your host development system needs the additional tools provided in the :term:`buildtools-extended` tarball, you can instead execute the ``install-buildtools`` script with the default parameters:: - $ cd poky + $ cd /path/to/project $ scripts/install-buildtools Alternatively if your host development system has a broken ``make`` version such that you only need a known good version of ``make``, you can use the ``--make-only`` option:: - $ cd poky + $ cd /path/to/project $ scripts/install-buildtools --make-only #. Source the tools environment setup script by using a command like the following:: - $ source /path/to/poky/buildtools/environment-setup-x86_64-pokysdk-linux + $ source /path/to/project/buildtools/environment-setup-x86_64-pokysdk-linux After you have sourced the setup script, the tools are added to ``PATH`` and any other environment variables required to run the From patchwork Wed Dec 24 16:32:16 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77486 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 79C41E776F0 for ; Wed, 24 Dec 2025 16:32:34 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123217.1766593944492081450 for ; Wed, 24 Dec 2025 08:32:24 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ZcxLIews; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id EC8AC4E41D91 for ; Wed, 24 Dec 2025 16:32:22 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C472B6073D for ; Wed, 24 Dec 2025 16:32:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 24DC510AB1387; Wed, 24 Dec 2025 17:32:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593942; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vbiMfS3FE6ZuPuCWxloWB6JlT+A3/3vvaV8JMxs0Zgk=; b=ZcxLIewsK+kzYMd063TpnPOJaEUtT7zwlf/eq8nARIsXIH6PKrSDf28PNH26D2WyHhxc0O fvBIb5KDNynG/xNsRo3UjGMNSkInY+qWUUH4177ZnPOIJjNlTigOEQ6yIcyxZPDkgOKXmh +NMLe4a1mY1/tDhE96f7QwjeLqEANBgGvfVnerttDDQVH7hlCv+4rvv1/VA0NHF2fsFQpv smzyTOFy+UkKPEslRVNRCTvvuLSkBd+ZaYHB9nIUOE+5LK0RXXiJSUXYhw/ShNF7U7+PAH sEq3iJ3fd4J0njOGkIWNuted5hHtIiEYiMI1JTmFLs0I3ij9gcs/fwFQybZjyQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:16 +0100 Subject: [PATCH 50/53] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-50-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1015; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=c3m+eSvsaW1zYuK4Fn5y6kHIhCKarhbH1hWV0Px7Rcg=; b=owEBbAKT/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVwvntXFDJv6ax00XUmX2Bs8c0/2tklngsWZ Y7Am6dQFh2JAjIEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVcAAKCRDRgEFAKaOo NtDvD/dEEpxSG4dYlbISIhvNmcBkdqmF9vjOzC48szWI0bQZN/rJaoAz+T7wc3iAE9LARaRkBdM dvT+r3fGqbJnokJJsiXApNCwCDe4vd3avZzMjCcjr0QnBcBNaheBdNc7q3G9iCd6LzYIgTYlwzO GRKPa5E++9gMR/p80emHcNq+Xz6Rs6bag35fDyp6MgM7KqQCRkEddvQzfh4WR/VSaOCNz1NsSVO boUdt1xg/ziqg4ydhQPqpodeNfh0e3UewhKvcWzEOKkAqt3ydDBlb2fDAKFc/mLVbSpWFNUjNcq SVytH3BgqOdnmVYwFOiGGwej08AKFN/EFv3qDivd1A9wIITBrfBLph9Zp44OKy7WkdRWw44aDEA /eUylHQGauVgil9DWTL6Ch4cahOIFw8KfWClourMKFvRMO8bRcLeaA8j/0x8ExtcXhSJGm6+WEg y9BOb+eqkm1onUFO1+CFUn/RXLm5hLFa0/PztkMnLMQ4OVtem6gBoxc12A9/E4UTf1ThhamW/zU 2IV3yrcf7hlDWVNPSVRS3smdkmrtDx8Jxwf3oXlBef+bbbkbsUMVvWMpn1G7UbFF1B1d0+ejmy6 4zOIh4dWYA9fc4YKgt7owsVqRBPLlAKfWSvPYfcrA+Jl9Hy8adc7ScYSI+CnxDfxIEQ3myCdR+Q ZgGnAQZ8Kdg4Y X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:34 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8379 Poky -> meta-yocto link replacement. Signed-off-by: Antonin Godard --- documentation/ref-manual/yocto-project-supported-features.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/ref-manual/yocto-project-supported-features.rst b/documentation/ref-manual/yocto-project-supported-features.rst index eeae6b24a..021fca36b 100644 --- a/documentation/ref-manual/yocto-project-supported-features.rst +++ b/documentation/ref-manual/yocto-project-supported-features.rst @@ -59,7 +59,7 @@ Below is a list of primary tested features, their maintainer(s) and builder(s): qemuarm64-ptest, qemuarm64-tc, qemuarmv5 - * - :yocto_git:`Beaglebone ` + * - :yocto_git:`Beaglebone ` - Beaglebone image and SDK build testing - Collective effort - beaglebone, From patchwork Wed Dec 24 16:32:17 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77487 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 738D7E776EA for ; Wed, 24 Dec 2025 16:32:34 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123218.1766593945020027269 for ; Wed, 24 Dec 2025 08:32:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=rPrzqu12; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 7EEBF4E41D8E for ; Wed, 24 Dec 2025 16:32:23 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 561926073D for ; Wed, 24 Dec 2025 16:32:23 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B66F110AB137E; Wed, 24 Dec 2025 17:32:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593943; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=FRXNeRWlYwN2ksrdbh1KKkHuPRSR2Xxvdp+XgL/ldCI=; b=rPrzqu12E0MlEFtbESnZXW0kL+qyKpffNH/mpNhvqcZsqDk45/AhOkt0bIL80BtKhIIzLN BfLuJWMKCUPR5pwAqooRMX8zLd4oI4Q5J08KO6lEU21BTY7aHFfHGwv8/9Of57XdKnKWnj 1PcEWC3M6wAVDTb2ZNejHRH1MFgJze4QlqZjOkpfmT18WKWtYWgRRu+RPshT8CbK0JHRGS VtI9BR7A5tAMT6W/KtDWuSsFkRi1jjg11apoAML1Anoy6uiPU+YAhIweJuZAMbhe+/+jy9 BxOMh87qoVkYEYowJmMGFNBe+jKLScSv9W7nVIRrEgLYjjMCTRx+mvAGGalqkQ== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:17 +0100 Subject: [PATCH 51/53] test-manual/reproducible-builds.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-51-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1258; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=J3Xq7d4zAbBU2bkFct2yLGi6gzaj7pGQudWugM9p9vM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVwvPYwMTs4e0UEf0yrtnOEKgsoRZ3tffUak 1Jmx5erGDSJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVcAAKCRDRgEFAKaOo NjeLEACN4kWUuhS+E8ijgl60v4v65zugfXvC/aZJbWg0q7uUIDX79/tYofjz3N+Xzet6k0PhXtE Zrt59atV7kg9XhRfayWBNx7ZuIpA4kQdf10/t5akVp7AOMeaDk0Rt2dXgMSgfQhdQ1dnhySI0aP jiBYFkj5k2vefoSblPYz16B0lj2jR4QdYe0ngDcJ+aL+9/BMmxRa2o+OepradYcy2wIT7B2CbLS J4YRXgL32RAMzGj0XC9iU7wxJy9eipJnmTlMLy1vCkCaVOVpRvzOWWrmQdV+nXdAiP888dl77KL HlHtr6+fFucd4emDiLV7cYUMuqugmSYhqtdM9bubWldEyp+Pc6w6W4E+VEmwXj7nHhDKW7tyZof xYTb9Ljuhq5PUo0gy1Stzn6RQYKAGzw1mqYlmi4DTU1siVl6PTjwXloboAOLh8T14joTf8cPxoy FsKgUijCxmxV7Uiporde1Fkf0ZrZ0Sf2Dzc/UJUr8ZPaJnSXOJD+BWLwRGrgn+GZecu2QSUGciM lweJ+Vjw3xh1xlyJ3ZpccLUjcFYUXl/lAjiFcaM+fRrjS2K9cG+oNPPWFoiVyOCYrU+YmjsBzXi 5kZRinDqVuqhEVTaZZhDx1O51AJp6iFESrt+BTjGkmK9KBAwOzPCwkMJvEEJjNkIMiBGG1bKbaO yFIWxQdmC+S/vhg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:34 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8380 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/test-manual/reproducible-builds.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst index 336bb7f26..84523ff13 100644 --- a/documentation/test-manual/reproducible-builds.rst +++ b/documentation/test-manual/reproducible-builds.rst @@ -81,10 +81,10 @@ it always depends upon the paths it is built in. .. note:: - Only BitBake and :term:`OpenEmbedded-Core (OE-Core)`, which is the ``meta`` - layer in Poky, guarantee complete reproducibility. The moment you add - another layer, this warranty is voided, because of additional configuration - files, ``bbappend`` files, overridden classes, etc. + Only BitBake and :term:`OpenEmbedded-Core (OE-Core)` guarantee complete + reproducibility. The moment you add another layer, this warranty is voided, + because of additional configuration files, ``bbappend`` files, overridden + classes, etc. To run our automated selftest, as we use in our CI on the Autobuilder, you can run:: From patchwork Wed Dec 24 16:32:18 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77489 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 7E6ECE776F8 for ; Wed, 24 Dec 2025 16:32:34 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123219.1766593945704536540 for ; Wed, 24 Dec 2025 08:32:26 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=n5rFhq5L; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 361414E41D8F for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 0DD9A6073D for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 3F13F10AB1381; Wed, 24 Dec 2025 17:32:23 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593943; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=BkC+xXKgJW1swyzD+aPrb6evrjLJA1CTvQkYPXGR+Dc=; b=n5rFhq5L/+F75januUWacCZKFNtMhDpjxc7UXC0eWGVw+jXjOjUt05Rod6wN0pMfSo1lgB zaSLhauRFHt0Uu6PERORa9MEpQ/2VnMnve7F3bnqwuEt1fKJBNRMat9WreY/zXmGzK6FX6 afHj7jEchX4gj+MN3zYnYugnowQ7iM6lsybjO2IvFc0siJsonol4xup2pLc4U2+uu+Rss1 b5kPA4ERtfkxBVtdN0sa55YE380kslgAjpHZlyp/xI2Q21TL6wlvxXGxRoc67yJzJzf/o6 +hzPqXl1VhByTVTEaT1dmbPZ1qDGwG/kAV4QmZuDOd1iY6EdChqf+1l8gvjYyw== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:18 +0100 Subject: [PATCH 52/53] test-manual/understand-autobuilder.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-52-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1160; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=A+gnKUTYRLxtYe232U7LRDmNgUR5nT0LBOPi0xSkT1Y=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVwg87JAFVVoEpMnfRh0X9A2XHVsHQ+gIU42 OLiRNXYsoeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVcAAKCRDRgEFAKaOo NnJ4D/wO/ps/hF9S2yGlcs0FZebunU5LD8ihSAGGROQuxMS6bShZ+RrxDqFWROy9gJ1x6OFoizo ueJgYba9kiH7FaxanZwU0yVoU73MtCYa64sZil6kAsHPVPNSDfxh+GhaUlZSpXe1brYfgOxn7m7 poEkLiHgD5yX+cawaKKBDjET7Bqn7ipEaBlZN/zUPNFZeds87Y8KAgEBaKEclgqlsRkXwYkti9Y pli1L9KKgiyRdqcKPH+1mDVQcSnepKQSoP9yDI2r6lQ9hVHn6lJrkM74isYsvCKc9UfXB0jfcYe ENJsS2NjMd3zzGj4eGi6xFdJNHcPhO0U0mccnrLdMCnqzvIKeg5hq15cIShvc5LxoryFmaqbORe pxwBTQVkC/vvGaUYJZwNIyst3Yp6ssebzVwPfWhxCN5fmuFUYwHumU4v00X/FIaE5tAEs7p9h5E 7DofeRW3f7KFunY/sdZrdmc2bI7WN5/UGyNhwFGQVV08gmVwR0RlmDJxHq85rt6MueGpGhwQaxw eDFfK1tmINNN4D7g8YecjfDnD6MPi84xgdvQ8PFZBQgHqz0T1PJGy4inFuqjsYcKnPFd2EENOWL 7b4FdCL+j/UTwnTZw0rFaa1JLKSE/mLCWmAZp4912neMak27aoniUEXUmtG8SXIuI8M4i80OjIW vfQlNbeZ4gK7csA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:34 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8381 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/test-manual/understand-autobuilder.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/test-manual/understand-autobuilder.rst b/documentation/test-manual/understand-autobuilder.rst index 23b3ef7d7..2b5eb144f 100644 --- a/documentation/test-manual/understand-autobuilder.rst +++ b/documentation/test-manual/understand-autobuilder.rst @@ -104,7 +104,7 @@ roughly consist of: This is a call into the Helper scripts to set up a checkout of all the pieces this build might need. It might clone the BitBake repository and the OpenEmbedded-Core repository. It may clone the - Poky repository, as well as additional layers. It will use the data + :term:`OpenEmbedded-Core (OE-Core)` repository, as well as additional layers. It will use the data from the ``layerinfo.json`` file to help understand the configuration. It will also use a local cache of repositories to speed up the clone checkouts. For additional information, see From patchwork Wed Dec 24 16:32:19 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 77488 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 8481DE776FC for ; Wed, 24 Dec 2025 16:32:34 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123747.1766593946276331175 for ; Wed, 24 Dec 2025 08:32:26 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=JwTfU/P/; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id BC9E54E41D90 for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8EA306073D for ; Wed, 24 Dec 2025 16:32:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id EE8E110AB1389; Wed, 24 Dec 2025 17:32:23 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1766593944; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=5vVF4lOlo5ICcanc+93TdXkJ/j3ha346h3xp7eMxqBo=; b=JwTfU/P/LdNYB0O7zWZEzaW/oj9VZGeMGt5mlFZQsUZejbzxVNOvvt10lmnjgQWKUTg4FD W+dbyxgzhmJsVv3n2Hu3QQTlKWG+mi3ntPmb/8hOHgPGHG7ElL1d70pnPiMpJBsv4TqOrd Tx+SyyfBjodgj9om8jiTcQ9m2PffSxw5AMsQzHJItosNIGhXo5ry/FDYP8cHmvu2ai+EQr amEDLWo8FFbHJM/ONhVcdVyF6gopdKz4yaBu50wd/ELSYQnDWyItFMMCC6q/VkHKvzscJ+ qvjDARI1OZLeIS4xWXhUrFxgAx/IvUxm0p91UIpZD7jjqr+Rp1OjMCQCzNQGeg== From: Antonin Godard Date: Wed, 24 Dec 2025 17:32:19 +0100 Subject: [PATCH 53/53] what-i-wish-id-known.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20251224-remove-poky-references-v1-53-658a5f4dbde2@bootlin.com> References: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> In-Reply-To: <20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1125; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=W2xD2wRzNvKwgrNv4n5Z59wHZ/UyqL/07ymnSiHpqJg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpTBVwg7IReKl9VTIhAWhJh9C+jG7w7YP90p1x+ azxApeYqNOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaUwVcAAKCRDRgEFAKaOo NuzkEADJ6UH97NdhiAnGG2pNw3N4JXf+6MdzWhoBC5Tsn2i0BEFvURpNgkz/Kgr5AUruNdEyDPe JOaC/sAe3RcZMl8X8iF7ov8/000XQMRsEMF6xnObpgRudIJgY4VEv2m+ypJ3jsFlG9VHCjxk+N7 rnZV2dsm0G+VfKsSTBYXXZPGacG6HtxfiI1qOTNY62TWR8LKZoAsRZ2DSC1S6ozaGzd/yC6Vllt vgrOvQBbZC721UTbZj5wM2GBx8qR26XZtcSSHpAEWHvLjaYBZdVccxXD0p7qA9wwCAR8qwIAqCt oQvlUlCuotqTuXsVxKXzAosipEcQrL0eNE7UmSpN3MsOrtb6q8ZrVwjQCPWtfoJRuxw3tDVcqt9 OyhDGh9fAgP4tQjRJGTXYd+c923a1MHSiyPebrVjomqvH4TUyLAltVVbkCJYRTmMFfzWpPNpwCU uEIIorHROgMsPqE0z5po0FrUQi/2z4QFXAxs3GMQkwJ5vRovcOGll04oJb/5Pl3Hki/aDDx06Rj UbeqKJRzD+TR/0thUl9/h47ylnJ5L7jeJYMxRAcqPziFVR0INxzr3oE1NvlO4jGsu8bMf8dTzt2 6OTElWTIXsCVKJ6YjdpQDAV7EPzePpKNv65wK1hDkZIsocIB5NwKlvnY+OL9KKkOiU29qLAx7ly pdTj/fV3Mf+473w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 24 Dec 2025 16:32:34 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8382 Refresh the document now that the Poky repository is obsolete. Signed-off-by: Antonin Godard --- documentation/what-i-wish-id-known.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst index ddee6ad74..a381a6fdf 100644 --- a/documentation/what-i-wish-id-known.rst +++ b/documentation/what-i-wish-id-known.rst @@ -60,8 +60,9 @@ contact us with other suggestions. layers, on the other hand, helps keep simplify future customizations and reuse. -#. **Never modify the POKY layer. Never. Ever. When you update to the next - release, you'll lose all of your work. ALL OF IT.** +#. **Never modify the core layers (:term:`OpenEmbedded-Core (OE-Core)` and + possibly :yocto_git:`meta-yocto `. Never. Ever. When you update + to the next release, you'll lose all of your work. ALL OF IT.** #. **Don't be fooled by documentation searching results:** Yocto Project documentation is always being updated. Unfortunately, when you