diff options
Diffstat (limited to 'poky/documentation')
31 files changed, 2135 insertions, 1615 deletions
diff --git a/poky/documentation/.gitignore b/poky/documentation/.gitignore index 35ead8af66..096b97ec28 100644 --- a/poky/documentation/.gitignore +++ b/poky/documentation/.gitignore @@ -1,5 +1,7 @@ _build/ Pipfile.lock +poky.yaml +sphinx-static/switchers.js .vscode/ */svg/*.png */svg/*.pdf diff --git a/poky/documentation/Makefile b/poky/documentation/Makefile index f04f381bd2..bec53399c0 100644 --- a/poky/documentation/Makefile +++ b/poky/documentation/Makefile @@ -57,4 +57,5 @@ all: html epub latexpdf # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). %: + $(SOURCEDIR)/set_versions.py @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/poky/documentation/README b/poky/documentation/README index 10b46de3e6..6f6a8ec842 100644 --- a/poky/documentation/README +++ b/poky/documentation/README @@ -113,13 +113,18 @@ documentation with Python3. Sphinx might be available in your Linux distro packages repositories, however it is not recommended to use distro packages, as they might be old versions, especially if you are using an LTS version of your -distro. The recommended method to install Sphinx and all required -dependencies is to use the Python Package Index (pip). +distro. The recommended method to install the latest versions of Sphinx +and of its required dependencies is to use the Python Package Index (pip). To install all required packages run: $ pip3 install sphinx sphinx_rtd_theme pyyaml +To make sure you always have the latest versions of such packages, you +should regularly run the same command with an added "--upgrade" option: + + $ pip3 install --upgrade sphinx sphinx_rtd_theme pyyaml + Also install the "inkscape" package from your distribution. Inkscape is need to convert SVG graphics to PNG (for EPUB export) and to PDF (for PDF export). @@ -170,17 +175,18 @@ The layout of the Yocto Project manuals is organized as follows Book Chapter Section - Section - Section - -Here are the heading styles defined in Sphinx: - - Book => overline === - Chapter => overline *** - Section => ==== - Section => ---- - Section => ^^^^ - Section => """" or ~~~~ + Subsection + Subsubsection + Subsubsubsection + +Here are the heading styles that we use in the manuals: + + Book => overline === + Chapter => overline *** + Section => ==== + Subsection => ---- + Subsubsection => ~~~~ + Subsubsubsection => ^^^^ With this proposal, we preserve the same TOCs between Sphinx and Docbook. diff --git a/poky/documentation/brief-yoctoprojectqs/index.rst b/poky/documentation/brief-yoctoprojectqs/index.rst index b01fb4d40b..ad5d8a950c 100644 --- a/poky/documentation/brief-yoctoprojectqs/index.rst +++ b/poky/documentation/brief-yoctoprojectqs/index.rst @@ -424,12 +424,12 @@ information including the website, wiki pages, and user manuals: development documentation, and access to a rich Yocto Project Development Community into which you can tap. -- **Developer Screencast:** The `Getting Started with the Yocto Project - - New Developer Screencast Tutorial <https://vimeo.com/36450321>`__ - provides a 30-minute video created for users unfamiliar with the - Yocto Project but familiar with Linux build hosts. While this - screencast is somewhat dated, the introductory and fundamental - concepts are useful for the beginner. +- **Video Seminar:** The `Introduction to the Yocto Project and Bitbake, Part 1 + <https://youtu.be/yuE7my3KOpo>`__ and + `Introduction to the Yocto Project and Bitbake, Part 2 + <https://youtu.be/iZ05TTyzGHk>`__ videos offer a video seminar + introducing you to the most important aspects of developing a + custom embedded Linux distribution with the Yocto Project. - **Yocto Project Overview and Concepts Manual:** The :doc:`/overview-manual/index` is a great diff --git a/poky/documentation/bsp-guide/bsp.rst b/poky/documentation/bsp-guide/bsp.rst index ab8ed54807..8ec7f2957e 100644 --- a/poky/documentation/bsp-guide/bsp.rst +++ b/poky/documentation/bsp-guide/bsp.rst @@ -1113,7 +1113,7 @@ list describes them in order of preference: #. *Use the LICENSE_FLAGS Variable to Define the Recipes that Have Commercial or Other Types of Specially-Licensed Packages:* For each of those recipes, you can specify a matching license string in a ``local.conf`` variable named - :term:`LICENSE_FLAGS_WHITELIST`. + :term:`LICENSE_FLAGS_ACCEPTED`. Specifying the matching license string signifies that you agree to the license. Thus, the build system can build the corresponding recipe and include the component in the image. See the @@ -1122,15 +1122,15 @@ list describes them in order of preference: how to use these variables. If you build as you normally would, without specifying any recipes in - the :term:`LICENSE_FLAGS_WHITELIST` variable, the build stops and provides + the :term:`LICENSE_FLAGS_ACCEPTED` variable, the build stops and provides you with the list of recipes that you have tried to include in the image - that need entries in the :term:`LICENSE_FLAGS_WHITELIST` variable. Once you + that need entries in the :term:`LICENSE_FLAGS_ACCEPTED` variable. Once you enter the appropriate license flags into it, restart the build to continue where it left off. During the build, the prompt will not appear again since you have satisfied the requirement. Once the appropriate license flags are on the white list in the - :term:`LICENSE_FLAGS_WHITELIST` variable, you can build the encumbered + :term:`LICENSE_FLAGS_ACCEPTED` variable, you can build the encumbered image with no change at all to the normal build process. #. *Get a Pre-Built Version of the BSP:* You can get this type of BSP by @@ -1143,7 +1143,7 @@ list describes them in order of preference: click-through license agreements presented by the website. If you want to build the image yourself using the recipes contained within the BSP tarball, you will still need to create an appropriate - :term:`LICENSE_FLAGS_WHITELIST` to match the encumbered recipes in the + :term:`LICENSE_FLAGS_ACCEPTED` to match the encumbered recipes in the BSP. .. note:: diff --git a/poky/documentation/conf.py b/poky/documentation/conf.py index 3015892d29..a5d7c0cd88 100644 --- a/poky/documentation/conf.py +++ b/poky/documentation/conf.py @@ -15,9 +15,27 @@ import os import sys import datetime +try: + import yaml +except ImportError: + sys.stderr.write("The Yocto Project Sphinx documentation requires PyYAML.\ + \nPlease make sure to install pyyaml python package.\n") + sys.exit(1) -current_version = "dev" -bitbake_version = "" # Leave empty for development branch +# current_version = "dev" +# bitbake_version = "" # Leave empty for development branch +# Obtain versions from poky.yaml instead +with open("poky.yaml") as data: + buff = data.read() + subst_vars = yaml.safe_load(buff) + if "DOCCONF_VERSION" not in subst_vars: + sys.stderr.write("Please set DOCCONF_VERSION in poky.yaml") + sys.exit(1) + current_version = subst_vars["DOCCONF_VERSION"] + if "BITBAKE_SERIES" not in subst_vars: + sys.stderr.write("Please set BITBAKE_SERIES in poky.yaml") + sys.exit(1) + bitbake_version = subst_vars["BITBAKE_SERIES"] # String used in sidebar version = 'Version: ' + current_version diff --git a/poky/documentation/dev-manual/common-tasks.rst b/poky/documentation/dev-manual/common-tasks.rst index c111355ccd..9d4aaa5a67 100644 --- a/poky/documentation/dev-manual/common-tasks.rst +++ b/poky/documentation/dev-manual/common-tasks.rst @@ -564,7 +564,7 @@ Directory`. Here is the main ``xserver-xf86-config`` recipe, which is named SUMMARY = "X.Org X server configuration file" HOMEPAGE = "http://www.x.org" SECTION = "x11/base" - LICENSE = "MIT-X" + LICENSE = "MIT" LIC_FILES_CHKSUM = "file://${COREBASE}/meta/COPYING.MIT;md5=3da9cfbcb788c80a0384361b4de20420" PR = "r33" @@ -1396,19 +1396,14 @@ another example that specifies these types of files, see the ":ref:`dev-manual/common-tasks:autotooled package`" section. Another way of specifying source is from an SCM. For Git repositories, -you must specify :term:`SRCREV` and -you should specify :term:`PV` to include -the revision with :term:`SRCPV`. Here -is an example from the recipe -``meta/recipes-kernel/blktrace/blktrace_git.bb``:: - - SRCREV = "d6918c8832793b4205ed3bfede78c2f915c23385" +you must specify :term:`SRCREV` and you should specify :term:`PV` to include +the revision with :term:`SRCPV`. Here is an example from the recipe +``meta/recipes-core/musl/gcompat_git.bb``:: - PR = "r6" - PV = "1.0.5+git${SRCPV}" + SRC_URI = "git://git.adelielinux.org/adelie/gcompat.git;protocol=https;branch=current" - SRC_URI = "git://git.kernel.dk/blktrace.git \ - file://ldflags.patch" + PV = "1.0.0+1.1+git${SRCPV}" + SRCREV = "af5a49e489fdc04b9cf02547650d7aeaccd43793" If your :term:`SRC_URI` statement includes URLs pointing to individual files fetched from a remote server other than a version control system, @@ -1481,6 +1476,22 @@ compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. The build system automatically applies patches as described in the ":ref:`dev-manual/common-tasks:patching code`" section. +Fetching Code Through Firewalls +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls and need to fetch code through a proxy. +See the ":doc:`/ref-manual/faq`" chapter for advice. + +Limiting the Number of Parallel Connections +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls or use servers where the number of parallel +connections is limited. In such cases, you can limit the number of fetch +tasks being run in parallel by adding the following to your ``local.conf`` +file:: + + do_fetch[number_threads] = "4" + Unpacking Code -------------- @@ -1543,7 +1554,7 @@ variables: given a piece of software licensed under the GNU General Public License version 2, you would set :term:`LICENSE` as follows:: - LICENSE = "GPLv2" + LICENSE = "GPL-2.0-only" The licenses you specify within :term:`LICENSE` can have any name as long as you do not use spaces, since spaces are used as separators between @@ -2338,7 +2349,7 @@ Following is one example: (``hello_2.3.bb``) SUMMARY = "GNU Helloworld application" SECTION = "examples" - LICENSE = "GPLv2+" + LICENSE = "GPL-2.0-or-later" LIC_FILES_CHKSUM = "file://COPYING;md5=751419260aa954499f7abaabaa882bbe" SRC_URI = "${GNU_MIRROR}/hello/hello-${PV}.tar.gz" @@ -2372,41 +2383,39 @@ following example shows this:: CFLAGS:prepend = "-I ${S}/include " -In the following example, ``mtd-utils`` is a makefile-based package:: +In the following example, ``lz4`` is a makefile-based package:: - SUMMARY = "Tools for managing memory technology devices" - SECTION = "base" - DEPENDS = "zlib lzo e2fsprogs util-linux" - HOMEPAGE = "http://www.linux-mtd.infradead.org/" - LICENSE = "GPLv2+" - LIC_FILES_CHKSUM = "file://COPYING;md5=0636e73ff0215e8d672dc4c32c317bb3 \ - file://include/common.h;beginline=1;endline=17;md5=ba05b07912a44ea2bf81ce409380049c" - - # Use the latest version at 26 Oct, 2013 - SRCREV = "9f107132a6a073cce37434ca9cda6917dd8d866b" - SRC_URI = "git://git.infradead.org/mtd-utils.git \ - file://add-exclusion-to-mkfs-jffs2-git-2.patch \ - " + SUMMARY = "Extremely Fast Compression algorithm" + DESCRIPTION = "LZ4 is a very fast lossless compression algorithm, providing compression speed at 400 MB/s per core, scalable with multi-cores CPU. It also features an extremely fast decoder, with speed in multiple GB/s per core, typically reaching RAM speed limits on multi-core systems." + HOMEPAGE = "https://github.com/lz4/lz4" - PV = "1.5.1+git${SRCPV}" + LICENSE = "BSD-2-Clause | GPL-2.0-only" + LIC_FILES_CHKSUM = "file://lib/LICENSE;md5=ebc2ea4814a64de7708f1571904b32cc \ + file://programs/COPYING;md5=b234ee4d69f5fce4486a80fdaf4a4263 \ + file://LICENSE;md5=d57c0d21cb917fb4e0af2454aa48b956 \ + " - S = "${WORKDIR}/git" + PE = "1" - EXTRA_OEMAKE = "'CC=${CC}' 'RANLIB=${RANLIB}' 'AR=${AR}' 'CFLAGS=${CFLAGS} -I${S}/include -DWITHOUT_XATTR' 'BUILDDIR=${S}'" + SRCREV = "d44371841a2f1728a3f36839fd4b7e872d0927d3" - do_install () { - oe_runmake install DESTDIR=${D} SBINDIR=${sbindir} MANDIR=${mandir} INCLUDEDIR=${includedir} - } + SRC_URI = "git://github.com/lz4/lz4.git;branch=release;protocol=https \ + file://CVE-2021-3520.patch \ + " + UPSTREAM_CHECK_GITTAGREGEX = "v(?P<pver>.*)" - PACKAGES =+ "mtd-utils-jffs2 mtd-utils-ubifs mtd-utils-misc" + S = "${WORKDIR}/git" + + # Fixed in r118, which is larger than the current version. + CVE_CHECK_IGNORE += "CVE-2014-4715" - FILES:mtd-utils-jffs2 = "${sbindir}/mkfs.jffs2 ${sbindir}/jffs2dump ${sbindir}/jffs2reader ${sbindir}/sumtool" - FILES:mtd-utils-ubifs = "${sbindir}/mkfs.ubifs ${sbindir}/ubi*" - FILES:mtd-utils-misc = "${sbindir}/nftl* ${sbindir}/ftl* ${sbindir}/rfd* ${sbindir}/doc* ${sbindir}/serve_image ${sbindir}/recv_image" + EXTRA_OEMAKE = "PREFIX=${prefix} CC='${CC}' CFLAGS='${CFLAGS}' DESTDIR=${D} LIBDIR=${libdir} INCLUDEDIR=${includedir} BUILD_STATIC=no" - PARALLEL_MAKE = "" + do_install() { + oe_runmake install + } - BBCLASSEXTEND = "native" + BBCLASSEXTEND = "native nativesdk" Splitting an Application into Multiple Packages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -2534,13 +2543,6 @@ doing the following: where you have installed them and whether those files are in different locations than the defaults. -.. note:: - - If image prelinking is enabled (e.g. :ref:`image-prelink <ref-classes-image-prelink>` is in :term:`USER_CLASSES` - which it is by default), prelink will change the binaries in the generated images - and this often catches people out. Remove that class to ensure binaries are - preserved exactly if that is necessary. - Following Recipe Style Guidelines --------------------------------- @@ -7908,6 +7910,20 @@ image cannot use this package group. However, it can install SysVinit and the appropriate packages will have support for both systemd and SysVinit. +Using systemd-journald without a traditional syslog daemon +---------------------------------------------------------- + +Counter-intuitively, ``systemd-journald`` is not a syslog runtime or provider, +and the proper way to use systemd-journald as your sole logging mechanism is to +effectively disable syslog entirely by setting these variables in your distribution +configuration file:: + + VIRTUAL-RUNTIME_syslog = "" + VIRTUAL-RUNTIME_base-utils-syslog = "" + +Doing so will prevent ``rsyslog`` / ``busybox-syslog`` from being pulled in by +default, leaving only ``journald``. + Selecting a Device Manager ========================== @@ -8273,26 +8289,39 @@ in a format suitable for use in global configuration (e.g., output from this command:: $ buildhistory-collect-srcrevs -a - # i586-poky-linux - SRCREV:pn-glibc = "b8079dd0d360648e4e8de48656c5c38972621072" - SRCREV:pn-glibc-initial = "b8079dd0d360648e4e8de48656c5c38972621072" - SRCREV:pn-opkg-utils = "53274f087565fd45d8452c5367997ba6a682a37a" - SRCREV:pn-kmod = "fd56638aed3fe147015bfa10ed4a5f7491303cb4" - # x86_64-linux - SRCREV:pn-gtk-doc-stub-native = "1dea266593edb766d6d898c79451ef193eb17cfa" - SRCREV:pn-dtc-native = "65cc4d2748a2c2e6f27f1cf39e07a5dbabd80ebf" - SRCREV:pn-update-rc.d-native = "eca680ddf28d024954895f59a241a622dd575c11" - SRCREV_glibc:pn-cross-localedef-native = "b8079dd0d360648e4e8de48656c5c38972621072" - SRCREV_localedef:pn-cross-localedef-native = "c833367348d39dad7ba018990bfdaffaec8e9ed3" - SRCREV:pn-prelink-native = "faa069deec99bf61418d0bab831c83d7c1b797ca" - SRCREV:pn-opkg-utils-native = "53274f087565fd45d8452c5367997ba6a682a37a" - SRCREV:pn-kern-tools-native = "23345b8846fe4bd167efdf1bd8a1224b2ba9a5ff" - SRCREV:pn-kmod-native = "fd56638aed3fe147015bfa10ed4a5f7491303cb4" - # qemux86-poky-linux - SRCREV_machine:pn-linux-yocto = "38cd560d5022ed2dbd1ab0dca9642e47c98a0aa1" - SRCREV_meta:pn-linux-yocto = "a227f20eff056e511d504b2e490f3774ab260d6f" # all-poky-linux - SRCREV:pn-update-rc.d = "eca680ddf28d024954895f59a241a622dd575c11" + SRCREV:pn-ca-certificates = "07de54fdcc5806bde549e1edf60738c6bccf50e8" + SRCREV:pn-update-rc.d = "8636cf478d426b568c1be11dbd9346f67e03adac" + # core2-64-poky-linux + SRCREV:pn-binutils = "87d4632d36323091e731eb07b8aa65f90293da66" + SRCREV:pn-btrfs-tools = "8ad326b2f28c044cb6ed9016d7c3285e23b673c8" + SRCREV_bzip2-tests:pn-bzip2 = "f9061c030a25de5b6829e1abf373057309c734c0" + SRCREV:pn-e2fsprogs = "02540dedd3ddc52c6ae8aaa8a95ce75c3f8be1c0" + SRCREV:pn-file = "504206e53a89fd6eed71aeaf878aa3512418eab1" + SRCREV_glibc:pn-glibc = "24962427071fa532c3c48c918e9d64d719cc8a6c" + SRCREV:pn-gnome-desktop-testing = "e346cd4ed2e2102c9b195b614f3c642d23f5f6e7" + SRCREV:pn-init-system-helpers = "dbd9197569c0935029acd5c9b02b84c68fd937ee" + SRCREV:pn-kmod = "b6ecfc916a17eab8f93be5b09f4e4f845aabd3d1" + SRCREV:pn-libnsl2 = "82245c0c58add79a8e34ab0917358217a70e5100" + SRCREV:pn-libseccomp = "57357d2741a3b3d3e8425889a6b79a130e0fa2f3" + SRCREV:pn-libxcrypt = "50cf2b6dd4fdf04309445f2eec8de7051d953abf" + SRCREV:pn-ncurses = "51d0fd9cc3edb975f04224f29f777f8f448e8ced" + SRCREV:pn-procps = "19a508ea121c0c4ac6d0224575a036de745eaaf8" + SRCREV:pn-psmisc = "5fab6b7ab385080f1db725d6803136ec1841a15f" + SRCREV:pn-ptest-runner = "bcb82804daa8f725b6add259dcef2067e61a75aa" + SRCREV:pn-shared-mime-info = "18e558fa1c8b90b86757ade09a4ba4d6a6cf8f70" + SRCREV:pn-zstd = "e47e674cd09583ff0503f0f6defd6d23d8b718d3" + # qemux86_64-poky-linux + SRCREV_machine:pn-linux-yocto = "20301aeb1a64164b72bc72af58802b315e025c9c" + SRCREV_meta:pn-linux-yocto = "2d38a472b21ae343707c8bd64ac68a9eaca066a0" + # x86_64-linux + SRCREV:pn-binutils-cross-x86_64 = "87d4632d36323091e731eb07b8aa65f90293da66" + SRCREV_glibc:pn-cross-localedef-native = "24962427071fa532c3c48c918e9d64d719cc8a6c" + SRCREV_localedef:pn-cross-localedef-native = "794da69788cbf9bf57b59a852f9f11307663fa87" + SRCREV:pn-debianutils-native = "de14223e5bffe15e374a441302c528ffc1cbed57" + SRCREV:pn-libmodulemd-native = "ee80309bc766d781a144e6879419b29f444d94eb" + SRCREV:pn-virglrenderer-native = "363915595e05fb252e70d6514be2f0c0b5ca312b" + SRCREV:pn-zstd-native = "e47e674cd09583ff0503f0f6defd6d23d8b718d3" .. note:: @@ -8354,21 +8383,18 @@ Here is an example of ``image-info.txt``: .. code-block:: none DISTRO = poky - DISTRO_VERSION = 1.7 - USER_CLASSES = buildstats image-prelink - IMAGE_CLASSES = image_types + DISTRO_VERSION = 3.4+snapshot-a0245d7be08f3d24ea1875e9f8872aa6bbff93be + USER_CLASSES = buildstats + IMAGE_CLASSES = qemuboot qemuboot license_image IMAGE_FEATURES = debug-tweaks IMAGE_LINGUAS = - IMAGE_INSTALL = packagegroup-core-boot run-postinsts + IMAGE_INSTALL = packagegroup-core-boot speex speexdsp BAD_RECOMMENDATIONS = NO_RECOMMENDATIONS = PACKAGE_EXCLUDE = - ROOTFS_POSTPROCESS_COMMAND = write_package_manifest; license_create_manifest; \ - write_image_manifest ; buildhistory_list_installed_image ; \ - buildhistory_get_image_installed ; ssh_allow_empty_password; \ - postinst_enable_logging; rootfs_update_timestamp ; ssh_disable_dns_lookup ; - IMAGE_POSTPROCESS_COMMAND = buildhistory_get_imageinfo ; - IMAGESIZE = 6900 + ROOTFS_POSTPROCESS_COMMAND = write_package_manifest; license_create_manifest; cve_check_write_rootfs_manifest; ssh_allow_empty_password; ssh_allow_root_login; postinst_enable_logging; rootfs_update_timestamp; write_image_test_data; empty_var_volatile; sort_passwd; rootfs_reproducible; + IMAGE_POSTPROCESS_COMMAND = buildhistory_get_imageinfo ; + IMAGESIZE = 9265 Other than ``IMAGESIZE``, which is the total size of the files in the image in Kbytes, the @@ -11041,17 +11067,17 @@ name and version (after variable expansion):: In order for a component restricted by a :term:`LICENSE_FLAGS` definition to be enabled and included in an image, it needs to have a matching entry in the global -:term:`LICENSE_FLAGS_WHITELIST` +:term:`LICENSE_FLAGS_ACCEPTED` variable, which is a variable typically defined in your ``local.conf`` file. For example, to enable the ``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` package, you could add either the string "commercial_gst-plugins-ugly" or the more -general string "commercial" to :term:`LICENSE_FLAGS_WHITELIST`. See the +general string "commercial" to :term:`LICENSE_FLAGS_ACCEPTED`. See the ":ref:`dev-manual/common-tasks:license flag matching`" section for a full explanation of how :term:`LICENSE_FLAGS` matching works. Here is the example:: - LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly" + LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly" Likewise, to additionally enable the package built from the recipe containing ``LICENSE_FLAGS = "license_${PN}_${PV}"``, and assuming that @@ -11059,7 +11085,7 @@ the actual recipe name was ``emgd_1.10.bb``, the following string would enable that package as well as the original ``gst-plugins-ugly`` package:: - LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly license_emgd_1.10" + LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly license_emgd_1.10" As a convenience, you do not need to specify the complete license string for every package. You can use @@ -11072,7 +11098,7 @@ previously mentioned as well as any other packages that have licenses starting with "commercial" or "license". :: - LICENSE_FLAGS_WHITELIST = "commercial license" + LICENSE_FLAGS_ACCEPTED = "commercial license" License Flag Matching ~~~~~~~~~~~~~~~~~~~~~ @@ -11080,7 +11106,7 @@ License Flag Matching License flag matching allows you to control what recipes the OpenEmbedded build system includes in the build. Fundamentally, the build system attempts to match :term:`LICENSE_FLAGS` strings found in -recipes against strings found in :term:`LICENSE_FLAGS_WHITELIST`. +recipes against strings found in :term:`LICENSE_FLAGS_ACCEPTED`. A match causes the build system to include a recipe in the build, while failure to find a match causes the build system to exclude a recipe. @@ -11089,19 +11115,19 @@ In general, license flag matching is simple. However, understanding some concepts will help you correctly and effectively use matching. Before a flag defined by a particular recipe is tested against the -entries of :term:`LICENSE_FLAGS_WHITELIST`, the expanded +entries of :term:`LICENSE_FLAGS_ACCEPTED`, the expanded string ``_${PN}`` is appended to the flag. This expansion makes each :term:`LICENSE_FLAGS` value recipe-specific. After expansion, the string is then matched against the entries. Thus, specifying ``LICENSE_FLAGS = "commercial"`` in recipe "foo", for example, results in the string ``"commercial_foo"``. And, to create a match, that string -must appear among the entries of :term:`LICENSE_FLAGS_WHITELIST`. +must appear among the entries of :term:`LICENSE_FLAGS_ACCEPTED`. Judicious use of the :term:`LICENSE_FLAGS` strings and the contents of the -:term:`LICENSE_FLAGS_WHITELIST` variable allows you a lot of flexibility for +:term:`LICENSE_FLAGS_ACCEPTED` variable allows you a lot of flexibility for including or excluding recipes based on licensing. For example, you can broaden the matching capabilities by using license flags string subsets -in :term:`LICENSE_FLAGS_WHITELIST`. +in :term:`LICENSE_FLAGS_ACCEPTED`. .. note:: @@ -11110,7 +11136,7 @@ in :term:`LICENSE_FLAGS_WHITELIST`. ``usethispart_1.3``, ``usethispart_1.4``, and so forth). For example, simply specifying the string "commercial" in the -:term:`LICENSE_FLAGS_WHITELIST` variable matches any expanded +:term:`LICENSE_FLAGS_ACCEPTED` variable matches any expanded :term:`LICENSE_FLAGS` definition that starts with the string "commercial" such as "commercial_foo" and "commercial_bar", which are the strings the build system automatically generates for @@ -11128,24 +11154,24 @@ This scheme works even if the :term:`LICENSE_FLAGS` string already has ``_${PN}`` appended. For example, the build system turns the license flag "commercial_1.2_foo" into "commercial_1.2_foo_foo" and would match both the general "commercial" and the specific "commercial_1.2_foo" -strings found in the :term:`LICENSE_FLAGS_WHITELIST` variable, as expected. +strings found in the :term:`LICENSE_FLAGS_ACCEPTED` variable, as expected. Here are some other scenarios: - You can specify a versioned string in the recipe such as "commercial_foo_1.2" in a "foo" recipe. The build system expands this string to "commercial_foo_1.2_foo". Combine this license flag with a - :term:`LICENSE_FLAGS_WHITELIST` variable that has the string + :term:`LICENSE_FLAGS_ACCEPTED` variable that has the string "commercial" and you match the flag along with any other flag that starts with the string "commercial". - Under the same circumstances, you can add "commercial_foo" in the - :term:`LICENSE_FLAGS_WHITELIST` variable and the build system not only + :term:`LICENSE_FLAGS_ACCEPTED` variable and the build system not only matches "commercial_foo_1.2" but also matches any license flag with the string "commercial_foo", regardless of the version. - You can be very specific and use both the package and version parts - in the :term:`LICENSE_FLAGS_WHITELIST` list (e.g. + in the :term:`LICENSE_FLAGS_ACCEPTED` list (e.g. "commercial_foo_1.2") to specifically match a versioned recipe. Other Variables Related to Commercial Licenses @@ -11167,20 +11193,20 @@ file:: gst-plugins-ugly-mpegaudioparse" COMMERCIAL_VIDEO_PLUGINS = "gst-plugins-ugly-mpeg2dec \ gst-plugins-ugly-mpegstream gst-plugins-bad-mpegvideoparse" - LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp" + LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp" Of course, you could also create a matching list for those components using the more general "commercial" in the -:term:`LICENSE_FLAGS_WHITELIST` variable, but that would also enable all +:term:`LICENSE_FLAGS_ACCEPTED` variable, but that would also enable all the other packages with :term:`LICENSE_FLAGS` containing "commercial", which you may or may not want:: - LICENSE_FLAGS_WHITELIST = "commercial" + LICENSE_FLAGS_ACCEPTED = "commercial" Specifying audio and video plugins as part of the ``COMMERCIAL_AUDIO_PLUGINS`` and ``COMMERCIAL_VIDEO_PLUGINS`` statements -(along with the enabling :term:`LICENSE_FLAGS_WHITELIST`) includes the +(along with the enabling :term:`LICENSE_FLAGS_ACCEPTED`) includes the plugins or components into built images, thus adding support for media formats or components. @@ -11544,7 +11570,7 @@ The NIST database knows which versions are vulnerable and which ones are not. Last but not least, you can choose to ignore vulnerabilities through -the :term:`CVE_CHECK_PN_WHITELIST` and :term:`CVE_CHECK_WHITELIST` +the :term:`CVE_CHECK_SKIP_RECIPE` and :term:`CVE_CHECK_IGNORE` variables. Implementation details @@ -11563,9 +11589,9 @@ Then, the code looks up all the CVE IDs in the NIST database for all the products defined in :term:`CVE_PRODUCT`. Then, for each found CVE: - If the package name (:term:`PN`) is part of - :term:`CVE_CHECK_PN_WHITELIST`, it is considered as patched. + :term:`CVE_CHECK_SKIP_RECIPE`, it is considered as patched. - - If the CVE ID is part of :term:`CVE_CHECK_WHITELIST`, it is + - If the CVE ID is part of :term:`CVE_CHECK_IGNORE`, it is considered as patched too. - If the CVE ID is part of the patched CVE for the recipe, it is diff --git a/poky/documentation/dev-manual/start.rst b/poky/documentation/dev-manual/start.rst index 9c7dde8cf2..96fabac1aa 100644 --- a/poky/documentation/dev-manual/start.rst +++ b/poky/documentation/dev-manual/start.rst @@ -502,9 +502,10 @@ your Yocto Project build host: can be easily avoided by manually optimizing this file often, this can be done in the following way: - 1. *Find the location of your VHDX file:* First you need to find the - distro app package directory, to achieve this open a Windows - Powershell as Administrator and run:: + 1. *Find the location of your VHDX file:* + + First you need to find the distro app package directory, to achieve this + open a Windows Powershell as Administrator and run:: C:\WINDOWS\system32> Get-AppxPackage -Name "*Ubuntu*" | Select PackageFamilyName PackageFamilyName @@ -516,22 +517,40 @@ your Yocto Project build host: replace the PackageFamilyName and your user on the following path to find your VHDX file:: - ls C:\Users\myuser\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79abcdefgh\LocalState\ - Mode LastWriteTime Length Name - -a---- 3/14/2020 9:52 PM 57418973184 ext4.vhdx + ls C:\Users\myuser\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79abcdefgh\LocalState\ + Mode LastWriteTime Length Name + -a---- 3/14/2020 9:52 PM 57418973184 ext4.vhdx Your VHDX file path is: ``C:\Users\myuser\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79abcdefgh\LocalState\ext4.vhdx`` - 2. *Optimize your VHDX file:* Open a Windows Powershell as - Administrator to optimize your VHDX file, shutting down WSL first:: + 2a. *Optimize your VHDX file using Windows Powershell:* + + To use the ``optimize-vhd`` cmdlet below, first install the Hyper-V + option on Windows. Then, open a Windows Powershell as Administrator to + optimize your VHDX file, shutting down WSL first:: C:\WINDOWS\system32> wsl --shutdown C:\WINDOWS\system32> optimize-vhd -Path C:\Users\myuser\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79abcdefgh\LocalState\ext4.vhdx -Mode full - A progress bar should be shown while optimizing the - VHDX file, and storage should now be reflected correctly on the - Windows Explorer. + A progress bar should be shown while optimizing the + VHDX file, and storage should now be reflected correctly on the + Windows Explorer. + + 2b. *Optimize your VHDX file using DiskPart:* + + The ``optimize-vhd`` cmdlet noted in step 2a above is provided by + Hyper-V. Not all SKUs of Windows can install Hyper-V. As an alternative, + use the DiskPart tool. To start, open a Windows command prompt as + Administrator to optimize your VHDX file, shutting down WSL first:: + + C:\WINDOWS\system32> wsl --shutdown + C:\WINDOWS\system32> diskpart + + DISKPART> select vdisk file="<path_to_VHDX_file>" + DISKPART> attach vdisk readonly + DISKPART> compact vdisk + DISKPART> exit .. note:: @@ -628,9 +647,7 @@ Follow these steps to locate and download a particular tarball: 3. *Find the Tarball:* Drill down to find the associated tarball. For example, click on ``yocto-&DISTRO;`` to view files associated with the - Yocto Project &DISTRO; release (e.g. - ``&YOCTO_POKY;.tar.bz2``, which is the - released Poky tarball). + Yocto Project &DISTRO; release. 4. *Download the Tarball:* Click the tarball to download and save a snapshot of the given component. diff --git a/poky/documentation/migration-guides/migration-2.2.rst b/poky/documentation/migration-guides/migration-2.2.rst index 3e35b2b8aa..10aa2d0684 100644 --- a/poky/documentation/migration-guides/migration-2.2.rst +++ b/poky/documentation/migration-guides/migration-2.2.rst @@ -26,8 +26,8 @@ Staging Directories in Sysroot Has Been Simplified The way directories are staged in sysroot has been simplified and introduces the new :term:`SYSROOT_DIRS`, -:term:`SYSROOT_DIRS_NATIVE`, and -:term:`SYSROOT_DIRS_BLACKLIST`. See the +:term:`SYSROOT_DIRS_NATIVE`, and ``SYSROOT_DIRS_BLACKLIST`` +(replaced by :term:`SYSROOT_DIRS_IGNORE` in version 3.5). See the :oe_lists:`v2 patch series on the OE-Core Mailing List </pipermail/openembedded-core/2016-May/121365.html>` for additional information. diff --git a/poky/documentation/migration-guides/migration-2.6.rst b/poky/documentation/migration-guides/migration-2.6.rst index c68414e1ca..11e659de7c 100644 --- a/poky/documentation/migration-guides/migration-2.6.rst +++ b/poky/documentation/migration-guides/migration-2.6.rst @@ -118,8 +118,7 @@ For names of recipes removed because of this repository change, see the --------------------------------------------------------------------------------------------------- Previously, it was possible for Python recipes that inherited the -``distutils`` and -:ref:`distutils3 <ref-classes-distutils3>` classes to fetch code +``distutils`` and ``distutils3`` classes to fetch code during the :ref:`ref-tasks-configure` task to satisfy dependencies mentioned in ``setup.py`` if those dependencies were not provided in the sysroot (i.e. recipes providing the dependencies were diff --git a/poky/documentation/migration-guides/migration-3.0.rst b/poky/documentation/migration-guides/migration-3.0.rst index 610298bda6..50d6758e71 100644 --- a/poky/documentation/migration-guides/migration-3.0.rst +++ b/poky/documentation/migration-guides/migration-3.0.rst @@ -148,7 +148,7 @@ XML feeds that ``cve-check-tool`` was using, supports CVSSv3 scoring, and makes other improvements. Additionally, the ``CVE_CHECK_CVE_WHITELIST`` variable has been replaced -by ``CVE_CHECK_WHITELIST``. +by ``CVE_CHECK_WHITELIST`` (replaced by :term:`CVE_CHECK_IGNORE` in version 3.5). .. _migration-3.0-bitbake-changes: diff --git a/poky/documentation/migration-guides/migration-3.3.rst b/poky/documentation/migration-guides/migration-3.3.rst index f982b1c80a..1eb494c286 100644 --- a/poky/documentation/migration-guides/migration-3.3.rst +++ b/poky/documentation/migration-guides/migration-3.3.rst @@ -90,17 +90,17 @@ example:: then in ``setup.py`` it works with source code in a relative fashion, such as ``../../src``. This causes pseudo to fail as it isn't able to track -the paths properly. This release introduces a new :term:`DISTUTILS_SETUP_PATH` +the paths properly. This release introduces a new ``DISTUTILS_SETUP_PATH`` variable so that recipes can specify it explicitly, for example:: S = "${WORKDIR}/git" DISTUTILS_SETUP_PATH = "${S}/python/pythonmodule" -Recipes that inherit from :ref:`distutils3 <ref-classes-distutils3>` (or +Recipes that inherit from ``distutils3`` (or :ref:`setuptools3 <ref-classes-setuptools3>` which itself inherits -:ref:`distutils3 <ref-classes-distutils3>`) that also set :term:`S` to +``distutils3``) that also set :term:`S` to point to a Python module within a subdirectory in the aforementioned -manner should be changed to set :term:`DISTUTILS_SETUP_PATH` instead. +manner should be changed to set ``DISTUTILS_SETUP_PATH`` instead. .. _migration-3.3-bitbake: diff --git a/poky/documentation/migration-guides/migration-3.4.rst b/poky/documentation/migration-guides/migration-3.4.rst index 40e01d4f84..139b2bf9c0 100644 --- a/poky/documentation/migration-guides/migration-3.4.rst +++ b/poky/documentation/migration-guides/migration-3.4.rst @@ -255,7 +255,8 @@ Miscellaneous - The previously deprecated ``COMPRESS_CMD`` and ``CVE_CHECK_CVE_WHITELIST`` variables have been removed. Use - ``CONVERSION_CMD`` and :term:`CVE_CHECK_WHITELIST` respectively + ``CONVERSION_CMD`` and ``CVE_CHECK_WHITELIST`` (replaced by + :term:`CVE_CHECK_IGNORE` in version 3.5) respectively instead. - The obsolete ``oe_machinstall`` function previously provided in the @@ -264,1055 +265,6 @@ Miscellaneous built-in override support in the fetcher or overrides in general instead. -Release notes for 3.4 (honister) --------------------------------- - -New Features / Enhancements in 3.4 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- Linux kernel 5.14, glibc 2.34 and ~280 other recipe upgrades -- Switched override character to ':' (replacing '_') for more robust parsing and improved performance - see the above migration guide for help -- Rust integrated into core, providing rust support for cross-compilation and SDK -- New create-spdx class for creating SPDX SBoM documents -- New recipes: cargo, core-image-ptest-all, core-image-ptest-fast, core-image-weston-sdk, erofs-utils, gcompat, gi-docgen, libmicrohttpd, libseccomp, libstd-rs, perlcross, python3-markdown, python3-pyyaml, python3-smartypants, python3-typogrify, rust, rust-cross, rust-cross-canadian, rust-hello-world, rust-llvm, rust-tools-cross-canadian, rustfmt, xwayland -- Several optimisations to reduce unnecessary task dependencies for faster builds -- seccomp integrated into core, with additional enabling for gnutls, systemd, qemu -- New overlayfs class to help generate overlayfs mount units -- debuginfod support now enabled by default -- Switched several recipes over to using OpenSSL instead of GnuTLS (wpa-supplicant, curl, glib-networking) or disable GnuTLS (cups) by default -- Improvements to LTO plugin installation and reproducibility -- Architecture-specific enhancements: - - - glibc: Enable memory tagging for aarch64 - - testimage: remove aarch64 xorg exclusion - - arch-arm*: add better support for gcc march extensions - - tune-cortexm*: add support for all Arm Cortex-M processors - - tune-cortexr*: add support for all Arm Cortex-R processors - - arch-armv4: Allow -march=armv4 - - qemuarm*: use virtio graphics - - baremetal-helloworld: Enable RISC-V 64/32 port - - ldconfig-native: Add RISC-V support - - qemuriscv: Enable 4 core emulation - - Add ARC support in gdb, dpkg, dhcpcd - - conf/machine-sdk: Add ppc64 SDK machine - - libjpeg-turbo: Handle powerpc64le without Altivec - - pixman: Handle PowerPC without Altivec - - mesa: enable gallium Intel drivers when building for x86 - - mesa: enable crocus driver for older Intel graphics - -- Kernel-related enhancements: - - - Support zstd-compressed modules and initramfs images - - Allow opt-out of split kernel modules - - linux-yocto-dev: base AUTOREV on specified version - - kernel-yocto: provide debug / summary information for metadata - - kernel-uboot: Handle gzip and lzo compression options - - linux-yocto/5.14: added devupstream support - - linux-yocto: add vfat to :term:`KERNEL_FEATURES` when :term:`MACHINE_FEATURES` include vfat - - linux-yocto: enable TYPEC_TCPCI in usbc fragment - -- Image-related enhancements: - - - New erofs, erofs-lz4 and erofs-lz4hc image types - - New squashfs-zst and cpio.zst image types - - New lic-pkgs :term:`IMAGE_FEATURES` item to install all license packages - - Added zsync metadata conversion support - - Use xargs to set file timestamps for significant (>90%) do_image speedup - - Find .ko.gz and .ko.xz kernel modules as well when determining need to run depmod on an image - - Show formatted error messages instead of tracebacks for systemctl errors - - No longer ignore installation failures in complementary package installation - - Remove ldconfig auxiliary cache when not needed - -- wic enhancements: - - - Added erofs filesystem support - - Added --extra-space argument to leave extra space after last partition - - Added --no-fstab-update part option to allow using the stock fstab - - bootimg-efi: added Unified Kernel Image option - - bootimg-pcbios: use label provided when formatting a DOS partition - -- SDK-related enhancements: - - - Enable do_populate_sdk with multilibs - - New ``SDKPATHINSTALL`` variable decouples default install path from built in path to avoid rebuilding nativesdk components on e.g. :term:`DISTRO_VERSION` changes - - eSDK: Error if trying to generate an eSDK from a multiconfig - - eSDK: introduce :term:`TOOLCHAIN_HOST_TASK_ESDK` to be used in place of :term:`TOOLCHAIN_HOST_TASK` to add components to the host part of the eSDK - -- BitBake enhancements: - - - New bitbake-getvar helper command to query a variable value (with history) - - bitbake-layers: layerindex-fetch: add --fetchdir parameter - - bitbake-layers: show-recipes: add skip reason to output - - bitbake-diffsigs: sort diff output for consistency - - Allow setting upstream for local hash equivalence server - - fetch2/s3: allow to use credentials and switch profile from environment variables - - fetch2/s3: Add progress handler for S3 cp command - - fetch2/npm: Support npm archives with missing search directory mode - - fetch2/npmsw: Add support for local tarball and link sources - - fetch2/svn: Allow peg-revision functionality to be disabled - - fetch2/wget: verify certificates for HTTPS/FTPS by default - - fetch2/wget: Enable FTPS - - prserv: added read-only mode - - prserv: replaced XML RPC with modern asyncrpc implementation - - Numerous warning/error message improvements - -- New :term:`PACKAGECONFIG` options in btrfs-tools, ccache, coreutils, cups, dbus, elfutils, ffmpeg, findutils, glib-2.0, gstreamer1.0-plugins-bad, gstreamer1.0-plugins-base, libarchive, libnotify, libpsl, man-db, mesa, ovmf, parted, prelink, qemu, rpm, shadow, systemd, tar, vim, weston -- u-boot enhancements: - - - Make SPL suffix configurable - - Make ``UBOOT_BINARYNAME`` configurable - - Package ``extlinux.conf`` separately - - Allow deploying the u-boot DTB - -- opensbi: Add support for specifying a device tree -- busybox enhancements: - - - Added tmpdir option into mktemp applet - - Support mounting swap via labels - - Enable long options for enabled applets - -- Move tune files to architecture subdirectories -- buildstats: log host data on failure separately to task specific file -- buildstats: collect "at interval" and "on failure" logs in the same file -- Ptest enhancements: - - - ptest-runner: install script to collect system data on failure - - Added ptest support to python3-hypothesis, python3-jinja2, python3-markupsafe - - Enhanced ptest support in lttng, util-linux, and others - - New leaner ptest image recipes based upon core-image-minimal - -- scripts/contrib/image-manifest: add new script -- Add beginnings of Android target support -- devtool upgrade: rebase override-only patches as well -- devtool: print a warning on upgrades if :term:`PREFERRED_VERSION` is set -- systemd: set zstd as default compression option -- init-manager-systemd: add a weak VIRTUAL-RUNTIME_dev_manager assignment -- Add proper unpack dependency for .zst compressed archives -- util-linux: build chfn and chsh by default -- qemu: use 4 cores in qemu guests -- runqemu: decouple bios and kernel options -- qemu: add a hint on how to enable CPU render nodes when a suitable GPU is absent -- devupstream: Allow support of native class extensions -- Prelinking now disabled in default configuration -- python3: statistics module moved to its own python3-statistics package -- pypi: allow override of PyPI archive name -- Allow global override of golang GO_DYNLINK -- buildhistory enhancements: - - - Add option to strip path prefix - - Add output file listing package information - - Label packages providing per-file dependencies in depends.dot - -- New gi-docgen class for GNOME library documentation -- meson.bbclass: Make the default buildtype "debug" if :term:`DEBUG_BUILD` is 1 -- distro_features_check: expand with :term:`IMAGE_FEATURES` -- Add extended packagedata in JSON format -- local.conf.sample: Update sstate mirror entry with new hash equivalence setting -- poky: Use https in default :term:`PREMIRRORS` -- reproducible_build.bbclass: Enable -Wdate-time -- yocto-check-layer: ensure that all layer dependencies are tested too -- core-image-multilib-example: base on weston, and not sato -- npm.bbclass: Allow nodedir to be overridden by ``NPM_NODEDIR`` -- cve-extra-exclusions.inc: add exclusion list for intractable CVE's -- license_image.bbclass: Detect broken symlinks -- sysstat: make the service start automatically -- sanity: Add error check for '%' in build path -- sanity: Further improve directory sanity tests -- sanity.bbclass: mention ``CONNECTIVITY_CHECK_URIS`` in network failure message -- tzdata: Allow controlling zoneinfo binary format -- oe-time-dd-test.sh: add options and refactor -- vim: add option to disable NLS support -- zstd: Include pzstd in the build -- mirrors.bbclass: provide additional rule for git repo fallbacks -- own-mirrors: Add support for s3:// scheme in :term:`SOURCE_MIRROR_URL` -- common-licenses: add missing SPDX licences -- Add MAINTAINERS.md file to record subsystem maintainers - -Known Issues in 3.4 -~~~~~~~~~~~~~~~~~~~ - -- Build failures have been reported when running on host Linux systems with FIPS enabled (such as RHEL 8.0 with the FIPS mode enabled). For more details please see :yocto_bugs:`bug #14609 </show_bug.cgi?id=14609>`. - -Recipe Licenses changes in 3.4 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following corrections have been made to the LICENSE values set by recipes: - -- acpica: correct LICENSE to "Intel | BSD-3-Clause | GPLv2" -- dtc: correct LICENSE to "GPLv2 | BSD-2-Clause" -- e2fsprogs: correct LICENSE to "GPLv2 & LGPLv2 & BSD-3-Clause & MIT" -- ffmpeg: correct LICENSE to "GPLv2+ & LGPLv2.1+ & ISC & MIT & BSD-2-Clause & BSD-3-Clause & IJG" -- flac: correct LICENSE to "GFDL-1.2 & GPLv2+ & LGPLv2.1+ & BSD-3-Clause" -- flex: correct LICENSE to "BSD-3-Clause & LGPL-2.0+" -- font-util: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" -- glib-2.0: correct LICENSE to "LGPLv2.1+ & BSD-3-Clause & PD" -- gobject-introspection: correct LICENSE to "LGPLv2+ & GPLv2+ & MIT" (add MIT license) -- hdparm: correct LICENSE to "BSD-2-Clause & GPLv2 & hdparm" -- iputils: correct LICENSE to "BSD-3-Clause & GPLv2+" -- libcap: correct LICENSE to "BSD-3-Clause | GPLv2" -- libevent: correct LICENSE to "BSD-3-Clause & MIT" -- libjitterentropy: correct LICENSE to "GPLv2+ | BSD-3-Clause" -- libpam: correct LICENSE to "GPLv2+ | BSD-3-Clause" -- libwpe: correct LICENSE to "BSD-2-Clause" -- libx11-compose-data: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" -- libx11: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" -- libxfont2: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" -- libxfont: correct LICENSE to "MIT & MIT-style & BSD-3-Clause" -- lsof: correct LICENSE to reflect that it uses a BSD-like (but not exactly BSD) license ("Spencer-94") -- nfs-utils: correct LICENSE to "MIT & GPLv2+ & BSD-3-Clause" -- ovmf: correct license to "BSD-2-Clause-Patent" -- ppp: correct LICENSE to "BSD-3-Clause & BSD-3-Clause-Attribution & GPLv2+ & LGPLv2+ & PD" -- python3-packaging: correct LICENSE to "Apache-2.0 | BSD-2-Clause" -- python-async-test: correct LICENSE to "BSD-3-Clause" -- quota: remove BSD license (only BSD licensed part of the code was removed in 4.05) -- shadow: correct LICENSE to "BSD-3-Clause | Artistic-1.0" -- shadow-sysroot: set LICENSE the same as shadow -- sudo: correct LICENSE to "ISC & BSD-3-Clause & BSD-2-Clause & Zlib" -- swig: correct LICENSE to "BSD-3-Clause & GPLv3" -- valgrind: correct license to "GPLv2 & GPLv2+ & BSD-3-Clause" -- webkitgtk: correct LICENSE to "BSD-2-Clause & LGPLv2+" -- wpebackend-fdo: correct LICENSE to "BSD-2-Clause" -- xinetd: correct LICENSE to reflect that it uses a unique BSD-like (but not exactly BSD) license - -Other license-related notes: - -- When creating recipes for Python software, recipetool will now treat "BSD" as "BSD-3-Clause" for the purposes of setting LICENSE, as that is the most common understanding. -- Please be aware that an initramfs bundled with the kernel using :term:`INITRAMFS_IMAGE_BUNDLE` should only contain GPLv2-compatible software; this is now mentioned in the documentation. - -Security Fixes in 3.4 -~~~~~~~~~~~~~~~~~~~~~ - -- apr: :cve:`2021-35940` -- aspell: :cve:`2019-25051` -- avahi: :cve:`2021-3468`, :cve:`2021-36217` -- binutils: :cve:`2021-20197` -- bluez: :cve:`2021-3658` -- busybox: :cve:`2021-28831` -- cairo: :cve:`2020-35492` -- cpio: :cve:`2021-38185` -- expat: :cve:`2013-0340` -- ffmpeg: :cve:`2020-20446`, :cve:`2020-22015`, :cve:`2020-22021`, :cve:`2020-22033`, :cve:`2020-22019`, :cve:`2021-33815`, :cve:`2021-38171`, :cve:`2020-20453` -- glibc: :cve:`2021-33574`, :cve:`2021-38604` -- inetutils: :cve:`2021-40491` -- libgcrypt: :cve:`2021-40528` -- linux-yocto/5.10, 5.14: :cve:`2021-3653`, :cve:`2021-3656` -- lz4: :cve:`2021-3520` -- nettle: :cve:`2021-20305` -- openssl: :cve:`2021-3711`, :cve:`2021-3712` -- perl: :cve:`2021-36770` -- python3: :cve:`2021-29921` -- python3-pip: :cve:`2021-3572` -- qemu: :cve:`2020-27821`, :cve:`2020-29443`, :cve:`2020-35517`, :cve:`2021-3392`, :cve:`2021-3409`, :cve:`2021-3416`, :cve:`2021-3527`, :cve:`2021-3544`, :cve:`2021-3545`, :cve:`2021-3546`, :cve:`2021-3682`, :cve:`2021-20181`, :cve:`2021-20221`, :cve:`2021-20257`, :cve:`2021-20263` -- rpm: :cve:`2021-3421`, :cve:`2021-20271` -- rsync: :cve:`2020-14387` -- util-linux: :cve:`2021-37600` -- vim: :cve:`2021-3770`, :cve:`2021-3778` -- wpa-supplicant: :cve:`2021-30004` -- xdg-utils: :cve:`2020-27748` -- xserver-xorg: :cve:`2021-3472` - -Recipe Upgrades in 3.4 -~~~~~~~~~~~~~~~~~~~~~~ - -- acl 2.2.53 -> 2.3.1 -- acpica 20210105 -> 20210730 -- alsa-lib 1.2.4 -> 1.2.5.1 -- alsa-plugins 1.2.2 -> 1.2.5 -- alsa-tools 1.2.2 -> 1.2.5 -- alsa-topology-conf 1.2.4 -> 1.2.5.1 -- alsa-ucm-conf 1.2.4 -> 1.2.5.1 -- alsa-utils 1.2.4 -> 1.2.5.1 -- alsa-utils-scripts 1.2.4 -> 1.2.5.1 -- apt 2.2.2 -> 2.2.4 -- at 3.2.1 -> 3.2.2 -- at-spi2-core 2.38.0 -> 2.40.3 -- autoconf-archive 2019.01.06 -> 2021.02.19 -- babeltrace2 2.0.3 -> 2.0.4 -- bash 5.1 -> 5.1.8 -- bind 9.16.16 -> 9.16.20 -- binutils 2.36.1 -> 2.37 -- binutils-cross 2.36.1 -> 2.37 -- binutils-cross-canadian 2.36.1 -> 2.37 -- binutils-cross-testsuite 2.36.1 -> 2.37 -- binutils-crosssdk 2.36.1 -> 2.37 -- bison 3.7.5 -> 3.7.6 -- blktrace 1.2.0+gitX -> 1.3.0+gitX -- bluez5 5.56 -> 5.61 -- boost 1.75.0 -> 1.77.0 -- boost-build-native 4.3.0 -> 4.4.1 -- btrfs-tools 5.10.1 -> 5.13.1 -- busybox 1.33.1 -> 1.34.0 -- busybox-inittab 1.33.0 -> 1.34.0 -- ccache 4.2 -> 4.4 -- cmake 3.19.5 -> 3.21.1 -- cmake-native 3.19.5 -> 3.21.1 -- connman 1.39 -> 1.40 -- createrepo-c 0.17.0 -> 0.17.4 -- cronie 1.5.5 -> 1.5.7 -- cross-localedef-native 2.33 -> 2.34 -- cups 2.3.3 -> 2.3.3op2 -- curl 7.75.0 -> 7.78.0 -- dbus-glib 0.110 -> 0.112 -- dejagnu 1.6.2 -> 1.6.3 -- diffoscope 172 -> 181 -- diffutils 3.7 -> 3.8 -- distcc 3.3.5 -> 3.4 -- dnf 4.6.0 -> 4.8.0 -- dpkg 1.20.7.1 -> 1.20.9 -- dtc 1.6.0 -> 1.6.1 -- e2fsprogs 1.46.1 -> 1.46.4 -- elfutils 0.183 -> 0.185 -- ell 0.38 -> 0.43 -- enchant2 2.2.15 -> 2.3.1 -- epiphany 3.38.2 -> 40.3 -- ethtool 5.10 -> 5.13 -- expat 2.2.10 -> 2.4.1 -- ffmpeg 4.3.2 -> 4.4 -- file 5.39 -> 5.40 -- freetype 2.10.4 -> 2.11.0 -- gcc 10.2.0 -> 11.2.0 -- gcc-cross 10.2.0 -> 11.2.0 -- gcc-cross-canadian 10.2.0 -> 11.2.0 -- gcc-crosssdk 10.2.0 -> 11.2.0 -- gcc-runtime 10.2.0 -> 11.2.0 -- gcc-sanitizers 10.2.0 -> 11.2.0 -- gcc-source 10.2.0 -> 11.2.0 -- gcr 3.38.1 -> 3.40.0 -- gdb 10.1 -> 10.2 -- gdb-cross 10.1 -> 10.2 -- gdb-cross-canadian 10.1 -> 10.2 -- gdk-pixbuf 2.40.0 -> 2.42.6 -- ghostscript 9.53.3 -> 9.54.0 -- git 2.31.1 -> 2.33.0 -- glib-2.0 2.66.7 -> 2.68.4 -- glib-networking 2.66.0 -> 2.68.2 -- glibc 2.33 -> 2.34 -- glibc-locale 2.33 -> 2.34 -- glibc-mtrace 2.33 -> 2.34 -- glibc-scripts 2.33 -> 2.34 -- glibc-testsuite 2.33 -> 2.34 -- glslang 11.2.0 -> 11.5.0 -- gnome-desktop-testing 2018.1 -> 2021.1 -- gnu-config 20210125+gitX -> 20210722+gitX -- gnu-efi 3.0.12 -> 3.0.14 -- gnupg 2.2.27 -> 2.3.1 -- gobject-introspection 1.66.1 -> 1.68.0 -- gpgme 1.15.1 -> 1.16.0 -- gptfdisk 1.0.7 -> 1.0.8 -- grep 3.6 -> 3.7 -- grub 2.04+2.06~rc1 -> 2.06 -- grub-efi 2.04+2.06~rc1 -> 2.06 -- gsettings-desktop-schemas 3.38.0 -> 40.0 -- gtk+3 3.24.25 -> 3.24.30 -- harfbuzz 2.7.4 -> 2.9.0 -- hdparm 9.60 -> 9.62 -- help2man 1.48.2 -> 1.48.4 -- hwlatdetect 1.10 -> 2.1 -- i2c-tools 4.2 -> 4.3 -- icu 68.2 -> 69.1 -- igt-gpu-tools 1.25+gitX -> 1.26 -- inetutils 2.0 -> 2.1 -- iproute2 5.11.0 -> 5.13.0 -- iputils s20200821 -> 20210722 -- json-glib 1.6.2 -> 1.6.4 -- kexec-tools 2.0.21 -> 2.0.22 -- kmod 28 -> 29 -- kmod-native 28 -> 29 -- less 563 -> 590 -- libassuan 2.5.4 -> 2.5.5 -- libcap 2.48 -> 2.51 -- libcgroup 0.41 -> 2.0 -- libcomps 0.1.15 -> 0.1.17 -- libconvert-asn1-perl 0.27 -> 0.31 -- libdazzle 3.38.0 -> 3.40.0 -- libdnf 0.58.0 -> 0.63.1 -- libdrm 2.4.104 -> 2.4.107 -- libedit 20210216-3.1 -> 20210714-3.1 -- libepoxy 1.5.5 -> 1.5.9 -- liberation-fonts 2.00.1 -> 2.1.4 -- libffi 3.3 -> 3.4.2 -- libfm 1.3.1 -> 1.3.2 -- libgcc 10.2.0 -> 11.2.0 -- libgcc-initial 10.2.0 -> 11.2.0 -- libgcrypt 1.9.3 -> 1.9.4 -- libgfortran 10.2.0 -> 11.2.0 -- libgit2 1.1.0 -> 1.1.1 -- libglu 9.0.1 -> 9.0.2 -- libgpg-error 1.41 -> 1.42 -- libgudev 234 -> 237 -- libhandy 1.2.0 -> 1.2.3 -- libical 3.0.9 -> 3.0.10 -- libidn2 2.3.0 -> 2.3.2 -- libinput 1.16.4 -> 1.18.1 -- libjitterentropy 3.0.1 -> 3.1.0 -- libjpeg-turbo 2.0.6 -> 2.1.1 -- libksba 1.5.0 -> 1.6.0 -- libmodulemd 2.12.0 -> 2.13.0 -- libnsl2 1.3.0 -> 2.0.0 -- libnss-mdns 0.14.1 -> 0.15.1 -- libogg 1.3.4 -> 1.3.5 -- libpcap 1.10.0 -> 1.10.1 -- libpcre 8.44 -> 8.45 -- libpcre2 10.36 -> 10.37 -- libportal 0.3 -> 0.4 -- librepo 1.13.0 -> 1.14.1 -- libsdl2 2.0.14 -> 2.0.16 -- libsolv 0.7.17 -> 0.7.19 -- libtasn1 4.16.0 -> 4.17.0 -- libtest-needs-perl 0.002006 -> 0.002009 -- libtirpc 1.3.1 -> 1.3.2 -- libubootenv 0.3.1 -> 0.3.2 -- libucontext 0.10+X -> 1.1+X -- liburcu 0.12.2 -> 0.13.0 -- libuv 1.41.0 -> 1.42.0 -- libva 2.10.0 -> 2.12.0 -- libva-initial 2.10.0 -> 2.12.0 -- libva-utils 2.10.0 -> 2.12.0 -- libwebp 1.2.0 -> 1.2.1 -- libwpe 1.8.0 -> 1.10.1 -- libx11 1.7.0 -> 1.7.2 -- libxcrypt 4.4.18 -> 4.4.25 -- libxcrypt-compat 4.4.18 -> 4.4.25 -- libxfixes 5.0.3 -> 6.0.0 -- libxfont2 2.0.4 -> 2.0.5 -- libxft 2.3.3 -> 2.3.4 -- libxi 1.7.10 -> 1.7.99.2 -- libxkbcommon 1.0.3 -> 1.3.0 -- libxml2 2.9.10 -> 2.9.12 -- libxres 1.2.0 -> 1.2.1 -- linux-libc-headers 5.10 -> 5.14 -- linux-yocto 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX -- linux-yocto-dev 5.12++gitX -> 5.15++gitX -- linux-yocto-rt 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX -- linux-yocto-tiny 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX -- llvm 11.1.0 -> 12.0.1 -- log4cplus 2.0.6 -> 2.0.7 -- logrotate 3.18.0 -> 3.18.1 -- ltp 20210121 -> 20210524 -- lttng-modules 2.12.6 -> 2.13.0 -- lttng-tools 2.12.4 -> 2.13.0 -- lttng-ust 2.12.1 -> 2.13.0 -- m4 1.4.18 -> 1.4.19 -- m4-native 1.4.18 -> 1.4.19 -- man-pages 5.10 -> 5.12 -- mc 4.8.26 -> 4.8.27 -- mesa 21.0.3 -> 21.2.1 -- mesa-gl 21.0.3 -> 21.2.1 -- meson 0.57.1 -> 0.58.1 -- mmc-utils 0.1+gitX (73d6c59af8d1...) -> 0.1+gitX (43282e80e174...) -- mobile-broadband-provider-info 20201225 -> 20210805 -- mpg123 1.26.4 -> 1.28.2 -- mtd-utils 2.1.2 -> 2.1.3 -- mtools 4.0.26 -> 4.0.35 -- musl 1.2.2+gitX (e5d2823631bb...) -> 1.2.2+gitX (3f701faace7a...) -- nativesdk-meson 0.57.1 -> 0.58.1 -- netbase 6.2 -> 6.3 -- nfs-utils 2.5.3 -> 2.5.4 -- ofono 1.31 -> 1.32 -- openssh 8.5p1 -> 8.7p1 -- opkg 0.4.4 -> 0.4.5 -- opkg-utils 0.4.3 -> 0.4.5 -- ovmf edk2-stable202102 -> edk2-stable202105 -- p11-kit 0.23.22 -> 0.24.0 -- pango 1.48.2 -> 1.48.9 -- patchelf 0.12 -> 0.13 -- perl 5.32.1 -> 5.34.0 -- piglit 1.0+gitrX (d4d9353b7290...) -> 1.0+gitrX (6a4be9e9946d...) -- pkgconf 1.7.3 -> 1.8.0 -- powertop 2.13 -> 2.14 -- pseudo 1.9.0+gitX (b988b0a6b8af...) -> 1.9.0+gitX (0cda3ba5f94a...) -- pulseaudio 14.2 -> 15.0 -- puzzles 0.0+gitX (84cb4c6701e0...) -> 0.0+gitX (8f3413c31ffd...) -- python3 3.9.5 -> 3.9.6 -- python3-attrs 20.3.0 -> 21.2.0 -- python3-cython 0.29.22 -> 0.29.24 -- python3-dbus 1.2.16 -> 1.2.18 -- python3-dbusmock 0.22.0 -> 0.23.1 -- python3-docutils 0.16 -> 0.17.1 -- python3-git 3.1.14 -> 3.1.20 -- python3-gitdb 4.0.5 -> 4.0.7 -- python3-hypothesis 6.2.0 -> 6.15.0 -- python3-importlib-metadata 3.4.0 -> 4.6.4 -- python3-iniparse 0.4 -> 0.5 -- python3-jinja2 2.11.3 -> 3.0.1 -- python3-libarchive-c 2.9 -> 3.1 -- python3-magic 0.4.22 -> 0.4.24 -- python3-mako 1.1.4 -> 1.1.5 -- python3-markupsafe 1.1.1 -> 2.0.1 -- python3-more-itertools 8.7.0 -> 8.8.0 -- python3-numpy 1.20.1 -> 1.21.2 -- python3-packaging 20.9 -> 21.0 -- python3-pathlib2 2.3.5 -> 2.3.6 -- python3-pbr 5.4.4 -> 5.6.0 -- python3-pip 20.0.2 -> 21.2.4 -- python3-pluggy 0.13.1 -> 1.0.0 -- python3-pycairo 1.20.0 -> 1.20.1 -- python3-pygments 2.8.1 -> 2.10.0 -- python3-pygobject 3.38.0 -> 3.40.1 -- python3-pytest 6.2.2 -> 6.2.4 -- python3-scons 3.1.2 -> 4.2.0 -- python3-scons-native 3.1.2 -> 4.2.0 -- python3-setuptools 54.1.1 -> 57.4.0 -- python3-setuptools-scm 5.0.1 -> 6.0.1 -- python3-six 1.15.0 -> 1.16.0 -- python3-sortedcontainers 2.3.0 -> 2.4.0 -- python3-testtools 2.4.0 -> 2.5.0 -- python3-zipp 3.4.1 -> 3.5.0 -- qemu 5.2.0 -> 6.0.0 -- qemu-native 5.2.0 -> 6.0.0 -- qemu-system-native 5.2.0 -> 6.0.0 -- re2c 2.0.3 -> 2.2 -- rng-tools 6.11 -> 6.14 -- rpcbind 1.2.5 -> 1.2.6 -- rt-tests 1.10 -> 2.1 -- ruby 3.0.1 -> 3.0.2 -- rxvt-unicode 9.22 -> 9.26 -- shaderc 2020.5 -> 2021.1 -- shadow 4.8.1 -> 4.9 -- spirv-tools 2020.7 -> 2021.2 -- sqlite3 3.35.0 -> 3.36.0 -- squashfs-tools 4.4 -> 4.5 -- strace 5.11 -> 5.14 -- stress-ng 0.12.05 -> 0.13.00 -- sudo 1.9.6p1 -> 1.9.7p2 -- swig 3.0.12 -> 4.0.2 -- sysklogd 2.2.2 -> 2.2.3 -- systemd 247.6 -> 249.3 -- systemd-boot 247.6 -> 249.3 -- systemd-conf 247.6 -> 1.0 -- systemtap 4.4 -> 4.5 -- systemtap-native 4.4 -> 4.5 -- systemtap-uprobes 4.4 -> 4.5 -- tcf-agent 1.7.0+gitX (a022ef2f1acf...) -> 1.7.0+gitX (2735e3d6b7ec...) -- texinfo 6.7 -> 6.8 -- tiff 4.2.0 -> 4.3.0 -- u-boot 2021.01 -> 2021.07 -- u-boot-tools 2021.01 -> 2021.07 -- usbutils 013 -> 014 -- util-linux 2.36.2 -> 2.37.2 -- util-linux-libuuid 2.36.2 -> 2.37.2 -- vala 0.50.4 -> 0.52.5 -- valgrind 3.16.1 -> 3.17.0 -- virglrenderer 0.8.2 -> 0.9.1 -- vte 0.62.2 -> 0.64.2 -- vulkan-headers 1.2.170.0 -> 1.2.182.0 -- vulkan-loader 1.2.170.0 -> 1.2.182.0 -- vulkan-samples git (55cebd9e7cc4...) -> git (d2187278cb66...) -- vulkan-tools 1.2.170.0 -> 1.2.182.0 -- wayland-protocols 1.20 -> 1.21 -- webkitgtk 2.30.5 -> 2.32.3 -- wireless-regdb 2021.04.21 -> 2021.07.14 -- wpebackend-fdo 1.8.0 -> 1.10.0 -- x264 r3039+gitX (544c61f08219...) -> r3039+gitX (5db6aa6cab1b...) -- xeyes 1.1.2 -> 1.2.0 -- xf86-input-libinput 0.30.0 -> 1.1.0 -- xkbcomp 1.4.4 -> 1.4.5 -- xkeyboard-config 2.32 -> 2.33 -- xorgproto 2020.1 -> 2021.4.99.2 -- xserver-xorg 1.20.10 -> 1.20.13 -- zstd 1.4.9 -> 1.5.0 - -Contributors to 3.4 -~~~~~~~~~~~~~~~~~~~ - -Thanks to the following people who contributed to this release: - -- Adam Romanek -- Alejandro Hernandez Samaniego -- Alexander Kanavin -- Alexandre Belloni -- Alexey Brodkin -- Alex Stewart -- Alistair Francis -- Anatol Belski -- Anders Wallin -- Andrea Adami -- Andreas Müller -- Andrej Valek -- Andres Beltran -- Andrey Zhizhikin -- Anibal Limon -- Anthony Bagwell -- Anton Blanchard -- Anuj Mittal -- Armin Kuster -- Asfak Rahman -- Bastian Krause -- Bernhard Rosenkränzer -- Bruce Ashfield -- Carlos Rafael Giani -- Chandana kalluri -- Changhyeok Bae -- Changqing Li -- Chanho Park -- Chen Qi -- Chris Laplante -- Christophe Chapuis -- Christoph Muellner -- Claudius Heine -- Damian Wrobel -- Daniel Ammann -- Daniel Gomez -- Daniel McGregor -- Daniel Wagenknecht -- Denys Dmytriyenko -- Devendra Tewari -- Diego Sueiro -- Dmitry Baryshkov -- Douglas Royds -- Dragos-Marian Panait -- Drew Moseley -- Enrico Scholz -- Fabio Berton -- Florian Amstutz -- Gavin Li -- Guillaume Champagne -- Harald Brinkmann -- Henning Schild -- He Zhe -- Hongxu Jia -- Hsia-Jun (Randy) Li -- Jean Bouchard -- Joe Slater -- Jonas Höppner -- Jon Mason -- Jose Quaresma -- Joshua Watt -- Justin Bronder -- Kai Kang -- Kenfe-Mickael Laventure -- Kevin Hao -- Khairul Rohaizzat Jamaluddin -- Khem Raj -- Kiran Surendran -- Konrad Weihmann -- Kristian Klausen -- Kyle Russell -- Lee Chee Yang -- Lei Maohui -- Luca Boccassi -- Marco Felsch -- Marcus Comstedt -- Marek Vasut -- Mark Hatle -- Markus Volk -- Marta Rybczynska -- Martin Jansa -- Matthias Klein -- Matthias Schiffer -- Matt Madison -- Matt Spencer -- Max Krummenacher -- Michael Halstead -- Michael Ho -- Michael Opdenacker -- Mike Crowe -- Mikko Rapeli -- Ming Liu -- Mingli Yu -- Minjae Kim -- Nicolas Dechesne -- Niels Avonds -- Nikolay Papenkov -- Nisha Parrakat -- Olaf Mandel -- Oleksandr Kravchuk -- Oleksandr Popovych -- Oliver Kranz -- Otavio Salvador -- Patrick Williams -- Paul Barker -- Paul Eggleton -- Paul Gortmaker -- Paulo Cesar Zaneti -- Peter Bergin -- Peter Budny -- Peter Kjellerstedt -- Petr Vorel -- Przemyslaw Gorszkowski -- Purushottam Choudhary -- Qiang Zhang -- Quentin Schulz -- Ralph Siemsen -- Randy MacLeod -- Ranjitsinh Rathod -- Rasmus Villemoes -- Reto Schneider -- Richard Purdie -- Richard Weinberger -- Robert Joslyn -- Robert P. J. Day -- Robert Yang -- Romain Naour -- Ross Burton -- Sakib Sajal -- Samuli Piippo -- Saul Wold -- Scott Murray -- Scott Weaver -- Stefan Ghinea -- Stefan Herbrechtsmeier -- Stefano Babic -- Stefan Wiehler -- Steve Sakoman -- Teoh Jay Shen -- Thomas Perrot -- Tim Orling -- Tom Pollard -- Tom Rini -- Tony Battersby -- Tony Tascioglu -- Trevor Gamblin -- Trevor Woerner -- Ulrich Ölmann -- Valentin Danaila -- Vinay Kumar -- Vineela Tummalapalli -- VinÃcius Ossanes Aquino -- Vivien Didelot -- Vyacheslav Yurkov -- Wang Mingyu -- Wes Lindauer -- William A. Kennington III -- Yanfei Xu -- Yann Dirson -- Yi Fan Yu -- Yi Zhao -- Zang Ruochen -- Zheng Ruoqin -- Zoltan Boszormenyi - -Repositories / Downloads for 3.4 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -poky - -- Repository Location: https://git.yoctoproject.org/poky/ -- Branch: :yocto_git:`honister </poky/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4 </poky/tag/?h=yocto-3.4>` -- Git Revision: :yocto_git:`f6d1126fff213460dc6954a5d5fc168606d76b66 </poky/commit/?id=f6d1126fff213460dc6954a5d5fc168606d76b66>` -- Release Artefact: poky-f6d1126fff213460dc6954a5d5fc168606d76b66 -- sha: 11e8f5760f704eed1ac37a5b09b1a831b5254d66459be75b06a72128c63e0411 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/poky-f6d1126fff213460dc6954a5d5fc168606d76b66.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/poky-f6d1126fff213460dc6954a5d5fc168606d76b66.tar.bz2 - -openembedded-core - -- Repository Location: :oe_git:`/openembedded-core` -- Branch: :oe_git:`honister </openembedded-core/log/?h=honister>` -- Tag: :oe_git:`2021-10-honister </openembedded-core/tag/?h=2021-10-honister>` -- Git Revision: :oe_git:`bb1dea6806f084364b6017db2567f438e805aef0 </openembedded-core/commit/?id=bb1dea6806f084364b6017db2567f438e805aef0>` -- Release Artefact: oecore-bb1dea6806f084364b6017db2567f438e805aef0 -- sha: 9a356c407c567b1c26e535cad235204b0462cb79321fefb0844324a6020b31f4 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/oecore-bb1dea6806f084364b6017db2567f438e805aef0.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/oecore-bb1dea6806f084364b6017db2567f438e805aef0.tar.bz2 - -meta-mingw - -- Repository Location: https://git.yoctoproject.org/meta-mingw -- Branch: :yocto_git:`honister </meta-mingw/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4 </meta-mingw/tag/?h=yocto-3.4>` -- Git Revision: :yocto_git:`f5d761cbd5c957e4405c5d40b0c236d263c916a8 </meta-mingw/commit/?id=f5d761cbd5c957e4405c5d40b0c236d263c916a8>` -- Release Artefact: meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8 -- sha: d4305d638ef80948584526c8ca386a8cf77933dffb8a3b8da98d26a5c40fcc11 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2 - -meta-intel - -- Repository Location: https://git.yoctoproject.org/meta-intel -- Branch: :yocto_git:`honister </meta-intel/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4 </meta-intel/tag/?h=yocto-3.4>` -- Git Revision: :yocto_git:`90170cf85fe35b4e8dc00eee50053c0205276b63 </meta-intel/commit/?id=90170cf85fe35b4e8dc00eee50053c0205276b63>` -- Release Artefact: meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63 -- sha: 2b3b43386dfcaaa880d819c1ae88b1251b55fb12c622af3d0936c3dc338491fc -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63.tar.bz2 - -meta-gplv2 - -- Repository Location: https://git.yoctoproject.org/meta-gplv2 -- Branch: :yocto_git:`honister </meta-gplv2/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4 </meta-gplv2/tag/?h=yocto-3.4>` -- Git Revision: :yocto_git:`f04e4369bf9dd3385165281b9fa2ed1043b0e400 </meta-gplv2/commit/?id=f04e4369bf9dd3385165281b9fa2ed1043b0e400>` -- Release Artefact: meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400 -- sha: ef8e2b1ec1fb43dbee4ff6990ac736315c7bc2d8c8e79249e1d337558657d3fe -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2 - -bitbake - -- Repository Location: :oe_git:`/bitbake` -- Branch: :oe_git:`1.52 </bitbake/log/?h=1.52>` -- Tag: :oe_git:`2021-10-honister </bitbake/tag/?h=2021-10-honister>` -- Git Revision: :oe_git:`c78ebac71ec976fdf27ea24767057882870f5c60 </bitbake/commit/?id=c78ebac71ec976fdf27ea24767057882870f5c60>` -- Release Artefact: bitbake-c78ebac71ec976fdf27ea24767057882870f5c60 -- sha: 8077c7e7528cd73ef488ef74de3943ec66cae361459e5b630fb3cbe89c498d3d -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/bitbake-c78ebac71ec976fdf27ea24767057882870f5c60.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/bitbake-c78ebac71ec976fdf27ea24767057882870f5c60.tar.bz2 - -yocto-docs - -- Repository Location: https://git.yoctoproject.org/yocto-docs -- Branch: :yocto_git:`honister </yocto-docs/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4 </yocto-docs/tag/?h=yocto-3.4>` -- Git Revision: :yocto_git:`d75c5450ecf56c8ac799a633ee9ac459e88f91fc </yocto-docs/commit/?id=d75c5450ecf56c8ac799a633ee9ac459e88f91fc>` - -Release notes for 3.4.1 (honister) ----------------------------------- - -Known Issues in 3.4.1 -~~~~~~~~~~~~~~~~~~~~~ - -- :yocto_bugs:`bsps-hw.bsps-hw.Test_Seek_bar_and_volume_control manual test case failure </show_bug.cgi?id=14622>` - -Security Fixes in 3.4.1 -~~~~~~~~~~~~~~~~~~~~~~~ - -- glibc: Backport fix for :cve:`2021-43396` -- vim: add patch number to :cve:`2021-3778` patch -- vim: fix :cve:`2021-3796`, :cve:`2021-3872`, and :cve:`2021-3875` -- squashfs-tools: follow-up fix for :cve:`2021-41072` -- avahi: update CVE id fixed by local-ping.patch -- squashfs-tools: fix :cve:`2021-41072` -- ffmpeg: fix :cve:`2021-38114` -- curl: fix :cve:`2021-22945`, :cve:`2021-22946` and :cve:`2021-22947` - -Fixes in 3.4.1 -~~~~~~~~~~~~~~ - -- bitbake.conf: Fix corruption of GNOME mirror url -- bitbake.conf: Use wayland distro feature for native builds -- bitbake: Revert "parse/ast: Show errors for append/prepend/remove operators combined with +=/.=" -- bitbake: bitbake-worker: Add debug when unpickle fails -- bitbake: cooker: Fix task-depends.dot for multiconfig targets -- bitbake: cooker: Handle parse threads disappearing to avoid hangs -- bitbake: cooker: Handle parsing results queue race -- bitbake: cooker: Remove debug code, oops :( -- bitbake: cooker: check if upstream hash equivalence server is available -- bitbake: fetch/git: Handle github dropping git:// support -- bitbake: fetch/wget: Add timeout for checkstatus calls (30s) -- bitbake: fetch2/perforce: Fix typo -- bitbake: fetch2: Fix url remap issue and add testcase -- bitbake: fetch2: fix downloadfilename issue with premirror -- bitbake: fetch: Handle mirror user/password replacements correctly -- bitbake: parse/ast: Show errors for append/prepend/remove operators combined with +=/.= -- bitbake: runqueue: Fix runall option handling -- bitbake: runqueue: Fix runall option task deletion ordering issue -- bitbake: test/fetch: Update urls to match upstream branch name changes -- bitbake: tests/fetch.py: add test case to ensure downloadfilename is used for premirror -- bitbake: tests/fetch.py: fix premirror test cases -- bitbake: tests/fetch: Update github urls -- bitbake: tests/fetch: Update pcre.org address after github changes -- bitbake: tests/runqueue: Ensure hashserv exits before deleting files -- bitbake: utils: Handle lockfile filenames that are too long for filesystems -- bootchart2: Don't compile python modules -- build-appliance-image: Update to honister head revision -- buildhistory: Fix package output files for SDKs -- busybox: 1.34.0 -> 1.34.1 -- ca-certificates: update 20210119 -> 20211016 -- classes/populate_sdk_base: Add setscene tasks -- conf: update for release 3.4 -- convert-srcuri.py: use regex to check space in SRC_URI -- create-spdx: Fix key errors in do_create_runtime_spdx -- create-spdx: Protect against None from LICENSE_PATH -- create-spdx: Set the Organization field via a variable -- create-spdx: add create_annotation function -- create-spdx: cross recipes are native also -- create_spdx: ensure is_work_shared() is unique -- cups: Fix missing installation of cups sysv init scripts -- docs: poky.yaml: updates for 3.4 -- dpkg: Install dkpg-perl scripts to versioned perl directory -- glibc-version.inc: remove branch= from GLIBC_GIT_URI -- go-helloworld/glide: Fix urls -- go.bbclass: Allow adding parameters to go ldflags -- go: upgrade 1.16.7 -> 1.16.8 -- gst-devtools: 1.18.4 -> 1.18.5 -- gst-examples: 1.18.4 -> 1.18.5 -- gstreamer1.0-libav: 1.18.4 -> 1.18.5 -- gstreamer1.0-omx: 1.18.4 -> 1.18.5 -- gstreamer1.0-plugins-bad: 1.18.4 -> 1.18.5 -- gstreamer1.0-plugins-base: 1.18.4 -> 1.18.5 -- gstreamer1.0-plugins-good: 1.18.4 -> 1.18.5 -- gstreamer1.0-plugins-ugly: 1.18.4 -> 1.18.5 -- gstreamer1.0-python: 1.18.4 -> 1.18.5 -- gstreamer1.0-rtsp-server: 1.18.4 -> 1.18.5 -- gstreamer1.0-vaapi: 1.18.4 -> 1.18.5 -- gstreamer1.0: 1.18.4 -> 1.18.5 -- insane.bbclass: Add a check for directories that are expected to be empty -- kernel-devsrc: Add vdso.lds and other build files for riscv64 as well -- libnewt: Use python3targetconfig to fix reproducibility issue -- libpcre/libpcre2: correct SRC_URI -- libx11-compose-data: Update LICENSE to better reflect reality -- libx11: Update LICENSE to better reflect reality -- libxml2: Use python3targetconfig to fix reproducibility issue -- linunistring: Add missing gperf-native dependency -- linux-firmware: upgrade to 20211027 -- linux-yocto-dev: Ensure DEPENDS matches recent 5.14 kernel changes -- linux-yocto-rt/5.10: update to -rt54 -- linux-yocto/5.10: update to v5.10.78 -- linux-yocto/5.14: common-pc: enable CONFIG_ATA_PIIX as built-in -- linux-yocto/5.14: update to v5.14.17 -- linux-yocto: add libmpc-native to DEPENDS -- lttng-tools: replace ad hoc ptest fixup with upstream fixes -- manuals: releases.rst: move gatesgarth to outdated releases section -- mesa: Enable svga for x86 only -- mesa: upgrade 21.2.1 -> 21.2.4 -- meson.bblcass: Remove empty egg-info directories before running meson -- meson: install native file in sdk -- meson: move lang args to the right section -- meson: set objcopy in the cross and native toolchain files -- meta/scripts: Manual git url branch additions -- meta: Add explict branch to git SRC_URIs -- migration-3.4: add additional migration info -- migration-3.4: add some extra packaging notes -- migration-3.4: tweak overrides change section -- migration: tweak introduction section -- mirrors: Add kernel.org sources mirror for downloads.yoctoproject.org -- mirrors: Add uninative mirror on kernel.org -- nativesdk-packagegroup-sdk-host.bb: Update host tools for wayland -- oeqa/runtime/parselogs: modified drm error in common errors list -- oeqa/selftest/sstatetests: fix typo ware -> were -- oeqa: Update cleanup code to wait for hashserv exit -- opkg: Fix poor operator combination choice -- ovmf: update 202105 -> 202108 -- patch.bbclass: when the patch fails show more info on the fatal error -- poky.conf: bump version for 3.4.1 honister release -- poky.yaml: add lz4 and zstd to essential host packages -- poky.yaml: fix lz4 package name for older Ubuntu versions -- pseudo: Add fcntl64 wrapper -- python3-setuptools: _distutils/sysconfig fix -- python3: update to 3.9.7 -- qemu.inc: Remove empty egg-info directories before running meson -- recipes: Update github.com urls to use https -- ref-manual: Update how to set a useradd password -- ref-manual: document "reproducible_build" class and SOURCE_DATE_EPOCH -- ref-manual: document BUILD_REPRODUCIBLE_BINARIES -- ref-manual: document TOOLCHAIN_HOST_TASK_ESDK -- ref-manual: remove meta class -- ref-manual: update system requirements -- releases.rst: fix release number for 3.3.3 -- scripts/convert-srcuri: Update SRC_URI conversion script to handle github url changes -- scripts/lib/wic/help.py: Update Fedora Kickstart URLs -- scripts/oe-package-browser: Fix after overrides change -- scripts/oe-package-browser: Handle no packages being built -- spdx.py: Add annotation to relationship -- sstate: Account for reserved characters when shortening sstate filenames -- sstate: another fix for touching files inside pseudo -- sstate: fix touching files inside pseudo -- staging: Fix autoconf-native rebuild failure -- strace: fix build against 5.15 kernel/kernel-headers -- strace: show test suite log on failure -- stress-ng: convert to git, website is down -- systemd: add missing include for musl -- tar: filter CVEs using vendor name -- test-manual: how to enable reproducible builds -- testimage: fix unclosed testdata file -- tzdata: update 2021d to 2021d -- uninative: Add version to uninative tarball name -- waffle: convert to git, website is down -- wayland: Fix wayland-tools packaging -- wireless-regdb: upgrade 2021.07.14 -> 2021.08.28 -- wpa-supplicant: Match package override to PACKAGES for pkg_postinst - -Contributors to 3.4.1 -~~~~~~~~~~~~~~~~~~~~~ - -- Ahmed Hossam -- Alexander Kanavin -- Alexandre Belloni -- Andrej Valek -- Andres Beltran -- Anuj Mittal -- Bruce Ashfield -- Chen Qi -- Claus Stovgaard -- Daiane Angolini -- Hsia-Jun(Randy) Li -- Jon Mason -- Jose Quaresma -- Joshua Watt -- Kai Kang -- Khem Raj -- Kiran Surendran -- Manuel Leonhardt -- Michael Opdenacker -- Oleksandr Kravchuk -- Pablo Saavedra -- Paul Eggleton -- Peter Kjellerstedt -- Quentin Schulz -- Ralph Siemsen -- Randy Li -- Richard Purdie -- Ross Burton -- Sakib Sajal -- Saul Wold -- Teoh Jay Shen -- Tim Orling -- Tom Hochstein -- Yureka - -Repositories / Downloads for 3.4.1 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -poky - -- Repository Location: https://git.yoctoproject.org/poky/ -- Branch: :yocto_git:`honister </poky/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4.1 </poky/tag/?h=yocto-3.4.1>` -- Git Revision: :yocto_git:`b53230c08d9f02ecaf35b4f0b70512abbf10ae11 </poky/commit/?id=b53230c08d9f02ecaf35b4f0b70512abbf10ae11>` -- Release Artefact: poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11 -- sha: 57d49e2afafb555baf65643acf752464f0eb7842b964713a5de7530c392de159 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11.tar.bz2 - -meta-mingw - -- Repository Location: https://git.yoctoproject.org/meta-mingw -- Branch: :yocto_git:`honister </meta-mingw/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4.1 </meta-mingw/tag/?h=yocto-3.4.1>` -- Git Revision: :yocto_git:`f5d761cbd5c957e4405c5d40b0c236d263c916a8 </meta-mingw/commit/?id=f5d761cbd5c957e4405c5d40b0c236d263c916a8>` -- Release Artefact: meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8 -- sha: d4305d638ef80948584526c8ca386a8cf77933dffb8a3b8da98d26a5c40fcc11 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2 - -meta-gplv2 - -- Repository Location: https://git.yoctoproject.org/meta-gplv2 -- Branch: :yocto_git:`honister </meta-gplv2/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4.1 </meta-gplv2/tag/?h=yocto-3.4.1>` -- Git Revision: :yocto_git:`f04e4369bf9dd3385165281b9fa2ed1043b0e400 </meta-gplv2/commit/?id=f04e4369bf9dd3385165281b9fa2ed1043b0e400>` -- Release Artefact: meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400 -- sha: ef8e2b1ec1fb43dbee4ff6990ac736315c7bc2d8c8e79249e1d337558657d3fe -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2 - -bitbake - -- Repository Location: :oe_git:`/bitbake` -- Branch: :oe_git:`1.52 </bitbake/log/?h=1.52>` -- Tag: :oe_git:`yocto-3.4.1 </bitbake/tag/?h=yocto-3.4.1>` -- Git Revision: :oe_git:`44a83b373e1fc34c93cd4a6c6cf8b73b230c1520 </bitbake/commit/?id=44a83b373e1fc34c93cd4a6c6cf8b73b230c1520>` -- Release Artefact: bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520 -- sha: 03d50c1318d88d62eb01d359412ea5a8014ef506266629a2bd43ab3a2ef19430 -- Download Locations: - http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520.tar.bz2, - http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520.tar.bz2 - -yocto-docs - -- Repository Location: https://git.yoctoproject.org/yocto-docs -- Branch: :yocto_git:`honister </yocto-docs/log/?h=honister>` -- Tag: :yocto_git:`yocto-3.4.1 </yocto-docs/tag/?h=yocto-3.4.1>` -- Git Revision: :yocto_git:`b250eda5a0beba8acc9641c55a5b0e30594b5178 </yocto-docs/commit/?b250eda5a0beba8acc9641c55a5b0e30594b5178>` +.. include:: release-notes-3.4.rst +.. include:: release-notes-3.4.1.rst +.. include:: release-notes-3.4.2.rst diff --git a/poky/documentation/migration-guides/migration-3.5.rst b/poky/documentation/migration-guides/migration-3.5.rst index 8c2a7d2c65..8ce2306e42 100644 --- a/poky/documentation/migration-guides/migration-3.5.rst +++ b/poky/documentation/migration-guides/migration-3.5.rst @@ -7,6 +7,16 @@ Project 3.5 Release (codename "kirkstone") from the prior release. Recipe changes -------------- +- To use more `inclusive language <https://inclusivenaming.org/>`__ + in the code and documentation, some variables have been renamed or even + deleted. BitBake will stop with an error when renamed or removed variables + still exist in your recipes or configuration. + + A :oe_git:`convert-variable-renames.py + </openembedded-core/tree/scripts/contrib/convert-variable-renames.py>` + script is provided to convert your recipes and configuration, + and also warns you about the use of problematic words. + - Because of the uncertainty in future default branch names in git repositories, it is now required to add a branch name to all URLs described by ``git://`` and ``gitsm://`` :term:`SRC_URI` entries. For example:: @@ -54,3 +64,15 @@ Recipe changes - :ref:`allarch <ref-classes-allarch>` packagegroups can no longer depend on packages which use :term:`PKG` renaming such as :ref:`ref-classes-debian`. +Class changes +------------- + +- The `distutils*.bbclasses` have been moved to `meta-python`. The classes and + `DISTUTILS*` variables have been removed from the documentation. + +- ``blacklist.bbclass`` is removed and the functionality moved to the + :ref:`base <ref-classes-base>` class with a more descriptive + ``varflag`` named :term:`SKIP_RECIPE` which will use the `SkipRecipe()` + function. The usage will remain the same:: + + SKIP_RECIPE[my-recipe] = "Reason for skipping recipe" diff --git a/poky/documentation/migration-guides/release-notes-3.4.1.rst b/poky/documentation/migration-guides/release-notes-3.4.1.rst new file mode 100644 index 0000000000..b122887661 --- /dev/null +++ b/poky/documentation/migration-guides/release-notes-3.4.1.rst @@ -0,0 +1,252 @@ +Release notes for 3.4.1 (honister) +---------------------------------- + +Known Issues in 3.4.1 +~~~~~~~~~~~~~~~~~~~~~ + +- :yocto_bugs:`bsps-hw.bsps-hw.Test_Seek_bar_and_volume_control manual test case failure </show_bug.cgi?id=14622>` + +Security Fixes in 3.4.1 +~~~~~~~~~~~~~~~~~~~~~~~ + +- glibc: Backport fix for :cve:`2021-43396` +- vim: add patch number to :cve:`2021-3778` patch +- vim: fix :cve:`2021-3796`, :cve:`2021-3872`, and :cve:`2021-3875` +- squashfs-tools: follow-up fix for :cve:`2021-41072` +- avahi: update CVE id fixed by local-ping.patch +- squashfs-tools: fix :cve:`2021-41072` +- ffmpeg: fix :cve:`2021-38114` +- curl: fix :cve:`2021-22945`, :cve:`2021-22946` and :cve:`2021-22947` + +Fixes in 3.4.1 +~~~~~~~~~~~~~~ + +- bitbake.conf: Fix corruption of GNOME mirror url +- bitbake.conf: Use wayland distro feature for native builds +- bitbake: Revert "parse/ast: Show errors for append/prepend/remove operators combined with +=/.=" +- bitbake: bitbake-worker: Add debug when unpickle fails +- bitbake: cooker: Fix task-depends.dot for multiconfig targets +- bitbake: cooker: Handle parse threads disappearing to avoid hangs +- bitbake: cooker: Handle parsing results queue race +- bitbake: cooker: Remove debug code, oops :( +- bitbake: cooker: check if upstream hash equivalence server is available +- bitbake: fetch/git: Handle github dropping git:// support +- bitbake: fetch/wget: Add timeout for checkstatus calls (30s) +- bitbake: fetch2/perforce: Fix typo +- bitbake: fetch2: Fix url remap issue and add testcase +- bitbake: fetch2: fix downloadfilename issue with premirror +- bitbake: fetch: Handle mirror user/password replacements correctly +- bitbake: parse/ast: Show errors for append/prepend/remove operators combined with +=/.= +- bitbake: runqueue: Fix runall option handling +- bitbake: runqueue: Fix runall option task deletion ordering issue +- bitbake: test/fetch: Update urls to match upstream branch name changes +- bitbake: tests/fetch.py: add test case to ensure downloadfilename is used for premirror +- bitbake: tests/fetch.py: fix premirror test cases +- bitbake: tests/fetch: Update github urls +- bitbake: tests/fetch: Update pcre.org address after github changes +- bitbake: tests/runqueue: Ensure hashserv exits before deleting files +- bitbake: utils: Handle lockfile filenames that are too long for filesystems +- bootchart2: Don't compile python modules +- build-appliance-image: Update to honister head revision +- buildhistory: Fix package output files for SDKs +- busybox: 1.34.0 -> 1.34.1 +- ca-certificates: update 20210119 -> 20211016 +- classes/populate_sdk_base: Add setscene tasks +- conf: update for release 3.4 +- convert-srcuri.py: use regex to check space in SRC_URI +- create-spdx: Fix key errors in do_create_runtime_spdx +- create-spdx: Protect against None from LICENSE_PATH +- create-spdx: Set the Organization field via a variable +- create-spdx: add create_annotation function +- create-spdx: cross recipes are native also +- create_spdx: ensure is_work_shared() is unique +- cups: Fix missing installation of cups sysv init scripts +- docs: poky.yaml: updates for 3.4 +- dpkg: Install dkpg-perl scripts to versioned perl directory +- glibc-version.inc: remove branch= from GLIBC_GIT_URI +- go-helloworld/glide: Fix urls +- go.bbclass: Allow adding parameters to go ldflags +- go: upgrade 1.16.7 -> 1.16.8 +- gst-devtools: 1.18.4 -> 1.18.5 +- gst-examples: 1.18.4 -> 1.18.5 +- gstreamer1.0-libav: 1.18.4 -> 1.18.5 +- gstreamer1.0-omx: 1.18.4 -> 1.18.5 +- gstreamer1.0-plugins-bad: 1.18.4 -> 1.18.5 +- gstreamer1.0-plugins-base: 1.18.4 -> 1.18.5 +- gstreamer1.0-plugins-good: 1.18.4 -> 1.18.5 +- gstreamer1.0-plugins-ugly: 1.18.4 -> 1.18.5 +- gstreamer1.0-python: 1.18.4 -> 1.18.5 +- gstreamer1.0-rtsp-server: 1.18.4 -> 1.18.5 +- gstreamer1.0-vaapi: 1.18.4 -> 1.18.5 +- gstreamer1.0: 1.18.4 -> 1.18.5 +- insane.bbclass: Add a check for directories that are expected to be empty +- kernel-devsrc: Add vdso.lds and other build files for riscv64 as well +- libnewt: Use python3targetconfig to fix reproducibility issue +- libpcre/libpcre2: correct SRC_URI +- libx11-compose-data: Update LICENSE to better reflect reality +- libx11: Update LICENSE to better reflect reality +- libxml2: Use python3targetconfig to fix reproducibility issue +- linunistring: Add missing gperf-native dependency +- linux-firmware: upgrade to 20211027 +- linux-yocto-dev: Ensure DEPENDS matches recent 5.14 kernel changes +- linux-yocto-rt/5.10: update to -rt54 +- linux-yocto/5.10: update to v5.10.78 +- linux-yocto/5.14: common-pc: enable CONFIG_ATA_PIIX as built-in +- linux-yocto/5.14: update to v5.14.17 +- linux-yocto: add libmpc-native to DEPENDS +- lttng-tools: replace ad hoc ptest fixup with upstream fixes +- manuals: releases.rst: move gatesgarth to outdated releases section +- mesa: Enable svga for x86 only +- mesa: upgrade 21.2.1 -> 21.2.4 +- meson.bblcass: Remove empty egg-info directories before running meson +- meson: install native file in sdk +- meson: move lang args to the right section +- meson: set objcopy in the cross and native toolchain files +- meta/scripts: Manual git url branch additions +- meta: Add explict branch to git SRC_URIs +- migration-3.4: add additional migration info +- migration-3.4: add some extra packaging notes +- migration-3.4: tweak overrides change section +- migration: tweak introduction section +- mirrors: Add kernel.org sources mirror for downloads.yoctoproject.org +- mirrors: Add uninative mirror on kernel.org +- nativesdk-packagegroup-sdk-host.bb: Update host tools for wayland +- oeqa/runtime/parselogs: modified drm error in common errors list +- oeqa/selftest/sstatetests: fix typo ware -> were +- oeqa: Update cleanup code to wait for hashserv exit +- opkg: Fix poor operator combination choice +- ovmf: update 202105 -> 202108 +- patch.bbclass: when the patch fails show more info on the fatal error +- poky.conf: bump version for 3.4.1 honister release +- poky.yaml: add lz4 and zstd to essential host packages +- poky.yaml: fix lz4 package name for older Ubuntu versions +- pseudo: Add fcntl64 wrapper +- python3-setuptools: _distutils/sysconfig fix +- python3: update to 3.9.7 +- qemu.inc: Remove empty egg-info directories before running meson +- recipes: Update github.com urls to use https +- ref-manual: Update how to set a useradd password +- ref-manual: document "reproducible_build" class and SOURCE_DATE_EPOCH +- ref-manual: document BUILD_REPRODUCIBLE_BINARIES +- ref-manual: document TOOLCHAIN_HOST_TASK_ESDK +- ref-manual: remove meta class +- ref-manual: update system requirements +- releases.rst: fix release number for 3.3.3 +- scripts/convert-srcuri: Update SRC_URI conversion script to handle github url changes +- scripts/lib/wic/help.py: Update Fedora Kickstart URLs +- scripts/oe-package-browser: Fix after overrides change +- scripts/oe-package-browser: Handle no packages being built +- spdx.py: Add annotation to relationship +- sstate: Account for reserved characters when shortening sstate filenames +- sstate: another fix for touching files inside pseudo +- sstate: fix touching files inside pseudo +- staging: Fix autoconf-native rebuild failure +- strace: fix build against 5.15 kernel/kernel-headers +- strace: show test suite log on failure +- stress-ng: convert to git, website is down +- systemd: add missing include for musl +- tar: filter CVEs using vendor name +- test-manual: how to enable reproducible builds +- testimage: fix unclosed testdata file +- tzdata: update 2021d to 2021d +- uninative: Add version to uninative tarball name +- waffle: convert to git, website is down +- wayland: Fix wayland-tools packaging +- wireless-regdb: upgrade 2021.07.14 -> 2021.08.28 +- wpa-supplicant: Match package override to PACKAGES for pkg_postinst + +Contributors to 3.4.1 +~~~~~~~~~~~~~~~~~~~~~ + +- Ahmed Hossam +- Alexander Kanavin +- Alexandre Belloni +- Andrej Valek +- Andres Beltran +- Anuj Mittal +- Bruce Ashfield +- Chen Qi +- Claus Stovgaard +- Daiane Angolini +- Hsia-Jun(Randy) Li +- Jon Mason +- Jose Quaresma +- Joshua Watt +- Kai Kang +- Khem Raj +- Kiran Surendran +- Manuel Leonhardt +- Michael Opdenacker +- Oleksandr Kravchuk +- Pablo Saavedra +- Paul Eggleton +- Peter Kjellerstedt +- Quentin Schulz +- Ralph Siemsen +- Randy Li +- Richard Purdie +- Ross Burton +- Sakib Sajal +- Saul Wold +- Teoh Jay Shen +- Tim Orling +- Tom Hochstein +- Yureka + +Repositories / Downloads for 3.4.1 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +poky + +- Repository Location: https://git.yoctoproject.org/poky/ +- Branch: :yocto_git:`honister </poky/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.1 </poky/tag/?h=yocto-3.4.1>` +- Git Revision: :yocto_git:`b53230c08d9f02ecaf35b4f0b70512abbf10ae11 </poky/commit/?id=b53230c08d9f02ecaf35b4f0b70512abbf10ae11>` +- Release Artefact: poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11 +- sha: 57d49e2afafb555baf65643acf752464f0eb7842b964713a5de7530c392de159 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/poky-b53230c08d9f02ecaf35b4f0b70512abbf10ae11.tar.bz2 + +meta-mingw + +- Repository Location: https://git.yoctoproject.org/meta-mingw +- Branch: :yocto_git:`honister </meta-mingw/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.1 </meta-mingw/tag/?h=yocto-3.4.1>` +- Git Revision: :yocto_git:`f5d761cbd5c957e4405c5d40b0c236d263c916a8 </meta-mingw/commit/?id=f5d761cbd5c957e4405c5d40b0c236d263c916a8>` +- Release Artefact: meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8 +- sha: d4305d638ef80948584526c8ca386a8cf77933dffb8a3b8da98d26a5c40fcc11 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2 + +meta-gplv2 + +- Repository Location: https://git.yoctoproject.org/meta-gplv2 +- Branch: :yocto_git:`honister </meta-gplv2/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.1 </meta-gplv2/tag/?h=yocto-3.4.1>` +- Git Revision: :yocto_git:`f04e4369bf9dd3385165281b9fa2ed1043b0e400 </meta-gplv2/commit/?id=f04e4369bf9dd3385165281b9fa2ed1043b0e400>` +- Release Artefact: meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400 +- sha: ef8e2b1ec1fb43dbee4ff6990ac736315c7bc2d8c8e79249e1d337558657d3fe +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2 + +bitbake + +- Repository Location: :oe_git:`/bitbake` +- Branch: :oe_git:`1.52 </bitbake/log/?h=1.52>` +- Tag: :oe_git:`yocto-3.4.1 </bitbake/tag/?h=yocto-3.4.1>` +- Git Revision: :oe_git:`44a83b373e1fc34c93cd4a6c6cf8b73b230c1520 </bitbake/commit/?id=44a83b373e1fc34c93cd4a6c6cf8b73b230c1520>` +- Release Artefact: bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520 +- sha: 03d50c1318d88d62eb01d359412ea5a8014ef506266629a2bd43ab3a2ef19430 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.1/bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.1/bitbake-44a83b373e1fc34c93cd4a6c6cf8b73b230c1520.tar.bz2 + +yocto-docs + +- Repository Location: https://git.yoctoproject.org/yocto-docs +- Branch: :yocto_git:`honister </yocto-docs/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.1 </yocto-docs/tag/?h=yocto-3.4.1>` +- Git Revision: :yocto_git:`b250eda5a0beba8acc9641c55a5b0e30594b5178 </yocto-docs/commit/?b250eda5a0beba8acc9641c55a5b0e30594b5178>` diff --git a/poky/documentation/migration-guides/release-notes-3.4.2.rst b/poky/documentation/migration-guides/release-notes-3.4.2.rst new file mode 100644 index 0000000000..23c409397e --- /dev/null +++ b/poky/documentation/migration-guides/release-notes-3.4.2.rst @@ -0,0 +1,240 @@ +Release notes for 3.4.2 (honister) +---------------------------------- + +Security Fixes in 3.4.2 +~~~~~~~~~~~~~~~~~~~~~~~ + +- tiff: backport fix for :cve:`2022-22844` +- glibc : Fix :cve:`2021-3999` +- glibc : Fix :cve:`2021-3998` +- glibc : Fix :cve:`2022-23219` +- glibc : Fix :cve:`2022-23218` +- lighttpd: backport a fix for :cve:`2022-22707` +- speex: fix :cve:`2020-23903` +- linux-yocto/5.10: amdgpu: updates for :cve:`2021-42327` +- libsndfile1: fix :cve:`2021-4156` +- xserver-xorg: whitelist two CVEs +- grub2: fix :cve:`2021-3981` +- xserver-xorg: update CVE_PRODUCT +- binutils: :cve:`2021-42574` +- gcc: Fix :cve:`2021-42574` +- gcc: Fix :cve:`2021-35465` +- cve-extra-exclusions: add db CVEs to exclusion list +- gcc: Add :cve:`2021-37322` to the list of CVEs to ignore +- bind: fix :cve:`2021-25219` +- openssh: fix :cve:`2021-41617` +- ncurses: fix :cve:`2021-39537` +- vim: fix :cve:`2021-3968` and :cve:`2021-3973` +- vim: fix :cve:`2021-3927` and :cve:`2021-3928` +- gmp: fix :cve:`2021-43618` + +Fixes in 3.4.2 +~~~~~~~~~~~~~~ + +- build-appliance-image: Update to honister head revision +- poky.conf: bump version for 3.4.2 release +- libxml2: Backport python3-lxml workaround patch +- core-image-sato-sdk: allocate more memory when in qemu +- vim: upgrade to patch 4269 +- vim: update to include latest CVE fixes +- expat: upgrade to 2.4.4 +- libusb1: correct SRC_URI +- yocto-check-layer: add debug output for the layers that were found +- linux-firmware: Add CLM blob to linux-firmware-bcm4373 package +- linux-yocto/5.10: update to v5.10.93 +- icu: fix make_icudata dependencies +- sstate: Improve failure to obtain archive message/handling +- insane.bbclass: Correct package_qa_check_empty_dirs() +- sstate: A third fix for for touching files inside pseudo +- kernel: introduce python3-dtschema-wrapper +- vim: upgrade to 8.2 patch 3752 +- bootchart2: Add missing python3-math dependency +- socat: update SRC_URI +- pigz: fix one failure of command "unpigz -l" +- linux-yocto/5.14: update genericx86* machines to v5.14.21 +- linux-yocto/5.10: update genericx86* machines to v5.10.87 +- go: upgrade 1.16.10 -> 1.16.13 +- linux-yocto/5.10/cfg: add kcov feature fragment +- linux-yocto/5.14: fix arm 32bit -rt warnings +- oeqa/sstate: Fix allarch samesigs test +- rootfs-postcommands.bbclass: Make two comments use the new variable syntax +- cve-check: add lockfile to task +- lib/oe/reproducible: correctly set .git location when recursively looking for git repos +- epiphany: Update 40.3 -> 40.6 +- scripts/buildhistory-diff: drop use of distutils +- scripts: Update to use exec_module() instead of load_module() +- vulkan-loader: inherit pkgconfig +- webkitgtk: Add reproducibility fix +- openssl: Add reproducibility fix +- rpm: remove tmp folder created during install +- package_manager: ipk: Fix host manifest generation +- bitbake: utils: Update to use exec_module() instead of load_module() +- linux-yocto: add libmpc-native to DEPENDS +- ref-manual: fix patch documentation +- bitbake: tests/fetch: Drop gnu urls from wget connectivity test +- bitbake: fetch: npm: Use temporary file for empty user config +- bitbake: fetch: npm: Quote destdir in run chmod command +- bitbake: process: Do not mix stderr with stdout +- xserver-xorg: upgrade 1.20.13 -> 1.20.14 +- python3-pyelftools: Depend on debugger, pprint +- linux-firmware: upgrade 20211027 -> 20211216 +- oeqa/selftest/bbtests: Use YP sources mirror instead of GNU +- systemd: Fix systemd-journal-gateway user/groups +- license.bbclass: implement ast.NodeVisitor.visit_Constant +- oe/license: implement ast.NodeVisitor.visit_Constant +- packagedata.py: silence a DeprecationWarning +- uboot-sign: fix the concatenation when multiple U-BOOT configurations are specified +- runqemu: check the qemu PID has been set before kill()ing it +- selftest/devtool: Check branch in git fetch +- recipetool: Set master branch only as fallback +- kern-tools: bug fixes and kgit-gconfig +- linux-yocto-rt/5.10: update to -rt56 +- linux-yocto/5.14: update to v5.14.21 +- python3: upgrade 3.9.7 -> 3.9.9 +- bitbake: lib/pyinotify.py: Remove deprecated module asyncore +- updates for recent releases +- libdrm: upgrade 2.4.108 -> 2.4.109 +- patch.py: Initialize git repo before patching +- boost: Fix build on arches with no atomics +- boost: allow searching for python310 +- recipetool: extend curl detection when creating recipes +- recipetool: handle GitLab URLs like we do GitHub +- README.OE-Core.md: update URLs +- libtool: change the default AR_FLAGS from "cru" to "cr" +- libtool: Update patchset to match those submitted upstream +- scripts/checklayer/common.py: Fixed a minor grammatical error +- oeqa/parselogs: Fix quoting +- oeqa/utils/dump: Fix typo +- systemd: update 249.6 -> 249.7 +- glibc: Fix i586/c3 support +- wic: support rootdev identified by partition label +- buildhistory: Fix srcrevs output +- classes/crate-fetch: Ensure crate fetcher is available +- rootfs-postcommands: update systemd_create_users +- classes/meson: Add optional rust definitions +- rust-cross: Replace TARGET_ARCH with TUNE_PKGARCH +- maintainers.inc: fix up rust-cross entry +- rust-cross: Fix directory not deleted for race glibc vs. musl +- wic: use shutil.which +- bitbake: data_smart.py: Skip old override syntax checking for anonymous functions +- documentation: conf.py: fix version of bitbake objects.inv +- updates for release 3.3.4 + +Contributors to 3.4.2 +~~~~~~~~~~~~~~~~~~~~~ + +- Alexander Kanavin +- Alexandre Belloni +- Anton Mikanovich +- Anuj Mittal +- Bruce Ashfield +- Carlos Rafael Giani +- Chaitanya Vadrevu +- Changqing Li +- Dhruva Gole +- Florian Amstutz +- Joshua Watt +- Kai Kang +- Khairul Rohaizzat Jamaluddin +- Khem Raj +- Konrad Weihmann +- Kory Maincent +- Li Wang +- Marek Vasut +- Markus Volk +- Martin Jansa +- Max Krummenacher +- Michael Opdenacker +- Mingli Yu +- Oleksiy Obitotskyy +- Pavel Zhukov +- Peter Kjellerstedt +- Pgowda +- Quentin Schulz +- Richard Purdie +- Robert Yang +- Ross Burton +- Rudolf J Streif +- Sakib Sajal +- Samuli Piippo +- Schmidt, Adriaan +- Stefan Herbrechtsmeier +- Steve Sakoman +- Sundeep KOKKONDA +- Teoh Jay Shen +- Thomas Perrot +- Tim Orling +- Vyacheslav Yurkov +- Yongxin Liu +- pgowda +- wangmy + +Repositories / Downloads for 3.4.2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +poky + +- Repository Location: https://git.yoctoproject.org/poky/ +- Branch: :yocto_git:`honister </poky/log/?h=honister>` +- Tag: `yocto-3.4.2 <https://git.yoctoproject.org/poky/tag/?h=yocto-3.4.2>`__ +- Git Revision: :yocto_git:`e0ab08bb6a32916b457d221021e7f402ffa36b1a </poky/commit/?id=e0ab08bb6a32916b457d221021e7f402ffa36b1a>` +- Release Artefact: poky-e0ab08bb6a32916b457d221021e7f402ffa36b1a +- sha: 8580dc5067ee426fe347a0d0f7a74c29ba539120bbe8438332339a9c8bce00fd +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.2/poky-e0ab08bb6a32916b457d221021e7f402ffa36b1a.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.2/poky-e0ab08bb6a32916b457d221021e7f402ffa36b1a.tar.bz2 + +openembedded-core + +- Repository Location: :oe_git:`/openembedded-core` +- Branch: :oe_git:`honister </openembedded-core/log/?h=honister>` +- Tag: :oe_git:`yocto-3.4.2 </openembedded-core/tag/?h=yocto-3.4.2>` +- Git Revision: :oe_git:`418a9c4c31615a9e3e011fc2b21fb7154bc6c93a </openembedded-core/commit/?id=418a9c4c31615a9e3e011fc2b21fb7154bc6c93a>` +- Release Artefact: oecore-418a9c4c31615a9e3e011fc2b21fb7154bc6c93a +- sha: f2ca94a5a7ec669d4c208d1729930dfc1b917846dbb2393d01d6d5856fcbc6de +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.2/oecore-418a9c4c31615a9e3e011fc2b21fb7154bc6c93a.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.2/oecore-418a9c4c31615a9e3e011fc2b21fb7154bc6c93a.tar.bz2 + +meta-mingw + +- Repository Location: https://git.yoctoproject.org/meta-mingw +- Branch: :yocto_git:`honister </meta-mingw/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.2 </meta-mingw/tag/?h=yocto-3.4.2>` +- Git Revision: :yocto_git:`f5d761cbd5c957e4405c5d40b0c236d263c916a8 </meta-mingw/commit/?id=f5d761cbd5c957e4405c5d40b0c236d263c916a8>` +- Release Artefact: meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8 +- sha: d4305d638ef80948584526c8ca386a8cf77933dffb8a3b8da98d26a5c40fcc11 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.2/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.2/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2 + +meta-gplv2 + +- Repository Location: https://git.yoctoproject.org/meta-gplv2 +- Branch: :yocto_git:`honister </meta-gplv2/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.2 </meta-gplv2/tag/?h=yocto-3.4.2>` +- Git Revision: :yocto_git:`f04e4369bf9dd3385165281b9fa2ed1043b0e400 </meta-gplv2/commit/?id=f04e4369bf9dd3385165281b9fa2ed1043b0e400>` +- Release Artefact: meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400 +- sha: ef8e2b1ec1fb43dbee4ff6990ac736315c7bc2d8c8e79249e1d337558657d3fe +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.2/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.2/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2 + +bitbake + +- Repository Location: :oe_git:`/bitbake` +- Branch: :oe_git:`1.52 </bitbake/log/?h=1.52>` +- Tag: :oe_git:`yocto-3.4.2 </bitbake/tag/?h=yocto-3.4.2>` +- Git Revision: :oe_git:`c039182c79e2ccc54fff5d7f4f266340014ca6e0 </bitbake/commit/?id=c039182c79e2ccc54fff5d7f4f266340014ca6e0>` +- Release Artefact: bitbake-c039182c79e2ccc54fff5d7f4f266340014ca6e0 +- sha: bd80297f8d8aa40cbcc8a3d4e23a5223454b305350adf34cd29b5fb65c1b4c52 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4.2/bitbake-c039182c79e2ccc54fff5d7f4f266340014ca6e0.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4.2/bitbake-c039182c79e2ccc54fff5d7f4f266340014ca6e0.tar.bz2 + +yocto-docs + +- Repository Location: https://git.yoctoproject.org/yocto-docs +- Branch: :yocto_git:`honister </yocto-docs/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4.2 </yocto-docs/tag/?h=yocto-3.4.2>` +- Git Revision: :yocto_git:`3061d3d62054a5c3b9e16bfce4bcd186fa7a23d2` </yocto-docs/commit/?3061d3d62054a5c3b9e16bfce4bcd186fa7a23d2>` diff --git a/poky/documentation/migration-guides/release-notes-3.4.rst b/poky/documentation/migration-guides/release-notes-3.4.rst new file mode 100644 index 0000000000..927de6dc0c --- /dev/null +++ b/poky/documentation/migration-guides/release-notes-3.4.rst @@ -0,0 +1,800 @@ +Release notes for 3.4 (honister) +-------------------------------- + +New Features / Enhancements in 3.4 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Linux kernel 5.14, glibc 2.34 and ~280 other recipe upgrades +- Switched override character to ':' (replacing '_') for more robust parsing and improved performance - see the above migration guide for help +- Rust integrated into core, providing rust support for cross-compilation and SDK +- New create-spdx class for creating SPDX SBoM documents +- New recipes: cargo, core-image-ptest-all, core-image-ptest-fast, core-image-weston-sdk, erofs-utils, gcompat, gi-docgen, libmicrohttpd, libseccomp, libstd-rs, perlcross, python3-markdown, python3-pyyaml, python3-smartypants, python3-typogrify, rust, rust-cross, rust-cross-canadian, rust-hello-world, rust-llvm, rust-tools-cross-canadian, rustfmt, xwayland +- Several optimisations to reduce unnecessary task dependencies for faster builds +- seccomp integrated into core, with additional enabling for gnutls, systemd, qemu +- New overlayfs class to help generate overlayfs mount units +- debuginfod support now enabled by default +- Switched several recipes over to using OpenSSL instead of GnuTLS (wpa-supplicant, curl, glib-networking) or disable GnuTLS (cups) by default +- Improvements to LTO plugin installation and reproducibility +- Architecture-specific enhancements: + + - glibc: Enable memory tagging for aarch64 + - testimage: remove aarch64 xorg exclusion + - arch-arm*: add better support for gcc march extensions + - tune-cortexm*: add support for all Arm Cortex-M processors + - tune-cortexr*: add support for all Arm Cortex-R processors + - arch-armv4: Allow -march=armv4 + - qemuarm*: use virtio graphics + - baremetal-helloworld: Enable RISC-V 64/32 port + - ldconfig-native: Add RISC-V support + - qemuriscv: Enable 4 core emulation + - Add ARC support in gdb, dpkg, dhcpcd + - conf/machine-sdk: Add ppc64 SDK machine + - libjpeg-turbo: Handle powerpc64le without Altivec + - pixman: Handle PowerPC without Altivec + - mesa: enable gallium Intel drivers when building for x86 + - mesa: enable crocus driver for older Intel graphics + +- Kernel-related enhancements: + + - Support zstd-compressed modules and initramfs images + - Allow opt-out of split kernel modules + - linux-yocto-dev: base AUTOREV on specified version + - kernel-yocto: provide debug / summary information for metadata + - kernel-uboot: Handle gzip and lzo compression options + - linux-yocto/5.14: added devupstream support + - linux-yocto: add vfat to :term:`KERNEL_FEATURES` when :term:`MACHINE_FEATURES` include vfat + - linux-yocto: enable TYPEC_TCPCI in usbc fragment + +- Image-related enhancements: + + - New erofs, erofs-lz4 and erofs-lz4hc image types + - New squashfs-zst and cpio.zst image types + - New lic-pkgs :term:`IMAGE_FEATURES` item to install all license packages + - Added zsync metadata conversion support + - Use xargs to set file timestamps for significant (>90%) do_image speedup + - Find .ko.gz and .ko.xz kernel modules as well when determining need to run depmod on an image + - Show formatted error messages instead of tracebacks for systemctl errors + - No longer ignore installation failures in complementary package installation + - Remove ldconfig auxiliary cache when not needed + +- wic enhancements: + + - Added erofs filesystem support + - Added --extra-space argument to leave extra space after last partition + - Added --no-fstab-update part option to allow using the stock fstab + - bootimg-efi: added Unified Kernel Image option + - bootimg-pcbios: use label provided when formatting a DOS partition + +- SDK-related enhancements: + + - Enable do_populate_sdk with multilibs + - New ``SDKPATHINSTALL`` variable decouples default install path from built in path to avoid rebuilding nativesdk components on e.g. :term:`DISTRO_VERSION` changes + - eSDK: Error if trying to generate an eSDK from a multiconfig + - eSDK: introduce :term:`TOOLCHAIN_HOST_TASK_ESDK` to be used in place of :term:`TOOLCHAIN_HOST_TASK` to add components to the host part of the eSDK + +- BitBake enhancements: + + - New bitbake-getvar helper command to query a variable value (with history) + - bitbake-layers: layerindex-fetch: add --fetchdir parameter + - bitbake-layers: show-recipes: add skip reason to output + - bitbake-diffsigs: sort diff output for consistency + - Allow setting upstream for local hash equivalence server + - fetch2/s3: allow to use credentials and switch profile from environment variables + - fetch2/s3: Add progress handler for S3 cp command + - fetch2/npm: Support npm archives with missing search directory mode + - fetch2/npmsw: Add support for local tarball and link sources + - fetch2/svn: Allow peg-revision functionality to be disabled + - fetch2/wget: verify certificates for HTTPS/FTPS by default + - fetch2/wget: Enable FTPS + - prserv: added read-only mode + - prserv: replaced XML RPC with modern asyncrpc implementation + - Numerous warning/error message improvements + +- New :term:`PACKAGECONFIG` options in btrfs-tools, ccache, coreutils, cups, dbus, elfutils, ffmpeg, findutils, glib-2.0, gstreamer1.0-plugins-bad, gstreamer1.0-plugins-base, libarchive, libnotify, libpsl, man-db, mesa, ovmf, parted, prelink, qemu, rpm, shadow, systemd, tar, vim, weston +- u-boot enhancements: + + - Make SPL suffix configurable + - Make ``UBOOT_BINARYNAME`` configurable + - Package ``extlinux.conf`` separately + - Allow deploying the u-boot DTB + +- opensbi: Add support for specifying a device tree +- busybox enhancements: + + - Added tmpdir option into mktemp applet + - Support mounting swap via labels + - Enable long options for enabled applets + +- Move tune files to architecture subdirectories +- buildstats: log host data on failure separately to task specific file +- buildstats: collect "at interval" and "on failure" logs in the same file +- Ptest enhancements: + + - ptest-runner: install script to collect system data on failure + - Added ptest support to python3-hypothesis, python3-jinja2, python3-markupsafe + - Enhanced ptest support in lttng, util-linux, and others + - New leaner ptest image recipes based upon core-image-minimal + +- scripts/contrib/image-manifest: add new script +- Add beginnings of Android target support +- devtool upgrade: rebase override-only patches as well +- devtool: print a warning on upgrades if :term:`PREFERRED_VERSION` is set +- systemd: set zstd as default compression option +- init-manager-systemd: add a weak VIRTUAL-RUNTIME_dev_manager assignment +- Add proper unpack dependency for .zst compressed archives +- util-linux: build chfn and chsh by default +- qemu: use 4 cores in qemu guests +- runqemu: decouple bios and kernel options +- qemu: add a hint on how to enable CPU render nodes when a suitable GPU is absent +- devupstream: Allow support of native class extensions +- Prelinking now disabled in default configuration +- python3: statistics module moved to its own python3-statistics package +- pypi: allow override of PyPI archive name +- Allow global override of golang GO_DYNLINK +- buildhistory enhancements: + + - Add option to strip path prefix + - Add output file listing package information + - Label packages providing per-file dependencies in depends.dot + +- New gi-docgen class for GNOME library documentation +- meson.bbclass: Make the default buildtype "debug" if :term:`DEBUG_BUILD` is 1 +- distro_features_check: expand with :term:`IMAGE_FEATURES` +- Add extended packagedata in JSON format +- local.conf.sample: Update sstate mirror entry with new hash equivalence setting +- poky: Use https in default :term:`PREMIRRORS` +- reproducible_build.bbclass: Enable -Wdate-time +- yocto-check-layer: ensure that all layer dependencies are tested too +- core-image-multilib-example: base on weston, and not sato +- npm.bbclass: Allow nodedir to be overridden by ``NPM_NODEDIR`` +- cve-extra-exclusions.inc: add exclusion list for intractable CVE's +- license_image.bbclass: Detect broken symlinks +- sysstat: make the service start automatically +- sanity: Add error check for '%' in build path +- sanity: Further improve directory sanity tests +- sanity.bbclass: mention ``CONNECTIVITY_CHECK_URIS`` in network failure message +- tzdata: Allow controlling zoneinfo binary format +- oe-time-dd-test.sh: add options and refactor +- vim: add option to disable NLS support +- zstd: Include pzstd in the build +- mirrors.bbclass: provide additional rule for git repo fallbacks +- own-mirrors: Add support for s3:// scheme in :term:`SOURCE_MIRROR_URL` +- common-licenses: add missing SPDX licences +- Add MAINTAINERS.md file to record subsystem maintainers + +Known Issues in 3.4 +~~~~~~~~~~~~~~~~~~~ + +- Build failures have been reported when running on host Linux systems with FIPS enabled (such as RHEL 8.0 with the FIPS mode enabled). For more details please see :yocto_bugs:`bug #14609 </show_bug.cgi?id=14609>`. + +Recipe Licenses changes in 3.4 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following corrections have been made to the LICENSE values set by recipes: + +- acpica: correct LICENSE to "Intel | BSD-3-Clause | GPLv2" +- dtc: correct LICENSE to "GPLv2 | BSD-2-Clause" +- e2fsprogs: correct LICENSE to "GPLv2 & LGPLv2 & BSD-3-Clause & MIT" +- ffmpeg: correct LICENSE to "GPLv2+ & LGPLv2.1+ & ISC & MIT & BSD-2-Clause & BSD-3-Clause & IJG" +- flac: correct LICENSE to "GFDL-1.2 & GPLv2+ & LGPLv2.1+ & BSD-3-Clause" +- flex: correct LICENSE to "BSD-3-Clause & LGPL-2.0+" +- font-util: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" +- glib-2.0: correct LICENSE to "LGPLv2.1+ & BSD-3-Clause & PD" +- gobject-introspection: correct LICENSE to "LGPLv2+ & GPLv2+ & MIT" (add MIT license) +- hdparm: correct LICENSE to "BSD-2-Clause & GPLv2 & hdparm" +- iputils: correct LICENSE to "BSD-3-Clause & GPLv2+" +- libcap: correct LICENSE to "BSD-3-Clause | GPLv2" +- libevent: correct LICENSE to "BSD-3-Clause & MIT" +- libjitterentropy: correct LICENSE to "GPLv2+ | BSD-3-Clause" +- libpam: correct LICENSE to "GPLv2+ | BSD-3-Clause" +- libwpe: correct LICENSE to "BSD-2-Clause" +- libx11-compose-data: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" +- libx11: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" +- libxfont2: correct LICENSE to "MIT & MIT-style & BSD-4-Clause & BSD-2-Clause" +- libxfont: correct LICENSE to "MIT & MIT-style & BSD-3-Clause" +- lsof: correct LICENSE to reflect that it uses a BSD-like (but not exactly BSD) license ("Spencer-94") +- nfs-utils: correct LICENSE to "MIT & GPLv2+ & BSD-3-Clause" +- ovmf: correct license to "BSD-2-Clause-Patent" +- ppp: correct LICENSE to "BSD-3-Clause & BSD-3-Clause-Attribution & GPLv2+ & LGPLv2+ & PD" +- python3-packaging: correct LICENSE to "Apache-2.0 | BSD-2-Clause" +- python-async-test: correct LICENSE to "BSD-3-Clause" +- quota: remove BSD license (only BSD licensed part of the code was removed in 4.05) +- shadow: correct LICENSE to "BSD-3-Clause | Artistic-1.0" +- shadow-sysroot: set LICENSE the same as shadow +- sudo: correct LICENSE to "ISC & BSD-3-Clause & BSD-2-Clause & Zlib" +- swig: correct LICENSE to "BSD-3-Clause & GPLv3" +- valgrind: correct license to "GPLv2 & GPLv2+ & BSD-3-Clause" +- webkitgtk: correct LICENSE to "BSD-2-Clause & LGPLv2+" +- wpebackend-fdo: correct LICENSE to "BSD-2-Clause" +- xinetd: correct LICENSE to reflect that it uses a unique BSD-like (but not exactly BSD) license + +Other license-related notes: + +- When creating recipes for Python software, recipetool will now treat "BSD" as "BSD-3-Clause" for the purposes of setting LICENSE, as that is the most common understanding. +- Please be aware that an initramfs bundled with the kernel using :term:`INITRAMFS_IMAGE_BUNDLE` should only contain GPLv2-compatible software; this is now mentioned in the documentation. + +Security Fixes in 3.4 +~~~~~~~~~~~~~~~~~~~~~ + +- apr: :cve:`2021-35940` +- aspell: :cve:`2019-25051` +- avahi: :cve:`2021-3468`, :cve:`2021-36217` +- binutils: :cve:`2021-20197` +- bluez: :cve:`2021-3658` +- busybox: :cve:`2021-28831` +- cairo: :cve:`2020-35492` +- cpio: :cve:`2021-38185` +- expat: :cve:`2013-0340` +- ffmpeg: :cve:`2020-20446`, :cve:`2020-22015`, :cve:`2020-22021`, :cve:`2020-22033`, :cve:`2020-22019`, :cve:`2021-33815`, :cve:`2021-38171`, :cve:`2020-20453` +- glibc: :cve:`2021-33574`, :cve:`2021-38604` +- inetutils: :cve:`2021-40491` +- libgcrypt: :cve:`2021-40528` +- linux-yocto/5.10, 5.14: :cve:`2021-3653`, :cve:`2021-3656` +- lz4: :cve:`2021-3520` +- nettle: :cve:`2021-20305` +- openssl: :cve:`2021-3711`, :cve:`2021-3712` +- perl: :cve:`2021-36770` +- python3: :cve:`2021-29921` +- python3-pip: :cve:`2021-3572` +- qemu: :cve:`2020-27821`, :cve:`2020-29443`, :cve:`2020-35517`, :cve:`2021-3392`, :cve:`2021-3409`, :cve:`2021-3416`, :cve:`2021-3527`, :cve:`2021-3544`, :cve:`2021-3545`, :cve:`2021-3546`, :cve:`2021-3682`, :cve:`2021-20181`, :cve:`2021-20221`, :cve:`2021-20257`, :cve:`2021-20263` +- rpm: :cve:`2021-3421`, :cve:`2021-20271` +- rsync: :cve:`2020-14387` +- util-linux: :cve:`2021-37600` +- vim: :cve:`2021-3770`, :cve:`2021-3778` +- wpa-supplicant: :cve:`2021-30004` +- xdg-utils: :cve:`2020-27748` +- xserver-xorg: :cve:`2021-3472` + +Recipe Upgrades in 3.4 +~~~~~~~~~~~~~~~~~~~~~~ + +- acl 2.2.53 -> 2.3.1 +- acpica 20210105 -> 20210730 +- alsa-lib 1.2.4 -> 1.2.5.1 +- alsa-plugins 1.2.2 -> 1.2.5 +- alsa-tools 1.2.2 -> 1.2.5 +- alsa-topology-conf 1.2.4 -> 1.2.5.1 +- alsa-ucm-conf 1.2.4 -> 1.2.5.1 +- alsa-utils 1.2.4 -> 1.2.5.1 +- alsa-utils-scripts 1.2.4 -> 1.2.5.1 +- apt 2.2.2 -> 2.2.4 +- at 3.2.1 -> 3.2.2 +- at-spi2-core 2.38.0 -> 2.40.3 +- autoconf-archive 2019.01.06 -> 2021.02.19 +- babeltrace2 2.0.3 -> 2.0.4 +- bash 5.1 -> 5.1.8 +- bind 9.16.16 -> 9.16.20 +- binutils 2.36.1 -> 2.37 +- binutils-cross 2.36.1 -> 2.37 +- binutils-cross-canadian 2.36.1 -> 2.37 +- binutils-cross-testsuite 2.36.1 -> 2.37 +- binutils-crosssdk 2.36.1 -> 2.37 +- bison 3.7.5 -> 3.7.6 +- blktrace 1.2.0+gitX -> 1.3.0+gitX +- bluez5 5.56 -> 5.61 +- boost 1.75.0 -> 1.77.0 +- boost-build-native 4.3.0 -> 4.4.1 +- btrfs-tools 5.10.1 -> 5.13.1 +- busybox 1.33.1 -> 1.34.0 +- busybox-inittab 1.33.0 -> 1.34.0 +- ccache 4.2 -> 4.4 +- cmake 3.19.5 -> 3.21.1 +- cmake-native 3.19.5 -> 3.21.1 +- connman 1.39 -> 1.40 +- createrepo-c 0.17.0 -> 0.17.4 +- cronie 1.5.5 -> 1.5.7 +- cross-localedef-native 2.33 -> 2.34 +- cups 2.3.3 -> 2.3.3op2 +- curl 7.75.0 -> 7.78.0 +- dbus-glib 0.110 -> 0.112 +- dejagnu 1.6.2 -> 1.6.3 +- diffoscope 172 -> 181 +- diffutils 3.7 -> 3.8 +- distcc 3.3.5 -> 3.4 +- dnf 4.6.0 -> 4.8.0 +- dpkg 1.20.7.1 -> 1.20.9 +- dtc 1.6.0 -> 1.6.1 +- e2fsprogs 1.46.1 -> 1.46.4 +- elfutils 0.183 -> 0.185 +- ell 0.38 -> 0.43 +- enchant2 2.2.15 -> 2.3.1 +- epiphany 3.38.2 -> 40.3 +- ethtool 5.10 -> 5.13 +- expat 2.2.10 -> 2.4.1 +- ffmpeg 4.3.2 -> 4.4 +- file 5.39 -> 5.40 +- freetype 2.10.4 -> 2.11.0 +- gcc 10.2.0 -> 11.2.0 +- gcc-cross 10.2.0 -> 11.2.0 +- gcc-cross-canadian 10.2.0 -> 11.2.0 +- gcc-crosssdk 10.2.0 -> 11.2.0 +- gcc-runtime 10.2.0 -> 11.2.0 +- gcc-sanitizers 10.2.0 -> 11.2.0 +- gcc-source 10.2.0 -> 11.2.0 +- gcr 3.38.1 -> 3.40.0 +- gdb 10.1 -> 10.2 +- gdb-cross 10.1 -> 10.2 +- gdb-cross-canadian 10.1 -> 10.2 +- gdk-pixbuf 2.40.0 -> 2.42.6 +- ghostscript 9.53.3 -> 9.54.0 +- git 2.31.1 -> 2.33.0 +- glib-2.0 2.66.7 -> 2.68.4 +- glib-networking 2.66.0 -> 2.68.2 +- glibc 2.33 -> 2.34 +- glibc-locale 2.33 -> 2.34 +- glibc-mtrace 2.33 -> 2.34 +- glibc-scripts 2.33 -> 2.34 +- glibc-testsuite 2.33 -> 2.34 +- glslang 11.2.0 -> 11.5.0 +- gnome-desktop-testing 2018.1 -> 2021.1 +- gnu-config 20210125+gitX -> 20210722+gitX +- gnu-efi 3.0.12 -> 3.0.14 +- gnupg 2.2.27 -> 2.3.1 +- gobject-introspection 1.66.1 -> 1.68.0 +- gpgme 1.15.1 -> 1.16.0 +- gptfdisk 1.0.7 -> 1.0.8 +- grep 3.6 -> 3.7 +- grub 2.04+2.06~rc1 -> 2.06 +- grub-efi 2.04+2.06~rc1 -> 2.06 +- gsettings-desktop-schemas 3.38.0 -> 40.0 +- gtk+3 3.24.25 -> 3.24.30 +- harfbuzz 2.7.4 -> 2.9.0 +- hdparm 9.60 -> 9.62 +- help2man 1.48.2 -> 1.48.4 +- hwlatdetect 1.10 -> 2.1 +- i2c-tools 4.2 -> 4.3 +- icu 68.2 -> 69.1 +- igt-gpu-tools 1.25+gitX -> 1.26 +- inetutils 2.0 -> 2.1 +- iproute2 5.11.0 -> 5.13.0 +- iputils s20200821 -> 20210722 +- json-glib 1.6.2 -> 1.6.4 +- kexec-tools 2.0.21 -> 2.0.22 +- kmod 28 -> 29 +- kmod-native 28 -> 29 +- less 563 -> 590 +- libassuan 2.5.4 -> 2.5.5 +- libcap 2.48 -> 2.51 +- libcgroup 0.41 -> 2.0 +- libcomps 0.1.15 -> 0.1.17 +- libconvert-asn1-perl 0.27 -> 0.31 +- libdazzle 3.38.0 -> 3.40.0 +- libdnf 0.58.0 -> 0.63.1 +- libdrm 2.4.104 -> 2.4.107 +- libedit 20210216-3.1 -> 20210714-3.1 +- libepoxy 1.5.5 -> 1.5.9 +- liberation-fonts 2.00.1 -> 2.1.4 +- libffi 3.3 -> 3.4.2 +- libfm 1.3.1 -> 1.3.2 +- libgcc 10.2.0 -> 11.2.0 +- libgcc-initial 10.2.0 -> 11.2.0 +- libgcrypt 1.9.3 -> 1.9.4 +- libgfortran 10.2.0 -> 11.2.0 +- libgit2 1.1.0 -> 1.1.1 +- libglu 9.0.1 -> 9.0.2 +- libgpg-error 1.41 -> 1.42 +- libgudev 234 -> 237 +- libhandy 1.2.0 -> 1.2.3 +- libical 3.0.9 -> 3.0.10 +- libidn2 2.3.0 -> 2.3.2 +- libinput 1.16.4 -> 1.18.1 +- libjitterentropy 3.0.1 -> 3.1.0 +- libjpeg-turbo 2.0.6 -> 2.1.1 +- libksba 1.5.0 -> 1.6.0 +- libmodulemd 2.12.0 -> 2.13.0 +- libnsl2 1.3.0 -> 2.0.0 +- libnss-mdns 0.14.1 -> 0.15.1 +- libogg 1.3.4 -> 1.3.5 +- libpcap 1.10.0 -> 1.10.1 +- libpcre 8.44 -> 8.45 +- libpcre2 10.36 -> 10.37 +- libportal 0.3 -> 0.4 +- librepo 1.13.0 -> 1.14.1 +- libsdl2 2.0.14 -> 2.0.16 +- libsolv 0.7.17 -> 0.7.19 +- libtasn1 4.16.0 -> 4.17.0 +- libtest-needs-perl 0.002006 -> 0.002009 +- libtirpc 1.3.1 -> 1.3.2 +- libubootenv 0.3.1 -> 0.3.2 +- libucontext 0.10+X -> 1.1+X +- liburcu 0.12.2 -> 0.13.0 +- libuv 1.41.0 -> 1.42.0 +- libva 2.10.0 -> 2.12.0 +- libva-initial 2.10.0 -> 2.12.0 +- libva-utils 2.10.0 -> 2.12.0 +- libwebp 1.2.0 -> 1.2.1 +- libwpe 1.8.0 -> 1.10.1 +- libx11 1.7.0 -> 1.7.2 +- libxcrypt 4.4.18 -> 4.4.25 +- libxcrypt-compat 4.4.18 -> 4.4.25 +- libxfixes 5.0.3 -> 6.0.0 +- libxfont2 2.0.4 -> 2.0.5 +- libxft 2.3.3 -> 2.3.4 +- libxi 1.7.10 -> 1.7.99.2 +- libxkbcommon 1.0.3 -> 1.3.0 +- libxml2 2.9.10 -> 2.9.12 +- libxres 1.2.0 -> 1.2.1 +- linux-libc-headers 5.10 -> 5.14 +- linux-yocto 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX +- linux-yocto-dev 5.12++gitX -> 5.15++gitX +- linux-yocto-rt 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX +- linux-yocto-tiny 5.4.144+gitX, 5.10.63+gitX -> 5.10.70+gitX, 5.14.9+gitX +- llvm 11.1.0 -> 12.0.1 +- log4cplus 2.0.6 -> 2.0.7 +- logrotate 3.18.0 -> 3.18.1 +- ltp 20210121 -> 20210524 +- lttng-modules 2.12.6 -> 2.13.0 +- lttng-tools 2.12.4 -> 2.13.0 +- lttng-ust 2.12.1 -> 2.13.0 +- m4 1.4.18 -> 1.4.19 +- m4-native 1.4.18 -> 1.4.19 +- man-pages 5.10 -> 5.12 +- mc 4.8.26 -> 4.8.27 +- mesa 21.0.3 -> 21.2.1 +- mesa-gl 21.0.3 -> 21.2.1 +- meson 0.57.1 -> 0.58.1 +- mmc-utils 0.1+gitX (73d6c59af8d1...) -> 0.1+gitX (43282e80e174...) +- mobile-broadband-provider-info 20201225 -> 20210805 +- mpg123 1.26.4 -> 1.28.2 +- mtd-utils 2.1.2 -> 2.1.3 +- mtools 4.0.26 -> 4.0.35 +- musl 1.2.2+gitX (e5d2823631bb...) -> 1.2.2+gitX (3f701faace7a...) +- nativesdk-meson 0.57.1 -> 0.58.1 +- netbase 6.2 -> 6.3 +- nfs-utils 2.5.3 -> 2.5.4 +- ofono 1.31 -> 1.32 +- openssh 8.5p1 -> 8.7p1 +- opkg 0.4.4 -> 0.4.5 +- opkg-utils 0.4.3 -> 0.4.5 +- ovmf edk2-stable202102 -> edk2-stable202105 +- p11-kit 0.23.22 -> 0.24.0 +- pango 1.48.2 -> 1.48.9 +- patchelf 0.12 -> 0.13 +- perl 5.32.1 -> 5.34.0 +- piglit 1.0+gitrX (d4d9353b7290...) -> 1.0+gitrX (6a4be9e9946d...) +- pkgconf 1.7.3 -> 1.8.0 +- powertop 2.13 -> 2.14 +- pseudo 1.9.0+gitX (b988b0a6b8af...) -> 1.9.0+gitX (0cda3ba5f94a...) +- pulseaudio 14.2 -> 15.0 +- puzzles 0.0+gitX (84cb4c6701e0...) -> 0.0+gitX (8f3413c31ffd...) +- python3 3.9.5 -> 3.9.6 +- python3-attrs 20.3.0 -> 21.2.0 +- python3-cython 0.29.22 -> 0.29.24 +- python3-dbus 1.2.16 -> 1.2.18 +- python3-dbusmock 0.22.0 -> 0.23.1 +- python3-docutils 0.16 -> 0.17.1 +- python3-git 3.1.14 -> 3.1.20 +- python3-gitdb 4.0.5 -> 4.0.7 +- python3-hypothesis 6.2.0 -> 6.15.0 +- python3-importlib-metadata 3.4.0 -> 4.6.4 +- python3-iniparse 0.4 -> 0.5 +- python3-jinja2 2.11.3 -> 3.0.1 +- python3-libarchive-c 2.9 -> 3.1 +- python3-magic 0.4.22 -> 0.4.24 +- python3-mako 1.1.4 -> 1.1.5 +- python3-markupsafe 1.1.1 -> 2.0.1 +- python3-more-itertools 8.7.0 -> 8.8.0 +- python3-numpy 1.20.1 -> 1.21.2 +- python3-packaging 20.9 -> 21.0 +- python3-pathlib2 2.3.5 -> 2.3.6 +- python3-pbr 5.4.4 -> 5.6.0 +- python3-pip 20.0.2 -> 21.2.4 +- python3-pluggy 0.13.1 -> 1.0.0 +- python3-pycairo 1.20.0 -> 1.20.1 +- python3-pygments 2.8.1 -> 2.10.0 +- python3-pygobject 3.38.0 -> 3.40.1 +- python3-pytest 6.2.2 -> 6.2.4 +- python3-scons 3.1.2 -> 4.2.0 +- python3-scons-native 3.1.2 -> 4.2.0 +- python3-setuptools 54.1.1 -> 57.4.0 +- python3-setuptools-scm 5.0.1 -> 6.0.1 +- python3-six 1.15.0 -> 1.16.0 +- python3-sortedcontainers 2.3.0 -> 2.4.0 +- python3-testtools 2.4.0 -> 2.5.0 +- python3-zipp 3.4.1 -> 3.5.0 +- qemu 5.2.0 -> 6.0.0 +- qemu-native 5.2.0 -> 6.0.0 +- qemu-system-native 5.2.0 -> 6.0.0 +- re2c 2.0.3 -> 2.2 +- rng-tools 6.11 -> 6.14 +- rpcbind 1.2.5 -> 1.2.6 +- rt-tests 1.10 -> 2.1 +- ruby 3.0.1 -> 3.0.2 +- rxvt-unicode 9.22 -> 9.26 +- shaderc 2020.5 -> 2021.1 +- shadow 4.8.1 -> 4.9 +- spirv-tools 2020.7 -> 2021.2 +- sqlite3 3.35.0 -> 3.36.0 +- squashfs-tools 4.4 -> 4.5 +- strace 5.11 -> 5.14 +- stress-ng 0.12.05 -> 0.13.00 +- sudo 1.9.6p1 -> 1.9.7p2 +- swig 3.0.12 -> 4.0.2 +- sysklogd 2.2.2 -> 2.2.3 +- systemd 247.6 -> 249.3 +- systemd-boot 247.6 -> 249.3 +- systemd-conf 247.6 -> 1.0 +- systemtap 4.4 -> 4.5 +- systemtap-native 4.4 -> 4.5 +- systemtap-uprobes 4.4 -> 4.5 +- tcf-agent 1.7.0+gitX (a022ef2f1acf...) -> 1.7.0+gitX (2735e3d6b7ec...) +- texinfo 6.7 -> 6.8 +- tiff 4.2.0 -> 4.3.0 +- u-boot 2021.01 -> 2021.07 +- u-boot-tools 2021.01 -> 2021.07 +- usbutils 013 -> 014 +- util-linux 2.36.2 -> 2.37.2 +- util-linux-libuuid 2.36.2 -> 2.37.2 +- vala 0.50.4 -> 0.52.5 +- valgrind 3.16.1 -> 3.17.0 +- virglrenderer 0.8.2 -> 0.9.1 +- vte 0.62.2 -> 0.64.2 +- vulkan-headers 1.2.170.0 -> 1.2.182.0 +- vulkan-loader 1.2.170.0 -> 1.2.182.0 +- vulkan-samples git (55cebd9e7cc4...) -> git (d2187278cb66...) +- vulkan-tools 1.2.170.0 -> 1.2.182.0 +- wayland-protocols 1.20 -> 1.21 +- webkitgtk 2.30.5 -> 2.32.3 +- wireless-regdb 2021.04.21 -> 2021.07.14 +- wpebackend-fdo 1.8.0 -> 1.10.0 +- x264 r3039+gitX (544c61f08219...) -> r3039+gitX (5db6aa6cab1b...) +- xeyes 1.1.2 -> 1.2.0 +- xf86-input-libinput 0.30.0 -> 1.1.0 +- xkbcomp 1.4.4 -> 1.4.5 +- xkeyboard-config 2.32 -> 2.33 +- xorgproto 2020.1 -> 2021.4.99.2 +- xserver-xorg 1.20.10 -> 1.20.13 +- zstd 1.4.9 -> 1.5.0 + +Contributors to 3.4 +~~~~~~~~~~~~~~~~~~~ + +Thanks to the following people who contributed to this release: + +- Adam Romanek +- Alejandro Hernandez Samaniego +- Alexander Kanavin +- Alexandre Belloni +- Alexey Brodkin +- Alex Stewart +- Alistair Francis +- Anatol Belski +- Anders Wallin +- Andrea Adami +- Andreas Müller +- Andrej Valek +- Andres Beltran +- Andrey Zhizhikin +- Anibal Limon +- Anthony Bagwell +- Anton Blanchard +- Anuj Mittal +- Armin Kuster +- Asfak Rahman +- Bastian Krause +- Bernhard Rosenkränzer +- Bruce Ashfield +- Carlos Rafael Giani +- Chandana kalluri +- Changhyeok Bae +- Changqing Li +- Chanho Park +- Chen Qi +- Chris Laplante +- Christophe Chapuis +- Christoph Muellner +- Claudius Heine +- Damian Wrobel +- Daniel Ammann +- Daniel Gomez +- Daniel McGregor +- Daniel Wagenknecht +- Denys Dmytriyenko +- Devendra Tewari +- Diego Sueiro +- Dmitry Baryshkov +- Douglas Royds +- Dragos-Marian Panait +- Drew Moseley +- Enrico Scholz +- Fabio Berton +- Florian Amstutz +- Gavin Li +- Guillaume Champagne +- Harald Brinkmann +- Henning Schild +- He Zhe +- Hongxu Jia +- Hsia-Jun (Randy) Li +- Jean Bouchard +- Joe Slater +- Jonas Höppner +- Jon Mason +- Jose Quaresma +- Joshua Watt +- Justin Bronder +- Kai Kang +- Kenfe-Mickael Laventure +- Kevin Hao +- Khairul Rohaizzat Jamaluddin +- Khem Raj +- Kiran Surendran +- Konrad Weihmann +- Kristian Klausen +- Kyle Russell +- Lee Chee Yang +- Lei Maohui +- Luca Boccassi +- Marco Felsch +- Marcus Comstedt +- Marek Vasut +- Mark Hatle +- Markus Volk +- Marta Rybczynska +- Martin Jansa +- Matthias Klein +- Matthias Schiffer +- Matt Madison +- Matt Spencer +- Max Krummenacher +- Michael Halstead +- Michael Ho +- Michael Opdenacker +- Mike Crowe +- Mikko Rapeli +- Ming Liu +- Mingli Yu +- Minjae Kim +- Nicolas Dechesne +- Niels Avonds +- Nikolay Papenkov +- Nisha Parrakat +- Olaf Mandel +- Oleksandr Kravchuk +- Oleksandr Popovych +- Oliver Kranz +- Otavio Salvador +- Patrick Williams +- Paul Barker +- Paul Eggleton +- Paul Gortmaker +- Paulo Cesar Zaneti +- Peter Bergin +- Peter Budny +- Peter Kjellerstedt +- Petr Vorel +- Przemyslaw Gorszkowski +- Purushottam Choudhary +- Qiang Zhang +- Quentin Schulz +- Ralph Siemsen +- Randy MacLeod +- Ranjitsinh Rathod +- Rasmus Villemoes +- Reto Schneider +- Richard Purdie +- Richard Weinberger +- Robert Joslyn +- Robert P. J. Day +- Robert Yang +- Romain Naour +- Ross Burton +- Sakib Sajal +- Samuli Piippo +- Saul Wold +- Scott Murray +- Scott Weaver +- Stefan Ghinea +- Stefan Herbrechtsmeier +- Stefano Babic +- Stefan Wiehler +- Steve Sakoman +- Teoh Jay Shen +- Thomas Perrot +- Tim Orling +- Tom Pollard +- Tom Rini +- Tony Battersby +- Tony Tascioglu +- Trevor Gamblin +- Trevor Woerner +- Ulrich Ölmann +- Valentin Danaila +- Vinay Kumar +- Vineela Tummalapalli +- VinÃcius Ossanes Aquino +- Vivien Didelot +- Vyacheslav Yurkov +- Wang Mingyu +- Wes Lindauer +- William A. Kennington III +- Yanfei Xu +- Yann Dirson +- Yi Fan Yu +- Yi Zhao +- Zang Ruochen +- Zheng Ruoqin +- Zoltan Boszormenyi + +Repositories / Downloads for 3.4 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +poky + +- Repository Location: https://git.yoctoproject.org/poky/ +- Branch: :yocto_git:`honister </poky/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4 </poky/tag/?h=yocto-3.4>` +- Git Revision: :yocto_git:`f6d1126fff213460dc6954a5d5fc168606d76b66 </poky/commit/?id=f6d1126fff213460dc6954a5d5fc168606d76b66>` +- Release Artefact: poky-f6d1126fff213460dc6954a5d5fc168606d76b66 +- sha: 11e8f5760f704eed1ac37a5b09b1a831b5254d66459be75b06a72128c63e0411 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/poky-f6d1126fff213460dc6954a5d5fc168606d76b66.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/poky-f6d1126fff213460dc6954a5d5fc168606d76b66.tar.bz2 + +openembedded-core + +- Repository Location: :oe_git:`/openembedded-core` +- Branch: :oe_git:`honister </openembedded-core/log/?h=honister>` +- Tag: :oe_git:`2021-10-honister </openembedded-core/tag/?h=2021-10-honister>` +- Git Revision: :oe_git:`bb1dea6806f084364b6017db2567f438e805aef0 </openembedded-core/commit/?id=bb1dea6806f084364b6017db2567f438e805aef0>` +- Release Artefact: oecore-bb1dea6806f084364b6017db2567f438e805aef0 +- sha: 9a356c407c567b1c26e535cad235204b0462cb79321fefb0844324a6020b31f4 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/oecore-bb1dea6806f084364b6017db2567f438e805aef0.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/oecore-bb1dea6806f084364b6017db2567f438e805aef0.tar.bz2 + +meta-mingw + +- Repository Location: https://git.yoctoproject.org/meta-mingw +- Branch: :yocto_git:`honister </meta-mingw/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4 </meta-mingw/tag/?h=yocto-3.4>` +- Git Revision: :yocto_git:`f5d761cbd5c957e4405c5d40b0c236d263c916a8 </meta-mingw/commit/?id=f5d761cbd5c957e4405c5d40b0c236d263c916a8>` +- Release Artefact: meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8 +- sha: d4305d638ef80948584526c8ca386a8cf77933dffb8a3b8da98d26a5c40fcc11 +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-mingw-f5d761cbd5c957e4405c5d40b0c236d263c916a8.tar.bz2 + +meta-intel + +- Repository Location: https://git.yoctoproject.org/meta-intel +- Branch: :yocto_git:`honister </meta-intel/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4 </meta-intel/tag/?h=yocto-3.4>` +- Git Revision: :yocto_git:`90170cf85fe35b4e8dc00eee50053c0205276b63 </meta-intel/commit/?id=90170cf85fe35b4e8dc00eee50053c0205276b63>` +- Release Artefact: meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63 +- sha: 2b3b43386dfcaaa880d819c1ae88b1251b55fb12c622af3d0936c3dc338491fc +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-intel-90170cf85fe35b4e8dc00eee50053c0205276b63.tar.bz2 + +meta-gplv2 + +- Repository Location: https://git.yoctoproject.org/meta-gplv2 +- Branch: :yocto_git:`honister </meta-gplv2/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4 </meta-gplv2/tag/?h=yocto-3.4>` +- Git Revision: :yocto_git:`f04e4369bf9dd3385165281b9fa2ed1043b0e400 </meta-gplv2/commit/?id=f04e4369bf9dd3385165281b9fa2ed1043b0e400>` +- Release Artefact: meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400 +- sha: ef8e2b1ec1fb43dbee4ff6990ac736315c7bc2d8c8e79249e1d337558657d3fe +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/meta-gplv2-f04e4369bf9dd3385165281b9fa2ed1043b0e400.tar.bz2 + +bitbake + +- Repository Location: :oe_git:`/bitbake` +- Branch: :oe_git:`1.52 </bitbake/log/?h=1.52>` +- Tag: :oe_git:`2021-10-honister </bitbake/tag/?h=2021-10-honister>` +- Git Revision: :oe_git:`c78ebac71ec976fdf27ea24767057882870f5c60 </bitbake/commit/?id=c78ebac71ec976fdf27ea24767057882870f5c60>` +- Release Artefact: bitbake-c78ebac71ec976fdf27ea24767057882870f5c60 +- sha: 8077c7e7528cd73ef488ef74de3943ec66cae361459e5b630fb3cbe89c498d3d +- Download Locations: + http://downloads.yoctoproject.org/releases/yocto/yocto-3.4/bitbake-c78ebac71ec976fdf27ea24767057882870f5c60.tar.bz2, + http://mirrors.kernel.org/yocto/yocto/yocto-3.4/bitbake-c78ebac71ec976fdf27ea24767057882870f5c60.tar.bz2 + +yocto-docs + +- Repository Location: https://git.yoctoproject.org/yocto-docs +- Branch: :yocto_git:`honister </yocto-docs/log/?h=honister>` +- Tag: :yocto_git:`yocto-3.4 </yocto-docs/tag/?h=yocto-3.4>` +- Git Revision: :yocto_git:`d75c5450ecf56c8ac799a633ee9ac459e88f91fc </yocto-docs/commit/?id=d75c5450ecf56c8ac799a633ee9ac459e88f91fc>` + diff --git a/poky/documentation/overview-manual/concepts.rst b/poky/documentation/overview-manual/concepts.rst index 5c6364129d..065d9586c6 100644 --- a/poky/documentation/overview-manual/concepts.rst +++ b/poky/documentation/overview-manual/concepts.rst @@ -300,13 +300,8 @@ in the ``meta-poky`` layer: .. note:: - Configurations set in the - conf/local.conf - file can also be set in the - conf/site.conf - and - conf/auto.conf - configuration files. + Configurations set in the ``conf/local.conf`` file can also be set + in the ``conf/site.conf`` and ``conf/auto.conf`` configuration files. The ``bblayers.conf`` file tells BitBake what layers you want considered during the build. By default, the layers listed in this file include @@ -1036,12 +1031,10 @@ for example, to determine whether or not to run specific tests. See the :term:`IMAGE_MANIFEST` variable for additional information. -Optimizing processes that are run across the image include ``mklibs``, -``prelink``, and any other post-processing commands as defined by the +Optimizing processes that are run across the image include ``mklibs`` +and any other post-processing commands as defined by the :term:`ROOTFS_POSTPROCESS_COMMAND` -variable. The ``mklibs`` process optimizes the size of the libraries, -while the ``prelink`` process optimizes the dynamic linking of shared -libraries to reduce start up time of executables. +variable. The ``mklibs`` process optimizes the size of the libraries. After the root filesystem is built, processing begins on the image through the :ref:`ref-tasks-image` @@ -1379,15 +1372,15 @@ associated with an extensible SDK: Specifies whether or not the toolchain is included when building the extensible SDK. -- :term:`SDK_LOCAL_CONF_WHITELIST`: +- :term:`ESDK_LOCALCONF_ALLOW`: A list of variables allowed through from the build system configuration into the extensible SDK configuration. -- :term:`SDK_LOCAL_CONF_BLACKLIST`: +- :term:`ESDK_LOCALCONF_REMOVE`: A list of variables not allowed through from the build system configuration into the extensible SDK configuration. -- :term:`SDK_INHERIT_BLACKLIST`: +- :term:`ESDK_CLASS_INHERIT_DISABLE`: A list of classes to remove from the :term:`INHERIT` value globally within the extensible SDK configuration. @@ -1729,7 +1722,7 @@ it construct the basehash. The following statement effectively results in a list of global variable dependency excludes (i.e. variables never included in any checksum):: - BB_HASHBASE_WHITELIST ?= "TMPDIR FILE PATH PWD BB_TASKHASH BBPATH DL_DIR \\ + BB_BASEHASH_IGNORE_VARS ?= "TMPDIR FILE PATH PWD BB_TASKHASH BBPATH DL_DIR \\ SSTATE_DIR THISDIR FILESEXTRAPATHS FILE_DIRNAME HOME LOGNAME SHELL TERM \\ USER FILESPATH STAGING_DIR_HOST STAGING_DIR_TARGET COREBASE PRSERV_HOST \\ PRSERV_DUMPDIR PRSERV_DUMPFILE PRSERV_LOCKDOWN PARALLEL_MAKE \\ diff --git a/poky/documentation/overview-manual/development-environment.rst b/poky/documentation/overview-manual/development-environment.rst index fc193f3135..9c9c8e87a0 100644 --- a/poky/documentation/overview-manual/development-environment.rst +++ b/poky/documentation/overview-manual/development-environment.rst @@ -461,7 +461,7 @@ and clicking on the ``[...]`` link beneath the "Tag" heading. Some key tags for the ``poky`` repository are ``jethro-14.0.3``, ``morty-16.0.1``, ``pyro-17.0.0``, and -``&DISTRO_NAME_NO_CAP;-&POKYVERSION;``. These tags represent Yocto Project +``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent Yocto Project releases. When you create a local copy of the Git repository, you also have access diff --git a/poky/documentation/overview-manual/yp-intro.rst b/poky/documentation/overview-manual/yp-intro.rst index ce2aed519e..a863a7d16e 100644 --- a/poky/documentation/overview-manual/yp-intro.rst +++ b/poky/documentation/overview-manual/yp-intro.rst @@ -387,39 +387,6 @@ Yocto Project: You can learn more about the AutoBuilder used by the Yocto Project Autobuilder :doc:`here </test-manual/understand-autobuilder>`. -- *Cross-Prelink:* Prelinking is the process of pre-computing the load - addresses and link tables generated by the dynamic linker as compared - to doing this at runtime. Doing this ahead of time results in - performance improvements when the application is launched and reduced - memory usage for libraries shared by many applications. - - Historically, cross-prelink is a variant of prelink, which was - conceived by `Jakub - JelÃnek <https://people.redhat.com/jakub/prelink.pdf>`__ a number of - years ago. Both prelink and cross-prelink are maintained in the same - repository albeit on separate branches. By providing an emulated - runtime dynamic linker (i.e. ``glibc``-derived ``ld.so`` emulation), - the cross-prelink project extends the prelink software's ability to - prelink a sysroot environment. Additionally, the cross-prelink - software enables the ability to work in sysroot style environments. - - The dynamic linker determines standard load address calculations - based on a variety of factors such as mapping addresses, library - usage, and library function conflicts. The prelink tool uses this - information, from the dynamic linker, to determine unique load - addresses for executable and linkable format (ELF) binaries that are - shared libraries and dynamically linked. The prelink tool modifies - these ELF binaries with the pre-computed information. The result is - faster loading and often lower memory consumption because more of the - library code can be re-used from shared Copy-On-Write (COW) pages. - - The original upstream prelink project only supports running prelink - on the end target device due to the reliance on the target device's - dynamic linker. This restriction causes issues when developing a - cross-compiled system. The cross-prelink adds a synthesized dynamic - loader that runs on the host, thus permitting cross-prelinking - without ever having to run on a read-write target filesystem. - - *Pseudo:* Pseudo is the Yocto Project implementation of `fakeroot <http://man.he.net/man1/fakeroot>`__, which is used to run commands in an environment that seemingly has root privileges. diff --git a/poky/documentation/poky.yaml b/poky/documentation/poky.yaml.in index 0935e28251..a346b7623c 100644 --- a/poky/documentation/poky.yaml +++ b/poky/documentation/poky.yaml.in @@ -4,10 +4,9 @@ DISTRO_NAME : "Honister" DISTRO_NAME_NO_CAP_MINUS_ONE : "hardknott" DISTRO_NAME_NO_CAP_LTS : "dunfell" YOCTO_DOC_VERSION : "3.4.2" -YOCTO_DOC_VERSION_MINUS_ONE : "3.3.4" DISTRO_REL_TAG : "yocto-3.4.2" -POKYVERSION : "26.0.2" -YOCTO_POKY : "poky-&DISTRO_NAME_NO_CAP;-&POKYVERSION;" +DOCCONF_VERSION : "dev" +BITBAKE_SERIES : "" YOCTO_DL_URL : "https://downloads.yoctoproject.org" YOCTO_AB_URL : "https://autobuilder.yoctoproject.org" YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;" diff --git a/poky/documentation/ref-manual/classes.rst b/poky/documentation/ref-manual/classes.rst index 949217bf42..4dd0901623 100644 --- a/poky/documentation/ref-manual/classes.rst +++ b/poky/documentation/ref-manual/classes.rst @@ -170,8 +170,7 @@ example use for this class. are extracted into the subdirectory expected by the default value of :term:`S`:: - SRC_URI = "git://example.com/downloads/somepackage.rpm;subpath=${BP}" - + SRC_URI = "git://example.com/downloads/somepackage.rpm;branch=main;subpath=${BP}" See the ":ref:`bitbake-user-manual/bitbake-user-manual-fetching:fetchers`" section in the BitBake User Manual for more information on supported BitBake Fetchers. @@ -208,23 +207,6 @@ scripts to be disabled should be specified using the :term:`BINCONFIG` variable within the recipe inheriting the class. -.. _ref-classes-blacklist: - -``blacklist.bbclass`` -===================== - -The ``blacklist`` class prevents the OpenEmbedded build system from -building specific recipes. To use this class, inherit -the class globally and set :term:`PNBLACKLIST` for -each recipe you wish to ignore. Specify the :term:`PN` -value as a variable flag (varflag) and provide a reason, which is -reported, if the package is requested to be built as the value. For -example, if you want to ignore a recipe called "exoticware", you -add the following to your ``local.conf`` or distribution configuration:: - - INHERIT += "blacklist" - PNBLACKLIST[exoticware] = "Not supported by our organization." - .. _ref-classes-buildhistory: ``buildhistory.bbclass`` @@ -477,7 +459,7 @@ recipe that fetches from an alternative URI (e.g. Git) instead of a tarball. Following is an example:: BBCLASSEXTEND = "devupstream:target" - SRC_URI:class-devupstream = "git://git.example.com/example" + SRC_URI:class-devupstream = "git://git.example.com/example;branch=main" SRCREV:class-devupstream = "abcd1234" Adding the above statements to your recipe creates a variant that has @@ -503,35 +485,6 @@ Support for other version control systems such as Subversion is limited due to BitBake's automatic fetch dependencies (e.g. ``subversion-native``). -.. _ref-classes-distutils3: - -``distutils3*.bbclass`` -======================= - -The ``distutils3*`` classes support recipes for Python version 3.x -extensions, which are simple. These recipes usually only need to point -to the source's archive and then inherit the proper class. Building is -split into three methods depending on which method the module authors -used. - -- Extensions that use an Autotools-based build system require Autotools - and ``distutils``-based classes in their recipes. - -- Extensions that use ``distutils``-based build systems require the - ``distutils`` class in their recipes. - - .. note:: - - ``distutils`` has been deprecated in Python 3.10 and will be removed - in Python 3.12. For this reason the ``distutils3*`` classes are now - deprecated and will be removed from core in the near future. Instead, - use the ``setuptools3*`` classes. - - -- Extensions that use build systems based on ``setuptools3`` require - the :ref:`setuptools3 <ref-classes-setuptools3>` class in their - recipes. - .. _ref-classes-externalsrc: ``externalsrc.bbclass`` @@ -603,12 +556,11 @@ Here is an example that uses this class in an image recipe:: " Here is an example that adds two users named "tester-jim" and "tester-sue" and assigns -passwords. First on host, create the password hash:: +passwords. First on host, create the (escaped) password hash:: - mkpasswd -m sha256crypt tester01 + printf "%q" $(mkpasswd -m sha256crypt tester01) -The resulting hash is set to a variable and used in ``useradd`` command parameters. -Remember to escape the character ``$``:: +The resulting hash is set to a variable and used in ``useradd`` command parameters:: inherit extrausers PASSWD = "\$X\$ABC123\$A-Long-Hash" @@ -650,6 +602,22 @@ variables are not met, the recipe will be skipped, and if the build system attempts to build the recipe then an error will be triggered. +.. _ref-classes-flit_core: + +``flit_core.bbclass`` +===================== + +The ``flit_core`` class enables building Python modules which declare +the `PEP-517 <https://www.python.org/dev/peps/pep-0517/>`__ compliant +``flit_core.buildapi`` ``build-backend`` in the ``[build-system]`` +section of ``pyproject.toml`` (See `PEP-518 <https://www.python.org/dev/peps/pep-0518/>`__). + +Python modules built with ``flit_core.buildapi`` are pure Python (no +``C`` or ``Rust`` extensions). + +The resulting ``wheel`` (See `PEP-427 <https://www.python.org/dev/peps/pep-0427/>`__) +is installed with the :ref:`python_pep517 <ref-classes-python_pep517>` class. + .. _ref-classes-fontcache: ``fontcache.bbclass`` @@ -860,13 +828,13 @@ provided by the recipe ``icecc-create-env-native.bb``. If you do not want the Icecream distributed compile support to apply to specific recipes or classes, you can ask them to be ignored by Icecream by listing the recipes and classes using the -:term:`ICECC_USER_PACKAGE_BL` and -:term:`ICECC_USER_CLASS_BL` variables, +:term:`ICECC_RECIPE_DISABLE` and +:term:`ICECC_CLASS_DISABLE` variables, respectively, in your ``local.conf`` file. Doing so causes the OpenEmbedded build system to handle these compilations locally. Additionally, you can list recipes using the -:term:`ICECC_USER_PACKAGE_WL` variable in +:term:`ICECC_RECIPE_ENABLE` variable in your ``local.conf`` file to force ``icecc`` to be enabled for recipes using an empty :term:`PARALLEL_MAKE` variable. @@ -967,21 +935,6 @@ specified by :term:`EFI_PROVIDER` if Normally, you do not use this class directly. Instead, you add "live" to :term:`IMAGE_FSTYPES`. -.. _ref-classes-image-prelink: - -``image-prelink.bbclass`` -========================= - -The ``image-prelink`` class enables the use of the ``prelink`` utility -during the :ref:`ref-tasks-rootfs` task, which optimizes -the dynamic linking of shared libraries to reduce executable startup -time. - -By default, the class is enabled in the ``local.conf.template`` using -the :term:`USER_CLASSES` variable as follows:: - - USER_CLASSES ?= "buildstats image-prelink" - .. _ref-classes-insane: ``insane.bbclass`` @@ -2025,6 +1978,21 @@ When inherited by a recipe, the ``perlnative`` class supports using the native version of Perl built by the build system rather than using the version provided by the build host. +.. _ref-classes-python_pep517: + +``python_pep517.bbclass`` +============================= + +The ``python_pep517`` class installs a Python ``wheel`` binary archive (see +`PEP-517 <https://peps.python.org/pep-0517/>`__). + +The Python ``wheel`` can be built with several classes, including :ref:`flit_core <ref-classes-flit_core>`, +:ref:`setuptools_build_meta <ref-classes-setuptools_build_meta>`, and :ref:`setuptools3 <ref-classes-setuptools3>`. + +The path to the wheel to be installed is defined by :term:`PEP517_WHEEL_PATH`. +This defaults to ``${D}/dist`` and should be respected by the builder class +(such as :ref:`flit_core <ref-classes-flit_core>`). + .. _ref-classes-pixbufcache: ``pixbufcache.bbclass`` @@ -2380,14 +2348,65 @@ additional configuration options you want to pass SCons command line. The ``sdl`` class supports recipes that need to build software that uses the Simple DirectMedia Layer (SDL) library. +.. _ref-classes-setuptools_build_meta: + +``setuptools_build_meta.bbclass`` +================================= + +The ``setuptools_build_meta`` class enables building Python modules which +declare the +`PEP-517 <https://www.python.org/dev/peps/pep-0517/>`__ compliant +``setuptools.build_meta`` ``build-backend`` in the ``[build-system]`` +section of ``pyproject.toml`` (See `PEP-518 <https://www.python.org/dev/peps/pep-0518/>`__). + +Python modules built with ``setuptools.build_meta`` can be pure Python or +include ``C`` or ``Rust`` extensions). + +The resulting ``wheel`` (See `PEP-427 <https://www.python.org/dev/peps/pep-0427/>`__) +is installed with the :ref:`python_pep517 <ref-classes-python_pep517>` class. + .. _ref-classes-setuptools3: ``setuptools3.bbclass`` ======================= The ``setuptools3`` class supports Python version 3.x extensions that -use build systems based on ``setuptools``. If your recipe uses these -build systems, the recipe needs to inherit the ``setuptools3`` class. +use build systems based on ``setuptools`` (e.g. only have a ``setup.py`` and +have not migrated to the official ``pyproject.toml`` format). If your recipe +uses these build systems, the recipe needs to inherit the ``setuptools3`` class. + + .. note:: + + The ``setuptools3`` class ``do_compile()`` task now calls + ``setup.py bdist_wheel`` to build the ``wheel`` binary archive format + (See `PEP-427 <https://www.python.org/dev/peps/pep-0427/>`__). + + A consequence of this is that legacy software still using deprecated + ``distutils`` from the Python standard library cannot be packaged as + ``wheels``. A common solution is the replace + ``from distutils.core import setup`` with ``from setuptools import setup``. + + .. note:: + + The ``setuptools3`` class ``do_install()`` task now installs the ``wheel`` + binary archive. In current versions of ``setuptools`` the legacy ``setup.py + install`` method is deprecated. If the ``setup.py`` cannot be used with + wheels, for example it creates files outside of the Python module or + standard entry points, then :ref:`setuptools3_legacy + <ref-classes-setuptools3_legacy>` should be used. + +.. _ref-classes-setuptools3_legacy: + +``setuptools3_legacy.bbclass`` +============================== + +The ``setuptools3_legacy`` class supports Python version 3.x extensions that use +build systems based on ``setuptools`` (e.g. only have a ``setup.py`` and have +not migrated to the official ``pyproject.toml`` format). Unlike +``setuptools3.bbclass``, this uses the traditional ``setup.py`` ``build`` and +``install`` commands and not wheels. This use of ``setuptools`` like this is +`deprecated <https://github.com/pypa/setuptools/blob/main/CHANGES.rst#v5830>`_ +but still relatively common. .. _ref-classes-setuptools3-base: @@ -2489,7 +2508,7 @@ stages: subset of files is controlled by the :term:`SYSROOT_DIRS`, :term:`SYSROOT_DIRS_NATIVE`, and - :term:`SYSROOT_DIRS_BLACKLIST` + :term:`SYSROOT_DIRS_IGNORE` variables. .. note:: diff --git a/poky/documentation/ref-manual/faq.rst b/poky/documentation/ref-manual/faq.rst index e06dfd972b..e06b5e6caa 100644 --- a/poky/documentation/ref-manual/faq.rst +++ b/poky/documentation/ref-manual/faq.rst @@ -455,7 +455,4 @@ changing it? **A:** The first most obvious change is the system stripping debug symbols from it. Setting :term:`INHIBIT_PACKAGE_STRIP` to stop debug symbols being stripped and/or :term:`INHIBIT_PACKAGE_DEBUG_SPLIT` to stop debug symbols being split into a separate -file will ensure the binary is unchanged. The other less obvious thing that can -happen is prelinking of the image. This is set by default in local.conf via -:term:`USER_CLASSES` which can contain 'image-prelink'. If you remove that, the -image will not be prelinked meaning the binaries would be unchanged. +file will ensure the binary is unchanged. diff --git a/poky/documentation/ref-manual/images.rst b/poky/documentation/ref-manual/images.rst index 0e3351bb7b..31fb567687 100644 --- a/poky/documentation/ref-manual/images.rst +++ b/poky/documentation/ref-manual/images.rst @@ -21,7 +21,7 @@ image you want. image:: 1. Comment out the EXTRA_IMAGE_FEATURES line - 2. Set INCOMPATIBLE_LICENSE = "GPL-3.0 LGPL-3.0 AGPL-3.0" + 2. Set INCOMPATIBLE_LICENSE = "GPL-3.0* LGPL-3.0* AGPL-3.0*" From within the ``poky`` Git repository, you can use the following diff --git a/poky/documentation/ref-manual/system-requirements.rst b/poky/documentation/ref-manual/system-requirements.rst index 30294cb27a..04f9efaa23 100644 --- a/poky/documentation/ref-manual/system-requirements.rst +++ b/poky/documentation/ref-manual/system-requirements.rst @@ -41,15 +41,15 @@ distributions: - Ubuntu 20.04 (LTS) -- Fedora 33 - - Fedora 34 +- Fedora 35 + - CentOS 7.x - CentOS 8.x -- Debian GNU/Linux 8.x (Jessie) +- AlmaLinux 8.5 - Debian GNU/Linux 9.x (Stretch) @@ -57,9 +57,7 @@ distributions: - Debian GNU/Linux 11.x (Bullseye) -- OpenSUSE Leap 15.1 - -- OpenSUSE Leap 15.2 +- OpenSUSE Leap 15.3 .. note:: diff --git a/poky/documentation/ref-manual/terms.rst b/poky/documentation/ref-manual/terms.rst index 3f18d3404e..cba514c345 100644 --- a/poky/documentation/ref-manual/terms.rst +++ b/poky/documentation/ref-manual/terms.rst @@ -88,11 +88,11 @@ universal, the list includes them just in case: - Provide a directory path and specifically name the Build Directory. Any intermediate folders in the pathname must exist. This next example creates a Build Directory named - ``YP-&POKYVERSION;`` within the existing directory ``mybuilds``: + ``YP-&DISTRO;`` within the existing directory ``mybuilds``: .. code-block:: shell - $ source poky/oe-init-build-env mybuilds/YP-&POKYVERSION; + $ source poky/oe-init-build-env mybuilds/YP-&DISTRO; .. note:: @@ -357,13 +357,13 @@ universal, the list includes them just in case: repository results in a local Git repository whose top-level folder is also named "poky". - While it is not recommended that you use tarball expansion to set up + While it is not recommended that you use tarball extraction to set up the Source Directory, if you do, the top-level directory name of the Source Directory is derived from the Yocto Project release tarball. - For example, downloading and unpacking - :yocto_dl:`/releases/yocto/&DISTRO_REL_TAG;/&YOCTO_POKY;.tar.bz2` - results in a Source Directory whose root folder is named - ``&YOCTO_POKY;``. + For example, downloading and unpacking poky tarballs from + :yocto_dl:`/releases/yocto/&DISTRO_REL_TAG;/` + results in a Source Directory whose root folder is named poky. + It is important to understand the differences between the Source Directory created by unpacking a released tarball as compared to diff --git a/poky/documentation/ref-manual/variables.rst b/poky/documentation/ref-manual/variables.rst index ecb2b60c73..634f19a673 100644 --- a/poky/documentation/ref-manual/variables.rst +++ b/poky/documentation/ref-manual/variables.rst @@ -17,6 +17,7 @@ system and gives an overview of their function and contents. :term:`W <WARN_QA>` :term:`X <XSERVER>` .. glossary:: + :sorted: :term:`ABIEXTENSION` Extension to the Application Binary Interface (ABI) field of the GNU @@ -206,11 +207,6 @@ system and gives an overview of their function and contents. The default value is "${PACKAGES}", which causes the debian class to act on all packages that are explicitly generated by the recipe. - :term:`AUTO_SYSLINUXMENU` - Enables creating an automatic menu for the syslinux bootloader. You - must set this variable in your recipe. The - :ref:`syslinux <ref-classes-syslinux>` class checks this variable. - :term:`AUTOREV` When :term:`SRCREV` is set to the value of this variable, it specifies to use the latest source revision in the repository. Here is an example:: @@ -230,6 +226,11 @@ system and gives an overview of their function and contents. ":ref:`dev-manual/common-tasks:automatically incrementing a package version number`" section in the Yocto Project Development Tasks Manual. + :term:`AUTO_SYSLINUXMENU` + Enables creating an automatic menu for the syslinux bootloader. You + must set this variable in your recipe. The + :ref:`syslinux <ref-classes-syslinux>` class checks this variable. + :term:`AVAILABLE_LICENSES` List of licenses found in the directories specified by :term:`COMMON_LICENSE_DIR` and @@ -1306,6 +1307,40 @@ system and gives an overview of their function and contents. the recipe will be skipped, and if the build system attempts to build the recipe then an error will be triggered. + :term:`COPY_LIC_DIRS` + If set to "1" along with the + :term:`COPY_LIC_MANIFEST` variable, the + OpenEmbedded build system copies into the image the license files, + which are located in ``/usr/share/common-licenses``, for each + package. The license files are placed in directories within the image + itself during build time. + + .. note:: + + The :term:`COPY_LIC_DIRS` does not offer a path for adding licenses for + newly installed packages to an image, which might be most suitable for + read-only filesystems that cannot be upgraded. See the + :term:`LICENSE_CREATE_PACKAGE` variable for additional information. + You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" + section in the Yocto Project Development Tasks Manual for + information on providing license text. + + :term:`COPY_LIC_MANIFEST` + If set to "1", the OpenEmbedded build system copies the license + manifest for the image to + ``/usr/share/common-licenses/license.manifest`` within the image + itself during build time. + + .. note:: + + The :term:`COPY_LIC_MANIFEST` does not offer a path for adding licenses for + newly installed packages to an image, which might be most suitable for + read-only filesystems that cannot be upgraded. See the + :term:`LICENSE_CREATE_PACKAGE` variable for additional information. + You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" + section in the Yocto Project Development Tasks Manual for + information on providing license text. + :term:`COPYLEFT_LICENSE_EXCLUDE` A space-separated list of licenses to exclude from the source archived by the :ref:`archiver <ref-classes-archiver>` class. In @@ -1374,40 +1409,6 @@ system and gives an overview of their function and contents. is set by the :ref:`copyleft_filter <ref-classes-copyleft_filter>` class, which is inherited by the :ref:`archiver <ref-classes-archiver>` class. - :term:`COPY_LIC_DIRS` - If set to "1" along with the - :term:`COPY_LIC_MANIFEST` variable, the - OpenEmbedded build system copies into the image the license files, - which are located in ``/usr/share/common-licenses``, for each - package. The license files are placed in directories within the image - itself during build time. - - .. note:: - - The :term:`COPY_LIC_DIRS` does not offer a path for adding licenses for - newly installed packages to an image, which might be most suitable for - read-only filesystems that cannot be upgraded. See the - :term:`LICENSE_CREATE_PACKAGE` variable for additional information. - You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" - section in the Yocto Project Development Tasks Manual for - information on providing license text. - - :term:`COPY_LIC_MANIFEST` - If set to "1", the OpenEmbedded build system copies the license - manifest for the image to - ``/usr/share/common-licenses/license.manifest`` within the image - itself during build time. - - .. note:: - - The :term:`COPY_LIC_MANIFEST` does not offer a path for adding licenses for - newly installed packages to an image, which might be most suitable for - read-only filesystems that cannot be upgraded. See the - :term:`LICENSE_CREATE_PACKAGE` variable for additional information. - You can also reference the ":ref:`dev-manual/common-tasks:providing license text`" - section in the Yocto Project Development Tasks Manual for - information on providing license text. - :term:`CORE_IMAGE_EXTRA_INSTALL` Specifies the list of packages to be added to the image. You should only set this variable in the ``local.conf`` configuration file found @@ -1472,16 +1473,16 @@ system and gives an overview of their function and contents. variable only in certain contexts (e.g. when building for kernel and kernel module recipes). - :term:`CVE_CHECK_PN_WHITELIST` - The list of package names (:term:`PN`) for which - CVEs (Common Vulnerabilities and Exposures) are ignored. - - :term:`CVE_CHECK_WHITELIST` + :term:`CVE_CHECK_IGNORE` The list of CVE IDs which are ignored. Here is an example from the :oe_layerindex:`Python3 recipe</layerindex/recipe/23823>`:: # This is windows only issue. - CVE_CHECK_WHITELIST += "CVE-2020-15523" + CVE_CHECK_IGNORE += "CVE-2020-15523" + + :term:`CVE_CHECK_SKIP_RECIPE` + The list of package names (:term:`PN`) for which + CVEs (Common Vulnerabilities and Exposures) are ignored. :term:`CVE_PRODUCT` In a recipe, defines the name used to match the recipe name @@ -1568,21 +1569,6 @@ system and gives an overview of their function and contents. compiling a system for debugging. This variable defaults to "-O -fno-omit-frame-pointer ${DEBUG_FLAGS} -pipe". - :term:`DEFAULT_PREFERENCE` - Specifies a weak bias for recipe selection priority. - - The most common usage of this is variable is to set it to "-1" within - a recipe for a development version of a piece of software. Using the - variable in this way causes the stable version of the recipe to build - by default in the absence of :term:`PREFERRED_VERSION` being used to - build the development version. - - .. note:: - - The bias provided by :term:`DEFAULT_PREFERENCE` is weak and is overridden - by :term:`BBFILE_PRIORITY` if that variable is different between two - layers that contain different versions of the same recipe. - :term:`DEBUG_PREFIX_MAP` Allows to set C compiler options, such as ``-fdebug-prefix-map``, ``-fmacro-prefix-map``, and ``-ffile-prefix-map``, which allow to @@ -1600,6 +1586,21 @@ system and gives an overview of their function and contents. This variable is set in the ``meta/conf/bitbake.conf`` file. It is not intended to be user-configurable. + :term:`DEFAULT_PREFERENCE` + Specifies a weak bias for recipe selection priority. + + The most common usage of this is variable is to set it to "-1" within + a recipe for a development version of a piece of software. Using the + variable in this way causes the stable version of the recipe to build + by default in the absence of :term:`PREFERRED_VERSION` being used to + build the development version. + + .. note:: + + The bias provided by :term:`DEFAULT_PREFERENCE` is weak and is overridden + by :term:`BBFILE_PRIORITY` if that variable is different between two + layers that contain different versions of the same recipe. + :term:`DEFAULTTUNE` The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system. The @@ -1982,25 +1983,6 @@ system and gives an overview of their function and contents. is included in the default value of :term:`OVERRIDES`. - :term:`DISTUTILS_SETUP_PATH` - When used by recipes that inherit the - :ref:`distutils3 <ref-classes-distutils3>` class, this variable should - be used to specify the directory in which the ``setup.py`` file is - located if it is not at the root of the source tree (as specified by - :term:`S`). For example, in a recipe where the sources are fetched from - a Git repository and ``setup.py`` is in a ``python/pythonmodule`` - subdirectory, you would have this:: - - S = "${WORKDIR}/git" - DISTUTILS_SETUP_PATH = "${S}/python/pythonmodule" - - .. note:: - - ``distutils`` has been deprecated in Python 3.10 and will be removed - in Python 3.12. For this reason, the use of :ref:`distutils3 <ref-classes-distutils3>` - is deprecated. Instead use :ref:`setuptools3 <ref-classes-setuptools3>` and the - :term:`SETUPTOOLS_SETUP_PATH` variable. - :term:`DL_DIR` The central download directory used by the build process to store downloads. By default, :term:`DL_DIR` gets files suitable for mirroring @@ -2086,6 +2068,68 @@ system and gives an overview of their function and contents. can control with this variable, see the ":ref:`ref-classes-insane`" section. + :term:`ESDK_CLASS_INHERIT_DISABLE` + A list of classes to remove from the :term:`INHERIT` + value globally within the extensible SDK configuration. The + :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the + default value:: + + ESDK_CLASS_INHERIT_DISABLE ?= "buildhistory icecc" + + Some classes are not generally applicable within the extensible SDK + context. You can use this variable to disable those classes. + + For additional information on how to customize the extensible SDK's + configuration, see the + ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" + section in the Yocto Project Application Development and the + Extensible Software Development Kit (eSDK) manual. + + :term:`ESDK_LOCALCONF_ALLOW` + A list of variables allowed through from the OpenEmbedded build + system configuration into the extensible SDK configuration. By + default, the list of variables is empty and is set in the + :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class. + + This list overrides the variables specified using the + :term:`ESDK_LOCALCONF_REMOVE` variable as well as + other variables automatically added due to the "/" character + being found at the start of the + value, which is usually indicative of being a path and thus might not + be valid on the system where the SDK is installed. + + For additional information on how to customize the extensible SDK's + configuration, see the + ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" + section in the Yocto Project Application Development and the + Extensible Software Development Kit (eSDK) manual. + + :term:`ESDK_LOCALCONF_REMOVE` + A list of variables not allowed through from the OpenEmbedded build + system configuration into the extensible SDK configuration. Usually, + these are variables that are specific to the machine on which the + build system is running and thus would be potentially problematic + within the extensible SDK. + + By default, :term:`ESDK_LOCALCONF_REMOVE` is set in the + :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class and + excludes the following variables: + + - :term:`CONF_VERSION` + - :term:`BB_NUMBER_THREADS` + - :term:`BB_NUMBER_PARSE_THREADS` + - :term:`PARALLEL_MAKE` + - :term:`PRSERV_HOST` + - :term:`SSTATE_MIRRORS` :term:`DL_DIR` + - :term:`SSTATE_DIR` :term:`TMPDIR` + - :term:`BB_SERVER_TIMEOUT` + + For additional information on how to customize the extensible SDK's + configuration, see the + ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" + section in the Yocto Project Application Development and the + Extensible Software Development Kit (eSDK) manual. + :term:`EXCLUDE_FROM_SHLIBS` Triggers the OpenEmbedded build system's shared libraries resolver to exclude an entire package when scanning for shared libraries. @@ -2253,16 +2297,6 @@ system and gives an overview of their function and contents. To add packages to the root filesystem, see the various :term:`RDEPENDS` and :term:`RRECOMMENDS` variables. - :term:`EXTRANATIVEPATH` - A list of subdirectories of - ``${``\ :term:`STAGING_BINDIR_NATIVE`\ ``}`` - added to the beginning of the environment variable ``PATH``. As an - example, the following prepends - "${STAGING_BINDIR_NATIVE}/foo:${STAGING_BINDIR_NATIVE}/bar:" to - ``PATH``:: - - EXTRANATIVEPATH = "foo bar" - :term:`EXTRA_OECMAKE` Additional `CMake <https://cmake.org/overview/>`__ options. See the :ref:`cmake <ref-classes-cmake>` class for additional information. @@ -2319,6 +2353,16 @@ system and gives an overview of their function and contents. At present, ``passwd-expire`` may only work for remote logins when using OpenSSH and not dropbear as an SSH server. + :term:`EXTRANATIVEPATH` + A list of subdirectories of + ``${``\ :term:`STAGING_BINDIR_NATIVE`\ ``}`` + added to the beginning of the environment variable ``PATH``. As an + example, the following prepends + "${STAGING_BINDIR_NATIVE}/foo:${STAGING_BINDIR_NATIVE}/bar:" to + ``PATH``:: + + EXTRANATIVEPATH = "foo bar" + :term:`FEATURE_PACKAGES` Defines one or more packages to include in an image when a specific item is included in :term:`IMAGE_FEATURES`. @@ -2612,10 +2656,6 @@ system and gives an overview of their function and contents. Specifies the signature algorithm used in creating the FIT Image. For e.g. rsa2048. - :term:`FIT_SIGN_NUMBITS` - Size of private key in number of bits used in fitImage. The default - value is "2048". - :term:`FIT_SIGN_INDIVIDUAL` If set to "1", then the :ref:`kernel-fitimage <ref-classes-kernel-fitimage>` class will sign the kernel, dtb and ramdisk images individually in addition @@ -2623,6 +2663,10 @@ system and gives an overview of their function and contents. intending to verify signatures in another context than booting via U-Boot. + :term:`FIT_SIGN_NUMBITS` + Size of private key in number of bits used in fitImage. The default + value is "2048". + :term:`FONT_EXTRA_RDEPENDS` When inheriting the :ref:`fontcache <ref-classes-fontcache>` class, this variable specifies the runtime dependencies for font packages. @@ -2819,6 +2863,10 @@ system and gives an overview of their function and contents. - Given a recipe being built for a little-endian MIPS target running Linux, the value might be "mipsel-linux". + :term:`HOST_VENDOR` + Specifies the name of the vendor. :term:`HOST_VENDOR` is normally the + same as :term:`TARGET_VENDOR`. + :term:`HOSTTOOLS` A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks. Using this @@ -2839,9 +2887,15 @@ system and gives an overview of their function and contents. :term:`HOSTTOOLS_NONFATAL` is not found on the build host. Thus, you can use :term:`HOSTTOOLS_NONFATAL` to filter optional host tools. - :term:`HOST_VENDOR` - Specifies the name of the vendor. :term:`HOST_VENDOR` is normally the - same as :term:`TARGET_VENDOR`. + :term:`ICECC_CLASS_DISABLE` + Identifies user classes that you do not want the Icecream distributed + compile support to consider. This variable is used by the + :ref:`icecc <ref-classes-icecc>` class. You set this variable in + your ``local.conf`` file. + + When you list classes using this variable, the recipes inheriting + those classes will not benefit from distributed compilation across + remote hosts. Instead they will be built locally. :term:`ICECC_DISABLED` Disables or enables the ``icecc`` (Icecream) function. For more @@ -2898,17 +2952,7 @@ system and gives an overview of their function and contents. this variable, the :ref:`icecc <ref-classes-icecc>` class attempts to define it by locating ``icecc`` using ``which``. - :term:`ICECC_USER_CLASS_BL` - Identifies user classes that you do not want the Icecream distributed - compile support to consider. This variable is used by the - :ref:`icecc <ref-classes-icecc>` class. You set this variable in - your ``local.conf`` file. - - When you list classes using this variable, the recipes inheriting - those classes will not benefit from distributed compilation across - remote hosts. Instead they will be built locally. - - :term:`ICECC_USER_PACKAGE_BL` + :term:`ICECC_RECIPE_DISABLE` Identifies user recipes that you do not want the Icecream distributed compile support to consider. This variable is used by the :ref:`icecc <ref-classes-icecc>` class. You set this variable in @@ -2918,7 +2962,7 @@ system and gives an overview of their function and contents. from distributed compilation across remote hosts. Instead they will be built locally. - :term:`ICECC_USER_PACKAGE_WL` + :term:`ICECC_RECIPE_ENABLE` Identifies user recipes that use an empty :term:`PARALLEL_MAKE` variable that you want to force remote distributed compilation on using the Icecream @@ -2930,40 +2974,6 @@ system and gives an overview of their function and contents. The base name of image output files. This variable defaults to the recipe name (``${``\ :term:`PN`\ ``}``). - :term:`IMAGE_EFI_BOOT_FILES` - A space-separated list of files installed into the boot partition - when preparing an image using the Wic tool with the - ``bootimg-efi`` source plugin. By default, - the files are - installed under the same name as the source files. To change the - installed name, separate it from the original name with a semi-colon - (;). Source files need to be located in - :term:`DEPLOY_DIR_IMAGE`. Here are two - examples:: - - IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE};bz2" - IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE} microcode.cpio" - - Alternatively, source files can be picked up using a glob pattern. In - this case, the destination file must have the same name as the base - name of the source file path. To install files into a directory - within the target location, pass its name after a semi-colon (;). - Here are two examples:: - - IMAGE_EFI_BOOT_FILES = "boot/loader/*" - IMAGE_EFI_BOOT_FILES = "boot/loader/*;boot/" - - The first example - installs all files from ``${DEPLOY_DIR_IMAGE}/boot/loader/`` - into the root of the target partition. The second example installs - the same files into a ``boot`` directory within the target partition. - - You can find information on how to use the Wic tool in the - ":ref:`dev-manual/common-tasks:creating partitioned images using wic`" - section of the Yocto Project Development Tasks Manual. Reference - material for Wic is located in the - ":doc:`/ref-manual/kickstart`" chapter. - :term:`IMAGE_BOOT_FILES` A space-separated list of files installed into the boot partition when preparing an image using the Wic tool with the @@ -3036,6 +3046,40 @@ system and gives an overview of their function and contents. device table files, see ``meta/files/device_table-minimal.txt`` as an example. + :term:`IMAGE_EFI_BOOT_FILES` + A space-separated list of files installed into the boot partition + when preparing an image using the Wic tool with the + ``bootimg-efi`` source plugin. By default, + the files are + installed under the same name as the source files. To change the + installed name, separate it from the original name with a semi-colon + (;). Source files need to be located in + :term:`DEPLOY_DIR_IMAGE`. Here are two + examples:: + + IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE};bz2" + IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE} microcode.cpio" + + Alternatively, source files can be picked up using a glob pattern. In + this case, the destination file must have the same name as the base + name of the source file path. To install files into a directory + within the target location, pass its name after a semi-colon (;). + Here are two examples:: + + IMAGE_EFI_BOOT_FILES = "boot/loader/*" + IMAGE_EFI_BOOT_FILES = "boot/loader/*;boot/" + + The first example + installs all files from ``${DEPLOY_DIR_IMAGE}/boot/loader/`` + into the root of the target partition. The second example installs + the same files into a ``boot`` directory within the target partition. + + You can find information on how to use the Wic tool in the + ":ref:`dev-manual/common-tasks:creating partitioned images using wic`" + section of the Yocto Project Development Tasks Manual. Reference + material for Wic is located in the + ":doc:`/ref-manual/kickstart`" chapter. + :term:`IMAGE_FEATURES` The primary list of features to include in an image. Typically, you configure this variable in an image recipe. Although you can use this @@ -3457,7 +3501,7 @@ system and gives an overview of their function and contents. This functionality is only regularly tested using the following setting:: - INCOMPATIBLE_LICENSE = "GPL-3.0 LGPL-3.0 AGPL-3.0" + INCOMPATIBLE_LICENSE = "GPL-3.0* LGPL-3.0* AGPL-3.0*" Although you can use other settings, you might be required to @@ -4348,9 +4392,9 @@ system and gives an overview of their function and contents. Here are some examples:: - LICENSE = "LGPLv2.1 | GPLv3" - LICENSE = "MPL-1 & LGPLv2.1" - LICENSE = "GPLv2+" + LICENSE = "LGPL-2.1-only | GPL-3.0-only" + LICENSE = "MPL-1.0 & LGPL-2.1-only" + LICENSE = "GPL-2.0-or-later" The first example is from the recipes for Qt, which the user may choose to distribute under either @@ -4365,8 +4409,8 @@ system and gives an overview of their function and contents. but has accompanying documentation licensed under the GNU Free Documentation License 1.2 could be specified as follows:: - LICENSE = "GFDL-1.2 & GPLv2" - LICENSE:${PN} = "GPLv2" + LICENSE = "GFDL-1.2 & GPL-2.0-only" + LICENSE:${PN} = "GPL-2.0.only" LICENSE:${PN}-doc = "GFDL-1.2" :term:`LICENSE_CREATE_PACKAGE` @@ -4394,7 +4438,7 @@ system and gives an overview of their function and contents. :term:`LICENSE_FLAGS` Specifies additional flags for a recipe you must allow through - :term:`LICENSE_FLAGS_WHITELIST` in + :term:`LICENSE_FLAGS_ACCEPTED` in order for the recipe to be built. When providing multiple flags, separate them with spaces. @@ -4405,7 +4449,7 @@ system and gives an overview of their function and contents. ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`" section in the Yocto Project Development Tasks Manual. - :term:`LICENSE_FLAGS_WHITELIST` + :term:`LICENSE_FLAGS_ACCEPTED` Lists license flags that when specified in :term:`LICENSE_FLAGS` within a recipe should not prevent that recipe from being built. For more information, see the @@ -5156,18 +5200,6 @@ system and gives an overview of their function and contents. ":ref:`dev-manual/common-tasks:debugging with the gnu project debugger (gdb) remotely`" section in the Yocto Project Development Tasks Manual. - :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` - Prevents specific packages from being installed when you are - installing complementary packages. - - You might find that you want to prevent installing certain packages - when you are installing complementary packages. For example, if you - are using :term:`IMAGE_FEATURES` to install - ``dev-pkgs``, you might not want to install all packages from a - particular multilib. If you find yourself in this situation, you can - use the :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` variable to specify regular - expressions to match the packages you want to exclude. - :term:`PACKAGE_EXCLUDE` Lists packages that should not be installed into an image. For example:: @@ -5195,6 +5227,18 @@ system and gives an overview of their function and contents. :term:`BAD_RECOMMENDATIONS` variables for related information. + :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` + Prevents specific packages from being installed when you are + installing complementary packages. + + You might find that you want to prevent installing certain packages + when you are installing complementary packages. For example, if you + are using :term:`IMAGE_FEATURES` to install + ``dev-pkgs``, you might not want to install all packages from a + particular multilib. If you find yourself in this situation, you can + use the :term:`PACKAGE_EXCLUDE_COMPLEMENTARY` variable to specify regular + expressions to match the packages you want to exclude. + :term:`PACKAGE_EXTRA_ARCHS` Specifies the list of architectures compatible with the device CPU. This variable is useful when you build for several different devices @@ -5588,12 +5632,24 @@ system and gives an overview of their function and contents. :term:`PE` is the default value of the :term:`PKGE` variable. + :term:`PEP517_WHEEL_PATH` + When used by recipes that inherit the + :ref:`python_pep517 <ref-classes-python_pep517>` class, + denotes the path to ``dist/`` (short for distribution) where the + binary archive ``wheel`` is built. + :term:`PF` Specifies the recipe or package name and includes all version and revision numbers (i.e. ``glibc-2.13-r20+svnr15508/`` and ``bash-4.2-r1/``). This variable is comprised of the following: ${:term:`PN`}-${:term:`EXTENDPE`}${:term:`PV`}-${:term:`PR`} + :term:`PIP_INSTALL_ARGS` + When used by recipes that inherit the + :ref:`python_pep517 <ref-classes-python_pep517>` class, + denotes the arguments passed to ``pip install`` to adjust the + behavior of how the ``wheel`` is installed. + :term:`PIXBUF_PACKAGES` When inheriting the :ref:`pixbufcache <ref-classes-pixbufcache>` class, this variable identifies packages that contain the pixbuf @@ -5700,18 +5756,6 @@ system and gives an overview of their function and contents. packages for the target and for Multilib, :term:`PN` would be ``bash`` and ``lib64-bash``, respectively. - :term:`PNBLACKLIST` - Lists recipes you do not want the OpenEmbedded build system to build. - This variable works in conjunction with the - :ref:`blacklist <ref-classes-blacklist>` class, which is inherited - globally. - - To prevent a recipe from being built, use the :term:`PNBLACKLIST` - variable in your ``local.conf`` file. Here is an example that - prevents ``myrecipe`` from being built:: - - PNBLACKLIST[myrecipe] = "Not supported by our organization." - :term:`POPULATE_SDK_POST_HOST_COMMAND` Specifies a list of functions to call once the OpenEmbedded build system has created the host part of the SDK. You can specify @@ -6023,8 +6067,7 @@ system and gives an overview of their function and contents. :term:`PYTHON_ABI` When used by recipes that inherit the - :ref:`distutils3 <ref-classes-distutils3>`, - :ref:`setuptools3 <ref-classes-setuptools3>` classes, denotes the + :ref:`setuptools3 <ref-classes-setuptools3>` class, denotes the Application Binary Interface (ABI) currently in use for Python. By default, the ABI is "m". You do not have to set this variable as the OpenEmbedded build system sets it for you. @@ -6033,14 +6076,9 @@ system and gives an overview of their function and contents. names used when installing the Python headers and libraries in sysroot (e.g. ``.../python3.3m/...``). - Recipes that inherit the :ref:`distutils3 <ref-classes-distutils3>` class during cross-builds also - use this variable to locate the headers and libraries of the - appropriate Python that the extension is targeting. - :term:`PYTHON_PN` When used by recipes that inherit the - `distutils3 <ref-classes-distutils3>`, - :ref:`setuptools3 <ref-classes-setuptools3>` classes, specifies the + :ref:`setuptools3 <ref-classes-setuptools3>` classe, specifies the major Python version being built. For Python 3.x, :term:`PYTHON_PN` would be "python3". You do not have to set this variable as the OpenEmbedded build system automatically sets it for you. @@ -6454,7 +6492,7 @@ system and gives an overview of their function and contents. from the default value of :term:`S`, you must set it specifically so the source can be located:: - SRC_URI = "git://path/to/repo.git" + SRC_URI = "git://path/to/repo.git;branch=main" S = "${WORKDIR}/git" :term:`SANITY_REQUIRED_UTILITIES` @@ -6559,68 +6597,6 @@ system and gives an overview of their function and contents. :term:`SDK_EXT_TYPE` is set to "minimal", and defaults to "1" if :term:`SDK_EXT_TYPE` is set to "full". - :term:`SDK_INHERIT_BLACKLIST` - A list of classes to remove from the :term:`INHERIT` - value globally within the extensible SDK configuration. The - :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the - default value:: - - SDK_INHERIT_BLACKLIST ?= "buildhistory icecc" - - Some classes are not generally applicable within the extensible SDK - context. You can use this variable to disable those classes. - - For additional information on how to customize the extensible SDK's - configuration, see the - ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" - section in the Yocto Project Application Development and the - Extensible Software Development Kit (eSDK) manual. - - :term:`SDK_LOCAL_CONF_BLACKLIST` - A list of variables not allowed through from the OpenEmbedded build - system configuration into the extensible SDK configuration. Usually, - these are variables that are specific to the machine on which the - build system is running and thus would be potentially problematic - within the extensible SDK. - - By default, :term:`SDK_LOCAL_CONF_BLACKLIST` is set in the - :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class and - excludes the following variables: - - - :term:`CONF_VERSION` - - :term:`BB_NUMBER_THREADS` - - :term:`BB_NUMBER_PARSE_THREADS` - - :term:`PARALLEL_MAKE` - - :term:`PRSERV_HOST` - - :term:`SSTATE_MIRRORS` :term:`DL_DIR` - - :term:`SSTATE_DIR` :term:`TMPDIR` - - :term:`BB_SERVER_TIMEOUT` - - For additional information on how to customize the extensible SDK's - configuration, see the - ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" - section in the Yocto Project Application Development and the - Extensible Software Development Kit (eSDK) manual. - - :term:`SDK_LOCAL_CONF_WHITELIST` - A list of variables allowed through from the OpenEmbedded build - system configuration into the extensible SDK configuration. By - default, the list of variables is empty and is set in the - :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class. - - This list overrides the variables specified using the - :term:`SDK_LOCAL_CONF_BLACKLIST` variable as well as - other variables automatically added due to the "/" character - being found at the start of the - value, which is usually indicative of being a path and thus might not - be valid on the system where the SDK is installed. - - For additional information on how to customize the extensible SDK's - configuration, see the - ":ref:`sdk-manual/appendix-customizing:configuring the extensible sdk`" - section in the Yocto Project Application Development and the - Extensible Software Development Kit (eSDK) manual. - :term:`SDK_NAME` The base name for SDK output files. The name is derived from the :term:`DISTRO`, :term:`TCLIBC`, @@ -6946,6 +6922,18 @@ system and gives an overview of their function and contents. SKIP_FILEDEPS = "1" + :term:`SKIP_RECIPE` + Used to prevent the OpenEmbedded build system from building a given + recipe. Specify the :term:`PN` value as a variable flag (``varflag``) + and provide a reason, which will be reported when attempting to + build the recipe. + + To prevent a recipe from being built, use the :term:`SKIP_RECIPE` + variable in your ``local.conf`` file or distribution configuration. + Here is an example which prevents ``myrecipe`` from being built:: + + SKIP_RECIPE[myrecipe] = "Not supported by our organization." + :term:`SOC_FAMILY` Groups together machines based upon the same family of SOC (System On Chip). You typically set this variable in a common ``.inc`` file that @@ -7505,14 +7493,14 @@ system and gives an overview of their function and contents. /sysroot-only \ " - :term:`SYSROOT_DIRS_BLACKLIST` + :term:`SYSROOT_DIRS_IGNORE` Directories that are not staged into the sysroot by the :ref:`ref-tasks-populate_sysroot` task. You can use this variable to exclude certain subdirectories of directories listed in :term:`SYSROOT_DIRS` from staging. By default, the following directories are not staged:: - SYSROOT_DIRS_BLACKLIST = " \ + SYSROOT_DIRS_IGNORE = " \ ${mandir} \ ${docdir} \ ${infodir} \ @@ -8425,7 +8413,7 @@ system and gives an overview of their function and contents. passes and uses "all" for the target during the U-Boot building process. - :term:`UNKNOWN_CONFIGURE_WHITELIST` + :term:`UNKNOWN_CONFIGURE_OPT_IGNORE` Specifies a list of options that, if reported by the configure script as being invalid, should not generate a warning during the :ref:`ref-tasks-configure` task. Normally, invalid @@ -8435,10 +8423,10 @@ system and gives an overview of their function and contents. However, there are common options that are passed to all configure scripts at a class level, but might not be valid for some configure scripts. Therefore warnings about these options are useless. - For these cases, the options are added to :term:`UNKNOWN_CONFIGURE_WHITELIST`. + For these cases, the options are added to :term:`UNKNOWN_CONFIGURE_OPT_IGNORE`. The configure arguments check that uses - :term:`UNKNOWN_CONFIGURE_WHITELIST` is part of the + :term:`UNKNOWN_CONFIGURE_OPT_IGNORE` is part of the :ref:`insane <ref-classes-insane>` class and is only enabled if the recipe inherits the :ref:`autotools <ref-classes-autotools>` class. @@ -8536,12 +8524,11 @@ system and gives an overview of their function and contents. :term:`USER_CLASSES` A list of classes to globally inherit. These classes are used by the - OpenEmbedded build system to enable extra features (e.g. - ``buildstats``, ``image-prelink``, and so forth). + OpenEmbedded build system to enable extra features. The default list is set in your ``local.conf`` file:: - USER_CLASSES ?= "buildstats image-prelink" + USER_CLASSES ?= "buildstats" For more information, see ``meta-poky/conf/local.conf.sample`` in the :term:`Source Directory`. diff --git a/poky/documentation/releases.rst b/poky/documentation/releases.rst index a8c6d2c9f9..247481f760 100644 --- a/poky/documentation/releases.rst +++ b/poky/documentation/releases.rst @@ -28,6 +28,7 @@ Release Series 3.3 (hardknott) - :yocto_docs:`3.3.2 Documentation </3.3.2>` - :yocto_docs:`3.3.3 Documentation </3.3.3>` - :yocto_docs:`3.3.4 Documentation </3.3.4>` +- :yocto_docs:`3.3.5 Documentation </3.3.5>` **************************** Release Series 3.1 (dunfell) @@ -48,6 +49,7 @@ Release Series 3.1 (dunfell) - :yocto_docs:`3.1.12 Documentation </3.1.12>` - :yocto_docs:`3.1.13 Documentation </3.1.13>` - :yocto_docs:`3.1.14 Documentation </3.1.14>` +- :yocto_docs:`3.1.15 Documentation </3.1.15>` ========================== Outdated Release Manuals diff --git a/poky/documentation/sdk-manual/appendix-customizing.rst b/poky/documentation/sdk-manual/appendix-customizing.rst index f8e56477f3..9a76cc59d6 100644 --- a/poky/documentation/sdk-manual/appendix-customizing.rst +++ b/poky/documentation/sdk-manual/appendix-customizing.rst @@ -21,7 +21,7 @@ build system applies them against ``local.conf`` and ``auto.conf``: specific to the :term:`Build Host`. - Variables listed in - :term:`SDK_LOCAL_CONF_BLACKLIST` + :term:`ESDK_LOCALCONF_REMOVE` are excluded. These variables are not allowed through from the OpenEmbedded build system configuration into the extensible SDK configuration. Typically, these variables are specific to the machine @@ -29,19 +29,19 @@ build system applies them against ``local.conf`` and ``auto.conf``: of the extensible SDK configuration. For a list of the variables excluded by default, see the - :term:`SDK_LOCAL_CONF_BLACKLIST` + :term:`ESDK_LOCALCONF_REMOVE` in the glossary of the Yocto Project Reference Manual. - Variables listed in - :term:`SDK_LOCAL_CONF_WHITELIST` + :term:`ESDK_LOCALCONF_ALLOW` are included. Including a variable in the value of - :term:`SDK_LOCAL_CONF_WHITELIST` overrides either of the previous two + :term:`ESDK_LOCALCONF_ALLOW` overrides either of the previous two filters. The default value is blank. - Classes inherited globally with :term:`INHERIT` that are listed in - :term:`SDK_INHERIT_BLACKLIST` - are disabled. Using :term:`SDK_INHERIT_BLACKLIST` to disable these + :term:`ESDK_CLASS_INHERIT_DISABLE` + are disabled. Using :term:`ESDK_CLASS_INHERIT_DISABLE` to disable these classes is the typical method to disable classes that are problematic or unnecessary in the SDK context. The default value disables the :ref:`buildhistory <ref-classes-buildhistory>` @@ -63,13 +63,13 @@ adjustments: - If your SDK configuration inherits additional classes using the :term:`INHERIT` variable and you do not need or want those classes enabled in the SDK, you can - disable them by adding them to the :term:`SDK_INHERIT_BLACKLIST` + disable them by adding them to the :term:`ESDK_CLASS_INHERIT_DISABLE` variable as described in the previous section. .. note:: The default value of - SDK_INHERIT_BLACKLIST + ESDK_CLASS_INHERIT_DISABLE is set using the "?=" operator. Consequently, you will need to either define the entire list by using the "=" operator, or you will need to append a value using either ":append" or the "+=" @@ -92,7 +92,7 @@ adjustments: - Disable the tasks if they are added by a class and you do not need the functionality the class provides in the extensible SDK. To - disable the tasks, add the class to the :term:`SDK_INHERIT_BLACKLIST` + disable the tasks, add the class to the :term:`ESDK_CLASS_INHERIT_DISABLE` variable as described in the previous section. - Generally, you want to have a shared state mirror set up so users of @@ -277,7 +277,7 @@ source, you need to do a number of things: configuration file. You can then pass the variable to the SDK by adding the following:: - SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" + ESDK_LOCALCONF_ALLOW = "SSTATE_MIRRORS" - Alternatively, if you just want to set the :term:`SSTATE_MIRRORS` variable's value for the SDK alone, create a diff --git a/poky/documentation/set_versions.py b/poky/documentation/set_versions.py new file mode 100755 index 0000000000..1ab946fe61 --- /dev/null +++ b/poky/documentation/set_versions.py @@ -0,0 +1,229 @@ +#!/usr/bin/env python3 +# +# Add version information to poky.yaml based upon current git branch/tags +# +# Copyright Linux Foundation +# Author: Richard Purdie <richard.purdie@linuxfoundation.org> +# +# SPDX-License-Identifier: MIT +# + + +import subprocess +import collections +import sys +import os +import itertools + +ourversion = None +if len(sys.argv) == 2: + ourversion = sys.argv[1] + +ourversion = None +if len(sys.argv) == 2: + ourversion = sys.argv[1] + +activereleases = ["honister", "hardknott", "gatesgarth", "dunfell", "zeus", "warrior"] +#devbranch = "langdale" +devbranch = "kirkstone" +ltsseries = ["kirkstone", "dunfell"] + +release_series = collections.OrderedDict() +#release_series["langdale"] = "4.1" +release_series["kirkstone"] = "4.0" +release_series["honister"] = "3.4" +release_series["hardknott"] = "3.3" +release_series["gatesgarth"] = "3.2" +release_series["dunfell"] = "3.1" +release_series["zeus"] = "3.0" +release_series["warrior"] = "2.7" +release_series["thud"] = "2.6" +release_series["sumo"] = "2.5" +release_series["rocko"] = "2.4" +release_series["pyro"] = "2.3" +release_series["morty"] = "2.2" +release_series["krogoth"] = "2.1" +release_series["jethro"] = "2.0" +release_series["jethro-pre"] = "1.9" +release_series["fido"] = "1.8" +release_series["dizzy"] = "1.7" +release_series["daisy"] = "1.6" +release_series["dora"] = "1.5" +release_series["dylan"] = "1.4" +release_series["danny"] = "1.3" +release_series["denzil"] = "1.2" +release_series["edison"] = "1.1" +release_series["bernard"] = "1.0" +release_series["laverne"] = "0.9" + + +# "langdale" : "2.2", +bitbake_mapping = { + "kirkstone" : "2.0", + "honister" : "1.52", + "hardknott" : "1.50", + "gatesgarth" : "1.48", + "dunfell" : "1.46", +} + +# 3.4 onwards doesn't have poky version +# Early 3.4 release docs do reference it though +poky_mapping = { + "3.4" : "26.0", + "3.3" : "25.0", + "3.2" : "24.0", + "3.1" : "23.0", +} + +ourseries = None +ourbranch = None +bitbakeversion = None +docconfver = None + +# Test tags exist and inform the user to fetch if not +try: + subprocess.run(["git", "show", "yocto-3.4.2"], capture_output=True, check=True) +except subprocess.CalledProcessError: + sys.exit("Please run 'git fetch --tags' before building the documentation") + +# Try and figure out what we are +tags = subprocess.run(["git", "tag", "--points-at", "HEAD"], capture_output=True, text=True).stdout +for t in tags.split(): + if t.startswith("yocto-"): + ourversion = t[6:] + +if ourversion: + # We're a tagged release + components = ourversion.split(".") + baseversion = components[0] + "." + components[1] + docconfver = ourversion + for i in release_series: + if release_series[i] == baseversion: + ourseries = i + ourbranch = i + if i in bitbake_mapping: + bitbakeversion = bitbake_mapping[i] +else: + # We're floating on a branch + branch = subprocess.run(["git", "branch", "--show-current"], capture_output=True, text=True).stdout.strip() + ourbranch = branch + if branch != "master" and branch not in release_series: + # We're not on a known release branch so we have to guess. Compare the numbers of commits + # from each release branch and assume the smallest number of commits is the one we're based off + possible_branch = None + branch_count = 0 + for b in itertools.chain(release_series.keys(), ["master"]): + result = subprocess.run(["git", "log", "--format=oneline", "HEAD..origin/" + b], capture_output=True, text=True) + if result.returncode == 0: + count = result.stdout.count('\n') + if not possible_branch or count < branch_count: + print("Branch %s has count %s" % (b, count)) + possible_branch = b + branch_count = count + if possible_branch: + branch = possible_branch + else: + branch = "master" + print("Nearest release branch estimated to be %s" % branch) + if branch == "master": + ourseries = devbranch + docconfver = "dev" + bitbakeversion = "" + elif branch in release_series: + ourseries = branch + if branch in bitbake_mapping: + bitbakeversion = bitbake_mapping[branch] + else: + sys.exit("Unknown series for branch %s" % branch) + + previoustags = subprocess.run(["git", "tag", "--merged", "HEAD"], capture_output=True, text=True).stdout + previoustags = [t[6:] for t in previoustags.split() if t.startswith("yocto-" + release_series[ourseries])] + futuretags = subprocess.run(["git", "tag", "--merged", ourbranch], capture_output=True, text=True).stdout + futuretags = [t[6:] for t in futuretags.split() if t.startswith("yocto-" + release_series[ourseries])] + + # Append .999 against the last known version + if len(previoustags) != len(futuretags): + ourversion = previoustags[-1] + ".999" + else: + ourversion = release_series[ourseries] + ".999" + if not docconfver: + docconfver = ourversion + +series = [k for k in release_series] +previousseries = series[series.index(ourseries)+1:] or [""] +lastlts = [k for k in previousseries if k in ltsseries] or "dunfell" + +print("Version calculated to be %s" % ourversion) +print("Release series calculated to be %s" % ourseries) + +replacements = { + "DISTRO" : ourversion, + "DISTRO_NAME_NO_CAP" : ourseries, + "DISTRO_NAME" : ourseries.capitalize(), + "DISTRO_NAME_NO_CAP_MINUS_ONE" : previousseries[0], + "DISTRO_NAME_NO_CAP_LTS" : lastlts[0], + "YOCTO_DOC_VERSION" : ourversion, + "DISTRO_REL_TAG" : "yocto-" + ourversion, + "DOCCONF_VERSION" : docconfver, + "BITBAKE_SERIES" : bitbakeversion, +} + +if release_series[ourseries] in poky_mapping: + pokyversion = poky_mapping[release_series[ourseries]] + if ourversion != release_series[ourseries]: + pokyversion = pokyversion + "." + ourversion.rsplit(".", 1)[1] + else: + pokyversion = pokyversion + ".0" + replacements["POKYVERSION"] = pokyversion + +if os.path.exists("poky.yaml.in"): + with open("poky.yaml.in", "r") as r, open("poky.yaml", "w") as w: + lines = r.readlines() + for line in lines: + data = line.split(":") + k = data[0].strip() + if k in replacements: + w.write("%s : \"%s\"\n" % (k, replacements[k])) + else: + w.write(line) + + print("poky.yaml generated from poky.yaml.in") + + +# In the switcher list of versions we display: +# - latest dev +# - latest stable release +# - latest LTS +# - latest for each releases listed as active +# - latest doc version in current series +# - current doc version +# (with duplicates removed) + +if ourseries not in activereleases: + activereleases.append(ourseries) + +versions = [] +with open("sphinx-static/switchers.js.in", "r") as r, open("sphinx-static/switchers.js", "w") as w: + lines = r.readlines() + for line in lines: + if "VERSIONS_PLACEHOLDER" in line: + w.write(" 'dev': 'dev (%s)',\n" % release_series[devbranch]) + for branch in activereleases: + if branch == devbranch: + continue + versions = subprocess.run('git tag --list yocto-%s*' % (release_series[branch]), shell=True, capture_output=True, text=True).stdout.split() + versions = sorted([v.replace("yocto-" + release_series[branch] + ".", "").replace("yocto-" + release_series[branch], "0") for v in versions], key=int) + if not versions: + continue + version = release_series[branch] + if versions[-1] != "0": + version = version + "." + versions[-1] + versions.append(version) + w.write(" '%s': '%s',\n" % (version, version)) + if ourversion not in versions and ourseries != devbranch: + w.write(" '%s': '%s',\n" % (ourversion, ourversion)) + else: + w.write(line) + +print("switchers.js generated from switchers.js.in") + diff --git a/poky/documentation/sphinx-static/switchers.js b/poky/documentation/sphinx-static/switchers.js.in index c4c3bd64c9..5d3a4d7935 100644 --- a/poky/documentation/sphinx-static/switchers.js +++ b/poky/documentation/sphinx-static/switchers.js.in @@ -10,13 +10,7 @@ by https://git.yoctoproject.org/yocto-autobuilder-helper/tree/scripts/run-docs-b 'use strict'; var all_versions = { - 'dev': 'dev (3.5)', - '3.4.2': '3.4.2', - '3.3.4': '3.3.4', - '3.2.4': '3.2.4', - '3.1.14': '3.1.14', - '3.0.4': '3.0.4', - '2.7.4': '2.7.4', + VERSIONS_PLACEHOLDER }; var all_doctypes = { |