From bd8c3d62141876c948c0021816d8a8791c6a1231 Mon Sep 17 00:00:00 2001
From: Stephen Wadeley <swadeley@redhat.com>
Date: Dec 13 2012 14:28:46 +0000
Subject: Adding section on Ethtool.


---

diff --git a/en-US/Network_Interfaces.xml b/en-US/Network_Interfaces.xml
index cced4e5..4ee65c7 100644
--- a/en-US/Network_Interfaces.xml
+++ b/en-US/Network_Interfaces.xml
@@ -261,6 +261,7 @@ ONBOOT=yes</programlisting>
                 Changing speed or duplex settings almost always requires disabling autonegotiation with the <option>autoneg off</option> option. This option needs to be stated first, as the option entries are order-dependent.
               </para>
             </important>
+            <para>Refer to <xref linkend="s2-ethtool"/> for more Ethtool options.</para>
           </listitem>
         </varlistentry>
         <!-- Suppress this directive as its better to put this in the Global Config file called /etc/sysconfig/network
@@ -521,6 +522,1074 @@ ONBOOT=yes</programlisting>
         </variablelist>
         </section>
         
+        <section id="s2-ethtool">
+          <title>Ethtool</title>
+        <indexterm>
+          <primary>network</primary>
+          <secondary>interfaces</secondary>
+        <tertiary>ethtool</tertiary>
+      </indexterm>
+      <para>Ethtool is a utility for configuration of <firstterm>Network Interface Cards</firstterm> (<acronym>NICs</acronym>). This utility allows querying and changing settings such as speed, port, auto-negotiation, PCI locations and checksum offload on many network devices, especially Ethernet devices. 
+</para>
+
+<para>We present here a short selection of often used Ethtool commands together with some useful commands that are not well known. For a full list of commands type <command>ethtool -h</command> or refer to the man page, <filename>ethtool(8)</filename>, for a more verbose list and explanation. The first two examples are information queries and show the use of the different formats of the command.</para> <para>But first, the command structure:</para>
+
+<variablelist>
+
+
+ 
+ <synopsis><command>ethtool</command> <optional><replaceable>option</replaceable>...</optional> <replaceable>devname</replaceable></synopsis>
+<para>
+  where <replaceable>option</replaceable> is none or more options, and <replaceable>devname</replaceable> is your Network Interface Card (NIC). For example <interface>eth0</interface> or <interface>em1</interface>.</para>
+
+<varlistentry> 
+<term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>command</secondary>
+              <tertiary>
+                <option>devname</option>
+              </tertiary>
+            </indexterm>
+            <command>ethtool</command>
+          </term>
+          <listitem>
+            <para>
+              The <command>ethtool</command> command with only a device name as an option is used to query a network device for NIC and driver statistics. It takes the following form:
+              </para>
+          <screen>ethtool <option>-S</option>, <option>--statistics</option> <replaceable>devname</replaceable></screen>
+
+            <para>
+              where <replaceable>devname</replaceable> is your NIC. For example <interface>eth0</interface> or <interface>em1</interface>.
+              </para>
+       </listitem>
+       
+       </varlistentry> 
+
+</variablelist>
+         <para>
+ Some values can only be obtained when the command is run as root. Here is an example of the output when the command is run as root:
+ </para>
+ <screen>
+~]# <command>ethtool em1</command>
+Settings for em1:
+	Supported ports: [ TP ]
+	Supported link modes:   10baseT/Half 10baseT/Full 
+	                        100baseT/Half 100baseT/Full 
+	                        1000baseT/Full 
+	Supported pause frame use: No
+	Supports auto-negotiation: Yes
+	Advertised link modes:  10baseT/Half 10baseT/Full 
+	                        100baseT/Half 100baseT/Full 
+	                        1000baseT/Full 
+	Advertised pause frame use: No
+	Advertised auto-negotiation: Yes
+	Speed: 1000Mb/s
+	Duplex: Full
+	Port: Twisted Pair
+	PHYAD: 2
+	Transceiver: internal
+	Auto-negotiation: on
+	MDI-X: on
+	Supports Wake-on: pumbg
+	Wake-on: g
+	Current message level: 0x00000007 (7)
+			       drv probe link
+	Link detected: yes
+ </screen>
+
+
+<para>
+  Issue the following command, using the short or long form of the argument, to query the specified network device for associated driver information:
+</para>
+<para><screen>
+<command>ethtool</command> <option>-i, --driver</option> <replaceable>devname</replaceable></screen>
+</para>
+        
+          <para>
+            where <replaceable>devname</replaceable> is your Network Interface Card (NIC). For example <interface>eth0</interface> or <interface>em1</interface>.
+            </para>
+           
+           
+           
+           <para>
+ Here is an example of the output:</para>
+ 
+ <screen>
+~]$ <command>ethtool -i em1</command>
+driver: e1000e
+version: 2.0.0-k
+firmware-version: 0.13-3
+bus-info: 0000:00:19.0
+supports-statistics: yes
+supports-test: yes
+supports-eeprom-access: yes
+supports-register-dump: yes </screen>
+
+
+
+
+
+<para>Here follows a list of commands to query, identify or reset the device. They are in the usual -short and --long form:</para>
+
+
+
+<variablelist>
+
+
+
+  <varlistentry>
+          <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--statistics</option>
+              </tertiary>
+            </indexterm>
+            <option>--statistics</option>
+          </term>
+          <listitem>
+            <para>
+              The <option>--statistics</option> or <option>-S</option> queries the specified network device for NIC and driver statistics. It takes the following form:
+              </para>
+          <screen>ethtool <option>-S</option>, <option>--statistics</option> <replaceable>devname</replaceable></screen>
+
+            <para>
+              where <replaceable>devname</replaceable> is your NIC.
+              </para>
+              
+             </listitem>
+</varlistentry>
+
+
+ <varlistentry>
+          <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--identify</option>
+              </tertiary>
+            </indexterm>
+            <option>--identify</option>
+          </term>
+          <listitem>
+            <para>
+The <option>--identify</option> or <option>-p</option> option initiates adapter-specific action intended to enable an operator to easily identify the adapter by sight. Typically this involves blinking one or more LEDs on the specified network port. It takes the following form:
+                  </para>
+<screen><option>-p, --identify
+</option><replaceable>devname</replaceable> <replaceable>integer</replaceable></screen>
+							<para>
+              where <replaceable>integer</replaceable> is length of time in seconds to perform the action,
+              </para>
+          
+            <para>
+              and <replaceable>devname</replaceable> is your NIC.
+              </para>
+             
+ </listitem>
+</varlistentry>
+
+<varlistentry>
+  <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--test</option>
+              </tertiary>
+            </indexterm>
+            <option>--test</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--test</option> or <option>-t</option> option is used to perform tests on a Network Interface Card. It takes the following form:
+                           </para>
+<screen><option>-t, --test</option> <replaceable>word </replaceable><replaceable>devname</replaceable></screen>
+          
+            <para>
+              where <replaceable>word</replaceable> is one of the following:
+            </para>
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>offline</literal> — Perform a comprehensive set of tests. Service will be interrupted.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>online</literal> — Perform a reduced set of tests. Service should not be interrupted.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>external_lb</literal> — Perform full set of tests including loopback tests while fitted with a loopback cable.
+                </para>
+              </listitem>
+
+            </itemizedlist>
+            
+                          <para> and <replaceable>devname</replaceable> is your NIC.</para>
+
+             
+          </listitem>
+</varlistentry>
+
+
+</variablelist>
+
+<para>Changing some or all settings of the specified network device requires the <option>-s</option> or <option>--change</option> option. All the following options are only applied if the <option>-s</option> or <option>--change</option> option is also specified. For the sake of clarity we will omit it here.
+          </para>
+          <para>
+           To make these settings permanent you can make use of the ETHTOOL_OPTS directive. It can be used in interface configuration files to set the desired options when the network interface is brought up. Refer to <xref linkend="s2-networkscripts-interfaces-eth0"/> for more details on how to use this directive.
+           </para>
+
+<variablelist>
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--speed</option>
+              </tertiary>
+            </indexterm>
+            <option>--speed</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--speed</option> option is used to set the speed in megabits per second (Mb/s). Omitting the speed value will show the supported device speeds. It takes the following form:
+           </para>
+           <screen>
+<option>--speed</option> <replaceable>number</replaceable> <replaceable>devname</replaceable></screen>
+
+          
+            <para>
+              where <replaceable>number</replaceable> is the speed in megabits per second (Mb/s),
+              </para>
+              <para> and <replaceable>devname</replaceable> is your NIC.</para>
+
+                           </listitem>
+                           </varlistentry>
+
+
+
+
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--duplex</option>
+              </tertiary>
+            </indexterm>
+            <option>--duplex</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--duplex</option> option is used to set the transmit and receive mode of operation. It takes the following form:
+           </para>
+           <screen>
+ <option>--duplex</option> <replaceable>word</replaceable> <replaceable>devname</replaceable></screen>
+
+              <para>
+              where <replaceable>word</replaceable> is one of the following:
+            </para>
+            	<itemizedlist>
+              <listitem>
+                <para>
+                  <literal>half</literal> — Sets half-duplex mode. Usually used when connected to a hub.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>full</literal> — Sets full-duplex mode. Usually used when connected to a switch or another host.</para>
+              </listitem>
+              </itemizedlist>
+              
+              <para> and <replaceable>devname</replaceable> is your NIC.</para>
+              
+              
+            
+              </listitem>
+</varlistentry>
+
+
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--port</option>
+              </tertiary>
+            </indexterm>
+            <option>--port</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--port</option> option is used to select the device port . It takes the following form:
+           </para>
+           <screen><option>--port</option> <replaceable>value</replaceable> <replaceable>devname</replaceable></screen>
+          
+          
+            <para>
+              where <replaceable>value</replaceable> is one of the following:
+            </para>
+
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>tp</literal> — An Ethernet interface using Twisted-Pair cable as the medium.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>aui</literal> — Attachment Unit Interface (AUI). Normally used with hubs.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>bnc</literal> — An Ethernet interface using BNC connectors and co-axial cable.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>mii</literal> — An Ethernet interface using a Media Independent Interface (MII).
+                </para>
+              </listitem>
+               <listitem>
+                <para>
+                  <literal>fibre</literal> — An Ethernet interface using Optical Fibre as the medium.
+                </para>
+              </listitem>
+
+             </itemizedlist>
+             
+             <para> and <replaceable>devname</replaceable> is your NIC.</para>
+
+          </listitem>
+          
+</varlistentry>
+
+
+ <varlistentry>
+  <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--autoneg</option>
+              </tertiary>
+            </indexterm>
+            <option>--autoneg</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--autoneg</option> option is used to control auto-negotiation of network speed and mode of operation (full-duplex or half-duplex mode). If auto-negotiation is enabled you can initiate re-negotiation of network speeds and mode of operation by using the <option>-r, --negotiate</option> option.
+              You can display the auto-negotiation state using the <option>--a, --show-pause</option> option.
+              </para>
+            <para>
+            It takes the following form:
+                           </para>
+<screen><option>--autoneg</option> <replaceable>value</replaceable> <replaceable>devname</replaceable></screen>
+          
+          
+            <para>
+              where <replaceable>value</replaceable> is one of the following:
+            </para>
+
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>yes</literal> — Allow auto-negotiating of network speed and mode of operation.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>no</literal> — Do not allow auto-negotiating of network speed and mode of operation.
+                </para>
+              </listitem>
+             
+             </itemizedlist>
+             <para> and <replaceable>devname</replaceable> is your NIC.</para>
+          
+              
+          </listitem>
+</varlistentry>
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--advertise</option>
+              </tertiary>
+            </indexterm>
+            <option>--advertise</option>
+          </term>
+          <listitem>
+            <para>
+              The <option>--advertise</option> option is used to set what speeds and modes of operation (duplex mode) are advertised for auto-negotiation. The argument is one or more hexadecimal values from <xref linkend="advertised-speeds-duplex-mode"/>.
+              </para>
+             
+            <para>
+            It takes the following form:
+                           </para>
+<screen><option>--advertise</option> <replaceable>HEX-VALUE</replaceable> <replaceable>devname</replaceable></screen>
+          
+          
+            <para>
+              where <replaceable>HEX-VALUE</replaceable> is one or more of the hexadecimal values from the table below and <replaceable>devname</replaceable> is your NIC.</para>
+            
+            
+
+             <table id="advertised-speeds-duplex-mode" frame="all">
+              <title>Ethtool advertise options: speed and mode of operation</title>
+      <tgroup cols="4" align="left" colsep="1" rowsep="1">
+        <colspec colnum="1" colname="col1"/>
+        <colspec colnum="2" colname="col2"/>
+        <colspec colnum="3" colname="col3"/>
+        <colspec colnum="4" colname="col4"/>
+        <thead>
+          <row>
+            <entry>
+              Hex Value
+            </entry>
+            <entry>
+              Speed
+            </entry>
+            <entry>
+              Duplex Mode
+            </entry>
+            <entry>
+              IEEE standard?
+            </entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>
+              0x001
+            </entry>
+            <entry>
+              10
+            </entry>
+            <entry>
+              <para>
+                Half
+              </para>
+            </entry>
+            <entry>
+Yes
+</entry>
+          </row>
+          <row>
+            <entry>
+0x002
+</entry>
+            <entry>
+10
+</entry>
+            <entry>
+              <para>
+                Full
+              </para>
+            </entry>
+            <entry>
+             Yes
+            </entry>
+          </row>
+          <row>
+            <entry>
+              0x004
+            </entry>
+            <entry>
+     100</entry>
+            <entry>
+              <para>
+               Half
+              </para>
+            </entry>
+            <entry>
+              Yes
+            </entry>
+          </row>
+          <row>
+            <entry>
+              0x008
+            </entry>
+            <entry>
+     100
+     </entry>
+            <entry>
+              <para>
+                Full
+              </para>
+            </entry>
+            <entry>
+              Yes
+            </entry>
+          </row>
+          <row>
+            <entry>
+              0x010
+            </entry>
+            <entry>
+                   1000
+            </entry>
+            <entry>
+              Half
+            </entry>
+            <entry>
+              No
+            </entry>
+          </row>
+          <row>
+            <entry>
+              0x020
+            </entry>
+            <entry>
+                   1000
+            </entry>
+            <entry>
+              <para>
+                Full
+                </para>
+            </entry>
+            <entry>
+Yes</entry>
+          </row>
+          <row>
+            <entry>
+             0x8000
+            </entry>
+            <entry>
+                   2500
+            </entry>
+            <entry>
+              Full
+            </entry>
+            <entry>
+              Yes
+            </entry>
+          </row>
+          <row>
+            <entry>
+             0x1000
+            </entry>
+            <entry>
+                   10000
+            </entry>
+            <entry>
+              Full
+            </entry>
+            <entry>
+              Yes
+            </entry>
+          </row>
+           <row>
+            <entry>
+             0x20000
+            </entry>
+            <entry>
+                   20000MLD2
+            </entry>
+            <entry>
+              Full
+            </entry>
+            <entry>
+              No
+            </entry>
+          </row>
+           <row>
+            <entry>
+             0x20000
+            </entry>
+            <entry>
+                   20000MLD2
+            </entry>
+            <entry>
+              Full
+            </entry>
+            <entry>
+              No
+            </entry>
+          </row>
+           <row>
+            <entry>
+             0x40000
+            </entry>
+            <entry>
+                   20000KR2
+            </entry>
+            <entry>
+              Full
+            </entry>
+            <entry>
+              No
+            </entry>
+          </row>
+          
+        </tbody>
+      </tgroup>
+    </table>
+
+</listitem>
+</varlistentry>
+ 
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--phyad</option>
+              </tertiary>
+            </indexterm>
+            <option>--phyad</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--phyad</option> option is used to change the physical address. Often referred to as the MAC or hardware address but in this context referred to as the physical address.
+        </para>
+        
+        <para>
+        It takes the following form:
+           </para>
+           <screen><option>--phyad</option> <replaceable>HEX-VALUE</replaceable> <replaceable>devname</replaceable></screen>
+
+            <para>
+              where <replaceable>HEX-VALUE</replaceable> is the physical address in hexadecimal format and <replaceable>devname</replaceable> is your NIC.
+              </para>
+
+         </listitem>
+
+         </varlistentry>
+
+
+<varlistentry>
+<term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--xcvr</option>
+              </tertiary>
+            </indexterm>
+            <option>--xcvr</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--xcvr</option> option is used to select the transceiver type. Currently only <quote>internal</quote> and <quote>external</quote> can be specified. In the future other types might be added.
+        </para>
+        
+        <para>
+        It takes the following form:
+           </para>
+           <screen><option>--xcvr</option> <replaceable>word</replaceable> <replaceable>devname</replaceable></screen>
+            <para>
+              where <replaceable>word</replaceable> is one of the following:
+            </para>
+
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>internal</literal> — Use internal transceiver.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>external</literal> — Use external transceiver.
+                </para>
+                </listitem>
+             </itemizedlist>
+             
+           <para> and <replaceable>devname</replaceable> is your NIC.</para>
+</listitem>
+</varlistentry>
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--wol</option>
+              </tertiary>
+            </indexterm>
+            <option>--wol</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--wol</option> option is used to set <quote>Wake-on-LAN</quote> options. Not all devices support this. The argument to this option is a string of characters specifying which options to enable.
+</para>
+            <para>
+            It takes the following form:
+                           </para>
+<screen><option>--wol</option> <replaceable>value</replaceable> <replaceable>devname</replaceable></screen>
+          
+            <para>
+              where <replaceable>value</replaceable> is one or more of the following:
+            </para>
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>p</literal> — Wake on PHY activity.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>u</literal> — Wake on unicast messages.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>m</literal> — Wake on multicast messages.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>b</literal> — Wake on broadcast messages.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>g</literal> — Wake-on-Lan; wake on receipt of a "magic packet".
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>s</literal> — Enable security function using password for Wake-on-Lan.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>d</literal> — Disable Wake-on-Lan and clear all settings.
+                </para>
+              </listitem>
+              </itemizedlist>
+
+              <para> and <replaceable>devname</replaceable> is your NIC.</para>
+
+</listitem>
+</varlistentry>
+
+ <varlistentry>
+ <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--sopass</option>
+              </tertiary>
+            </indexterm>
+            <option>--sopass</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--sopass</option> option is used to set the <quote>SecureOn</quote> password. The argument to this option must be 6 bytes in Ethernet MAC hexadecimal format (xx:yy:zz:aa:bb:cc).
+        </para>
+                
+        <para>
+        It takes the following form:
+           </para>
+           <screen><option>--sopass</option> <replaceable>xx:yy:zz:aa:bb:cc</replaceable> <replaceable>devname</replaceable></screen>
+
+            <para>
+              where <replaceable>xx:yy:zz:aa:bb:cc</replaceable> is the password in the same format as a MAC address and <replaceable>devname</replaceable> is your NIC.
+              </para>
+
+         </listitem>
+  </varlistentry>
+
+		 <varlistentry>
+		 <term>
+            <indexterm>
+              <primary>
+                <application>Ethtool</application>
+              </primary>
+              <secondary>option</secondary>
+              <tertiary>
+                <option>--msglvl</option>
+              </tertiary>
+            </indexterm>
+            <option>--msglvl</option>
+          </term>
+          <listitem>
+            <para>
+            The <option>--msglvl</option> option is used to set the driver message-type flags by name or number. The precise meanings of these type flags differ between drivers.
+              </para>
+                 
+        <para>
+        It takes the following form:
+           </para>
+           <screen><option>--msglvl</option> <replaceable>value</replaceable> <replaceable>devname</replaceable></screen>
+          
+          
+            <para>
+              where <replaceable>value</replaceable> is one of:
+              
+              <itemizedlist>
+              <listitem>
+                <para>
+                  <literal>HEX-VALUE</literal> — Hexadecimal value indicating message type.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <literal>message-type</literal> — The message type name in plain text.
+                </para>
+              </listitem>
+              </itemizedlist>
+              </para>
+              <para> and <replaceable>devname</replaceable> is your NIC.</para>
+<para>
+              The defined message type names and numbers are shown in the table below:
+            </para>
+
+             <table id="msglvl-driver-message-type" frame="all">
+              <title>Driver message type</title>
+      <tgroup cols="3" align="left" colsep="1" rowsep="1">
+        <colspec colnum="1" colname="col1"/>
+        <colspec colnum="2" colname="col2"/>
+        <colspec colnum="3" colname="col3"/>
+        
+        <thead>
+          <row>
+            <entry>
+              Message Type
+            </entry>
+            <entry>
+              Hex Value
+            </entry>
+            <entry>
+              Description
+            </entry>
+            
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>
+              drv
+            </entry>
+            <entry>
+              0x0001
+            </entry>
+            <entry>
+              <para>
+                General driver status
+              </para>
+            </entry>
+            
+          </row>
+          <row>
+            <entry>
+probe
+
+</entry>
+            <entry>
+0x0002
+</entry>
+            <entry>
+              <para>
+                Hardware probing
+              </para>
+            </entry>
+            
+          </row>
+          <row>
+            <entry>
+              link
+              </entry>
+            <entry>
+     0x0004
+     </entry>
+            <entry>
+              <para>
+               Link state
+              </para>
+            </entry>
+            
+          </row>
+          <row>
+            <entry>
+              timer
+            </entry>
+            <entry>
+     0x0008
+     </entry>
+            <entry>
+              <para>
+                Periodic status check
+              </para>
+            </entry>
+            
+          </row>
+          <row>
+            <entry>
+                            ifdown
+            </entry>
+            <entry>
+                   0x0010
+            </entry>
+            <entry>
+Interface being brought down
+</entry>
+            
+          </row>
+          <row>
+            <entry>
+                            ifup
+            </entry>
+            <entry>
+                   0x0020
+            </entry>
+            <entry>
+              <para>
+                          Interface being brought up
+                </para>
+            </entry>
+   
+          </row>
+          <row>
+            <entry>
+                           rx_err
+            </entry>
+            <entry>
+                   0x0040
+            </entry>
+            <entry>
+                Receive error
+            </entry>
+         
+          </row>
+          <row>
+            <entry>
+                           tx_err
+                           </entry>
+            <entry>
+                         0x0080
+            </entry>
+            <entry>
+                Transmit error
+            </entry>
+         
+          </row>
+           <row>
+            <entry>
+                           intr
+            </entry>
+            <entry>
+                           0x0200
+            </entry>
+            <entry>
+                Interrupt handling
+            </entry>
+            
+          </row>
+           <row>
+            <entry>
+                           tx_done
+            </entry>
+            <entry>
+                        0x0400
+            </entry>
+            <entry>
+              Transmit completion
+            </entry>
+            
+          </row>
+           <row>
+            <entry>
+                           rx_status 
+            </entry>
+            <entry>
+                     0x0800
+            </entry>
+            <entry>
+                Receive completion
+            </entry>
+            
+          </row>
+           <row>
+            <entry>
+            pktdata
+            </entry>
+            <entry>
+              0x1000
+            </entry>
+            <entry>
+              Packet contents
+            </entry>
+            </row>
+             <row>
+            <entry>
+              hw
+            </entry>
+            <entry>
+              0x2000
+            </entry>
+            <entry>
+              Hardware status
+            </entry>
+            </row>
+             <row>
+            <entry>
+wol
+            </entry>
+            <entry>
+0x4000
+</entry>
+            <entry>
+                Wake-on-LAN status
+            </entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+
+               </listitem>
+
+</varlistentry>
+		
+</variablelist>
+</section>
+        
 <section id="s2-networkscripts-interfaces-chan">
       <title>Channel Bonding Interfaces</title>
       <indexterm>