[networking-guide] master: Move "Understanding the Device Renaming Procedure" (876cd14)

[stephenw]

Repository : http://git.fedorahosted.org/cgit/docs/networking-guide.git

On branch  : master

> ---------------------------------------------------------------
commit 876cd1419206004b0d32a0f064fef435ad254dcb
Author: Stephen Wadeley <swadeley(a)redhat.com&gt;
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">