diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2023-10-30 10:53:49 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2023-11-06 22:52:27 +0000 |
commit | e80a5cb66db40336c87e7b568692182bb91644b0 (patch) | |
tree | 425c2a8a125119f101324143a0aa652112325f49 /documentation/migration-guides | |
parent | 5466a06f17de944ce507b2a65931f0c989c17e93 (diff) | |
download | poky-e80a5cb66db40336c87e7b568692182bb91644b0.tar.gz |
migration-guides: further updates for release 4.3
(From yocto-docs rev: fcd7490afba8e70740a2d4c17f759bf3e330e88a)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/migration-guides')
-rw-r--r-- | documentation/migration-guides/migration-4.3.rst | 12 | ||||
-rw-r--r-- | documentation/migration-guides/release-notes-4.3.rst | 89 |
2 files changed, 82 insertions, 19 deletions
diff --git a/documentation/migration-guides/migration-4.3.rst b/documentation/migration-guides/migration-4.3.rst index 891f2d08ce..7647246a0d 100644 --- a/documentation/migration-guides/migration-4.3.rst +++ b/documentation/migration-guides/migration-4.3.rst | |||
@@ -44,8 +44,8 @@ Compiling changes | |||
44 | ~~~~~~~~~~~~~~~~~ | 44 | ~~~~~~~~~~~~~~~~~ |
45 | 45 | ||
46 | - Code on 32 bit platforms is now compiled with largefile support and 64 | 46 | - Code on 32 bit platforms is now compiled with largefile support and 64 |
47 | bit ``time_t``, to avoid the Y2038 time overflow issue. This could break | 47 | bit ``time_t``, to avoid the Y2038 time overflow issue. This breaks the ABI |
48 | existing programs in untested layers. | 48 | and could break existing programs in untested layers. |
49 | 49 | ||
50 | .. _migration-4.3-supported-distributions: | 50 | .. _migration-4.3-supported-distributions: |
51 | 51 | ||
@@ -118,6 +118,7 @@ Removed variables | |||
118 | 118 | ||
119 | The following variables have been removed: | 119 | The following variables have been removed: |
120 | 120 | ||
121 | - ``AUTHOR`` | ||
121 | - ``PERLARCH`` | 122 | - ``PERLARCH`` |
122 | - ``PERLVERSION`` | 123 | - ``PERLVERSION`` |
123 | 124 | ||
@@ -168,6 +169,13 @@ QA check changes | |||
168 | Miscellaneous changes | 169 | Miscellaneous changes |
169 | ~~~~~~~~~~~~~~~~~~~~~ | 170 | ~~~~~~~~~~~~~~~~~~~~~ |
170 | 171 | ||
172 | - `jsDelivr <https://www.jsdelivr.com/`>__ now offers a new Content Delivery | ||
173 | Network (CDN) to Yocto Project users, which is completely free of charge | ||
174 | for Open Source projects. In particular, it can be used to efficiently | ||
175 | access prebuilt binary artifacts (see :term:`SSTATE_MIRRORS`) from many | ||
176 | different locations in the world. This is available to all supported Poky | ||
177 | releases. | ||
178 | |||
171 | - The ``-crosssdk`` suffix and any :term:`MLPREFIX` were removed from | 179 | - The ``-crosssdk`` suffix and any :term:`MLPREFIX` were removed from |
172 | ``virtual/XXX`` provider/dependencies where a ``PREFIX`` was used as well, | 180 | ``virtual/XXX`` provider/dependencies where a ``PREFIX`` was used as well, |
173 | as we don't need both and it made automated dependency rewriting | 181 | as we don't need both and it made automated dependency rewriting |
diff --git a/documentation/migration-guides/release-notes-4.3.rst b/documentation/migration-guides/release-notes-4.3.rst index 424e75541d..35d9981e0f 100644 --- a/documentation/migration-guides/release-notes-4.3.rst +++ b/documentation/migration-guides/release-notes-4.3.rst | |||
@@ -10,7 +10,11 @@ New Features / Enhancements in 4.3 | |||
10 | 10 | ||
11 | - New variables: | 11 | - New variables: |
12 | 12 | ||
13 | - :term:`FILE_LAYERNAME`: bitbake now sets this to the name of the layer containing the recipe | 13 | - :term:`CVE_CHECK_STATUSMAP`, :term:`CVE_STATUS`, :term:`CVE_STATUS_GROUPS`, |
14 | replaceing the deprecated :term:`CVE_CHECK_IGNORE`. | ||
15 | |||
16 | - :term:`FILE_LAYERNAME`: bitbake now sets this to the name of the layer | ||
17 | containing the recipe | ||
14 | 18 | ||
15 | - :term:`FIT_ADDRESS_CELLS` and :term:`UBOOT_FIT_ADDRESS_CELLS`. | 19 | - :term:`FIT_ADDRESS_CELLS` and :term:`UBOOT_FIT_ADDRESS_CELLS`. |
16 | See details below. | 20 | See details below. |
@@ -19,26 +23,29 @@ New Features / Enhancements in 4.3 | |||
19 | 23 | ||
20 | - :term:`KERNEL_DTBVENDORED`: whether to keep vendor subdirectories. | 24 | - :term:`KERNEL_DTBVENDORED`: whether to keep vendor subdirectories. |
21 | 25 | ||
26 | - :term:`KERNEL_LOCALVERSION`: to add a string to the kernel version | ||
27 | information. | ||
28 | |||
29 | - :term:`KERNEL_STRIP`: to specify the command to strip the kernel binary. | ||
30 | |||
22 | - :term:`LICENSE_FLAGS_DETAILS`: add extra details about a recipe license | 31 | - :term:`LICENSE_FLAGS_DETAILS`: add extra details about a recipe license |
23 | in case it is not allowed by :term:`LICENSE_FLAGS_ACCEPTED`. | 32 | in case it is not allowed by :term:`LICENSE_FLAGS_ACCEPTED`. |
24 | 33 | ||
25 | - :term:`FILE_LAYERNAME`: bitbake now sets this to the name of the layer containing the recipe. | 34 | - :term:`MESON_TARGET`: to compile a specific Meson target instead of the |
26 | 35 | default ones. | |
27 | - :term:`KERNEL_LOCALVERSION`: to add a string to the kernel version information. | ||
28 | 36 | ||
29 | - :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE`: to restrict package managers used in reproducibility testing. | 37 | - :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE`: to restrict package managers used |
38 | in reproducibility testing. | ||
30 | 39 | ||
31 | - :term:`KERNEL_STRIP`: to specify the command to strip the kernel binary. | 40 | - Layername functionality available through overrides |
32 | 41 | ||
33 | - Layername functionality available through overrides | 42 | Code can now know which layer a recipe is coming from through the newly added :term:`FILE_LAYERNAME` |
43 | variable. This has been added as an override of the form ``layer-<layername>``. In particular, | ||
44 | this means QA checks can now be layer specific, for example:: | ||
34 | 45 | ||
35 | Code can now know which layer a recipe is coming from through the newly added :term:`FILE_LAYERNAME` | 46 | ERROR_QA:layer-core:append = " patch-status" |
36 | variable. This has been added as an override of the form ``layer-<layername>``. In particular, | ||
37 | this means QA checks can now be layer specific, for example:: | ||
38 | 47 | ||
39 | ERROR_QA:layer-core:append = " patch-status" | 48 | This will enable the ``patch-status`` QA check for the core layer. |
40 | |||
41 | which will enable the ``patch-status`` QA check for the core layer. | ||
42 | 49 | ||
43 | - Architecture-specific enhancements: | 50 | - Architecture-specific enhancements: |
44 | 51 | ||
@@ -47,17 +54,48 @@ New Features / Enhancements in 4.3 | |||
47 | - Loongarch support in the :ref:`ref-classes-linuxloader` class and | 54 | - Loongarch support in the :ref:`ref-classes-linuxloader` class and |
48 | ``core-image-minimal-initramfs`` image. | 55 | ``core-image-minimal-initramfs`` image. |
49 | 56 | ||
57 | - The ``arch-armv8`` and ``arch-armv9`` architectures are now given | ||
58 | `Scalable Vector Extension (SVE) | ||
59 | <https://developer.arm.com/documentation/100891/0612/sve-overview/introducing-sve>`__ | ||
60 | based tune options. Commits: | ||
61 | :yocto_git:`1 </poky/commit/?id=e4be03be5be62e367a40437a389121ef97d6cff3>`, | ||
62 | :yocto_git:`2 </poky/commit/?id=8cd5d264af4c346730531cb98ae945ab862dbd69>`. | ||
63 | |||
50 | - Kernel-related enhancements: | 64 | - Kernel-related enhancements: |
51 | 65 | ||
52 | - New core recipes: | 66 | - New core recipes: |
53 | 67 | ||
68 | - ``musl-legacy-error``: glibc ``error()`` API implementation still needed | ||
69 | by a few packages. | ||
70 | |||
71 | - `python3-beartype <https://beartype.readthedocs.io>`, unbearably fast | ||
72 | runtime type checking in pure Python. | ||
73 | |||
74 | - `python3-spdx-tools <https://github.com/spdx/tools-python>`__, | ||
75 | tools for SPDX validation and conversion. | ||
76 | |||
77 | - `python3-uritools <https://github.com/tkem/uritools/>`__, replacement for | ||
78 | the ``urllib.parse`` module. | ||
79 | |||
80 | - `ttyrun <https://github.com/ibm-s390-linux/s390-tools>`__, starts | ||
81 | ``getty`` programs only when a terminal exists, preventing respawns | ||
82 | through the ``init`` program. | ||
83 | |||
54 | - New classes: | 84 | - New classes: |
55 | 85 | ||
56 | - A ``ptest-cargo`` class was added to allow Cargo based recipes to easily add ptests | 86 | - A ``ptest-cargo`` class was added to allow Cargo based recipes to easily add ptests |
87 | |||
88 | - A :ref:`ref-classes-cargo_c` class was added to allow recipes to make Rust code | ||
89 | available to C and C++ programs. | ||
57 | 90 | ||
58 | - QEMU/runqemu enhancements: | 91 | - QEMU / ``runqemu`` enhancements: |
59 | 92 | ||
60 | - QEMU has been upgraded to version 8.0 | 93 | - QEMU has been upgraded to version 8.1 |
94 | |||
95 | - Many updates to the ``runqemu`` command. | ||
96 | |||
97 | - The ``qemu-system-native`` recipe is now built with PNG support, which could be | ||
98 | useful to grab screeshots for error reporting purposes. | ||
61 | 99 | ||
62 | - Rust improvements: | 100 | - Rust improvements: |
63 | 101 | ||
@@ -81,8 +119,17 @@ New Features / Enhancements in 4.3 | |||
81 | 119 | ||
82 | - Testing: | 120 | - Testing: |
83 | 121 | ||
122 | - The :ref:`ref-classes-insane` class now adds an :ref:`unimplemented-ptest | ||
123 | <qa-check-unimplemented-ptest>` infrastructure to detect package sources | ||
124 | with unit tests but no implemented ptests in the recipe. | ||
125 | |||
84 | - Utility script changes: | 126 | - Utility script changes: |
85 | 127 | ||
128 | - New ``scripts/patchtest`` utility to check patches to the | ||
129 | OpenEmbedded-Core project. See | ||
130 | :ref:`contributor-guide/submit-changes:validating patches with patchtest` | ||
131 | for details. | ||
132 | |||
86 | - BitBake improvements: | 133 | - BitBake improvements: |
87 | 134 | ||
88 | - The BitBake Cooker log now contains notes when the caches are | 135 | - The BitBake Cooker log now contains notes when the caches are |
@@ -94,10 +141,19 @@ New Features / Enhancements in 4.3 | |||
94 | 141 | ||
95 | - :term:`SPDX` manifests are now generated by default. | 142 | - :term:`SPDX` manifests are now generated by default. |
96 | 143 | ||
144 | - Security improvements: | ||
145 | |||
146 | - Most repositories now include a :yocto_git:`SECURITY.md | ||
147 | </poky/tree/SECURITY.md>` file with hints for security researchers | ||
148 | and other parties who might report potential security vulnerabilities. | ||
149 | |||
97 | - Prominent documentation updates: | 150 | - Prominent documentation updates: |
98 | 151 | ||
99 | - New :doc:`../contributor-guide/index` document. | 152 | - New :doc:`../contributor-guide/index` document. |
100 | 153 | ||
154 | - New :doc:`../dev-manual/security-subjects` chapter in the Development | ||
155 | Tasks Manual. | ||
156 | |||
101 | - Long due documentation for the :ref:`ref-classes-devicetree` class. | 157 | - Long due documentation for the :ref:`ref-classes-devicetree` class. |
102 | 158 | ||
103 | - New :ref:`summary about available init systems | 159 | - New :ref:`summary about available init systems |
@@ -109,7 +165,6 @@ New Features / Enhancements in 4.3 | |||
109 | 165 | ||
110 | - Miscellaneous changes: | 166 | - Miscellaneous changes: |
111 | 167 | ||
112 | |||
113 | - Git based recipes in OE-Core which used the git protocol have been | 168 | - Git based recipes in OE-Core which used the git protocol have been |
114 | changed to use https where possibile. https is now believed to be | 169 | changed to use https where possibile. https is now believed to be |
115 | faster and more reliable. | 170 | faster and more reliable. |