summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/brief-yoctoprojectqs/index.rst7
-rw-r--r--documentation/dev-manual/vulnerabilities.rst4
-rw-r--r--documentation/migration-guides/index.rst1
-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-5.0.rst1
-rw-r--r--documentation/migration-guides/release-5.1.rst9
-rw-r--r--documentation/migration-guides/release-notes-4.0.18.rst191
-rw-r--r--documentation/migration-guides/release-notes-5.0.1.rst134
-rw-r--r--documentation/migration-guides/release-notes-5.0.rst55
-rw-r--r--documentation/migration-guides/release-notes-5.1.rst67
-rw-r--r--documentation/poky.yaml.in12
-rw-r--r--documentation/ref-manual/svg/releases.svg99
-rw-r--r--documentation/ref-manual/tasks.rst9
-rw-r--r--documentation/ref-manual/variables.rst33
15 files changed, 715 insertions, 51 deletions
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index 4301bfd970..c5400e4ac8 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -256,8 +256,11 @@ an entire Linux distribution, including the toolchain, from source.
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 a recent version of python 259 The hash equivalence server needs the websockets python module version 9.1
260 websockets installed to work correctly. 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``.
261 264
262#. **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
263 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:
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/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-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-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.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-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 884a66771d..800ba20a27 100644
--- a/documentation/migration-guides/release-notes-5.0.rst
+++ b/documentation/migration-guides/release-notes-5.0.rst
@@ -936,3 +936,58 @@ Thanks to the following people who contributed to this release:
936Repositories / Downloads for Yocto-5.0 936Repositories / Downloads for Yocto-5.0
937~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 937~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
938 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/poky.yaml.in b/documentation/poky.yaml.in
index 17cbe26e36..0c04b615ea 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -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/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 2e4b23408d..df751d75a3 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -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/variables.rst b/documentation/ref-manual/variables.rst
index 3f37f42f21..07b5b6f95c 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -5585,6 +5585,21 @@ system and gives an overview of their function and contents.
5585 5585
5586 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"
5587 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
5588 :term:`OBJCOPY` 5603 :term:`OBJCOPY`
5589 The minimal command and arguments to run ``objcopy``. 5604 The minimal command and arguments to run ``objcopy``.
5590 5605
@@ -6829,6 +6844,19 @@ system and gives an overview of their function and contents.
6829 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
6830 package name has a prefix, underscores, uppercase letters etc.) 6845 package name has a prefix, underscores, uppercase letters etc.)
6831 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
6832 :term:`PYTHON_ABI` 6860 :term:`PYTHON_ABI`
6833 When used by recipes that inherit the :ref:`ref-classes-setuptools3` 6861 When used by recipes that inherit the :ref:`ref-classes-setuptools3`
6834 class, denotes the Application Binary Interface (ABI) currently in use 6862 class, denotes the Application Binary Interface (ABI) currently in use
@@ -9670,6 +9698,11 @@ system and gives an overview of their function and contents.
9670 :ref:`ref-classes-insane` class and is only enabled if the 9698 :ref:`ref-classes-insane` class and is only enabled if the
9671 recipe inherits the :ref:`ref-classes-autotools` class. 9699 recipe inherits the :ref:`ref-classes-autotools` class.
9672 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
9673 :term:`UPDATERCPN` 9706 :term:`UPDATERCPN`
9674 For recipes inheriting the 9707 For recipes inheriting the
9675 :ref:`ref-classes-update-rc.d` class, :term:`UPDATERCPN` 9708 :ref:`ref-classes-update-rc.d` class, :term:`UPDATERCPN`