.. SPDX-License-Identifier: CC-BY-SA-2.0-UK

Release notes for 4.3 (nandbield)
----------------------------------

New Features / Enhancements in 4.3
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-  Linux kernel 6.5 and 6.1, gcc 13, glibc 2.38 and other recipe upgrades

-  New variables:

   -  :term:`FILE_LAYERNAME`: bitbake now sets this to the name of the layer containing the recipe

   -  :term:`FIT_ADDRESS_CELLS` and :term:`UBOOT_FIT_ADDRESS_CELLS`.
      See details below.

   -  :term:`KERNEL_DTBDEST`: directory where to install DTB files.

   -  :term:`KERNEL_DTBVENDORED`: whether to keep vendor subdirectories.

   -  :term:`LICENSE_FLAGS_DETAILS`: add extra details about a recipe license
      in case it is not allowed by :term:`LICENSE_FLAGS_ACCEPTED`.

   -  :term:`FILE_LAYERNAME`: bitbake now sets this to the name of the layer containing the recipe.

   -  :term:`KERNEL_LOCALVERSION`: to add a string to the kernel version information.

   -  :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE`: to restrict package managers used in reproducibility testing.

   -  :term:`KERNEL_STRIP`: to specify the command to strip the kernel binary.

- Layername functionality available through overrides

  Code can now know which layer a recipe is coming from through the newly added :term:`FILE_LAYERNAME`
  variable. This has been added as an override of the form ``layer-<layername>``. In particular,
  this means QA checks can now be layer specific, for example::

    ERROR_QA:layer-core:append = " patch-status"

  which will enable the ``patch-status`` QA check for the core layer.

-  Architecture-specific enhancements:

   -  RISCV support is now enabled in LLVM 17.

   -  Loongarch support in the :ref:`ref-classes-linuxloader` class and
      ``core-image-minimal-initramfs`` image.

-  Kernel-related enhancements:

-  New core recipes:

-  New classes:

   - A ``ptest-cargo`` class was added to allow Cargo based recipes to easily add ptests

-  QEMU/runqemu enhancements:

   -  QEMU has been upgraded to version 8.0

-  Rust improvements:

   -  Rust has been upgraded to version 1.70

-  Image-related enhancements:

-  Distribution-related enhancements:

   -  The ``poky-altcfg`` distribution enables the ``usrmerge``
      :ref:`distro feature <ref-manual/features:Distro Features>`.

-  wic Image Creator enhancements:

-  FIT image related improvements:

   -  New :term:`FIT_ADDRESS_CELLS` and :term:`UBOOT_FIT_ADDRESS_CELLS` variables allowing
      to specify 64 bit addresses, typically for loading U-Boot.

-  SDK-related improvements:

-  Testing:

-  Utility script changes:

-  BitBake improvements:

   -  The BitBake Cooker log now contains notes when the caches are
      invalidated which is useful for memory resident bitbake debugging.

-  Packaging changes:

-  :term:`SPDX` improvements:

   -  :term:`SPDX` manifests are now generated by default.

-  Prominent documentation updates:

   -  New :doc:`../contributor-guide/index` document.

   -  Long due documentation for the :ref:`ref-classes-devicetree` class.

   -  New :ref:`summary about available init systems
      <dev-manual/init-manager:summary>`.

   -  New documentation for the :ref:`ref-classes-uboot-sign` class and
      its variables and for the :ref:`ref-classes-kernel-devicetree` class
      variables.

-  Miscellaneous changes:


   -  Git based recipes in OE-Core which used the git protocol have been
      changed to use https where possibile. https is now believed to be
      faster and more reliable.

   -  The ``os-release`` recipe added a ``CPE_NAME`` to the fields provided, with the
      default being populated from :term:`DISTRO`.

   -  The ``psplash`` recipe now accepts a PNG format image through :term:`SPLASH_IMAGES`,
      instead of a harder to generate and modify ``.h`` file.

Known Issues in 4.3
~~~~~~~~~~~~~~~~~~~

Recipe License changes in 4.3
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The following corrections have been made to the :term:`LICENSE` values set by recipes:

Security Fixes in 4.3
~~~~~~~~~~~~~~~~~~~~~

Recipe Upgrades in 4.3
~~~~~~~~~~~~~~~~~~~~~~

Contributors to 4.3
~~~~~~~~~~~~~~~~~~~