From 3608380f2246ae4abd6202f56fdb8a09674a0165 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Tue, 19 Dec 2023 19:50:34 +0800
Subject: symlinks: Mention how to disable NIC alternative names assignment

Fixes #5394.
---
 chapter09/symlinks.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/chapter09/symlinks.xml b/chapter09/symlinks.xml
index 86528ba69..add956941 100644
--- a/chapter09/symlinks.xml
+++ b/chapter09/symlinks.xml
@@ -112,6 +112,19 @@
       proceeding, and be sure to use that <literal>NAME</literal> value when
       creating your network configuration files.</para>
 
+      <para>Even if the custom udev rule file is created, udev may still
+      assign one or more alternative names for a NIC based on physical
+      characteristics.  If a custom udev rule would rename another NIC using
+      a name already assigned as an alternative name of another NIC, this
+      udev rule will fail.  If this issue happens, you may create the
+      <filename>/etc/udev/network/99-default.link</filename> configuration
+      file with an empty alternative assignment policy, overriding the
+      default configuration file
+      <filename>/usr/lib/udev/network/99-default.link</filename>:</para>
+
+<screen role="nodump"><userinput>sed -e '/^AlternativeNamesPolicy/s/=.*$/=/'  \
+    -i /usr/lib/udev/network/99-default.link \
+     > /etc/udev/network/99-default.link</userinput></screen>
     </sect3>
 
   </sect2>
-- 
cgit v1.2.3-54-g00ecf