Repository :
http://git.fedorahosted.org/cgit/docs/networking-guide.git
On branch : master
---------------------------------------------------------------
commit 876cd1419206004b0d32a0f064fef435ad254dcb
Author: Stephen Wadeley <swadeley(a)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">