mirror of
git://git.yoctoproject.org/poky.git
synced 2025-07-19 21:09:03 +02:00
d01f9c44ed
Add migration documentation for users moving from the removed kernel-fitimage.bbclass to the new kernel-fit-image.bbclass. (From yocto-docs rev: 4c3552940a6ff89824845473317b7f5d741d4635) Signed-off-by: Adrian Freihofer <adrian.freihofer@siemens.com> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
111 lines
3.3 KiB
ReStructuredText
111 lines
3.3 KiB
ReStructuredText
.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
|
|
|
|
.. |yocto-codename| replace:: whinlatter
|
|
.. |yocto-ver| replace:: 5.3
|
|
.. Note: anchors id below cannot contain substitutions so replace them with the
|
|
value of |yocto-ver| above.
|
|
|
|
Release |yocto-ver| (|yocto-codename|)
|
|
======================================
|
|
|
|
Migration notes for |yocto-ver| (|yocto-codename|)
|
|
--------------------------------------------------
|
|
|
|
This section provides migration information for moving to the Yocto
|
|
Project |yocto-ver| Release (codename "|yocto-codename|") from the prior release.
|
|
|
|
Supported kernel versions
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The :term:`OLDEST_KERNEL` setting is XXX in this release, meaning that
|
|
out the box, older kernels are not supported. See :ref:`4.3 migration notes
|
|
<migration-4.3-supported-kernel-versions>` for details.
|
|
|
|
Supported distributions
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Compared to the previous releases, running BitBake is supported on new
|
|
GNU/Linux distributions:
|
|
|
|
- XXX
|
|
|
|
On the other hand, some earlier distributions are no longer supported:
|
|
|
|
- XXX
|
|
|
|
See :ref:`all supported distributions <system-requirements-supported-distros>`.
|
|
|
|
Rust language changes
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
systemd changes
|
|
~~~~~~~~~~~~~~~
|
|
|
|
Recipe changes
|
|
~~~~~~~~~~~~~~
|
|
|
|
Removed variables
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
The following variables have been removed:
|
|
|
|
Removed recipes
|
|
~~~~~~~~~~~~~~~
|
|
|
|
The following recipes have been removed in this release:
|
|
|
|
Removed classes
|
|
~~~~~~~~~~~~~~~
|
|
|
|
The following classes have been removed in this release:
|
|
|
|
- ``kernel-fitimage.bbclass``: the class has been replaced by the
|
|
:ref:`ref-classes-kernel-fit-image` class. The new implementation resolves
|
|
the long-standing :yocto_bugs:`bug 12912</show_bug.cgi?id=12912>`.
|
|
|
|
If you are using the kernel FIT image support, you will need to:
|
|
|
|
#. Make sure to include ``kernel-fit-extra-artifacts`` in your :term:`KERNEL_CLASSES`
|
|
variable to ensure the required files are exposed to the :term:`DEPLOY_DIR_IMAGE`
|
|
directory::
|
|
|
|
KERNEL_CLASSES += "kernel-fit-extra-artifacts"
|
|
|
|
#. Use the specific FIT image recipe rather than the base kernel recipe.
|
|
For example, instead of::
|
|
|
|
bitbake linux-yocto
|
|
|
|
the FIT image is now build by::
|
|
|
|
bitbake linux-yocto-fitimage
|
|
|
|
For custom kernel recipes, creating a corresponding custom FIT image recipe
|
|
is usually a good approach.
|
|
|
|
#. If a FIT image is used as a replacement for the kernel image in the root
|
|
filesystem, add the following configuration to your machine configuration
|
|
file::
|
|
|
|
# Create and deploy the vmlinux artifact which gets included into the FIT image
|
|
KERNEL_CLASSES += "kernel-fit-extra-artifacts"
|
|
|
|
# Do not install the kernel image package
|
|
RRECOMMENDS:${KERNEL_PACKAGE_NAME}-base = ""
|
|
# Install the FIT image package
|
|
MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "linux-yocto-fitimage"
|
|
|
|
# Configure the image.bbclass to depend on the FIT image instead of only
|
|
# the kernel to ensure the FIT image is built and deployed with the image
|
|
KERNEL_DEPLOY_DEPEND = "linux-yocto-fitimage:do_deploy"
|
|
|
|
See the :ref:`ref-classes-kernel-fit-image` section for more information.
|
|
|
|
Removed features
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
The following features have been removed in this release:
|
|
|
|
Miscellaneous changes
|
|
~~~~~~~~~~~~~~~~~~~~~
|