merge -c1578 trunk: Debug if. stable-1.4
authorFlorian Pose <fp@igh-essen.com>
Wed, 05 Nov 2008 15:39:42 +0000
branchstable-1.4
changeset 1673 c6f214c9986d
parent 1672 70dbf6cff28c
child 1674 201b4ce689e5
merge -c1578 trunk: Debug if.
documentation/ethercat_doc.tex
--- a/documentation/ethercat_doc.tex	Wed Nov 05 15:27:14 2008 +0000
+++ b/documentation/ethercat_doc.tex	Wed Nov 05 15:39:42 2008 +0000
@@ -2205,16 +2205,17 @@
 Wireshark~\cite{wireshark}, for example.
 
 For convenience, so-called ``debug interfaces'' are supported. Debug
-interfaces allow to monitor EtherCAT traffic with a network monitor (like
-Wireshark or tcpdump) running on the master machine without using external
-hardware. To use this functionality, the master sources have to be configured
-with the \lstinline+--enable-debug-if+ switch (see
-sec.~\ref{sec:installation}).
-
-Every EtherCAT master registers two read-only network interfaces. These are
+interfaces are virtual network interfaces allowing to capture EtherCAT traffic
+with a network monitor (like Wireshark or tcpdump) running on the master
+machine without using external hardware. To use this functionality, the master
+sources have to be configured with the \lstinline+--enable-debug-if+ switch
+(see sec.~\ref{sec:installation}).
+
+Every EtherCAT master registers two read-only network interfaces,
+corresponding to the physical Ethernet devices. These are
 named \textit{ecdbgmX} (main device) and \textit{ecdbgbX} (backup device, for
 future use), where X is the master index. The below listing shows debug
-interface among some standard interfaces:
+interfaces among some standard network interfaces:
 
 \begin{lstlisting}
 # `\textbf{ip link}`
@@ -2223,7 +2224,7 @@
 4: eth0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop qlen 1000
     link/ether 00:04:61:03:d1:01 brd ff:ff:ff:ff:ff:ff
 8: ecdbgm0: <BROADCAST,MULTICAST> mtu 1500 qdisc pfifo_fast
-    qlen 1000
+                                                 qlen 1000
     link/ether 00:00:00:00:00:00 brd ff:ff:ff:ff:ff:ff
 9: ecdbgb0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop qlen 1000
     link/ether 00:00:00:00:00:00 brd ff:ff:ff:ff:ff:ff
@@ -2231,7 +2232,8 @@
 
 While a debug interface is enabled, all frames sent or received to or from the
 physical device are additionally forwarded to the debug interface by the
-corresponding master. Interfaces can be enabled with the below command:
+corresponding master. Network interfaces can be enabled with the below
+command:
 
 \begin{lstlisting}
 # `\textbf{ip link set dev ecdbgm0 up}`
@@ -2240,9 +2242,9 @@
 Please note, that the frame rate can be very high. With an application
 connected, the debug interface can produce thousands of frames per second.
 
-\paragraph{Attention} The socket buffers needed for the operation of the
-debugging interface have to be allocated dynamically. Some Linux realtime
-extensions do not allow this in realtime context!
+\paragraph{Attention} The socket buffers needed for the operation of debug
+interfaces have to be allocated dynamically. Some Linux realtime extensions do
+not allow this in realtime context!
 
 %------------------------------------------------------------------------------