diff mbox series

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

Message ID 20250912-systemd-pni-names-v2-1-2615197df69f@bootlin.com
State Under Review
Headers show
Series [v2] migration-guides/migration-5.3.rst: add note on systemd pni-names change | expand

Commit Message

Antonin Godard Sept. 12, 2025, 1:56 p.m. UTC 
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>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v2:
- Suggested by Quentin Schulz: simplify note on how to revert to the mac
  policy, and mention the systemd version at the time of writing the
  note.
- Link to v1: https://lore.kernel.org/r/20250909-systemd-pni-names-v1-1-efb2fef7aaf8@bootlin.com
---
 documentation/migration-guides/migration-5.3.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)


---
base-commit: ee0b46bd074dd34c3d6b401e65d2c519c2c3d47b
change-id: 20250904-systemd-pni-names-a9e6c45602c9

Best regards,
--  
Antonin Godard <antonin.godard@bootlin.com>

Comments

Quentin Schulz Sept. 12, 2025, 2:22 p.m. UTC | #1 
Hi Antonin,

On 9/12/25 3:56 PM, Antonin Godard wrote:
> 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>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

Thanks!
Quentin
diff mbox series

Patch

diff --git a/documentation/migration-guides/migration-5.3.rst b/documentation/migration-guides/migration-5.3.rst
index 2d2f8d91a..cca93cbb3 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 <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
 ~~~~~~~~~~~~~~~~~~~~~~~~~