migration-guides/migration-5.3.rst: add note on systemd pni-names change

Add a migration note on the pni-names default policy change after commit
9b34a810496f ("systemd: stop enabling non-standard "mac" policy when
using the 'pni-names' DISTRO_FEATURE") in OE-Core.

Cc: Koen Kooi <koen.kooi@oss.qualcomm.com>
Cc: Ross Burton <Ross.Burton@arm.com>
Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: 237f28de0bf8d1e1be60a0d9429b3a98740778e9)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Antonin Godard
2025-09-12 15:56:59 +02:00
committed by Richard Purdie
parent ef5c17601a
commit 8fecfe98c9

View File

@@ -118,6 +118,22 @@ class. Instead, one should create a new recipe to build this FIT image, as
described in the :ref:`Removed Classes <migration-guides/migration-5.3:Removed
Classes>` section of the Migration notes for |yocto-ver| (|yocto-codename|).
systemd Predictable Interface Names no longer MAC policy by default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The :oe_git:`systemd recipe </openembedded-core/tree/meta/recipes-core/systemd>`
used to forcibly set the "mac" policy by default when the ``pni-names``
:term:`distro feature <DISTRO_FEATURES>` is enabled.
This is no longer the case as this was not following upstream changes. Now when
the ``pni-names`` :term:`distro feature <DISTRO_FEATURES>` is enabled, the
default policy from systemd is selected (from
https://github.com/systemd/systemd/blob/v257.8/network/99-default.link).
To set back the "mac" policy in systemd (version 257.8 at the time of writing
this note), you should set the ``NamePolicy`` and ``AlternativeNamesPolicy`` as
detailed in :manpage:`systemd.link(5)`.
Supported kernel versions
~~~~~~~~~~~~~~~~~~~~~~~~~