man: add an example to (re-)apply new settings to a network interface

[thirdparty/systemd.git] / man / systemd.link.xml

diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index 1aa93fb05e1f2fdae808fa1c616d0d61ad3d066e..546a6a006b20e1ba333f454abc71e307a31a98fd 100644 (file)
--- 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>