From 8fecfe98c93e62532a3f8c99a00ad195aa8ffbde Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Fri, 12 Sep 2025 15:56:59 +0200 Subject: 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 Cc: Ross Burton Reviewed-by: Quentin Schulz (From yocto-docs rev: 237f28de0bf8d1e1be60a0d9429b3a98740778e9) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie --- documentation/migration-guides/migration-5.3.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/documentation/migration-guides/migration-5.3.rst b/documentation/migration-guides/migration-5.3.rst index 1b767374d5..748e51bb67 100644 --- a/documentation/migration-guides/migration-5.3.rst +++ b/documentation/migration-guides/migration-5.3.rst @@ -118,6 +118,22 @@ class. Instead, one should create a new recipe to build this FIT image, as described in the :ref:`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 ` +used to forcibly set the "mac" policy by default when the ``pni-names`` +:term:`distro feature ` is enabled. + +This is no longer the case as this was not following upstream changes. Now when +the ``pni-names`` :term:`distro feature ` 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 ~~~~~~~~~~~~~~~~~~~~~~~~~ -- cgit v1.2.3-54-g00ecf