[networking-guide] master: Move "Understanding the Device Renaming Procedure" (876cd14)
stephenw at fedoraproject.org
stephenw at fedoraproject.org
Mon Jul 28 21:11:36 UTC 2014
Repository : http://git.fedorahosted.org/cgit/docs/networking-guide.git
On branch : master
>---------------------------------------------------------------
commit 876cd1419206004b0d32a0f064fef435ad254dcb
Author: Stephen Wadeley <swadeley at redhat.com>
Date: Mon Jul 28 23:05:57 2014 +0200
Move "Understanding the Device Renaming Procedure"
Based on feedback from jskotka
>---------------------------------------------------------------
en-US/Consistent_Network_Device_Naming.xml | 58 ++++++++++++++-------------
1 files changed, 30 insertions(+), 28 deletions(-)
diff --git a/en-US/Consistent_Network_Device_Naming.xml b/en-US/Consistent_Network_Device_Naming.xml
index 498616e..4bba7cf 100644
--- a/en-US/Consistent_Network_Device_Naming.xml
+++ b/en-US/Consistent_Network_Device_Naming.xml
@@ -80,6 +80,35 @@ By default, <systemitem class="daemon">systemd</systemitem> will name interfaces
This policy, the procedure outlined above, is the default. If the system has <application>BIOSDEVNAME</application> enabled, it will take precedence. If the user has added <systemitem class="daemon">udevd</systemitem> rules which change the name of the kernel devices, those rules will take precedence too.
</para>
+ <section id="sec-Understanding_the_Device_Renaming_Procedure">
+ <title>Understanding the Device Renaming Procedure</title>
+<para>
+ The device name procedure in detail is as follows:
+</para>
+<procedure>
+ <step>
+ <para>
+ A rule in <filename>/usr/lib/udev/rules.d/60-net.rules</filename> instructs the <application>udev</application> helper utility, <application>/lib/udev/rename_device</application>, to look into all <filename>/etc/sysconfig/network-scripts/ifcfg-<replaceable>suffix</replaceable></filename> files. If it finds an <filename>ifcfg</filename> file with a <command>HWADDR</command> entry matching the MAC address of an interface it renames the interface to the name given in the <filename>ifcfg</filename> file by the <command>DEVICE</command> directive.
+ </para>
+ </step>
+ <step>
+ <para>
+ A rule in <filename>/usr/lib/udev/rules.d/71-biosdevname.rules</filename> instructs <application>biosdevname</application> to rename the interface according to its naming policy, provided that it was not renamed in a previous step, <application>biosdevname</application> is installed, and <command>biosdevname=0</command> was not given as a kernel command on the boot command line.
+ </para>
+ </step>
+ <step>
+ <para>
+ A rule in <filename>/lib/udev/rules.d/75-net-description.rules</filename> instructs <application>udev</application> to fill in ID_NET_NAME_ONBOARD, ID_NET_NAME_SLOT, ID_NET_NAME_PATH, ID_NET_NAME_MAC by examining the network interface device. Note, that some variables can be empty.
+ </para>
+ </step>
+ <step>
+ <para>
+ A rule in <filename>/usr/lib/udev/rules.d/80-net-name-slot.rules</filename> instructs <application>udev</application> to rename the interface, provided that it was not renamed in a previous step, and the kernel parameter <command>net.ifnames=0</command> was not given, according to the following priority: ID_NET_NAME_ONBOARD, ID_NET_NAME_SLOT, ID_NET_NAME_PATH. It falls through to the next in the list, if one is unset. If none of these are set, then the interface will not be renamed.
+ </para>
+ </step>
+</procedure>
+ </section>
+
<section id="sec-Understanding_the_Predictable_Network_Interface_Device_Names">
<title>Understanding the Predictable Network Interface Device Names</title>
<para>
@@ -335,34 +364,7 @@ The name provided by <systemitem class="daemon">systemd-udev</systemitem> will b
</variablelist>
</section>
- <section id="sec-Understanding_the_Device_Renaming_Procedure">
- <title>Understanding the Device Renaming Procedure</title>
-<para>
- The device name procedure in detail is as follows:
-</para>
-<procedure>
- <step>
- <para>
- A rule in <filename>/usr/lib/udev/rules.d/60-net.rules</filename> instructs the <application>udev</application> helper utility, <application>/lib/udev/rename_device</application>, to look into all <filename>/etc/sysconfig/network-scripts/ifcfg-<replaceable>suffix</replaceable></filename> files. If it finds an <filename>ifcfg</filename> file with a <command>HWADDR</command> entry matching the MAC address of an interface it renames the interface to the name given in the <filename>ifcfg</filename> file by the <command>DEVICE</command> directive.
- </para>
- </step>
- <step>
- <para>
- A rule in <filename>/usr/lib/udev/rules.d/71-biosdevname.rules</filename> instructs <application>biosdevname</application> to rename the interface according to its naming policy, provided that it was not renamed in a previous step, <application>biosdevname</application> is installed, and <command>biosdevname=0</command> was not given as a kernel command on the boot command line.
- </para>
- </step>
- <step>
- <para>
- A rule in <filename>/lib/udev/rules.d/75-net-description.rules</filename> instructs <application>udev</application> to fill in ID_NET_NAME_ONBOARD, ID_NET_NAME_SLOT, ID_NET_NAME_PATH, ID_NET_NAME_MAC by examining the network interface device. Note, that some variables can be empty.
- </para>
- </step>
- <step>
- <para>
- A rule in <filename>/usr/lib/udev/rules.d/80-net-name-slot.rules</filename> instructs <application>udev</application> to rename the interface, provided that it was not renamed in a previous step, and the kernel parameter <command>net.ifnames=0</command> was not given, according to the following priority: ID_NET_NAME_ONBOARD, ID_NET_NAME_SLOT, ID_NET_NAME_PATH. It falls through to the next in the list, if one is unset. If none of these are set, then the interface will not be renamed.
- </para>
- </step>
-</procedure>
- </section>
+
<!-- "Topics, Tasks" section -->
<section id="sec-Disabling_sec-Consistent_Network_Device_Naming">
More information about the docs-commits
mailing list