From 9b7f499ff145b54d42ad8b32cf2ab27cf23cb401 Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Sat, 4 Mar 2023 14:33:10 +0900
Subject: [PATCH 1/2] man: sync the default .link file in example

---
 man/systemd.link.xml | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index aad3736c36..1aa93fb05e 100644
--- a/man/systemd.link.xml
+++ b/man/systemd.link.xml
@@ -1111,12 +1111,15 @@
     <example>
       <title>/usr/lib/systemd/network/99-default.link</title>
 
-      <para>The link file <filename>99-default.link</filename> that is
-      shipped with systemd defines the default naming policy for
-      links.</para>
+      <para>The link file <filename>99-default.link</filename> that is shipped with systemd defines the
+      default policies for the interface name, alternative names, and MAC address of links.</para>
 
-      <programlisting>[Link]
-NamePolicy=kernel database on-board slot path
+      <programlisting>[Match]
+OriginalName=*
+
+[Link]
+NamePolicy=keep kernel database onboard slot path
+AlternativeNamesPolicy=database onboard slot path
 MACAddressPolicy=persistent</programlisting>
     </example>
 
@@ -1134,7 +1137,7 @@ Name=dmz0</programlisting>
 
       <para><varname>NamePolicy=</varname> is not set, so <varname>Name=</varname> takes effect. We use the
       <literal>10-</literal> prefix to order this file early in the list. Note that it needs to be before
-      <literal>99-link</literal>, i.e. it needs a numerical prefix, to have any effect at all.</para>
+      <filename>99-default.link</filename>, i.e. it needs a numerical prefix, to have any effect at all.</para>
     </example>
 
     <example>

From 181d719542fb00ec4cc25d7f857cf82dae8e961f Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Sat, 4 Mar 2023 14:57:10 +0900
Subject: [PATCH 2/2] man: add an example to (re-)apply new settings to a
 network interface

Closes #26601.
---
 man/systemd.link.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index 1aa93fb05e..546a6a006b 100644
--- a/man/systemd.link.xml
+++ b/man/systemd.link.xml
@@ -1140,6 +1140,23 @@ Name=dmz0</programlisting>
       <filename>99-default.link</filename>, i.e. it needs a numerical prefix, to have any effect at all.</para>
     </example>
 
+    <example>
+      <title>(Re-)applying a .link file to an interface</title>
+
+      <para>After a new .link file has been created, or an exisiting .link file modified, the new settings
+      may be applied to the matching interface with the following commands:</para>
+
+      <programlisting>$ sudo udevadm control --reload
+$ sudo ip link set eth0 down
+$ sudo udevadm trigger --verbose --settle --action add /sys/class/net/eth0</programlisting>
+
+      <para>You may also need to stop the service that manages the network interface, e.g.
+      <filename>systemd-networkd.service</filename> or <filename>NetworkManager.service</filename> before
+      the above operation, and then restart the service after that. For more details about
+      <command>udevadm</command> command, see
+      <citerefentry><refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
+    </example>
+
     <example>
       <title>Debugging <varname>NamePolicy=</varname> assignments</title>