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 GigabitEthernet 3/1/1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] bandwidth 1000

# Set the expected bandwidth of GigabitEthernet 3/1/1.1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.1] bandwidth 1000

Related commands

speed

combo enable

Use combo enable to activate the copper or fiber combo port of a combo interface.

Syntax

combo enable { copper | fiber }

Default

The copper combo port of a combo interface is activated.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

copper: Activates the copper combo port. In this case, use twisted pairs to connect the port.

fiber: Activates the fiber combo port. In this case, use optical fibers to connect the port.

Usage guidelines

A combo interface is a logical interface that physically contains one fiber combo port and one copper combo port on the device panel. The two ports share one forwarding interface. As a result, they cannot work simultaneously. When you activate either port, the other port is automatically disabled. You can select to activate the copper combo port or fiber combo port.

Before using this command, perform the following tasks according to the marks on the device panel:

· Determine the combo interfaces on your device.

· Identify the two physical interfaces that belong to each combo interface.

This command does not take effect on a combo interface in a service loopback group. For more information about service loopback groups, see Layer 2—LAN Switching Configuration Guide.

Examples

# Activate the copper combo port of combo interface GigabitEthernet 1/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/1/1

[Sysname-GigabitEthernet1/1/1] combo enable copper

# Activate the fiber combo port of combo interface GigabitEthernet 1/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/1/1

[Sysname-GigabitEthernet1/1/1] combo enable fiber

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

This command and the link-delay command cannot be both configured 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 MSTP enabled.

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

Examples

# Enable interface dampening on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] dampening

# Enable interface dampening on GigabitEthernet 3/1/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 gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] dampening 2 800 3000 5

Related commands

display interface

link-delay

default

Use default to restore the default settings for an interface.

Syntax

default

Views

Ethernet interface view

Ethernet subinterface 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 GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] default

# Restore the default settings for GigabitEthernet 3/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.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, GigabitEthernet3/1/1 Interface).

Views

Ethernet interface view

Ethernet subinterface 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 GigabitEthernet 3/1/1 to lan-interface.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] description lan-interface

# Set the description of GigabitEthernet 3/1/1.1 to subinterface3/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.1] description subinterface3/1/1.1

display counters

Use display counters to display interface traffic statistics.

Syntax

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

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.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface.

Usage guidelines

This command displays traffic statistics within a statistics polling interval specified by using the flow-interval command.

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 or subinterface number, this command displays traffic statistics for all interfaces of the specified type.

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

Examples

# Display inbound traffic statistics for all GigabitEthernet interfaces.

<Sysname> display counters inbound interface gigabitethernet

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

GE3/1/1 100 100 0 0

GE3/1/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

flow-interval

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 | interface-number.subnumber ] ]

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.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface.

Usage guidelines

If you do not specify the inbound or outbound keyword, this command displays both the inbound and outbound traffic rate statistics for interfaces in up state within the most recent statistics polling interval.

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 or subinterface number, this command displays traffic rate statistics for all up interfaces of the specified type.

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

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.

You can use the flow-interval command to set the statistics polling interval.

Examples

# Display the inbound and outbound traffic rate statistics for GigabitEthernet 3/1/1.

<Sysname> display counters rate interface gigabitethernet 3/1/1

Usage: Bandwidth utilization in percentage

Interface InUsage (%) InTotal (pps) OutUsage (%) OutTotal (pps)

GE3/1/1 0 0 0 0

Overflow: More than 14 digits.

--: Not supported.

# Display the inbound traffic rate statistics for all GigabitEthernet interfaces.

<Sysname> display counters rate inbound interface gigabitethernet

Usage: Bandwidth utilization in percentage

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

GE3/1/1 3 200 100 100

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.
InUsage (%)	Bandwidth usage (in percentage) of all inbound packets within the most recent statistics polling interval. When the usage is smaller than 1%, 1% is displayed.
InTotal (pps)	Average receiving rate (in pps) for all packets within the most recent statistics polling interval.
OutUsage (%)	Bandwidth usage (in percentage) of all outbound packets within the most recent statistics polling interval. When the usage is smaller than 1%, 1% is displayed.
OutTotal (pps)	Average sending rate (in pps) for all packets within the most recent 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

In standalone mode:

display ethernet statistics slot slot-number

In IRF mode:

display ethernet statistics chassis chassis-number slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Examples

# (In standalone mode.) Display the Ethernet module statistics for the specified slot.

<Sysname> display ethernet statistics slot 3

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. · 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. · 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. · MbufRelayNum—Number of packets transparently sent.
ETH send error statistics	Statistics about the error Ethernet packets in the outbound direction on the Ethernet module: · 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 | interface-number.subnumber ] ] [ 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.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface.

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 27 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 or subinterface number, this command displays information about all interfaces of the specified type.

Examples

# Display information about Layer 3 interface GigabitEthernet 3/1/1.

<Sysname> display interface gigabitethernet 3/1/1

GigabitEthernet3/1/1

Current state: UP

Line protocol state: UP

Description: GigabitEthernet3/1/1 Interface

Bandwidth: 1000000 kbps

Flow-control is not enabled

Maximum transmission unit: 1500

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 1234-5678-9066

IPv6 packet frame type: Ethernet II, hardware address: 1234-5678-9066

Media type is twisted pair, port hardware type is 1000_BASE_T

Port priority: 0

Loopback is not set

1000Mbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10240

Last link flapping: 0 hours 30 minutes 52 seconds

Last clearing of counters: Never

Current system time:2017-12-21 09:10:12

Last time when physical state changed to up:2017-12-21 08:39:19

Last time when physical state changed to down:2017-12-21 08:37:21

Peak input rate: 903 bytes/sec, at 2017-12-21 07:02:00

Peak output rate: 0 bytes/sec, at 2017-12-21 09:10:07

Last 300 second input: 8 packets/sec 722 bytes/sec 0%

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

Input (total): 123220 packets, 11777588 bytes

482 unicasts, 87316 broadcasts, 35422 multicasts, - pauses

Input (normal): 123220 packets, - bytes

- unicasts, - broadcasts, - multicasts, 0 pauses

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

0 CRC, 0 frame, 0 overruns, - aborts

0 ignored, - parity errors

Output (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, - pauses

Output (normal): 0 packets, 0 bytes

- unicasts, - broadcasts, - multicasts, 0 pauses

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

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

- lost carrier, - no carrier

# Display detailed information about Layer 3 Ethernet subinterface GigabitEthernet1/1/1.1.

<Sysname> display interface gigabitethernet 1/1/1.1

GigabitEthernet1/1/1.1

Current state: DOWN

Line protocol state: DOWN

Description: GigabitEthernet1/1/1.1 Interface

Bandwidth: 1000000 kbps

Maximum transmission unit: 1500

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 80f6-fe00-f4a3

IPv6 packet frame type: Ethernet II, hardware address: 80f6-fe00-f4a3

Last clearing of counters: Never

Last 300 seconds input rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec

Last 300 seconds output rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec

Input (total): 0 packets, 0 bytes

(broadcasts) 0 packets, 0 bytes

(multicasts) 0 packets, 0 bytes

(unicasts) 0 packets, 0 bytes

Output (total): 0 packets, 0 bytes

(broadcasts) 0 packets, 0 bytes

(multicasts) 0 packets, 0 bytes

(unicasts) 0 packets, 0 bytes

# Display detailed information about Layer 2 interface GigabitEthernet 3/1/1.

<Sysname> display interface gigabitethernet 3/1/1

GigabitEthernet3/1/1

Current state: DOWN

Line protocol state: DOWN

IP packet frame type: Ethernet II, hardware address: 00fc-5ba5-d800

Description: GigabitEthernet3/1/1 Interface

Bandwidth: 1000000 kbps

Loopback is not set

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

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

Maximum frame length: 9216

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

PVID: 1

MDI type: Automdix

Port link-type: Access

Tagged VLANs: None

Untagged VLANs: 1

Port priority: 0

Last link flapping: Never

Last clearing of counters: Never

Current system time:2017-12-13 12:07:43

Last time when physical state changed to up:-

Last time when physical state changed to down:2017-12-11 17:51:41

Peak input rate: 0 bytes/sec, at 2017-12-12 17:27:42

Peak output rate: 0 bytes/sec, at 2017-12-12 17:27:42

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

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

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. · 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 ( Tunnel-Bundle administratively down )—The tunnel bundle interface to which the interface belongs has been shut down by using the shutdown command. · ETH-rddc Shutdown—The interface has been shut down by the Reth module. · IRF-link-down—The interface has been shut down by IRF. This state occurs when the IRF member device that contains the interface is detected to have lost the connectivity of all its IRF links. · mac-address moving down—The interface has been shut down by the MAC address move suppression feature. · MAD ShutDown—The interface has been shut down by IRF MAD. This state occurs if the interface is on an IRF fabric placed in Recovery state after an IRF split. · 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. ¡ MACSEC—Shuts down the data link layer when it fails to negotiate the encryption parameters.
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 of the interface. The primary attribute indicates that the address is the primary IP address.
IP packet frame type	IPv4 packet framing format.
hardware address	MAC address of the interface.
IPv6 packet frame type	IPv6 packet framing format.
Port priority	Port priority 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.
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.
10Mbps-speed mode	The interface is operating at 10 Mbps. This field depends on your configuration and the link parameter negotiation result.
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.
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.
half-duplex mode	The interface is operating in half duplex mode. This field depends on your configuration and the link parameter negotiation result.
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, 10 Mbps or 100 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 in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Multicast max-	Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Unicast max-	Unknown unicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
PVID	Port VLAN ID (PVID) of the interface.
MDI type	MDIX mode of the interface: · automdix. · mdi. · mdix.
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.
Ethernet port mode	Operating mode of a 10-GE interface: · LAN. · WAN. For more information, see the port-mode command.
Regenerator section layer	Alarm and error statistics of the regenerator section.
J0(TX)	Sent J0 trace byte value.
J0(RX)	Received J0 trace byte value.
Error	Error statistics,
Multiplex section layer	Alarm and error statistics of the multiplex section.
Higher order path layer	Alarm and error statistics of the higher order path.
J1(TX)	Sent J1 trace byte value.
J1(RX)	Received J1 trace byte value.
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 UTC±HH:MM:SS format.
Last time when physical state changed to up	Last time when physical state of the interface changed to up. A hyphen (-) indicates that the physical state of the interface has not changed to up.
Last time when physical state changed to down	Last time when physical state of the interface changed to down. A hyphen (-) indicates that the physical state of the interface has not changed to down.
Last interval second input: 8 packets/sec 722 bytes/sec 0% Last interval second 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, use the flow-interval command. A hyphen (-) indicates that the statistical item is not supported.
Input (total): 123220 packets, 11777588 bytes 482 unicasts, 87316 broadcasts, 35422 multicasts, - 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): 123220 packets, - bytes - unicasts, - broadcasts, - 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.
Last 300 seconds input rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec Last 300 seconds output rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec	Average inbound or outbound traffic rate (in Bps, bps, and pps) in the last 300 seconds. These fields are displayed only when the traffic-statistic enable command is configured.
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: · 1518 bytes (without VLAN tags). · 1522 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 1518 bytes (without VLAN tags) or 1522 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, - 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 - unicasts, - broadcasts, - 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.

# 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

GE3/1/1 DOWN DOWN --

Loop0 UP UP(s) 2.2.2.9

NULL0 UP UP(s) --

Vlan1 UP DOWN --

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

GE3/1/2 DOWN auto A A 1

GE3/1/3 UP 100M(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display brief information about GigabitEthernet 3/1/3, including the complete description of the interface.

<Sysname> display interface gigabitethernet 3/1/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

GE3/1/3 UP 100M(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaaaa

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

GE3/1/1 DOWN Not connected

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

GE3/1/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. · IRF-link-down—The IRF member device that contains the interface has lost the connectivity of all its IRF links. · MAD ShutDown—The interface is on an IRF fabric placed by IRF MAD in Recovery state after an IRF split. · 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. · Standby—The interface is a backup interface in standby state.
Link physical state	Physical state of the IRF port. This field is displayed only when the VLAN used for sending and receiving IRF protocol packets is configured when IRF port is bound to the IRF physical interface.
Link detect state	State of the link where the IRF port resides. This field is displayed only when the VLAN used for sending and receiving IRF protocol packets is configured when IRF port is bound to the IRF physical interface.

Related commands

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 [ main ]

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

GE3/1/1 UP UP 10.09% 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. When the usage is smaller than 0.01%, 0.01% is displayed. 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. When the usage is smaller than 0.01%, 0.01% is displayed. 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 interface main

Use display interface main to display operating status and information of all interfaces except subinterfaces.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type. If you do not specify this argument, the command displays information about interfaces of all types.

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 27 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.

Examples

# Display operating status and information of all interfaces except subinterfaces.

<Sysname> display interface main

GigabitEthernet3/1/1

Current state: UP

Line protocol state: UP

Description: GigabitEthernet3/1/1 Interface

Bandwidth: 1000000 kbps

Flow-control is not enabled

Maximum transmission unit: 1500

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 1234-5678-9066

IPv6 packet frame type: Ethernet II, hardware address: 1234-5678-9066

Media type is twisted pair, port hardware type is 1000_BASE_T

Port priority: 0

Loopback is not set

1000Mbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10240

Last link flapping: 0 hours 30 minutes 52 seconds

Last clearing of counters: Never

Current system time:2017-12-21 09:10:12

Last time when physical state changed to up:2017-12-21 08:39:19

Last time when physical state changed to down:2017-12-21 08:37:21

Peak input rate: 903 bytes/sec, at 2017-12-21 07:02:00

Peak output rate: 0 bytes/sec, at 2017-12-21 09:10:07

Last 300 second input: 8 packets/sec 722 bytes/sec 0%

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

Input (total): 123220 packets, 11777588 bytes

482 unicasts, 87316 broadcasts, 35422 multicasts, - pauses

Input (normal): 123220 packets, - bytes

- unicasts, - broadcasts, - multicasts, 0 pauses

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

0 CRC, 0 frame, 0 overruns, - aborts

0 ignored, - parity errors

Output (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, - pauses

Output (normal): 0 packets, 0 bytes

- unicasts, - broadcasts, - multicasts, 0 pauses

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

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

- lost carrier, - no carrier

# Display brief information of all interfaces except subinterfaces.

<Sysname> display interface brief main

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Primary IP Description

GE3/0/1 UP UP 192.168.2.88

InLoop0 UP UP(s) --

NULL0 UP UP(s) --

REG0 UP -- --

VT1 DOWN DOWN --

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

GE3/0/2 DOWN auto A A 1 aaaaa

# Display brief information about all interfaces, including the complete interface descriptions.

<Sysname> display interface brief description main

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Primary IP Description

GE3/0/3 UP UP 2.2.2.9 aaaaaaaaaaaaaaaaa

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

<Sysname> display interface brief down main

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

GE3/1/1 DOWN Not connected

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

GE3/1/2 DOWN Not connected

For description on the display interface main command output, see Table 4 and Table 5.

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 all interfaces that support this command.

Usage guidelines

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

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

This command cannot display packets dropped by Ethernet interfaces on CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, and CEPC cards.

Examples

# Display information about dropped packets on GigabitEthernet 3/1/1.

<Sysname> display packet-drop interface gigabitethernet 3/1/1

GigabitEthernet3/1/1:

Packets dropped due to full GBP or insufficient bandwidth: 0

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

Packets dropped due to STP non-forwarding state: 0

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

<Sysname> display packet-drop summary

All interfaces:

Packets dropped due to full GBP or insufficient bandwidth: 0

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

Packets dropped due to STP non-forwarding state: 0

Table 7 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.

display portcar

Use display portcar to display protocol group rate limit information.

Syntax

display portcar slot global-slot-number [ cpu cpu-number ] verbose

Views

System view

Predefined user roles

network-admin

network-operator

Parameters

slot global-slot-number: Specifies a card by its global slot number. The value range is the slot numbers of the CSPEX (except CSPEX-1104-E) and CEPC cards on the device. In IRF mode, the global slot number is (chassis-number - 1) * 23 + slot-number, where the chassis-number argument represents the member ID of the IRF member device and the slot-number argument represents the slot number of the card.

cpu cpu-number: Specifies a CPU by its number. When the specified slot does not support multiple CPUs, the CPU number is fixed at 0 and does not need to be configured.

verbose: Displays detailed protocol group rate limit information.

Examples

# Display detailed protocol group rate limit information of slot 3.

<Sysname> system-view

[Sysname] display portcar slot 3 verbose

PortCar info, Slot:3

Group Id Rate-Value(pps) Protocol

1 1 LDP_HELLO&LDP&LDPv6

2 30 SNMP

3 100 TFTP

4 1100000 BFD

5 600 PIMv4_UC&PIMv6_UC

6 600 PIMv4_MC&PIMv6_MC

...

Table 8 Command output

Field	Description
Group Id	Protocol group ID.
Rate-Value(pps)	Maximum number of packets that can be forwarded in the protocol group per second, in pps.
Protocol	Protocols in the protocol group.

Related commands

set portcar

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

10-GE, 40-GE, and 100-GE interfaces operate in full duplex mode, and all other types of 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.

Usage guidelines

Fiber ports do not support half duplex mode.

On an interface subcard in a CSPEX-1104-E or SPEX-1204 card, copper ports do not support half duplex mode. On an interface subcard in any other CSPEX card, only copper ports on an MIC-GP4L interface subcard support half duplex mode.

Examples

# Configure GigabitEthernet 3/1/1 to operate in full duplex mode.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] duplex full

flag sdh

IMPORTANT:

This command is effective only when the 10-GE interface is operating in WAN mode.

Use flag sdh to set the value for the overhead byte J0 or J1 in SDH frames on a 10-GE interface.

Use undo flag sdh to restore the default.

Syntax

flag { j0 | j1 } sdh value

undo flag { j0 | j1 } sdh

Default

The value for the Regenerator Section Trace byte J0 is SR8800.

Views

10-GE interface view

Predefined user roles

network-admin

Parameters

j0: Specifies the Regenerator Section Trace byte J0.

j1: Specifies the Path Trace byte J1.

value: Specifies the value for the J0 or J1 byte, a string of 1 to 15 characters.

Examples

# Set the value of the J0 byte in SDH frames to Sysname on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] port-mode wan

[Sysname-Ten-GigabitEthernet3/1/1] flag j0 sdh Sysname

Related commands

port-mode

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.

Examples

# Enable TxRx-mode generic flow control on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/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.

Examples

# Enable Rx-mode generic flow control on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-gigabitethernet 3/1/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

System view

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.

Usage guidelines

You can use this command in system view or interface view.

· In system view, the command takes effect on all interfaces.

· In interface view, the command takes effect only on the specified interface.

When the statistics polling interval uses the default setting in interface view, the setting in system view takes effect. When the command is configured in both system view and interface view, the setting in interface view takes priority.

As a best practice, use the default value for the flow-interval command in system view. A short static polling interval in system view might decrease the system performance and result in inaccurate statistics.

You can use the display interface command to view the statistics only after two consecutive statistics polling intervals. The statistics are displayed by the Last interval second input and Last interval second input fields in the display interface command output.

Examples

# Set the statistics polling interval to 100 seconds for interfaces.

<Sysname> system-view

[Sysname] flow-interval 100

Related commands

display interface

ifmonitor crc-error

Use ifmonitor crc-error to configure global CRC error packet alarm parameters.

Use undo ifmonitor crc-error to restore the default.

Syntax

In standalone mode:

ifmonitor crc-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor crc-error slot slot-number

In IRF mode:

ifmonitor crc-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor crc-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for CRC error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the CRC error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor crc-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor input-error

Use ifmonitor input-error to configure global input error packet alarm parameters.

Use undo ifmonitor input-error to restore the default.

Syntax

In standalone mode:

ifmonitor input-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-error slot slot-number

In IRF mode:

ifmonitor input-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for input error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of input error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of input error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the input error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for input error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor input-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor input-usage

Use ifmonitor input-usage to configure global input bandwidth usage alarm parameters.

Use undo ifmonitor input-usage to restore the default.

Syntax

In standalone mode:

ifmonitor input-usage slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor input-usage slot slot-number

In IRF mode:

ifmonitor input-usage chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor input-usage chassis chassis-number slot slot-number

Default

The upper threshold is 90, and the lower threshold is 80.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

The statistics polling interval varies by device model:

· On a device that does not support the flow-interval command, the statistics polling interval is 5 minutes.

· On a device that supports the flow-interval command, you can use the flow-interval command to set the statistics polling interval.

You can configure the input bandwidth usage alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the input bandwidth usage alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 95 and lower threshold to 80 for input bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor input-usage high-threshold 95 low-threshold 80

Related commands

flow-interval

snmp-agent trap enable ifmonitor

ifmonitor output-error

Use ifmonitor output-error to configure global output error packet alarm parameters.

Use undo ifmonitor output-error to restore the default.

Syntax

In standalone mode:

ifmonitor output-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-error slot slot-number

In IRF mode:

ifmonitor output-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for output error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of output error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of output error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the output error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for output error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor output-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor output-usage

Use ifmonitor output-usage to configure global output bandwidth usage alarm parameters.

Use undo ifmonitor output-usage to restore the default.

Syntax

In standalone mode:

ifmonitor output-usage slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor output-usage slot slot-number

In IRF mode:

ifmonitor output-usage chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor output-usage chassis chassis-number slot slot-number

Default

The upper threshold is 90, and the lower threshold is 80.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

The statistics polling interval varies by device model:

· On a device that does not support the flow-interval command, the statistics polling interval is 5 minutes.

· On a device that supports the flow-interval command, you can use the flow-interval command to set the statistics polling interval.

You can configure the output bandwidth usage alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the output bandwidth usage alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 80 and lower threshold to 60 for output bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor output-usage high-threshold 80 low-threshold 60

Related commands

flow-interval

snmp-agent trap enable ifmonitor

ifmonitor rx-pause

Use ifmonitor rx-pause to configure global received pause frame alarm parameters.

Use undo ifmonitor rx-pause to restore the default.

Syntax

In standalone mode:

ifmonitor rx-pause slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor rx-pause slot slot-number

In IRF mode:

ifmonitor rx-pause chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor rx-pause chassis chassis-number slot slot-number

Default

The upper threshold is 500, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for received pause frame alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for received pause frame alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for received pause frame alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for received pause frames, in the range of 1 to 65535 seconds.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the received pause frame alarm function enabled, when the number of received pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of received pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the received pause frame alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the received pause frame alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 30, lower threshold to 20, and statistics collection and comparison interval to 4 seconds for received pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor rx-pause high-threshold 30 low-threshold 20 interval 4

Related commands

snmp-agent trap enable ifmonitor

ifmonitor sdh-b1-error

Use ifmonitor sdh-b1-error to configure global SDH-B1 error packet alarm parameters.

Use undo ifmonitor sdh-b1-error to restore the default.

Syntax

In standalone mode:

ifmonitor sdh-b1-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-b1-error slot slot-number

In IRF mode:

ifmonitor sdh-b1-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-b1-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for SDH-B1 error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH-B1 error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of incoming SDH-B1 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B1 error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the SDH-B1 error packet alarm function enabled, when the number of incoming SDH-B1 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B1 error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the SDH-B1 error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B1 error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 65, lower threshold to 25, and statistics collection and comparison interval to 20 seconds for SDH-B1 error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor sdh-b1-error high-threshold 65 low-threshold 25 interval 20

Related commands

snmp-agent trap enable ifmonitor

ifmonitor sdh-b2-error

Use ifmonitor sdh-b2-error to configure global SDH-B2 error packet alarm parameters.

Use undo ifmonitor sdh-b2-error to restore the default.

Syntax

In standalone mode:

ifmonitor sdh-b2-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-b2-error slot slot-number

In IRF mode:

ifmonitor sdh-b2-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-b2-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for SDH-B2 error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH-B2 error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of incoming SDH-B2 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B2 error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the SDH-B2 error packet alarm function enabled, when the number of incoming SDH-B2 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B2 error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the SDH-B2 error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B2 error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 6, lower threshold to 5, and statistics collection and comparison interval to 2 seconds for SDH-B2 error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor sdh-b2-error high-threshold 6 low-threshold 5 interval 2

Related commands

snmp-agent trap enable ifmonitor

ifmonitor sdh-error

Use ifmonitor sdh-error to configure global SDH error packet alarm parameters.

Use undo ifmonitor sdh-error to restore the default.

Syntax

In standalone mode:

ifmonitor sdh-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-error slot slot-number

In IRF mode:

ifmonitor sdh-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor sdh-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for SDH error packet alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of incoming SDH error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH error packets exceeds the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the SDH error packet alarm function enabled, when the number of incoming SDH error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the SDH error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 35, lower threshold to 20, and statistics collection and comparison interval to 8 seconds for SDH error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor sdh-error high-threshold 35 low-threshold 20 interval 8

Related commands

snmp-agent trap enable ifmonitor

ifmonitor tx-pause

Use ifmonitor tx-pause to configure global sent pause frame alarm parameters.

Use undo ifmonitor tx-pause to restore the default.

Syntax

In standalone mode:

ifmonitor tx-pause slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor tx-pause slot slot-number

In IRF mode:

ifmonitor tx-pause chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor tx-pause chassis chassis-number slot slot-number

Default

The upper threshold is 500, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for sent pause frame alarms.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for sent pause frame alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for sent pause frame alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for sent pause frames, in the range of 1 to 65535 seconds.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

Usage guidelines

With the sent pause frame alarm function enabled, when the number of sent pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of sent pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the sent pause frame alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the sent pause frame alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 20, lower threshold to 10, and statistics collection and comparison interval to 5 seconds for sent pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor tx-pause high-threshold 20 low-threshold 10 interval 5

Related commands

snmp-agent trap enable ifmonitor

interface

Use interface to enter interface view, create a subinterface and enter its view, or enter the view of an existing subinterface.

Syntax

interface interface-type { interface-number | interface-number.subnumber }

Views

System view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 99999999. On a main interface, you can create up to 16383 subinterfaces. For Layer 3 Ethernet subinterfaces on SPC and MPE-1104 cards, the value range for the subnumber argument is 1 to 4093.

Examples

# Enter the view of GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1]

# Create Ethernet subinterface GigabitEthernet 3/1/1.1 and enter its view.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.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 a specific length to pass through.

Views

Layer 2 Ethernet interface view

Layer 3 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.

· For interfaces on PIC-PS2G4L and PIC-TCP8L subcards in a SPEX-1204 card, the value range is 1552 to 2048 bytes.

· For interfaces on PIC-XP1L subcards in a SPEX-1204 card, the value range is 1552 to 9600 bytes.

· For interfaces on PIC-GP10L subcards in a SPEX-1204 card, the value range is 1552 to 3072 bytes.

· For interfaces on MIC interface subcards in a CSPEX-1104-E or SPEX-1204 card, the value range is 1552 to 3072 bytes.

· For interfaces on SPC and MPE-1104 cards, the value range is 1536 to 9216 bytes.

Usage guidelines

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

Interfaces on CSPEX (except CSPEX-1104-E) and CEPC cards do not support this command.

Examples

# Allow jumbo frames to pass through GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/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 [ msec ] delay-time [ mode { up | updown } ]

undo link-delay [ msec ] delay-time [ mode { up | updown } ]

Default

The physical state change suppression interval on an Ethernet interface is 1 second.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

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 60 seconds.

· If you specify the msec keyword, as a best practice, set the value in the range of 100 to 10000 milliseconds, and the value must be a multiple of 100.

mode up: Suppresses the link-up events.

mode updown: Suppresses both the link-up and link-down events.

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 only link-down events, configure the link-delay [ msec ] delay-time command.

· To suppress only link-up events, configure the link-delay [ msec ] delay-time mode up command.

· To suppress both link-down and link-up events, configure the link-delay [ msec ] delay-time mode updown command.

On an interface, you can configure different suppression intervals for link-up and link-down events. If you configure the link-delay command multiple times for link-up or link-down events, the most recent configuration takes effect.

Do not configure this command on an interface with spanning tree protocols enabled.

Examples

# Set the link-down event suppression interval to 8 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] link-delay 8

# Set the link-up event suppression interval to 800 milliseconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] link-delay msec 800 mode up

loopback

CAUTION:

After you enable loopback testing on an Ethernet interface, the interface does not forward data traffic.

Use loopback to enable loopback testing on an Ethernet interface.

Use undo loopback to disable loopback testing on an Ethernet interface.

Syntax

loopback { external | internal }

undo loopback

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

CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, and CEPC cards do not support the external keyword.

The internal keyword can be configured but does not take effect on the following interfaces:

· The first interface on the MIC-XP5L subcard.

· Interfaces on the MIC-QP1L, MIC-XP2L-LAN, and MIC-CP1L subcards.

· Interfaces on the CEPC-XP48RX card.

After the following interfaces are switched to GE interfaces by using the using gigabit command, the GE interfaces do not support the internal keyword.

· All interfaces on the MIC-XP20L, MIC-XP2L, and MIC-XP4L1 subcards.

· The last four interfaces on each MIC-XP5L or MIC-XP5L1 subcard.

After you enable loopback testing on an Ethernet interface, the Ethernet interface switches to full duplex mode. After you disable loopback testing, the Ethernet interface restores to its duplex setting.

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

Examples

# Enable internal loopback testing on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] loopback internal

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

The FEC mode of 100-GE interfaces is auto.

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.

You can modify the FEC mode for only 100-GE interfaces that support the QSFP28 transceiver modules.

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

Examples

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

<Sysname> system-view

[Sysname] interface hundredgige 3/1/1

[Sysname-HundredGigE3/1/1] port fec mode auto

port ifmonitor crc-error

Use port ifmonitor crc-error to configure CRC error packet alarm parameters for an interface.

Use undo port ifmonitor crc-error to restore the default.

Syntax

port ifmonitor crc-error [ ratio ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor crc-error

Default

An interface uses the global CRC error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

ratio: Specifies the alarm thresholds in percentage. If you do not specify this keyword, you configure the alarm thresholds in absolute value.

high-threshold high-value: Specifies the upper threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the CRC error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor crc-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-error

Use port ifmonitor input-error to configure input error packet alarm parameters for an interface.

Use undo port ifmonitor input-error to restore the default.

Syntax

port ifmonitor input-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor input-error

Default

An interface uses the global input error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the input error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for input error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor input-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-usage

Use port ifmonitor input-usage to configure input bandwidth usage alarm parameters.

Use undo port ifmonitor input-usage to restore the default.

Syntax

port ifmonitor input-usage high-threshold high-value low-threshold low-value

undo port ifmonitor input-usage

Default

An interface uses the global input bandwidth usage alarm parameters.

Views

Interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.

Usage guidelines

The statistics polling interval varies by device model:

· On a device that does not support the flow-interval command, the statistics polling interval is 5 minutes.

· On a device that supports the flow-interval command, you can use the flow-interval command to set the statistics polling interval.

You can configure the input bandwidth usage alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the input bandwidth usage alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 80 and lower threshold to 60 for input bandwidth usage alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor input-usage high-threshold 80 low-threshold 60

Related commands

flow-interval

snmp-agent trap enable ifmonitor

port ifmonitor output-error

Use port ifmonitor output-error to configure output error packet alarm parameters for an interface.

Use undo port ifmonitor output-error to restore the default.

Syntax

port ifmonitor output-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor output-error

Default

An interface uses the global output error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the output error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for output error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor output-error high-threshold 5 low-threshold 4 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor output-usage

Use port ifmonitor output-usage to configure output bandwidth usage alarm parameters.

Use undo port ifmonitor output-usage to restore the default.

Syntax

port ifmonitor output-usage high-threshold high-value low-threshold low-value

undo port ifmonitor output-usage

Default

An interface uses the global output bandwidth usage alarm parameters.

Views

Interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.

Usage guidelines

The statistics polling interval varies by device model:

· On a device that does not support the flow-interval command, the statistics polling interval is 5 minutes.

· On a device that supports the flow-interval command, you can use the flow-interval command to set the statistics polling interval.

You can configure the output bandwidth usage alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the output bandwidth usage alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 9 and lower threshold to 7 for output bandwidth usage alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor output-usage high-threshold 9 low-threshold 7

Related commands

flow-interval

snmp-agent trap enable ifmonitor

port ifmonitor rx-pause

Use port ifmonitor rx-pause to configure received pause frame packet alarm parameters for an interface.

Use undo port ifmonitor rx-pause to restore the default.

Syntax

port ifmonitor rx-pause high-threshold high-value low-threshold low-value interval interval

undo port ifmonitor rx-pause

Default

An interface uses the global received pause frame packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for received pause frame packet alarms, in the range of 1 to 4294967295.

low-threshold low-value: Specifies the lower threshold for received pause frame packet alarms, in the range of 1 to 4294967295.

interval interval: Specifies the statistics collection and comparison interval for received pause frame packets, in the range of 1 to 65535 seconds.

Usage guidelines

With the received pause frame packet alarm function enabled, when the number of received pause frame packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of received pause frame packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the received pause frame packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the received pause frame alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 90, lower threshold to 50, and statistics collection and comparison interval to 5 seconds for received pause frame packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor rx-pause high-threshold 90 low-threshold 50 interval 5

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor sdh-b1-error

Use port ifmonitor sdh-b1-error to configure SDH-B1 error packet alarm parameters for an interface.

Use undo port ifmonitor sdh-b1-error to restore the default.

Syntax

port ifmonitor sdh-b1-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor sdh-b1-error

Default

An interface uses the global SDH-B1 error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH-B1 error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the SDH-B1 error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B1 error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 20, lower threshold to 10, and statistics collection and comparison interval to 10 seconds for SDH-B1 error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor sdh-b1-error high-threshold 20 low-threshold 10 interval 10

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor sdh-b2-error

Use port ifmonitor sdh-b2-error to configure SDH-B2 error packet alarm parameters for an interface.

Use undo port ifmonitor sdh-b2-error to restore the default.

Syntax

port ifmonitor sdh-b2-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor sdh-b2-error

Default

An interface uses the global SDH-B2 error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH-B2 error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the SDH-B2 error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B2 error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 10, lower threshold to 8, and statistics collection and comparison interval to 3 seconds for SDH-B2 error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor sdh-b2-error high-threshold 10 low-threshold 8 interval 3

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor sdh-error

Use port ifmonitor sdh-error to configure SDH error packet alarm parameters for an interface.

Use undo port ifmonitor sdh-error to restore the default.

Syntax

port ifmonitor sdh-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor sdh-error

Default

An interface uses the global SDH error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for SDH error packets, in the range of 1 to 65535 seconds.

Usage guidelines

You can configure the SDH error packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH error packet alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 50, lower threshold to 30, and statistics collection and comparison interval to 10 seconds for SDH error packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor sdh-error high-threshold 50 low-threshold 30 interval 10

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor tx-pause

Use port ifmonitor tx-pause to configure sent pause frame packet alarm parameters for an interface.

Use undo port ifmonitor tx-pause to restore the default.

Syntax

port ifmonitor tx-pause high-threshold high-value low-threshold low-value interval interval

undo port ifmonitor tx-pause

Default

An interface uses the global sent pause frame packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper threshold for sent pause frame packet alarms, in the range of 1 to 4294967295.

low-threshold low-value: Specifies the lower threshold for sent pause frame packet alarms, in the range of 1 to 4294967295.

interval interval: Specifies the statistics collection and comparison interval for sent pause frame packets, in the range of 1 to 65535 seconds.

Usage guidelines

With the sent pause frame packet alarm function enabled, when the number of sent pause frame packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of sent pause frame packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the sent pause frame packet alarm parameters in system view and interface view.

· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the sent pause frame alarm function.

When you configure this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 50, lower threshold to 40, and statistics collection and comparison interval to 8 seconds for sent pause frame packet alarms on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port ifmonitor tx-pause high-threshold 50 low-threshold 40 interval 8

Related commands

snmp-agent trap enable ifmonitor

port link-mode

Use port link-mode to change the link mode of an Ethernet interface.

Use undo port link-mode to restore the default.

Syntax

port link-mode { bridge | route }

undo port link-mode

Default

An Ethernet interface operates in Layer 3 mode.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

bridge: Specifies the Layer 2 mode.

route: Specifies the Layer 3 mode.

Usage guidelines

Interfaces on the device can operate either as Layer 2 or Layer 3 Ethernet interfaces. You can use commands to set the link mode to bridge or route.

Changing the link mode of an Ethernet interface also restores all commands (except shutdown and combo enable) on the Ethernet interface to their defaults in the new link mode.

Examples

# Configure GigabitEthernet 3/1/1 to operate in Layer 2 mode.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port link-mode bridge

port-mode

Use port-mode to configure a 10-GE interface to operate in LAN or WAN mode.

Use undo port-mode to restore the default.

Syntax

port-mode { lan | wan }

undo port-mode

Default

A 10-GE interface operates in LAN mode.

Views

10-GE interface view

Predefined user roles

network-admin

Parameters

lan: Configures the interface to operate in LAN mode. An interface operating in this mode transmits Ethernet packets and connects an Ethernet network.

wan: Configures the interface to operate in WAN mode. An interface operating in this mode transmits SDH packets and connects an SDH network. In addition, it supports point-to-point links only.

Usage guidelines

Only interfaces on a PIC-XP1L, MIC-XP2L, MIC-XP4L1, MIC-XP5L1, MIC-XP20L, NIC-XP5L, NIC-XP10L, or NIC-XP20L interface subcard and the last four interfaces on a MIC-XP5L interface subcard support this command.

Examples

# Configure Ten-GigabitEthernet 1/1/1 to operate in WAN mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 1/1/1

[Sysname-Ten-GigabitEthernet1/1/1] port-mode wan

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.

Only 10-GE fiber ports operating in LAN mode, GE fiber ports, 40-GE fiber ports, and 100-GE fiber ports support this command.

Copper ports and combo interfaces do not support this command.

Interfaces on CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, and CEPC do not support this command.

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

A GE fiber port forcibly brought up cannot correctly forward traffic if it is installed with a fiber-to-copper converter, 100/1000-Mbps transceiver module, or 100-Mbps transceiver module. To solve the problem, use the undo port up-mode command on the fiber port.

Examples

# Forcibly bring up fiber port GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port up-mode

priority-flow-control

Use priority-flow-control to enable PFC in auto mode or forcibly.

Use undo priority-flow-control to disable PFC.

Syntax

priority-flow-control { auto | enable }

undo priority-flow-control

Default

PFC is disabled on Ethernet interfaces.

Views

System view

Predefined user roles

network-admin

Parameters

auto: Specifies PFC in auto mode. In this mode, the local end automatically negotiates the PFC status with its peer. This keyword is not supported in the current software version.

enable: Forcibly enables PFC.

Usage guidelines

When congestion occurs in the network, the local device buffers packets if the following conditions exist:

· The local device has PFC enabled and the priority-flow-control no-drop dot1p command configured.

· The local device receives a packet carrying a 802.1p priority that is in the 802.1p priority list specified by the dot1p-list argument.

When the number of buffered packets reaches a certain value, the local device notifies the remote device to stop sending packets if the following conditions exist:

· The incoming interface on the local device is configured with the flow-control command.

· The outgoing interface on the remote device is configured with the flow-control or flow-control receive enable command.

When congestion disappears, the local device notifies the remote device to restore packet sending.

In IRF mode, this feature is supported only when the incoming interface and outgoing interface are on the same member device.

Examples

# Enable PFC on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] priority-flow-control enable

Related commands

priority-flow-control no-drop dot1p

Use priority-flow-control no-drop dot1p to enable PFC for 802.1p priorities.

Use undo priority-flow-control no-drop dot1p to disable PFC for the specified 802.1p priority.

Syntax

priority-flow-control no-drop dot1p dot1p-list

undo priority-flow-control no-drop dot1p

Default

PFC is disabled for all 802.1p priorities.

Views

System view

Predefined user roles

network-admin

Parameters

dot1p-list: Specifies an 802.1p priority (or dot1p priority) list to identify flows that are subject to PFC (for example: 1,3-5). A hyphen (-) connects two numeric values, which together indicate a continuous value range. Different values or value ranges are separated with commas (,). You can configure up to 16 characters for this argument.

Usage guidelines

When congestion occurs in the network, the local device buffers packets if the following conditions exist:

· The local device has PFC enabled and the priority-flow-control no-drop dot1p command configured.

· The local device receives a packet carrying a 802.1p priority that is in the 802.1p priority list specified by the dot1p-list argument.

When the number of buffered packets reaches a certain value, the local device notifies the remote device to stop sending packets if the following conditions exist:

· The incoming interface on the local device is configured with the flow-control command.

· The outgoing interface on the remote device is configured with the flow-control or flow-control receive enable command.

When congestion disappears, the local device notifies the remote device to restore packet sending.

In IRF mode, this feature is supported only when the incoming interface and outgoing interface are on the same member device.

Examples

# Enable PFC forcibly and enable PFC for 802.1p priority 5.

<Sysname> system-view

[Sysname] priority-flow-control no-drop dot1p 5

Related commands

flow-control

flow-control receive enable

priority-flow-control

reset counters interface

Use reset counters interface to clear the interface statistics.

Syntax

reset counters interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

User view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface.

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 GigabitEthernet 3/1/1.

<Sysname> reset counters interface gigabitethernet 3/1/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

In standalone mode:

reset ethernet statistics [ slot slot-number ]

In IRF mode:

reset ethernet statistics [ chassis chassis-number slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears statistics for all cards. (In standalone mode.)

Examples

# (In standalone mode.) Clear the Ethernet module statistics for the specified slot.

<Sysname> reset ethernet statistics slot 3

Related commands

display ethernet statistics

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. If you do not specify an interface type, this command clears dropped packet statistics for all interfaces on the device.

interface-number: Specify an interface number. If you do not specify this argument, the command clears dropped packet statistics for all interfaces of the specified type.

Examples

# Clear dropped packet statistics for GigabitEthernet 3/1/1.

<Sysname> reset packet-drop interface gigabitethernet 3/1/1

# Clear dropped packet statistics for all interfaces.

<Sysname> reset packet-drop interface

Related commands

display packet-drop

set portcar

Use set portcar to set the protocol group rate limits.

Syntax

set portcar group-id rate slot global-slot-number

Default

For more information, see the display portcar command output.

Views

System view

Predefined user roles

network-admin

Parameters

group-id: Specifies a protocol group by its ID in the range of 1 to 96. For available protocol groups, see the display portcar command output.

rate: Specifies the maximum number of packets that can be forwarded per second, in the range of 1 to 1100000.

Usage guidelines

To restore the default protocol group rate limits on a card, restart the card.

Examples

# Set the rate limit to 200 pps for protocol group 3 on slot 3.

<Sysname> system-view

[Sysname] set portcar 3 200 slot 3

Related commands

display portcar

shutdown

Use shutdown to shut down an Ethernet interface or subinterface.

Use undo shutdown to bring up an Ethernet interface or subinterface.

Syntax

shutdown

undo shutdown

Default

An Ethernet interface or subinterface is up.

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

Usage guidelines

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 GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] shutdown

[Sysname-GigabitEthernet3/1/1] undo shutdown

# Shut down and then bring up GigabitEthernet 3/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.1] shutdown

[Sysname-GigabitEthernet3/1/1.1] undo shutdown

snmp-agent trap enable ifmonitor

Use snmp-agent trap enable ifmonitor to enable interface alarm functions.

Use undo snmp-agent trap enable ifmonitor to disable interface alarm functions.

Syntax

Default

Interface alarm functions are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

crc-error: Enables the CRC error packet alarm function for interfaces.

input-error: Enables the input error packet alarm function for interfaces.

input-usage: Enables the input bandwidth usage alarm function for interfaces.

output-error: Enables the output error packet alarm function for interfaces.

output-usage: Enables the output bandwidth usage alarm function for interfaces.

rx-pause: Enables the received pause frame alarm function for interfaces.

sdh-b1-error: Enables the SDH-B1 error packet alarm function for interfaces.

sdh-b2-error: Enables the SDH-B2 error packet alarm function for interfaces.

sdh-error: Enables the SDH error packet alarm function for interfaces.

tx-pause: Enables the sent pause frame alarm function for interfaces.

Examples

# Enable the CRC error packet alarm function for interfaces.

<Sysname> system-view

[Sysname] snmp-agent trap enable ifmonitor crc-error

speed

Use speed to set the speed of an Ethernet interface.

Use undo speed to restore the default.

Syntax

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

undo speed

Default

A GE interface negotiates a speed with its peer, and a 10-GE, 40-GE, or 100-GE interface operates at its highest speed.

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.

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.

For a fiber port, use the speed command to set its speed to match the rate of a transceiver module.

Support of an interface for the keywords depends on the interface type. For more information, use the speed ? command in interface view,

40-GE and 100-GE interfaces can operate only at their highest speed.

Examples

# Configure GigabitEthernet 3/1/1 to autonegotiate the speed.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] speed auto

using gigabit

Use using gigabit to change a 10-GE interface to a GE interface.

Syntax

using gigabit

Default

A 10-GE interface is not changed to a GE interface.

Views

10-GE interface view

Predefined user roles

network-admin

Usage guidelines

Change a 10-GE interface to a GE interface when either of the following conditions exists:

· The peer is a GE interface.

· No 10-GE transceiver module is available, and GE transceiver modules are available.

Only the following interfaces support this command:

· All interfaces on the MIC-XP20L, MIC-XP2L, MIC-XP2L-LAN, and MIC-XP4L1 subcards.

· The last four interfaces on a MIC-XP5L or MIC-XP5L1 subcard.

When you execute this command on an interface, this command changes two interfaces in the same group. For more information, see the command prompt. When a group contains an aggregation group member port, this command is not supported.

Examples

# Change Ten-GigabitEthernet 3/1/1 and Ten-GigabitEthernet 3/1/2 to GE interfaces.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] using gigabit

The interface Ten-GigabitEthernet3/1/1 and Ten-GigabitEthernet3/1/2 will be deleted. Continue? [Y/N]:y

Related commands

using tengige

Use using tengige to restore a GE interface changed from a 10-GE interface back to a 10-GE interface.

Syntax

using tengige

Default

GE interface changed from a 10-GE interface is not restored back to a 10-GE interface.

Views

GE interface view

Predefined user roles

network-admin

Usage guidelines

Only the following interfaces support this command:

· All interfaces on the MIC-XP20L, MIC-XP2L, MIC-XP2L-LAN, and MIC-XP4L1 subcards.

· The last four interfaces on a MIC-XP5L or MIC-XP5L1 subcard.

If you need higher bandwidth, you can restore a GE interface that was changed from a 10-GE interface to a 10-GE interface.

Examples

# Restore GigabitEthernet 3/1/1 and GigabitEthernet 3/1/2 to 10-GE interfaces.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] using tengige

The interface GigabitEthernet3/1/1 and GigabitEthernet3/1/2 will be deleted. Continue? [Y/N]:y

Related commands

using gigabit

Layer 2 Ethernet interface commands

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. Interfaces on PIC interface subcards in a SPEX-1204 card do not support this option.

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.

The configured suppression threshold value in pps or kbps might be converted into a multiple of a step supported by the chip. As a result, the effective suppression threshold might be different from the configured one. To determine the suppression threshold that takes effect, see the prompts on the device.

Examples

# Set the broadcast suppression threshold to 10000 kbps on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] broadcast-suppression kbps 10000

The actual value is 10048 on port GigabitEthernet3/1/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

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

Only SPC and MPE-1104 cards support this command.

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 - unicast

FW - forwarding

Flow Statistic Interval: 5 (in seconds)

Port Type Lower Upper Unit CtrlMode Status Trap Log StateChanges

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

GE3/1/1 MC 100 200 kbps shutdown shutdown off on 10

Table 9 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.
CtrlMode	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.
StateChanges	Number of forwarding state changes of the interface. When the StateChanges field reaches 65535, it resets automatically.

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 }

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.

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 configure both the storm-constrain multicast command and the multicast-suppression command on an interface.

Examples

# Set the multicast storm suppression threshold to 10000 kbps on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] multicast-suppression kbps 10000

The actual value is 10048 on port GigabitEthernet3/1/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

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 0 to 1.4881 × the interface bandwidth.

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

· If you specify the ratio keyword, the value range for the upperlimit argument is 0 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 0 to 1.4881 × the interface bandwidth.

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

· If you specify the ratio keyword, the value range for the lowerlimit argument is 0 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 GigabitEthernet 3/1/1 and set the upper and lower thresholds to 200 pps and 150 pps, respectively.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

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

# Enable broadcast storm control on GigabitEthernet 3/1/2, and set the upper and lower thresholds to 2000 kbps and 1500 kbps, respectively.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/2

[Sysname-GigabitEthernet3/1/2] storm-constrain broadcast kbps 2000 1500

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

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/3

[Sysname-GigabitEthernet3/1/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 GigabitEthernet 3/1/1 to block a specific type of traffic when the type of traffic exceeds the upper storm control threshold.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/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 GigabitEthernet 3/1/1 to output log messages when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/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 GigabitEthernet 3/1/1 to send traps when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/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

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.

Examples

# Set the unknown unicast storm suppression threshold to 10000 kbps on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] unicast-suppression kbps 10000

The actual value is 10048 on port GigabitEthernet3/1/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

Layer 3 Ethernet interface or subinterface commands

mac-address

Use mac-address to set the MAC address of an Ethernet interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

The MAC address of a Layer 3 Ethernet interface is allocated by the device.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a MAC address in the format of H-H-H.

Usage guidelines

You cannot set a MAC address for a subinterface. A subinterface uses the MAC address of the main interface. All subinterfaces of a main interface share the same MAC address.

Do not set a VRRP-reserved MAC address for a Layer 3 Ethernet interface.

If you execute this command on a main interface with a large number of subinterfaces, you might need to wait for a period of time. The main interface takes time to synchronize the set MAC address to all its subinterfaces.

Examples

# Set the MAC address of GigabitEthernet 3/1/1 to 0001-0001-0001.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] mac-address 1-1-1

mtu

Use mtu to set the MTU for an Ethernet interface or subinterface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of an Ethernet interface or subinterface is 1500 bytes.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

size: Sets the MTU in the range of 46 to 9100 bytes. The value range for this argument varies by card model.

· For interfaces on MIC interface subcards in a CSPEX-1104-E or SPEX-1204 card, the value range is 46 to 2980 bytes.

· For interfaces on PIC-PS2G4L or PIC-TCP8L subcards in a SPEX-1204 card, the value range is 46 to 2000 bytes.

· For interfaces on PIC-GP10L subcards in a SPEX-1204 card, the value range is 46 to 3000 bytes.

· For interfaces on other PIC subcards in a SPEX-1204 card, the value range is 46 to 9100 bytes.

· For interfaces on SPC and MPE-1104 cards, the value range is 46 to 9100 bytes.

Usage guidelines

A smaller MTU size results in more fragments. When you set the MTU for an interface, consider QoS queue lengths, for example, consider that the default FIFO queue length is 75. To prevent a too small MTU from causing packet drops in QoS queuing, you can perform one of the following configurations:

· Tune the MTU with the mtu command.

· Tune QoS queue lengths with the qos fifo queue-length command.

For more information about the qos fifo queue-length command, see ACL and QoS Command Reference.

An outgoing interface of packets cannot use its MTU to fragment packets if the incoming interface is on SPC or MPE-1104 cards.

The outgoing interface uses the MTU of 1280 bytes if its MTU is smaller than 1280 bytes and the incoming interface is on CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, or CEPC cards. As a best practice, set the MTU of the outgoing interface to a value greater than 1280 bytes when the device is installed with the cards mentioned above.

Examples

# Set the MTU to 1430 bytes for GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] mtu 1430

# Set the MTU to 1430 bytes for GigabitEthernet 3/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.1] mtu 1430

port-type switch

Use port-type switch to change the type of an interface.

Syntax

In standard POS interface view:

port-type switch gigabitethernet

In Layer 3 GigabitEthernet interface view:

port-type switch pos

Views

Standard POS interface view

Layer 3 GigabitEthernet interface view

Predefined user roles

network-admin

Parameters

gigabitethernet: Changes a standard POS interface to a Layer 3 GigabitEthernet interface.

pos: Changes a Layer 3 GigabitEthernet interface to a standard POS interface.

Usage guidelines

Only PIC-TCP8L subcards support this command.

This command removes the original interface, and then creates the target interface with the same number as the original interface.

The device enters the view of the new interface automatically after you execute this command.

Examples

# Change POS 2/2/1 to GigabitEthernet 2/2/1.

<Sysname> system-view

[Sysname] interface pos 2/2/1

[Sysname-Pos2/2/1] port-type switch gigabitethernet

Changing port type can result in loss of port configuration. Are you sure to continue? [Y/N]:y

[Sysname-GigabitEthernet2/2/1]

traffic-statistic enable

Use traffic-statistic enable to enable packet statistics collection for a Layer 3 Ethernet subinterface.

Use undo traffic-statistic enable to disable packet statistics collection for a Layer 3 Ethernet subinterface.

Syntax

traffic-statistic enable

undo traffic-statistic enable

Default

Packet statistics collection is disabled for a Layer 3 Ethernet subinterface.

Views

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Usage guidelines

Only CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, and CEPC cards support this command.

This command is resource intensive. The system becomes busy and the CPU usage increases when you enable this feature on a large number of Ethernet subinterfaces or set a shorter interval by using the flow-interval command.

You can use the display interface or display counters command to display the subinterface traffic statistics.

On a Layer 3 Ethernet subinterface, the command is mutually exclusive with the IPoE L2VPN-leased users. For more information about IPoE L2VPN-leased users, see IPoE configuration in BRAS Services Configuration Guide.

Examples

# Enable packet statistics collection for GigabitEthernet 3/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/1.1

[Sysname-GigabitEthernet3/1/1.1] traffic-statistic enable

Related commands

display counters

display interface

flow-interval

03-Interface Command Reference

flow-control receive enable

reset counters interface

broadcast-suppression

multicast-suppression

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