Difference between revisions of "Manual:Interface/Ethernet"

From MikroTik Wiki
Jump to: navigation, search
Line 79: Line 79:
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>running</b></var> (<em>yes | no</em>;)</td>
+
     <td><var><b>running</b></var> (<em>yes | no</em>)</td>
 
     <td>Whether interface is running. Note that some interface does not have running check and they are always reported as "running"</td>
 
     <td>Whether interface is running. Note that some interface does not have running check and they are always reported as "running"</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
     <td><var><b>rx-1024-1518</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-1024-1518</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-128-255</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-128-255</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-1519-max</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-1519-max</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-256-511</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-256-511</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-512-1023</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-512-1023</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-64</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-64</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-65-127</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-65-127</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-align-error</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-align-error</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-broadcast</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-broadcast</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-bytes</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-bytes</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-fcs-error</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-fcs-error</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-fragment</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-fragment</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-multicast</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-multicast</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-overflow</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-overflow</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-pause</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-pause</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-runt</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-runt</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>rx-too-long</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>rx-too-long</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
     <td><var><b>slave</b></var> (<em>yes | no</em>;)</td>
+
     <td><var><b>slave</b></var> (<em>yes | no</em>)</td>
 
     <td>Whether interface is configured as a slave of another interface (for example [[Bonding]])</td>
 
     <td>Whether interface is configured as a slave of another interface (for example [[Bonding]])</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>switch</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>switch</b></var> (<em>integer</em>)</td>
 
     <td>ID to which switch chip interface belongs to.</td>
 
     <td>ID to which switch chip interface belongs to.</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
     <td><var><b>tx-1024-1518</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-1024-1518</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-128-255</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-128-255</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-1519-max</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-1519-max</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-256-511</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-256-511</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-512-1023</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-512-1023</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-64</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-64</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-65-127</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-65-127</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-align-error</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-align-error</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-broadcast</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-broadcast</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-bytes</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-bytes</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-fcs-error</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-fcs-error</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-fragment</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-fragment</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-multicast</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-multicast</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-overflow</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-overflow</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-pause</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-pause</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-runt</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-runt</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>tx-too-long</b></var> (<em>integer</em>;)</td>
+
     <td><var><b>tx-too-long</b></var> (<em>integer</em>)</td>
 
     <td></td>
 
     <td></td>
 
</tr>
 
</tr>
Line 239: Line 239:
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>blink</b></var> (<em>[id, name]</em>;)</td>
+
     <td><var><b>blink</b></var> (<em>[id, name]</em>)</td>
 
     <td>Blink Ethernet leds</td>
 
     <td>Blink Ethernet leds</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>monitor</b></var> (<em>[id, name]</em>;)</td>
+
     <td><var><b>monitor</b></var> (<em>[id, name]</em>)</td>
 
     <td>Monitor ethernet status. [[#Monitor | Read more>>]]</td>
 
     <td>Monitor ethernet status. [[#Monitor | Read more>>]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>reset-counters</b></var> (<em>[id, name]</em>;)</td>
+
     <td><var><b>reset-counters</b></var> (<em>[id, name]</em>)</td>
 
     <td>Reset stats counters. [[#Stats | Read more>>]]</td>
 
     <td>Reset stats counters. [[#Stats | Read more>>]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
     <td><var><b>reset-mac</b></var> (<em>[id, name]</em>;)</td>
+
     <td><var><b>reset-mac</b></var> (<em>[id, name]</em>)</td>
 
     <td>Reset MAC address to manufacturers default.</td>
 
     <td>Reset MAC address to manufacturers default.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
 +
<h2>Monitor</h2>
 +
 +
<code>/interface ethernet monitor</code> command prints out current link, rate and duplex status of an interface.
 +
<br /><br />
 +
Properties:<br />
 +
<table class="styled_table">
 +
<tr>
 +
  <th width="40%">Property</th>
 +
  <th >Description</th>
 +
</tr>
 +
<tr>
 +
    <td><var><b>auto-negotiation</b></var> (<em>done | incomplete</em>)</td>
 +
    <td>Current auto negotiation status.<br />
 +
<ul>
 +
:<li><var>done</var>-negotiation completed
 +
:<li><var>incomplete</var>-negotiation failed or not yet completed
 +
</ul></td>
 +
</tr>
 +
<tr>
 +
    <td><var><b>default-cable-settings</b></var> (<em>short | standard</em>)</td>
 +
    <td>default cable length setting (only applicable to NS DP83815/6 cards)<br />
 +
<ul>
 +
:<li><var>short</var>-support short cables
 +
:<li><var>standard</var>-support standard cables
 +
</ul></td>
 +
</tr>
 +
 +
<tr>
 +
    <td><var><b>full-duplex</b></var> (<em>yes | no</em>)</td>
 +
    <td>Whether transmission of data occurs in two directions simultaneously</td>
 +
</tr>
 +
<tr>
 +
    <td><var><b>rate</b></var> (<em>10Mbps | 100Mbps | 1Gbps</em>)</td>
 +
    <td>Actual data rate of the connection</td>
 +
</tr>
 +
<tr>
 +
    <td><var><b>status</b></var> (<em>link-ok | no-link | unknown</em>)</td>
 +
    <td>Current link status of an interface<br />
 +
<ul>
 +
:<li><var>link-ok</var>-the card is connected to the network
 +
:<li><var>no-link</var>-the card is not connected to the network
 +
:<li><var>unknown</var>-the connection is not recognized (if the card does not report connection status)
 +
</ul></td>
 +
</tr>
 +
 +
</table>
 +
 +
<br />
 +
Example output of ethernet status:
 +
<pre>
 +
[admin@MikroTik] /interface ethernet> monitor ether1
 +
            status: link-ok
 +
  auto-negotiation: done
 +
              rate: 1Gbps
 +
      full-duplex: yes
 +
 +
</pre>
 
<h2>Stats</h2>
 
<h2>Stats</h2>
 
RouterOS v3.22 introduces a new command:
 
RouterOS v3.22 introduces a new command:
Line 306: Line 363:
  
 
</pre>
 
</pre>
 +
 +
<h2>Mirror</h2>
 +
<p><b>Sub-menu:</b> <code>/interface ethernet mirror</code></p>
 +
 +
 
</div>
 
</div>
  

Revision as of 10:05, 13 October 2009

Summary

Sub-menu: /interface ethernet

Standards: IEEE 802.3


MikroTik RouterOS supports various types of Ethernet interfaces.

Properties


Property Description
arp (disabled | enabled | proxy-arp | reply-only; Default: enabled) Address Resolution Protocol mode
auto-negotiation (yes | no; Default: yes) When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible.
Note: Auto-negotiation must be disabled on both ends, otherwise Ethernets may not work properly.
Note2: Gigabit link cannot work with auto-negotiation disabled.
bandwidth (integer/integer; Default: unlimited/unlimited) Sets max rx/tx bandwidth that will be handled by an interface.
cable-setting (default | short | standard; Default: default) changes the cable length setting (only applicable to NS DP83815/6 cards)
disable-running-check (yes | no; Default: yes) Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not.
full-duplex (yes | no; Default: yes) Defines whether the transmission of data appears in two directions simultaneously
l2mtu (integer; Default: ) Layer2 Maximum transmission unit. Read more>>
mac-address (MAC; Default: ) Media Access Control number of an interface.
master-port (name | none; Default: none) Sets switch group master interface
mdix-enable (yes | no; Default: ) Whether the MDI/X auto crosscable correction feature is enabled for the port
mtu (integer; Default: 1500) Layer3 Maximum transmission unit
name (string; Default: ) Name of an interface
speed (10Mbps | 100Mbps | 1Gbps; Default: max available) Sets the data transmission speed of the interface. By default, this value is the maximal data rate supported by the interface


Read-only properties

Property Description
running (yes | no) Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
rx-1024-1518 (integer)
rx-128-255 (integer)
rx-1519-max (integer)
rx-256-511 (integer)
rx-512-1023 (integer)
rx-64 (integer)
rx-65-127 (integer)
rx-align-error (integer)
rx-broadcast (integer)
rx-bytes (integer)
rx-fcs-error (integer)
rx-fragment (integer)
rx-multicast (integer)
rx-overflow (integer)
rx-pause (integer)
rx-runt (integer)
rx-too-long (integer)
slave (yes | no) Whether interface is configured as a slave of another interface (for example Bonding)
switch (integer) ID to which switch chip interface belongs to.
tx-1024-1518 (integer)
tx-128-255 (integer)
tx-1519-max (integer)
tx-256-511 (integer)
tx-512-1023 (integer)
tx-64 (integer)
tx-65-127 (integer)
tx-align-error (integer)
tx-broadcast (integer)
tx-bytes (integer)
tx-fcs-error (integer)
tx-fragment (integer)
tx-multicast (integer)
tx-overflow (integer)
tx-pause (integer)
tx-runt (integer)
tx-too-long (integer)

Menu specific commands

Property Description
blink ([id, name]) Blink Ethernet leds
monitor ([id, name]) Monitor ethernet status. Read more>>
reset-counters ([id, name]) Reset stats counters. Read more>>
reset-mac ([id, name]) Reset MAC address to manufacturers default.

Monitor

/interface ethernet monitor command prints out current link, rate and duplex status of an interface.

Properties:

Property Description
auto-negotiation (done | incomplete) Current auto negotiation status.
  • done-negotiation completed
  • incomplete-negotiation failed or not yet completed
default-cable-settings (short | standard) default cable length setting (only applicable to NS DP83815/6 cards)
  • short-support short cables
  • standard-support standard cables
full-duplex (yes | no) Whether transmission of data occurs in two directions simultaneously
rate (10Mbps | 100Mbps | 1Gbps) Actual data rate of the connection
status (link-ok | no-link | unknown) Current link status of an interface
  • link-ok-the card is connected to the network
  • no-link-the card is not connected to the network
  • unknown-the connection is not recognized (if the card does not report connection status)


Example output of ethernet status:

[admin@MikroTik] /interface ethernet> monitor ether1
            status: link-ok
  auto-negotiation: done
              rate: 1Gbps
       full-duplex: yes

Stats

RouterOS v3.22 introduces a new command:

/interface ethernet print stats

This command will display all kinds of other statistics if the interface is supporting them (currently only RB450G ether2-ether5 and also RB750 ether2-ether5). Complete list of properties can be found in section above

For example, output of ethernet stats on RB450G:

[admin@MikroTik] /interface ethernet> print stats 
                      name: ether1-gateway ether2-local ether3-local ether4-local ether5-local
              rx-broadcast:                22           31           3666         11          
                  rx-pause:                0            0            0            0           
              rx-multicast:                4            7            1423         5           
              rx-fcs-error:                0            0            2            0           
            rx-align-error:                0            0            0            0           
                   rx-runt:                0            0            0            0           
               rx-fragment:                0            0            1            0           
                     rx-64:                0            0            0            0           
                 rx-65-127:                8            14           21598        10          
                rx-128-255:                0            0            0            0           
                rx-256-511:                18           24           2245         6           
               rx-512-1023:                28926        7649         371938       24476       
              rx-1024-1518:                0            0            0            0           
               rx-1519-max:                0            0            0            0           
               rx-too-long:                0            0            0            0           
               rx-overflow:                0            0            0            0           
                  rx-bytes:                15337844     4063737      199738064    12975401    
              tx-broadcast:                13           13           1496         8           
                  tx-pause:                0            0            0            0           
              tx-multicast:                13           13           1496         8           
               tx-underrun:                0            0            0            0           
                     tx-64:                0            0            0            0           
                 tx-65-127:                26           26           2992         16          
                tx-128-255:                0            0            0            0           
                tx-256-511:                0            0            0            0           
               tx-512-1023:                0            0            0            0           
              tx-1024-1518:                0            0            0            0           
               tx-1519-max:                0            0            0            0
               tx-too-long:                0            0            0            0
              tx-collision:                0            0            0            0
    tx-excessive-collision:                0            0            0            0
     tx-multiple-collision:                0            0            0            0
       tx-single-collision:                0            0            0            0
     tx-excessive-deferred:                0            0            0            0
               tx-deferred:                0            0            0            0
         tx-late-collision:                0            0            0            0
                  tx-bytes:                2561         2561         294712       1576

Mirror

Sub-menu: /interface ethernet mirror