[PATCH] migration-guides/{migration,release-notes}-5.2.rst: notes for systemd pni-names

[PATCH] migration-guides/{migration,release-notes}-5.2.rst: notes for systemd pni-names

[Antonin Godard]

Add a note to the migration guide regarding the pni-names behavior
change.

Suggested-by: Enrico Jörns <ejo@pengutronix.de>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/migration-guides/migration-5.2.rst     | 7 +++++++
 documentation/migration-guides/release-notes-5.2.rst | 7 ++++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/documentation/migration-guides/migration-5.2.rst b/documentation/migration-guides/migration-5.2.rst
index 6b7d02d65..9df04d291 100644
--- a/documentation/migration-guides/migration-5.2.rst
+++ b/documentation/migration-guides/migration-5.2.rst
@@ -104,6 +104,13 @@ systemd changes
    ``journald.conf`` to "persistent". The ``/var/log/journal`` directory is now
    used for logging instead of ``/run/log``.
 
+-  If ``pni-names`` is not in the :term:`DISTRO_FEATURES`, the `Predictable
+   Network Interface names <https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/>`__
+   systemd feature will now be disabled. Previously the feature was still
+   enabled even if ``pni-names`` was part of :term:`DISTRO_FEATURES`. Make
+   sure to add the feature to :term:`DISTRO_FEATURES` if you want to keep this
+   systemd behavior.
+
 Multiconfig changes
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/documentation/migration-guides/release-notes-5.2.rst b/documentation/migration-guides/release-notes-5.2.rst
index ac9c6319a..0ac276c1e 100644
--- a/documentation/migration-guides/release-notes-5.2.rst
+++ b/documentation/migration-guides/release-notes-5.2.rst
@@ -523,9 +523,10 @@ New Features / Enhancements in |yocto-ver|
          ``${libdir}`` if the ``set-time-epoch`` :term:`PACKAGECONFIG` config is
          set.
 
-      -  really disable Predictable Network Interface names if the ``pni-names``
-         feature is not part of :term:`DISTRO_FEATURES`. Previously it was only
-         really disable for QEMU machines.
+      -  really disable `Predictable Network Interface names
+         <https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/>`__
+         if the ``pni-names`` feature is not part of :term:`DISTRO_FEATURES`.
+         Previously it was only really disabled for QEMU machines.
 
       -  split ``networkd`` into its own package named ``systemd-networkd``.
 

---
base-commit: 1ed64dbdf4a60b000305cdc2c67dc24f4bc97ef7
change-id: 20250415-systemd-migration-note-36e893cced28

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

Re: [docs] [PATCH] migration-guides/{migration,release-notes}-5.2.rst: notes for systemd pni-names

[Daniel Ammann]

Hello Antonin

On 4/15/25 14:41, Antonin Godard via lists.yoctoproject.org wrote:
> Add a note to the migration guide regarding the pni-names behavior
> change.
> 
> Suggested-by: Enrico Jörns <ejo@pengutronix.de>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/migration-guides/migration-5.2.rst     | 7 +++++++
>   documentation/migration-guides/release-notes-5.2.rst | 7 ++++---
>   2 files changed, 11 insertions(+), 3 deletions(-)
> 
> diff --git a/documentation/migration-guides/migration-5.2.rst b/documentation/migration-guides/migration-5.2.rst
> index 6b7d02d65..9df04d291 100644
> --- a/documentation/migration-guides/migration-5.2.rst
> +++ b/documentation/migration-guides/migration-5.2.rst
> @@ -104,6 +104,13 @@ systemd changes
>      ``journald.conf`` to "persistent". The ``/var/log/journal`` directory is now
>      used for logging instead of ``/run/log``.
>   
> +-  If ``pni-names`` is not in the :term:`DISTRO_FEATURES`, the `Predictable
> +   Network Interface names <https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/>`__
> +   systemd feature will now be disabled. Previously the feature was still
> +   enabled even if ``pni-names`` was part of :term:`DISTRO_FEATURES`. Make

Shouldn't this be "was *not* part of"?

> +   sure to add the feature to :term:`DISTRO_FEATURES` if you want to keep this
> +   systemd behavior.
> +
>   Multiconfig changes
>   ~~~~~~~~~~~~~~~~~~~
>   
> diff --git a/documentation/migration-guides/release-notes-5.2.rst b/documentation/migration-guides/release-notes-5.2.rst
> index ac9c6319a..0ac276c1e 100644
> --- a/documentation/migration-guides/release-notes-5.2.rst
> +++ b/documentation/migration-guides/release-notes-5.2.rst
> @@ -523,9 +523,10 @@ New Features / Enhancements in |yocto-ver|
>            ``${libdir}`` if the ``set-time-epoch`` :term:`PACKAGECONFIG` config is
>            set.
>   
> -      -  really disable Predictable Network Interface names if the ``pni-names``
> -         feature is not part of :term:`DISTRO_FEATURES`. Previously it was only
> -         really disable for QEMU machines.
> +      -  really disable `Predictable Network Interface names
> +         <https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/>`__
> +         if the ``pni-names`` feature is not part of :term:`DISTRO_FEATURES`.
> +         Previously it was only really disabled for QEMU machines.
>   
>         -  split ``networkd`` into its own package named ``systemd-networkd``.
>   
> 
> ---
> base-commit: 1ed64dbdf4a60b000305cdc2c67dc24f4bc97ef7
> change-id: 20250415-systemd-migration-note-36e893cced28
> 
> Best regards,
> --
> Antonin Godard <antonin.godard@bootlin.com>
> 
> 
> 
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#6746): https://lists.yoctoproject.org/g/docs/message/6746
> Mute This Topic: https://lists.yoctoproject.org/mt/112275153/3616718
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [daniel.ammann@bytesatwork.ch]
> -=-=-=-=-=-=-=-=-=-=-=-
> 

Kind regards, Daniel

Re: [docs] [PATCH] migration-guides/{migration,release-notes}-5.2.rst: notes for systemd pni-names

[Antonin Godard]

Hi Daniel,

On Tue Apr 15, 2025 at 3:18 PM CEST, Daniel Ammann wrote:
> Hello Antonin
>
> On 4/15/25 14:41, Antonin Godard via lists.yoctoproject.org wrote:
>> Add a note to the migration guide regarding the pni-names behavior
>> change.
>> 
>> Suggested-by: Enrico Jörns <ejo@pengutronix.de>
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/migration-guides/migration-5.2.rst     | 7 +++++++
>>   documentation/migration-guides/release-notes-5.2.rst | 7 ++++---
>>   2 files changed, 11 insertions(+), 3 deletions(-)
>> 
>> diff --git a/documentation/migration-guides/migration-5.2.rst b/documentation/migration-guides/migration-5.2.rst
>> index 6b7d02d65..9df04d291 100644
>> --- a/documentation/migration-guides/migration-5.2.rst
>> +++ b/documentation/migration-guides/migration-5.2.rst
>> @@ -104,6 +104,13 @@ systemd changes
>>      ``journald.conf`` to "persistent". The ``/var/log/journal`` directory is now
>>      used for logging instead of ``/run/log``.
>>   
>> +-  If ``pni-names`` is not in the :term:`DISTRO_FEATURES`, the `Predictable
>> +   Network Interface names <https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/>`__
>> +   systemd feature will now be disabled. Previously the feature was still
>> +   enabled even if ``pni-names`` was part of :term:`DISTRO_FEATURES`. Make
>
> Shouldn't this be "was *not* part of"?

Well spotted, thanks.

Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com