summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/Makefile5
-rw-r--r--documentation/README14
-rw-r--r--documentation/brief-yoctoprojectqs/index.rst8
-rw-r--r--documentation/conf.py4
-rw-r--r--documentation/contributor-guide/submit-changes.rst2
-rw-r--r--documentation/dev-manual/custom-distribution.rst34
-rw-r--r--documentation/dev-manual/debugging.rst12
-rw-r--r--documentation/dev-manual/disk-space.rst2
-rw-r--r--documentation/dev-manual/init-manager.rst2
-rw-r--r--documentation/dev-manual/layers.rst18
-rw-r--r--documentation/dev-manual/start.rst2
-rw-r--r--documentation/dev-manual/vulnerabilities.rst4
-rw-r--r--documentation/dev-manual/wic.rst56
-rw-r--r--documentation/kernel-dev/advanced.rst4
-rw-r--r--documentation/kernel-dev/common.rst14
-rw-r--r--documentation/migration-guides/index.rst1
-rw-r--r--documentation/migration-guides/migration-4.0.rst20
-rw-r--r--documentation/migration-guides/migration-4.2.rst2
-rw-r--r--documentation/migration-guides/migration-5.0.rst101
-rw-r--r--documentation/migration-guides/migration-5.1.rst143
-rw-r--r--documentation/migration-guides/release-4.0.rst1
-rw-r--r--documentation/migration-guides/release-4.3.rst1
-rw-r--r--documentation/migration-guides/release-5.0.rst1
-rw-r--r--documentation/migration-guides/release-5.1.rst9
-rw-r--r--documentation/migration-guides/release-notes-4.0.17.rst12
-rw-r--r--documentation/migration-guides/release-notes-4.0.18.rst191
-rw-r--r--documentation/migration-guides/release-notes-4.0.4.rst2
-rw-r--r--documentation/migration-guides/release-notes-4.0.5.rst2
-rw-r--r--documentation/migration-guides/release-notes-4.0.rst16
-rw-r--r--documentation/migration-guides/release-notes-4.2.rst4
-rw-r--r--documentation/migration-guides/release-notes-4.3.4.rst206
-rw-r--r--documentation/migration-guides/release-notes-5.0.1.rst134
-rw-r--r--documentation/migration-guides/release-notes-5.0.rst931
-rw-r--r--documentation/migration-guides/release-notes-5.1.rst67
-rw-r--r--documentation/overview-manual/intro.rst2
-rw-r--r--documentation/poky.yaml.in26
-rw-r--r--documentation/profile-manual/usage.rst116
-rw-r--r--documentation/ref-manual/classes.rst49
-rw-r--r--documentation/ref-manual/qa-checks.rst8
-rw-r--r--documentation/ref-manual/resources.rst3
-rw-r--r--documentation/ref-manual/svg/releases.svg99
-rw-r--r--documentation/ref-manual/tasks.rst11
-rw-r--r--documentation/ref-manual/terms.rst10
-rw-r--r--documentation/ref-manual/variables.rst98
-rw-r--r--documentation/sdk-manual/working-projects.rst6
-rwxr-xr-xdocumentation/set_versions.py8
-rw-r--r--documentation/standards.md33
47 files changed, 2233 insertions, 261 deletions
diff --git a/documentation/Makefile b/documentation/Makefile
index c930d2d280..189bd1dfac 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -53,9 +53,8 @@ stylecheck:
53 vale sync 53 vale sync
54 vale $(VALEOPTS) $(VALEDOCS) 54 vale $(VALEOPTS) $(VALEDOCS)
55 55
56stylecheck: 56sphinx-lint:
57 vale sync 57 sphinx-lint $(SOURCEDIR)
58 vale $(VALEOPTS) $(VALEDOCS)
59 58
60epub: $(PNGs) 59epub: $(PNGs)
61 $(SOURCEDIR)/set_versions.py 60 $(SOURCEDIR)/set_versions.py
diff --git a/documentation/README b/documentation/README
index 8035418cac..b60472fcbf 100644
--- a/documentation/README
+++ b/documentation/README
@@ -165,6 +165,20 @@ To run Vale:
165 165
166 $ make stylecheck 166 $ make stylecheck
167 167
168Link checking the Yocto Project documentation
169=============================================
170
171To fix errors which are not reported by Sphinx itself,
172the project uses sphinx-lint (https://github.com/sphinx-contrib/sphinx-lint).
173
174To install sphinx-lint:
175
176 $ pip install sphinx-lint
177
178To run sphinx-lint:
179
180 $ make sphinx-lint
181
168Sphinx theme and CSS customization 182Sphinx theme and CSS customization
169================================== 183==================================
170 184
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index 61c5cbec36..c5400e4ac8 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -251,11 +251,17 @@ an entire Linux distribution, including the toolchain, from source.
251 To use such mirrors, uncomment the below lines in your ``conf/local.conf`` 251 To use such mirrors, uncomment the below lines in your ``conf/local.conf``
252 file in the :term:`Build Directory`:: 252 file in the :term:`Build Directory`::
253 253
254 BB_HASHSERVE_UPSTREAM = "hashserv.yocto.io:8687" 254 BB_HASHSERVE_UPSTREAM = "wss://hashserv.yoctoproject.org/ws"
255 SSTATE_MIRRORS ?= "file://.* http://cdn.jsdelivr.net/yocto/sstate/all/PATH;downloadfilename=PATH" 255 SSTATE_MIRRORS ?= "file://.* http://cdn.jsdelivr.net/yocto/sstate/all/PATH;downloadfilename=PATH"
256 BB_HASHSERVE = "auto" 256 BB_HASHSERVE = "auto"
257 BB_SIGNATURE_HANDLER = "OEEquivHash" 257 BB_SIGNATURE_HANDLER = "OEEquivHash"
258 258
259 The hash equivalence server needs the websockets python module version 9.1
260 or later. Debian GNU/Linux 12 (Bookworm) and later, Fedora, CentOS Stream
261 9 and later, and Ubuntu 22.04 (LTS) and later, all have a recent enough
262 package. Other supported distributions need to get the module some other
263 place than their package feed, e.g. via ``pip``.
264
259#. **Start the Build:** Continue with the following command to build an OS 265#. **Start the Build:** Continue with the following command to build an OS
260 image for the target, which is ``core-image-sato`` in this example: 266 image for the target, which is ``core-image-sato`` in this example:
261 267
diff --git a/documentation/conf.py b/documentation/conf.py
index a64685ec9b..35c5c14535 100644
--- a/documentation/conf.py
+++ b/documentation/conf.py
@@ -159,8 +159,8 @@ html_last_updated_fmt = '%b %d, %Y'
159html_secnumber_suffix = " " 159html_secnumber_suffix = " "
160 160
161latex_elements = { 161latex_elements = {
162 'passoptionstopackages': '\PassOptionsToPackage{bookmarksdepth=5}{hyperref}', 162 'passoptionstopackages': '\\PassOptionsToPackage{bookmarksdepth=5}{hyperref}',
163 'preamble': '\setcounter{tocdepth}{2}', 163 'preamble': '\\setcounter{tocdepth}{2}',
164} 164}
165 165
166# Make the EPUB builder prefer PNG to SVG because of issues rendering Inkscape SVG 166# Make the EPUB builder prefer PNG to SVG because of issues rendering Inkscape SVG
diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst
index dfeb0305c3..47a416b245 100644
--- a/documentation/contributor-guide/submit-changes.rst
+++ b/documentation/contributor-guide/submit-changes.rst
@@ -440,7 +440,7 @@ varies by component:
440 440
441For changes to other layers and tools hosted in the Yocto Project source 441For changes to other layers and tools hosted in the Yocto Project source
442repositories (i.e. :yocto_git:`git.yoctoproject.org <>`), use the 442repositories (i.e. :yocto_git:`git.yoctoproject.org <>`), use the
443:yocto_lists:`yocto </g/yocto/>` general mailing list. 443:yocto_lists:`yocto-patches </g/yocto-patches/>` general mailing list.
444 444
445For changes to other layers hosted in the OpenEmbedded source 445For changes to other layers hosted in the OpenEmbedded source
446repositories (i.e. :oe_git:`git.openembedded.org <>`), use 446repositories (i.e. :oe_git:`git.openembedded.org <>`), use
diff --git a/documentation/dev-manual/custom-distribution.rst b/documentation/dev-manual/custom-distribution.rst
index 47faed0d04..0bc386d606 100644
--- a/documentation/dev-manual/custom-distribution.rst
+++ b/documentation/dev-manual/custom-distribution.rst
@@ -4,10 +4,16 @@ Creating Your Own Distribution
4****************************** 4******************************
5 5
6When you build an image using the Yocto Project and do not alter any 6When you build an image using the Yocto Project and do not alter any
7distribution :term:`Metadata`, you are 7distribution :term:`Metadata`, you are using the Poky distribution.
8creating a Poky distribution. If you wish to gain more control over 8Poky is explicitly a *reference* distribution for testing and
9package alternative selections, compile-time options, and other 9development purposes. It enables most hardware and software features
10low-level configurations, you can create your own distribution. 10so that they can be tested, but this also means that from a security
11point of view the attack surface is very large. Additionally, at some
12point it is likely that you will want to gain more control over package
13alternative selections, compile-time options, and other low-level
14configurations. For both of these reasons, if you are using the Yocto
15Project for production use then you are strongly encouraged to create
16your own distribution.
11 17
12To create your own distribution, the basic steps consist of creating 18To create your own distribution, the basic steps consist of creating
13your own distribution layer, creating your own distribution 19your own distribution layer, creating your own distribution
@@ -107,3 +113,23 @@ layer. The following steps provide some more detail:
107 For information on append files, see the 113 For information on append files, see the
108 ":ref:`dev-manual/layers:appending other layers metadata with your layer`" 114 ":ref:`dev-manual/layers:appending other layers metadata with your layer`"
109 section. 115 section.
116
117Copying and modifying the Poky distribution
118===========================================
119
120Instead of creating a custom distribution from scratch as per above, you may
121wish to start your custom distribution configuration by copying the Poky
122distribution provided within the ``meta-poky`` layer and then modifying it.
123This is fine, however if you do this you should keep the following in mind:
124
125- Every reference to Poky needs to be updated in your copy so that it
126 will still apply. This includes override usage within files (e.g. ``:poky``)
127 and in directory names. This is a good opportunity to evaluate each one of
128 these customizations to see if they are needed for your use case.
129
130- Unless you also intend to use them, the ``poky-tiny``, ``poky-altcfg`` and
131 ``poky-bleeding`` variants and any references to them can be removed.
132
133- More generally, the Poky distribution configuration enables a lot more
134 than you likely need for your production use case. You should evaluate *every*
135 configuration choice made in your copy to determine if it is needed.
diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst
index e20637e1c6..92458a0c37 100644
--- a/documentation/dev-manual/debugging.rst
+++ b/documentation/dev-manual/debugging.rst
@@ -270,13 +270,17 @@ format and can be converted to images (e.g. using the ``dot`` tool from
270 displays paths between graph nodes. 270 displays paths between graph nodes.
271 271
272You can use a different method to view dependency information by using 272You can use a different method to view dependency information by using
273the following command:: 273either::
274 274
275 $ bitbake -g -u taskexp recipename 275 $ bitbake -g -u taskexp recipename
276 276
277This command 277or::
278displays a GUI window from which you can view build-time and runtime 278
279dependencies for the recipes involved in building recipename. 279 $ bitbake -g -u taskexp_ncurses recipename
280
281The ``-u taskdep`` option GUI window from which you can view build-time and
282runtime dependencies for the recipes involved in building recipename. The
283``-u taskexp_ncurses`` option uses ncurses instead of GTK to render the UI.
280 284
281Viewing Task Variable Dependencies 285Viewing Task Variable Dependencies
282================================== 286==================================
diff --git a/documentation/dev-manual/disk-space.rst b/documentation/dev-manual/disk-space.rst
index 6d1638a302..efca82601d 100644
--- a/documentation/dev-manual/disk-space.rst
+++ b/documentation/dev-manual/disk-space.rst
@@ -49,7 +49,7 @@ requires a full build environment to be available and doesn't work well
49covering multiple releases. It won't work either on limited environments 49covering multiple releases. It won't work either on limited environments
50such as BSD based NAS:: 50such as BSD based NAS::
51 51
52 sstate-cache-management.sh --remove-duplicated --cache-dir=build/sstate-cache 52 sstate-cache-management.py --remove-duplicated --cache-dir=sstate-cache
53 53
54This command will ask you to confirm the deletions it identifies. 54This command will ask you to confirm the deletions it identifies.
55Run ``sstate-cache-management.sh`` for more details about this script. 55Run ``sstate-cache-management.sh`` for more details about this script.
diff --git a/documentation/dev-manual/init-manager.rst b/documentation/dev-manual/init-manager.rst
index 20d61ea830..ddce82b81f 100644
--- a/documentation/dev-manual/init-manager.rst
+++ b/documentation/dev-manual/init-manager.rst
@@ -121,7 +121,7 @@ increasing levels of complexity and functionality:
121 :widths: 40 20 20 20 121 :widths: 40 20 20 20
122 :header-rows: 1 122 :header-rows: 1
123 123
124 * - 124 * -
125 - BusyBox init 125 - BusyBox init
126 - SysVinit 126 - SysVinit
127 - systemd 127 - systemd
diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst
index f7929e630e..91889bd0ae 100644
--- a/documentation/dev-manual/layers.rst
+++ b/documentation/dev-manual/layers.rst
@@ -501,12 +501,12 @@ the "meta" layer at ``meta/recipes-bsp/formfactor``::
501 INHIBIT_DEFAULT_DEPS = "1" 501 INHIBIT_DEFAULT_DEPS = "1"
502 502
503 do_install() { 503 do_install() {
504 # Install file only if it has contents 504 # Install file only if it has contents
505 install -d ${D}${sysconfdir}/formfactor/ 505 install -d ${D}${sysconfdir}/formfactor/
506 install -m 0644 ${S}/config ${D}${sysconfdir}/formfactor/ 506 install -m 0644 ${S}/config ${D}${sysconfdir}/formfactor/
507 if [ -s "${S}/machconfig" ]; then 507 if [ -s "${S}/machconfig" ]; then
508 install -m 0644 ${S}/machconfig ${D}${sysconfdir}/formfactor/ 508 install -m 0644 ${S}/machconfig ${D}${sysconfdir}/formfactor/
509 fi 509 fi
510 } 510 }
511 511
512In the main recipe, note the :term:`SRC_URI` 512In the main recipe, note the :term:`SRC_URI`
@@ -582,10 +582,10 @@ Directory`. Here is the main ``xserver-xf86-config`` recipe, which is named
582 ALLOW_EMPTY:${PN} = "1" 582 ALLOW_EMPTY:${PN} = "1"
583 583
584 do_install () { 584 do_install () {
585 if test -s ${WORKDIR}/xorg.conf; then 585 if test -s ${WORKDIR}/xorg.conf; then
586 install -d ${D}/${sysconfdir}/X11 586 install -d ${D}/${sysconfdir}/X11
587 install -m 0644 ${WORKDIR}/xorg.conf ${D}/${sysconfdir}/X11/ 587 install -m 0644 ${WORKDIR}/xorg.conf ${D}/${sysconfdir}/X11/
588 fi 588 fi
589 } 589 }
590 590
591Here is the append file, which is named ``xserver-xf86-config_%.bbappend`` 591Here is the append file, which is named ``xserver-xf86-config_%.bbappend``
@@ -732,7 +732,7 @@ The following list describes the available commands:
732 732
733- ``save-build-conf``: Saves the currently active build configuration 733- ``save-build-conf``: Saves the currently active build configuration
734 (``conf/local.conf``, ``conf/bblayers.conf``) as a template into a layer. 734 (``conf/local.conf``, ``conf/bblayers.conf``) as a template into a layer.
735 This template can later be used for setting up builds via :term:``TEMPLATECONF``. 735 This template can later be used for setting up builds via :term:`TEMPLATECONF`.
736 For information about saving and using configuration templates, see 736 For information about saving and using configuration templates, see
737 ":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`". 737 ":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`".
738 738
diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst
index 8539bc0889..386e5f5d29 100644
--- a/documentation/dev-manual/start.rst
+++ b/documentation/dev-manual/start.rst
@@ -619,7 +619,7 @@ containing the release you wish to use, for example
619 619
620You will find there source archives of individual components (if you wish 620You will find there source archives of individual components (if you wish
621to use them individually), and of the corresponding Poky release bundling 621to use them individually), and of the corresponding Poky release bundling
622a selection of these components. 622a selection of these components.
623 623
624.. note:: 624.. note::
625 625
diff --git a/documentation/dev-manual/vulnerabilities.rst b/documentation/dev-manual/vulnerabilities.rst
index 1bc2a85929..983d4ad3c6 100644
--- a/documentation/dev-manual/vulnerabilities.rst
+++ b/documentation/dev-manual/vulnerabilities.rst
@@ -57,6 +57,10 @@ applied and that the issue needs to be investigated. ``Ignored`` means that afte
57analysis, it has been deemed to ignore the issue as it for example affects 57analysis, it has been deemed to ignore the issue as it for example affects
58the software component on a different operating system platform. 58the software component on a different operating system platform.
59 59
60By default, no NVD API key is used to retrieve data from the CVE database, which
61results in larger delays between NVD API requests. See the :term:`NVDCVE_API_KEY`
62documentation on how to request and set a NVD API key.
63
60After a build with CVE check enabled, reports for each compiled source recipe will be 64After a build with CVE check enabled, reports for each compiled source recipe will be
61found in ``build/tmp/deploy/cve``. 65found in ``build/tmp/deploy/cve``.
62 66
diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst
index 05e9cb381b..a3880f3a1c 100644
--- a/documentation/dev-manual/wic.rst
+++ b/documentation/dev-manual/wic.rst
@@ -139,20 +139,20 @@ individual images through the ``list`` command. You can use the ``list``
139command to return the available Wic images as follows:: 139command to return the available Wic images as follows::
140 140
141 $ wic list images 141 $ wic list images
142 genericx86 Create an EFI disk image for genericx86* 142 genericx86 Create an EFI disk image for genericx86*
143 beaglebone-yocto Create SD card image for Beaglebone 143 beaglebone-yocto Create SD card image for Beaglebone
144 qemuriscv Create qcow2 image for RISC-V QEMU machines 144 qemuriscv Create qcow2 image for RISC-V QEMU machines
145 mkefidisk Create an EFI disk image 145 mkefidisk Create an EFI disk image
146 qemuloongarch Create qcow2 image for LoongArch QEMU machines 146 qemuloongarch Create qcow2 image for LoongArch QEMU machines
147 directdisk-multi-rootfs Create multi rootfs image using rootfs plugin 147 directdisk-multi-rootfs Create multi rootfs image using rootfs plugin
148 directdisk Create a 'pcbios' direct disk image 148 directdisk Create a 'pcbios' direct disk image
149 efi-bootdisk 149 efi-bootdisk
150 mkhybridiso Create a hybrid ISO image 150 mkhybridiso Create a hybrid ISO image
151 directdisk-gpt Create a 'pcbios' direct disk image 151 directdisk-gpt Create a 'pcbios' direct disk image
152 systemd-bootdisk Create an EFI disk image with systemd-boot 152 systemd-bootdisk Create an EFI disk image with systemd-boot
153 sdimage-bootpart Create SD card image with a boot partition 153 sdimage-bootpart Create SD card image with a boot partition
154 qemux86-directdisk Create a qemu machine 'pcbios' direct disk image 154 qemux86-directdisk Create a qemu machine 'pcbios' direct disk image
155 directdisk-bootloader-config Create a 'pcbios' direct disk image with custom bootloader config 155 directdisk-bootloader-config Create a 'pcbios' direct disk image with custom bootloader config
156 156
157Once you know the list of available 157Once you know the list of available
158Wic images, you can use ``help`` with the command to get help on a 158Wic images, you can use ``help`` with the command to get help on a
@@ -282,20 +282,20 @@ following two locations::
282Use the following command to list the available kickstart files:: 282Use the following command to list the available kickstart files::
283 283
284 $ wic list images 284 $ wic list images
285 genericx86 Create an EFI disk image for genericx86* 285 genericx86 Create an EFI disk image for genericx86*
286 beaglebone-yocto Create SD card image for Beaglebone 286 beaglebone-yocto Create SD card image for Beaglebone
287 qemuriscv Create qcow2 image for RISC-V QEMU machines 287 qemuriscv Create qcow2 image for RISC-V QEMU machines
288 mkefidisk Create an EFI disk image 288 mkefidisk Create an EFI disk image
289 qemuloongarch Create qcow2 image for LoongArch QEMU machines 289 qemuloongarch Create qcow2 image for LoongArch QEMU machines
290 directdisk-multi-rootfs Create multi rootfs image using rootfs plugin 290 directdisk-multi-rootfs Create multi rootfs image using rootfs plugin
291 directdisk Create a 'pcbios' direct disk image 291 directdisk Create a 'pcbios' direct disk image
292 efi-bootdisk 292 efi-bootdisk
293 mkhybridiso Create a hybrid ISO image 293 mkhybridiso Create a hybrid ISO image
294 directdisk-gpt Create a 'pcbios' direct disk image 294 directdisk-gpt Create a 'pcbios' direct disk image
295 systemd-bootdisk Create an EFI disk image with systemd-boot 295 systemd-bootdisk Create an EFI disk image with systemd-boot
296 sdimage-bootpart Create SD card image with a boot partition 296 sdimage-bootpart Create SD card image with a boot partition
297 qemux86-directdisk Create a qemu machine 'pcbios' direct disk image 297 qemux86-directdisk Create a qemu machine 'pcbios' direct disk image
298 directdisk-bootloader-config Create a 'pcbios' direct disk image with custom bootloader config 298 directdisk-bootloader-config Create a 'pcbios' direct disk image with custom bootloader config
299 299
300When you use an existing file, you 300When you use an existing file, you
301do not have to use the ``.wks`` extension. Here is an example in Raw 301do not have to use the ``.wks`` extension. Here is an example in Raw
diff --git a/documentation/kernel-dev/advanced.rst b/documentation/kernel-dev/advanced.rst
index bcaaaeed14..4c463503f6 100644
--- a/documentation/kernel-dev/advanced.rst
+++ b/documentation/kernel-dev/advanced.rst
@@ -303,8 +303,8 @@ The following listings show the ``build.scc`` file and part of the
303 . 303 .
304 . 304 .
305 . 305 .
306 char *dump_write = NULL, *files_source = NULL; 306 char *dump_write = NULL, *files_source = NULL;
307 int opt; 307 int opt;
308 -- 308 --
309 2.10.1 309 2.10.1
310 310
diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst
index 0cee503346..fda41694dc 100644
--- a/documentation/kernel-dev/common.rst
+++ b/documentation/kernel-dev/common.rst
@@ -315,11 +315,7 @@ home directory:
315 315
316#. *Create Structure*: Create the layer's structure:: 316#. *Create Structure*: Create the layer's structure::
317 317
318 $ mkdir meta-mylayer 318 $ mkdir -p meta-mylayer/conf meta-mylayer/recipes-kernel/linux/linux-yocto
319 $ mkdir meta-mylayer/conf
320 $ mkdir meta-mylayer/recipes-kernel
321 $ mkdir meta-mylayer/recipes-kernel/linux
322 $ mkdir meta-mylayer/recipes-kernel/linux/linux-yocto
323 319
324 The ``conf`` directory holds your configuration files, while the 320 The ``conf`` directory holds your configuration files, while the
325 ``recipes-kernel`` directory holds your append file and eventual 321 ``recipes-kernel`` directory holds your append file and eventual
@@ -964,9 +960,7 @@ Section.
964 additional structure to your layer using the following commands:: 960 additional structure to your layer using the following commands::
965 961
966 $ cd ~/meta-mylayer 962 $ cd ~/meta-mylayer
967 $ mkdir recipes-kernel 963 $ mkdir -p recipes-kernel recipes-kernel/linux/linux-yocto
968 $ mkdir recipes-kernel/linux
969 $ mkdir recipes-kernel/linux/linux-yocto
970 964
971 Once you have created this 965 Once you have created this
972 hierarchy in your layer, you can move the patch file using the 966 hierarchy in your layer, you can move the patch file using the
@@ -1674,10 +1668,10 @@ looks much like the one provided with the ``hello-mod`` template::
1674 SRC := $(shell pwd) 1668 SRC := $(shell pwd)
1675 1669
1676 all: 1670 all:
1677 $(MAKE) -C $(KERNEL_SRC) M=$(SRC) 1671 $(MAKE) -C $(KERNEL_SRC) M=$(SRC)
1678 1672
1679 modules_install: 1673 modules_install:
1680 $(MAKE) -C $(KERNEL_SRC) M=$(SRC) modules_install 1674 $(MAKE) -C $(KERNEL_SRC) M=$(SRC) modules_install
1681 ... 1675 ...
1682 1676
1683The important point to note here is the :term:`KERNEL_SRC` variable. The 1677The important point to note here is the :term:`KERNEL_SRC` variable. The
diff --git a/documentation/migration-guides/index.rst b/documentation/migration-guides/index.rst
index d8edd05b89..e9d7f72809 100644
--- a/documentation/migration-guides/index.rst
+++ b/documentation/migration-guides/index.rst
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
12.. toctree:: 12.. toctree::
13 13
14 migration-general 14 migration-general
15 release-5.1
15 release-5.0 16 release-5.0
16 release-4.3 17 release-4.3
17 release-4.2 18 release-4.2
diff --git a/documentation/migration-guides/migration-4.0.rst b/documentation/migration-guides/migration-4.0.rst
index b5bd57c312..0e9e741458 100644
--- a/documentation/migration-guides/migration-4.0.rst
+++ b/documentation/migration-guides/migration-4.0.rst
@@ -68,7 +68,7 @@ changes and you need to review them before committing. An example warning
68looks like:: 68looks like::
69 69
70 poky/scripts/lib/devtool/upgrade.py needs further work at line 275 since it contains abort 70 poky/scripts/lib/devtool/upgrade.py needs further work at line 275 since it contains abort
71 71
72Fetching changes 72Fetching changes
73~~~~~~~~~~~~~~~~ 73~~~~~~~~~~~~~~~~
74 74
@@ -111,7 +111,7 @@ License changes
111 If they do not, by default a warning will be shown. A 111 If they do not, by default a warning will be shown. A
112 :oe_git:`convert-spdx-licenses.py </openembedded-core/tree/scripts/contrib/convert-spdx-licenses.py>` 112 :oe_git:`convert-spdx-licenses.py </openembedded-core/tree/scripts/contrib/convert-spdx-licenses.py>`
113 script can be used to update your recipes. 113 script can be used to update your recipes.
114 114
115- :term:`INCOMPATIBLE_LICENSE` should now use `SPDX identifiers <https://spdx.org/licenses/>`__. 115- :term:`INCOMPATIBLE_LICENSE` should now use `SPDX identifiers <https://spdx.org/licenses/>`__.
116 Additionally, wildcarding is now limited to specifically supported values - 116 Additionally, wildcarding is now limited to specifically supported values -
117 see the :term:`INCOMPATIBLE_LICENSE` documentation for further information. 117 see the :term:`INCOMPATIBLE_LICENSE` documentation for further information.
@@ -121,7 +121,7 @@ License changes
121 which can cause signature issues for users. In addition the ``available_licenses()`` 121 which can cause signature issues for users. In addition the ``available_licenses()``
122 function has been removed from the :ref:`ref-classes-license` class as 122 function has been removed from the :ref:`ref-classes-license` class as
123 it is no longer needed. 123 it is no longer needed.
124 124
125Removed recipes 125Removed recipes
126~~~~~~~~~~~~~~~ 126~~~~~~~~~~~~~~~
127 127
@@ -136,11 +136,11 @@ The following recipes have been removed in this release:
136 136
137Python changes 137Python changes
138~~~~~~~~~~~~~~ 138~~~~~~~~~~~~~~
139 139
140- ``distutils`` has been deprecated upstream in Python 3.10 and thus the ``distutils*`` 140- ``distutils`` has been deprecated upstream in Python 3.10 and thus the ``distutils*``
141 classes have been moved to ``meta-python``. Recipes that inherit the ``distutils*`` 141 classes have been moved to ``meta-python``. Recipes that inherit the ``distutils*``
142 classes should be updated to inherit ``setuptools*`` equivalents instead. 142 classes should be updated to inherit ``setuptools*`` equivalents instead.
143 143
144- The Python package build process is now based on `wheels <https://pythonwheels.com/>`__. 144- The Python package build process is now based on `wheels <https://pythonwheels.com/>`__.
145 The new Python packaging classes that should be used are 145 The new Python packaging classes that should be used are
146 :ref:`ref-classes-python_flit_core`, :ref:`ref-classes-python_setuptools_build_meta` 146 :ref:`ref-classes-python_flit_core`, :ref:`ref-classes-python_setuptools_build_meta`
@@ -159,7 +159,7 @@ Prelink removed
159Prelink has been dropped by ``glibc`` upstream in 2.36. It already caused issues with 159Prelink has been dropped by ``glibc`` upstream in 2.36. It already caused issues with
160binary corruption, has a number of open bugs and is of questionable benefit 160binary corruption, has a number of open bugs and is of questionable benefit
161without disabling load address randomization and PIE executables. 161without disabling load address randomization and PIE executables.
162 162
163We disabled prelinking by default in the honister (3.4) release, but left it able 163We disabled prelinking by default in the honister (3.4) release, but left it able
164to be enabled if desired. However, without glibc support it cannot be maintained 164to be enabled if desired. However, without glibc support it cannot be maintained
165any further, so all of the prelinking functionality has been removed in this release. 165any further, so all of the prelinking functionality has been removed in this release.
@@ -170,7 +170,7 @@ reference(s).
170Reproducible as standard 170Reproducible as standard
171~~~~~~~~~~~~~~~~~~~~~~~~ 171~~~~~~~~~~~~~~~~~~~~~~~~
172 172
173Reproducibility is now considered as standard functionality, thus the 173Reproducibility is now considered as standard functionality, thus the
174``reproducible`` class has been removed and its previous contents merged into the 174``reproducible`` class has been removed and its previous contents merged into the
175:ref:`ref-classes-base` class. If you have references in your configuration to 175:ref:`ref-classes-base` class. If you have references in your configuration to
176``reproducible`` in :term:`INHERIT`, :term:`USER_CLASSES` etc. then they should be 176``reproducible`` in :term:`INHERIT`, :term:`USER_CLASSES` etc. then they should be
@@ -212,7 +212,7 @@ and :ref:`bitbake-user-manual/bitbake-user-manual-metadata:removal (override sty
212 212
213Miscellaneous changes 213Miscellaneous changes
214~~~~~~~~~~~~~~~~~~~~~ 214~~~~~~~~~~~~~~~~~~~~~
215 215
216- ``blacklist.bbclass`` is removed and the functionality moved to the 216- ``blacklist.bbclass`` is removed and the functionality moved to the
217 :ref:`ref-classes-base` class with a more descriptive 217 :ref:`ref-classes-base` class with a more descriptive
218 ``varflag`` variable named :term:`SKIP_RECIPE` which will use the `bb.parse.SkipRecipe()` 218 ``varflag`` variable named :term:`SKIP_RECIPE` which will use the `bb.parse.SkipRecipe()`
@@ -252,7 +252,7 @@ Miscellaneous changes
252- The ``cortexa72-crc`` and ``cortexa72-crc-crypto`` tunes have been removed since 252- The ``cortexa72-crc`` and ``cortexa72-crc-crypto`` tunes have been removed since
253 the crc extension is now enabled by default for cortexa72. Replace any references to 253 the crc extension is now enabled by default for cortexa72. Replace any references to
254 these with ``cortexa72`` and ``cortexa72-crypto`` respectively. 254 these with ``cortexa72`` and ``cortexa72-crypto`` respectively.
255 255
256- The Python development shell (previously known as ``devpyshell``) feature has been 256- The Python development shell (previously known as ``devpyshell``) feature has been
257 renamed to ``pydevshell``. To start it you should now run:: 257 renamed to ``pydevshell``. To start it you should now run::
258 258
@@ -261,7 +261,7 @@ Miscellaneous changes
261- The ``packagegroups-core-full-cmdline-libs`` packagegroup is no longer produced, as 261- The ``packagegroups-core-full-cmdline-libs`` packagegroup is no longer produced, as
262 libraries should normally be brought in via dependencies. If you have any references 262 libraries should normally be brought in via dependencies. If you have any references
263 to this then remove them. 263 to this then remove them.
264 264
265- The :term:`TOPDIR` variable and the current working directory are no longer modified 265- The :term:`TOPDIR` variable and the current working directory are no longer modified
266 when parsing recipes. Any code depending on the previous behaviour will no longer 266 when parsing recipes. Any code depending on the previous behaviour will no longer
267 work - change any such code to explicitly use appropriate path variables instead. 267 work - change any such code to explicitly use appropriate path variables instead.
diff --git a/documentation/migration-guides/migration-4.2.rst b/documentation/migration-guides/migration-4.2.rst
index 1db6fbca42..f5f12c8871 100644
--- a/documentation/migration-guides/migration-4.2.rst
+++ b/documentation/migration-guides/migration-4.2.rst
@@ -121,7 +121,7 @@ Removed variables
121The following variables have been removed: 121The following variables have been removed:
122 122
123- ``SERIAL_CONSOLE``, deprecated since version 2.6, replaced by :term:`SERIAL_CONSOLES`. 123- ``SERIAL_CONSOLE``, deprecated since version 2.6, replaced by :term:`SERIAL_CONSOLES`.
124- ``PACKAGEBUILDPKGD``, a mostly internal variable in the ref:`ref-classes-package` 124- ``PACKAGEBUILDPKGD``, a mostly internal variable in the :ref:`ref-classes-package`
125 class was rarely used to customise packaging. If you were using this in your custom 125 class was rarely used to customise packaging. If you were using this in your custom
126 recipes or bbappends, you will need to switch to using :term:`PACKAGE_PREPROCESS_FUNCS` 126 recipes or bbappends, you will need to switch to using :term:`PACKAGE_PREPROCESS_FUNCS`
127 or :term:`PACKAGESPLITFUNCS` instead. 127 or :term:`PACKAGESPLITFUNCS` instead.
diff --git a/documentation/migration-guides/migration-5.0.rst b/documentation/migration-guides/migration-5.0.rst
index 32581d750b..cf413300c2 100644
--- a/documentation/migration-guides/migration-5.0.rst
+++ b/documentation/migration-guides/migration-5.0.rst
@@ -52,11 +52,21 @@ See :ref:`all supported distributions <system-requirements-supported-distros>`.
52Go language changes 52Go language changes
53~~~~~~~~~~~~~~~~~~~ 53~~~~~~~~~~~~~~~~~~~
54 54
55The ``linkmode`` flag was dropped from ``GO_LDFLAGS`` for ``nativesdk`` and
56``cross-canadian``. Also, dynamic linking was disabled for the whole set of
57(previously) supported architectures in the ``goarch`` class.
58
55.. _migration-5.0-systemd-changes: 59.. _migration-5.0-systemd-changes:
56 60
57systemd changes 61systemd changes
58~~~~~~~~~~~~~~~ 62~~~~~~~~~~~~~~~
59 63
64Systemd's nss-resolve plugin is now supported and can be added via the
65``nss-resolve`` :term:`PACKAGECONFIG` option , which is from now on required
66(along with ``resolved``) by the ``systemd-resolved`` feature. Related to that
67(i.e., Systemd's network name resolution), an option to use ``stub-resolv.conf``
68was added as well.
69
60.. _migration-5.0-recipe-changes: 70.. _migration-5.0-recipe-changes:
61 71
62Recipe changes 72Recipe changes
@@ -70,7 +80,8 @@ Recipe changes
70Deprecated variables 80Deprecated variables
71~~~~~~~~~~~~~~~~~~~~ 81~~~~~~~~~~~~~~~~~~~~
72 82
73The following variables have been deprecated: 83- ``CVE_CHECK_IGNORE`` should be replaced with :term:`CVE_STATUS`
84
74 85
75.. _migration-5.0-removed-variables: 86.. _migration-5.0-removed-variables:
76 87
@@ -79,6 +90,15 @@ Removed variables
79 90
80The following variables have been removed: 91The following variables have been removed:
81 92
93- ``DEPLOY_DIR_TAR``: no longer needed since the package_tar class was removed in 4.2.
94- ``PYTHON_PN``: Python 2 has previously been removed, leaving Python 3 as the sole
95 major version. Therefore, this abstraction to differentiate both versions is
96 no longer needed.
97- ``oldincludedir``
98- ``USE_L10N``: previously deprecated, and now removed.
99- ``CVE_SOCKET_TIMEOUT``
100- ``SERIAL_CONSOLES_CHECK`` - use :term:`SERIAL_CONSOLES` instead as all consoles specified in the latter are checked for their existence before a ``getty`` is started.
101
82.. _migration-5.0-removed-recipes: 102.. _migration-5.0-removed-recipes:
83 103
84Removed recipes 104Removed recipes
@@ -86,20 +106,97 @@ Removed recipes
86 106
87The following recipes have been removed in this release: 107The following recipes have been removed in this release:
88 108
109- ``libcroco``: deprecated and archived by the Gnome Project.
110- ``liberror-perl``: unmaintained and no longer needed - moved to meta-perl.
111- ``linux-yocto``: version 6.1 (version 6.6 provided instead).
112- ``systemtap-uprobes``: obsolete.
113- ``zvariant``: fails to build with newer Rust.
114
89.. _migration-5.0-removed-classes: 115.. _migration-5.0-removed-classes:
90 116
91Removed classes 117Removed classes
92~~~~~~~~~~~~~~~ 118~~~~~~~~~~~~~~~
93 119
94The following classes have been removed in this release: 120No classes have been removed in this release.
95 121
96.. _migration-5.0-qemu-changes: 122.. _migration-5.0-qemu-changes:
97 123
98QEMU changes 124QEMU changes
99~~~~~~~~~~~~ 125~~~~~~~~~~~~
100 126
127In ``tune-core2``, the cpu models ``n270`` and ``core2duo`` are no longer
128passed to QEMU, since its documentation recommends not using them with ``-cpu``
129option. Therefore, from now on, ``Nehalem`` model is used instead.
130
131
132ipk packaging changes
133~~~~~~~~~~~~~~~~~~~~~
134
135ipk packaging (using ``opkg``) now uses ``zstd`` compression instead of ``xz``
136for better compression and performance. This does mean that ``.ipk`` packages
137built using the 5.0 release requires Opkg built with zstd enabled --- naturally
138this is the case in 5.0, but at least by default these packages will not be
139usable on older systems where Opkg does not have zstd enabled at build time.
140
141Additionally, the internal dependency solver in Opkg is now deprecated --- it
142is still available in this release but will trigger a warning if selected.
143The default has been the external ``libsolv`` solver for some time, but if you
144have explicitly removed that from :term:`PACKAGECONFIG` for Opkg to
145select the internal solver, you should plan to switch to ``libsolv`` in the
146near future (by including ``libsolv`` your custom :term:`PACKAGECONFIG` value
147for Opkg, or reverting to the default value).
148
149
150motd message when using ``DISTRO = "poky"``
151~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
152
153The default ``poky`` :term:`DISTRO` is explicitly a *reference* distribution
154for testing and development purposes. It enables most hardware and software
155features so that they can be tested, but this also means that
156from a security point of view the attack surface is very large.
157
158We encourage anyone using the Yocto Project for production use to create
159their own distribution and not use Poky. To encourage this behaviour
160further, in 5.0 a warning has been added to ``/etc/motd`` when Poky is used
161so that the developer will see it when they log in. If you are creating your
162own distribution this message will not show up.
163
164For information on how to create your own distribution, see
165":ref:`dev-manual/custom-distribution:creating your own distribution`".
166
101.. _migration-5.0-misc-changes: 167.. _migration-5.0-misc-changes:
102 168
103Miscellaneous changes 169Miscellaneous changes
104~~~~~~~~~~~~~~~~~~~~~ 170~~~~~~~~~~~~~~~~~~~~~
105 171
172- ``bitbake-whatchanged`` script was removed as it was broken and unmaintained.
173
174- ``scripts/sstate-cache-management.sh`` has been replaced by
175 ``scripts/sstate-cache-management.py``, a more performant Python-based version.
176
177- The ``bmap-tools`` recipe has been renamed to ``bmaptool``.
178
179- ``gpgme`` has had Python binding support disabled since upstream does not
180 support Python 3.12 yet. This will be fixed in future once it is fixed upstream.)
181
182- A warning will now be shown if the ``virtual/`` prefix is used in runtime
183 contexts (:term:`RDEPENDS` / :term:`RPROVIDES`) ---
184 See :ref:`virtual-slash <qa-check-virtual-slash>` for details.
185
186- ``recipetool`` now prefixes the names of recipes created for Python modules
187 with ``python3-``.
188
189- The :ref:`ref-classes-cve-check` class no longer produces a warning for
190 remote patches --- it only logs a note and does not try to fetch the patch
191 in order to scan it for issues or CVE numbers. However, CVE number
192 references in remote patch file names will now be picked up.
193
194- The values of :term:`PE` and :term:`PR` have been dropped from
195 ``-f{file,macro,debug}-prefix-map``, in order to avoid unnecessary churn
196 in debugging symbol paths when the version is bumped. This is unlikely to
197 cause issues, but if you are paying attention to the debugging source path
198 (e.g. in recipes that need to manipulate these files during packaging) then
199 you will notice the difference. A new :term:`TARGET_DBGSRC_DIR` variable is
200 provided to make this easier.
201
202- ``ccache`` no longer supports FORTRAN.
diff --git a/documentation/migration-guides/migration-5.1.rst b/documentation/migration-guides/migration-5.1.rst
new file mode 100644
index 0000000000..b43fecc2dd
--- /dev/null
+++ b/documentation/migration-guides/migration-5.1.rst
@@ -0,0 +1,143 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release 5.1 (styhead)
4=====================
5
6Migration notes for 5.1 (styhead)
7------------------------------------
8
9This section provides migration information for moving to the Yocto
10Project 5.1 Release (codename "styhead") from the prior release.
11
12.. _migration-5.1-supported-kernel-versions:
13
14:term:`WORKDIR` changes
15~~~~~~~~~~~~~~~~~~~~~~~
16
17S = ${WORKDIR} no longer supported
18^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
19
20If a recipe has :term:`S` set to be :term:`WORKDIR`, this is no longer
21supported, and an error will be issued. The recipe should be changed to::
22
23 S = "${WORKDIR}/sources"
24 UNPACKDIR = "${S}"
25
26Any :term:`WORKDIR` references where files from :term:`SRC_URI` are referenced
27should be changed to :term:`S`. These are commonly in :ref:`ref-tasks-compile`,
28:ref:`ref-tasks-compile`, :ref:`ref-tasks-install` and :term:`LIC_FILES_CHKSUM`.
29
30:term:`WORKDIR` references in recipes
31^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
32
33:term:`WORKDIR` references in other recipes need auditing. If they reference
34files from :term:`SRC_URI`, they likely need changing to :term:`UNPACKDIR`.
35These are commonly in :ref:`ref-tasks-compile` and :ref:`ref-tasks-install`
36for things like service or configuration files. One unusual case is
37``${WORKDIR}/${BP}`` which should probably be set to ``${S}``.
38
39References to ``../`` in :term:`LIC_FILES_CHKSUM` or elsewhere may need changing
40to :term:`UNPACKDIR`. References to :term:`WORKDIR` in ``sed`` commands are
41usually left as they are.
42
43General notes
44^^^^^^^^^^^^^
45
46Files from :ref:`ref-tasks-unpack` now unpack to ``WORKDIR/sources-unpack/``
47rather than ``WORKDIR/``.
48
49If :term:`S` is set to a subdirectory under :term:`WORKDIR` and that
50subdirectory exists in ``sources-unpack`` after :ref:`ref-tasks-unpack` runs,
51it is moved to :term:`WORKDIR`. This means that ``S = "${WORKDIR}/${BP}"``,
52``S = "${WORKDIR}/git"`` and also deeper paths continue to work as expected
53without changes. We cannot use symlinks to do this as it breaks autotools
54based recipes. Keeping all sources under ``sources-unpack`` wasn't considered
55as it meant more invasive recipes changes. The key objective was separating the
56:ref:`ref-tasks-unpack` task output from :term:`WORKDIR`.
57
58Previously, :term:`S` was always created but after the recent changes it is no
59longer the case. This means the check in ``do_unpack_qa`` triggers where
60:term:`S` is not created by a recipe while it didn't happen before. This can
61require to add an :term:`S` definition to a recipe that only uses
62``file://`` :term:`SRC_URI` entries. To be consistent, the following pattern is
63recommended::
64
65 S = "${WORKDIR}/sources"
66 UNPACKDIR = "${S}"
67
68Building C files from :term:`UNPACKDIR` without setting :term:`S` to point at
69it does not work as the debug prefix mapping doesn't handle that.
70
71``devtool`` and ``recipetool`` have been updated to handle this and their
72support for ``S = WORKDIR`` and ``oe-local-files`` has been removed.
73
74Supported kernel versions
75~~~~~~~~~~~~~~~~~~~~~~~~~
76
77The :term:`OLDEST_KERNEL` setting is still "5.15" in this release, meaning that
78out the box, older kernels are not supported. See :ref:`4.3 migration notes
79<migration-4.3-supported-kernel-versions>` for details.
80
81.. _migration-5.1-supported-distributions:
82
83Supported distributions
84~~~~~~~~~~~~~~~~~~~~~~~
85
86Compared to the previous releases, running BitBake is supported on new
87GNU/Linux distributions:
88
89On the other hand, some earlier distributions are no longer supported:
90
91See :ref:`all supported distributions <system-requirements-supported-distros>`.
92
93.. _migration-5.1-go-changes:
94
95Go language changes
96~~~~~~~~~~~~~~~~~~~
97
98.. _migration-5.1-systemd-changes:
99
100systemd changes
101~~~~~~~~~~~~~~~
102
103.. _migration-5.1-recipe-changes:
104
105Recipe changes
106~~~~~~~~~~~~~~
107
108.. _migration-5.1-deprecated-variables:
109
110Deprecated variables
111~~~~~~~~~~~~~~~~~~~~
112
113.. _migration-5.1-removed-variables:
114
115Removed variables
116~~~~~~~~~~~~~~~~~
117
118The following variables have been removed:
119
120.. _migration-5.1-removed-recipes:
121
122Removed recipes
123~~~~~~~~~~~~~~~
124
125The following recipes have been removed in this release:
126
127.. _migration-5.1-removed-classes:
128
129Removed classes
130~~~~~~~~~~~~~~~
131
132No classes have been removed in this release.
133
134.. _migration-5.1-qemu-changes:
135
136QEMU changes
137~~~~~~~~~~~~
138
139.. _migration-5.1-misc-changes:
140
141Miscellaneous changes
142~~~~~~~~~~~~~~~~~~~~~
143
diff --git a/documentation/migration-guides/release-4.0.rst b/documentation/migration-guides/release-4.0.rst
index 685799e268..d848b3ef64 100644
--- a/documentation/migration-guides/release-4.0.rst
+++ b/documentation/migration-guides/release-4.0.rst
@@ -24,3 +24,4 @@ Release 4.0 (kirkstone)
24 release-notes-4.0.15 24 release-notes-4.0.15
25 release-notes-4.0.16 25 release-notes-4.0.16
26 release-notes-4.0.17 26 release-notes-4.0.17
27 release-notes-4.0.18
diff --git a/documentation/migration-guides/release-4.3.rst b/documentation/migration-guides/release-4.3.rst
index fa5653c467..1f07d229a7 100644
--- a/documentation/migration-guides/release-4.3.rst
+++ b/documentation/migration-guides/release-4.3.rst
@@ -10,3 +10,4 @@ Release 4.3 (nanbield)
10 release-notes-4.3.1 10 release-notes-4.3.1
11 release-notes-4.3.2 11 release-notes-4.3.2
12 release-notes-4.3.3 12 release-notes-4.3.3
13 release-notes-4.3.4
diff --git a/documentation/migration-guides/release-5.0.rst b/documentation/migration-guides/release-5.0.rst
index bd19b707f6..44a02ab041 100644
--- a/documentation/migration-guides/release-5.0.rst
+++ b/documentation/migration-guides/release-5.0.rst
@@ -7,3 +7,4 @@ Release 5.0 (scarthgap)
7 7
8 migration-5.0 8 migration-5.0
9 release-notes-5.0 9 release-notes-5.0
10 release-notes-5.0.1
diff --git a/documentation/migration-guides/release-5.1.rst b/documentation/migration-guides/release-5.1.rst
new file mode 100644
index 0000000000..768edfa2b0
--- /dev/null
+++ b/documentation/migration-guides/release-5.1.rst
@@ -0,0 +1,9 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release 5.1 (styhead)
4=======================
5
6.. toctree::
7
8 migration-5.1
9 release-notes-5.1
diff --git a/documentation/migration-guides/release-notes-4.0.17.rst b/documentation/migration-guides/release-notes-4.0.17.rst
index 1dfd10ce20..07242584b8 100644
--- a/documentation/migration-guides/release-notes-4.0.17.rst
+++ b/documentation/migration-guides/release-notes-4.0.17.rst
@@ -6,7 +6,7 @@ Release notes for Yocto-4.0.17 (Kirkstone)
6Security Fixes in Yocto-4.0.17 6Security Fixes in Yocto-4.0.17
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 8
9- bind: Fix :cve:`2023-4408`, :cve:`2023-50387`, :cve:`2023-50868`, :cve:`2023-5517` and :cve:`2023-5679` 9- bind: Fix :cve:`2023-4408`, :cve:`2023-5517`, :cve:`2023-5679`, :cve:`2023-50868` and :cve:`2023-50387`
10- binutils: Fix :cve:`2023-39129` and :cve:`2023-39130` 10- binutils: Fix :cve:`2023-39129` and :cve:`2023-39130`
11- curl: Fix :cve:`2023-46219` 11- curl: Fix :cve:`2023-46219`
12- curl: Ignore :cve:`2023-42915` 12- curl: Ignore :cve:`2023-42915`
@@ -18,13 +18,13 @@ Security Fixes in Yocto-4.0.17
18- libgit2: Fix :cve:`2024-24575` and :cve:`2024-24577` 18- libgit2: Fix :cve:`2024-24575` and :cve:`2024-24577`
19- libuv: fix :cve:`2024-24806` 19- libuv: fix :cve:`2024-24806`
20- libxml2: Fix for :cve:`2024-25062` 20- libxml2: Fix for :cve:`2024-25062`
21- linux-yocto/5.15: Fix :cve:`2022-36402`, :cve:`2022-40982`, :cve:`2022-47940`, :cve:`2023-1193`, :cve:`2023-1194`, :cve:`2023-20569`, :cve:`2023-20588`, :cve:`2023-25775`, :cve:`2023-31085`, :cve:`2023-32247`, :cve:`2023-32250`, :cve:`2023-32252`, :cve:`2023-32254`, :cve:`2023-32257`, :cve:`2023-32258`, :cve:`2023-34324`, :cve:`2023-35827`, :cve:`2023-3772`, :cve:`2023-38427`, :cve:`2023-38430`, :cve:`2023-38431`, :cve_mitre:`2023-3867`, :cve:`2023-39189`, :cve:`2023-39192`, :cve:`2023-39193`, :cve:`2023-39194`, :cve:`2023-39198`, :cve:`2023-40283`, :cve:`2023-4128`, :cve:`2023-4206`, :cve:`2023-4207`, :cve:`2023-4208`, :cve:`2023-4244`, :cve:`2023-4273`, :cve:`2023-42752`, :cve:`2023-42753`, :cve:`2023-42754`, :cve:`2023-42755`, :cve:`2023-4563`, :cve:`2023-4569`, :cve:`2023-45871`, :cve:`2023-4623`, :cve:`2023-46343`, :cve:`2023-46813`, :cve:`2023-46838`, :cve:`2023-46862`, :cve:`2023-4881`, :cve:`2023-4921`, :cve:`2023-51042`, :cve:`2023-5158`, :cve:`2023-51779`, :cve_mitre:`2023-52340`, :cve:`2023-52429`, :cve:`2023-52435`, :cve:`2023-52436`, :cve:`2023-52438`, :cve:`2023-52439`, :cve:`2023-52441`, :cve:`2023-52442`, :cve:`2023-52443`, :cve:`2023-52444`, :cve:`2023-52445`, :cve:`2023-52448`, :cve:`2023-52449`, :cve:`2023-52451`, :cve:`2023-52454`, :cve:`2023-52456`, :cve:`2023-52457`, :cve:`2023-52458`, :cve:`2023-52463`, :cve:`2023-52464`, :cve:`2023-5717`, :cve:`2023-6040`, :cve:`2023-6121`, :cve:`2023-6176`, :cve:`2023-6546`, :cve:`2023-6606`, :cve:`2023-6622`, :cve:`2023-6817`, :cve:`2023-6915`, :cve:`2023-6931`, :cve:`2023-6932`, :cve:`2024-0340`, :cve:`2024-0584`, :cve:`2024-0607`, :cve:`2024-0641`, :cve:`2024-0646`, :cve:`2024-1085`, :cve:`2024-1086`, :cve:`2024-1151`, :cve:`2024-22705`, :cve:`2024-23849`, :cve:`2024-23850`, :cve:`2024-23851`, :cve:`2024-24860`, :cve:`2024-26586`, :cve:`2024-26589`, :cve:`2024-26591`, :cve:`2024-26592`, :cve:`2024-26593`, :cve:`2024-26594`, :cve:`2024-26597` and :cve:`2024-26598` 21- linux-yocto/5.15: Fix :cve:`2022-36402`, :cve:`2022-40982`, :cve:`2022-47940`, :cve:`2023-1193`, :cve:`2023-1194`, :cve:`2023-3772`, :cve_mitre:`2023-3867`, :cve:`2023-4128`, :cve:`2023-4206`, :cve:`2023-4207`, :cve:`2023-4208`, :cve:`2023-4244`, :cve:`2023-4273`, :cve:`2023-4563`, :cve:`2023-4569`, :cve:`2023-4623`, :cve:`2023-4881`, :cve:`2023-4921`, :cve:`2023-5158`, :cve:`2023-5717`, :cve:`2023-6040`, :cve:`2023-6121`, :cve:`2023-6176`, :cve:`2023-6546`, :cve:`2023-6606`, :cve:`2023-6622`, :cve:`2023-6817`, :cve:`2023-6915`, :cve:`2023-6931`, :cve:`2023-6932`, :cve:`2023-20569`, :cve:`2023-20588`, :cve:`2023-25775`, :cve:`2023-31085`, :cve:`2023-32247`, :cve:`2023-32250`, :cve:`2023-32252`, :cve:`2023-32254`, :cve:`2023-32257`, :cve:`2023-32258`, :cve:`2023-34324`, :cve:`2023-35827`, :cve:`2023-38427`, :cve:`2023-38430`, :cve:`2023-38431`, :cve:`2023-39189`, :cve:`2023-39192`, :cve:`2023-39193`, :cve:`2023-39194`, :cve:`2023-39198`, :cve:`2023-40283`, :cve:`2023-42752`, :cve:`2023-42753`, :cve:`2023-42754`, :cve:`2023-42755`, :cve:`2023-45871`, :cve:`2023-46343`, :cve:`2023-46813`, :cve:`2023-46838`, :cve:`2023-46862`, :cve:`2023-51042`, :cve:`2023-51779`, :cve_mitre:`2023-52340`, :cve:`2023-52429`, :cve:`2023-52435`, :cve:`2023-52436`, :cve:`2023-52438`, :cve:`2023-52439`, :cve:`2023-52441`, :cve:`2023-52442`, :cve:`2023-52443`, :cve:`2023-52444`, :cve:`2023-52445`, :cve:`2023-52448`, :cve:`2023-52449`, :cve:`2023-52451`, :cve:`2023-52454`, :cve:`2023-52456`, :cve:`2023-52457`, :cve:`2023-52458`, :cve:`2023-52463`, :cve:`2023-52464`, :cve:`2024-0340`, :cve:`2024-0584`, :cve:`2024-0607`, :cve:`2024-0641`, :cve:`2024-0646`, :cve:`2024-1085`, :cve:`2024-1086`, :cve:`2024-1151`, :cve:`2024-22705`, :cve:`2024-23849`, :cve:`2024-23850`, :cve:`2024-23851`, :cve:`2024-24860`, :cve:`2024-26586`, :cve:`2024-26589`, :cve:`2024-26591`, :cve:`2024-26592`, :cve:`2024-26593`, :cve:`2024-26594`, :cve:`2024-26597` and :cve:`2024-26598`
22- linux-yocto/5.15: Ignore :cve:`2020-27418`, :cve:`2020-36766`, :cve:`2021-33630`, :cve:`2021-33631`, :cve:`2022-48619`, :cve:`2023-2430`, :cve:`2023-40791`, :cve:`2023-42756`, :cve:`2023-44466`, :cve:`2023-45862`, :cve:`2023-45863`, :cve:`2023-45898`, :cve:`2023-4610`, :cve:`2023-4732`, :cve:`2023-5090`, :cve:`2023-51043`, :cve:`2023-5178`, :cve:`2023-51780`, :cve:`2023-51781`, :cve:`2023-51782`, :cve:`2023-5197`, :cve:`2023-52433`, :cve:`2023-52440`, :cve:`2023-52446`, :cve:`2023-52450`, :cve:`2023-52453`, :cve:`2023-52455`, :cve:`2023-52459`, :cve:`2023-52460`, :cve:`2023-52461`, :cve:`2023-52462`, :cve:`2023-5345`, :cve:`2023-5633`, :cve:`2023-5972`, :cve:`2023-6111`, :cve:`2023-6200`, :cve:`2023-6531`, :cve:`2023-6679`, :cve:`2023-7192`, :cve:`2024-0193`, :cve:`2024-0443`, :cve:`2024-0562`, :cve:`2024-0582`, :cve:`2024-0639`, :cve:`2024-0775`, :cve:`2024-26581`, :cve:`2024-26582`, :cve:`2024-26590`, :cve:`2024-26596` and :cve:`2024-26599` 22- linux-yocto/5.15: Ignore :cve:`2020-27418`, :cve:`2020-36766`, :cve:`2021-33630`, :cve:`2021-33631`, :cve:`2022-48619`, :cve:`2023-2430`, :cve:`2023-4610`, :cve:`2023-4732`, :cve:`2023-5090`, :cve:`2023-5178`, :cve:`2023-5197`, :cve:`2023-5345`, :cve:`2023-5633`, :cve:`2023-5972`, :cve:`2023-6111`, :cve:`2023-6200`, :cve:`2023-6531`, :cve:`2023-6679`, :cve:`2023-7192`, :cve:`2023-40791`, :cve:`2023-42756`, :cve:`2023-44466`, :cve:`2023-45862`, :cve:`2023-45863`, :cve:`2023-45898`, :cve:`2023-51043`, :cve:`2023-51780`, :cve:`2023-51781`, :cve:`2023-51782`, :cve:`2023-52433`, :cve:`2023-52440`, :cve:`2023-52446`, :cve:`2023-52450`, :cve:`2023-52453`, :cve:`2023-52455`, :cve:`2023-52459`, :cve:`2023-52460`, :cve:`2023-52461`, :cve:`2023-52462`, :cve:`2024-0193`, :cve:`2024-0443`, :cve:`2024-0562`, :cve:`2024-0582`, :cve:`2024-0639`, :cve:`2024-0775`, :cve:`2024-26581`, :cve:`2024-26582`, :cve:`2024-26590`, :cve:`2024-26596` and :cve:`2024-26599`
23- linux-yocto/5.10: Fix :cve:`2023-39198`, :cve:`2023-46838`, :cve:`2023-51779`, :cve:`2023-51780`, :cve:`2023-51781`, :cve:`2023-51782`, :cve_mitre:`2023-52340`, :cve:`2023-6040`, :cve:`2023-6121`, :cve:`2023-6606`, :cve:`2023-6817`, :cve:`2023-6915`, :cve:`2023-6931`, :cve:`2023-6932`, :cve:`2024-0584` and :cve:`2024-0646` 23- linux-yocto/5.10: Fix :cve:`2023-6040`, :cve:`2023-6121`, :cve:`2023-6606`, :cve:`2023-6817`, :cve:`2023-6915`, :cve:`2023-6931`, :cve:`2023-6932`, :cve:`2023-39198`, :cve:`2023-46838`, :cve:`2023-51779`, :cve:`2023-51780`, :cve:`2023-51781`, :cve:`2023-51782`, :cve_mitre:`2023-52340`, :cve:`2024-0584` and :cve:`2024-0646`
24- linux-yocto/5.10: Ignore :cve:`2021-33630`, :cve:`2021-33631`, :cve:`2022-1508`, :cve:`2022-36402`, :cve:`2022-48619`, :cve:`2023-2430`, :cve:`2023-4610`, :cve:`2023-46343`, :cve:`2023-51042`, :cve:`2023-51043`, :cve:`2023-5972`, :cve:`2023-6039`, :cve:`2023-6200`, :cve:`2023-6531`, :cve:`2023-6546`, :cve:`2023-6622`, :cve:`2023-6679`, :cve:`2023-7192`, :cve:`2024-0193`, :cve:`2024-0443`, :cve:`2024-0562`, :cve:`2024-0582`, :cve:`2024-0639`, :cve:`2024-0641`, :cve:`2024-0775`, :cve:`2024-1085` and :cve:`2024-22705` 24- linux-yocto/5.10: Ignore :cve:`2021-33630`, :cve:`2021-33631`, :cve:`2022-1508`, :cve:`2022-36402`, :cve:`2022-48619`, :cve:`2023-2430`, :cve:`2023-4610`, :cve:`2023-5972`, :cve:`2023-6039`, :cve:`2023-6200`, :cve:`2023-6531`, :cve:`2023-6546`, :cve:`2023-6622`, :cve:`2023-6679`, :cve:`2023-7192`, :cve:`2023-46343`, :cve:`2023-51042`, :cve:`2023-51043`, :cve:`2024-0193`, :cve:`2024-0443`, :cve:`2024-0562`, :cve:`2024-0582`, :cve:`2024-0639`, :cve:`2024-0641`, :cve:`2024-0775`, :cve:`2024-1085` and :cve:`2024-22705`
25- openssl: Fix :cve:`2024-0727` 25- openssl: Fix :cve:`2024-0727`
26- python3-pycryptodome: Fix :cve:`2023-52323` 26- python3-pycryptodome: Fix :cve:`2023-52323`
27- qemu: Fix :cve:`2023-42467`, :cve:`2023-6693` and :cve:`2024-24474` 27- qemu: Fix :cve:`2023-6693`, :cve:`2023-42467` and :cve:`2024-24474`
28- vim: Fix :cve:`2024-22667` 28- vim: Fix :cve:`2024-22667`
29- xwayland: Fix :cve:`2023-6377` and :cve:`2023-6478` 29- xwayland: Fix :cve:`2023-6377` and :cve:`2023-6478`
30 30
diff --git a/documentation/migration-guides/release-notes-4.0.18.rst b/documentation/migration-guides/release-notes-4.0.18.rst
new file mode 100644
index 0000000000..d5a2a7f6ce
--- /dev/null
+++ b/documentation/migration-guides/release-notes-4.0.18.rst
@@ -0,0 +1,191 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release notes for Yocto-4.0.18 (Kirkstone)
4------------------------------------------
5
6Security Fixes in Yocto-4.0.18
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8
9- curl: Fix :cve:`2024-2398`
10- expat: fix :cve:`2023-52426` and :cve:`2024-28757`
11- libssh2: fix :cve:`2023-48795`
12- ncurses: Fix :cve:`2023-50495`
13- nghttp2: Fix :cve:`2024-28182` and :cve:`2023-44487`
14- openssh: Ignore :cve:`2023-51767`
15- openssl: Fix :cve:`2024-2511`
16- perl: Ignore :cve:`2023-47100`
17- python3-cryptography: Fix :cve:`2024-26130`
18- python3-urllib3: Fix :cve:`2023-45803`
19- qemu: Fix :cve:`2023-6683`
20- ruby: fix :cve_mitre:`2024-27281`
21- rust: Ignore :cve:`2024-24576`
22- tiff: Fix :cve:`2023-52356` and :cve:`2023-6277`
23- xserver-xorg: Fix :cve:`2024-31080` and :cve:`2024-31081`
24- xwayland: Fix :cve:`2023-6816`, :cve:`2024-0408` and :cve:`2024-0409`
25
26
27Fixes in Yocto-4.0.18
28~~~~~~~~~~~~~~~~~~~~~
29
30- build-appliance-image: Update to kirkstone head revision
31- common-licenses: backport LGPL-3.0-with-zeromq-exception license
32- contributor-guide: add notes for tests
33- contributor-guide: be more specific about meta-* trees
34- cups: fix typo in :cve:`2023-32360` backport patch
35- cve-update-nvd2-native: Add an age threshold for incremental update
36- cve-update-nvd2-native: Fix CVE configuration update
37- cve-update-nvd2-native: Fix typo in comment
38- cve-update-nvd2-native: Remove duplicated CVE_CHECK_DB_FILE definition
39- cve-update-nvd2-native: Remove rejected CVE from database
40- cve-update-nvd2-native: nvd_request_next: Improve comment
41- dev-manual: improve descriptions of 'bitbake -S printdiff'
42- dev-manual: packages: fix capitalization
43- docs: conf.py: properly escape backslashes for latex_elements
44- gcc: Backport sanitizer fix for 32-bit ALSR
45- glibc: Fix subscript typos for get_nscd_addresses
46- kernel-dev: join mkdir commands with -p
47- linux-firmware: Upgrade to 20240220
48- manuals: add initial sphinx-lint support
49- manuals: add initial stylechecks with Vale
50- manuals: document VIRTUAL-RUNTIME variables
51- manuals: fix duplicate "stylecheck" target
52- manuals: fix incorrect double backticks
53- manuals: fix trailing spaces
54- manuals: refer to new yocto-patches mailing list wherever appropriate
55- manuals: remove tab characters
56- manuals: replace hyphens with em dashes
57- manuals: use "manual page(s)"
58- migration-guides: add release notes for 4.0.17
59- poky.conf: bump version for 4.0.18
60- profile-manual: usage.rst: fix reference to bug report
61- profile-manual: usage.rst: formatting fixes
62- profile-manual: usage.rst: further style improvements
63- python3-urllib3: Upgrade to v1.26.18
64- ref-manual: add documentation of the variable :term:`SPDX_NAMESPACE_PREFIX`
65- ref-manual: tasks: do_cleanall: recommend using '-f' instead
66- ref-manual: tasks: do_cleansstate: recommend using '-f' instead for a shared sstate
67- ref-manual: variables: adding multiple groups in :term:`GROUPADD_PARAM`
68- ref-manual: variables: correct sdk installation default path
69- stress-ng: avoid calling sync during do_compile
70- systemd: Fix vlan qos mapping
71- tcl: Add a way to skip ptests
72- tcl: skip async and event tests in run-ptest
73- tcl: skip timing-dependent tests in run-ptest
74- valgrind: skip intermittently failing ptest
75- wireless-regdb: Upgrade to 2024.01.23
76- yocto-uninative: Update to 4.4 for glibc 2.39
77
78
79Known Issues in Yocto-4.0.18
80~~~~~~~~~~~~~~~~~~~~~~~~~~~~
81
82- N/A
83
84
85Contributors to Yocto-4.0.18
86~~~~~~~~~~~~~~~~~~~~~~~~~~~~
87
88- Alex Kiernan
89- Alex Stewart
90- Alexander Kanavin
91- BELOUARGA Mohamed
92- Claus Stovgaard
93- Colin McAllister
94- Geoff Parker
95- Haitao Liu
96- Harish Sadineni
97- Johan Bezem
98- Jonathan GUILLOT
99- Jörg Sommer
100- Khem Raj
101- Lee Chee Yang
102- Luca Ceresoli
103- Martin Jansa
104- Meenali Gupta
105- Michael Halstead
106- Michael Opdenacker
107- Peter Marko
108- Quentin Schulz
109- Ross Burton
110- Sana Kazi
111- Simone Weiß
112- Soumya Sambu
113- Steve Sakoman
114- Tan Wen Yan
115- Vijay Anusuri
116- Wang Mingyu
117- Yoann Congal
118- Yogita Urade
119- Zahir Hussain
120
121
122Repositories / Downloads for Yocto-4.0.18
123~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
124
125poky
126
127- Repository Location: :yocto_git:`/poky`
128- Branch: :yocto_git:`kirkstone </poky/log/?h=kirkstone>`
129- Tag: :yocto_git:`yocto-4.0.18 </poky/log/?h=yocto-4.0.18>`
130- Git Revision: :yocto_git:`31751bba1c789f15f574773a659b8017d7bcf440 </poky/commit/?id=31751bba1c789f15f574773a659b8017d7bcf440>`
131- Release Artefact: poky-31751bba1c789f15f574773a659b8017d7bcf440
132- sha: 72d5aa65c3c37766ebc24b212740272c1d52342468548f9c070241d3522ad2ca
133- Download Locations:
134 http://downloads.yoctoproject.org/releases/yocto/yocto-4.0.18/poky-31751bba1c789f15f574773a659b8017d7bcf440.tar.bz2
135 http://mirrors.kernel.org/yocto/yocto/yocto-4.0.18/poky-31751bba1c789f15f574773a659b8017d7bcf440.tar.bz2
136
137openembedded-core
138
139- Repository Location: :oe_git:`/openembedded-core`
140- Branch: :oe_git:`kirkstone </openembedded-core/log/?h=kirkstone>`
141- Tag: :oe_git:`yocto-4.0.18 </openembedded-core/log/?h=yocto-4.0.18>`
142- Git Revision: :oe_git:`b7182571242dc4e23e5250a449d90348e62a6abc </openembedded-core/commit/?id=b7182571242dc4e23e5250a449d90348e62a6abc>`
143- Release Artefact: oecore-b7182571242dc4e23e5250a449d90348e62a6abc
144- sha: 6f257e50c10ebae673dcf61a833b3270db6d22781f02f6794a370aac839f1020
145- Download Locations:
146 http://downloads.yoctoproject.org/releases/yocto/yocto-4.0.18/oecore-b7182571242dc4e23e5250a449d90348e62a6abc.tar.bz2
147 http://mirrors.kernel.org/yocto/yocto/yocto-4.0.18/oecore-b7182571242dc4e23e5250a449d90348e62a6abc.tar.bz2
148
149meta-mingw
150
151- Repository Location: :yocto_git:`/meta-mingw`
152- Branch: :yocto_git:`kirkstone </meta-mingw/log/?h=kirkstone>`
153- Tag: :yocto_git:`yocto-4.0.18 </meta-mingw/log/?h=yocto-4.0.18>`
154- Git Revision: :yocto_git:`f6b38ce3c90e1600d41c2ebb41e152936a0357d7 </meta-mingw/commit/?id=f6b38ce3c90e1600d41c2ebb41e152936a0357d7>`
155- Release Artefact: meta-mingw-f6b38ce3c90e1600d41c2ebb41e152936a0357d7
156- sha: 7d57167c19077f4ab95623d55a24c2267a3a3fb5ed83688659b4c03586373b25
157- Download Locations:
158 http://downloads.yoctoproject.org/releases/yocto/yocto-4.0.18/meta-mingw-f6b38ce3c90e1600d41c2ebb41e152936a0357d7.tar.bz2
159 http://mirrors.kernel.org/yocto/yocto/yocto-4.0.18/meta-mingw-f6b38ce3c90e1600d41c2ebb41e152936a0357d7.tar.bz2
160
161meta-gplv2
162
163- Repository Location: :yocto_git:`/meta-gplv2`
164- Branch: :yocto_git:`kirkstone </meta-gplv2/log/?h=kirkstone>`
165- Tag: :yocto_git:`yocto-4.0.18 </meta-gplv2/log/?h=yocto-4.0.18>`
166- Git Revision: :yocto_git:`d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a </meta-gplv2/commit/?id=d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a>`
167- Release Artefact: meta-gplv2-d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a
168- sha: c386f59f8a672747dc3d0be1d4234b6039273d0e57933eb87caa20f56b9cca6d
169- Download Locations:
170 http://downloads.yoctoproject.org/releases/yocto/yocto-4.0.18/meta-gplv2-d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a.tar.bz2
171 http://mirrors.kernel.org/yocto/yocto/yocto-4.0.18/meta-gplv2-d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a.tar.bz2
172
173bitbake
174
175- Repository Location: :oe_git:`/bitbake`
176- Branch: :oe_git:`2.0 </bitbake/log/?h=2.0>`
177- Tag: :oe_git:`yocto-4.0.18 </bitbake/log/?h=yocto-4.0.18>`
178- Git Revision: :oe_git:`40fd5f4eef7460ca67f32cfce8e229e67e1ff607 </bitbake/commit/?id=40fd5f4eef7460ca67f32cfce8e229e67e1ff607>`
179- Release Artefact: bitbake-40fd5f4eef7460ca67f32cfce8e229e67e1ff607
180- sha: 5d20a0e4c5d0fce44bd84778168714a261a30a4b83f67c88df3b8a7e7115e444
181- Download Locations:
182 http://downloads.yoctoproject.org/releases/yocto/yocto-4.0.18/bitbake-40fd5f4eef7460ca67f32cfce8e229e67e1ff607.tar.bz2
183 http://mirrors.kernel.org/yocto/yocto/yocto-4.0.18/bitbake-40fd5f4eef7460ca67f32cfce8e229e67e1ff607.tar.bz2
184
185yocto-docs
186
187- Repository Location: :yocto_git:`/yocto-docs`
188- Branch: :yocto_git:`kirkstone </yocto-docs/log/?h=kirkstone>`
189- Tag: :yocto_git:`yocto-4.0.18 </yocto-docs/log/?h=yocto-4.0.18>`
190- Git Revision: :yocto_git:`fd1423141e7458ba557db465c171b0b4e9063987 </yocto-docs/commit/?id=fd1423141e7458ba557db465c171b0b4e9063987>`
191
diff --git a/documentation/migration-guides/release-notes-4.0.4.rst b/documentation/migration-guides/release-notes-4.0.4.rst
index 611109a77e..1d6e525bbc 100644
--- a/documentation/migration-guides/release-notes-4.0.4.rst
+++ b/documentation/migration-guides/release-notes-4.0.4.rst
@@ -247,7 +247,7 @@ poky
247 247
248openembedded-core 248openembedded-core
249 249
250- Repository Location: oe_git:`/openembedded-core` 250- Repository Location: :oe_git:`/openembedded-core`
251- Branch: :oe_git:`kirkstone </openembedded-core/log/?h=kirkstone>` 251- Branch: :oe_git:`kirkstone </openembedded-core/log/?h=kirkstone>`
252- Tag: :oe_git:`yocto-4.0.4 </openembedded-core/log/?h=yocto-4.0.4>` 252- Tag: :oe_git:`yocto-4.0.4 </openembedded-core/log/?h=yocto-4.0.4>`
253- Git Revision: :oe_git:`f7766da462905ec67bf549d46b8017be36cd5b2a </openembedded-core/commit/?id=f7766da462905ec67bf549d46b8017be36cd5b2a>` 253- Git Revision: :oe_git:`f7766da462905ec67bf549d46b8017be36cd5b2a </openembedded-core/commit/?id=f7766da462905ec67bf549d46b8017be36cd5b2a>`
diff --git a/documentation/migration-guides/release-notes-4.0.5.rst b/documentation/migration-guides/release-notes-4.0.5.rst
index 172b8b800d..cdfe85b750 100644
--- a/documentation/migration-guides/release-notes-4.0.5.rst
+++ b/documentation/migration-guides/release-notes-4.0.5.rst
@@ -83,7 +83,7 @@ Fixes in Yocto-4.0.5
83Known Issues in Yocto-4.0.5 83Known Issues in Yocto-4.0.5
84~~~~~~~~~~~~~~~~~~~~~~~~~~~ 84~~~~~~~~~~~~~~~~~~~~~~~~~~~
85 85
86- There are recent CVEs in key components such as openssl. They are not included in this release as it was built before the issues were known and fixes were available but these are now available on the kirkstone branch. 86- There are recent CVEs in key components such as openssl. They are not included in this release as it was built before the issues were known and fixes were available but these are now available on the kirkstone branch.
87 87
88 88
89Contributors to Yocto-4.0.5 89Contributors to Yocto-4.0.5
diff --git a/documentation/migration-guides/release-notes-4.0.rst b/documentation/migration-guides/release-notes-4.0.rst
index 6eb5f807de..a5d66c0410 100644
--- a/documentation/migration-guides/release-notes-4.0.rst
+++ b/documentation/migration-guides/release-notes-4.0.rst
@@ -38,7 +38,7 @@ New Features / Enhancements in 4.0
38 38
39- Inclusive language adjustments to some variable names - see the 39- Inclusive language adjustments to some variable names - see the
40 :ref:`4.0 migration guide <migration-4.0-inclusive-language>` for details. 40 :ref:`4.0 migration guide <migration-4.0-inclusive-language>` for details.
41 41
42- New recipes: 42- New recipes:
43 43
44 - ``buildtools-docs-tarball`` 44 - ``buildtools-docs-tarball``
@@ -114,7 +114,7 @@ New Features / Enhancements in 4.0
114- BitBake enhancements: 114- BitBake enhancements:
115 115
116 - Fetcher enhancements: 116 - Fetcher enhancements:
117 117
118 - New :ref:`bitbake-user-manual/bitbake-user-manual-fetching:crate fetcher (\`\`crate://\`\`)` for Rust packages 118 - New :ref:`bitbake-user-manual/bitbake-user-manual-fetching:crate fetcher (\`\`crate://\`\`)` for Rust packages
119 - Added striplevel support to unpack 119 - Added striplevel support to unpack
120 - git: Add a warning asking users to set a branch in git urls 120 - git: Add a warning asking users to set a branch in git urls
@@ -127,7 +127,7 @@ New Features / Enhancements in 4.0
127 - ssh: now supports checkstatus, allows : in URLs (both required for use with sstate) and no longer requires username 127 - ssh: now supports checkstatus, allows : in URLs (both required for use with sstate) and no longer requires username
128 - wget: add redirectauth parameter 128 - wget: add redirectauth parameter
129 - wget: add 30s timeout for checkstatus calls 129 - wget: add 30s timeout for checkstatus calls
130 130
131 - Show warnings for append/prepend/remove operators combined with +=/.= 131 - Show warnings for append/prepend/remove operators combined with +=/.=
132 - Add bb.warnonce() and bb.erroronce() log methods 132 - Add bb.warnonce() and bb.erroronce() log methods
133 - Improved setscene task display 133 - Improved setscene task display
@@ -140,7 +140,7 @@ New Features / Enhancements in 4.0
140- Architecture-specific enhancements: 140- Architecture-specific enhancements:
141 141
142 - ARM: 142 - ARM:
143 143
144 - tune-cortexa72: Enable the crc extension by default for cortexa72 144 - tune-cortexa72: Enable the crc extension by default for cortexa72
145 - qemuarm64: Add tiny ktype to qemuarm64 bsp 145 - qemuarm64: Add tiny ktype to qemuarm64 bsp
146 - armv9a/tune: Add the support for the Neoverse N2 core 146 - armv9a/tune: Add the support for the Neoverse N2 core
@@ -163,7 +163,7 @@ New Features / Enhancements in 4.0
163 - linux-yocto-dev: add qemuriscv32 163 - linux-yocto-dev: add qemuriscv32
164 - packagegroup-core-tools-profile: Enable systemtap for riscv64 164 - packagegroup-core-tools-profile: Enable systemtap for riscv64
165 - qemuriscv: Use virtio-tablet-pci for mouse 165 - qemuriscv: Use virtio-tablet-pci for mouse
166 166
167 - x86: 167 - x86:
168 168
169 - kernel-yocto: conditionally enable stack protection checking on x86-64 169 - kernel-yocto: conditionally enable stack protection checking on x86-64
@@ -199,7 +199,7 @@ New Features / Enhancements in 4.0
199- yocto-check-layer: improved README checks 199- yocto-check-layer: improved README checks
200- cve-check: add json output format 200- cve-check: add json output format
201- cve-check: add coverage statistics on recipes with/without CVEs 201- cve-check: add coverage statistics on recipes with/without CVEs
202- Added mirrors for kernel sources and uninative binaries on kernel.org 202- Added mirrors for kernel sources and uninative binaries on kernel.org
203- glibc and binutils recipes now use shallow mirror tarballs for faster fetching 203- glibc and binutils recipes now use shallow mirror tarballs for faster fetching
204- When patching fails, show more information on the fatal error 204- When patching fails, show more information on the fatal error
205 205
@@ -234,7 +234,7 @@ New Features / Enhancements in 4.0
234 - Detect more known licenses in Python code 234 - Detect more known licenses in Python code
235 - Move license md5sums data into CSV files 235 - Move license md5sums data into CSV files
236 - npm: Use README as license fallback 236 - npm: Use README as license fallback
237 237
238- SDK-related enhancements: 238- SDK-related enhancements:
239 239
240 - Extended recipes to :ref:`ref-classes-nativesdk`: ``cargo``, 240 - Extended recipes to :ref:`ref-classes-nativesdk`: ``cargo``,
@@ -244,7 +244,7 @@ New Features / Enhancements in 4.0
244 - Support creating per-toolchain cmake file in SDK 244 - Support creating per-toolchain cmake file in SDK
245 245
246- Rust enhancements: 246- Rust enhancements:
247 247
248 - New python_setuptools3_rust class to enable building python extensions in Rust 248 - New python_setuptools3_rust class to enable building python extensions in Rust
249 - classes/meson: Add optional rust definitions 249 - classes/meson: Add optional rust definitions
250 250
diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst
index 653602f152..30049b89f6 100644
--- a/documentation/migration-guides/release-notes-4.2.rst
+++ b/documentation/migration-guides/release-notes-4.2.rst
@@ -35,7 +35,7 @@ New Features / Enhancements in 4.2
35 35
36 - BitBake's UI will now ping the server regularly to ensure 36 - BitBake's UI will now ping the server regularly to ensure
37 it is still alive. 37 it is still alive.
38 38
39- New variables: 39- New variables:
40 40
41 - :term:`VOLATILE_TMP_DIR` allows to specify 41 - :term:`VOLATILE_TMP_DIR` allows to specify
@@ -288,7 +288,7 @@ New Features / Enhancements in 4.2
288 BitBake manual. All variables should be easy to access through the Yocto 288 BitBake manual. All variables should be easy to access through the Yocto
289 Manual variable index. 289 Manual variable index.
290 - Expanded the description of the :term:`BB_NUMBER_THREADS` variable. 290 - Expanded the description of the :term:`BB_NUMBER_THREADS` variable.
291 291
292- Miscellaneous changes: 292- Miscellaneous changes:
293 293
294 - Supporting 64 bit dates on 32 bit platforms: several packages have been 294 - Supporting 64 bit dates on 32 bit platforms: several packages have been
diff --git a/documentation/migration-guides/release-notes-4.3.4.rst b/documentation/migration-guides/release-notes-4.3.4.rst
new file mode 100644
index 0000000000..4c9e67f2cb
--- /dev/null
+++ b/documentation/migration-guides/release-notes-4.3.4.rst
@@ -0,0 +1,206 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release notes for Yocto-4.3.4 (Nanbield)
4----------------------------------------
5
6Security Fixes in Yocto-4.3.4
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8
9- bind: Fix :cve:`2023-4408`, :cve:`2023-5517`, :cve:`2023-5679` and :cve:`2023-50387`
10- gcc: Update :term:`CVE_STATUS` for :cve:`2023-4039` as fixed
11- glibc: Fix :cve:`2023-6246`, :cve:`2023-6779` and :cve:`2023-6780`
12- gnutls: Fix :cve:`2024-0553` and :cve:`2024-0567`
13- gstreamer: Fix :cve_mitre:`2024-0444`
14- libssh2: fix :cve:`2023-48795`
15- libxml2: Fix :cve:`2024-25062`
16- linux-yocto/6.1: Fix :cve:`2023-6610`, :cve:`2023-6915`, :cve:`2023-46838`, :cve:`2023-50431`, :cve:`2024-1085`, :cve:`2024-1086` and :cve:`2024-23849`
17- linux-yocto/6.1: Ignore :cve:`2021-33630`, :cve:`2021-33631`, :cve:`2022-36402`, :cve:`2023-5717`, :cve:`2023-6200`, :cve:`2023-35827`, :cve:`2023-40791`, :cve:`2023-46343`, :cve:`2023-46813`, :cve:`2023-46862`, :cve:`2023-51042`, :cve:`2023-51043`, :cve_mitre:`2023-52340`, :cve:`2024-0562`, :cve:`2024-0565`, :cve:`2024-0582`, :cve:`2024-0584`, :cve:`2024-0607`, :cve:`2024-0639`, :cve:`2024-0641`, :cve:`2024-0646`, :cve:`2024-0775` and :cve:`2024-22705`
18- openssl: fix :cve:`2024-0727`
19- python3-jinja2: Fix :cve:`2024-22195`
20- tiff: Fix :cve:`2023-6228`, :cve:`2023-52355` and :cve:`2023-52356`
21- vim: Fix :cve:`2024-22667`
22- wpa-supplicant: Fix :cve:`2023-52160`
23- xserver-xorg: Fix :cve:`2023-6377`, :cve:`2023-6478`, :cve:`2023-6816`, :cve:`2024-0229`, :cve:`2024-0408`, :cve:`2024-0409`, :cve:`2024-21885` and :cve:`2024-21886`
24- xwayland: Fix :cve:`2023-6816`, :cve:`2024-0408` and :cve:`2024-0409`
25- zlib: Ignore :cve:`2023-6992`
26
27
28Fixes in Yocto-4.3.4
29~~~~~~~~~~~~~~~~~~~~
30
31- allarch: Fix allarch corner case
32- at-spi2-core: Upgrade to 2.50.1
33- bind: Upgrade to 9.18.24
34- build-appliance-image: Update to nanbield head revision
35- contributor-guide: add notes for tests
36- contributor-guide: be more specific about meta-* trees
37- core-image-ptest: Increase disk size to 1.5G for strace ptest image
38- cpio: Upgrade to 2.15
39- curl: improve run-ptest
40- curl: increase test timeouts
41- cve-check: Log if :term:`CVE_STATUS` set but not reported for component
42- cve-update-nvd2-native: Add an age threshold for incremental update
43- cve-update-nvd2-native: Fix CVE configuration update
44- cve-update-nvd2-native: Fix typo in comment
45- cve-update-nvd2-native: Remove duplicated CVE_CHECK_DB_FILE definition
46- cve-update-nvd2-native: Remove rejected CVE from database
47- cve-update-nvd2-native: nvd_request_next: Improve comment
48- cve_check: cleanup logging
49- cve_check: handle :term:`CVE_STATUS` being set to the empty string
50- dev-manual: Rephrase spdx creation
51- dev-manual: improve descriptions of 'bitbake -S printdiff'
52- dev-manual: packages: clarify shared :term:`PR` service constraint
53- dev-manual: packages: fix capitalization
54- dev-manual: packages: need enough free space
55- docs: add initial stylechecks with Vale
56- docs: correct sdk installation default path
57- docs: document VIRTUAL-RUNTIME variables
58- docs: suppress excess use of "following" word
59- docs: use "manual page(s)"
60- docs: Makefile: remove releases.rst in "make clean"
61- externalsrc: fix task dependency for do_populate_lic
62- glibc: Remove duplicate :term:`CVE_STATUS` for :cve:`2023-4527`
63- glibc: stable 2.38 branch updates (2.38+gitd37c2b20a4)
64- gnutls: Upgrade to 3.8.3
65- gstreamer1.0: skip a test that is known to be flaky
66- gstreamer: Upgrade to 1.22.9
67- gtk: Set :term:`CVE_PRODUCT`
68- kernel.bbclass: Set pkg-config variables for building modules
69- libxml2: Upgrade to 2.11.7
70- linux-firmware: Upgrade to 20240220
71- linux-yocto/6.1: update to v6.1.78
72- mdadm: Disable ptests
73- migration-guides: add release notes for 4.3.3
74- migration-guides: add release notes for 4.0.17
75- migration-guides: fix release notes for 4.3.3 linux-yocto/6.1 CVE entries
76- multilib_global.bbclass: fix parsing error with no kernel module split
77- openssl: fix crash on aarch64 if BTI is enabled but no Crypto instructions
78- openssl: Upgrade to 3.1.5
79- overlayfs: add missing closing parenthesis in selftest
80- poky.conf: bump version for 4.3.4 release
81- profile-manual: usage.rst: fix reference to bug report
82- profile-manual: usage.rst: formatting fixes
83- profile-manual: usage.rst: further style improvements
84- pseudo: Update to pull in gcc14 fix and missing statvfs64 intercept
85- python3-jinja2: Upgrade to 3.1.3
86- ref-manual: release-process: grammar fix
87- ref-manual: system-requirements: update packages to build docs
88- ref-manual: tasks: do_cleanall: recommend using '-f' instead
89- ref-manual: tasks: do_cleansstate: recommend using '-f' instead for a shared sstate
90- ref-manual: variables: adding multiple groups in :term:`GROUPADD_PARAM`
91- ref-manual: variables: add documentation of the variable :term:`SPDX_NAMESPACE_PREFIX`
92- reproducible: Fix race with externalsrc/devtool over lockfile
93- sdk-manual: extensible: correctly describe separate build-sysroots tasks in direct sdk workflows
94- tzdata : Upgrade to 2024a
95- udev-extraconf: fix unmount directories containing octal-escaped chars
96- vim: Upgrade to v9.0.2190
97- wireless-regdb: Upgrade to 2024.01.23
98- xserver-xorg: Upgrade to 21.1.11
99- xwayland: Upgrade to 23.2.4
100- yocto-uninative: Update to 4.4 for glibc 2.39
101
102
103Known Issues in Yocto-4.3.4
104~~~~~~~~~~~~~~~~~~~~~~~~~~~
105
106- N/A
107
108
109Contributors to Yocto-4.3.4
110~~~~~~~~~~~~~~~~~~~~~~~~~~~
111
112- Alex Kiernan
113- Alexander Kanavin
114- Alexander Sverdlin
115- Baruch Siach
116- BELOUARGA Mohamed
117- Benjamin Bara
118- Bruce Ashfield
119- Chen Qi
120- Claus Stovgaard
121- Dhairya Nagodra
122- Geoff Parker
123- Johan Bezem
124- Jonathan GUILLOT
125- Julien Stephan
126- Kai Kang
127- Khem Raj
128- Lee Chee Yang
129- Luca Ceresoli
130- Martin Jansa
131- Michael Halstead
132- Michael Opdenacker
133- Munehisa Kamata
134- Pavel Zhukov
135- Peter Marko
136- Priyal Doshi
137- Richard Purdie
138- Robert Joslyn
139- Ross Burton
140- Simone Weiß
141- Soumya Sambu
142- Steve Sakoman
143- Tim Orling
144- Wang Mingyu
145- Yoann Congal
146- Yogita Urade
147
148
149Repositories / Downloads for Yocto-4.3.4
150~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151
152poky
153
154- Repository Location: :yocto_git:`/poky`
155- Branch: :yocto_git:`nanbield </poky/log/?h=nanbield>`
156- Tag: :yocto_git:`yocto-4.3.4 </poky/log/?h=yocto-4.3.4>`
157- Git Revision: :yocto_git:`7b8aa378d069ee31373f22caba3bd7fc7863f447 </poky/commit/?id=7b8aa378d069ee31373f22caba3bd7fc7863f447>`
158- Release Artefact: poky-7b8aa378d069ee31373f22caba3bd7fc7863f447
159- sha: 0cb14125f215cc9691cff43982e2c540a5b6018df4ed25c10933135b5bf21d0f
160- Download Locations:
161 http://downloads.yoctoproject.org/releases/yocto/yocto-4.3.4/poky-7b8aa378d069ee31373f22caba3bd7fc7863f447.tar.bz2
162 http://mirrors.kernel.org/yocto/yocto/yocto-4.3.4/poky-7b8aa378d069ee31373f22caba3bd7fc7863f447.tar.bz2
163
164openembedded-core
165
166- Repository Location: :oe_git:`/openembedded-core`
167- Branch: :oe_git:`nanbield </openembedded-core/log/?h=nanbield>`
168- Tag: :oe_git:`yocto-4.3.4 </openembedded-core/log/?h=yocto-4.3.4>`
169- Git Revision: :oe_git:`d0e68072d138ccc1fb5957fdc46a91871eb6a3e1 </openembedded-core/commit/?id=d0e68072d138ccc1fb5957fdc46a91871eb6a3e1>`
170- Release Artefact: oecore-d0e68072d138ccc1fb5957fdc46a91871eb6a3e1
171- sha: d311fe22ff296c466f9bea1cd26343baee5630bc37f3dda42f2d9d8cc99e3add
172- Download Locations:
173 http://downloads.yoctoproject.org/releases/yocto/yocto-4.3.4/oecore-d0e68072d138ccc1fb5957fdc46a91871eb6a3e1.tar.bz2
174 http://mirrors.kernel.org/yocto/yocto/yocto-4.3.4/oecore-d0e68072d138ccc1fb5957fdc46a91871eb6a3e1.tar.bz2
175
176meta-mingw
177
178- Repository Location: :yocto_git:`/meta-mingw`
179- Branch: :yocto_git:`nanbield </meta-mingw/log/?h=nanbield>`
180- Tag: :yocto_git:`yocto-4.3.4 </meta-mingw/log/?h=yocto-4.3.4>`
181- Git Revision: :yocto_git:`49617a253e09baabbf0355bc736122e9549c8ab2 </meta-mingw/commit/?id=49617a253e09baabbf0355bc736122e9549c8ab2>`
182- Release Artefact: meta-mingw-49617a253e09baabbf0355bc736122e9549c8ab2
183- sha: 2225115b73589cdbf1e491115221035c6a61679a92a93b2a3cf761ff87bf4ecc
184- Download Locations:
185 http://downloads.yoctoproject.org/releases/yocto/yocto-4.3.4/meta-mingw-49617a253e09baabbf0355bc736122e9549c8ab2.tar.bz2
186 http://mirrors.kernel.org/yocto/yocto/yocto-4.3.4/meta-mingw-49617a253e09baabbf0355bc736122e9549c8ab2.tar.bz2
187
188bitbake
189
190- Repository Location: :oe_git:`/bitbake`
191- Branch: :oe_git:`2.6 </bitbake/log/?h=2.6>`
192- Tag: :oe_git:`yocto-4.3.4 </bitbake/log/?h=yocto-4.3.4>`
193- Git Revision: :oe_git:`380a9ac97de5774378ded5e37d40b79b96761a0c </bitbake/commit/?id=380a9ac97de5774378ded5e37d40b79b96761a0c>`
194- Release Artefact: bitbake-380a9ac97de5774378ded5e37d40b79b96761a0c
195- sha: 78f579b9d29e72d09b6fb10ac62aa925104335e92d2afb3155bc9ab1994e36c1
196- Download Locations:
197 http://downloads.yoctoproject.org/releases/yocto/yocto-4.3.4/bitbake-380a9ac97de5774378ded5e37d40b79b96761a0c.tar.bz2
198 http://mirrors.kernel.org/yocto/yocto/yocto-4.3.4/bitbake-380a9ac97de5774378ded5e37d40b79b96761a0c.tar.bz2
199
200yocto-docs
201
202- Repository Location: :yocto_git:`/yocto-docs`
203- Branch: :yocto_git:`nanbield </yocto-docs/log/?h=nanbield>`
204- Tag: :yocto_git:`yocto-4.3.4 </yocto-docs/log/?h=yocto-4.3.4>`
205- Git Revision: :yocto_git:`05d08b0bbaef760157c8d35a78d7405bc5ffce55 </yocto-docs/commit/?id=05d08b0bbaef760157c8d35a78d7405bc5ffce55>`
206
diff --git a/documentation/migration-guides/release-notes-5.0.1.rst b/documentation/migration-guides/release-notes-5.0.1.rst
new file mode 100644
index 0000000000..a377f92c19
--- /dev/null
+++ b/documentation/migration-guides/release-notes-5.0.1.rst
@@ -0,0 +1,134 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release notes for Yocto-5.0.1 (Scarthgap)
4-----------------------------------------
5
6Security Fixes in Yocto-5.0.1
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8
9- N/A
10
11
12Fixes in Yocto-5.0.1
13~~~~~~~~~~~~~~~~~~~~
14
15- babeltrace2: upgrade 2.0.5 -> 2.0.6
16- bind: upgrade 9.18.24 -> 9.18.25
17- bitbake: cooker: Use hash client to ping upstream server
18- build-appliance-image: Update to scarthgap head revision (b9b47b1a392b...)
19- docs: add support for scarthgap 5.0 release
20- docs: brief-yoctoprojectqs: explicit version dependency on websockets python module
21- docs: brief-yoctoprojectqs: Update to the correct hash equivalence server address
22- documentation/poky.yaml.in: drop mesa/sdl from essential host packages
23- ell: upgrade 0.63 -> 0.64
24- gcr: upgrade 4.2.0 -> 4.2.1
25- icu: update 74-1 -> 74-2
26- libdnf: upgrade 0.73.0 -> 0.73.1
27- libsdl2: upgrade 2.30.0 -> 2.30.1
28- libx11: upgrade 1.8.7 -> 1.8.9
29- libxcursor: upgrade 1.2.1 -> 1.2.2
30- libxml2: upgrade 2.12.5 -> 2.12.6
31- local.conf.sample: Fix hashequivalence server address
32- lttng-tools: upgrade 2.13.11 -> 2.13.13
33- manuals: standards.md: add standard for project names
34- mesa: upgrade 24.0.2 -> 24.0.3
35- migration-notes: add release notes for 4.0.18
36- mpg123: upgrade 1.32.5 -> 1.32.6
37- pango: upgrade 1.52.0 -> 1.52.1
38- poky.conf: bump version for 5.0.1
39- python3: skip test_concurrent_futures/test_shutdown
40- ref-manual: update releases.svg
41- ref-manual: variables: add :term:`USERADD_DEPENDS`
42- release-notes-5.0: update Repositories / Downloads section
43- release-notes-5.0: update recipes changes
44- release-notes-5.0: update new features
45- rootfs-postcommands.bbclass: Only set DROPBEAR_RSAKEY_DIR once
46- rpm: update 4.19.1 -> 4.19.1.1
47- scripts/oe-setup-build: write a build environment initialization one-liner into the build directory
48- sstate.bbclass: Add _SSTATE_EXCLUDEDEPS_SYSROOT to vardepsexclude
49- systemd: sed :term:`ROOT_HOME` only if sysusers :term:`PACKAGECONFIG` is set
50
51
52Known Issues in Yocto-5.0.1
53~~~~~~~~~~~~~~~~~~~~~~~~~~~
54
55- N/A
56
57
58Contributors to Yocto-5.0.1
59~~~~~~~~~~~~~~~~~~~~~~~~~~~
60
61- Alexander Kanavin
62- Christian Bräuner Sørensen
63- Joshua Watt
64- Lee Chee Yang
65- Mark Hatle
66- Michael Glembotzki
67- Michael Halstead
68- Michael Opdenacker
69- Paul Eggleton
70- Quentin Schulz
71- Richard Purdie
72- Steve Sakoman
73- Trevor Gamblin
74- Wang Mingyu
75
76
77Repositories / Downloads for Yocto-5.0.1
78~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79
80poky
81
82- Repository Location: :yocto_git:`/poky`
83- Branch: :yocto_git:`scarthgap </poky/log/?h=scarthgap>`
84- Tag: :yocto_git:`yocto-5.0.1 </poky/log/?h=yocto-5.0.1>`
85- Git Revision: :yocto_git:`4b07a5316ed4b858863dfdb7cab63859d46d1810 </poky/commit/?id=4b07a5316ed4b858863dfdb7cab63859d46d1810>`
86- Release Artefact: poky-4b07a5316ed4b858863dfdb7cab63859d46d1810
87- sha: 51d0c84da7dbcc8db04a674da39cfc73ea78aac22ee646ede5b6229937d4666a
88- Download Locations:
89 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0.1/poky-4b07a5316ed4b858863dfdb7cab63859d46d1810.tar.bz2
90 http://mirrors.kernel.org/yocto/yocto/yocto-5.0.1/poky-4b07a5316ed4b858863dfdb7cab63859d46d1810.tar.bz2
91
92openembedded-core
93
94- Repository Location: :oe_git:`/openembedded-core`
95- Branch: :oe_git:`scarthgap </openembedded-core/log/?h=scarthgap>`
96- Tag: :oe_git:`yocto-5.0.1 </openembedded-core/log/?h=yocto-5.0.1>`
97- Git Revision: :oe_git:`294a7dbe44f6b7c8d3a1de8c2cc182af37c4f916 </openembedded-core/commit/?id=294a7dbe44f6b7c8d3a1de8c2cc182af37c4f916>`
98- Release Artefact: oecore-294a7dbe44f6b7c8d3a1de8c2cc182af37c4f916
99- sha: e9be51a3b1fe8a1f420483b912caf91bc429dcca303d462381876a643b73045e
100- Download Locations:
101 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0.1/oecore-294a7dbe44f6b7c8d3a1de8c2cc182af37c4f916.tar.bz2
102 http://mirrors.kernel.org/yocto/yocto/yocto-5.0.1/oecore-294a7dbe44f6b7c8d3a1de8c2cc182af37c4f916.tar.bz2
103
104meta-mingw
105
106- Repository Location: :yocto_git:`/meta-mingw`
107- Branch: :yocto_git:`scarthgap </meta-mingw/log/?h=scarthgap>`
108- Tag: :yocto_git:`yocto-5.0.1 </meta-mingw/log/?h=yocto-5.0.1>`
109- Git Revision: :yocto_git:`acbba477893ef87388effc4679b7f40ee49fc852 </meta-mingw/commit/?id=acbba477893ef87388effc4679b7f40ee49fc852>`
110- Release Artefact: meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852
111- sha: 3b7c2f475dad5130bace652b150367f587d44b391218b1364a8bbc430b48c54c
112- Download Locations:
113 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0.1/meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852.tar.bz2
114 http://mirrors.kernel.org/yocto/yocto/yocto-5.0.1/meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852.tar.bz2
115
116bitbake
117
118- Repository Location: :oe_git:`/bitbake`
119- Branch: :oe_git:`2.8 </bitbake/log/?h=2.8>`
120- Tag: :oe_git:`yocto-5.0.1 </bitbake/log/?h=yocto-5.0.1>`
121- Git Revision: :oe_git:`8f90d10f9efc9a32e13f6bd031992aece79fe7cc </bitbake/commit/?id=8f90d10f9efc9a32e13f6bd031992aece79fe7cc>`
122- Release Artefact: bitbake-8f90d10f9efc9a32e13f6bd031992aece79fe7cc
123- sha: 519f02d5de7fbfac411532161d521123814dd9cc7d6b55488b5e7a547c1a6977
124- Download Locations:
125 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0.1/bitbake-8f90d10f9efc9a32e13f6bd031992aece79fe7cc.tar.bz2
126 http://mirrors.kernel.org/yocto/yocto/yocto-5.0.1/bitbake-8f90d10f9efc9a32e13f6bd031992aece79fe7cc.tar.bz2
127
128yocto-docs
129
130- Repository Location: :yocto_git:`/yocto-docs`
131- Branch: :yocto_git:`scarthgap </yocto-docs/log/?h=scarthgap>`
132- Tag: :yocto_git:`yocto-5.0.1 </yocto-docs/log/?h=yocto-5.0.1>`
133- Git Revision: :yocto_git:`875dfe69e93bf8fee3b8c07818a6ac059f228a13 </yocto-docs/commit/?id=875dfe69e93bf8fee3b8c07818a6ac059f228a13>`
134
diff --git a/documentation/migration-guides/release-notes-5.0.rst b/documentation/migration-guides/release-notes-5.0.rst
index e5cdd87d1d..800ba20a27 100644
--- a/documentation/migration-guides/release-notes-5.0.rst
+++ b/documentation/migration-guides/release-notes-5.0.rst
@@ -6,61 +6,988 @@ Release notes for 5.0 (scarthgap)
6New Features / Enhancements in 5.0 6New Features / Enhancements in 5.0
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 8
9- Linux kernel 6.6, gcc 13.2, glibc 2.39, LLVM 18.1, and over XXX other recipe upgrades 9- Linux kernel 6.6, gcc 13.2, glibc 2.39, LLVM 18.1, and over 300 other recipe upgrades
10 10
11- New variables: 11- New variables:
12 12
13 - :term:`CVE_DB_INCR_UPDATE_AGE_THRES`: Configure the maximum age of the
14 internal CVE database for incremental update (instead of a full
15 redownload).
16
17 - :term:`RPMBUILD_EXTRA_PARAMS`: support extra user-defined fields without
18 crashing the RPM package creation.
19
20 - :term:`OPKG_MAKE_INDEX_EXTRA_PARAMS`: support extra parameters for
21 ``opkg-make-index``.
22
23 - :term:`EFI_UKI_PATH`, :term:`EFI_UKI_DIR`: define the location of UKI
24 image in the EFI System partition.
25
26 - :term:`TARGET_DBGSRC_DIR`: specifies the target path to debug source files
27
28 - :term:`USERADD_DEPENDS`: provides a way to declare dependencies on the users
29 and/or groups created by other recipes, resolving a long-standing build
30 ordering issue
31
13- Architecture-specific enhancements: 32- Architecture-specific enhancements:
14 33
34 - ``genericarm64``: a new :term:`MACHINE` to represent a 64-bit General Arm
35 SystemReady platform.
36
37 - Add Power8 tune to PowerPC architecture.
38
39 - ``arch-armv9``: remove CRC and SVE tunes, since FEAT_CRC32 is now mandatory
40 and SVE/SVE2 are enabled by default in GCC's ``-march=armv9-a``.
41
42 - ``arm/armv*``: add all of the additional Arm tunes in GCC 13.2.0
43
15- Kernel-related enhancements: 44- Kernel-related enhancements:
16 45
46 - The default kernel is the current LTS (6.6).
47
48 - Add support for ``genericarm64``.
49
17- New core recipes: 50- New core recipes:
18 51
52 - `bmaptool <https://github.com/yoctoproject/bmaptool>`__: a tool for
53 creating block maps for files and flashing images, being now under the
54 Yocto Project umbrella.
55
56 - ``core-image-initramfs-boot``: a minimal initramfs image, containing just
57 ``udev`` and ``init``, designed to find the main root filesystem and
58 pivot to it.
59
60 - `lzlib <https://www.nongnu.org/lzip/lzlib.html>`__: a data compression
61 library that provides LZMA compression and decompression functions.
62
63 - `lzop <https://www.lzop.org/>`__: a compression utility based on the LZO
64 library, that was brought back after a (now reverted) removal.
65
66 - `python3-jsonschema-specifications <https://pypi.org/project/jsonschema-specifications/>`__:
67 support files for JSON Schema Specifications (meta-schemas and
68 vocabularies), added as a new dependency of ``python3-jsonschema``.
69
70 - `python3-maturin <https://github.com/pyo3/maturin>`__: a project that
71 allows building and publishing Rust crates as Python packages.
72
73 - `python3-meson-python <https://github.com/mesonbuild/meson-python>`__: a
74 Python build backend that enables the Meson build-system for Python packages.
75
76 - `python3-pyproject-metadata <https://pypi.org/project/pyproject-metadata/>`__:
77 a class to handle PEP 621 metadata, and a dependency for
78 ``python3-meson-python``.
79
80 - `python3-referencing <https://github.com/python-jsonschema/referencing>`__:
81 another dependency of ``python3-jsonschema``, it provides an
82 implementation of JSON reference resolution.
83
84 - `python3-rpds-py <https://pypi.org/project/rpds-py/>`__: Python bindings
85 to the Rust rpds crate, and a runtime dependency for ``python3-referencing``.
86
87 - `python3-sphinxcontrib-jquery <https://pypi.org/project/sphinxcontrib-jquery/>`__:
88 a Sphinx extension to include jQuery on newer Sphinx releases. Recent
89 versions of ``python3-sphinx-rtd-theme`` depend on it.
90
91 - `python3-websockets <https://pypi.org/project/websockets/>`__: a
92 library for building WebSocket servers and clients in Python.
93
94 - `python3-yamllint <https://github.com/adrienverge/yamllint>`__: a linter
95 for YAML files. In U-Boot, the ``binman`` tool uses this linter to verify the
96 configurations at compile time.
97
98 - ``systemd-boot-native``: a UEFI boot manager, this time built as native to
99 provide the ``ukify`` tool.
100
101 - `utfcpp <https://github.com/nemtrif/utfcpp>`__: a C++ library to handle
102 UTF-8 encoded strings. It was added as a dependency for ``taglib`` after
103 its upgrade to v2.0.
104
105 - `vulkan-utility-libraries <https://github.com/KhronosGroup/Vulkan-Utility-Libraries>`__:
106 a set of libraries to share code across various Vulkan repositories.
107
108 - `vulkan-volk <https://github.com/zeux/volk>`__: a meta-loader for Vulkan,
109 needed to support building the latest ``vulkan-tools``.
110
19- QEMU / ``runqemu`` enhancements: 111- QEMU / ``runqemu`` enhancements:
20 112
21 - QEMU has been upgraded to version 8.2.1 113 - QEMU has been upgraded to version 8.2.1
22 114
115 - ``qemuboot``: support predictable network interface names.
116
117 - ``runqemu``: match ".rootfs." in addition to "-image-" for the root
118 filesystem.
119
120 - :ref:`ref-classes-cmake-qemu`: a new class allowing to execute cross-compiled
121 binaries using QEMU user-mode emulation.
122
23- Rust improvements: 123- Rust improvements:
24 124
25 - Rust has been upgraded to version 1.75 125 - Rust has been upgraded to version 1.75
26 126
127 - The Rust profiler (i.e., PGO - Profile-Guided Optimization) options were
128 enabled back.
129
130 - The Rust ``oe-selftest`` were enabled, except for ``mips32`` whose tests
131 are skipped.
132
133 - ``rust-cross-canadian``: added ``riscv64`` to cross-canadian hosts.
134
27- wic Image Creator enhancements: 135- wic Image Creator enhancements:
28 136
137 - Allow the imager's output file extension to match the imager's name,
138 instead of hardcoding it to ``direct`` (i.e., the default imager)
139
140 - For GPT-based disks, add reproducible Disk GUID generation
141
142 - Allow generating reproducible ext4 images
143
144 - Add feature to fill a specific range of a partition with zeros
145
146 - ``bootimg-efi``: add ``install-kernel-into-boot-dir`` parameter to
147 configure kernel installation point(s) (i.e., rootfs and/or boot partition)
148
149 - ``rawcopy``: add support for zstd decompression
150
29- SDK-related improvements: 151- SDK-related improvements:
30 152
153 - ``nativesdk``: let :term:`MACHINE_FEATURES` be set by ``machine-sdk``
154 configuration files.
155
156 - ``nativesdk``: prevent :term:`MACHINE_FEATURES` and :term:`DISTRO_FEATURES`
157 from being backfilled.
158
159 - Support for ``riscv64`` as an SDK host architecture
160
161 - Extend recipes to ``nativesdk``: ``acpica``, ``libpcap``, ``python3-setuptools-rust``
162
31- Testing: 163- Testing:
32 164
165 - Move `patchtest` to the core (as ``scripts/patchtest``, test cases under
166 ``meta/lib/patchtest/tests``) and make a number of improvements to enable
167 it to validate patches submitted on the mailing list again. Additionally,
168 make it work with the original upstream version of
169 `Patchwork <http://jk.ozlabs.org/projects/patchwork/>`__.
170
171 - Add an optional ``unimplemented-ptest`` QA warning to detect upstream
172 packages with tests, that do not use ptest.
173
174 - ``testimage``: retrieve the ptests directory, especially for the logs,
175 upon ptest failure.
176
177 - ``oeqa``, ``oe-selftest``: add test cases for Maturin (SDK and runtime).
178
179 - Proof-of-concept of screenshot-based runtime UI test
180 (``meta/lib/oeqa/runtime/cases/login.py``)
181
182 - Enable ptests for ``python3-attrs``, ``python3-pyyaml``, ``xz``
183
33- Utility script changes: 184- Utility script changes:
34 185
186 - ``oe-init-build-env`` can generate a initial configuration (``.vscode``)
187 for VSCode and its "Yocto Project BitBake" extension.
188
189 - The ``sstate-cache-management`` script has been rewritten in python for better performance and maintainability
190
191 - ``bitbake-layers``: added an option to update the reference of repositories in layer setup
192
35- BitBake improvements: 193- BitBake improvements:
36 194
195 - New ``inherit_defer`` statement which works as
196 :ref:`inherit <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:\`\`inherit\`\` directive>`
197 does, except that it is only evaluated at the end of parsing
198 --- recommended where a conditional expression is used, e.g.::
199
200 inherit_defer ${@bb.utils.contains('PACKAGECONFIG', 'python', 'python3targetconfig', '', d)}
201
202 This allows conditional expressions to be evaluated 'late' meaning changes
203 to the variable after the line is parsed will take effect - with inherit this
204 is not the case.
205
206 - Add support for :term:`BB_LOADFACTOR_MAX`, so Bitbake can stop running
207 extra tasks if the system load is too high, especially in distributions
208 where ``/proc/pressure`` is disabled.
209
210 - ``taskexp_ncurses``: add ncurses version of ``taskexp``, the dependency
211 explorer originally implemented with GTK.
212
213 - Improve ``runqueue`` performance by adding a cache mechanism in
214 ``build_taskdepdata``.
215
216 - ``bitbake.conf``: add ``runtimedir`` to represent the path to the runtime
217 state directory (i.e., ``/run``).
218
219 - Allow to disable colored text output through the
220 `NO_OUTPUT <https://no-color.org/>`__ environment variable.
221
222 - ``git-make-shallow`` script: add support for Git's ``safe.bareRepository=explicit``
223 configuration setting.
224
225 - Hash equivalence gained a number of scalability improvements including:
226
227 - Support for a wide range of database backends through `SQLAlchemy`
228
229 - Support for hash equivalence server and client to communicate over websockets
230
231 - Support for per-user permissions in the hashserver, and on the client side
232 specifying credentials via the environment or ``.netrc``
233
234 - Add garbage collection to remove unused unihashes from the database.
235
236- devtool improvements:
237
238 - Introduce a new ``ide-sdk`` plugin to generate a configuration to use
239 the eSDK through an IDE.
240
241 - Add ``--no-pypi`` option for Python projects that are not hosted on PyPI.
242
243 - Add support for Git submodules.
244
245 - ``ide``: ``vscode``: generate files from recipe sysroots and debug the
246 root filesystem in read-only mode to avoid confusion.
247
248 - ``modify``: add support for multiple sources in :term:`SRC_URI`.
249
250 - Support plugins within plugins.
251
252- recipetool improvements:
253
254 - ``appendsrcfile(s)``: add a mode to update the recipe itself.
255
256 - ``appendsrcfile(s)``: add ``--dry-run`` mode.
257
258 - ``create``: add handler to create Go recipes.
259
260 - ``create``: improve identification of licenses.
261
262 - ``create``: add support for modern Python PEP-517 build systems including
263 hatchling, maturin, meson-python.
264
265 - ``create``: add PyPi support.
266
267 - ``create``: prefix created Python recipes with ``python3-``.
268
37- Packaging changes: 269- Packaging changes:
38 270
271 - ``package_rpm``: the RPM package compressor's mode can now be overriden.
272
273 - ipk packaging (using ``opkg``) now uses ``zstd`` compression instead of
274 ``xz`` for better compression and performance.
275
39- Security improvements: 276- Security improvements:
40 277
278 - Improve incremental CVE database download from NVD. Rejected CVEs are
279 removed, configuration is kept up-to-date. The age threshold for
280 incremental update can be configured with :term:`CVE_DB_INCR_UPDATE_AGE_THRES`
281 variable.
282
283- Toaster Web UI improvements:
284
285 - Numerous bugfixes, and additional input validation
286
287 - Add `pytest` support and add/update test cases
288
41- Prominent documentation updates: 289- Prominent documentation updates:
42 290
291 - Documentation for using the new ``devtool ide-sdk`` command and features.
292 See :ref:`using_devtool` for details.
293
294 - New ":doc:`bitbake:bitbake-user-manual/bitbake-user-manual-ref-variables-context`"
295 section in the BitBake User Manual.
296
297 - New ``make stylecheck`` command to run `Vale <https://vale.sh>`__,
298 to perform text style checks and comply with text writing standards in
299 the industry.
300
301 - New ``make sphinx-lint`` command to run `sphinx-lint
302 <https://github.com/sphinx-contrib/sphinx-lint>`__. After customization,
303 this will allow us to enforce Sphinx syntax style choices.
304
43- Miscellaneous changes: 305- Miscellaneous changes:
44 306
307 - Systemd's following :term:`PACKAGECONFIG` options were added:
308 ``cryptsetup-plugins``, ``no-ntp-fallback``, and ``p11kit``.
309
310 - New PACKAGECONFIG options added to ``libarchive``, ``libinput``,
311 ``libunwind``, ``mesa``, ``mesa-gl``, ``openssh``, ``perf``,
312 ``python3-pyyaml``, ``qemu``, ``rpm``, ``shadow``, ``strace``,
313 ``syslinux``, ``systemd``, ``vte``, ``webkitgtk``, ``xserver-xorg``.
314
315 - ``systemd-boot`` can, from now on, be compiled as ``native``, thus
316 providing ``ukify`` tool to build UKI images.
317
318 - systemd: split bash completion for ``udevadm`` in a new
319 ``udev-bash-completion`` package.
320
321 - The :ref:`ref-classes-go-vendor` class was added to support offline builds
322 (i.e., vendoring). It can also handle modules from the same repository,
323 taking into account their versions.
324
325 - Disable strace support of bluetooth by default.
326
327 - ``openssh`` now has a systemd service: ``sshd.service``.
328
329 - The :ref:`ref-classes-python_mesonpy` class was added (moved in from
330 ``meta-python``) to support Python package builds using the meson-python
331 PEP-517 build backend.
332
333 - Support for unpacking ``.7z`` archives in :term:`SRC_URI` using ``p7zip``.
334
335 - Add minimal VS Code configuration to avoid VS Code's indexer from choking
336 on build directories.
337
338
45Known Issues in 5.0 339Known Issues in 5.0
46~~~~~~~~~~~~~~~~~~~ 340~~~~~~~~~~~~~~~~~~~
47 341
48- N/A 342- ``gpgme`` has had Python binding support disabled since upstream does not yet support Python 3.12.
343
49 344
50Recipe License changes in 5.0 345Recipe License changes in 5.0
51~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 346~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52 347
348The following corrections have been made to the :term:`LICENSE` values set by recipes:
349
350- ``elfutils``: split license for libraries & backend and utilities.
351- ``ghostscript``: correct :term:`LICENSE` to ``AGPL-3.0-or-later``.
352- ``kbd``: update license for consolefont and keymaps.
353- ``libsystemd``: set its own :term:`LICENSE` value (``LGPL-2.1-or-later``) to add more granularity.
354- ``libtest-warnings-perl``: update :term:`LICENSE` ``Artistic-1.0`` to ``Artistic-1.0-Perl``.
355- ``linux-firmware``: set package :term:`LICENSE` appropriately for ``carl9170``, ``rockchip`` and ``powerpr``.
356- ``newlib``: add license ``Apache-2.0-with-LLVM-exception``.
357- ``python3-poetry-core``: add license ``BSD-3-Clause`` for ``fastjsonschema``.
358- ``systemd``: make the scope of ``LGPL`` more accurate (``LGPL-2.1`` -> ``LGPL-2.1-or-later``).
359- ``util-linux``: add ``GPL-1.0-or-later`` license for fdisk and ``MIT`` license for ``flock``.
360- ``zstd``: set to dual-licensed ``BSD-3-Clause`` or ``GPL-2.0-only``.
361
53Security Fixes in 5.0 362Security Fixes in 5.0
54~~~~~~~~~~~~~~~~~~~~~ 363~~~~~~~~~~~~~~~~~~~~~
55 364
365- avahi: :cve:`2023-1981`, :cve:`2023-38469`, :cve:`2023-38470`, :cve:`2023-38471`, :cve:`2023-38469`, :cve:`2023-38470`, :cve:`2023-38471`, :cve:`2023-38472`, :cve:`2023-38473`
366- bind: :cve:`2023-4408`, :cve:`2023-5517`, :cve:`2023-5679`, :cve:`2023-50387`
367- bluez5: :cve:`2023-45866`
368- coreutils: :cve:`2024-0684`
369- cups: :cve:`2023-4504`
370- curl: :cve:`2023-46218`
371- expat: :cve:`2024-28757`
372- gcc: :cve:`2023-4039`
373- glibc: :cve:`2023-5156`, :cve:`2023-0687`
374- gnutls: :cve:`2024-0553`, :cve:`2024-0567`, :cve:`2024-28834`, :cve:`2024-28835`
375- go: :cve:`2023-45288`
376- grub: :cve:`2023-4692`, :cve:`2023-4693`
377- grub2: :cve:`2023-4001` (ignored), :cve:`2024-1048` (ignored)
378- libgit2: :cve:`2024-24575`, :cve:`2024-24577`
379- libsndfile1: :cve:`2022-33065`
380- libssh2: :cve:`2023-48795`
381- libuv: :cve:`2024-24806`
382- libxml2: :cve:`2023-45322` (ignored)
383- linux-yocto/6.6: :cve:`2020-16119`
384- openssh: :cve:`2023-48795`, :cve:`2023-51384`, :cve:`2023-51385`
385- openssl: :cve:`2023-5363`, :cve:`2023-5678`, :cve:`2023-6129`, :cve_mitre:`2023-6237`, :cve:`2024-0727`, :cve:`2024-2511`
386- perl: :cve:`2023-47100`
387- pixman: :cve:`2023-37769` (ignored)
388- python3-cryptography{-vectors}: :cve:`2023-49083`, :cve:`2024-26130`
389- python3-urllib3: :cve:`2023-45803`
390- shadow: :cve:`2023-4641`
391- sudo: :cve:`2023-42456`
392- tiff: :cve:`2023-6228`, :cve:`2023-6277`, :cve:`2023-52355`, :cve:`2023-52356`
393- vim: :cve:`2023-46246`, :cve:`2023-48231`, :cve:`2023-48232`, :cve:`2023-48233`, :cve:`2023-48234`, :cve:`2023-48235`, :cve:`2023-48236`, :cve:`2023-48237`, :cve:`2024-22667`
394- wpa-supplicant: :cve:`2023-52160`
395- xserver-xorg: :cve:`2023-5574`, :cve:`2023-6816`, :cve:`2024-0229`, :cve:`2024-0408`, :cve:`2024-0409`, :cve:`2024-21885`, :cve:`2024-21886`
396- xwayland: :cve:`2023-5367`, :cve:`2024-0408`, :cve:`2024-0409`, :cve:`2023-6816`, :cve:`2024-0229`, :cve:`2024-21885`, :cve:`2024-21886`
397- zlib: :cve:`2023-45853` (ignored), :cve:`2023-6992` (ignored)
398
399
56Recipe Upgrades in 5.0 400Recipe Upgrades in 5.0
57~~~~~~~~~~~~~~~~~~~~~~ 401~~~~~~~~~~~~~~~~~~~~~~
58 402
403- acl 2.3.1 -> 2.3.2
404- acpica 20230628 -> 20240322
405- alsa-lib 1.2.10 -> 1.2.11
406- alsa-tools 1.2.5 -> 1.2.11
407- alsa-ucm-conf 1.2.10 -> 1.2.11
408- alsa-utils 1.2.10 -> 1.2.11
409- appstream 0.16.3 -> 1.0.2
410- autoconf 2.72c -> 2.72e
411- bash 5.2.15 -> 5.2.21
412- bash-completion 2.11 -> 2.12.0
413- binutils 2.41 -> 2.42
414- bluez5 5.69 -> 5.72
415- boost 1.83.0 -> 1.84.0
416- boost-build-native 1.83.0 -> 1.84.0
417- btrfs-tools 6.5.1 -> 6.7.1
418- cairo 1.16.0 -> 1.18.0
419- cargo 1.70.0 -> 1.75.0
420- cargo-c-native 0.9.18 -> 0.9.30+cargo-0.77.0
421- ccache 4.8.3 -> 4.9.1
422- cmake 3.27.7 -> 3.28.3
423- cmake-native 3.27.7 -> 3.28.3
424- createrepo-c 1.0.0 -> 1.0.4
425- cronie 1.6.1 -> 1.7.1
426- cross-localedef-native 2.38+git -> 2.39+git
427- cups 2.4.6 -> 2.4.7
428- curl 8.4.0 -> 8.7.1
429- dbus-wait 0.1+git (6cc6077a36fe…) -> 0.1+git (64bc7c8fae61…)
430- debianutils 5.13 -> 5.16
431- desktop-file-utils 0.26 -> 0.27
432- dhcpcd 10.0.2 -> 10.0.6
433- diffoscope 249 -> 259
434- diffstat 1.65 -> 1.66
435- dnf 4.17.0 -> 4.19.0
436- dos2unix 7.5.1 -> 7.5.2
437- ed 1.19 -> 1.20.1
438- efivar 38+39+git -> 39+39+git
439- elfutils 0.189 -> 0.191
440- ell 0.60 -> 0.63
441- enchant2 2.6.2 -> 2.6.7
442- epiphany 44.6 -> 46.0
443- erofs-utils 1.6 -> 1.7.1
444- ethtool 6.5 -> 6.7
445- eudev 3.2.12 -> 3.2.14
446- expat 2.5.0 -> 2.6.2
447- ffmpeg 6.0 -> 6.1.1
448- fontconfig 2.14.2 -> 2.15.0
449- gawk 5.2.2 -> 5.3.0
450- gcr 4.1.0 -> 4.2.0
451- gdb 13.2 -> 14.2
452- gettext 0.22 -> 0.22.5
453- gettext-minimal-native 0.22 -> 0.22.5
454- gi-docgen 2023.1 -> 2023.3
455- git 2.42.0 -> 2.44.0
456- glib-2.0 2.78.3 -> 2.78.4
457- glib-networking 2.76.1 -> 2.78.1
458- glibc 2.38+git -> 2.39+git
459- glibc-locale 2.38 -> 2.39+git
460- glibc-mtrace 2.38 -> 2.39+git
461- glibc-scripts 2.38 -> 2.39+git
462- glibc-testsuite 2.38+git -> 2.39+git
463- glibc-y2038-tests 2.38+git -> 2.39+git
464- glslang 1.3.261.1 -> 1.3.275.0
465- gnu-config 20230216+git -> 20240101+git
466- gnupg 2.4.3 -> 2.4.4
467- gnutls 3.8.3 -> 3.8.4
468- go 1.20.12 -> 1.22.2
469- go-binary-native 1.20.12 -> 1.22.2
470- go-native 1.20.12 -> 1.22.2
471- go-runtime 1.20.12 -> 1.22.2
472- gpgme 1.22.0 -> 1.23.2
473- grub 2.06 -> 2.12
474- grub-efi 2.06 -> 2.12
475- gsettings-desktop-schemas 44.0 -> 46.0
476- gst-devtools 1.22.9 -> 1.22.11
477- gstreamer1.0 1.22.9 -> 1.22.11
478- gstreamer1.0-libav 1.22.9 -> 1.22.11
479- gstreamer1.0-omx 1.22.9 -> 1.22.11
480- gstreamer1.0-plugins-bad 1.22.9 -> 1.22.11
481- gstreamer1.0-plugins-base 1.22.9 -> 1.22.11
482- gstreamer1.0-plugins-good 1.22.9 -> 1.22.11
483- gstreamer1.0-plugins-ugly 1.22.9 -> 1.22.11
484- gstreamer1.0-python 1.22.9 -> 1.22.11
485- gstreamer1.0-rtsp-server 1.22.9 -> 1.22.11
486- gstreamer1.0-vaapi 1.22.9 -> 1.22.11
487- gtk+3 3.24.38 -> 3.24.41
488- gtk4 4.12.3 -> 4.14.1
489- harfbuzz 8.2.2 -> 8.3.0
490- hwlatdetect 2.5 -> 2.6
491- icu 73-2 -> 74-1
492- inetutils 2.4 -> 2.5
493- init-system-helpers 1.65.2 -> 1.66
494- iproute2 6.5.0 -> 6.7.0
495- iptables 1.8.9 -> 1.8.10
496- iputils 20221126 -> 20240117
497- iso-codes 4.15.0 -> 4.16.0
498- iw 5.19 -> 6.7
499- json-glib 1.6.6 -> 1.8.0
500- kbd 2.6.3 -> 2.6.4
501- kexec-tools 2.0.27 -> 2.0.28
502- kmod 30 -> 31
503- kmscube git -> 0.0.1+git
504- libadwaita 1.4.2 -> 1.5.0
505- libbsd 0.11.7 -> 0.12.1
506- libcap-ng 0.8.3 -> 0.8.4
507- libcap-ng-python 0.8.3 -> 0.8.4
508- libcomps 0.1.19 -> 0.1.20
509- libdnf 0.71.0 -> 0.73.0
510- libdrm 2.4.116 -> 2.4.120
511- libffi 3.4.4 -> 3.4.6
512- libgit2 1.7.1 -> 1.7.2
513- libgloss 4.3.0+git -> 4.4.0+git
514- libgpg-error 1.47 -> 1.48
515- libhandy 1.8.2 -> 1.8.3
516- libical 3.0.16 -> 3.0.17
517- libidn2 2.3.4 -> 2.3.7
518- libinput 1.24.0 -> 1.25.0
519- libksba 1.6.4 -> 1.6.6
520- libmicrohttpd 0.9.77 -> 1.0.1
521- libnl 3.8.0 -> 3.9.0
522- libnotify 0.8.2 -> 0.8.3
523- libpciaccess 0.17 -> 0.18
524- libpcre2 10.42 -> 10.43
525- libpng 1.6.40 -> 1.6.42
526- libproxy 0.5.3 -> 0.5.4
527- libpsl 0.21.2 -> 0.21.5
528- librepo 1.16.0 -> 1.17.0
529- librsvg 2.56.3 -> 2.57.1
530- libsdl2 2.28.4 -> 2.30.0
531- libseccomp 2.5.4 -> 2.5.5
532- libsecret 0.21.1 -> 0.21.4
533- libsolv 0.7.26 -> 0.7.28
534- libsoup 3.4.2 -> 3.4.4
535- libstd-rs 1.70.0 -> 1.75.0
536- libtest-warnings-perl 0.031 -> 0.033
537- libtirpc 1.3.3 -> 1.3.4
538- libubootenv 0.3.4 -> 0.3.5
539- libunistring 1.1 -> 1.2
540- liburi-perl 5.21 -> 5.27
541- libusb1 1.0.26 -> 1.0.27
542- libuv 1.46.0 -> 1.48.0
543- libva 2.19.0 -> 2.20.0
544- libva-initial 2.19.0 -> 2.20.0
545- libwpe 1.14.1 -> 1.14.2
546- libxext 1.3.5 -> 1.3.6
547- libxkbcommon 1.5.0 -> 1.6.0
548- libxkbfile 1.1.2 -> 1.1.3
549- libxml-parser-perl 2.46 -> 2.47
550- libxml2 2.11.7 -> 2.12.5
551- libxmlb 0.3.14 -> 0.3.15
552- libxrandr 1.5.3 -> 1.5.4
553- libxvmc 1.0.13 -> 1.0.14
554- lighttpd 1.4.71 -> 1.4.74
555- linux-firmware 20240220 -> 20240312
556- linux-libc-headers 6.5 -> 6.6
557- linux-yocto 6.1.78+git, 6.5.13+git -> 6.6.23+git
558- linux-yocto-dev 6.6+git -> 6.9+git
559- linux-yocto-rt 6.1.78+git, 6.5.13+git -> 6.6.23+git
560- linux-yocto-tiny 6.1.78+git, 6.5.13+git -> 6.6.23+git
561- llvm 17.0.3 -> 18.1.3
562- lsof 4.98.0 -> 4.99.3
563- ltp 20230516 -> 20240129
564- lttng-modules 2.13.10 -> 2.13.12
565- lttng-ust 2.13.6 -> 2.13.7
566- lzip 1.23 -> 1.24
567- makedepend 1.0.8 -> 1.0.9
568- man-db 2.11.2 -> 2.12.0
569- man-pages 6.05.01 -> 6.06
570- mc 4.8.30 -> 4.8.31
571- mesa 23.2.1 -> 24.0.2
572- mesa-gl 23.2.1 -> 24.0.2
573- meson 1.2.2 -> 1.3.1
574- minicom 2.8 -> 2.9
575- mmc-utils 0.1+git (613495ecaca9…) -> 0.1+git (b5ca140312d2…)
576- mpg123 1.31.3 -> 1.32.5
577- newlib 4.3.0+git -> 4.4.0+git
578- nghttp2 1.57.0 -> 1.61.0
579- numactl 2.0.16 -> 2.0.18
580- ofono 2.1 -> 2.4
581- opensbi 1.2 -> 1.4
582- openssh 9.5p1 -> 9.6p1
583- openssl 3.1.5 -> 3.2.1
584- opkg 0.6.2 -> 0.6.3
585- opkg-utils 0.6.2 -> 0.6.3
586- orc 0.4.34 -> 0.4.38
587- ovmf edk2-stable202308 -> edk2-stable202402
588- p11-kit 0.25.0 -> 0.25.3
589- pango 1.51.0 -> 1.52.0
590- pciutils 3.10.0 -> 3.11.1
591- piglit 1.0+gitr (71c21b1157c4…) -> 1.0+gitr (22eaf6a91cfd…)
592- pkgconf 2.0.3 -> 2.1.1
593- psplash 0.1+git (44afb7506d43…) -> 0.1+git (ecc191375669…)
594- ptest-runner 2.4.2+git -> 2.4.3+git
595- pulseaudio 16.1 -> 17.0
596- puzzles 0.0+git (2d9e414ee316…) -> 0.0+git (80aac3104096…)
597- python3 3.11.5 -> 3.12.3
598- python3-alabaster 0.7.13 -> 0.7.16
599- python3-attrs 23.1.0 -> 23.2.0
600- python3-babel 2.12.1 -> 2.14.0
601- python3-bcrypt 4.0.1 -> 4.1.2
602- python3-beartype 0.15.0 -> 0.17.2
603- python3-build 1.0.3 -> 1.1.1
604- python3-certifi 2023.7.22 -> 2024.2.2
605- python3-cffi 1.15.1 -> 1.16.0
606- python3-cryptography 41.0.4 -> 42.0.5
607- python3-cryptography-vectors 41.0.4 -> 42.0.5
608- python3-cython 0.29.36 -> 3.0.8
609- python3-dbusmock 0.29.1 -> 0.31.1
610- python3-dtschema 2023.7 -> 2024.2
611- python3-git 3.1.36 -> 3.1.42
612- python3-gitdb 4.0.10 -> 4.0.11
613- python3-hatch-fancy-pypi-readme 23.1.0 -> 24.1.0
614- python3-hatch-vcs 0.3.0 -> 0.4.0
615- python3-hatchling 1.18.0 -> 1.21.1
616- python3-hypothesis 6.86.2 -> 6.98.15
617- python3-idna 3.4 -> 3.6
618- python3-importlib-metadata 6.8.0 -> 7.0.1
619- python3-iso8601 2.0.0 -> 2.1.0
620- python3-jsonschema 4.17.3 -> 4.21.1
621- python3-license-expression 30.1.1 -> 30.2.0
622- python3-lxml 4.9.3 -> 5.0.0
623- python3-mako 1.2.4 -> 1.3.2
624- python3-markdown 3.4.4 -> 3.5.2
625- python3-markupsafe 2.1.3 -> 2.1.5
626- python3-more-itertools 10.1.0 -> 10.2.0
627- python3-numpy 1.26.0 -> 1.26.4
628- python3-packaging 23.1 -> 23.2
629- python3-pathspec 0.11.2 -> 0.12.1
630- python3-pbr 5.11.1 -> 6.0.0
631- python3-pip 23.2.1 -> 24.0
632- python3-pluggy 1.3.0 -> 1.4.0
633- python3-poetry-core 1.7.0 -> 1.9.0
634- python3-psutil 5.9.5 -> 5.9.8
635- python3-pyasn1 0.5.0 -> 0.5.1
636- python3-pycairo 1.24.0 -> 1.26.0
637- python3-pycryptodome 3.19.0 -> 3.20.0
638- python3-pycryptodomex 3.19.0 -> 3.20.0
639- python3-pygments 2.16.1 -> 2.17.2
640- python3-pyopenssl 23.2.0 -> 24.0.0
641- python3-pyrsistent 0.19.3 -> 0.20.0
642- python3-pytest 7.4.2 -> 8.0.2
643- python3-pytest-runner 6.0.0 -> 6.0.1
644- python3-pytz 2023.3 -> 2024.1
645- python3-ruamel-yaml 0.17.32 -> 0.18.6
646- python3-scons 4.5.2 -> 4.6.0
647- python3-setuptools 68.2.2 -> 69.1.1
648- python3-setuptools-rust 1.7.0 -> 1.9.0
649- python3-setuptools-scm 7.1.0 -> 8.0.4
650- python3-spdx-tools 0.8.1 -> 0.8.2
651- python3-sphinx-rtd-theme 1.3.0 -> 2.0.0
652- python3-sphinxcontrib-applehelp 1.0.4 -> 1.0.8
653- python3-sphinxcontrib-devhelp 1.0.2 -> 1.0.6
654- python3-sphinxcontrib-htmlhelp 2.0.1 -> 2.0.5
655- python3-sphinxcontrib-qthelp 1.0.3 -> 1.0.7
656- python3-sphinxcontrib-serializinghtml 1.1.5 -> 1.1.10
657- python3-subunit 1.4.2 -> 1.4.4
658- python3-testtools 2.6.0 -> 2.7.1
659- python3-trove-classifiers 2023.9.19 -> 2024.2.23
660- python3-typing-extensions 4.8.0 -> 4.10.0
661- python3-unittest-automake-output 0.1 -> 0.2
662- python3-urllib3 2.0.7 -> 2.2.1
663- python3-wcwidth 0.2.6 -> 0.2.13
664- python3-wheel 0.41.2 -> 0.42.0
665- qemu 8.1.4 -> 8.2.1
666- qemu-native 8.1.4 -> 8.2.1
667- qemu-system-native 8.1.4 -> 8.2.1
668- repo 2.36.1 -> 2.42
669- resolvconf 1.91 -> 1.92
670- rpm 4.18.1 -> 4.19.1
671- rt-tests 2.5 -> 2.6
672- rust 1.70.0 -> 1.75.0
673- rust-cross-canadian 1.70.0 -> 1.75.0
674- rust-llvm 1.70.0 -> 1.75.0
675- shaderc 2023.6 -> 2023.8
676- shadow 4.13 -> 4.14.2
677- shared-mime-info 2.2 -> 2.4
678- socat 1.7.4.4 -> 1.8.0.0
679- spirv-headers 1.3.261.1 -> 1.3.275.0
680- spirv-tools 1.3.261.1 -> 1.3.275.0
681- sqlite3 3.43.2 -> 3.45.1
682- strace 6.5 -> 6.7
683- stress-ng 0.16.05 -> 0.17.05
684- subversion 1.14.2 -> 1.14.3
685- swig 4.1.1 -> 4.2.1
686- sysstat 12.7.4 -> 12.7.5
687- systemd 254.4 -> 255.4
688- systemd-boot 254.4 -> 255.4
689- systemd-bootchart 234 -> 235
690- systemtap 4.9 -> 5.0
691- systemtap-native 4.9 -> 5.0
692- taglib 1.13.1 -> 2.0
693- ttyrun 2.29.0 -> 2.31.0
694- u-boot 2023.10 -> 2024.01
695- u-boot-tools 2023.10 -> 2024.01
696- update-rc.d 0.8 (8636cf478d42…) -> 0.8 (b8f950105010…)
697- usbutils 015 -> 017
698- util-linux 2.39.2 -> 2.39.3
699- util-linux-libuuid 2.39.2 -> 2.39.3
700- vala 0.56.13 -> 0.56.15
701- valgrind 3.21.0 -> 3.22.0
702- vim 9.0.2190 -> 9.1.0114
703- vim-tiny 9.0.2190 -> 9.1.0114
704- virglrenderer 0.10.4 -> 1.0.1
705- vte 0.72.2 -> 0.74.2
706- vulkan-headers 1.3.261.1 -> 1.3.275.0
707- vulkan-loader 1.3.261.1 -> 1.3.275.0
708- vulkan-tools 1.3.261.1 -> 1.3.275.0
709- vulkan-validation-layers 1.3.261.1 -> 1.3.275.0
710- wayland-protocols 1.32 -> 1.33
711- webkitgtk 2.40.5 -> 2.44.0
712- weston 12.0.2 -> 13.0.0
713- xkbcomp 1.4.6 -> 1.4.7
714- xkeyboard-config 2.39 -> 2.41
715- xprop 1.2.6 -> 1.2.7
716- xwayland 23.2.4 -> 23.2.5
717- xz 5.4.4 -> 5.4.6
718- zlib 1.3 -> 1.3.1
719
720
59Contributors to 5.0 721Contributors to 5.0
60~~~~~~~~~~~~~~~~~~~ 722~~~~~~~~~~~~~~~~~~~
61 723
62Thanks to the following people who contributed to this release: 724Thanks to the following people who contributed to this release:
63 725
726- Adam Johnston
727- Adithya Balakumar
728- Adrian Freihofer
729- Alassane Yattara
730- Alejandro Hernandez Samaniego
731- Aleksey Smirnov
732- Alexander Kanavin
733- Alexander Lussier-Cullen
734- Alexander Sverdlin
735- Alexandre Belloni
736- Alexandre Truong
737- Alex Bennée
738- Alexis Lothoré
739- Alex Kiernan
740- Alex Stewart
741- André Draszik
742- Anibal Limon
743- Anuj Mittal
744- Archana Polampalli
745- Arne Schwerdt
746- Bartosz Golaszewski
747- Baruch Siach
748- Bastian Krause
749- BELHADJ SALEM Talel
750- BELOUARGA Mohamed
751- Bruce Ashfield
752- Changhyeok Bae
753- Changqing Li
754- Charlie Johnston
755- Chen Qi
756- Chi Xu
757- Chris Laplante
758- Christian Taedcke
759- Christoph Vogtländer
760- Claus Stovgaard
761- Clay Chang
762- Clément Péron
763- Colin McAllister
764- Corentin Guillevic
765- Daniel Ammann
766- david d zuhn
767- David Reyna
768- Deepthi Hemraj
769- Denys Dmytriyenko
770- Derek Erdmann
771- Desone Burns
772- Dhairya Nagodra
773- Dmitry Baryshkov
774- Eero Aaltonen
775- Eilís 'pidge' Ní Fhlannagáin
776- Emil Kronborg
777- Enguerrand de Ribaucourt
778- Enrico Jörns
779- Enrico Scholz
780- Etienne Cordonnier
781- Fabien Mahot
782- Fabio Estevam
783- Fahad Arslan
784- Felix Moessbauer
785- Florian Wickert
786- Geoff Parker
787- Glenn Strauss
788- Harish Sadineni
789- Hongxu Jia
790- Ilya A. Kriveshko
791- Jamin Lin
792- Jan Vermaete
793- Jason Andryuk
794- Javier Tia
795- Jeremy A. Puhlman
796- Jérémy Rosen
797- Jermain Horsman
798- Jiang Kai
799- Joakim Tjernlund
800- Joao Marcos Costa
801- Joe Slater
802- Johan Bezem
803- Johannes Schneider
804- Jonathan GUILLOT
805- Jon Mason
806- Jörg Sommer
807- Jose Quaresma
808- Joshua Watt
809- Julien Stephan
810- Justin Bronder
811- Kai Kang
812- Kareem Zarka
813- Kevin Hao
814- Khem Raj
815- Konrad Weihmann
816- Lee Chee Yang
817- Lei Maohui
818- lixiaoyong
819- Logan Gunthorpe
820- Luca Ceresoli
821- luca fancellu
822- Lucas Stach
823- Ludovic Jozeau
824- Lukas Funke
825- Maanya Goenka
826- Malte Schmidt
827- Marcel Ziswiler
828- Marco Felsch
829- Marcus Folkesson
830- Marek Vasut
831- Mark Asselstine
832- Mark Hatle
833- Markus Fuchs
834- Markus Volk
835- Marlon Rodriguez Garcia
836- Marta Rybczynska
837- Martin Hundebøll
838- Martin Jansa
839- Massimiliano Minella
840- Maxin B. John
841- Max Krummenacher
842- Meenali Gupta
843- Michael Halstead
844- Michael Opdenacker
845- Michal Sieron
846- Mikko Rapeli
847- Ming Liu
848- Mingli Yu
849- Munehisa Kamata
850- Nick Owens
851- Niko Mauno
852- Ola x Nilsson
853- Oleh Matiusha
854- Patrick Williams
855- Paul Barker
856- Paul Eggleton
857- Paul Gortmaker
858- Pavel Zhukov
859- Peter A. Bigot
860- Peter Kjellerstedt
861- Peter Marko
862- Petr Vorel
863- Philip Balister
864- Philip Lorenz
865- Philippe Rivest
866- Piotr Łobacz
867- Priyal Doshi
868- Quentin Schulz
869- Ragesh Nair
870- Randolph Sapp
871- Randy MacLeod
872- Rasmus Villemoes
873- Renat Khalikov
874- Richard Haar
875- Richard Purdie
876- Robert Berger
877- Robert Joslyn
878- Robert P. J. Day
879- Robert Yang
880- Rodrigo M. Duarte
881- Ross Burton
882- Rouven Czerwinski
883- Ryan Eatmon
884- Sam Van Den Berge
885- Saul Wold
886- Sava Jakovljev
887- Sean Nyekjaer
888- Sergei Zhmylev
889- Shinji Matsunaga
890- Shubham Kulkarni
891- Simone Weiß
892- Siong W.LIM
893- Soumya Sambu
894- Sourav Kumar Pramanik
895- Stefan Herbrechtsmeier
896- Stéphane Veyret
897- Steve Sakoman
898- Sundeep KOKKONDA
899- Thomas Perrot
900- Thomas Wolber
901- Timon Bergelt
902- Tim Orling
903- Timotheus Giuliani
904- Tobias Hagelborn
905- Tom Hochstein
906- Tom Rini
907- Toni Lammi
908- Trevor Gamblin
909- Trevor Woerner
910- Ulrich Ölmann
911- Valek Andrej
912- venkata pyla
913- Victor Kamensky
914- Vijay Anusuri
915- Vikas Katariya
916- Vincent Davis Jr
917- Viswanath Kraleti
918- Vyacheslav Yurkov
919- Wang Mingyu
920- William A. Kennington III
921- William Hauser
922- William Lyu
923- Xiangyu Chen
924- Xiaotian Wu
925- Yang Xu
926- Yannick Rodriguez
927- Yash Shinde
928- Yi Zhao
929- Yoann Congal
930- Yogesh Tyagi
931- Yogita Urade
932- Zahir Hussain
933- Zang Ruochen
934- Zoltan Boszormenyi
935
64Repositories / Downloads for Yocto-5.0 936Repositories / Downloads for Yocto-5.0
65~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 937~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
66 938
939poky
940
941- Repository Location: :yocto_git:`/poky`
942- Branch: :yocto_git:`scarthgap </poky/log/?h=scarthgap>`
943- Tag: :yocto_git:`yocto-5.0 </poky/log/?h=yocto-5.0>`
944- Git Revision: :yocto_git:`fb91a49387cfb0c8d48303bb3354325ba2a05587 </poky/commit/?id=fb91a49387cfb0c8d48303bb3354325ba2a05587>`
945- Release Artefact: poky-fb91a49387cfb0c8d48303bb3354325ba2a05587
946- sha: 8a0dff4b677b9414ab814ed35d1880196123732ea16ab2fafa388bcc509b32ab
947- Download Locations:
948 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0/poky-fb91a49387cfb0c8d48303bb3354325ba2a05587.tar.bz2
949 http://mirrors.kernel.org/yocto/yocto/yocto-5.0/poky-fb91a49387cfb0c8d48303bb3354325ba2a05587.tar.bz2
950
951openembedded-core
952
953- Repository Location: :oe_git:`/openembedded-core`
954- Branch: :oe_git:`scarthgap </openembedded-core/log/?h=scarthgap>`
955- Tag: :oe_git:`yocto-5.0 </openembedded-core/log/?h=yocto-5.0>`
956- Git Revision: :oe_git:`b65b4e5a8e4473d8ca43835ba17bc8bd4bdca277 </openembedded-core/commit/?id=b65b4e5a8e4473d8ca43835ba17bc8bd4bdca277>`
957- Release Artefact: oecore-b65b4e5a8e4473d8ca43835ba17bc8bd4bdca277
958- sha: c7fd05d1a00c70acba2540e60dce01a1bdc4701ebff9a808784960240c69261d
959- Download Locations:
960 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0/oecore-b65b4e5a8e4473d8ca43835ba17bc8bd4bdca277.tar.bz2
961 http://mirrors.kernel.org/yocto/yocto/yocto-5.0/oecore-b65b4e5a8e4473d8ca43835ba17bc8bd4bdca277.tar.bz2
962
963meta-mingw
964
965- Repository Location: :yocto_git:`/meta-mingw`
966- Branch: :yocto_git:`scarthgap </meta-mingw/log/?h=scarthgap>`
967- Tag: :yocto_git:`yocto-5.0 </meta-mingw/log/?h=yocto-5.0>`
968- Git Revision: :yocto_git:`acbba477893ef87388effc4679b7f40ee49fc852 </meta-mingw/commit/?id=acbba477893ef87388effc4679b7f40ee49fc852>`
969- Release Artefact: meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852
970- sha: 3b7c2f475dad5130bace652b150367f587d44b391218b1364a8bbc430b48c54c
971- Download Locations:
972 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0/meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852.tar.bz2
973 http://mirrors.kernel.org/yocto/yocto/yocto-5.0/meta-mingw-acbba477893ef87388effc4679b7f40ee49fc852.tar.bz2
974
975bitbake
976
977- Repository Location: :oe_git:`/bitbake`
978- Branch: :oe_git:`2.8 </bitbake/log/?h=2.8>`
979- Tag: :oe_git:`yocto-5.0 </bitbake/log/?h=yocto-5.0>`
980- Git Revision: :oe_git:`c86466d51e8ff14e57a734c1eec5bb651fdc73ef </bitbake/commit/?id=c86466d51e8ff14e57a734c1eec5bb651fdc73ef>`
981- Release Artefact: bitbake-c86466d51e8ff14e57a734c1eec5bb651fdc73ef
982- sha: 45c91294c1fa5a0044f1bb72a9bb69456bb458747114115af85c7664bf672d48
983- Download Locations:
984 http://downloads.yoctoproject.org/releases/yocto/yocto-5.0/bitbake-c86466d51e8ff14e57a734c1eec5bb651fdc73ef.tar.bz2
985 http://mirrors.kernel.org/yocto/yocto/yocto-5.0/bitbake-c86466d51e8ff14e57a734c1eec5bb651fdc73ef.tar.bz2
986
987yocto-docs
988
989- Repository Location: :yocto_git:`/yocto-docs`
990- Branch: :yocto_git:`scarthgap </yocto-docs/log/?h=scarthgap>`
991- Tag: :yocto_git:`yocto-5.0 </yocto-docs/log/?h=yocto-5.0>`
992- Git Revision: :yocto_git:`0cdc0afd3332459d30cfc8f4c2e62bdcc23f5ed5 </yocto-docs/commit/?id=0cdc0afd3332459d30cfc8f4c2e62bdcc23f5ed5>`
993
diff --git a/documentation/migration-guides/release-notes-5.1.rst b/documentation/migration-guides/release-notes-5.1.rst
new file mode 100644
index 0000000000..32cb2de2b4
--- /dev/null
+++ b/documentation/migration-guides/release-notes-5.1.rst
@@ -0,0 +1,67 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release notes for 5.1 (styhead)
4---------------------------------
5
6New Features / Enhancements in 5.1
7~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8
9- Linux kernel 6.X, gcc 14.X, glibc 2.X, LLVM 18.X, and over XXX other recipe upgrades
10
11- New variables:
12
13- Architecture-specific enhancements:
14
15- Kernel-related enhancements:
16
17- New core recipes:
18
19- QEMU / ``runqemu`` enhancements:
20
21- Rust improvements:
22
23- wic Image Creator enhancements:
24
25- SDK-related improvements:
26
27- Testing:
28
29- Utility script changes:
30
31- BitBake improvements:
32
33- devtool improvements:
34
35- recipetool improvements:
36
37- Packaging changes:
38
39- Security improvements:
40
41- Toaster Web UI improvements:
42
43- Prominent documentation updates:
44
45- Miscellaneous changes:
46
47Known Issues in 5.1
48~~~~~~~~~~~~~~~~~~~
49
50Recipe License changes in 5.1
51~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52
53The following corrections have been made to the :term:`LICENSE` values set by recipes:
54
55Security Fixes in 5.1
56~~~~~~~~~~~~~~~~~~~~~
57
58Recipe Upgrades in 5.1
59~~~~~~~~~~~~~~~~~~~~~~
60
61Contributors to 5.1
62~~~~~~~~~~~~~~~~~~~
63
64Thanks to the following people who contributed to this release:
65
66Repositories / Downloads for Yocto-5.1
67~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/documentation/overview-manual/intro.rst b/documentation/overview-manual/intro.rst
index a8091771f4..80446b3810 100644
--- a/documentation/overview-manual/intro.rst
+++ b/documentation/overview-manual/intro.rst
@@ -38,7 +38,7 @@ This manual does not give you the following:
38 procedures reside in other manuals within the Yocto Project 38 procedures reside in other manuals within the Yocto Project
39 documentation set. For example, the :doc:`/dev-manual/index` 39 documentation set. For example, the :doc:`/dev-manual/index`
40 provides examples on how to perform 40 provides examples on how to perform
41 various development tasks. As another example, the 41 various development tasks. As another example, the
42 :doc:`/sdk-manual/index` manual contains detailed 42 :doc:`/sdk-manual/index` manual contains detailed
43 instructions on how to install an SDK, which is used to develop 43 instructions on how to install an SDK, which is used to develop
44 applications for target hardware. 44 applications for target hardware.
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 7a686ac4e1..0c04b615ea 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -1,10 +1,10 @@
1DISTRO : "4.3" 1DISTRO : "5.0"
2DISTRO_NAME_NO_CAP : "nanbield" 2DISTRO_NAME_NO_CAP : "scarthgap"
3DISTRO_NAME : "Nanbield" 3DISTRO_NAME : "Scarthgap"
4DISTRO_NAME_NO_CAP_MINUS_ONE : "mickledore" 4DISTRO_NAME_NO_CAP_MINUS_ONE : "nanbield"
5DISTRO_NAME_NO_CAP_LTS : "kirkstone" 5DISTRO_NAME_NO_CAP_LTS : "scarthgap"
6YOCTO_DOC_VERSION : "4.3" 6YOCTO_DOC_VERSION : "5.0"
7DISTRO_REL_TAG : "yocto-4.3" 7DISTRO_REL_TAG : "yocto-5.0"
8DOCCONF_VERSION : "dev" 8DOCCONF_VERSION : "dev"
9BITBAKE_SERIES : "" 9BITBAKE_SERIES : ""
10YOCTO_DL_URL : "https://downloads.yoctoproject.org" 10YOCTO_DL_URL : "https://downloads.yoctoproject.org"
@@ -12,18 +12,18 @@ YOCTO_AB_URL : "https://autobuilder.yoctoproject.org"
12YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;" 12YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;"
13UBUNTU_HOST_PACKAGES_ESSENTIAL : "gawk wget git diffstat unzip texinfo gcc \ 13UBUNTU_HOST_PACKAGES_ESSENTIAL : "gawk wget git diffstat unzip texinfo gcc \
14 build-essential chrpath socat cpio python3 python3-pip python3-pexpect \ 14 build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
15 xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \ 15 xz-utils debianutils iputils-ping python3-git python3-jinja2 \
16 python3-subunit mesa-common-dev zstd liblz4-tool file locales libacl1 16 python3-subunit zstd liblz4-tool file locales libacl1
17 \n\ $ sudo locale-gen en_US.UTF-8" 17 \n\ $ sudo locale-gen en_US.UTF-8"
18FEDORA_HOST_PACKAGES_ESSENTIAL : "gawk make wget tar bzip2 gzip python3 unzip perl patch \ 18FEDORA_HOST_PACKAGES_ESSENTIAL : "gawk make wget tar bzip2 gzip python3 unzip perl patch \
19 diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \ 19 diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \
20 ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum socat \ 20 ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum socat \
21 python3-pexpect findutils which file cpio python python3-pip xz python3-GitPython \ 21 python3-pexpect findutils which file cpio python python3-pip xz python3-GitPython \
22 python3-jinja2 SDL-devel rpcgen mesa-libGL-devel perl-FindBin perl-File-Compare \ 22 python3-jinja2 rpcgen perl-FindBin perl-File-Compare \
23 perl-File-Copy perl-locale zstd lz4 hostname glibc-langpack-en libacl" 23 perl-File-Copy perl-locale zstd lz4 hostname glibc-langpack-en libacl"
24OPENSUSE_HOST_PACKAGES_ESSENTIAL : "python gcc gcc-c++ git chrpath make wget python-xml \ 24OPENSUSE_HOST_PACKAGES_ESSENTIAL : "python gcc gcc-c++ git chrpath make wget python-xml \
25 diffstat makeinfo python-curses patch socat python3 python3-curses tar python3-pip \ 25 diffstat makeinfo python-curses patch socat python3 python3-curses tar python3-pip \
26 python3-pexpect xz which python3-Jinja2 Mesa-libEGL1 libSDL-devel rpcgen Mesa-dri-devel \ 26 python3-pexpect xz which python3-Jinja2 rpcgen \
27 zstd lz4 bzip2 gzip hostname libacl1 27 zstd lz4 bzip2 gzip hostname libacl1
28 \n\ $ sudo pip3 install GitPython" 28 \n\ $ sudo pip3 install GitPython"
29ALMALINUX_HOST_PACKAGES_ESSENTIAL : "-y epel-release 29ALMALINUX_HOST_PACKAGES_ESSENTIAL : "-y epel-release
@@ -33,8 +33,8 @@ ALMALINUX_HOST_PACKAGES_ESSENTIAL : "-y epel-release
33 \n\ $ sudo dnf install gawk make wget tar bzip2 gzip python3 unzip perl patch \ 33 \n\ $ sudo dnf install gawk make wget tar bzip2 gzip python3 unzip perl patch \
34 diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath ccache \ 34 diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath ccache \
35 socat perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip \ 35 socat perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip \
36 python3-GitPython python3-jinja2 python3-pexpect xz which SDL-devel \ 36 python3-GitPython python3-jinja2 python3-pexpect xz which \
37 rpcgen mesa-libGL-devel zstd lz4 cpio glibc-langpack-en libacl" 37 rpcgen zstd lz4 cpio glibc-langpack-en libacl"
38PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml" 38PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml"
39MIN_PYTHON_VERSION : "3.8.0" 39MIN_PYTHON_VERSION : "3.8.0"
40MIN_TAR_VERSION : "1.28" 40MIN_TAR_VERSION : "1.28"
diff --git a/documentation/profile-manual/usage.rst b/documentation/profile-manual/usage.rst
index 2f82137538..17be149580 100644
--- a/documentation/profile-manual/usage.rst
+++ b/documentation/profile-manual/usage.rst
@@ -1058,13 +1058,13 @@ section::
1058 name: do_fork 1058 name: do_fork
1059 ID: 944 1059 ID: 944
1060 format: 1060 format:
1061 field:unsigned short common_type; offset:0; size:2; signed:0; 1061 field:unsigned short common_type; offset:0; size:2; signed:0;
1062 field:unsigned char common_flags; offset:2; size:1; signed:0; 1062 field:unsigned char common_flags; offset:2; size:1; signed:0;
1063 field:unsigned char common_preempt_count; offset:3; size:1; signed:0; 1063 field:unsigned char common_preempt_count; offset:3; size:1; signed:0;
1064 field:int common_pid; offset:4; size:4; signed:1; 1064 field:int common_pid; offset:4; size:4; signed:1;
1065 field:int common_padding; offset:8; size:4; signed:1; 1065 field:int common_padding; offset:8; size:4; signed:1;
1066 1066
1067 field:unsigned long __probe_ip; offset:12; size:4; signed:0; 1067 field:unsigned long __probe_ip; offset:12; size:4; signed:0;
1068 1068
1069 print fmt: "(%lx)", REC->__probe_ip 1069 print fmt: "(%lx)", REC->__probe_ip
1070 1070
@@ -1550,17 +1550,17 @@ like ftrace to display the event as text. The format of the
1550 name: kmalloc 1550 name: kmalloc
1551 ID: 313 1551 ID: 313
1552 format: 1552 format:
1553 field:unsigned short common_type; offset:0; size:2; signed:0; 1553 field:unsigned short common_type; offset:0; size:2; signed:0;
1554 field:unsigned char common_flags; offset:2; size:1; signed:0; 1554 field:unsigned char common_flags; offset:2; size:1; signed:0;
1555 field:unsigned char common_preempt_count; offset:3; size:1; signed:0; 1555 field:unsigned char common_preempt_count; offset:3; size:1; signed:0;
1556 field:int common_pid; offset:4; size:4; signed:1; 1556 field:int common_pid; offset:4; size:4; signed:1;
1557 field:int common_padding; offset:8; size:4; signed:1; 1557 field:int common_padding; offset:8; size:4; signed:1;
1558 1558
1559 field:unsigned long call_site; offset:16; size:8; signed:0; 1559 field:unsigned long call_site; offset:16; size:8; signed:0;
1560 field:const void * ptr; offset:24; size:8; signed:0; 1560 field:const void * ptr; offset:24; size:8; signed:0;
1561 field:size_t bytes_req; offset:32; size:8; signed:0; 1561 field:size_t bytes_req; offset:32; size:8; signed:0;
1562 field:size_t bytes_alloc; offset:40; size:8; signed:0; 1562 field:size_t bytes_alloc; offset:40; size:8; signed:0;
1563 field:gfp_t gfp_flags; offset:48; size:4; signed:0; 1563 field:gfp_t gfp_flags; offset:48; size:4; signed:0;
1564 1564
1565 print fmt: "call_site=%lx ptr=%p bytes_req=%zu bytes_alloc=%zu gfp_flags=%s", REC->call_site, REC->ptr, REC->bytes_req, REC->bytes_alloc, 1565 print fmt: "call_site=%lx ptr=%p bytes_req=%zu bytes_alloc=%zu gfp_flags=%s", REC->call_site, REC->ptr, REC->bytes_req, REC->bytes_alloc,
1566 (REC->gfp_flags) ? __print_flags(REC->gfp_flags, "|", {(unsigned long)(((( gfp_t)0x10u) | (( gfp_t)0x40u) | (( gfp_t)0x80u) | (( 1566 (REC->gfp_flags) ? __print_flags(REC->gfp_flags, "|", {(unsigned long)(((( gfp_t)0x10u) | (( gfp_t)0x40u) | (( gfp_t)0x80u) | ((
@@ -1872,7 +1872,7 @@ Practically speaking, that means you need to do the following:
1872 1872
1873- Or build a non-SDK image but include the profiling tools 1873- Or build a non-SDK image but include the profiling tools
1874 (edit ``local.conf`` and add ``tools-profile`` to the end of 1874 (edit ``local.conf`` and add ``tools-profile`` to the end of
1875 :term:``EXTRA_IMAGE_FEATURES`` variable):: 1875 :term:`EXTRA_IMAGE_FEATURES` variable)::
1876 1876
1877 $ bitbake core-image-sato 1877 $ bitbake core-image-sato
1878 1878
@@ -2355,29 +2355,29 @@ first part of the filenames::
2355 8,32 1 0 58.516990819 0 m N cfq3551 put_queue 2355 8,32 1 0 58.516990819 0 m N cfq3551 put_queue
2356 2356
2357 CPU0 (sdc): 2357 CPU0 (sdc):
2358 Reads Queued: 0, 0KiB Writes Queued: 331, 26,284KiB 2358 Reads Queued: 0, 0KiB Writes Queued: 331, 26,284KiB
2359 Read Dispatches: 0, 0KiB Write Dispatches: 485, 40,484KiB 2359 Read Dispatches: 0, 0KiB Write Dispatches: 485, 40,484KiB
2360 Reads Requeued: 0 Writes Requeued: 0 2360 Reads Requeued: 0 Writes Requeued: 0
2361 Reads Completed: 0, 0KiB Writes Completed: 511, 41,000KiB 2361 Reads Completed: 0, 0KiB Writes Completed: 511, 41,000KiB
2362 Read Merges: 0, 0KiB Write Merges: 13, 160KiB 2362 Read Merges: 0, 0KiB Write Merges: 13, 160KiB
2363 Read depth: 0 Write depth: 2 2363 Read depth: 0 Write depth: 2
2364 IO unplugs: 23 Timer unplugs: 0 2364 IO unplugs: 23 Timer unplugs: 0
2365 CPU1 (sdc): 2365 CPU1 (sdc):
2366 Reads Queued: 0, 0KiB Writes Queued: 249, 15,800KiB 2366 Reads Queued: 0, 0KiB Writes Queued: 249, 15,800KiB
2367 Read Dispatches: 0, 0KiB Write Dispatches: 42, 1,600KiB 2367 Read Dispatches: 0, 0KiB Write Dispatches: 42, 1,600KiB
2368 Reads Requeued: 0 Writes Requeued: 0 2368 Reads Requeued: 0 Writes Requeued: 0
2369 Reads Completed: 0, 0KiB Writes Completed: 16, 1,084KiB 2369 Reads Completed: 0, 0KiB Writes Completed: 16, 1,084KiB
2370 Read Merges: 0, 0KiB Write Merges: 40, 276KiB 2370 Read Merges: 0, 0KiB Write Merges: 40, 276KiB
2371 Read depth: 0 Write depth: 2 2371 Read depth: 0 Write depth: 2
2372 IO unplugs: 30 Timer unplugs: 1 2372 IO unplugs: 30 Timer unplugs: 1
2373 2373
2374 Total (sdc): 2374 Total (sdc):
2375 Reads Queued: 0, 0KiB Writes Queued: 580, 42,084KiB 2375 Reads Queued: 0, 0KiB Writes Queued: 580, 42,084KiB
2376 Read Dispatches: 0, 0KiB Write Dispatches: 527, 42,084KiB 2376 Read Dispatches: 0, 0KiB Write Dispatches: 527, 42,084KiB
2377 Reads Requeued: 0 Writes Requeued: 0 2377 Reads Requeued: 0 Writes Requeued: 0
2378 Reads Completed: 0, 0KiB Writes Completed: 527, 42,084KiB 2378 Reads Completed: 0, 0KiB Writes Completed: 527, 42,084KiB
2379 Read Merges: 0, 0KiB Write Merges: 53, 436KiB 2379 Read Merges: 0, 0KiB Write Merges: 53, 436KiB
2380 IO unplugs: 53 Timer unplugs: 1 2380 IO unplugs: 53 Timer unplugs: 1
2381 2381
2382 Throughput (R/W): 0KiB/s / 719KiB/s 2382 Throughput (R/W): 0KiB/s / 719KiB/s
2383 Events (sdc): 6,592 entries 2383 Events (sdc): 6,592 entries
@@ -2500,29 +2500,29 @@ And run blkparse on the host system using the device name::
2500 8,32 1 0 177.266696560 0 m N cfq1267 put_queue 2500 8,32 1 0 177.266696560 0 m N cfq1267 put_queue
2501 2501
2502 CPU0 (sdc): 2502 CPU0 (sdc):
2503 Reads Queued: 0, 0KiB Writes Queued: 270, 21,708KiB 2503 Reads Queued: 0, 0KiB Writes Queued: 270, 21,708KiB
2504 Read Dispatches: 59, 2,628KiB Write Dispatches: 495, 39,964KiB 2504 Read Dispatches: 59, 2,628KiB Write Dispatches: 495, 39,964KiB
2505 Reads Requeued: 0 Writes Requeued: 0 2505 Reads Requeued: 0 Writes Requeued: 0
2506 Reads Completed: 90, 2,752KiB Writes Completed: 543, 41,596KiB 2506 Reads Completed: 90, 2,752KiB Writes Completed: 543, 41,596KiB
2507 Read Merges: 0, 0KiB Write Merges: 9, 344KiB 2507 Read Merges: 0, 0KiB Write Merges: 9, 344KiB
2508 Read depth: 2 Write depth: 2 2508 Read depth: 2 Write depth: 2
2509 IO unplugs: 20 Timer unplugs: 1 2509 IO unplugs: 20 Timer unplugs: 1
2510 CPU1 (sdc): 2510 CPU1 (sdc):
2511 Reads Queued: 688, 2,752KiB Writes Queued: 381, 20,652KiB 2511 Reads Queued: 688, 2,752KiB Writes Queued: 381, 20,652KiB
2512 Read Dispatches: 31, 124KiB Write Dispatches: 59, 2,396KiB 2512 Read Dispatches: 31, 124KiB Write Dispatches: 59, 2,396KiB
2513 Reads Requeued: 0 Writes Requeued: 0 2513 Reads Requeued: 0 Writes Requeued: 0
2514 Reads Completed: 0, 0KiB Writes Completed: 11, 764KiB 2514 Reads Completed: 0, 0KiB Writes Completed: 11, 764KiB
2515 Read Merges: 598, 2,392KiB Write Merges: 88, 448KiB 2515 Read Merges: 598, 2,392KiB Write Merges: 88, 448KiB
2516 Read depth: 2 Write depth: 2 2516 Read depth: 2 Write depth: 2
2517 IO unplugs: 52 Timer unplugs: 0 2517 IO unplugs: 52 Timer unplugs: 0
2518 2518
2519 Total (sdc): 2519 Total (sdc):
2520 Reads Queued: 688, 2,752KiB Writes Queued: 651, 42,360KiB 2520 Reads Queued: 688, 2,752KiB Writes Queued: 651, 42,360KiB
2521 Read Dispatches: 90, 2,752KiB Write Dispatches: 554, 42,360KiB 2521 Read Dispatches: 90, 2,752KiB Write Dispatches: 554, 42,360KiB
2522 Reads Requeued: 0 Writes Requeued: 0 2522 Reads Requeued: 0 Writes Requeued: 0
2523 Reads Completed: 90, 2,752KiB Writes Completed: 554, 42,360KiB 2523 Reads Completed: 90, 2,752KiB Writes Completed: 554, 42,360KiB
2524 Read Merges: 598, 2,392KiB Write Merges: 97, 792KiB 2524 Read Merges: 598, 2,392KiB Write Merges: 97, 792KiB
2525 IO unplugs: 72 Timer unplugs: 1 2525 IO unplugs: 72 Timer unplugs: 1
2526 2526
2527 Throughput (R/W): 15KiB/s / 238KiB/s 2527 Throughput (R/W): 15KiB/s / 238KiB/s
2528 Events (sdc): 9,301 entries 2528 Events (sdc): 9,301 entries
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index ab71cbe40c..9520d0bf7c 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -564,6 +564,13 @@ The ``Patched`` state of a CVE issue is detected from patch files with the forma
564``CVE-ID.patch``, e.g. ``CVE-2019-20633.patch``, in the :term:`SRC_URI` and using 564``CVE-ID.patch``, e.g. ``CVE-2019-20633.patch``, in the :term:`SRC_URI` and using
565CVE metadata of format ``CVE: CVE-ID`` in the commit message of the patch file. 565CVE metadata of format ``CVE: CVE-ID`` in the commit message of the patch file.
566 566
567.. note::
568
569 Commit message metadata (``CVE: CVE-ID`` in a patch header) will not be scanned
570 in any patches that are remote, i.e. that are anything other than local files
571 referenced via ``file://`` in SRC_URI. However, a ``CVE-ID`` in a remote patch
572 file name itself will be registered.
573
567If the recipe adds ``CVE-ID`` as flag of the :term:`CVE_STATUS` variable with status 574If the recipe adds ``CVE-ID`` as flag of the :term:`CVE_STATUS` variable with status
568mapped to ``Ignored``, then the CVE state is reported as ``Ignored``:: 575mapped to ``Ignored``, then the CVE state is reported as ``Ignored``::
569 576
@@ -665,7 +672,7 @@ The padding size can be modified by setting :term:`DT_PADDING_SIZE`
665to the desired size, in bytes. 672to the desired size, in bytes.
666 673
667See :oe_git:`devicetree.bbclass sources 674See :oe_git:`devicetree.bbclass sources
668</openembedded-core/tree/meta/classes-recipe/devicetree.bbclass>` 675</openembedded-core/tree/meta/classes-recipe/devicetree.bbclass>`
669for further variables controlling this class. 676for further variables controlling this class.
670 677
671Here is an excerpt of an example ``recipes-kernel/linux/devicetree-acme.bb`` 678Here is an excerpt of an example ``recipes-kernel/linux/devicetree-acme.bb``
@@ -939,6 +946,20 @@ The :ref:`ref-classes-go-mod` class allows to use Go modules, and inherits the
939 946
940See the associated :term:`GO_WORKDIR` variable. 947See the associated :term:`GO_WORKDIR` variable.
941 948
949.. _ref-classes-go-vendor:
950
951``go-vendor``
952=============
953
954The :ref:`ref-classes-go-vendor` class implements support for offline builds,
955also known as Go vendoring. In such a scenario, the module dependencias are
956downloaded during the :ref:`ref-tasks-fetch` task rather than when modules are
957imported, thus being coherent with Yocto's concept of fetching every source
958beforehand.
959
960The dependencies are unpacked into the modules' ``vendor`` directory, where a
961manifest file is generated.
962
942.. _ref-classes-gobject-introspection: 963.. _ref-classes-gobject-introspection:
943 964
944``gobject-introspection`` 965``gobject-introspection``
@@ -1568,6 +1589,12 @@ The tests you can list with the :term:`WARN_QA` and
1568 This is only relevant when you are using runtime package management 1589 This is only relevant when you are using runtime package management
1569 on your target system. 1590 on your target system.
1570 1591
1592- ``virtual-slash:`` Checks to see if ``virtual/`` is being used in
1593 :term:`RDEPENDS` or :term:`RPROVIDES`, which is not good practice ---
1594 ``virtual/`` is a convention intended for use in the build context
1595 (i.e. :term:`PROVIDES` and :term:`DEPENDS`) rather than the runtime
1596 context.
1597
1571- ``xorg-driver-abi:`` Checks that all packages containing Xorg 1598- ``xorg-driver-abi:`` Checks that all packages containing Xorg
1572 drivers have ABI dependencies. The ``xserver-xorg`` recipe provides 1599 drivers have ABI dependencies. The ``xserver-xorg`` recipe provides
1573 driver ABI names. All drivers should depend on the ABI versions that 1600 driver ABI names. All drivers should depend on the ABI versions that
@@ -2360,6 +2387,24 @@ Python modules built with ``flit_core.buildapi`` are pure Python (no
2360 2387
2361Internally this uses the :ref:`ref-classes-python_pep517` class. 2388Internally this uses the :ref:`ref-classes-python_pep517` class.
2362 2389
2390.. _ref-classes-python_maturin:
2391
2392``python_maturin``
2393==================
2394
2395The :ref:`ref-classes-python_maturin` class provides support for python-maturin, a replacement
2396for setuptools_rust and another "backend" for building Python Wheels.
2397
2398.. _ref-classes-python_mesonpy:
2399
2400``python_mesonpy``
2401==================
2402
2403The :ref:`ref-classes-python_mesonpy` class enables building Python modules which use the
2404meson-python build system.
2405
2406Internally this uses the :ref:`ref-classes-python_pep517` class.
2407
2363.. _ref-classes-python_pep517: 2408.. _ref-classes-python_pep517:
2364 2409
2365``python_pep517`` 2410``python_pep517``
@@ -3270,7 +3315,7 @@ The variables used by this class are:
3270- :term:`UBOOT_FIT_KEY_REQ_ARGS`: ``openssl req`` arguments. 3315- :term:`UBOOT_FIT_KEY_REQ_ARGS`: ``openssl req`` arguments.
3271- :term:`UBOOT_FIT_SIGN_ALG`: signature algorithm for the FIT image. 3316- :term:`UBOOT_FIT_SIGN_ALG`: signature algorithm for the FIT image.
3272- :term:`UBOOT_FIT_SIGN_NUMBITS`: size of the private key for FIT image 3317- :term:`UBOOT_FIT_SIGN_NUMBITS`: size of the private key for FIT image
3273 signing. 3318 signing.
3274- :term:`UBOOT_FIT_KEY_SIGN_PKCS`: algorithm for the public key certificate 3319- :term:`UBOOT_FIT_KEY_SIGN_PKCS`: algorithm for the public key certificate
3275 for FIT image signing. 3320 for FIT image signing.
3276- :term:`UBOOT_FITIMAGE_ENABLE`: enable the generation of a U-Boot FIT image. 3321- :term:`UBOOT_FITIMAGE_ENABLE`: enable the generation of a U-Boot FIT image.
diff --git a/documentation/ref-manual/qa-checks.rst b/documentation/ref-manual/qa-checks.rst
index 58526a0e57..53b1836e74 100644
--- a/documentation/ref-manual/qa-checks.rst
+++ b/documentation/ref-manual/qa-checks.rst
@@ -799,6 +799,14 @@ Errors and Warnings
799 section in the Yocto Project Development Tasks Manual. See also the 799 section in the Yocto Project Development Tasks Manual. See also the
800 ":ref:`ref-classes-ptest`" section. 800 ":ref:`ref-classes-ptest`" section.
801 801
802.. _qa-check-virtual-slash:
803
804- ``<variable> is set to <value> but the substring 'virtual/' holds no meaning in this context. It only works for build time dependencies, not runtime ones. It is suggested to use 'VIRTUAL-RUNTIME_' variables instead.``
805
806 ``virtual/`` is a convention intended for use in the build context
807 (i.e. :term:`PROVIDES` and :term:`DEPENDS`) rather than the runtime
808 context (i.e. :term:`RPROVIDES` and :term:`RDEPENDS`). Use
809 :term:`VIRTUAL-RUNTIME` variables instead for the latter.
802 810
803 811
804Configuring and Disabling QA Checks 812Configuring and Disabling QA Checks
diff --git a/documentation/ref-manual/resources.rst b/documentation/ref-manual/resources.rst
index 8e54ac87c9..4eaaca942e 100644
--- a/documentation/ref-manual/resources.rst
+++ b/documentation/ref-manual/resources.rst
@@ -66,6 +66,9 @@ instructions:
66- :yocto_lists:`/g/yocto` --- general Yocto Project 66- :yocto_lists:`/g/yocto` --- general Yocto Project
67 discussion mailing list. 67 discussion mailing list.
68 68
69- :yocto_lists:`/g/yocto-patches` --- patch contribution mailing list for Yocto
70 Project-related layers which do not have their own mailing list.
71
69- :oe_lists:`/g/openembedded-core` --- discussion mailing 72- :oe_lists:`/g/openembedded-core` --- discussion mailing
70 list about OpenEmbedded-Core (the core metadata). 73 list about OpenEmbedded-Core (the core metadata).
71 74
diff --git a/documentation/ref-manual/svg/releases.svg b/documentation/ref-manual/svg/releases.svg
index 198d4632b1..036aa467cc 100644
--- a/documentation/ref-manual/svg/releases.svg
+++ b/documentation/ref-manual/svg/releases.svg
@@ -3,8 +3,8 @@
3 version="1.1" 3 version="1.1"
4 id="svg2" 4 id="svg2"
5 width="2040.0006" 5 width="2040.0006"
6 height="624.30518" 6 height="669.30511"
7 viewBox="0 0 2040.0006 624.30515" 7 viewBox="0 0 2040.0006 669.30509"
8 sodipodi:docname="releases.svg" 8 sodipodi:docname="releases.svg"
9 inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)" 9 inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)"
10 xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" 10 xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
@@ -409,8 +409,8 @@
409 id="namedview4" 409 id="namedview4"
410 showgrid="true" 410 showgrid="true"
411 inkscape:zoom="1.4472045" 411 inkscape:zoom="1.4472045"
412 inkscape:cx="736.24703" 412 inkscape:cx="987.76641"
413 inkscape:cy="312.32629" 413 inkscape:cy="357.93145"
414 inkscape:window-x="1728" 414 inkscape:window-x="1728"
415 inkscape:window-y="0" 415 inkscape:window-y="0"
416 inkscape:window-maximized="1" 416 inkscape:window-maximized="1"
@@ -427,13 +427,13 @@
427 type="xygrid" 427 type="xygrid"
428 id="grid1257" 428 id="grid1257"
429 originx="-289.99936" 429 originx="-289.99936"
430 originy="325" /> 430 originy="369.99998" />
431 </sodipodi:namedview> 431 </sodipodi:namedview>
432 <g 432 <g
433 inkscape:groupmode="layer" 433 inkscape:groupmode="layer"
434 inkscape:label="Image" 434 inkscape:label="Image"
435 id="g10" 435 id="g10"
436 transform="translate(-289.99936,325.00004)"> 436 transform="translate(-289.99936,370.00003)">
437 <path 437 <path
438 style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" 438 style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
439 d="m 1080,220.00003 v -515.00007 0 0" 439 d="m 1080,220.00003 v -515.00007 0 0"
@@ -669,11 +669,11 @@
669 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none" 669 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
670 id="tspan10317-2-9-1-4">4.2</tspan></text> 670 id="tspan10317-2-9-1-4">4.2</tspan></text>
671 <g 671 <g
672 id="g1379"> 672 id="g1258">
673 <rect 673 <rect
674 style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1" 674 style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
675 id="rect917-0-0-4-4-9-4-5-38" 675 id="rect917-0-0-4-4-9-4-5-38"
676 width="140.00003" 676 width="120.00002"
677 height="45.000004" 677 height="45.000004"
678 x="1220" 678 x="1220"
679 y="-230.00005" 679 y="-230.00005"
@@ -696,53 +696,76 @@
696 id="tspan10317-2-9-1-4-6">4.3</tspan></text> 696 id="tspan10317-2-9-1-4-6">4.3</tspan></text>
697 </g> 697 </g>
698 <rect 698 <rect
699 style="opacity:0.75;fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1" 699 style="opacity:0.75;fill:#241f31;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
700 id="rect917-0-0-4-4-9-4-5-3-9" 700 id="rect917-0-0-4-4-9-4-5-3-9-2"
701 width="979.99994" 701 width="140"
702 height="45.000004" 702 height="45.000004"
703 x="1320" 703 x="1440"
704 y="-285.00003" 704 y="-340.00003"
705 ry="2.2558987" /> 705 ry="2.2558987" />
706 <text 706 <text
707 xml:space="preserve" 707 xml:space="preserve"
708 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" 708 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
709 x="1373.233" 709 x="1487.233"
710 y="-265.32928" 710 y="-320.32928"
711 id="text1185-3-55-4-0-0-0-1-1-6"><tspan 711 id="text1185-3-55-4-0-0-0-1-1-6-4"><tspan
712 sodipodi:role="line" 712 sodipodi:role="line"
713 x="1373.233" 713 x="1487.233"
714 y="-265.32928" 714 y="-320.32928"
715 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none" 715 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
716 id="tspan957-2-8-6-3-9-7-4-2">Scarthgap</tspan><tspan 716 id="tspan957-2-8-6-3-9-7-4-2-0">Styhead</tspan><tspan
717 sodipodi:role="line" 717 sodipodi:role="line"
718 x="1373.233" 718 x="1487.233"
719 y="-247.33261" 719 y="-302.33261"
720 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none" 720 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
721 id="tspan10317-2-9-1-4-6-5">5.0</tspan></text> 721 id="tspan10317-2-9-1-4-6-5-6">5.1</tspan></text>
722 <rect 722 <g
723 id="g1591">
724 <rect
725 style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
726 id="rect917-0-0-4-4-9-9"
727 width="960.00012"
728 height="45.000004"
729 x="859.99994"
730 y="-64.999992"
731 ry="2.2558987" />
732 <text
733 xml:space="preserve"
734 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
735 x="928.49872"
736 y="-45.648258"
737 id="text1185-3-55-4-0-0-9"><tspan
738 sodipodi:role="line"
739 x="928.49872"
740 y="-45.648258"
741 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
742 id="tspan957-2-8-6-3-6">Kirkstone (LTS)</tspan><tspan
743 sodipodi:role="line"
744 x="928.49872"
745 y="-27.651579"
746 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
747 id="tspan10317-2-9-0">4.0</tspan></text>
748 </g>
749 <path
750 id="rect917-0-0-4-4-9-9-9"
723 style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1" 751 style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
724 id="rect917-0-0-4-4-9-9" 752 d="m 1322.3015,-285.00003 c -1.2753,0 -2.302,1.00609 -2.302,2.25586 v 40.48828 c 0,1.24977 1.0267,2.25586 2.302,2.25586 h 975.0412 c 1.2754,0 2.302,-1.00609 2.302,-2.25586 v -40.48828 c 0,-1.24977 -1.0266,-2.25586 -2.302,-2.25586 z" />
725 width="960.00012"
726 height="45.000004"
727 x="859.99994"
728 y="-64.999992"
729 ry="2.2558987" />
730 <text 753 <text
731 xml:space="preserve" 754 xml:space="preserve"
732 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" 755 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
733 x="928.49872" 756 x="1390.4988"
734 y="-45.648258" 757 y="-265.64832"
735 id="text1185-3-55-4-0-0-9"><tspan 758 id="text1185-3-55-4-0-0-9-0"><tspan
736 sodipodi:role="line" 759 sodipodi:role="line"
737 x="928.49872" 760 x="1390.4988"
738 y="-45.648258" 761 y="-265.64832"
739 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none" 762 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
740 id="tspan957-2-8-6-3-6">Kirkstone (LTS)</tspan><tspan 763 id="tspan957-2-8-6-3-6-8">Scarthgap (LTS)</tspan><tspan
741 sodipodi:role="line" 764 sodipodi:role="line"
742 x="928.49872" 765 x="1390.4988"
743 y="-27.651579" 766 y="-247.65164"
744 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none" 767 style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
745 id="tspan10317-2-9-0">4.0</tspan></text> 768 id="tspan10317-2-9-0-1">5.0</tspan></text>
746 <text 769 <text
747 xml:space="preserve" 770 xml:space="preserve"
748 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" 771 style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index c28cd7a94a..df751d75a3 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -358,7 +358,7 @@ information.
358``do_populate_sdk_ext`` 358``do_populate_sdk_ext``
359----------------------- 359-----------------------
360 360
361Creates the file and directory structure for an installable extensible 361Creates the file and directory structure for an installable extensible
362SDK (eSDK). See the ":ref:`overview-manual/concepts:sdk generation`" 362SDK (eSDK). See the ":ref:`overview-manual/concepts:sdk generation`"
363section in the Yocto Project Overview and Concepts Manual for more 363section in the Yocto Project Overview and Concepts Manual for more
364information. 364information.
@@ -412,12 +412,11 @@ them. You can learn more by looking at the
412------------- 412-------------
413 413
414Unpacks the source code into a working directory pointed to by 414Unpacks the source code into a working directory pointed to by
415``${``\ :term:`WORKDIR`\ ``}``. The :term:`S` 415``${``\ :term:`UNPACKDIR`\ ``}``. A legacy way to specify
416variable also plays a role in where unpacked source files ultimately 416this directory is through the :term:`S` and :term:`WORKDIR` variables.
417reside. For more information on how source files are unpacked, see the 417For more information on how source files are unpacked, see the
418":ref:`overview-manual/concepts:source fetching`" 418":ref:`overview-manual/concepts:source fetching`"
419section in the Yocto Project Overview and Concepts Manual and also see 419section in the Yocto Project Overview and Concepts Manual.
420the :term:`WORKDIR` and :term:`S` variable descriptions.
421 420
422Manually Called Tasks 421Manually Called Tasks
423===================== 422=====================
diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst
index ad9c46c339..b18c4183b6 100644
--- a/documentation/ref-manual/terms.rst
+++ b/documentation/ref-manual/terms.rst
@@ -228,23 +228,23 @@ universal, the list includes them just in case:
228 228
229 As far as bootloaders are concerned, :term:`Initramfs` and "initrd" 229 As far as bootloaders are concerned, :term:`Initramfs` and "initrd"
230 images are still copied to RAM in the same way. That's why most 230 images are still copied to RAM in the same way. That's why most
231 most bootloaders refer to :term:`Initramfs` images as "initrd" 231 most bootloaders refer to :term:`Initramfs` images as "initrd"
232 or "init RAM disk". 232 or "init RAM disk".
233 233
234 This kind of mechanism is typically used for two reasons: 234 This kind of mechanism is typically used for two reasons:
235 235
236 - For booting the same kernel binary on multiple systems requiring 236 - For booting the same kernel binary on multiple systems requiring
237 different device drivers. The :term:`Initramfs` image is then customized 237 different device drivers. The :term:`Initramfs` image is then customized
238 for each type of system, to include the specific kernel modules 238 for each type of system, to include the specific kernel modules
239 necessary to access the final root filesystem. This technique 239 necessary to access the final root filesystem. This technique
240 is used on all GNU / Linux distributions for desktops and servers. 240 is used on all GNU / Linux distributions for desktops and servers.
241 241
242 - For booting faster. As the root filesystem is extracted into RAM, 242 - For booting faster. As the root filesystem is extracted into RAM,
243 accessing the first user-space applications is very fast, compared 243 accessing the first user-space applications is very fast, compared
244 to having to initialize a block device, to access multiple blocks 244 to having to initialize a block device, to access multiple blocks
245 from it, and to go through a filesystem having its own overhead. 245 from it, and to go through a filesystem having its own overhead.
246 For example, this allows to display a splashscreen very early, 246 For example, this allows to display a splashscreen very early,
247 and to later take care of mounting the final root filesystem and 247 and to later take care of mounting the final root filesystem and
248 loading less time-critical kernel drivers. 248 loading less time-critical kernel drivers.
249 249
250 This cpio archive can either be loaded to RAM by the bootloader, 250 This cpio archive can either be loaded to RAM by the bootloader,
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 435481c9aa..07b5b6f95c 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -561,6 +561,10 @@ system and gives an overview of their function and contents.
561 :term:`BB_INVALIDCONF` 561 :term:`BB_INVALIDCONF`
562 See :term:`bitbake:BB_INVALIDCONF` in the BitBake manual. 562 See :term:`bitbake:BB_INVALIDCONF` in the BitBake manual.
563 563
564 :term:`BB_LOADFACTOR_MAX`
565 The system load threshold above which BitBake will stop runnig extra
566 tasks.
567
564 :term:`BB_LOGCONFIG` 568 :term:`BB_LOGCONFIG`
565 See :term:`bitbake:BB_LOGCONFIG` in the BitBake manual. 569 See :term:`bitbake:BB_LOGCONFIG` in the BitBake manual.
566 570
@@ -1688,6 +1692,11 @@ system and gives an overview of their function and contents.
1688 The list of package names (:term:`PN`) for which 1692 The list of package names (:term:`PN`) for which
1689 CVEs (Common Vulnerabilities and Exposures) are ignored. 1693 CVEs (Common Vulnerabilities and Exposures) are ignored.
1690 1694
1695 :term:`CVE_DB_INCR_UPDATE_AGE_THRES`
1696 Specifies the maximum age of the CVE database in seconds for an
1697 incremental update (instead of a full-download). Use "0" to force a
1698 full-download.
1699
1691 :term:`CVE_DB_UPDATE_INTERVAL` 1700 :term:`CVE_DB_UPDATE_INTERVAL`
1692 Specifies the CVE database update interval in seconds, as used by 1701 Specifies the CVE database update interval in seconds, as used by
1693 ``cve-update-db-native``. The default value is "86400" i.e. once a day 1702 ``cve-update-db-native``. The default value is "86400" i.e. once a day
@@ -2330,6 +2339,12 @@ system and gives an overview of their function and contents.
2330 See the :ref:`ref-classes-systemd-boot` and :ref:`ref-classes-image-live` 2339 See the :ref:`ref-classes-systemd-boot` and :ref:`ref-classes-image-live`
2331 classes for more information. 2340 classes for more information.
2332 2341
2342 :term:`EFI_UKI_DIR`
2343 The primary place for the UKI image inside the EFI System Partition.
2344
2345 :term:`EFI_UKI_PATH`
2346 The path for the UKI image inside the root filesystem.
2347
2333 :term:`ENABLE_BINARY_LOCALE_GENERATION` 2348 :term:`ENABLE_BINARY_LOCALE_GENERATION`
2334 Variable that controls which locales for ``glibc`` are generated 2349 Variable that controls which locales for ``glibc`` are generated
2335 during the build (useful if the target device has 64Mbytes of RAM or 2350 during the build (useful if the target device has 64Mbytes of RAM or
@@ -2983,18 +2998,18 @@ system and gives an overview of their function and contents.
2983 2998
2984 :term:`FIT_ADDRESS_CELLS` 2999 :term:`FIT_ADDRESS_CELLS`
2985 Specifies the value of the ``#address-cells`` value for the 3000 Specifies the value of the ``#address-cells`` value for the
2986 description of the FIT image. 3001 description of the FIT image.
2987 3002
2988 The default value is set to "1" by the :ref:`ref-classes-kernel-fitimage` 3003 The default value is set to "1" by the :ref:`ref-classes-kernel-fitimage`
2989 class, which corresponds to 32 bit addresses. 3004 class, which corresponds to 32 bit addresses.
2990 3005
2991 For platforms that need to set 64 bit addresses, for example in 3006 For platforms that need to set 64 bit addresses, for example in
2992 :term:`UBOOT_LOADADDRESS` and :term:`UBOOT_ENTRYPOINT`, you need to 3007 :term:`UBOOT_LOADADDRESS` and :term:`UBOOT_ENTRYPOINT`, you need to
2993 set this value to "2", as two 32 bit values (cells) will be needed 3008 set this value to "2", as two 32 bit values (cells) will be needed
2994 to represent such addresses. 3009 to represent such addresses.
2995 3010
2996 Here is an example setting "0x400000000" as a load address:: 3011 Here is an example setting "0x400000000" as a load address::
2997 3012
2998 FIT_ADDRESS_CELLS = "2" 3013 FIT_ADDRESS_CELLS = "2"
2999 UBOOT_LOADADDRESS= "0x04 0x00000000" 3014 UBOOT_LOADADDRESS= "0x04 0x00000000"
3000 3015
@@ -3971,15 +3986,15 @@ system and gives an overview of their function and contents.
3971 Specifies a space-separated list of license names (as they would 3986 Specifies a space-separated list of license names (as they would
3972 appear in :term:`LICENSE`) that should be excluded 3987 appear in :term:`LICENSE`) that should be excluded
3973 from the build (if set globally), or from an image (if set locally 3988 from the build (if set globally), or from an image (if set locally
3974 in an image recipe). 3989 in an image recipe).
3975 3990
3976 When the variable is set globally, recipes that provide no alternatives to listed 3991 When the variable is set globally, recipes that provide no alternatives to listed
3977 incompatible licenses are not built. Packages that are individually 3992 incompatible licenses are not built. Packages that are individually
3978 licensed with the specified incompatible licenses will be deleted. 3993 licensed with the specified incompatible licenses will be deleted.
3979 Most of the time this does not allow a feasible build (because it becomes impossible 3994 Most of the time this does not allow a feasible build (because it becomes impossible
3980 to satisfy build time dependencies), so the recommended way to 3995 to satisfy build time dependencies), so the recommended way to
3981 implement license restrictions is to set the variable in specific 3996 implement license restrictions is to set the variable in specific
3982 image recipes where the restrictions must apply. That way there 3997 image recipes where the restrictions must apply. That way there
3983 are no build time restrictions, but the license check is still 3998 are no build time restrictions, but the license check is still
3984 performed when the image's filesystem is assembled from packages. 3999 performed when the image's filesystem is assembled from packages.
3985 4000
@@ -4033,7 +4048,7 @@ system and gives an overview of their function and contents.
4033 The default value of the variable is set as follows in the 4048 The default value of the variable is set as follows in the
4034 ``meta/conf/distro/defaultsetup.conf`` file:: 4049 ``meta/conf/distro/defaultsetup.conf`` file::
4035 4050
4036 INHERIT_DISTRO ?= "debian devshell sstate license" 4051 INHERIT_DISTRO ?= "debian devshell sstate license remove-libtool create-spdx"
4037 4052
4038 :term:`INHIBIT_DEFAULT_DEPS` 4053 :term:`INHIBIT_DEFAULT_DEPS`
4039 Prevents the default dependencies, namely the C compiler and standard 4054 Prevents the default dependencies, namely the C compiler and standard
@@ -4495,12 +4510,12 @@ system and gives an overview of their function and contents.
4495 When kernel configuration fragments are missing for some 4510 When kernel configuration fragments are missing for some
4496 :term:`KERNEL_FEATURES` specified by layers or BSPs, 4511 :term:`KERNEL_FEATURES` specified by layers or BSPs,
4497 building and configuring the kernel stops with an error. 4512 building and configuring the kernel stops with an error.
4498 4513
4499 You can turn these errors into warnings by setting the 4514 You can turn these errors into warnings by setting the
4500 following in ``conf/local.conf``:: 4515 following in ``conf/local.conf``::
4501 4516
4502 KERNEL_DANGLING_FEATURES_WARN_ONLY = "1" 4517 KERNEL_DANGLING_FEATURES_WARN_ONLY = "1"
4503 4518
4504 You will still be warned that runtime issues may occur, 4519 You will still be warned that runtime issues may occur,
4505 but at least the kernel configuration and build process will 4520 but at least the kernel configuration and build process will
4506 be allowed to continue. 4521 be allowed to continue.
@@ -5570,6 +5585,21 @@ system and gives an overview of their function and contents.
5570 5585
5571 NON_MULTILIB_RECIPES = "grub grub-efi make-mod-scripts ovmf u-boot" 5586 NON_MULTILIB_RECIPES = "grub grub-efi make-mod-scripts ovmf u-boot"
5572 5587
5588 :term:`NVDCVE_API_KEY`
5589 The NVD API key used to retrieve data from the CVE database when
5590 using :ref:`ref-classes-cve-check`.
5591
5592 By default, no API key is used, which results in larger delays between API
5593 requests and limits the number of queries to the public rate limits posted
5594 at the `NVD developer's page <https://nvd.nist.gov/developers/start-here>`__.
5595
5596 NVD API keys can be requested through the
5597 `Request an API Key <https://nvd.nist.gov/developers/request-an-api-key>`__
5598 page. You can set this variable to the NVD API key in your ``local.conf`` file.
5599 Example::
5600
5601 NVDCVE_API_KEY = "fe753&7a2-1427-347d-23ff-b2e2b7ca5f3"
5602
5573 :term:`OBJCOPY` 5603 :term:`OBJCOPY`
5574 The minimal command and arguments to run ``objcopy``. 5604 The minimal command and arguments to run ``objcopy``.
5575 5605
@@ -5666,6 +5696,9 @@ system and gives an overview of their function and contents.
5666 default by setting the variable in a custom distribution 5696 default by setting the variable in a custom distribution
5667 configuration file. 5697 configuration file.
5668 5698
5699 :term:`OPKG_MAKE_INDEX_EXTRA_PARAMS`
5700 Specifies extra parameters for the ``opkg-make-index`` command.
5701
5669 :term:`OVERLAYFS_ETC_DEVICE` 5702 :term:`OVERLAYFS_ETC_DEVICE`
5670 When the :ref:`ref-classes-overlayfs-etc` class is 5703 When the :ref:`ref-classes-overlayfs-etc` class is
5671 inherited, specifies the device to be mounted for the read/write 5704 inherited, specifies the device to be mounted for the read/write
@@ -6811,6 +6844,19 @@ system and gives an overview of their function and contents.
6811 explicitly if that will not match the package name (e.g. where the 6844 explicitly if that will not match the package name (e.g. where the
6812 package name has a prefix, underscores, uppercase letters etc.) 6845 package name has a prefix, underscores, uppercase letters etc.)
6813 6846
6847 :term:`PYPI_PACKAGE_EXT`
6848 When inheriting the :ref:`ref-classes-pypi` class, specifies the
6849 file extension to use when fetching a package from `PyPI
6850 <https://pypi.org/>`__. Default is ``tar.gz``.
6851
6852 :term:`PYPI_SRC_URI`
6853 When inheriting the :ref:`ref-classes-pypi` class, specifies the
6854 full `pythonhosted <https://files.pythonhosted.org/>`__ URI for
6855 fetching the package to be built. The default value is constructed
6856 based upon :term:`PYPI_PACKAGE`, :term:`PYPI_PACKAGE_EXT`, and
6857 :term:`PV`. Most recipes will not need to set this variable unless
6858 they are building an unstable (i.e. development) version.
6859
6814 :term:`PYTHON_ABI` 6860 :term:`PYTHON_ABI`
6815 When used by recipes that inherit the :ref:`ref-classes-setuptools3` 6861 When used by recipes that inherit the :ref:`ref-classes-setuptools3`
6816 class, denotes the Application Binary Interface (ABI) currently in use 6862 class, denotes the Application Binary Interface (ABI) currently in use
@@ -7147,6 +7193,9 @@ system and gives an overview of their function and contents.
7147 :term:`IMAGE_ROOTFS` variable for more 7193 :term:`IMAGE_ROOTFS` variable for more
7148 information. 7194 information.
7149 7195
7196 :term:`RPMBUILD_EXTRA_PARAMS`
7197 Specifies extra user-defined parameters for the ``rpmbuild`` command.
7198
7150 :term:`RPROVIDES` 7199 :term:`RPROVIDES`
7151 A list of package name aliases that a package also provides. These 7200 A list of package name aliases that a package also provides. These
7152 aliases are useful for satisfying runtime dependencies of other 7201 aliases are useful for satisfying runtime dependencies of other
@@ -7868,7 +7917,7 @@ system and gives an overview of their function and contents.
7868 This option allows to associate `SPDX annotations 7917 This option allows to associate `SPDX annotations
7869 <https://spdx.github.io/spdx-spec/v2.3/annotations/>`__ to a recipe, 7918 <https://spdx.github.io/spdx-spec/v2.3/annotations/>`__ to a recipe,
7870 using the values of variables in the recipe:: 7919 using the values of variables in the recipe::
7871 7920
7872 ANNOTATION1 = "First annotation for recipe" 7921 ANNOTATION1 = "First annotation for recipe"
7873 ANNOTATION2 = "Second annotation for recipe" 7922 ANNOTATION2 = "Second annotation for recipe"
7874 SPDX_CUSTOM_ANNOTATION_VARS = "ANNOTATION1 ANNOTATION2" 7923 SPDX_CUSTOM_ANNOTATION_VARS = "ANNOTATION1 ANNOTATION2"
@@ -7991,7 +8040,7 @@ system and gives an overview of their function and contents.
7991 The name of keys used by the :ref:`ref-classes-kernel-fitimage` class 8040 The name of keys used by the :ref:`ref-classes-kernel-fitimage` class
7992 for signing U-Boot FIT image stored in the :term:`SPL_SIGN_KEYDIR` 8041 for signing U-Boot FIT image stored in the :term:`SPL_SIGN_KEYDIR`
7993 directory. If we have for example a ``dev.key`` key and a ``dev.crt`` 8042 directory. If we have for example a ``dev.key`` key and a ``dev.crt``
7994 certificate stored in the :term:`SPL_SIGN_KEYDIR` directory, you will 8043 certificate stored in the :term:`SPL_SIGN_KEYDIR` directory, you will
7995 have to set :term:`SPL_SIGN_KEYNAME` to ``dev``. 8044 have to set :term:`SPL_SIGN_KEYNAME` to ``dev``.
7996 8045
7997 :term:`SPLASH` 8046 :term:`SPLASH`
@@ -8028,7 +8077,7 @@ system and gives an overview of their function and contents.
8028 8077
8029 EXTRA_OECONF += "--disable-startup-msg --enable-img-fullscreen" 8078 EXTRA_OECONF += "--disable-startup-msg --enable-img-fullscreen"
8030 8079
8031 For information on append files, see the 8080 For information on append files, see the
8032 ":ref:`dev-manual/layers:appending other layers metadata with your layer`" 8081 ":ref:`dev-manual/layers:appending other layers metadata with your layer`"
8033 section. 8082 section.
8034 8083
@@ -8792,6 +8841,10 @@ system and gives an overview of their function and contents.
8792 value so that executables built using the SDK also have the flags 8841 value so that executables built using the SDK also have the flags
8793 applied. 8842 applied.
8794 8843
8844 :term:`TARGET_DBGSRC_DIR`
8845 Specifies the target path to debug source files. The default is
8846 ``/usr/src/debug/${PN}/${PV}``.
8847
8795 :term:`TARGET_FPU` 8848 :term:`TARGET_FPU`
8796 Specifies the method for handling FPU code. For FPU-less targets, 8849 Specifies the method for handling FPU code. For FPU-less targets,
8797 which include most ARM CPUs, the variable must be set to "soft". If 8850 which include most ARM CPUs, the variable must be set to "soft". If
@@ -9442,10 +9495,10 @@ system and gives an overview of their function and contents.
9442 9495
9443 :term:`UBOOT_FIT_ADDRESS_CELLS` 9496 :term:`UBOOT_FIT_ADDRESS_CELLS`
9444 Specifies the value of the ``#address-cells`` value for the 9497 Specifies the value of the ``#address-cells`` value for the
9445 description of the U-Boot FIT image. 9498 description of the U-Boot FIT image.
9446 9499
9447 The default value is set to "1" by the :ref:`ref-classes-uboot-sign` 9500 The default value is set to "1" by the :ref:`ref-classes-uboot-sign`
9448 class, which corresponds to 32 bit addresses. 9501 class, which corresponds to 32 bit addresses.
9449 9502
9450 For platforms that need to set 64 bit addresses in 9503 For platforms that need to set 64 bit addresses in
9451 :term:`UBOOT_LOADADDRESS` and :term:`UBOOT_ENTRYPOINT`, you need to 9504 :term:`UBOOT_LOADADDRESS` and :term:`UBOOT_ENTRYPOINT`, you need to
@@ -9453,7 +9506,7 @@ system and gives an overview of their function and contents.
9453 to represent such addresses. 9506 to represent such addresses.
9454 9507
9455 Here is an example setting "0x400000000" as a load address:: 9508 Here is an example setting "0x400000000" as a load address::
9456 9509
9457 UBOOT_FIT_ADDRESS_CELLS = "2" 9510 UBOOT_FIT_ADDRESS_CELLS = "2"
9458 UBOOT_LOADADDRESS= "0x04 0x00000000" 9511 UBOOT_LOADADDRESS= "0x04 0x00000000"
9459 9512
@@ -9516,7 +9569,7 @@ system and gives an overview of their function and contents.
9516 UBOOT_FITIMAGE_ENABLE = "1" 9569 UBOOT_FITIMAGE_ENABLE = "1"
9517 9570
9518 See the :ref:`ref-classes-uboot-sign` class for details. 9571 See the :ref:`ref-classes-uboot-sign` class for details.
9519 9572
9520 :term:`UBOOT_LOADADDRESS` 9573 :term:`UBOOT_LOADADDRESS`
9521 Specifies the load address for the U-Boot image. During U-Boot image 9574 Specifies the load address for the U-Boot image. During U-Boot image
9522 creation, the :term:`UBOOT_LOADADDRESS` variable is passed as a 9575 creation, the :term:`UBOOT_LOADADDRESS` variable is passed as a
@@ -9645,6 +9698,11 @@ system and gives an overview of their function and contents.
9645 :ref:`ref-classes-insane` class and is only enabled if the 9698 :ref:`ref-classes-insane` class and is only enabled if the
9646 recipe inherits the :ref:`ref-classes-autotools` class. 9699 recipe inherits the :ref:`ref-classes-autotools` class.
9647 9700
9701 :term:`UNPACKDIR`
9702 This variable, used by the :ref:`ref-classes-base` class,
9703 specifies where fetches sources should be unpacked by the
9704 :ref:`ref-tasks-unpack` task.
9705
9648 :term:`UPDATERCPN` 9706 :term:`UPDATERCPN`
9649 For recipes inheriting the 9707 For recipes inheriting the
9650 :ref:`ref-classes-update-rc.d` class, :term:`UPDATERCPN` 9708 :ref:`ref-classes-update-rc.d` class, :term:`UPDATERCPN`
@@ -9746,6 +9804,12 @@ system and gives an overview of their function and contents.
9746 ``meta-poky/conf/templates/default/local.conf.sample`` in the 9804 ``meta-poky/conf/templates/default/local.conf.sample`` in the
9747 :term:`Source Directory`. 9805 :term:`Source Directory`.
9748 9806
9807 :term:`USERADD_DEPENDS`
9808 Specifies a list of recipes that create users / groups (via
9809 :term:`USERADD_PARAM` / :term:`GROUPADD_PARAM`) which a recipe
9810 depends upon. This ensures that those users / groups are available
9811 when building a recipe.
9812
9749 :term:`USERADD_ERROR_DYNAMIC` 9813 :term:`USERADD_ERROR_DYNAMIC`
9750 If set to ``error``, forces the OpenEmbedded build system to produce 9814 If set to ``error``, forces the OpenEmbedded build system to produce
9751 an error if the user identification (``uid``) and group 9815 an error if the user identification (``uid``) and group
diff --git a/documentation/sdk-manual/working-projects.rst b/documentation/sdk-manual/working-projects.rst
index b9af33393b..4236bcec24 100644
--- a/documentation/sdk-manual/working-projects.rst
+++ b/documentation/sdk-manual/working-projects.rst
@@ -295,12 +295,12 @@ example:
295 all: main.o module.o 295 all: main.o module.o
296 ${CC} main.o module.o -o target_bin 296 ${CC} main.o module.o -o target_bin
297 main.o: main.c module.h 297 main.o: main.c module.h
298 ${CC} -I . -c main.c 298 ${CC} -I . -c main.c
299 module.o: module.c module.h 299 module.o: module.c module.h
300 ${CC} -I . -c module.c 300 ${CC} -I . -c module.c
301 clean: 301 clean:
302 rm -rf *.o 302 rm -rf *.o
303 rm target_bin 303 rm target_bin
304 304
305#. *Make the Project:* Use the ``make`` command to create the binary 305#. *Make the Project:* Use the ``make`` command to create the binary
306 output file. Because variables are commented out in the Makefile, the 306 output file. Because variables are commented out in the Makefile, the
diff --git a/documentation/set_versions.py b/documentation/set_versions.py
index 90e08fc5e0..dec0780834 100755
--- a/documentation/set_versions.py
+++ b/documentation/set_versions.py
@@ -26,9 +26,9 @@ ourversion = None
26if len(sys.argv) == 2: 26if len(sys.argv) == 2:
27 ourversion = sys.argv[1] 27 ourversion = sys.argv[1]
28 28
29activereleases = ["nanbield", "kirkstone", "dunfell"] 29activereleases = ["scarthgap", "nanbield", "kirkstone", "dunfell"]
30devbranch = "scarthgap" 30devbranch = "styhead"
31ltsseries = ["kirkstone", "dunfell"] 31ltsseries = ["scarthgap", "kirkstone", "dunfell"]
32 32
33# used by run-docs-builds to get the default page 33# used by run-docs-builds to get the default page
34if ourversion == "getlatest": 34if ourversion == "getlatest":
@@ -36,6 +36,7 @@ if ourversion == "getlatest":
36 sys.exit(0) 36 sys.exit(0)
37 37
38release_series = collections.OrderedDict() 38release_series = collections.OrderedDict()
39release_series["styhead"] = "5.1"
39release_series["scarthgap"] = "5.0" 40release_series["scarthgap"] = "5.0"
40release_series["nanbield"] = "4.3" 41release_series["nanbield"] = "4.3"
41release_series["mickledore"] = "4.2" 42release_series["mickledore"] = "4.2"
@@ -68,6 +69,7 @@ release_series["laverne"] = "0.9"
68 69
69 70
70bitbake_mapping = { 71bitbake_mapping = {
72 "styhead" : "2.10",
71 "scarthgap" : "2.8", 73 "scarthgap" : "2.8",
72 "nanbield" : "2.6", 74 "nanbield" : "2.6",
73 "mickledore" : "2.4", 75 "mickledore" : "2.4",
diff --git a/documentation/standards.md b/documentation/standards.md
index e0c0cba83c..bc403e393e 100644
--- a/documentation/standards.md
+++ b/documentation/standards.md
@@ -70,27 +70,30 @@ cannot be split without infringing syntactic rules
70or reducing readability, as well as for command output 70or reducing readability, as well as for command output
71which should be kept unmodified. 71which should be kept unmodified.
72 72
73### Project names 73### File, tool and command names
74 74
75Project names should be capitalized in the same 75File, tool, command and package names should be double tick-quoted.
76way they are on Wikipedia, in particular: 76For example, ``` ``conf/local.conf`` ``` is preferred over
77`"conf/local.conf"`.
77 78
78* BitBake 79### Project names
79* OpenEmbedded
80 80
81There are exceptions in which such names can be used 81Project names should be introduced with single quotes, to have them rendered
82in lower case: 82with an italic font and make them easier to distinguish from command names
83(double tick-quoted) and from regular English words.
83 84
84* When referring to a package name 85An exception is when project names appear in hyperlinks, as nested markup
85* When referring to the corresponding command name 86is not supported by Sphinx yet.
86* When used in a cross-reference title. Such
87 titles are usually in lower case.
88 87
89### File, tool and command names 88Project names should also be capitalized (or not) in the same way they are on
89Wikipedia, or on their own project pages if they are not described on
90Wikipedia. If a project name isn't capitalized, it should remain so even
91at the beginning of a sentence.
90 92
91File, tool and command names should be double tick-quoted. 93For example:
92For example, ``` ``conf/local.conf`` ``` is preferred over 94
93`"conf/local.conf"`. 95* ``` `BitBake` ```
96* ``` `ftrace` ```
94 97
95### Variables 98### Variables
96 99