ratio: Maximum percentage of broadcast traffic to the total transmission capability of an Ethernet interface, in the range 1 to 100. The smaller the ratio, the less broadcast traffic is allowed to pass through the interface.

pps max-pps: Specifies the maximum number of broadcast packets that can be forwarded on the Ethernet interface(s) per second.

l For a 100-Mbps port, this value ranges from 1 to 148810 (in pps).

l For a 1-Gbps port, this value ranges from 1 to 1488100 (in pps).

l For a 10-Gbps port, this value ranges from 1 to 14881000 (in pps).

Note that:

l When a suppression granularity larger than 1 is specified on the device, the value of the pps keyword should be no smaller than and an integral multiple of the granularity. The broadcast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual broadcast suppression threshold value on an Ethernet interface, you can use the display interface command.

l When no suppression granularity is specified or the suppression granularity is set to 1, the value of the pps or keyword should be no smaller than 1, and the broadcast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Description

Use the broadcast-suppression command to set a broadcast traffic threshold on one or multiple Ethernet ports.

Use the undo broadcast-suppression command to restore the default.

By default, all broadcast traffic is allowed to pass through an Ethernet interface, that is, broadcast traffic is not suppressed.

If you execute this command in Ethernet interface, the configuration takes effect only on the current interface. If you execute this command in port-group view, the configuration takes effect on all the ports in the port group.

When broadcast traffic exceeds the broadcast traffic threshold, the system begins to discard broadcast packets until the broadcast traffic drops below the threshold to ensure operation of network services.

l If you set different suppression ratios in Ethernet interface view or port-group view for multiple times, the latest configuration takes effect.

l Do not use the broadcast-suppression command along with the storm-constrain command. Otherwise, the broadcast storm suppression ratio configured may get invalid.

l On an Ethernet port enabled with broadcast storm suppression ratio, this feature takes effect only in the inbound direction.

Examples

# For Ethernet interface Ethernet 2/0/1, allow broadcast traffic equivalent to 20% of the total transmission capability of Ethernet 2/0/1 to pass.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] broadcast-suppression 20

# For all the ports of the manual port group named group1, allow broadcast traffic equivalent to 20% of the total transmission capability of each port to pass and suppress excessive broadcast packets.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/2

[Sysname-port-group-manual-group1] broadcast-suppression 20

description

Syntax

description text

undo description

View

Ethernet interface view

Default Level

2: System level

Parameters

text: Description of an Ethernet interface, a string of 1 to 80 characters. Currently, the device supports the following types of characters or symbols: standard English characters (numbers and case-sensitive letters), special English characters, spaces, and other characters or symbols that conform to the Unicode standard.

l A port description can be the mixture of English characters and other Unicode characters. The mixed description cannot exceed the specified length.

l To use a type of Unicode characters or symbols in a port description, you need to install the corresponding Input Method Editor (IME) and log in to the device through remote login software that supports this character type.

l Each Unicode character or symbol (non-English characters) takes the space of two regular characters. When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character into two. As a result, garbled characters may be displayed at the end of a line.

Description

Use the description command to set the description string of the current interface.

Use the undo description command to restore the default.

By default, the description of an interface is the interface name followed by the “interface” string, Ethernet2/0/1 Interface for example.

Related commands: display interface.

Examples

# Configure the description string of interface Ethernet 2/0/1 as lanswitch-interface.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] description lanswitch-interface

display brief interface

Syntax

display brief interface [ interface-type [ interface-number ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default Level

1: Monitor level

Parameters

interface-type: Type of a specified interface.

interface-number: Number of a specified interface.

|: Uses a regular expression to filter output information. For detailed description on regular expression, refer to Basic System Configuration in the System Volume.

begin: Displays the line that matches the regular expression and all the subsequent lines.

exclude: Displays the lines that do not match the regular expression.

include: Displays the lines that match the regular expression.

regular-expression: Regular expression, a string of 1 to 256 characters. Note that this argument is case-sensitive.

Description

Use the display brief interface command to display brief interface information.

l If neither interface type nor interface number is specified, all interface information will be displayed.

l If only interface type is specified, then only information of this particular type of interface will be displayed.

l If both interface type and interface number are specified, then only information of the specified interface will be displayed.

Related commands: interface.

Examples

# Display the brief information of interfaces.

<Sysname> display brief interface

The brief information of interface(s) under route mode:

Interface Link Protocol-link Protocol type Main IP

Loop0 UP UP(spoofing) LOOP 2.2.2.9

Loop1 UP UP(spoofing) LOOP --

Loop2 UP UP(spoofing) LOOP --

M-E0/0/0 DOWN DOWN ETHERNET --

NULL0 UP UP(spoofing) NULL --

Tun3/0/20 DOWN DOWN TUNNEL --

Vlan1 UP UP ETHERNET 192.168.0.73

Vlan2 DOWN DOWN ETHERNET 10.1.1.2

Vlan3 DOWN DOWN ETHERNET 20.1.1.1

Vlan100 DOWN DOWN ETHERNET --

Vlan200 UP DOWN ETHERNET --

The brief information of interface(s) under bridge mode:

Interface Link Speed Duplex Link-type PVID

BAGG1 DOWN auto auto access 1

Eth3/0/1 UP 100M(a) full(a) access 100

Eth3/0/2 UP 100M(a) full(a) access 200

Eth3/0/3 DOWN auto auto hybrid 3

Eth3/0/4 DOWN auto auto access 1

Eth3/0/5 DOWN auto auto access 1

Eth3/0/6 DOWN auto auto access 1

Eth3/0/7 DOWN auto auto access 1

Eth3/0/8 DOWN auto auto access 1

Eth3/0/9 DOWN auto auto access 1

Eth3/0/10 DOWN auto auto access 1

# Display the information of interfaces beginning with the string “spoof”.

<Sysname> display brief interface | begin spoof

The brief information of interface(s) under route mode:

Interface Link Protocol-link Protocol type Main IP

Loop0 UP UP(spoofing) LOOP 2.2.2.9

Loop1 UP UP(spoofing) LOOP --

Loop2 UP UP(spoofing) LOOP --

M-E0/0/0 DOWN DOWN ETHERNET --

NULL0 UP UP(spoofing) NULL --

Tun3/0/20 DOWN DOWN TUNNEL --

Vlan1 UP UP ETHERNET 192.168.0.73

Vlan2 DOWN DOWN ETHERNET 10.1.1.2

Vlan3 DOWN DOWN ETHERNET 20.1.1.1

Vlan100 DOWN DOWN ETHERNET --

Vlan200 UP DOWN ETHERNET --

# Display the brief information of all UP interfaces.

<Sysname> display brief interface | include UP

The brief information of interface(s) under route mode:

Interface Link Protocol-link Protocol type Main IP

Loop0 UP UP(spoofing) LOOP 2.2.2.9

Loop1 UP UP(spoofing) LOOP --

Loop2 UP UP(spoofing) LOOP --

NULL0 UP UP(spoofing) NULL --

Vlan1 UP UP ETHERNET 192.168.0.73

Vlan200 UP DOWN ETHERNET --

The brief information of interface(s) under bridge mode:

Interface Link Speed Duplex Link-type PVID

Eth3/0/1 UP 100M(a) full(a) access 100

Eth3/0/2 UP 100M(a) full(a) access 200

Eth3/0/48 UP 100M(a) full(a) access 1

# Display the brief information of all interfaces excluding Ethernet interfaces.

<Sysname> display brief interface | exclude Eth

The brief information of interface(s) under route mode:

Interface Link Protocol-link Protocol type Main IP

Loop0 UP UP(spoofing) LOOP 2.2.2.9

Loop1 UP UP(spoofing) LOOP --

Loop2 UP UP(spoofing) LOOP --

M-E0/0/0 DOWN DOWN ETHERNET --

NULL0 UP UP(spoofing) NULL --

Tun3/0/20 DOWN DOWN TUNNEL --

Vlan1 UP UP ETHERNET 192.168.0.73

Vlan2 DOWN DOWN ETHERNET 10.1.1.2

Vlan3 DOWN DOWN ETHERNET 20.1.1.1

Vlan100 DOWN DOWN ETHERNET --

Vlan200 UP DOWN ETHERNET --

The brief information of interface(s) under bridge mode:

Interface Link Speed Duplex Link-type PVID

BAGG1 DOWN auto auto access 1

Table 1-1 display brief interface command output description

Field	Description
The brief information of interface(s) under route mode:	Brief information of interface(s) in route mode
Interface	Abbreviated interface name
Link	Interface physical link state, which can be up or down
Protocol-link	Interface protocol link state, which can be up or down
Protocol type	Interface protocol type
Main IP	Main IP
The brief information of interface(s) under bridge mode:	Brief information of interface(s) in bridge mode
Speed	Interface rate, in bps
Duplex	Duplex mode, which can be half (half duplex), full (full duplex), or auto (auto-negotiation).
PVID	Default VLAN ID

display interface

Syntax

display interface [ interface-type [ interface-number ] ]

View

Any view

Default Level

1: Monitor level

Parameters

interface-type: Type of a specified interface.

interface-number: Number of a specified interface.

Description

Use the display interface command to display the current state of a specified interface and related information.

l If neither interface type nor interface number is specified, all interface information will be displayed.

l If only interface type is specified, then only information of this particular type of interface will be displayed.

l If both interface type and interface number are specified, then only information of the specified interface will be displayed.

Related commands: interface.

Examples

# Display the current state of Layer 2 interface Ethernet 2/0/1 and related information.

<Sysname> display interface ethernet 2/0/1

Ethernet2/0/1 current state: DOWN

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e200-8048

Description: Ethernet2/0/1 Interface

Loopback is not set

Media type is twisted pair, port hardware type is 100_BASE_TX

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

The Maximum Frame Length is 9022

Broadcast MAX-ratio: 100%

Unicast MAX-ratio: 100%

Multicast MAX-ratio: 100%

Allow jumbo frame to pass

PVID: 100

Mdi type: auto

Link delay is 10(sec)

Port link-type: access

Tagged VLAN ID : none

Untagged VLAN ID : 100

Port priority: 0

Last 300 seconds input: 0 packets/sec 0 bytes/sec -%

Last 300 seconds output: 0 packets/sec 0 bytes/sec -%

Input (total): 0 packets, 0 bytes

0 broadcasts, 0 multicasts

Input (normal): 0 packets, - bytes

0 broadcasts, 0 multicasts

Input: 0 input errors, 0 runts, 0 giants, 0 throttles

0 CRC, 0 frame, - overruns, 0 aborts

- ignored, - parity errors

Output (total): 0 packets, 0 bytes

0 broadcasts, 0 multicasts, 0 pauses

Output (normal): 0 packets, - bytes

0 broadcasts, 0 multicasts, 0 pauses

Output: 0 output errors, - underruns, - buffer failures

0 aborts, 0 deferred, 0 collisions, 0 late collisions

0 lost carrier, - no carrier

Table 1-2 display interface command output description

Field	Description
Ethernet2/0/1 current state	Current physical link state of the Ethernet port
IP Packet Frame Type	Frame type of the Ethernet port
Description	Description of the interface
Unknown-speed mode	Unknown-speed mode, in which mode speed is negotiated between the current host and the peer.
unknown-duplex mode	Unknown-duplex mode, in which mode speed is negotiated between the current host and the peer.
The Maximum Frame Length	The maximum frame length allowed on an interface
Broadcast MAX-ratio	Broadcast storm suppression ratio (the maximum ratio of allowed number of broadcast packets to overall traffic through an interface)
Unicast MAX-ratio	Unicast storm suppression ratio (the maximum ratio of allowed number of unknown unicast packets to overall traffic over an interface)
Multicast MAX-ratio	Multicast storm suppression ratio (the maximum ratio of allowed number of multicast packets to overall traffic through an interface)
PVID	Default VLAN ID
Mdi type	Cable type
Link delay	The suppression time of physical-link-down-state changes
Port link-type	Interface link type, which could be access, trunk, and hybrid.
Tagged VLAN ID	VLANs whose packets are sent through the port with VLAN tag kept
Untagged VLAN ID	VLANs whose packets are sent through the port with VLAN tag stripped off
Last 300 seconds input: 0 packets/sec 0 bytes/sec Last 300 seconds output: 0 packets/sec 0 bytes/sec	Average rate of input and output traffic in the last 300 seconds, in pps and Bps
Input (total): 0 packets, 0 bytes 0 broadcasts, 0 multicasts	Packet statistics on the inbound direction of the interface, including the statistics of normal packets, and abnormal packets, in packets and bytes Number of broadcast packets, and multicast packets on the inbound direction of the interface
Input (normal): 0 packets, - bytes 0 broadcasts, 0 multicasts	Normal packet statistics on the inbound direction of the interface, including the statistics of normal packets and pause frames, in packets and bytes Number of broadcast packets, and multicast packets on the inbound direction of the interface.
input errors	Input packets with errors
runts	Frames received that were shorter than 64 bytes, yet in correct formats, and contained valid CRCs
giants	Frames received that were longer than 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags)
throttles	The number of times the receiver on the interface was disabled, possibly because of buffer or CPU overload
CRC	Total number of packets received that had a normal length, but contained checksum errors
frame	Total number of frames that contained checksum errors and a non-integer number of bytes
- overruns	Number of times the receive rate of the interface exceeded the capacity of the input queue, causing packets to be discarded
aborts	Total number of illegal packets received, including: l Fragment frames: Frames that were shorter than 64 bytes (with an integral or non-integral length) and contained checksum errors l Jabber frames: Frames that were longer than 1518 or 1522 bytes and contained checksum errors (the frame lengths in bytes may or may not be integers) l Symbol error frames: Frames that contained at least one undefined symbol l Unknown operation code frames: Frames that were MAC control frames but not pause frames l Length error frames: Frames whose 802.3 length fields did not match the actual frame lengths (46 bytes to 1500 bytes)
- ignored	Number of received packets ignored by the interface because the interface hardware ran low on internal buffers
- parity errors	Total number of frames with parity errors
Output (total): 0 packets, 0 bytes 0 broadcasts, 0 multicasts, 0 pauses	Packet statistics on the outbound direction of the interface, including the statistics of normal packets, abnormal packets, and normal pause frames, in packets and bytes Number of broadcast packets, multicast packets, and pause frames on the outbound direction of the interface
Output (normal): 0 packets, - bytes 0 broadcasts, 0 multicasts, 0 pauses	Normal packet statistics on the outbound direction of the interface, including the statistics of normal packets and pause frames, in packets and bytes Number of broadcast packets, multicast packets, and pause frames on the outbound direction of the interface.
output errors	Output packets with errors
- underruns	Number of times the transmit rate of the interface exceeded the capacity of the output queue, causing packets to be discarded. This is a very rare hardware-related problem.
- buffer failures	Number of packets dropped because the interface ran low on output buffers
aborts	Number of packets that failed to be transmitted due to causes such as Ethernet collisions
deferred	Number of frames whose first transmission attempt was delayed, due to traffic on the network media, and that were successfully transmitted later
collisions	Number of times frames were delayed due to Ethernet collisions detected during the transmission
late collisions	Number of times frames were delayed due to the detection of collisions after the first 512 bits of the frames were already on the network
lost carrier	Number of times the carrier was lost during transmission. This counter applies to serial WAN interfaces.
- no carrier	Number of times the carrier was not present in the transmission. This counter applies to serial WAN interfaces.

“-“ indicates that the corresponding entry is not supported.

display loopback-detection

Syntax

display loopback-detection

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display loopback-detection command to display loopback detection information on a port.

If loopback detection is already enabled, this command will also display the detection interval and information on the ports currently detected with a loopback.

Examples

# Display loopback detection information on a port.

<Sysname> display loopback-detection

Loopback-detection is running

Detection interval time is 30 seconds

No port is detected with loopback

Table 1-3 display loopback-detection command output description

Field	Description
Loopback-detection is running	Loopback-detection is running.
Detection interval time is 30 seconds	Detection interval is 30 seconds.
No port is detected with loopback	No port is currently being detected with a loopback.

display port combo

Syntax

display port combo

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display port combo command to display the Combo ports of a device and the corresponding optical ports and electrical ports.

Examples

# Display the Combo ports of the device and the corresponding optical ports and electrical ports.

<Sysname> display port combo

Combo-group Active Inactive

1 GigabitEthernet0/0/25 GigabitEthernet0/0/18

2 GigabitEthernet0/0/26 GigabitEthernet0/0/17

3 GigabitEthernet0/0/27 GigabitEthernet0/0/20

4 GigabitEthernet0/0/28 GigabitEthernet0/0/19

5 GigabitEthernet0/0/29 GigabitEthernet0/0/22

6 GigabitEthernet0/0/30 GigabitEthernet0/0/21

7 GigabitEthernet0/0/31 GigabitEthernet0/0/24

8 GigabitEthernet0/0/32 GigabitEthernet0/0/23

Table 1-4 display port combo command output description

Field	Description
Combo-group	Combo ports of the device, represented by Combo port number, which is generated by the system.
Active	Ports of the Combo ports that are active
Inactive	Ports of the Combo ports that are inactive

As for the optical port and the electrical port of a Combo port, the one with the smaller port number is active by default. The port number varies with device models. You can determine whether a port is an optical port or an electrical port by checking the “Media type is” field of the display interface command.

display port-group manual

Syntax

display port-group manual [ all | name port-group-name ]

View

Any view

Default Level

2: System level

Parameters

all: Specifies all the manual port groups.

name port-group-name: Specifies the name of a manual port group, a string of 1 to 32 characters.

Description

Use the display port-group manual command to display the information about a manual port group or all the manual port groups.

l If you provide the port-group-name argument, this command displays the details for a specified manual port group, including its name and the Ethernet interface ports included.

l If you provide the all keyword, this command displays the details for all manual port groups, including their names and the Ethernet interface ports included.

l Absence of parameters indicates that the names of all the port groups will be displayed.

Examples

# Display the names of all the port groups.

<Sysname> display port-group manual

The following manual port group exist(s):

1 2

# Display details of all the manual port groups.

<Sysname> display port-group manual all

Member of 1:

Ethernet2/0/1 Ethernet2/0/2 Ethernet2/0/3

Member of 2:

None

# Display details of the port group named group1.

Member of 1:

Ethernet2/0/1 Ethernet2/0/2 Ethernet2/0/3

Table 1-5 display port-group manual command output description

Field	Description
Member of group	Member of the manual port group

display storm-constrain

Syntax

display storm-constrain [ broadcast | multicast | unicast ] [ interface interface-type interface-number ]

View

Any view

Default Level

1: Monitor level

Parameters

broadcast: Displays the information about storm constrain for broadcast packets.

multicast: Displays the information about storm constrain for multicast packets.

unicast: Displays the information about storm constrain for unicast packets.

interface interface-type interface-number: Specifies an interface by its type and number.

Description

Use the display storm-constrain command to display the information about storm constrain.

If you provide no argument or keyword, this command displays the information about storm constrain for all types of packets on all the interfaces.

Examples

# Display the information about storm constrain for all types of packets on all the interfaces.

<Sysname> display storm-constrain

Flow Statistic Interval: 10(second)

PortName StormType LowerLimit UpperLimit Ctr-mode Status Trap Log Swi-num

--------------------------------------------------------------------------

Eth2/0/5 broadcast 10 500 N/A normal on on 0

Table 1-6 display storm-constrain command output description

Field	Description
Flow Statistic Interval	Interval for generating storm constrain statistics
PortName	Abbreviated port name
StormType	Type of the packets for which storm constrain function is enabled, which can be broadcast (for broadcast packets), multicast (for multicast packets), and unicast (for unicast packets).
LowerLimit	Lower threshold (in pps)
UpperLimit	Upper threshold (in pps)
Ctr-mode	Action to be taken when the upper threshold is reached, which can be block, shutdown, and N/A.
Status	Interface state, which can be normal (indicating the interface operates properly), control (indicating the interface is blocked or shut down).
Trap	State of trap messages sending. “on” indicates trap message sending is enabled; “off” indicates trap message sending is disabled.
Log	State of log sending. “on” indicates log sending is enabled; “off” indicates log sending is disabled.
Swi-num	Number of the forwarding state switching. This field is numbered modulo 65,535.

duplex

Syntax

duplex { auto | full | half }

undo duplex

View

Ethernet interface view

Default Level

2: System level

Parameters

auto: Indicates that the interface is in auto-negotiation state.

full: Indicates that the interface is in full-duplex state.

half: Indicates that the interface is in half-duplex state. The optical interface of a Combo port does not support the half keyword.

Description

Use the duplex command to configure the duplex mode for an Ethernet interface.

Use the undo duplex command to restore the duplex mode for an Ethernet interface to the default.

By default, the duplex mode for an Ethernet interface is auto.

Related commands: speed.

Examples

# Configure the interface Ethernet 2/0/1 to work in full-duplex mode.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] duplex full

flow-control

Syntax

flow-control

undo flow-control

View

Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the flow-control command to enable flow control on an Ethernet interface.

Use the undo flow-control command to disable flow control on an Ethernet interface.

By default, flow control on an Ethernet interface is disabled.

The flow control function takes effect on the local Ethernet interface only when it is enabled on both the local and peer devices.

Examples

# Enable flow control on interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] flow-control

flow-interval

Syntax

flow-interval interval

undo flow-interval

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

interval: Time interval at which interface statistics are collected, in the range of 5 to 300 seconds, a multiple of 5. The default value is 300 seconds.

Description

Use the flow-interval command to configure the time interval for collecting interface statistics.

Use the undo flow-interval command to restore the default interval.

Examples

# Set the time interval for collecting interface statistics to 100 seconds.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] flow-interval 100

group-member

Syntax

group-member interface-list

undo group-member interface-list

View

Port group view

Default Level

2: System level

Parameters

interface-list: Ethernet interface list, in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where &<1-10> indicates that you can specify up to 10 port or port ranges.

Description

Use the group-member command to add an Ethernet interface to a specified manual port group.

Use the undo group-member command to remove a specified Ethernet interface from a manual port group.

By default, there is no Ethernet interface in a manual port group.

Examples

# Add interface Ethernet 2/0/1 to the manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/1

interface

Syntax

interface interface-type interface-number

View

System view

Default Level

2: System level

Parameters

interface-type interface-number : Interface type and interface number.

Description

Use the interface command to enter interface.

Examples

# Enter Ethernet 2/0/1 interface view (assuming that the interface is a Layer 2 Ethernet interface).

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1]

jumboframe enable

Syntax

jumboframe enable [ value ]

undo jumboframe enable

View

Layer 2 Ethernet interface view, port group view

Default Level

2: System level

Parameters

value: Maximum length of Ethernet frames that are allowed to pass through. The effective range is 1,536 to 9,216 (in bytes).

Description

Use the jumboframe enable command to allow jumbo frames with the specified length to pass through an Ethernet interface.

Use the undo jumboframe enable command to prevent jumbo frames from passing through an Ethernet interface. That is, the maximum length of the frames allowed to pass through an Ethernet interface is 1518 bytes.

By default, the device allows frames no larger than 1536 bytes to pass through an Ethernet interface.

You can configure length of jumbo frames in global configuration mode (in system view) or on a port (in Ethernet interface view, port-group view) to allow them to pass through Ethernet interfaces.

l Execution of this command under Ethernet interface view will only apply the configurations to the current Ethernet interface.

l Execution of this command under port group view will apply the configurations to the Ethernet interface(s) in the port group.

The latest configuration takes effect if you configure the value argument for multiple times in Ethernet interface view or port-group view.

Examples

# Enable jumbo frames to pass through all the Ethernet interfaces in the manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group manual group1] group-member ethernet 2/0

[Sysname-port-group manual group1] jumboframe enable

# Enable jumbo frames to pass through Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] jumboframe enable

link-delay

Syntax

link-delay delay-time

undo link-delay

View

Ethernet interface view

Default Level

2: System level

Parameters

delay-time: Up/down suppression time for the physical connection of the Ethernet interface (in seconds), in the range 0 to 30.

Description

Use the link-delay command to configure the suppression time of physical-link-state changes on the Ethernet Interface.

Use the undo link-delay command to restore the default suppression time.

By default, the suppression time is 0 second, that is, the physical layer will report physical-link-state changes without delay.

Examples

# Set the up/down suppression time of the physical connection of interface Ethernet 2/0/1 to 8 seconds.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] link-delay 8

loopback

Syntax

loopback { external | internal }

undo loopback

View

Ethernet interface view

Default Level

2: System level

Parameters

external: Enables external loopback testing on an Ethernet interface.

internal: Enables internal loopback testing on an Ethernet interface.

Description

Use the loopback command to enable Ethernet interface loopback testing.

Use the undo loopback command to disable Ethernet interface loopback testing.

By default, Ethernet interface loopback testing is disabled.

l Ethernet interface loopback testing should be enabled while testing certain functionalities, such as during the initial identification of any network failure.

l While enabled, Ethernet interface loopback testing will work in full-duplex mode. The interface will return to its original state upon completion of the loopback testing.

Examples

# Enable loopback testing on Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] loopback internal

loopback-detection control enable

Syntax

loopback-detection control enable

undo loopback-detection control enable

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the loopback-detection control enable command to enable loopback detection for a Trunk port or Hybrid port.

Use the undo loopback-detection control enable command to restore the default.

By default, loopback detection for a Trunk port or Hybrid port is disabled.

Note that this command is inapplicable to an Access port as its loopback detection is enabled by default.

Examples

# Enable loopback detection for the trunk port Ethernet 2/0/1.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] port link-type trunk

[Sysname-Ethernet2/0/1] loopback-detection enable

[Sysname-Ethernet2/0/1] loopback-detection control enable

loopback-detection enable

Syntax

loopback-detection enable

undo loopback-detection enable

View

System view, Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the loopback-detection enable command to enable loopback detection globally or on a specified port.

Use the undo loopback-detection enable command to disable loopback detection globally or on a specified port.

By default, loopback detection is disabled for an Access, Trunk, or Hybrid port.

With loopback detection enabled on a port (whose link type may be Access, Trunk, or Hybrid):

l If an Access port has been detected with loopback, it will transit to the loopback detection control state, where the incoming packets of the port are dropped and the outgoing packets of the port are forwarded normally. A Trap message will be sent to the terminal and the corresponding MAC address.

l If a Trunk port or Hybrid port has been detected with loopback, a Trunk message will be sent to the terminal. If the loopback detection control function is enabled on the port, the port will transit to the loopback detection control state, where the incoming packets of the port are dropped and the outgoing packets of the port are forwarded normally. In addition, a Trap message will be sent to the terminal and the corresponding MAC address forwarding entries will be deleted.

Related commands: loopback-detection control enable.

l Loopback detection on a given port is enabled only after the loopback-detection enable command has been configured in both system view and interface view of the port.

l Loopback detection on all ports will be disabled after the configuration of the undo loopback-detection enable command in system view.

Examples

# Enable loopback detection on the interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] loopback-detection enable

loopback-detection interval-time

Syntax

loopback-detection interval-time time

undo loopback-detection interval-time

View

System view

Default Level

2: System level

Parameters

time: Time interval for performing port loopback detection, in the range 5 to 300 (in seconds).

Description

Use the loopback-detection interval-time command to configure time interval for performing port loopback detection.

Use the undo loopback-detection interval-time command to restore the default time interval for port loopback detection, which is 30 seconds.

Related commands: display loopback-detection.

Examples

# Set the time interval for performing port loopback detection to 10 seconds.

<Sysname> system-view

[Sysname] loopback-detection interval-time 10

loopback-detection per-vlan enable

Syntax

loopback-detection per-vlan enable

undo loopback-detection per-vlan enable

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the loopback-detection per-vlan enable command to enable loopback detection in all VLANs with Trunk ports or Hybrid ports.

Use the undo loopback-detection per-vlan enable command to enable loopback detection in the default VLAN with Trunk ports or Hybrid ports.

By default, loopback detection is only enabled in the default VLAN(s) with Trunk ports or Hybrid ports.

Note that the loopback-detection per-vlan enable command is not applicable to Access ports.

Examples

# Enable loopback detection in all the VLANs to which the Hybrid port Ethernet 2/0/1 belongs.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] loopback-detection enable

[Sysname-Ethernet2/0/1] port link-type trunk

[Sysname-Ethernet2/0/1] loopback-detection per-vlan enable

mdi

Syntax

mdi { across | auto | normal }

undo mdi

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

across: Specifies the MDI mode as across.

auto: Specifies the MDI mode as auto.

normal: Specifies the MDI mode as normal.

Description

Use the mdi command to configure the MDI mode for an Ethernet interface.

Use the undo mdi command to restore the system default.

By default, the MDI mode of an Ethernet interface is auto, that is, the Ethernet interface determines the physical pin roles (transmit or receive) through negotiation.

The command is not applicable to Combo ports operating as optical ports.

Examples

# Set the MDI mode of Ethernet 2/0/1 to across.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] mdi across

multicast-suppression

Syntax

multicast-suppression { ratio | pps max-pps }

undo multicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default Level

2: System level

Parameters

ratio: Maximum percentage of multicast traffic to the total transmission capability of an Ethernet interface, in the range 1 to 100. The smaller the ratio is, the less multicast traffic is allowed to pass through the interface.

pps max-pps: Specifies the maximum number of multicast packets allowed on the Ethernet interface(s) per second...

l For a 100-Mbps port, this value ranges from 1 to 148810 (in pps).

l For a 1-Gbps port, this value ranges from 1 to 1488100 (in pps).

l For a 10-Gbps port, this value ranges from 1 to 14881000 (in pps).

Note that:

Description

Use the multicast-suppression command to configure multicast storm suppression ratio on an interface.

Use the undo multicast-suppression command to restore the default multicast suppression ratio.

By default, all multicast traffic is allowed to go through an Ethernet interface, that is, multicast traffic is not suppressed.

If you execute this command in Ethernet interface, the configurations take effect only on the current interface. If you execute this command in port-group view, the configurations take effect on all ports in the port group.

Note that when multicast traffic exceeds the maximum value configured, the system will discard the extra packets so that the multicast traffic ratio can drop below the limit to ensure that the network functions properly.

l If you set different suppression ratios in Ethernet interface view or port-group view for multiple times, the latest configuration takes effect.

l Do not use the multicast-suppression command along with the storm-constrain command. Otherwise, the multicast storm suppression ratio configured may get invalid.

l On an Ethernet port enabled with multicast storm suppression ratio, this feature takes effect only in the inbound direction.

Examples

# For Ethernet interface Ethernet 2/0/1, allow multicast traffic equivalent to 20% of the total transmission capability of Ethernet 2/0/1 to pass.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] multicast-suppression 20

# For all the ports of the manual port group group1, allow multicast traffic equivalent to 20% of the total transmission capability of each port to pass.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/2

[Sysname-port-group-manual-group1] multicast-suppression 20

port-group manual

Syntax

port-group manual port-group-name

undo port-group manual port-group-name

View

System view

Default Level

2: System level

Parameters

port-group-name: Specifies name of a manual port group, a string of 1 to 32 characters.

Description

Use the port-group manual command to create a manual port group and enter manual port group view.

Use the undo port-group manual command to remove a manual port group.

By default, no manual port group is created.

Examples

# Create a manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1]

reset counters interface

Syntax

reset counters interface [ interface-type [ interface-number ] ]

View

User view

Default Level

2: System level

Parameters

interface-type: Interface type.

interface-number: Interface number.

Description

Use the reset counters interface command to clear the statistics of an interface.

Before sampling network traffic within a specific period of time on an interface, you need to clear the existing statistics.

l If neither interface type nor interface number is specified, this command clears the statistics of all the interfaces.

l If only the interface type is specified, this command clears the statistics of the interfaces that are of the interface type specified.

l If both the interface type and interface number are specified, this command clears the statistics of the specified interface.

Examples

# Clear the statistics of Ethernet 2/0/1.

<Sysname> reset counters interface ethernet 2/0/1

shutdown

Syntax

shutdown

undo shutdown

View

Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the shutdown command to shut down an Ethernet interface.

Use the undo shutdown command to bring up an Ethernet interface.

By default, an Ethernet interface is in the up state.

In certain circumstances, modification to the interface parameters does not immediately take effect, and therefore, you need to shut down the relative interface to make the modification work.

Note that in case of a double Combo port, only one interface (either the optical port or the electrical port) is active at a time. That is, once the optical port is active (after you execute the undo shutdown command), the electrical port will be inactive automatically, and vice versa.

Examples

# Shut down interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] shutdown

# Bring up interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] undo shutdown

speed

Syntax

speed { 10 | 100 | 1000 | auto }

undo speed

View

Ethernet interface view

Default Level

2: System level

Parameters

10: Specifies the interface rate as 10 Mbps. The optical interface of a Combo port does not support the 10 keyword.

100: Specifies the interface rate as 100 Mbps. The optical interface of a Combo port does not support the 100 keyword.

1000: Specifies the interface rate as 1,000 Mbps.

auto: Specifies to determine the interface rate through auto-negotiation.

Description

Use the speed command to configure Ethernet interface data rate.

Use the undo speed command to restore Ethernet interface data rate.

By default, the port speed is in the auto-negotiation mode.

Related commands: duplex, speed auto.

You are recommended to configure the same port rate and duplex mode on two ports connected to each other, for example, set the duplex mode of both ports to auto negotiation or full/half duplex, so as to avoid packet loss.

Examples

# Configure the interface rate as 100 Mbps for interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] speed 100

speed auto

Syntax

speed auto [ 10 | 100 | 1000 ] *

undo speed

View

100MB or Gigabit Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

10: Specifies the interface auto-negotiation rate as 10 Mbps.

100: Specifies the interface auto-negotiation rate as 100 Mbps.

1000: Specifies the interface auto-negotiation rate as 1000 Mbps.

Description

Use the speed auto command to configure the auto-negotiation rate of the current interface.

Use the undo speed command to restore the default.

If you repeatedly use the speed command and the speed auto command to configure the rate of an interface, only the latest configuration takes effect. For example, if you configure speed 100 after configuring speed auto 100 1000 on an interface, the rate is 100 Mbps by force, with no negotiation performed between the interface and the peer end; if you configure speed auto 100 1000 after configuring speed 100 on the interface, the rate through negotiation can be either 100 Mbps or 1000 Mbps only.

Note that:

l When the auto-negotiation rate ranges set on the local and peer ends do not intersect, for example, 10 and 100 Mbps on one end and 1000 Mbps on the other, the rate negotiation will fail.

l When the auto-negotiation rate ranges set on the local and peer ends intersect, for example, 10 and 100 Mbps on one end and 100 and 1000 Mbps on the other, the negotiation rate range is the intersection, 100 Mbps.

l When the auto-negotiation rate ranges set on the local and peer ends are the same, for example, 100 and 1000 Mbps, the maximum value of the auto-negotiation rate is 1000 Mbps.

l This function is available for auto-negotiation-capable 100 MB or Gigabit Layer-2 Ethernet interfaces only. For a Combo port, only the electrical port supports this function.

l If you repeatedly use the speed and the speed auto commands to configure the transmission rate on an interface, only the latest configuration takes effect.

Examples

# Set the auto-negotiation rate of interface GigabitEthernet 2/0/1 to 10 Mbps or 1000 Mbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] speed auto 10 1000

storm-constrain

Syntax

storm-constrain { broadcast | multicast } pps max-pps-values min-pps-values

undo storm-constrain { all | broadcast | multicast }

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

all: Disables the storm constrain function for all types of packets (that is, unicast packets, multicast packets, and broadcast packets).

broadcast: Enables/Disables the storm constrain function for broadcast packets.

multicast: Enables/Disables the storm constrain function for multicast packets.

pps: Specifies that the thresholds to be configured.

max-pps-values: Upper threshold to be set, in pps.

l For a 100-Mbps port, this value ranges from 1 to 148810.

l For a 1-Gbps port, this value ranges from 1 to 1488100.

l For a 10-Gbps port, this value ranges from 1 to 14881000.

min-pps-values: Lower threshold to be set, in pps. The range of this argument is 1 to max-pps-values.

Description

Use the storm-constrain command to enable the storm constrain function for specific type of packets and set the upper and lower thresholds.

Use the undo storm-constrain command to disable the storm constrain function for specific type of packets.

By default, the storm constrain function is not enabled.

l Do not use the storm-constrain command along with the multicast-suppression command or the broadcast-suppression command. Otherwise, traffics may be suppressed in an unpredictable way.

l An upper threshold cannot be less than the corresponding lower threshold. Besides, do not configure the two thresholds as the same value.

Examples

# Enable the storm constrain function for unicast packets on Ethernet 2/0/1, setting the upper and lower threshold to 200 pps and 150 pps.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] storm-constrain unicast pps 200 150

storm-constrain control

Syntax

storm-constrain control { block | shutdown }

undo storm-constrain control

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

block: Blocks the traffic of a specific type on a port when the traffic detected exceeds the upper threshold.

shutdown: Shuts down a port when a type of traffic exceeds the corresponding upper threshold. A port shut down by the storm constrain function stops forwarding all types of packets.

Description

Use the storm-constrain control command to set the action to be taken when a type of traffic exceeds the corresponding upper threshold.

Use the undo storm-constrain control command to restore the default.

By default, no action is taken when a type of traffic exceeds the corresponding threshold.

Examples

# Configure to block interface Ethernet 2/0/1 when a type of traffic reaching it exceeds the corresponding upper threshold.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] storm-constrain control block

storm-constrain enable log

Syntax

storm-constrain enable log

undo storm-constrain enable log

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the storm-constrain enable log command to enable log sending. With log sending enabled, the system sends log when traffic reaching a port exceeds the corresponding threshold or the traffic drops down below the lower threshold after exceeding the upper threshold.

Use the undo storm-constrain enable log command to disable log sending.

By default, log sending is enabled.

Examples

# Disable log sending for Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] undo storm-constrain enable log

storm-constrain enable trap

Syntax

storm-constrain enable trap

undo storm-constrain enable trap

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the storm-constrain enable trap command to enable trap message sending. With trap message sending enabled, the system sends trap messages when traffic reaching a port exceeds the corresponding threshold or the traffic drops down below the lower threshold after exceeding the upper threshold.

Use the undo storm-constrain enable trap command to disable trap message sending.

By default, trap message sending is enabled.

Examples

# Disable trap message sending for Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] undo storm-constrain enable trap

storm-constrain interval

Syntax

storm-constrain interval seconds

undo storm-constrain interval

View

System view

Default Level

2: System level

Parameters

seconds: Interval for generating traffic statistics, in the range 1 to 300 (in seconds).

Description

Use the storm-constrain interval command to set the interval for generating traffic statistics.

Use the undo storm-constrain interval command to restore the default.

By default, the interval for generating traffic statistics is 10 seconds.

l The interval set by the storm-constrain interval command is specifically for the storm constrain function. It is different form that set by the flow-interval command.

l For network stability consideration, configure the interval for generating traffic statistics to a value that is not shorter than the default.

Examples

# Set the interval for generating traffic statistics to 60 seconds.

<Sysname> system-view

[Sysname] storm-constrain interval 60

unicast-suppression

Syntax

unicast-suppression { ratio | pps max-pps }

undo unicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default Level

2: System level

Parameters

ratio: Maximum percentage of unicast traffic to the total transmission capability of an Ethernet interface, in the range of 1 to 100. The smaller the ratio is, the less unicast traffic is allowed through the interface.

pps max-pps: Specifies the maximum number of unknown unicast packets passing through an Ethernet interface per second.

l For a 100-Mbps port, this value ranges from 1 to 148810 (in pps).

l For a 1-Gbps port, this value ranges from 1 to 1488100 (in pps).

l For a 10-Gbps port, this value ranges from 1 to 14881000 (in pps).

Note that:

Description

Use the unicast-suppression command to configure a unicast storm suppression ratio.

Use the undo unicast-suppression command to restore the default unicast suppression ratio.

By default, all unicast traffic is allowed to go through an Ethernet interface, that is, unicast traffic is not suppressed.

Note that when unicast traffic exceeds the maximum value configured, the system will discard the extra packets so that the unknown unicast traffic ratio can drop below the limit to ensure that the network functions properly.

l If you set different suppression ratios in Ethernet interface view or port-group view repeatedly, the latest configuration takes effect.

l Do not use the unicast-suppression command along with the storm-constrain command. Otherwise, the unicast storm suppression ratio configured may get invalid.

l On an Ethernet port enabled with unicast storm suppression ratio, this feature takes effect only in the inbound direction.

Examples

# For Ethernet interface Ethernet 2/0/1, allow unknown unicast traffic equivalent to 20% of the total transmission capability of the interface to pass and suppress the excessive unknown unicast packets.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] unicast-suppression 20

# For all the ports of the manual port group group1, allow unknown unicast traffic equivalent to 20% of the total transmission capability of each port to pass and suppress excessive unknown unicast packets.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/1

[Sysname-port-group-manual-group1] group-member ethernet 2/0/2

[Sysname-port-group-manual-group1] unicast-suppression 20

virtual-cable-test

Syntax

virtual-cable-test

View

Layer 2 Ethernet interface view

Default Level

2: System level

Parameters

None

Description

Use the virtual-cable-test command to test the cable connected to the Ethernet interface once and to display the testing result. The tested items include:

Note that:

l When the cable is functioning properly, the cable length in the test result represents the total cable length;

l When the cable is not functioning properly, the cable length in the test result represents the length from the current interface to the failed position.

l The optical interface of a Combo port does not support this command. The support of other Ethernet interfaces for this command varies with device models.

l A link in the up state goes down and then up automatically if you execute this command on one of the Ethernet interfaces forming the link.

l The test result is for your information only. The maximum error in the tested cable length is 5 m. A hyphen “-” indicates that the corresponding test item is not supported.

Examples

# Enable the virtual cable test for the interface Ethernet 2/0/1.

<Sysname> system-view

[Sysname] interface ethernet 2/0/1

[Sysname-Ethernet2/0/1] virtual-cable-test

Cable status: normal, 1 metres

Pair Impedance mismatch: -

Pair skew: - ns

Pair swap: -

Pair polarity: -

Insertion loss: - db

Return loss: - db

Near-end crosstalk: - db

01-Access Volume

broadcast-suppression

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us