Ethernet Interface Commands

interface ethernet <slot>/<port>[/<subport>][-<slot>/<port>[/<subport>]]

Enters the Ethernet interface or Ethernet interface range configuration mode.

switch (config) # interface ethernet 1/1
switch (config) # interface ethernet 1/1) # exit
switch (config) # interface ethernet 1/1-1/10
switch (config) # interface ethernet 1/1-1/10) #

boot-delay [<time>]
no boot-delay

Configures interface boot-delay timer.
The no form of the command returns boot-delay time to its default value.

switch (config interface ethernet 1/1) # boot-delay 60

• This command delays the interface from boot time of the interface
• Configuration save and system reboot is required for the configuration to take effect

default interface ethernet <slot/port>

Resets a port to its default settings

switch (config) # default interface ethernet 1/1

If one of the following configurations exist on the port, the command will be blocked and an informative message will appear.

1. Port is a BGP update source port (when the IP of the port is taken and used as a source IP for BGP routing updates and for TCP connection establishment with neighbor or peer-group).
2. Port is a PIM update source port (when the IP of the port is taken and used as source IP in PIM communications).
3. Port is an IP PIM rp-candidate.
4. Port is an IP PIM bsr-candidate.
5. Port is a member in LAG router port.
6. Port is a member in LAG in NVE mode.

description <string>
no description

Configures an interface description.
The no form of the command returns the interface description to its default value.

switch (config interface ethernet 1/1) # description my-interface

fec-override <fec-configuration> [force]
no fec-override <fec-configuration> [force]

Changes FEC configuration on a specific port or range of ports.
The no form of the command resets this parameter to its default value.

• fc-fec – FireCode FEC
• no-fec – does not use FEC
• rs-fec – Reed Solomon FEC

switch (config interface ethernet 1/1) # fec-override fc-fec

Use this command with caution. There is no limitation in configuring non-standard FEC. It may cause the link to malfunction.

flowcontrol {receive | send} {off | on} [force]

Enables or disables IEEE 802.3x link-level flow control per direction for the specified interface.

• receive – ingresses direction

• send – egresses direction

• on – enables IEEE 802.3x link-level flow control for the specified interface on receive or send
• off – disables IEEE 802.3x link-level flow control for the specified interface on receive or send

config interface ethernet
config interface port-channel
config interface mlag-port-channel

switch (config interface ethernet 1/1) # flowcontrol receive on

To configure global pause please see section “Flowcontrol (Global pause)”.

ip address dhcp
no ip address dhcp

Enables DHCP on this Ethernet interface.

config interface ethernet set as router interface
config interface port-channel set as router interface

switch (config interface ethernet 1/1) # ip address dhcp

load-interval <time>
no load-interval

Sets the interface counter interval.
The no form of the command resets the interval to its default value.

config interface ethernet
config interface port-channel
config interface mlag-port-channel

switch (config interface ethernet 1/1) # load-interval 30

This interval is used for the ingress rate and egress rate counters

Syntax Description

type

force

Force the split operation without asking for user confirmation.

Default

non-split

Configuration Mode

config interface ethernet

History

3.1.1400

3.5.0000

Added note

3.6.3640

Added note

3.6.4006

Added note

• Added QSFP-DD split types
• Removed “module-type qsfp” command

Example

switch (config interface ethernet 1/4) # module-type qsfp-split-4
The following interfaces will be unmapped: 1/4 1/1
Type 'YES' to confirm split: YES

Related Commands

show interfaces ethernet

Notes

mtu <frame-size>

Configures the Maximum Transmission Unit (MTU) frame size for the interface.

Syntax Description

frame-size

Range: 1500-9216 bytes

Default

9216 bytes

Configuration Mode

config interface ethernet
config interface port-channel
config interface mlag-port-channel

History

3.1.0000

3.3.4500

Added MPO configuration mode

Example

switch (config interface ethernet 1/4) # mtu 9216

Related Commands

show interfaces ethernet

Notes

Switches that perform upgrade to version 3.9.2000, existing interfaces will stay with MTU 1500 (or any other value that was configured). Newly created interfaces (created by split/unsplit operation) will be created with MTU 9216 (the new default). The configured and displayed MTU represents the L3 MTU (being used in IP interfaces). The L2 MTU (being used in physical interfaces) is automatically configured as L3 MTU + 22 Bytes.

recirculation [force]
no recirculation

Sets the recirculation port.
The no form of the command unsets the recirculation port.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config interface ethernet

History

3.9.0300

Example

switch (config interface ethernet 1/1) # recirculation force

Related Commands

what-just-happened buffer enable

Notes

This command reduces by 1 the number of monitor sessions that can be configured. It will fail if the maximum number of monitor sessions are already configured.

no recirculation port interface ethernet <port_num>

Disables the recirculation port.

Syntax Description

port_num 

Port number

Default

N/A

Configuration Mode

config

History

3.9.0300

Example

switch (config) # no recirculation port interface ethernet 1/2

Related Commands

recirculation
show recirculation port

Notes

shutdown
no shutdown

Disables the interface.
The no form of the command enables the interface.

Default

Interface is enabled

Configuration Mode

config interface ethernet
config interface port-channel
config interface mlag-port-channel

History

3.1.0000

3.3.4500

Added MPO configuration mode

Example

switch (config interface ethernet 1/4) # shutdown

Related Commands

show interfaces ethernet

Notes

speed {<value> [no-autoneg | speed_value [... speed_value]] | <auto>} [force]
no speed

Sets the speed of the interface.
The no form of the command sets the speed of the interface to its default value.

Syntax Description

value

force

Forces speed change configuration

Default

Depends on the port module type (see the “Notes” section below)

Configuration Mode

config interface ethernet
config interface port-channel
config interface mlag-port-channel

History

3.1.0000

3.5.0000

Added 25GbE, 50GbE, and 100GbE speeds and updated notes

Added no-autoneg parameter

Example

switch (config interface ethernet 1/1) # speed 40G

switch (config interface ethernet 1/2) # speed 40G no-autoneg

switch (config interface ethernet 1/3) # speed 25G no-autoneg force

Notes

clear counters

Clears the interface counters.

Syntax Description

N/A

Default

N/A

Configuration Mode

config interface ethernet
config interface port-channel
config interface mlag-port-channel

History

3.1.0000

3.3.4500

Added MPO configuration mode

Example

switch (config interface ethernet 1/1) # clear counters

Notes

This command also clears NVE counters

show interfaces <type> <id> counters

Displays the extended counters for the interface.

Syntax Description

id

Interface number: <slot>/<port> or <slot>/<port>-<slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.6.1002

Added “error packets” counter to Tx

3.6.4006

Added extended output for storm-control

3.6.5000

Added hoq discard packets counter

Added ability to use a range of ports and added "ECN marked packets" counter

Example

switch (config) # show interfaces ethernet 1/1-1/2 counters

Eth1/1:
 Rx:
 0                     packets
 0                     unicast packets
 0                     multicast packets
 0                     broadcast packets
 0                     bytes
 0                     packets of 64 bytes
 0                     packets of 65-127 bytes
 0                     packets of 128-255 bytes
 0                     packets of 256-511 bytes
 0                     packets of 512-1023 bytes
 0                     packets of 1024-1518 bytes
 0                     packets Jumbo
 0                     discard packets
 0                     error packets
 0                     fcs errors
 0                     undersize packets
 0                     oversize packets
 0                     pause packets
 0                     unknown control opcode
 0                     symbol errors
 0                     discard packets by storm control

Tx:
 0                     packets
 0                     unicast packets
 0                     multicast packets
 0                     broadcast packets
 0                     bytes
 0                     discard packets
 0                     error packets
 0                     hoq discard packets
 0                     pause packets
 0                     pause duration
 0                     ECN marked packets

Eth1/2:

. . .

Related Commands

Notes

show interfaces <type> <id> counters discard

Displays discarded counters of the interface.

Syntax Description

id

Interface number: <slot>/<port> or <slot>/<port>-<slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.6.6102

Example

switch (config) # show interfaces ethernet 1/24 counters discard

Interface Eth1/24:
  Rx:
    0                     discard packets
    0                     error packets
    0                     fcs errors
    0                     undersize packets
    0                     oversize packets
    0                     pause packets
    0                     unknown control opcode
    0                     symbol errors
    0                     discard packets by storm control
    0                     general discard packets
    0                     policy discard packets
    0                     invalid tag packets
    0                     discard packets by vlan filter

  Tx:
    1154059970            discard packets
    0                     error packets
    0                     hoq discard packets
    0                     oversize packets
    0                     policy discard packets
    0                     SLL discard packets
    11500                 no buffer discard mc packets
    0                     discard packets by vlan filter
    0                     discard packets by stp filter
    0                     discard packets by loopback filter

Related Commands

Notes

• Discard Packets counter refers to discards due to insufficient buffer in both RX and TX.
• The "id" attribute is optional. If nothing is selected, information for all ports will be displayed

show interfaces ethernet <inf> [cable-length | capabilities | congestion-control | counters | description | link-diagnostics | pfc-wd | signal-degrade | status | switchport | transceiver]

Displays the configuration and status for the interface.

Syntax Description

inf

Interface number: <slot>/<port> or <slot>/<port>-<slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.6.1002

Added “error packets” counter to Tx, “Last change in operational status”, and “Isolation group” to output

3.6.2002

Added “boot delay” parameters to output

3.6.3640

Added support for “forwarding mode”

3.6.4110

Updated Example with “Forwarding mode”

3.6.5000

Added telemetry to output

3.6.6000

Added output line for “auto-negotiation”

3.6.8008

Updated example

3.6.8100

Updated example

3.7.1100

Updated example and notes

Example

Related Commands

Notes

show interfaces ethernet [<slot/port> | <slot/port>-<slot/port>] counters tc <priority> 

Displays traffic class counters for the specified interface and priority.

switch (config) # show interfaces ethernet 1/1-1/2 counters tc 3

Eth1/1:
TC 3
  0                     packets
  0                     bytes
  0                     queue depth
  0                     unicast no buffer discard
  0                     WRED discard

Eth1/2:
TC 3
  0                     packets
  0                     bytes
  0                     queue depth
  0                     unicast no buffer discard
  0                     WRED discard

As of version 3.9.1000, the "slot/port" attribute is optional. If nothing is selected, information for all ports will be displayed

show interfaces ethernet [<slot/port> | <slot/port>-<slot/port>] counters pg <priority> 

Displays priority group counters for the specified interface and priority.

switch (config) # show interfaces ethernet 1/1-1/2 counters pg 3

Eth1/1:
  PG 0:
    0                     packets
    0                     bytes
    0                     queue depth
    0                     no buffer discard
    0                     shared buffer discard

Eth1/2:
  PG 0:
    0                     packets
    0                     bytes
    0                     queue depth
    0                     no buffer discard
    0                     shared buffer discard

show interfaces ethernet [<inf>] description

Displays the admin status and protocol status for the specified interface.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.4.1100

Updated example

Notes

show interfaces ethernet rates [<transfer-rate-unit>]

Displays the current transfer rate of the interface.

Syntax Description

transfer-rate-unit

• bytes – displays interface transfer rates in B/s dynamically (while converting to K/M/G if needed)
• KB – displays interface transfer rate in Kb/s
• MB – displays interface transfer rate in Mb/s
• GB – displays interface transfer rate in Gb/s
• bits – displays interface transfer rates in b/s dynamically (while converting to K/M/G if needed)
• Kb – displays interface transfer rate in Kb/s
• Mb – displays interface transfer rate in Mb/s
• Gb – displays interface transfer rate in Gb/s
• If no parameter is entered, transfer rate is displayed in bits

Default

N/A

Configuration Mode

Any command mode

History

3.6.2002

3.7.0000

Added new rates to “transfer-rate-unit”

Example

switch (config) # show interfaces ethernet rates KB

Port                        egress                             ingress
                  avg rate (KB/s)   pkts/sec         avg rate (KB/s)   pkts/sec
---------        ----------------   --------         ---------------   --------
Eth1/1                       0            0                 0.032            1
Eth1/2                       0            0                 0.032            1
Eth1/3                       0            0                     0            0
...

Notes

show recirculation port

Shows recirculation port status and information.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.9.0300

Example

switch (config) # show recirculation port

Notes

show interfaces ethernet [<inf>] status

Displays the status, speed and negotiation mode of the specified interface.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.4.1100

Updated example

Example

Notes

show interfaces ethernet [<inf>] transceiver

Displays transceiver information.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show interfaces ethernet status

Port                   Operational state           Speed                  Negotiation
----                   -----------------           -----                  -----------
Eth1/58                Down                        40 Gbps             No-Negotiation
Eth1/59                Up                          40 Gbps             No-Negotiation
Eth1/60                Down (Suspend)              40 Gbps             No-Negotiation

switch (config) # show interfaces ethernet 1/1 transceiver
Port 1/1 state
        identifier             : QSFP+
        cable/module type      : Optical cable/module
        ethernet speed and type: 40GBASE - SR4
        vendor                 : Mellanox
        cable_length           : 50 m
        part number            : MC2210411-SR4
        revision               : A1
        serial number          : TT1151-00006

Notes

show interfaces ethernet [<inf>] transceiver brief

Display brief transceiver information.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.6.6102

Example

switch (config) # show interfaces ethernet 1/1 transceiver brief
show interfaces ethernet transceiver brief 

----------------------------------------------------------------------------------------
Interface       Identifier      Vendor           PN               SN               Rev   
----------------------------------------------------------------------------------------
Eth1/1                                                                              
Eth1/2          QSFP+           Mellanox         MCP1600-E00A     MT1710VS06916    A3
Eth1/3          QSFP+           Mellanox         MCP1600-E00A     MT1710VS06929    A3
Eth1/4          QSFP+           Mellanox         MCP1600-E00A     MT1710VS06953    A3
Eth1/5          QSFP+           Mellanox         MCP1600-E00A     MT1710VS06923    A3

Notes

show interfaces ethernet [<inf>] transceiver counters

 Displays PHY counters related to operational FEC mode and actual number of lanes in the current port.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.6.1002

Example

switch (config) # show interfaces ethernet 1/1 transceiver counters
 
    Rx
    phy received bits            398503339622400
    phy symbol errors            0
    phy corrected bits           0
    Time since last clear        0
    Edpl/bip errors lane0        0 
    Edpl/bip errors lane1        0
    Edpl/bip errors lane2        0
    Edpl/bip errors lane3        0
    raw_ber_magnitude            9
    raw_ber_coef                 1
    effective_ber_magnitude      255
    effective_ber_coef           15

• The counter “phy received bits” provides information on the total amount of traffic received and can be used to estimate the ratio of error traffic
• The counter “phy symbol errors” provides information on the error traffic that was not corrected because the FEC algorithm could not do it or because FEC was not active on this interface
• The counter “phy corrected bits” provides the number of corrected bits by the active FEC mode (RS/FC)
• The counter "Time since last clear" provides the time passed since the last counters clear event in msec
• The counter "Edpl/bip errors lane*" provides the NO FEC corrected counter value on appropriate lane
• The counter "FC corrected blocks lane*" provides the FC FEC corrected counter value on appropriate lane
• The counter "RS corrected symbols lane*" provides the RS FEC corrected counter value on appropriate lane
• The counter "raw_ber_magnitude" provides the BER magnitude value for total number of errors. Used for BER calculation - Raw_BER = raw_ber_coef * 10^(-raw_ber_magnitude)
• The counter "raw_ber_coef" provides the BER coefficient value for total number of errors
• The counter "effective_ber_magnitude" provides the BER magnitude value for effective number of errors. Used for BER calculation - Effective_BER = effective_ber_coef * 10^(-effective_ber_magnitude)
• The counter "effective_ber_coef" provides the BER coefficient value for effective number of errors

show interfaces ethernet [<inf>] transceiver counters

Displays all PHY counters.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.6.1002

Example

switch (config) # show interfaces ethernet 1/1 transceiver counters details

Phy counters
Symbol errors                   0
Sync headers errors             0
Edpl/bip errors lane0           0
Edpl/bip errors lane1           0
Edpl/bip errors lane2           0
Edpl/bip errors lane3           0
FC corrected blocks lane0       0
FC corrected blocks lane1       0
FC corrected blocks lane2       0
FC corrected blocks lane3       0
FC uncorrectable blocks lane0   0
FC uncorrectable blocks lane1   0
FC uncorrectable blocks lane2   0
FC uncorrectable blocks lane3   0
RS corrected blocks             0
RS uncorrectable blocks         0
RS no errors blocks             0
RS single error blocks          0
RS corrected symbols total      0
RS corrected symbols lane0      0
RS corrected symbols lane1      0
RS corrected symbols lane2      0
RS corrected symbols lane3      0
Link down events                0
Successful recovery events      0
Time since last clear           3545366

The number of lanes displayed depends on interface splitter ratio (4-way-split – each split has only 1 lane; 2-way-split – each split has 2 lanes)

As of 3.10.3000, this command is deprecated. Please use the command "show interfaces ethernet transceiver counters" instead.

show interfaces ethernet [<inf>] transceiver diagnostics

Displays cable channel monitoring and diagnostics info for this interface. Tx and Rx power are reported in mW and dBm units.

Syntax Description

inf

Interface number: <slot>/<port>

Default

N/A

Configuration Mode

Any command mode

History

3.6.2002

3.6.4006

Updated Example to report Tx and Rx power in mW and dBm units

3.6.6000

Updated Example

Example

switch (config) # show interfaces ethernet 1/5 transceiver diagnostics

Port 1/5 transceiver diagnostic data:
  Temperature (-127C to +127C):
    Temperature          : 26 C
    Hi Temp Alarm Thresh : 80 C
    Low Temp Alarm Thresh: -10 C
    Temperature Alarm    : None

  Voltage ( 0 to 6.5535 V):
    Voltage              : 3.28980 V
    Hi Volt Alarm Thresh : 3.50000 V
    Low Volt Alarm Thresh: 3.10000 V
    Voltage Alarm        : None

  Tx Bias Current ( 0 to 131 mA):
    Ch1 Tx Current          : 6.60000 mA
    Ch2 Tx Current          : 6.60000 mA
    Ch3 Tx Current          : 6.60000 mA
    Ch4 Tx Current          : 6.60000 mA
    Hi Tx Crnt Alarm Thresh : 8.50000 mA
    Low Tx Crnt Alarm Thresh: 5.49200 mA
    Ch1 Tx Current Alarm    : None
    Ch2 Tx Current Alarm    : None
    Ch3 Tx Current Alarm    : None
    Ch4 Tx Current Alarm    : None

  Tx Power ( 0 mW to 6.5535 mW / 8.1647 dBm):
    Ch1 Tx Power             : 1.01420 mW / 0.06124 dBm
    Ch2 Tx Power             : 0.96740 mW / -0.14394 dBm
    Ch3 Tx Power             : 0.96730 mW / -0.14439 dBm
    Ch4 Tx Power             : 0.96050 mW / -0.17503 dBm
    Hi Tx Power Alarm Thresh : 3.46730 mW / 5.39991 dBm
    Low Tx Power Alarm Thresh: 0.07240 mW / -11.40261 dBm
    Ch1 Tx Power Alarm       : None
    Ch2 Tx Power Alarm       : None
    Ch3 Tx Power Alarm       : None
    Ch4 Tx Power Alarm       : None

  Rx Power ( 0 mW to 6.5535 mW / 8.1647 dBm):
    Ch1 Rx Power             : 0.99160 mW / -0.03663 dBm
    Ch2 Rx Power             : 1.06080 mW / 0.25633 dBm
    Ch3 Rx Power             : 1.09810 mW / 0.40642 dBm
    Ch4 Rx Power             : 0.97500 mW / -0.10995 dBm
    Hi Rx Power Alarm Thresh : 3.46730 mW / 5.39991 dBm
    Low Rx Power Alarm Thresh: 0.04670 mW / -13.30683 dBm
    Ch1 Rx Power Alarm       : None
    Ch2 Rx Power Alarm       : None
    Ch3 Rx Power Alarm       : None
    Ch4 Rx Power Alarm       : None

  Vendor Date Code (dd-mm-yyyy): 07-11-2016

Notes

This example is for a QSFP transceiver

show interfaces status 

Displays the configuration and status for the interface.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.6.4006

Related Commands

Note

disable interface ethernet <inf> traffic-class <tc> congestion-control

interface ethernet <inf> disable traffic-class <tc> congestion-control

Disables RED/ECN marking for traffic-class queue on ethernet port.

Syntax Description

inf

Default

N/A

Configuration Mode

config

History

3.8.2000

Example

switch (config) # disable interface ethernet  1/1  traffic-class 5 congestion-control

switch (config) # interface ethernet  1/1  disable traffic-class 5 congestion-control

Notes

The “no interface ethernet <inf> traffic-class <tc> congestion-control” command returns configuration on the port to its default value.

disable interface port-channel <inf> traffic-class <tc> congestion-control

Disables RED/ECN marking for traffic-class queue on LAG port.

Syntax Description

inf

Default

N/A

Configuration Mode

config

History

3.8.2000

Example

switch (config) # disable interface port-channel 15  traffic-class 5 congestion-control

switch (config) # interface port-channel  15  disable traffic-class 5 congestion-control

Notes

The “no interface port-channel <inf> traffic-class <tc> congestion-control” command returns configuration on the port to its default value.

disable interface mlag-port-channel <inf> traffic-class <tc> congestion-control
interface mlag-port-channel <inf> disable traffic-class <tc> congestion-control

Disables RED/ECN marking for traffic-class queue on MLAG port.

Syntax Description

inf

Default

N/A

Configuration Mode

config

History

3.8.2000

Example

switch (config) # disable interface mlag-port-channel  1  traffic-class 5 congestion-control

switch (config) # interface mlag-port-channel 1 disable traffic-class 5 congestion-control

Notes

The “no interface mlag-port-channel <inf> traffic-class <tc> congestion-control” command returns configuration on the port to a default value.