documentation/migration-guides/migration-2.3.rst

7 .. _migration-2.3-recipe-specific-sysroots:
9 Recipe-specific Sysroots
10 ------------------------
13 long-standing issues with configuration script auto-detection of
22 -  *Declare Build-Time Dependencies:* Because of this new feature, you
23    must explicitly declare all build-time dependencies for your recipe.
27 -  *Specify Pre-Installation and Post-Installation Native Tool
33    :ref:`ref-tasks-rootfs` task.
38    ``systemd-systemctl-native`` is added to :term:`PACKAGE_WRITE_DEPS`,
41 -  Examine Recipes that Use ``SSTATEPOSTINSTFUNCS``: You need to
50    post-installation script that is installed by a function added to
53 … For an example, see the :ref:`pixbufcache <ref-classes-pixbufcache>` class in ``meta/classes/`` in
54    the :ref:`overview-manual/development-environment:yocto project source repositories`.
70 -  *Specify the Sysroot when Using Certain External Scripts:* Because
72    ``oe-find-native-sysroot`` and ``oe-run-native`` have been changed
78    You can find more information on how recipe-specific sysroots work in
79    the ":ref:`ref-classes-staging`" section.
81 .. _migration-2.3-path-variable:
84 -----------------
89 directory containing symbolic links linking only to the binaries from
98 Alternatively, you can add a native recipe (i.e. ``-native``) that
109 .. _migration-2.3-scripts:
112 ------------------
116 -  ``oe-find-native-sysroot``: The usage for the
117    ``oe-find-native-sysroot`` script has changed to the following::
119       $ . oe-find-native-sysroot recipe
125 -  ``oe-run-native``: The usage for the ``oe-run-native`` script has
128       $ oe-run-native native_recipe tool
135 -  ``cleanup-workdir``: The ``cleanup-workdir`` script has been
142 -  ``wipe-sysroot``: The ``wipe-sysroot`` script has been removed as
143    it is no longer needed with recipe-specific sysroots.
145 .. _migration-2.3-functions:
148 --------------------
156 .. _migration-2.3-bitbake-changes:
159 ---------------
163 -  *BitBake's Graphical Dependency Explorer UI Replaced:* BitBake's
166    exploring the ``task-depends.dot`` file. The data presented by Task
170    size of the ``task-depends.dot`` file.
172 -  *BitBake "-g" Output Changes:* The ``package-depends.dot`` and
173    ``pn-depends.dot`` files as previously generated using the
174    ``bitbake -g`` command have been removed. A ``recipe-depends.dot``
175    file is now generated as a collapsed version of ``task-depends.dot``
178    The reason for this change is because ``package-depends.dot`` and
179    ``pn-depends.dot`` largely date back to a time before task-based
180    execution and do not take into account task-level dependencies
183 -  *Mirror Variable Splitting Changes:* Mirror variables including
191 -  *The Subversion (SVN) Fetcher Uses an "ssh" Parameter and Not an
197    variable during the :ref:`ref-tasks-fetch` task.
199 …See the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-fetching:subversion (svn) fetcher (…
203 -  ``BB_SETSCENE_VERIFY_FUNCTION`` and ``BB_SETSCENE_VERIFY_FUNCTION2``
205    necessary with recipe-specific sysroots, the
209 .. _migration-2.3-absolute-symlinks:
211 Absolute Symbolic Links
212 -----------------------
214 Absolute symbolic links (symlinks) within staged files are no longer
216 can use the ``lnr`` script, which is a replacement for ``ln -r``.
223 .. _migration-2.3-gplv2-and-gplv3-moves:
226 -------------------------------------
229 ``meta-gplv2`` layer.
234 ``meta-gplv2`` layer to your configuration.
238    You can ``find meta-gplv2`` layer in the OpenEmbedded layer index at
239    :oe_layer:`/meta-gplv2`.
251    The long-term solution might be to move to BSD-licensed replacements
252    of the GPLv3 components for those that need to exclude GPLv3-licensed
256 .. _migration-2.3-package-management-changes:
259 --------------------------
263 -  Smart package manager is replaced by DNF package manager. Smart has
268    The change in functionality is that the on-target runtime package
270    tool that has a different set of command-line options. If you have
272    fixed.
277 -  Rpm 5.x is replaced with Rpm 4.x. This is done for two major reasons:
279    -  DNF is API-incompatible with Rpm 5.x and porting it and
280       maintaining the port is non-trivial.
282    -  Rpm 5.x itself has limited maintenance upstream, and the Yocto
285 -  Berkeley DB 6.x is removed and Berkeley DB 5.x becomes the default:
287    -  Version 6.x of Berkeley DB has largely been rejected by the open
292    -  In OE-core, the only thing that was requiring DB 6.x was Rpm 5.x.
293       Thus, no reason exists to continue carrying DB 6.x in OE-core.
295 -  ``createrepo`` is replaced with ``createrepo_c``.
302 -  Architecture-independent RPM packages are "noarch" instead of "all".
306    tag has changed. Nothing else has changed in OE-core system,
307    particularly in the :ref:`ref-classes-allarch` class.
309 -  Signing of remote package feeds using ``PACKAGE_FEED_SIGN`` is not
315 -  OPKG now uses the libsolv backend for resolving package dependencies
316    by default. This is vastly superior to OPKG's internal ad-hoc solver
325 .. _migration-2.3-removed-recipes:
328 ---------------
332 -  ``linux-yocto 4.8``: Version 4.8 has been removed. Versions 4.1
335 -  ``python-smartpm``: Functionally replaced by ``dnf``.
337 -  ``createrepo``: Replaced by the ``createrepo-c`` recipe.
339 -  ``rpmresolve``: No longer needed with the move to RPM 4 as RPM
342 -  ``gstreamer``: Removed the GStreamer Git version recipes as they
345 -  ``alsa-conf-base``: Merged into ``alsa-conf`` since ``libasound``
349 -  ``tremor``: Moved to ``meta-multimedia``. Fixed-integer Vorbis
352    ``tremor`` recipe in :term:`OpenEmbedded-Core (OE-Core)`.
354 -  ``gummiboot``: Replaced by ``systemd-boot``.
356 .. _migration-2.3-wic-changes:
359 -----------
366    ":ref:`dev-manual/common-tasks:creating partitioned images using wic`"
369 -  *Default Output Directory Changed:* Wic's default output directory is
373    The ``-o`` and ``--outdir`` options remain unchanged and are used to
377 -  *fsimage Plug-in Removed:* The Wic fsimage plugin has been removed as
380 .. _migration-2.3-qa-changes:
383 ----------
387 -  ``unsafe-references-in-binaries``: The
388    ``unsafe-references-in-binaries`` QA check, which was disabled by
396    Consequently, ``unsafe-references-in-binaries`` was removed.
398 -  ``file-rdeps``: The ``file-rdeps`` QA check is now an error by
403    :ref:`insane <ref-classes-insane>` class and the
404    ":ref:`ref-manual/qa-checks:errors and warnings`" section.
406 .. _migration-2.3-miscellaneous-changes:
409 ---------------------
413 -  In this release, a number of recipes have been changed to ignore the
426 -  If the :term:`DISTRO_VERSION` value contains
432    ``base-files`` recipe is restored from shared state (sstate) rather
436    else in your image, a better method is to define a post-processing
439    Doing so ensures the value is always up-to-date with the created
442 -  Dropbear's ``init`` script now disables DSA host keys by default.
447 -  The :ref:`buildhistory <ref-classes-buildhistory>` class now
449    ``installed-package-sizes.txt`` in order to aid import into other
452 -  The ``USE_LDCONFIG`` variable has been replaced with the "ldconfig"
461 -  The default value of
471 -  Kernel module packages are now suffixed with the kernel version in
473    co-exist on a target system. If you wish to return to the previous
479 -  Removal of ``libtool`` ``*.la`` files is now enabled by default. The
486    "remove-libtool" is not included in the value.
488 -  Extensible SDKs built for GCC 5+ now refuse to install on a
492    the :ref:`uninative <ref-classes-uninative>` class for additional
495 -  All native and nativesdk recipes now use a separate
509 -  The ``FILESDIR`` variable, which was previously deprecated and rarely
513 -  The ``MULTIMACH_HOST_SYS`` variable has been removed as it is no
514    longer needed with recipe-specific sysroots.