blob: c2e5699ccbb3d8b1593adba4962c174332c0d178 [file] [log] [blame]
Andrew Geissler3eeda902023-05-19 10:14:02 -05001.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3Release 4.3 (nanbield)
4========================
5
6Migration notes for 4.3 (nanbield)
7------------------------------------
8
9This section provides migration information for moving to the Yocto
10Project 4.3 Release (codename "nanbield") from the prior release.
11
12.. _migration-4.3-supported-kernel-versions:
13
14Supported kernel versions
15~~~~~~~~~~~~~~~~~~~~~~~~~
16
17The :term:`OLDEST_KERNEL` setting has been changed to "5.15" in this release, meaning that
18out the box, older kernels are not supported. There were two reasons for this.
19Firstly it allows glibc optimisations that improve the performance of the system
20by removing compatibility code and using modern kernel APIs exclusively. The second
21issue was this allows 64 bit time support even on 32 bit platforms and resolves Y2038
22issues.
23
24It is still possible to override this value and build for older kernels, this is just
25no longer the default supported configuration. This setting does not affect which
26kernel versions SDKs will run against and does not affect which versions of the kernel
27can be used to run builds.
28
29.. _migration-4.3-supported-distributions:
30
31Supported distributions
32~~~~~~~~~~~~~~~~~~~~~~~
33
34This release supports running BitBake on new GNU/Linux distributions:
35
36On the other hand, some earlier distributions are no longer supported:
37
38See :ref:`all supported distributions <system-requirements-supported-distros>`.
39
40.. _migration-4.3-go-changes:
41
42Go language changes
43~~~~~~~~~~~~~~~~~~~
44
45- Support for the Glide package manager has been removed, as ``go mod``
46 has become the standard.
47
48.. _migration-4.3-recipe-changes:
49
50Recipe changes
51~~~~~~~~~~~~~~
52
53- Runtime testing of ptest now fails if no test results are returned by
54 any given ptest.
55
56.. _migration-4.3-class-changes:
57
58Class changes
59~~~~~~~~~~~~~
60
61- The ``perl-version`` class no longer provides the ``PERLVERSION`` and ``PERLARCH`` variables
62 as there were no users in any core layer. The functions for this functionality
63 are still available.
64
65.. _migration-4.3-removed-variables:
66
67Removed variables
68~~~~~~~~~~~~~~~~~
69
70The following variables have been removed:
71
72- ``PERLARCH``
73- ``PERLVERSION``
74
75.. _migration-4.3-removed-recipes:
76
77Removed recipes
78~~~~~~~~~~~~~~~
79
80The following recipes have been removed in this release:
81
82- ``glide``, as explained in :ref:`migration-4.3-go-changes`.
83
84.. _migration-4.3-removed-classes:
85
86Removed classes
87~~~~~~~~~~~~~~~
88
89The following classes have been removed in this release:
90
91
92.. _migration-4.3-misc-changes:
93
94Miscellaneous changes
95~~~~~~~~~~~~~~~~~~~~~
96
97- The ``-crosssdk`` suffix and any :term:`MLPREFIX` were removed from
98 ``virtual/XXX`` provider/dependencies where a ``PREFIX`` was used as well,
99 as we don't need both and it made automated dependency rewriting
100 unnecessarily complex. In general this only affects internal toolchain
101 dependencies so isn't end user visible.
102