diff options
Diffstat (limited to 'documentation/migration-guides/release-notes-4.0.rst')
| -rw-r--r-- | documentation/migration-guides/release-notes-4.0.rst | 88 |
1 files changed, 46 insertions, 42 deletions
diff --git a/documentation/migration-guides/release-notes-4.0.rst b/documentation/migration-guides/release-notes-4.0.rst index 4bf680db5d..a5d66c0410 100644 --- a/documentation/migration-guides/release-notes-4.0.rst +++ b/documentation/migration-guides/release-notes-4.0.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-2.0-UK + Release notes for 4.0 (kirkstone) --------------------------------- @@ -8,9 +10,10 @@ New Features / Enhancements in 4.0 - Linux kernel 5.15, glibc 2.35 and ~300 other recipe upgrades -- Reproducibility: this release fixes the reproducibility issues with ``rust-llvm`` and - ``golang``. Recipes in OpenEmbedded-Core are now fully reproducible. Functionality - previously in the optional "reproducible" class has been merged into the base class. +- Reproducibility: this release fixes the reproducibility issues with + ``rust-llvm`` and ``golang``. Recipes in OpenEmbedded-Core are now fully + reproducible. Functionality previously in the optional "reproducible" + class has been merged into the :ref:`ref-classes-base` class. - Network access is now disabled by default for tasks other than where it is expected to ensure build integrity (where host kernel supports it) @@ -22,21 +25,20 @@ New Features / Enhancements in 4.0 BB_SIGNATURE_HANDLER = "OEEquivHash" BB_HASHSERVE = "auto" - BB_HASHSERVE_UPSTREAM = "typhoon.yocto.io:8687" + BB_HASHSERVE_UPSTREAM = "hashserv.yocto.io:8687" SSTATE_MIRRORS ?= "file://.* https://sstate.yoctoproject.org/all/PATH;downloadfilename=PATH" - The Python package build process is now based on `wheels <https://pythonwheels.com/>`__ in line with the upstream direction. -- New :ref:`overlayfs <ref-classes-overlayfs>` and - :ref:`overlayfs-etc <ref-classes-overlayfs-etc>` classes and - ``overlayroot`` support in the initramfs framework to make it easier to +- New :ref:`ref-classes-overlayfs` and :ref:`ref-classes-overlayfs-etc` classes and + ``overlayroot`` support in the :term:`Initramfs` framework to make it easier to overlay read-only filesystems (for example) with - `OverlayFS <https://en.wikipedia.org/wiki/OverlayFS>`__. + :wikipedia:`OverlayFS <OverlayFS>`. - Inclusive language adjustments to some variable names - see the :ref:`4.0 migration guide <migration-4.0-inclusive-language>` for details. - + - New recipes: - ``buildtools-docs-tarball`` @@ -104,7 +106,7 @@ New Features / Enhancements in 4.0 - Shared state (sstate) improvements: - - Switched to `ZStandard (zstd) <https://en.wikipedia.org/wiki/Zstd>`__ instead + - Switched to :wikipedia:`ZStandard (zstd) <Zstd>` instead of Gzip, for better performance. - Allow validation of sstate signatures against a list of keys - Improved error messages and exception handling @@ -112,8 +114,8 @@ New Features / Enhancements in 4.0 - BitBake enhancements: - Fetcher enhancements: - - - New :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-fetching:crate fetcher (\`\`crate://\`\`)` for Rust packages + + - New :ref:`bitbake-user-manual/bitbake-user-manual-fetching:crate fetcher (\`\`crate://\`\`)` for Rust packages - Added striplevel support to unpack - git: Add a warning asking users to set a branch in git urls - git: Allow git fetcher to support subdir param @@ -125,7 +127,7 @@ New Features / Enhancements in 4.0 - ssh: now supports checkstatus, allows : in URLs (both required for use with sstate) and no longer requires username - wget: add redirectauth parameter - wget: add 30s timeout for checkstatus calls - + - Show warnings for append/prepend/remove operators combined with +=/.= - Add bb.warnonce() and bb.erroronce() log methods - Improved setscene task display @@ -138,12 +140,12 @@ New Features / Enhancements in 4.0 - Architecture-specific enhancements: - ARM: - + - tune-cortexa72: Enable the crc extension by default for cortexa72 - qemuarm64: Add tiny ktype to qemuarm64 bsp - armv9a/tune: Add the support for the Neoverse N2 core - arch-armv8-5a.inc: Add tune include for armv8.5a - - grub-efi: Add xen_boot support when 'xen' is in DISTRO_FEATURES for aarch64 + - grub-efi: Add xen_boot support when 'xen' is in :term:`DISTRO_FEATURES` for aarch64 - tune-cortexa73: Introduce cortexa73-crypto tune - libacpi: Build libacpi also for 'aarch64' machines - core-image-tiny-initramfs: Mark recipe as 32 bit ARM compatible @@ -161,28 +163,28 @@ New Features / Enhancements in 4.0 - linux-yocto-dev: add qemuriscv32 - packagegroup-core-tools-profile: Enable systemtap for riscv64 - qemuriscv: Use virtio-tablet-pci for mouse - + - x86: - kernel-yocto: conditionally enable stack protection checking on x86-64 - Kernel-related enhancements: - - Allow initramfs to be built from a separate multiconfig + - Allow :term:`Initramfs` to be built from a separate multiconfig - Make kernel-base recommend kernel-image, not depend (allowing images containing kernel modules without kernel image) - linux-yocto: split vtpm for more granular inclusion - linux-yocto: cfg/debug: add configs for kcsan - linux-yocto: cfg: add kcov feature fragment - linux-yocto: export pkgconfig variables to devshell - linux-yocto-dev: use versioned branch as default - - New ``KERNEL_DEBUG_TIMESTAMPS`` variable (to replace removed ``BUILD_REPRODUCIBLE_BINARIES`` for the kernel) + - New :term:`KERNEL_DEBUG_TIMESTAMPS` variable (to replace removed ``BUILD_REPRODUCIBLE_BINARIES`` for the kernel) - Introduce python3-dtschema-wrapper in preparation for mandatory schema checking on dtb files in 5.16 - Allow disabling kernel artifact symlink creation - Allow changing default .bin kernel artifact extension - FIT image related enhancements: - - New ``FIT_SUPPORTED_INITRAMFS_FSTYPES`` variable to allow extending initramfs image types to look for + - New ``FIT_SUPPORTED_INITRAMFS_FSTYPES`` variable to allow extending :term:`Initramfs` image types to look for - New ``FIT_CONF_PREFIX`` variable to allow overriding FIT configuration prefix - Use 'bbnote' for better logging @@ -197,7 +199,7 @@ New Features / Enhancements in 4.0 - yocto-check-layer: improved README checks - cve-check: add json output format - cve-check: add coverage statistics on recipes with/without CVEs -- Added mirrors for kernel sources and uninative binaries on kernel.org +- Added mirrors for kernel sources and uninative binaries on kernel.org - glibc and binutils recipes now use shallow mirror tarballs for faster fetching - When patching fails, show more information on the fatal error @@ -215,7 +217,7 @@ New Features / Enhancements in 4.0 - Ensure addition of patch-fuzz retriggers do_qa_patch - Added a sanity check for allarch packagegroups -- create-spdx class improvements: +- :ref:`ref-classes-create-spdx` class improvements: - Get SPDX-License-Identifier from source files - Generate manifest also for SDKs @@ -232,15 +234,17 @@ New Features / Enhancements in 4.0 - Detect more known licenses in Python code - Move license md5sums data into CSV files - npm: Use README as license fallback - + - SDK-related enhancements: - - Extended recipes to ``nativesdk``: ``cargo``, ``librsvg``, ``libstd-rs``, ``libva``, ``python3-docutil``, ``python3-packaging`` - - Enabled nativesdk recipes to find a correct version of the rust cross compiler + - Extended recipes to :ref:`ref-classes-nativesdk`: ``cargo``, + ``librsvg``, ``libstd-rs``, ``libva``, ``python3-docutil``, ``python3-packaging`` + - Enabled :ref:`ref-classes-nativesdk` recipes to find a correct version + of the rust cross compiler - Support creating per-toolchain cmake file in SDK - Rust enhancements: - + - New python_setuptools3_rust class to enable building python extensions in Rust - classes/meson: Add optional rust definitions @@ -276,7 +280,7 @@ New Features / Enhancements in 4.0 - volatile-binds: SELinux and overlayfs extensions in mount-copybind - gtk-icon-cache: Allow using gtk4 - kmod: Add an exclude directive to depmod -- os-release: add os-release-initrd package for use in systemd-based initramfs images +- os-release: add os-release-initrd package for use in systemd-based :term:`Initramfs` images - gstreamer1.0-plugins-base: add support for graphene - gpg-sign: Add parameters to gpg signature function - package_manager: sign DEB package feeds @@ -289,7 +293,7 @@ New Features / Enhancements in 4.0 - libxkbcommon: allow building of API documentation - libxkbcommon: split libraries and xkbcli into separate packages - systemd: move systemd shared library into its own package -- systemd: Minimize udev package size if DISTRO_FEATURES doen't contain sysvinit +- systemd: Minimize udev package size if :term:`DISTRO_FEATURES` doen't contain sysvinit Known Issues in 4.0 ~~~~~~~~~~~~~~~~~~~ @@ -301,22 +305,22 @@ Known Issues in 4.0 Recipe License changes in 4.0 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The following corrections have been made to the LICENSE values set by recipes: +The following corrections have been made to the :term:`LICENSE` values set by recipes: -* cmake: add BSD-1-Clause & MIT & BSD-2-Clause to LICENSE due to additional vendored libraries in native/target context -* gettext: extend LICENSE conditional upon PACKAGECONFIG (due to vendored libraries) +* cmake: add BSD-1-Clause & MIT & BSD-2-Clause to :term:`LICENSE` due to additional vendored libraries in native/target context +* gettext: extend :term:`LICENSE` conditional upon :term:`PACKAGECONFIG` (due to vendored libraries) * gstreamer1.0: update licenses of all modules to LGPL-2.1-or-later (with some exceptions that are GPL-2.0-or-later) * gstreamer1.0-plugins-bad/ugly: use the GPL-2.0-or-later only when it is in use * kern-tools-native: add missing MIT license due to Kconfiglib -* libcap: add pam_cap license to LIC_FILES_CHKSUM if pam is enabled +* libcap: add pam_cap license to :term:`LIC_FILES_CHKSUM` if pam is enabled * libidn2: add Unicode-DFS-2016 license -* libsdl2: add BSD-2-Clause to LICENSE due to default yuv2rgb and hidapi inclusion -* libx11-compose-data: update LICENSE to "MIT & MIT-style & BSD-1-Clause & HPND & HPND-sell-variant" to better reflect reality -* libx11: update LICENSE to "MIT & MIT-style & BSD-1-Clause & HPND & HPND-sell-variant" to better reflect reality -* libxshmfence: correct LICENSE - MIT -> HPND -* newlib: add BSD-3-Clause to LICENSE -* python3-idna: correct LICENSE - Unicode -> Unicode-TOU -* python3-pip: add "Apache-2.0 & MPL-2.0 & LGPL-2.1-only & BSD-3-Clause & PSF-2.0 & BSD-2-Clause" to LICENSE due to vendored libraries +* libsdl2: add BSD-2-Clause to :term:`LICENSE` due to default yuv2rgb and hidapi inclusion +* libx11-compose-data: update :term:`LICENSE` to "MIT & MIT-style & BSD-1-Clause & HPND & HPND-sell-variant" to better reflect reality +* libx11: update :term:`LICENSE` to "MIT & MIT-style & BSD-1-Clause & HPND & HPND-sell-variant" to better reflect reality +* libxshmfence: correct :term:`LICENSE` - MIT -> HPND +* newlib: add BSD-3-Clause to :term:`LICENSE` +* python3-idna: correct :term:`LICENSE` - Unicode -> Unicode-TOU +* python3-pip: add "Apache-2.0 & MPL-2.0 & LGPL-2.1-only & BSD-3-Clause & PSF-2.0 & BSD-2-Clause" to :term:`LICENSE` due to vendored libraries Other license-related notes: @@ -866,7 +870,7 @@ Repositories / Downloads for 4.0 poky -- Repository Location: https://git.yoctoproject.org/git/poky +- Repository Location: :yocto_git:`/poky` - Branch: :yocto_git:`kirkstone </poky/log/?h=kirkstone>` - Tag: :yocto_git:`yocto-4.0 </poky/tag/?h=yocto-4.0>` - Git Revision: :yocto_git:`00cfdde791a0176c134f31e5a09eff725e75b905 </poky/commit/?id=00cfdde791a0176c134f31e5a09eff725e75b905>` @@ -890,7 +894,7 @@ openembedded-core meta-mingw -- Repository Location: https://git.yoctoproject.org/git/meta-mingw +- Repository Location: :yocto_git:`/meta-mingw` - Branch: :yocto_git:`kirkstone </meta-mingw/log/?h=kirkstone>` - Tag: :yocto_git:`yocto-4.0 </meta-mingw/tag/?h=yocto-4.0>` - Git Revision: :yocto_git:`a90614a6498c3345704e9611f2842eb933dc51c1 </meta-mingw/commit/?id=a90614a6498c3345704e9611f2842eb933dc51c1>` @@ -902,7 +906,7 @@ meta-mingw meta-gplv2 -- Repository Location: https://git.yoctoproject.org/git/meta-gplv2 +- Repository Location: :yocto_git:`/meta-gplv2` - Branch: :yocto_git:`kirkstone </meta-gplv2/log/?h=kirkstone>` - Tag: :yocto_git:`yocto-4.0 </meta-gplv2/tag/?h=yocto-4.0>` - Git Revision: :yocto_git:`d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a </meta-mingw/commit/?id=d2f8b5cdb285b72a4ed93450f6703ca27aa42e8a>` @@ -926,7 +930,7 @@ bitbake yocto-docs -- Repository Location: https://git.yoctoproject.org/git/yocto-docs +- Repository Location: :yocto_git:`/yocto-docs` - Branch: :yocto_git:`kirkstone </yocto-docs/log/?h=kirkstone>` - Tag: :yocto_git:`yocto-4.0 </yocto-docs/tag/?h=yocto-4.0>` - Git Revision: :yocto_git:`a6f571ad5b087385cad8765ed455c4b4eaeebca6 </yocto-docs/commit/?id=a6f571ad5b087385cad8765ed455c4b4eaeebca6>` |