The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.

Examples

# Set the expected bandwidth of Twenty-FiveGigE 1/0/1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] bandwidth 1000

Related commands

speed

broadcast-suppression

Use broadcast-suppression to enable broadcast suppression and set the broadcast suppression threshold.

Use undo broadcast-suppression to disable broadcast suppression.

Syntax

broadcast-suppression { ratio | pps max-pps | kbps max-kbps }

undo broadcast-suppression

Default

Ethernet interfaces do not suppress broadcast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

ratio: Sets the broadcast suppression threshold as a percentage of the interface bandwidth. The value range for this argument is 0 to 100. A smaller value means that less broadcast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of broadcast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

Usage guidelines

The broadcast storm suppression features limits the size of broadcast traffic to a threshold on an interface. When the broadcast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.

Both the storm-constrain command and the broadcast-suppression command can suppress broadcast storms on a port. The broadcast-suppression command uses the chip to physically suppress broadcast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress broadcast traffic.

For the traffic suppression result to be determined, do not configure both the storm-constrain broadcast command and the broadcast-suppression command on an interface.

When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows:

· If the configured value is smaller than 64, the value of 64 takes effect.

· If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.

To determine the suppression threshold that takes effect, see the prompts on the switch.

Set the same type of thresholds for each interface, that is, set the ratio argument, the pps max-pps option, or the kbps max-kbps option for the interface.

Examples

# Set the broadcast suppression threshold to 10000 kbps on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] broadcast-suppression kbps 10000

The actual value is 10048 on port Twenty-FiveGigE1/0/1 currently.

The output shows that the value that takes effect is 10048 kbps (157 times of 64), because the chip only supports step 64.

Related commands

multicast-suppression

unicast-suppression

dampening

Use dampening to enable the device to dampen an interface when the interface is flapping.

Use undo dampening to restore the default.

Syntax

dampening [ half-life reuse suppress max-suppress-time ]

undo dampening

Default

Interface dampening is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to 120 seconds. The default value is 54 seconds.

reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The reuse threshold must be less than the suppression threshold.

suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is 2000.

max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).

Usage guidelines

When configuring the dampening command, follow these rules to set the values mentioned above:

· The ceiling is equal to 2 (Max-suppress-time/Decay) × reuse-limits. It is not user configurable.

· The configured suppress limit is lower than or equal to the ceiling.

· The ceiling is lower than or equal to the maximum suppress limit supported.

This command, the link-delay command, and the port link-flap protect enable command are mutually exclusive on an interface.

This command does not take effect on the administratively down events. When you execute the shutdown command, the penalty restores to 0, and the interface reports the down event to the higher layer protocols.

Do not enable the dampening function on an interface with RRPP, MSTP, or Smart Link enabled.

After an interface in down state is dampened, the interface state displayed through the display interface command is always down.

Examples

# Enable interface dampening on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] dampening

# Enable interface dampening on Twenty-FiveGigE 1/0/1, and set the following parameters:

· Half life time to 2 seconds.

· Reuse value to 800.

· Suppression threshold to 3000.

· Maximum suppression interval to 5 seconds.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] dampening 2 800 3000 5

Related commands

display interface

link-delay

port link-flap protect enable

default

Use default to restore the default settings for an interface.

Syntax

default

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it in a live network.

‌

This command might fail to restore the default settings for some commands because of command dependencies or system restrictions. You can use the display this command in interface view to identify these commands, and use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to solve the problem.

Examples

# Restore the default settings for Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] default

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an interface is the interface name plus Interface (for example, Twenty-FiveGigE1/0/1 Interface).

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.

Examples

# Set the description of Twenty-FiveGigE 1/0/1 to lan-interface.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] description lan-interface

display counters

Use display counters to display interface traffic statistics.

Syntax

display counters { inbound | outbound } interface [ interface-type [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

inbound: Displays inbound traffic statistics.

outbound: Displays outbound traffic statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

To clear the Ethernet interface traffic statistics, use the reset counters interface command.

If you do not specify an interface type, this command displays traffic statistics for all interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic statistics for all interfaces of the specified type.

If you specify an interface type and number, this command displays traffic statistics for the specified interface.

Examples

# Display inbound traffic statistics for all interfaces.

<Sysname> display counters inbound interface

Interface Total (pkts) Broadcast (pkts) Multicast (pkts) Err (pkts)

WGE1/0/1 100 100 0 0

WGE1/0/2 Overflow Overflow Overflow Overflow

Overflow: More than 14 digits (7 digits for column "Err").

--: Not supported.

Table 1 Command output

Field	Description
Interface	Abbreviated interface name.
Total (pkts)	Total number of packets received or sent through the interface.
Broadcast (pkts)	Total number of broadcast packets received or sent through the interface.
Multicast (pkts)	Total number of multicast packets received or sent through the interface.
Err (pkts)	Total number of error packets received or sent through the interface.
Overflow: More than 14 digits (7 digits for column "Err")	The command displays Overflow when any of the following conditions exist: · The data length of an Err field value is greater than 7 decimal digits. · The data length of a non-Err field value is greater than 14 decimal digits.
--: Not supported	The statistical item is not supported.

‌

Related commands

reset counters interface

display counters rate

Use display counters rate to display traffic rate statistics for interfaces in up state for the most recent statistics polling interval.

Syntax

display counters rate { inbound | outbound } interface [ interface-type [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

inbound: Displays inbound traffic rate statistics.

outbound: Displays outbound traffic rate statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command displays traffic rate statistics for all up interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic rate statistics for all up interfaces of the specified type.

If you specify an interface type and an interface, this command displays traffic rate statistics for the specified interface.

If an interface that you specify is always down for the most recent statistics polling interval, the system prompts that the interface does not support the command.

To set the statistics polling interval, use the flow-interval command.

Examples

# Display the inbound traffic rate statistics for all interfaces.

<Sysname> display counters rate inbound interface

Usage: Bandwidth utilization in percentage

Interface Usage (%) Total (pps) Broadcast (pps) Multicast (pps)

WGE1/0/1 0 0 -- --

Overflow: More than 14 digits.

--: Not supported.

Table 2 Command output

Field	Description
Interface	Abbreviated interface name.
Usage (%)	Bandwidth usage (in percentage) of the interface for the last statistics polling interval.
Total (pps)	Average receiving or sending rate (in pps) for unicast packets for the last statistics polling interval.
Broadcast (pps)	Average receiving or sending rate (in pps) for broadcast packets for the last statistics polling interval.
Multicast (pps)	Average receiving or sending rate (in pps) for multicast packets for the last statistics polling interval. .
Overflow: more than 14 decimal digits	The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits.
--: not supported	The statistical item is not supported.

‌

Related commands

flow-interval

reset counters interface

display ethernet statistics

Use display ethernet statistics to display the Ethernet module statistics.

Syntax

display ethernet statistics slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Display the Ethernet module statistics for the specified slot.

<Sysname> display ethernet statistics slot 1

ETH receive packet statistics:

Totalnum : 10447 ETHIINum : 4459

SNAPNum : 0 RAWNum : 0

LLCNum : 0 UnknownNum : 0

ForwardNum : 4459 ARP : 0

MPLS : 0 ISIS : 0

ISIS2 : 0 IP : 0

IPV6 : 0

ETH receive error statistics:

NullPoint : 0 ErrIfindex : 0

ErrIfcb : 0 IfShut : 0

ErrAnalyse : 5988 ErrSrcMAC : 5988

ErrHdrLen : 0

ETH send packet statistics:

L3OutNum : 211 VLANOutNum : 0

FastOutNum : 155 L2OutNum : 0

ETH send error statistics:

MbufRelayNum : 0 NullMbuf : 0

ErrAdjFwd : 0 ErrPrepend : 0

ErrHdrLen : 0 ErrPad : 0

ErrQoSTrs : 0 ErrVLANTrs : 0

ErrEncap : 0 ErrTagVLAN : 0

IfShut : 0 IfErr : 0

Table 3 Output description

Field	Description
ETH receive packet statistics	Statistics about the Ethernet packets received by the Ethernet module: · Totalnum—Total number of received packets. · ETHIINum—Number of packets encapsulated by using Ethernet II. · SNAPNum—Number of packets encapsulated by using SNAP. · RAWNum—Number of packets encapsulated by using RAW. · LLCNum—Number of packets encapsulated by using LLC. · UnknownNum—Number of packets encapsulated by using unknown methods. · ForwardNum—Number of packets forwarded at Layer 2 or sent to the CPU. · ARP—Number of ARP packets. · MPLS—Number of MPLS packets. This field is not supported in the current software version. · ISIS—Number of IS-IS packets. · ISIS2—Number of large 802.3/802.2 frames encapsulated by using IS-IS. · IP—Number of IP packets. · IPv6—Number of IPv6 packets.
ETH receive error statistics	Statistics about the error Ethernet packets in the inbound direction on the Ethernet module. Errors might be included in packets or occur during the receiving process. The items include: · NullPoint—Number of packets that include null pointers. · ErrIfindex—Number of packets that include incorrect interface indexes. · ErrIfcb—Number of packets that include incorrect interface control blocks. · IfShut—Number of packets that are being received when the interface is shut down. · ErrAnalyse—Number of packets that include packet parsing errors. · ErrSrcMAC—Number of packets that include incorrect source MAC addresses. · ErrHdrLen—Number of packets that include header length errors.
ETH send packet statistics	Statistics about the Ethernet packets sent by the Ethernet module: · L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces.This field is not supported in the current software version. · VLANOutNum—Number of packets sent out of VLAN interfaces. · FastOutNum—Number of packets fast forwarded. · L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.
ETH send error statistics	Statistics about the error Ethernet packets in the outbound direction on the Ethernet module: · MbufRelayNum—Number of packets transparently sent. · NullMbuf—Number of packets with null pointers. · ErrAdjFwd—Number of packets with adjacency table errors. · ErrPrepend—Number of packets with extension errors. · ErrHdrLen—Number of packets with header length errors. · ErrPad—Number of packets with padding errors. · ErrQoSTrs—Number of packets that failed to be sent by QoS. · ErrVLANTrs—Number of packets that failed to be sent in VLANs. · ErrEncap—Number of packets that failed to be sent due to link header encapsulation failures. · ErrTagVLAN—Number of packets that failed to be sent due to VLAN tag encapsulation failures. · IfShut—Number of packets that are being sent when the interface is shut down. · IfErr—Number of packets with incorrect outgoing interfaces.

‌

Related commands

reset ethernet statistics

display interface

Use display interface to display interface information.

Syntax

display interface [ interface-type [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of each interface description.

down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

If you do not specify an interface type, this command displays information about all interfaces.

If you specify an interface type but do not specify an interface number, this command displays information about all interfaces of the specified type.

Examples

# Display detailed information about Layer 2 interface Twenty-FiveGigE 1/0/1.

<Sysname> display interface twenty-fivegige 1/0/1

Twenty-FiveGigE1/0/1

Current state: UP

IP packet frame type: Ethernet II, hardware address: f010-90db-7482

Description: Twenty-FiveGigE1/0/1 Interface

Bandwidth: 25000000 kbps

Loopback is not set

Media type is not sure, port hardware type is No connector

25Gbps-speed mode, full-duplex mode

Link speed type is force link, link duplex type is force link

Maximum frame length: 9416

MDI type: Automdix

Last link flapping: 3 days 22 hours 47 minutes

Last clearing of counters: Never

Current system time:2011-01-20 02:26:51

Last time when physical state changed to up:2011-01-16 03:39:09

Last time when physical state changed to down:2011-01-16 03:39:07

Peak input rate: 0 bytes/sec, at 2011-01-19 20:43:25

Peak output rate: 0 bytes/sec, at 2011-01-19 20:43:25

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

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

Input (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Input (normal): 0 packets, - bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

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 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Output (normal): 0 packets, - bytes

0 unicasts, 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 4 Command output

Field	Description
Current state	Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · Administratively DOWN(Global)—The interface has been shut down by using the shutdown all-physical-interfaces command in system view. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · DOWN ( Link-Aggregation interface down )—The aggregate interface to which the interface belongs has been shut down by using the shutdown command. · DOWN (Monitor-Link uplink down )—The interface has been shut down by Monitor Link. · Link-Flap DOWN—The interface has been shut down by the link flapping protection feature. · mac-address moving down—The interface has been shut down by the MAC address move suppression feature. · Storm-Constrain—The interface has been shut down because the storm control feature detected that unknown unicast traffic, multicast traffic, or broadcast traffic exceeded the upper threshold. · STP DOWN—The interface has been shut down by the BPDU guard feature. · UP—The interface is both administratively and physically up.
Line protocol state	Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer. · UP—The data link layer protocol is up. · UP (spoofing)—The data link layer protocol is up, but the link is an on-demand link or does not exist. This attribute is typical of null interfaces and loopback interfaces. · DOWN—The data link layer protocol is down. · DOWN (protocols)—The data link layer has been shut down by protocols included in the parentheses. Available protocols include: ¡ DLDP—Shuts down the data link layer when it detects that the link is unidirectional. ¡ OAM—Shuts down the data link layer when it detects a remote link failure. ¡ LAGG—Shuts down the data link layer when it detects that the aggregate interface does not have Selected ports. ¡ BFD—Shuts down the data link layer when it detects a link failure.
Bandwidth	Expected bandwidth of the interface.
Maximum transmission unit	MTU of the interface.
Internet protocol processing: Disabled	The interface is not assigned an IP address and cannot process IP packets.
Internet address: ip-address/mask-length (Type)	IP address of the interface and type of the address in parentheses. Possible IP address types include: · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. · DHCP-allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · Unnumbered—IP address borrowed from another interface. · MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide.
IP packet frame type	IPv4 packet framing format.
hardware address	MAC address of the interface.
FEC mode	FEC mode of the interface, which depends on the configuration. When the FEC mode of an interface is set to autonegotiation, the actual FEC mode depends on the model of the transceiver module installed in the fiber port.
Port priority	Port priority of the interface.
Loopback is set internal	An internal loopback test is running on the interface. This field depends on your configuration.
Loopback is set external	An external loopback test is running on the interface. This field depends on your configuration.
Loopback is not set	No loopback test is running on the interface. This field depends on your configuration.
100Mbps-speed mode	The interface is operating at 100 Mbps. This field depends on your configuration and the link parameter negotiation result.
1000Mbps-speed mode	The interface is operating at 1000 Mbps. This field depends on your configuration and the link parameter negotiation result.
10Gbps-speed mode	The interface is operating at 10 Gbps. This field depends on your configuration and the link parameter negotiation result.
25Gbps-speed mode	The interface is operating at 25 Gbps. This field depends on your configuration and the link parameter negotiation result.
40Gbps-speed mode	The interface is operating at 40 Gbps. This field depends on your configuration and the link parameter negotiation result.
100Gbps-speed mode	The interface is operating at 100 Gbps. This field depends on your configuration and the link parameter negotiation result.
Unknown-speed mode	The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.
full-duplex mode	The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result.
unknown-duplex mode	The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.
Link speed type is autonegotiation	The interface is configured with the speed auto command.
Link speed type is force link	The interface is manually configured with a speed (for example, 1000 Mbps) by using the speed command.
link duplex type is autonegotiation	The interface is configured with the duplex auto command.
link duplex type is force link	The interface is manually configured with a duplex mode (for example, half or full) by using the duplex command.
Flow-control is not enabled	Generic flow control is disabled on the interface. This field depends on your configuration and the link parameter negotiation result.
Maximum frame length	Maximum length of Ethernet frames allowed to pass through the interface.
Allow jumbo frame to pass	The interface allows jumbo frames to pass through.
Broadcast max-	‌Broadcast storm suppression threshold.
Multicast max-	‌Multicast storm suppression threshold.
Unicast max-	‌Unknown unicast storm suppression threshold.
PVID	Port VLAN ID (PVID) of the interface.
MDI type	MDIX mode of the interface: · automdix. · mdi. · mdix.
Dampening enabled	Damping is enabled on the interface.
Penalty	Penalty value.
Ceiling	The penalty stops increasing when it reaches the ceiling.
Reuse	Reuse threshold.
Suppress	Suppression threshold.
Half-life	Amount of time after which a penalty is decreased, in seconds.
Max-suppress-time	Maximum amount of time the interface can be dampened, in seconds.
Flap count	Number of flaps (up/down events) on the interface.
Port link-type	Link type of the interface: · access. · trunk. · hybrid.
Tagged VLANs	VLANs for which the interface sends packets without removing VLAN tags.
Untagged VLANs	VLANs for which the interface sends packets after removing VLAN tags.
VLAN Passing	VLANs whose packets can be forwarded by the port. The VLANs must have been created.
VLAN permitted	VLANs whose packets are permitted by the port.
Trunk port encapsulation	Encapsulation protocol type for the trunk port.
Last link flapping	The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup.
Last clearing of counters	Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup.
Current system time	Current system time in the YYYY/MM/DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone.
Last time when physical state changed to up	Last time when the physical state of the interface changed to up. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone. A hyphen (-) indicates that the physical state of the interface has never changed.
Last time when physical state changed to down	Last time when the physical state of the interface changed to down. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone. A hyphen (-) indicates that the physical state of the interface has never changed.
Last interval seconds input: 0 packets/sec 0 bytes/sec 0% Last interval seconds output: 0 packets/sec 0 bytes/sec 0%	Average inbound or outbound traffic rate (in pps and Bps) in the last statistics polling interval, and the ratio of the actual rate to the interface bandwidth. To set the statistics polling interval (interval), use the flow-interval command. A hyphen (-) indicates that the statistical item is not supported.
Input(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of inbound unicast packets. · Number of inbound broadcasts. · Number of inbound multicasts. · Number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Input(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of inbound normal unicast packets. · Number of inbound normal broadcasts. · Number of inbound normal multicasts. · Number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
input errors	Statistics of incoming error packets.
runts	Number of inbound frames meeting the following conditions: · Shorter than 64 bytes. · In correct format. · Containing valid CRCs.
giants	Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface. For an Ethernet interface that does not permit jumbo frames, the maximum frame length is as follows: · 1532 bytes (without VLAN tags). · 1536 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.
throttles	Number of inbound frames that had a non-integer number of bytes.
CRC	Total number of inbound frames that had a normal length, but contained CRC errors.
frame	Total number of inbound frames that contained CRC errors and a non-integer number of bytes.
overruns	Number of packets dropped because the input rate of the port exceeded the queuing capability.
aborts	Total number of illegal inbound packets: · Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value. · Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length). ¡ For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1532 bytes (without VLAN tags) or 1536 bytes (with VLAN tags). ¡ For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface. · Symbol error frames—Frames that contained a minimum of one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).
ignored	Number of inbound frames dropped because the receiving buffer of the port ran low.
parity errors	Total number of frames with parity errors.
Output(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of outbound unicast packets. · Number of outbound broadcasts. · Number of outbound multicasts. · Number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Output(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of outbound normal unicast packets. · Number of outbound normal broadcasts. · Number of outbound normal multicasts. · Number of outbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
output errors	Number of outbound packets with errors.
underruns	Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.
buffer failures	Number of packets dropped because the transmitting buffer of the interface ran low.
aborts	Number of packets that failed to be transmitted, for example, because of Ethernet collisions.
deferred	Number of frames that the interface deferred to transmit because of detected collisions.
collisions	Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.
late collisions	Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.
lost carrier	Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.
no carrier	Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces.
Peak input rate	Peak rate of inbound traffic in Bps, and the time when the peak inbound traffic rate occurred.
Peak output rate	Peak rate of outbound traffic in Bps, and the time when the peak outbound traffic rate occurred.
Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec	Average inbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported.
Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec	Average outbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported.
Input: 0 packets, 0 bytes	Inbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported.
Output: 0 packets, 0 bytes	Outbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported.

‌

# Display brief information about all interfaces.

<Sysname> display interface brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) – spoofing

Interface Link Protocol Primary IP Description

Loop0 UP UP(s) 2.2.2.9

NULL0 UP UP(s) --

Vlan1 UP UP --

Vlan999 UP UP 192.168.1.42

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

WGE1/0/2 DOWN auto A A 1

WGE1/0/3 UP 1G(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaa

# Display brief information about Twenty-FiveGigE 1/0/3, including the complete description of the interface.

<Sysname> display interface twenty-fivegige 1/0/3 brief description

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

WGE1/0/3 UP 1G(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaa

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display information about interfaces in DOWN state and the causes.

<Sysname> display interface brief down

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

Vlan2 DOWN Not connected

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

WGE1/0/2 DOWN Not connected

Table 5 Command output

Field	Description
Brief information on interfaces in route mode:	Brief information about Layer 3 interfaces.
Interface	Interface name.
Link	Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state.
Protocol	Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.
Primary IP	Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.
Description	Description of the interface.
Brief information of interfaces in bridge mode:	Brief information about Layer 2 interfaces.
Type: A - access; T - trunk; H – hybrid	Link type options for interfaces.
Speed	Speed of the interface, in bps. This field displays the (a) flag next to the speed if the speed is automatically negotiated. This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started.
Duplex	Duplex mode of the interface: · A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started. · F—Full duplex. · F(a)—Autonegotiated full duplex. · H—Half duplex. · H(a)—Autonegotiated half duplex.
Type	Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk.
PVID	Port VLAN ID.
Cause	Cause for the physical link state of an interface to be DOWN: · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · DOWN ( Link-Aggregation interface down )—The interface is a member port of an aggregate interface, and the aggregate interface is down. · DOWN (Loopback detection down)—The loopback detection module has detected loops. · DOWN ( Monitor-Link uplink down )—The monitor link module has detected that the uplink is down. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty). · Storm-Constrain—The storm control feature has detected that unknown unicast traffic, multicast traffic, or broadcast traffic exceeded the upper threshold. · STP DOWN—The interface has been shut down by the BPDU guard feature. · Port Security Disabled—The interface has been shut down by the intrusion detection mechanism because the interface received illegal packets.

‌

Related commands

flow-interval

reset counters interface

display interface link-info

Use display interface link-info to display the status and packet statistics of interfaces.

Syntax

display interface link-info

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

main: Specifies all interfaces except subinterfaces. If you do not specify this keyword, this command displays status and packet statistics of all interfaces.

Examples

# Display status and statistics of all interfaces.

<Sysname> display interface link-info

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol InUsage OutUsage InErrs OutErrs

WGE1/0/1 UP UP 10% 0% 0 0

NULL0 UP UP(s) 0% 0% 0 0

Overflow: More than 7 digits.

--: Not supported.

Table 6 Command output

Field	Description
Link: ADM - administratively down; Stby - standby	Physical link state of the interface: · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state.
Protocol: (s) – spoofing	The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces.
Interface	Abbreviated interface name.
Link	Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state.
Protocol	Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces.
InUsage	Inbound bandwidth usage within the most recent statistics polling interval. It is calculated by this formula: Average inbound speed of the interface within the most recent statistics polling interval/interface bandwidth. To set the statistics polling interval, use the flow-interval command.
OutUsage	Outbound bandwidth usage within the most recent statistics polling interval. It is calculated by this formula: Average outbound speed of the interface within the most recent statistics polling interval/interface bandwidth. To set the statistics polling interval, use the flow-interval command.
InErrs	Number of error packets received.
OutErrs	Number of error packets sent.
Overflow: More than 7 digits.	The data length of a statistical item value is greater than 7 decimal digits.
--: Not supported.	A hyphen (-) indicates that the corresponding statistical item is not supported.

Related commands

flow-interval

display link-flap protection

Use display link-flap protection to display information about link flapping protection on an interface.

Syntax

display link-flap protection [ interface interface-type [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type. If you do not specify an interface type, the command displays information about link flapping protection on all interfaces.

interface-number: Specifies an interface number. If you do not specify an interface number, the command displays information about link flapping protection on all interfaces of the specified type.

Examples

# Display information about link flapping protection on all interfaces.

<Sysname> display link-flap protection

Link-flap protection: Enabled

Interface Link-flap Status Interval(L1/L2) Threshold(L1/L2)

WGE1/0/1 Enabled Down 10/5 5/60

WGE1/0/2 Disabled N/A --/-- --/--

Table 7 Command output

Field	Description
Link-flap protection	Status of global link flapping protection: · Enabled—Link flapping protection is enabled globally. · Disabled—Link flapping protection is disabled globally.
Link-flap	Status of link flapping protection on an interface: · Enabled—Link flapping protection is enabled on an interface. · Disabled—Link flapping protection is disabled on an interface.
Status	Status of an interface: · Down—The interface has been shut down by the link flapping protection feature. · N/A—The interface status is not affected by the link flapping protection feature.
Interval(L1/L2)	Level-1/Level-2 link flapping detection interval for an interface.
Threshold(L1/L2)	Level-1/Level-2 link flapping detection threshold for an interface.

‌

Related commands

link-flap protect enable

port link-flap protect enable

display link-state-change statistics interface

Use display link-state-change statistics interface to display the physical link state change statistics of interfaces.

Syntax

display link-state-change statistics interface [ interface-type [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command displays the link state change statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command displays the link state change statistics for all interfaces of the specified type.

Examples

# Display the link state change statistics of all interfaces.

<Sysname> display link-state-change statistics interface

Interface Change-times Last-change-time Reset link-state time

Link-flap-begin Link-flap-end

WGE1/0/1 0 Never Never

Never Never

Table 8 Command output

Field	Description
Interface	Abbreviated interface name.
Change-times	Number of physical state changes.
Last-change-time	Last time when the physical state changed.
Reset link-state time	Time when the physical link state change statistics were cleared.
Link-flap-begin	Last time when a physical link state flapping began. If no link state flapping has occurred, this field displays Never.
Link-flap-end	Last time when a physical link state flapping ended. If no link state flapping has occurred, this field displays Never.

Related commands

reset link-state-change statistics interface

display packet-drop

Use display packet-drop to display information about packets dropped on an interface.

Syntax

display packet-drop { interface [ interface-type [ interface-number ] ] | summary }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

summary: Displays the summary of dropped packets on only interfaces that support this command.

Usage guidelines

If you do not specify an interface type, this command displays information about dropped packets on only interfaces that support this command on the device.

If you specify an interface type but do not specify an interface number, this command displays information about dropped packets on only interfaces of the specified type that support this command.

Examples

# Display information about dropped packets on Twenty-FiveGigE 1/0/1.

<Sysname> display packet-drop interface twenty-fivegige 1/0/1

Twenty-FiveGigE1/0/1:

Packets dropped due to full GBP or insufficient bandwidth: 301

Packets dropped due to Fast Filter Processor (FFP): 261

Packets dropped due to STP non-forwarding state: 0

Packets dropped due to insufficient data buffer. Input dropped: 0 Output dropped:0

Packets of ECN marked: 0

# Display the summary of dropped packets on only interfaces that support this command.

<Sysname> display packet-drop summary

All interfaces:

Packets dropped due to full GBP or insufficient bandwidth: 301

Packets dropped due to Fast Filter Processor (FFP): 261

Packets dropped due to STP non-forwarding state: 0

Packets dropped due to insufficient data buffer. Input dropped: 0 Output dropped:0

Packets of ECN marked: 0

Table 9 Command output

Field	Description
Packets dropped due to full GBP or insufficient bandwidth	Packets that are dropped because the buffer is used up or the bandwidth is insufficient.
Packets dropped due to Fast Filter Processor (FFP)	Packets that are filtered out.
Packets dropped due to STP non-forwarding state	Packets that are dropped because STP is in the non-forwarding state.
Packets dropped due to insufficient data buffer. Input dropped: 0 Output dropped:0	Inbound and outbound packets that are dropped due to insufficient data buffer.
Packets of ECN marked	Packets with the ECN field set to 11 because WRED queue thresholds are reached. For more information about WRED and ECN, see ACL and QoS Configuration Guide.

‌

duplex

Use duplex to set the duplex mode for an Ethernet interface.

Use undo duplex to restore the default.

Syntax

duplex { auto | full | half }

undo duplex

Default

Ethernet interfaces operate in autonegotiation mode.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

auto: Configures the interface to autonegotiate the duplex mode with the peer.

full: Configures the interface to operate in full duplex mode. In this mode, the interface can receive and transmit packets simultaneously.

half: Configures the interface to operate in half duplex mode. In this mode, the interface can only receive or transmit packets at a given time.

‌

NOTE:

Only copper management Ethernet interfaces support the half keyword.

‌

Examples

# Configure Twenty-FiveGigE 1/0/1 to operate in full duplex mode.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] duplex full

flow-control

Use flow-control to enable TxRx-mode generic flow control on an Ethernet interface.

Use undo flow-control to disable TxRx-mode generic flow control on the Ethernet interface.

Syntax

flow-control

undo flow-control

Default

TxRx-mode generic flow control is disabled on an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

With TxRx-mode generic flow control configured, an interface can both send and receive flow control frames:

· When congested, the interface sends a flow control frame to its peer.

· Upon receiving a flow control frame from the peer, the interface suspends sending packets.

To implement flow control on a link, enable generic flow control at both ends of the link.

This command and the priority-flow-control no-drop dot1p command are mutually exclusive.

Examples

# Enable TxRx-mode generic flow control on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] flow-control

flow-control receive enable

Use flow-control receive enable to enable Rx-mode generic flow control on an Ethernet port.

Use undo flow-control to disable Rx-mode generic flow control on an Ethernet port.

Syntax

flow-control receive enable

undo flow-control

Default

Rx-mode generic flow control is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

With Rx-mode flow control enabled, an interface can receive but cannot send flow control frames.

· When the interface receives a flow control frame from its peer, it suspends sending packets to the peer.

· When traffic congestion occurs on the interface, it cannot send flow control frames to the peer.

To handle unidirectional traffic congestion on a link, configure the flow-control receive enable command at one end, and the flow-control command at the other. To enable both ends of the link to handle traffic congestion, configure the flow-control command at both ends.

This command, the priority-flow-control command, and the priority-flow-control no-drop dot1p command are mutually exclusive.

Examples

# Enable Rx-mode generic flow control on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-twenty-fivegige 1/0/1] flow-control receive enable

Related commands

flow-control

flow-interval

Use flow-interval to set the statistics polling interval.

Use undo flow-interval to restore the default.

Syntax

flow-interval interval

undo flow-interval

Default

The statistics polling interval is 300 seconds.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

interval: Sets the statistics polling interval in seconds. The interval is in the range of 5 to 300 and must be a multiple of 5.

Examples

# Set the statistics polling interval to 100 seconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] flow-interval 100

interface

Use interface to enter interface view.

Syntax

interface interface-type interface-number

Views

System view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Examples

# Enter the view of Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1]

jumboframe enable

Use jumboframe enable to allow jumbo frames within the specified length to pass through.

Use undo jumboframe enable to prevent jumbo frames from passing through.

Use undo jumboframe enable size to restore the default.

Syntax

jumboframe enable [ size ]

undo jumboframe enable [ size ]

Default

The device allows jumbo frames within 9416 bytes to pass through.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value range for this argument is 1536 to 9416.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Allow jumbo frames to pass through Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] jumboframe enable

link-delay

Use link-delay to set the physical state change suppression interval on an Ethernet interface.

Use undo link-delay to restore the default.

Syntax

link-delay { down | up } [ msec ] delay-time

undo link-delay { down | up }

Default

Each time the physical link of a port goes up or comes down, the interface immediately reports the change to the CPU.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

down: Suppresses link-down events.

up: Suppresses link-up events.

msec: Enables the physical state change suppression interval to be accurate to milliseconds. If you do not specify this keyword, the suppression interval is accurate to seconds.

delay-time: Sets the physical state change suppression interval on the Ethernet interface. A value of 0 means that physical state changes are immediately reported to the CPU and are not suppressed.

· If you do not specify the msec keyword, the value range is 0 to 300 seconds.

· If you specify the msec keyword, the value range is 0 to 10000 milliseconds, and the value must be a multiple of 100.

Usage guidelines

You can configure this feature to suppress only link-down events, only link-up events, or both. If an event of the specified type still exists when the suppression interval expires, the system reports the event.

When you configure this feature, follow these guidelines:

· To suppress link-down events, execute the link-delay down command.

· To suppress link-up events, execute the link-delay up command.

On an interface, you can configure different suppression intervals for link-up and link-down events. If you execute the link-delay command multiple times on an interface, the following rules apply:

· You can configure the suppression intervals for link-up and link-down events separately.

· If you configure the suppression interval multiple times for link-up or link-down events, the most recent configuration takes effect.

Do not execute this command on an interface that has RRPP, spanning tree protocols, or Smart Link enabled.

This command, the dampening command, and the port link-flap protect enable command are mutually exclusive on an Ethernet interface.

Examples

# Set the link-down event suppression interval to 8 seconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] link-delay down 8

# Set the link-up event suppression interval to 800 milliseconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] link-delay up msec 800

Related commands

dampening

port link-flap protect enable

link-flap protect enable

Use link-flap protect enable to enable link flapping protection globally.

Use undo link-flap protect enable to disable link flapping protection globally.

Syntax

link-flap protect enable

undo link-flap protect enable

Default

Link flapping protection is disabled globally.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Link flapping on any interface changes network topology and increases the system overhead. For example, in an active/standby link scenario, when the interface status on the active link changes between UP and DOWN, traffic switches between active and standby links. To solve this problem, execute this command.

With link flapping protection enabled on an interface, when the interface goes down, the system enables link flapping detection on the interface. During the link flapping detection interval, if the number of detected flaps reaches or exceeds the link flapping detection threshold, the system shuts down the interface.

Link flapping protection takes effect only when it is enabled in both system view and interface view.

Examples

# Enable link flapping protection globally.

<Sysname> system-view

[Sysname] link-flap protect enable

Related commands

port link-flap protect enable

loopback

Use loopback to enable loopback testing on an Ethernet interface.

Syntax

loopback { external | internal }

Default

Loopback testing is disabled on an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

external: Enables external loopback testing on the Ethernet interface.

internal: Enables internal loopback testing on the Ethernet interface.

Usage guidelines

The shutdown, port up-mode, and loopback commands are mutually exclusive.

Examples

# Enable internal loopback testing on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] loopback internal

multicast-suppression

Use multicast-suppression to enable multicast storm suppression and set the multicast storm suppression threshold.

Use undo multicast-suppression to disable multicast storm suppression.

Syntax

multicast-suppression { ratio | pps max-pps | kbps max-kbps } [ unknown ]

undo multicast-suppression

Default

Ethernet interfaces do not suppress multicast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

ratio: Sets the multicast suppression threshold as a percentage of the interface bandwidth. The value range for this argument (in percentage) is 0 to 100. A smaller value means that less multicast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of multicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

unknown: Enables multicast storm suppression only on unknown packets. If you do not specify this keyword, this command suppresses all the multicast packets that the interface can forward.

Usage guidelines

The multicast storm suppression feature limits the size of multicast traffic to a threshold on an interface. When the multicast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.

Both the storm-constrain command and the multicast-suppression command can suppress multicast storms on a port. The multicast-suppression command uses the chip to physically suppress multicast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress multicast traffic.

For the traffic suppression result to be determined, do not execute both the storm-constrain multicast command and the multicast-suppression command on an interface.

When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows:

· If the configured value is smaller than 64, the value of 64 takes effect.

· If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.

To determine the suppression threshold that takes effect, see the prompts on the switch.

Set the same type of thresholds for each interface, that is, set the ratio argument, the pps max-pps option, or the kbps max-kbps option for the interface.

Examples

# Set the multicast storm suppression threshold to 10000 kbps on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] multicast-suppression kbps 10000

The actual value is 10048 on port Twenty-FiveGigE1/0/1 currently.

The output shows that the value that takes effect is 10048 kbps (157 times of 64), because the chip only supports step 64.

Related commands

broadcast-suppression

unicast-suppression

port fast-retrain enable

Use port fast-retrain enable to enable fast retrain.

Use undo port fast-retrain enable to disable fast retrain.

Syntax

port fast-retrain enable

undo port fast-retrain enable

Default

Fast retrain is disabled.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

This command is supported only on copper ports.

Copper Ethernet ports negotiate parameters through electric signals to determine the up/down status. In an actual network, if a copper port is in a high-frequency or low-frequency environment, the electrical signals will be affected. As a result, the negotiated status might be incorrect. You can enable or disable fast retrain on a copper port to adjust the frequency of electrical signals transmitted by the copper port to improve the anti-attenuation and anti-inference capabilities of the interface.

Enabling fast retrain on a copper port enables the port to perform negotiation by using high-frequency electrical signals, which improves the anti-attenuation capability of the copper port. Disabling fast retrain on a copper port enables the port to perform negotiation by using low-frequency electrical signals, which improves the anti-interference capability of the copper port.

Examples

# Disable fast retrain on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] undo port fast-retrain enable

port fec bypass enable

Use port fec bypass enable to enable FEC bypass.

Use undo port fec bypass enable to disable FEC bypass.

Syntax

port fec bypass enable

undo port fec bypass enable

Default

FEC bypass is disabled.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

This command is supported only on 25-GE and 100-GE interfaces.

By default, when an interface continuously receives three or more packets that it cannot process, the device will shut down and then bring up the interface to fix the interface. However, there are many possible packet error reasons. If you are sure that the interface is not faulty, you do not need to fix the interface. To avoid service interruption in this case, you can enable this feature on the interface to prevent the device from shutting down and bringing up the interface.

Examples

# Enable FEC bypass.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] port fec bypass enable

port fec mode

Use port fec mode to set the forward error correction (FEC) mode of an interface.

Use undo port fec mode to restore the default.

Syntax

port fec mode { auto | none | rs-fec }

undo port fec mode

Default

By default, the interface's FEC is in autonegotiation mode.

Views

100-GE interface view

Predefined user roles

network-admin

Parameters

auto: Specifies the FEC autonegotiation mode.

none: Performs no FEC.

rs-fec: Specifies the RS-FEC mode.

Usage guidelines

The FEC feature corrects packet errors to improve transmission quality. It attaches correction information to a packet at the sending end, and corrects error codes generated during transmission at the receiving end based on the correction information. You can set the FEC mode as needed.

Make sure you set the same FEC mode for both interfaces of a link.

Examples

# Set the FEC mode of HundredGigE 1/0/1 to autonegotiation.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] port fec mode auto

port link-flap protect enable

Use port link-flap protect enable to enable link flapping protection on an interface.

Use undo port link-flap protect enable to disable link flapping protection on an interface.

Syntax

port link-flap protect enable [ interval interval | threshold threshold ] * [ second-interval second-interval second-threshold second-threshold ]

undo port link-flap protect enable [ interval | threshold ]

Default

Link flapping protection is disabled on an interface.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

interval interval: Specifies the level-1 link flapping detection interval in seconds. The value range for this argument is 5 to 86400. The default value for this argument is 10.

threshold threshold: Specifies the level-1 link flapping detection threshold in the range of 2 to 1200. The default value for this argument is 5.

second-interval interval: Specifies the level-2 link flapping detection interval in seconds. The value range for this argument is 5 to 86400.

second-threshold threshold: Specifies the level-2 link flapping detection threshold in the range of 2 to 1200.

Usage guidelines

Link flapping protection takes effect only when it is enabled in both system view and interface view.

If you do not specify the interval interval or threshold threshold option, the command uses the default level-1 link flapping protection settings. If you do not specify the second-interval interval or second-threshold threshold option, the command uses only the level-1 link flapping protection settings.

If you specify the interval or threshold keyword when you execute the undo port link-flap protect enable command, the command restores the default setting for the keyword.

With link flapping protection enabled on an interface, when the interface goes down, the system enables link flapping detection on the interface. During a link flapping detection interval, if the number of detected flaps reaches or exceeds the corresponding link flapping detection threshold, the system shuts down the interface. If you specify both level-1 and level-2 link flapping protection settings, link flapping protection will be triggered and the interface will be shut down when either of level-1 and level-2 link flapping protection conditions are met.

To bring up an interface that has been shut down by link flapping protection, execute the undo shutdown command.

This command, the dampening command, and the link-delay command are mutually exclusive on an Ethernet interface.

Examples

# Enable link flapping protection on an interface. Set the link flapping detection interval to 10 seconds, and set the link flapping detection threshold to 5.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE 1/0/1] port link-flap protect enable interval 10 threshold 5

Related commands

dampening

link-delay

link-flap protect enable

port up-mode

Use port up-mode to forcibly bring up a fiber Ethernet port.

Use undo port up-mode to restore the default.

Syntax

port up-mode

undo port up-mode

Default

A fiber Ethernet port is not forcibly brought up. The physical state of a fiber port depends on the physical state of the fibers.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

This command forcibly brings up a fiber Ethernet port and enables the port to forward packets unidirectionally over a single link. In this way, transmission links are well utilized.

The shutdown, port up-mode, and loopback commands are mutually exclusive.

A fiber Ethernet port does not support this command if the port is shut down by a protocol or by using the shutdown command.

Do not execute this command on a fiber port connected to copper cables.

Examples

# Forcibly bring up fiber port Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] port up-mode

reset counters interface

Use reset counters interface to clear the interface statistics.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

If you do not specify an interface type, this command clears statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command clears statistics for all interfaces of the specified type.

Examples

# Clear the statistics for Twenty-FiveGigE 1/0/1.

<Sysname> reset counters interface twenty-fivegige 1/0/1

Related commands

display counters interface

display counters rate interface

display interface

reset ethernet statistics

Use reset ethernet statistics to clear the Ethernet module statistics.

Syntax

reset ethernet statistics [ slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Clear the Ethernet module statistics for the specified slot.

<Sysname> reset ethernet statistics slot 1

Related commands

display ethernet statistics

reset link-state-change statistics interface

Use reset link-state-change statistics interface to clear link state change statistics of interfaces.

Syntax

reset link-state-change statistics interface [ interface-type [ interface-number ] ]

Default

Link state change statistics of an interface are not cleared.

Views

User view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command clears the link state change statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command clears the link state change statistics for all interfaces of the specified type.

Examples

# Clear the link state change statistics of Twenty-FiveGigE 1/0/1.

<Sysname> reset link-state-change statistics interface twenty-fivegige 1/0/1

Related commands

display link-state-change statistics interface

reset packet-drop interface

Use reset packet-drop interface to clear the dropped packet statistics for an interface.

Syntax

reset packet-drop interface [ interface-type [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

interface-type: Specify an interface type.

interface-number: Specify an interface number.

Usage guidelines

If you do not specify an interface type, this command clears dropped packet statistics for all interfaces on the device.

If you specify an interface type but do not specify an interface number, the command clears dropped packet statistics for all interfaces of the specified type.

Examples

# Clear dropped packet statistics for Twenty-FiveGigE 1/0/1.

<Sysname> reset packet-drop interface twenty-fivegige 1/0/1

# Clear dropped packet statistics for all interfaces.

<Sysname> reset packet-drop interface

Related commands

display packet-drop

shutdown

Use shutdown to shut down an Ethernet interface.

Use undo shutdown to bring up an Ethernet interface.

Syntax

shutdown

undo shutdown

Default

Ethernet interfaces and subinterfaces are in up state.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

Executing the shutdown command on an interface will disconnect the link of the interface and interrupt communication. Use this command with caution.

‌

Some interface configurations might require an interface restart before taking effect.

The shutdown, port up-mode, and loopback commands are mutually exclusive.

Examples

# Shut down and then bring up Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] shutdown

[Sysname-Twenty-FiveGigE1/0/1] undo shutdown

shutdown all-physical-interface

Use shutdown all-physical-interfaces to shut down all physical interfaces except management Ethernet interfaces.

Use undo shutdown all-physical-interfaces to bring up all physical interfaces except management Ethernet interfaces.

Syntax

shutdown all-physical-interfaces [ include irf-physical-interface ]

undo shutdown all-physical-interfaces

Default

Physical interfaces are up.

Views

System view

Predefined user roles

network-admin

Parameters

include irf-physical-interface: Shuts down all physical interfaces including the IRF physical interfaces. If you do not specify this keyword, this command does not shut down IRF physical interfaces.

Usage guidelines

With the shutdown all-physical-interfaces command, you can shut down all physical interfaces except the management Ethernet interfaces on the device. Physical interfaces shut down by using this command are in ADM state.

This command does not take effect on physical interfaces that have joined a service loopback group.

To shut down all physical interfaces or the specified interface, execute the shutdown all-physical-interfaces command in system view or execute the shutdown command in interface view.

To bring up interfaces shut down by using the shutdown all-physical-interfaces command, execute its undo form in system view. To bring up an interface shut down by using the shutdown command, execute its undo form in interface view.

If you execute this command with the include irf-physical-interface keyword multiple times, this command shuts down all physical interfaces except the management Ethernet interfaces on the device.

Examples

# Shut down all physical interfaces except management Ethernet interfaces and IRF physical interfaces.

<Sysname> system-view

[Sysname] shutdown all-physical-interfaces

Related commands

shutdown

speed

Use speed to set the speed of an Ethernet interface.

Use undo speed to restore the default.

Syntax

speed { 10 | 100 | 1000 | 10000 | 25000 | 40000 | 100000 | auto }

undo speed

Default

An Ethernet interface negotiates a speed with its peer.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

10: Sets the interface speed to 10 Mbps.

100: Sets the interface speed to 100 Mbps.

1000: Sets the interface speed to 1000 Mbps.

10000: Sets the interface speed to 10000 Mbps.

25000: Sets the interface speed to 25000 Mbps.

40000: Sets the interface speed to 40000 Mbps.

100000: Sets the interface speed to 100000 Mbps.

auto: Enables the interface to negotiate a speed with its peer.

Usage guidelines

For an Ethernet copper port, use the speed command to set its speed to match the speed of the peer interface. Support of copper ports for keywords of this command varies by copper port type. For more information, use the speed ? command in interface view. If the system does not prompt that operation failed when you configure a speed for a copper port, the copper port supports this speed. Otherwise, the copper port does not support this speed.

For a fiber port, use the speed command to set its speed to match the rate of a transceiver module. Support of fiber ports for keywords of this command varies by fiber port type. For more information, use the speed ? command in interface view. If the system does not prompt that operation failed when you configure a speed for a fiber port, the fiber port supports this speed. Otherwise, the fiber port does not support this speed.

Additionally, you must select a speed for a fiber port according to the transceiver module installed to ensure that the transceiver module can be used properly. If the transceiver module installed in a fiber port does not support the speed for the fiber port, the transceiver module cannot be used. For example, if the transceiver module installed in an SFP+ fiber port is an SFP GE transceiver module and the speed 10000 command is executed on the fiber port or the transceiver module installed in an SFP+ fiber port is a 10-GE transceiver module and the speed 1000 command is executed on the fiber port, the transceiver module cannot be used.

Examples

# Configure Twenty-FiveGigE 1/0/1 to autonegotiate the speed.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] speed auto

unicast-suppression

Use unicast-suppression to enable unknown unicast storm suppression and set the unknown unicast storm suppression threshold.

Use undo unicast-suppression to disable unknown unicast storm suppression.

Syntax

unicast-suppression { ratio | pps max-pps | kbps max-kbps }

undo unicast-suppression

Default

Ethernet interfaces do not suppress unknown unicast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

ratio: Sets the unknown unicast suppression threshold as a percentage of the interface bandwidth. The value range for this argument (in percentage) is 0 to 100. A smaller value means that less unknown unicast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of unknown unicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of unknown unicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

Usage guidelines

The unknown unicast storm suppression feature limits the size of unknown unicast traffic to a threshold on an interface. When the unknown unicast traffic on the interface exceeds this threshold, the system discards packets until the unknown unicast traffic drops below this threshold.

Both the storm-constrain command and the unicast-suppression command can suppress unknown unicast storms on a port. The unicast-suppression command uses the chip to physically suppress unknown unicast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress unknown unicast traffic.

For the unknown unicast traffic suppression result to be determined, do not configure both the storm-constrain unicast command and the unicast-suppression command on an interface.

When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows:

· If the configured value is smaller than 64, the value of 64 takes effect.

· If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.

For the suppression threshold that takes effect, see the prompt on the device.

Set the same type of thresholds for each interface, that is, set the ratio argument, the pps max-pps option, or the kbps max-kbps option for the interface.

Examples

# Set the unknown unicast storm suppression threshold to 10000 kbps on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] unicast-suppression kbps 10000

The actual value is 10048 on port Twenty-FiveGigE1/0/1 currently.

The output shows that the value that takes effect is 10048 kbps (157 times of 64), because the chip only supports step 64.

Related commands

broadcast-suppression

multicast-suppression

using fortygige

Use using fortygige to combine 10-GE breakout interfaces split from a 40-GE interface into a 40-GE interface.

Syntax

using fortygige

Default

The 10-GE breakout interfaces are not combined and operate as single interfaces.

Views

10-GE breakout interface view

Predefined user roles

network-admin

Usage guidelines

If you need higher bandwidth on a single interface, you can combine four 10-GE breakout interfaces split from a 40-GE interface into a 40-GE interface. To do so, execute this command on any of these 10-GE breakout interfaces.

After executing this command, you do not need to reboot the device. To view information about the 40-GE interface, execute the display interface brief command.

Examples

# Combine Ten-GigabitEthernet 1/0/1:1 through Ten-GigabitEthernet 1/0/1:4 into a 40-GE interface.

<System> system-view

[System] interface ten-gigabitethernet1/0/1:1

[System-Ten-GigabitEthernet1/0/1:1] using fortygige

The interfaces Ten-GigabitEthernet1/0/1:1 through Ten-GigabitEthernet1/0/1:4 will be deleted. Continue? [Y/N]:y

Related commands

using tengige

using hundredgige

Use using hundredgige to combine breakout interfaces split from a 100-GE interface into a 100-GE interface.

Syntax

using hundredgige

Default

The breakout interfaces are not combined and operate as single interfaces.

Views

10-GE breakout interface view

25-GE breakout interface view

Predefined user roles

network-admin

Usage guidelines

You can split a 100-GE interface into four 10-GE or four 25-GE breakout interfaces.

If you need higher bandwidth on a single interface, perform the following tasks as needed:

· You can combine four 10-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 10-GE breakout interfaces.

· You can combine four 25-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 25-GE breakout interfaces.

Device reboot is not required for this command to take effect. You can view the split or combined interface by using the display interface brief command.

Examples

# Combine Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4 into a 100-GE interface.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1:1

[Sysname-Twenty-FiveGigE1/0/1:1] using hundredgige

The interfaces Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4 will be deleted. Continue? [Y/N]:y

Related commands

using tengige

using twenty-fivegige

using tengige

Use using tengige to split a high bandwidth interface into multiple 10-GE breakout interfaces.

Syntax

using tengige

Default

A high bandwidth interface is not split and operates as a single interface.

Views

40-GE interface view

100-GE interface view

Predefined user roles

network-admin

Usage guidelines

To improve port density, reduce costs, and improve network flexibility, you can split a high bandwidth interface into multiple 10-GE breakout interfaces. For example:

· Split a 40-GE interface FortyGigE 1/0/1 into four 10-GE breakout interfaces Ten-GigabitEthernet 1/0/1:1 through Ten-GigabitEthernet 1/0/1:4.

After executing this command, you do not need to reboot the device. To view information about the 10-GE breakout interfaces, execute the display interface brief command.

An interface with any of the following configurations cannot be split:

· Service loopback group member.

· Reflector port for mirroring.

· Forcibly bringing up a fiber port.

Examples

# Split FortyGigE 1/0/1 into four 10-GE breakout interfaces.

<System> system-view

[System] interface fortygige 1/0/1

[System-FortyGigE1/0/1] using tengige

The interface FortyGigE1/0/1 will be deleted. Continue? [Y/N]:y

Related commands

using fortygige

using hundredgige

using twenty-fivegige

Use using twenty-fivegige to split a 100-GE interface into four 25-GE breakout interfaces.

Syntax

using twenty-fivegige

Default

A 100-GE interface is not split and operates as a single interface.

Views

100-GE interface view

Predefined user roles

network-admin

Usage guidelines

To improve port density, reduce costs, and improve network flexibility, you can split a 100-GE interface into four 25-GE breakout interfaces. For example, you can split the 100-GE interface HundredGigE 1/0/1 into four 25-GE breakout interfaces Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4.

After executing this command, you do not need to reboot the device. To view information about the 25-GE breakout interfaces, execute the display interface brief command.

An interface with any of the following configurations cannot be split:

· Service loopback group member.

· Reflector port for mirroring.

· Forcibly bringing up a fiber port.

Examples

# Split HundredGigE 1/0/1 into four 25-GE breakout interfaces.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] using twenty-fivegige

The interface HundredGigE1/0/1 will be deleted. Continue? [Y/N]:y

Related commands

using hundredgige

Layer 2 Ethernet interface commands

display storm-constrain

Use display storm-constrain to display storm control settings and statistics.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

broadcast: Displays broadcast storm control settings and statistics.

multicast: Displays multicast storm control settings and statistics.

unicast: Displays unknown unicast storm control settings and statistics.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays storm control settings and statistics for all storm control-enabled interfaces.

Usage guidelines

If you do not specify any keywords, this command displays all storm control settings on all storm control-enabled interfaces.

Examples

# Display the storm control settings on all storm control-enabled ports.

<Sysname> display storm-constrain

Abbreviation: BC - broadcast; MC - multicast; UC - unknown unicast;

KNUC - known unicast; FW - forwarding

Flow Statistic Interval: 5 (in seconds)

Port Type Lower Upper Unit Mode Status Trap Log StateChg

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

WGE1/0/1 MC 100 200 kbps shutdown shutdown off on 10

Table 10 Command output

Field	Description
Flow Statistic Interval	Traffic polling interval (in seconds) of the storm control module.
Port	Abbreviated interface name.
Type	Type of traffic subjected to storm control: · BC—Broadcast packets. · MC—Multicast packets. · UC—Unknown unicast packets.
Lower	Lower storm control threshold, in pps, kbps, or percentage.
Upper	Upper storm control threshold, in pps, kbps, or percentage.
Unit	Storm control threshold unit: · pps. · kbps. · percentage.
Mode	Action (block or shutdown) taken on the interface when the upper threshold is reached. N/A indicates that no action is configured.
Status	Packet forwarding status: · FW—The port is forwarding traffic correctly. · shutdown—The port has been shut down. · block—The port drops the type of traffic.
Trap	Status of the storm control threshold event trap switch: · on—The port sends threshold event traps. · off—The port does not send threshold event traps.
Log	Status of the storm control threshold event log switch: · on—The port sends threshold event log messages. · off—The port does not send threshold event log messages.
StateChg	Number of forwarding state changes of the interface. When the StateChg field reaches 65535, it resets automatically.

‌

port connection-distance

Use port connection-distance to set the interface connection distance.

Use undo port connection-distance to restore the default.

Syntax

port connection-distance { 300 | 10000 | 20000 }

undo port connection-distance

Default

The interface connection distance is 10000 meters.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

300: Sets the interface connection distance to 300 meters.

10000: Sets the interface connection distance to 10000 meters.

20000: Sets the interface connection distance to 20000 meters.

Usage guidelines

When two directly connected interfaces communicate, they use the buffer area to buffer the received data. A longer interface connection distance requires a greater buffer area.

Configure this command to modify the buffer area size by setting the interface connection distance.

Configure this command based on the network conditions because the buffer area size is limited.

Examples

# Sets the interface connection distance to 300 meters for Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] port connection-distance 300

storm-constrain

Use storm-constrain to enable storm control and set thresholds for broadcast, multicast, or unknown unicast packets on an Ethernet interface.

Use undo storm-constrain to disable storm control for broadcast, multicast, unknown unicast, or all types of traffic.

Syntax

storm-constrain { broadcast | multicast | unicast } { pps | kbps | ratio } upperlimit lowerlimit

undo storm-constrain { all | broadcast | multicast | unicast }

Default

Traffic storm control is disabled.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

all: Disables storm control for all types of traffic: broadcast, multicast, and unknown unicast.

broadcast: Enables or disables broadcast storm control.

multicast: Enables or disables multicast storm control.

unicast: Enables or disables unknown unicast storm control.

pps: Sets storm control thresholds in pps.

kbps: Sets storm control thresholds in kbps.

ratio: Sets storm control thresholds as a percentage of the transmission capacity of the interface.

upperlimit: Sets the upper threshold, in pps, kbps, or percentage.

· If you specify the pps keyword, the value range for the upperlimit argument is 1 to 1.4881 × the interface bandwidth.

· If you specify the kbps keyword, the value range for the upperlimit argument is 1 to the interface bandwidth.

· If you specify the ratio keyword, the value range for the upperlimit argument is 1 to 100.

lowerlimit: Sets the lower threshold, in pps, kbps, or percentage.

· If you specify the pps keyword, the value range for the lowerlimit argument is 1 to 1.4881 × the interface bandwidth.

· If you specify the kbps keyword, the value range for the lowerlimit argument is 1 to the interface bandwidth.

· If you specify the ratio keyword, the value range for the lowerlimit argument is 1 to 100.

Usage guidelines

After you configure storm control for a type of traffic, the device collects the statistics for the type of traffic at the interval configured by using the storm-constrain interval command. When the type of traffic exceeds its upper threshold, the interface takes an action configured by using the storm-constrain control command.

The storm-constrain, broadcast-suppression, multicast-suppression, and unicast-suppression commands can suppress storms on an interface. The broadcast-suppression, multicast-suppression, and unicast-suppression commands use the chip to physically suppress traffic. They have less influence on the device performance than the storm-constrain command, which uses software to suppress traffic.

For the traffic suppression result to be determined, do not configure both storm control and storm suppression for the same type of traffic.

When configuring this command, make sure upperlimit is greater than lowerlimit.

Examples

# Enable unknown unicast storm control on Twenty-FiveGigE 1/0/1 and set the upper and lower thresholds to 200 pps and 150 pps, respectively.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

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

# Enable broadcast storm control on Twenty-FiveGigE 1/0/2, and set the upper and lower thresholds to 2000 kbps and 1500 kbps, respectively.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/2

[Sysname-Twenty-FiveGigE1/0/2] storm-constrain broadcast kbps 2000 1500

# Enable multicast storm control on Twenty-FiveGigE 1/0/3, and set the upper and lower thresholds to 80% and 15%, respectively.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/3

[Sysname-Twenty-FiveGigE1/0/3] storm-constrain multicast ratio 80 15

Related commands

storm-constrain control

storm-constrain interval

storm-constrain control

Use storm-constrain control to set the action to take on an Ethernet interface when a type of traffic (unknown unicast, multicast, or broadcast) exceeds the upper storm control threshold.

Use undo storm-constrain control to restore the default.

Syntax

storm-constrain control { block | shutdown }

undo storm-constrain control

Default

No action is taken on an Ethernet interface when a type of traffic exceeds the upper storm control threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

block: Blocks this type of traffic and forwards other types of traffic. Even though the interface does not forward the blocked traffic, it still counts the traffic. When the blocked traffic drops below the lower threshold, the port begins to forward the traffic.

shutdown: Goes down automatically. The interface goes down automatically and stops forwarding any traffic. When the blocked traffic drops below the lower threshold, the interface does not forward the traffic. To bring up the interface, use the undo shutdown command or disable storm control on the interface.

Examples

# Configure Twenty-FiveGigE 1/0/1 to block a specific type of traffic when the type of traffic exceeds the upper storm control threshold.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] storm-constrain control block

Related commands

storm-constrain

storm-constrain control

storm-constrain enable log

Use storm-constrain enable log to enable an Ethernet interface to output log messages when it detects storm control threshold events.

Use undo storm-constrain enable log to disable an Ethernet interface from outputting log messages for storm control threshold events.

Syntax

storm-constrain enable log

undo storm-constrain enable log

Default

An Ethernet interface outputs log messages when monitored traffic exceeds the upper threshold or drops below the lower threshold from a value above the upper threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Examples

# Enable Twenty-FiveGigE 1/0/1 to output log messages when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] storm-constrain enable log

storm-constrain enable trap

Use storm-constrain enable trap to enable an Ethernet interface to send storm control threshold event traps.

Use undo storm-constrain enable trap to disable an Ethernet interface from sending storm control threshold event traps.

Syntax

storm-constrain enable trap

undo storm-constrain enable trap

Default

An interface sends out storm control threshold event traps when monitored traffic exceeds the upper threshold or drops below the lower threshold from a value above the upper threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Examples

# Enable Twenty-FiveGigE 1/0/1 to send traps when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] storm-constrain enable trap

storm-constrain interval

Use storm-constrain interval to set the traffic polling interval of the storm control module.

Use undo storm-constrain interval to restore the default.

Syntax

storm-constrain interval interval

undo storm-constrain interval

Default

The storm control module polls traffic statistics every 10 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Sets the traffic polling interval of the storm control module. The value range is 1 to 300 seconds. To ensure network stability, as a best practice, do not use a traffic polling interval shorter than 10 seconds.

Usage guidelines

The traffic polling interval set by using the storm-constrain interval command is specific to storm control. To set the statistics polling interval of an interface, use the flow-interval command.

Examples

# Set the traffic statistics polling interval of the storm control module to 60 seconds.

<Sysname> system-view

[Sysname] storm-constrain interval 60

Related commands

storm-constrain

storm-constrain control

02-Layer 2-LAN Switching Command Reference

flow-control receive enable

reset counters interface

display storm-constrain

port connection-distance

storm-constrain

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us