Manual:Interface/Ethernet: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
(New page: <div class=manual> <h2>Summary</h2> <p><b>Sub-menu:</b> <code>/interface ethernet</code></p> <p><b>Standards:</b> <code>[http://grouper.ieee.org/groups/802/3/ IEEE 802.3]</code></p> <br /...)
 
No edit summary
Line 24: Line 24:
     <td><var><b>auto-negotiation</b></var> (<em>yes | no</em>; Default: <b>yes</b>)</td>
     <td><var><b>auto-negotiation</b></var> (<em>yes | no</em>; Default: <b>yes</b>)</td>
     <td>When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. <br /> <b>Note:</b> Auto-negotiation must be disabled on both ends, otherwise Ethernets may not work properly. <br /> <b>Note2:</b> Gigabit link cannot work with auto-negotiation disabled.</td>
     <td>When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. <br /> <b>Note:</b> Auto-negotiation must be disabled on both ends, otherwise Ethernets may not work properly. <br /> <b>Note2:</b> Gigabit link cannot work with auto-negotiation disabled.</td>
</tr>
<tr>
    <td><var><b>bandwidth</b></var> (<em>integer/integer</em>; Default: <b>unlimited/unlimited</b>)</td>
    <td>Sets max rx/tx bandwidth that will be handled by an interface.</td>
</tr>
</tr>
<tr>
<tr>
Line 44: Line 48:
     <td><var><b>mac-address</b></var> (<em>MAC</em>; Default: <b></b>)</td>
     <td><var><b>mac-address</b></var> (<em>MAC</em>; Default: <b></b>)</td>
     <td>Media Access Control number of an interface.</td>
     <td>Media Access Control number of an interface.</td>
</tr>
<tr>
    <td><var><b>master-port</b></var> (<em>name | none</em>; Default: <b>none</b>)</td>
    <td>Sets switch group master interface</td>
</tr>
</tr>
<tr>
<tr>
Line 65: Line 73:


<h3>Read-only properties</h3>
<h3>Read-only properties</h3>
<table class="styled_table">
<tr>
  <th width="40%">Property</th>
  <th >Description</th>
</tr>
<tr>
    <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>
</tr>
<tr>
    <td><var><b>rx-1024-1518</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-128-255</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-1519-max</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-256-511</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-512-1023</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-64</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-65-127</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-align-error</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-broadcast</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-bytes</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-fcs-error</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-fragment</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-multicast</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-overflow</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-pause</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-runt</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>rx-too-long</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <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>
</tr>
<tr>
    <td><var><b>switch</b></var> (<em>integer</em>;)</td>
    <td>ID to which switch chip interface belongs to.</td>
</tr>
<tr>
    <td><var><b>tx-1024-1518</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-128-255</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-1519-max</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-256-511</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-512-1023</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-64</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-65-127</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-align-error</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-broadcast</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-bytes</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-fcs-error</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-fragment</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-multicast</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-overflow</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-pause</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-runt</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
<tr>
    <td><var><b>tx-too-long</b></var> (<em>integer</em>;)</td>
    <td></td>
</tr>
</table>
<h2>Menu specific commands</h2>
<table class="styled_table">
<tr>
  <th width="40%">Property</th>
  <th >Description</th>
</tr>
<tr>
    <td><var><b>blink</b></var> (<em>[id, name]</em>;)</td>
    <td>Blink Ethernet leds</td>
</tr>
<tr>
    <td><var><b>monitor</b></var> (<em>[id, name]</em>;)</td>
    <td>Monitor ethernet status. [[#Monitor | Read more>>]]</td>
</tr>
<tr>
    <td><var><b>reset-counters</b></var> (<em>[id, name]</em>;)</td>
    <td>Reset stats counters. [[#Stats | Read more>>]]</td>
</tr>
<tr>
    <td><var><b>reset-mac</b></var> (<em>[id, name]</em>;)</td>
    <td>Reset MAC address to manufacturers default.</td>
</tr>
</table>
<h2>Stats</h2>
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 [[#Read-only_properties | section above]]<br />
<br />
For example, output of ethernet stats on RB450G:
<pre>
[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


</pre>
</div>
</div>



Revision as of 07:29, 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.

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