documentation/migration-guides/migration-2.2.rst

7 .. _migration-2.2-minimum-kernel-version:
10 ----------------------
14 AArch64-based targets the version is 3.14. For Nios II-based targets,
22 .. _migration-2.2-staging-directories-in-sysroot-simplified:
25 --------------------------------------------------
31 :oe_lists:`v2 patch series on the OE-Core Mailing List
32 </pipermail/openembedded-core/2016-May/121365.html>`
35 .. _migration-2.2-removal-of-old-images-from-tmp-deploy-now-enabled:
38 -------------------------------------------------------------------
44 .. _migration-2.2-python-changes:
47 --------------
51 .. _migration-2.2-bitbake-now-requires-python-3.4:
58 .. _migration-2.2-utf-8-locale-required-on-build-host:
60 UTF-8 Locale Required on Build Host
63 A UTF-8 locale is required on the build host due to Python 3. Since
64 C.UTF-8 is not a standard, the default is en_US.UTF-8.
66 .. _migration-2.2-metadata-now-must-use-python-3-syntax:
74 you can use :term:`OpenEmbedded-Core (OE-Core)` as a guide for changes. Following are
77   - subprocess command-line pipes needing locale decoding
79   - the syntax for octal values changed
81   - the ``iter*()`` functions changed name
83   - iterators now return views, not lists
85   - changed names for Python modules
87 .. _migration-2.2-target-python-recipes-switched-to-python-3:
94 online package-manager support through SMART still require Python 2.
101 .. _migration-2.2-buildtools-tarball-includes-python-3:
103 ``buildtools-tarball`` Includes Python 3
106 ``buildtools-tarball`` now includes Python 3.
108 .. _migration-2.2-uclibc-replaced-by-musl:
111 -----------------------
117 .. _migration-2.2-B-no-longer-default-working-directory-for-tasks:
120 ------------------------------------------------------
125 ``[``\ :ref:`dirs <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]``…
135 .. _migration-2.2-runqemu-ported-to-python:
138 ----------------------------
149    image-name-machine.qemuboot.conf
152 enables fine-grained tuning of options passed to QEMU without the
153 ``runqemu`` script hard-coding any knowledge about different machines.
156 :term:`OpenEmbedded-Core (OE-Core)`. The ``qemuboot.conf`` file is generated by the
168   - qemuarm
169   - qemuarm64
170   - qemux86
171   - qemux86-64
172   - qemuppc
173   - qemumips
174   - qemumips64
175   - qemumipsel
176   - qemumips64el
179 following example, which uses the ``qemux86-64`` machine, provides a
182 …$ runqemu qemux86-64 tmp/deploy/images/qemux86-64/core-image-minimal-qemux86-64.ext4 tmp/deploy/im…
193    QB_SYSTEM_NAME: QEMU name (e.g. "qemu-system-i386")
194    QB_OPT_APPEND: Options to append to QEMU (e.g. "-show-cursor")
197    QB_MEM: Memory (e.g. "-m 512")
198    QB_MACHINE: QEMU machine (e.g. "-machine virt")
199    QB_CPU: QEMU cpu (e.g. "-cpu qemu32")
200    QB_CPU_KVM: Similar to QB_CPU except used for kvm support (e.g. "-cpu kvm64")
201    QB_KERNEL_CMDLINE_APPEND: Options to append to the kernel's -append
205    QB_AUDIO_OPT: QEMU audio option (e.g. "-soundhw ac97,es1370"), which is used
209 … "-netdev tap,id=net0,ifname=@TAP@,script=no,downscript=no -device virtio-net-device,netdev=net0").
211 …QB_SLIRP_OPT: Network option for SLIRP mode (e.g. "-netdev user,id=net0 -device virtio-net-device,…
213 …         "-drive id=disk0,file=@ROOTFS@,if=none,format=raw -device virtio-blk-device,drive=disk0").
215                   core-image-minimal-qemuarm64.ext4.
216    QB_SERIAL_OPT: Serial port (e.g. "-serial mon:stdio")
218 …" -device virtio-serial-device -chardev socket,id=virtcon,port=@PORT@,host=127.0.0.1 -device      …
226    For command-line syntax, use ``runqemu help``.
232 .. _migration-2.2-default-linker-hash-style-changed:
235 ---------------------------------
237 The default linker hash style for ``gcc-cross`` is now "sysv" in order
249 .. _migration-2.2-kernel-image-base-name-no-longer-uses-kernel-imagetype:
252 --------------------------------------------------------------
260    KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
266 .. _migration-2.2-imgdeploydir-replaces-deploy-dir-image-for-most-use-cases:
269 -----------------------------------------------------------------
271 The :term:`IMGDEPLOYDIR` variable was introduced to allow sstate caching of
277 .. _migration-2.2-bitbake-changes:
280 ---------------
284 -  The "goggle" UI and standalone image-writer tool have been removed as
287 -  The Perforce fetcher now supports :term:`SRCREV` for
292    change is more in-line with how the other fetchers work for source
297 -  Some of BitBake's internal code structures for accessing the recipe
298    cache needed to be changed to support the new multi-configuration
301    changes made to the scripts supplied with OpenEmbedded-Core:
306 -  The task management code has been rewritten to avoid using ID
313    suitably written metadata, which includes OpenEmbedded-Core and Poky.
317 .. _migration-2.2-swabber-has-been-removed:
320 ------------------------
329 .. _migration-2.2-removed-recipes:
332 ---------------
336 -  ``augeas``: No longer needed and has been moved to ``meta-oe``.
338 -  ``directfb``: Unmaintained and has been moved to ``meta-oe``.
340 -  ``gcc``: Removed 4.9 version. Versions 5.4 and 6.2 are still present.
342 -  ``gnome-doc-utils``: No longer needed.
344 -  ``gtk-doc-stub``: Replaced by ``gtk-doc``.
346 -  ``gtk-engines``: No longer needed and has been moved to
347    ``meta-gnome``.
349 -  ``gtk-sato-engine``: Became obsolete.
351 -  ``libglade``: No longer needed and has been moved to ``meta-oe``.
353 -  ``libmad``: Unmaintained and functionally replaced by ``libmpg123``.
354    ``libmad`` has been moved to ``meta-oe``.
356 -  ``libowl``: Became obsolete.
358 -  ``libxsettings-client``: No longer needed.
360 -  ``oh-puzzles``: Functionally replaced by ``puzzles``.
362 -  ``oprofileui``: Became obsolete. OProfile has been largely supplanted
365 -  ``packagegroup-core-directfb.bb``: Removed.
367 -  ``core-image-directfb.bb``: Removed.
369 -  ``pointercal``: No longer needed and has been moved to ``meta-oe``.
371 -  ``python-imaging``: No longer needed and moved to ``meta-python``
373 -  ``python-pyrex``: No longer needed and moved to ``meta-python``.
375 -  ``sato-icon-theme``: Became obsolete.
377 -  ``swabber-native``: Swabber has been removed. See the :ref:`entry on
378    Swabber <migration-guides/migration-2.2:swabber has been removed>`.
380 -  ``tslib``: No longer needed and has been moved to ``meta-oe``.
382 -  ``uclibc``: Removed in favor of musl.
384 -  ``xtscal``: No longer needed and moved to ``meta-oe``
386 .. _migration-2.2-removed-classes:
389 ---------------
393 -  ``distutils-native-base``: No longer needed.
395 -  ``distutils3-native-base``: No longer needed.
397 -  ``sdl``: Only set :term:`DEPENDS` and
401 -  ``sip``: Mostly unused.
403 -  ``swabber``: See the :ref:`entry on
404    Swabber <migration-guides/migration-2.2:swabber has been removed>`.
406 .. _migration-2.2-minor-packaging-changes:
409 -----------------------
413 -  ``grub``: Split ``grub-editenv`` into its own package.
415 -  ``systemd``: Split container and vm related units into a new package,
416    systemd-container.
418 -  ``util-linux``: Moved ``prlimit`` to a separate
419    ``util-linux-prlimit`` package.
421 .. _migration-2.2-miscellaneous-changes:
424 ---------------------
428 -  ``package_regex.inc``: Removed because the definitions
432 -  Both ``devtool add`` and ``recipetool create`` now use a fixed
436    ``-a`` or ``--autorev`` command-line option
438 -  ``distcc``: GTK+ UI is now disabled by default.
440 -  ``packagegroup-core-tools-testapps``: Removed Piglit.
442 -  :ref:`ref-classes-image`: Renamed COMPRESS(ION) to CONVERSION. This change
447    does not need to be backwards-compatible should be changed to use the
451 -  ``gtk-doc``: A full version of ``gtk-doc`` is now made available.
453    version of ``gtk-doc`` to build documentation. You need to change
455    building documentation with ``gtk-doc``.