[networking-guide] master: Add: Naming Scheme for VLAN Interfaces (0bc9a06)

[stephenw at fedoraproject.org]

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

On branch  : master

>---------------------------------------------------------------

commit 0bc9a06e835209106507f5b11984cd3a0eb55f95
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Mon Jul 28 23:11:11 2014 +0200

    Add: Naming Scheme for VLAN Interfaces


>---------------------------------------------------------------

 en-US/Consistent_Network_Device_Naming.xml |   48 ++++++++++++++++++++++++++++
 1 files changed, 48 insertions(+), 0 deletions(-)

diff --git a/en-US/Consistent_Network_Device_Naming.xml b/en-US/Consistent_Network_Device_Naming.xml
index 481d783..1e75ba5 100644
--- a/en-US/Consistent_Network_Device_Naming.xml
+++ b/en-US/Consistent_Network_Device_Naming.xml
@@ -235,6 +235,54 @@ Use the <command>znetconf -c</command> command or the <command>lscss -a</command
        </table>
    </section>
 
+   <section id="sec-Naming_Scheme_for_VLAN_Interfaces">
+   <title>Naming Scheme for VLAN Interfaces</title>
+   <para>
+   Traditionally, VLAN interface names in the format: <replaceable>interface-name</replaceable>.<replaceable>VLAN-ID</replaceable> are used. The <literal>VLAN-ID</literal> ranges from <literal>0</literal> to <literal>4096</literal>, which is a maximum of four characters and the total interface name has a limit of 15 characters. The maximum interface name length is defined by the kernel headers and is a global limit, affecting all applications.
+   </para>
+
+   <para>
+   In Fedora, four naming conventions for VLAN interface names are supported:
+   </para>
+<variablelist>
+
+    <varlistentry>
+       <term>VLAN plus VLAN ID <!--vlan=VLAN_PLUS_VID--></term>
+    <listitem>
+    <para>
+       The word <literal>vlan</literal> plus the VLAN ID. For example: vlan0005
+    </para>
+    </listitem>
+  </varlistentry>
+      <varlistentry>
+        <term>VLAN plus VLAN ID without padding<!--vlan=VLAN_PLUS_VID_NO_PAD--></term>
+    <listitem>
+      <para>
+The word <literal>vlan</literal> plus the VLAN ID with out padding by means of an additional two zeros. For example: vlan5
+      </para>
+    </listitem>
+  </varlistentry>
+      <varlistentry>
+        <term>Device name plus VLAN ID<!--vlan=DEV_PLUS_VID--></term>
+    <listitem>
+      <para>
+The name of the parent interface plus the VLAN ID. For example: eth0.0005
+      </para>
+    </listitem>
+  </varlistentry>
+     <varlistentry>
+        <term>Device name plus VLAN ID without padding<!--vlan=DEV_PLUS_VID_NO_PAD--></term>
+    <listitem>
+      <para>
+The name of the parent interface plus the VLAN ID with out padding by means of an additional two zeros. For example: eth0.05
+      </para>
+    </listitem>
+  </varlistentry>
+</variablelist>
+
+
+   </section>
+
   <section id="sec-Consistent_Network_Device_Naming_Using_biosdevname">
     <title>Consistent Network Device Naming Using biosdevname</title>
     <para>