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 1/0/6 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] bandwidth 1000

# Set the expected bandwidth of GigabitEthernet 1/0/6.1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.1] bandwidth 1000

Related commands

speed

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 are mutually exclusive on an interface.

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

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 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] dampening

# Enable interface dampening on GigabitEthernet 1/0/6, 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 1/0/6

[Sysname-GigabitEthernet1/0/6] dampening 2 800 3000 5

Related commands

display interface

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 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] default

# Restore the default settings for GigabitEthernet 1/0/6.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.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, GigabitEthernet1/0/6 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 1/0/6 to lan-interface.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] description lan-interface

# Set the description of GigabitEthernet 1/0/6.1 to subinterface 1/0/6.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.1] description subinterface1/0/6.1

display counters

Use display counters to display interface traffic statistics.

Syntax

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

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. The value range for the subnumber argument is 1 to 4094.

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

Usage guidelines

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

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

If you specify an interface type but do not specify an interface number 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/subinterface.

Examples

# Display inbound traffic statistics for all GigabitEthernet interfaces.

<Sysname> display counters inbound interface gigabitethernet

Interface Total(pkt) Broadcast(pkt) Multicast(pkt) Err(pkt)

Description

GE1/0/6 100 100 0 0

GE1/0/7 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(pkt)	Total number of packets received or sent through the interface.
Broadcast(pkt)	Total number of broadcast packets received or sent through the interface.
Multicast(pkt)	Total number of multicast packets received or sent through the interface.
Err(pkt)	Total number of error packets received or sent through the interface.
Description	Description configured for the interface.
Overflow: More than 14 digits (7 digits for column "Err")	The command displays Overflow when any of the following conditions exist: · The data length of an Err field value is greater than 7 decimal digits. · The data length of a non-Err field value is greater than 14 decimal digits.
--: Not supported	The statistical item is not supported.

‌

Related commands

reset counters interface

display counters rate

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

Syntax

display counters rate [ inbound | outbound ] interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ description ]

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.

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

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 1/0/6.

<Sysname> display counters rate interface gigabitethernet 1/0/6

Usage: Bandwidth utilization in percentage

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

Description

GE1/0/6 0.01 1000 0.01 1000

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)

Description

GE1/0/6 0.03 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 within the most recent statistics polling interval. The formula for calculating the bandwidth usage of an interface is: local physical interface bandwidth/total bandwidth of all selected local interfaces.
Total(pps)	Average receiving or sending rate (in pps) for all packets within the most recent 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 0.01%, 0.01% 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 0.01%, 0.01% 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 within the most recent statistics polling interval.
Multicast(pps)	Average receiving or sending rate (in pps) for multicast packets within the most recent statistics polling interval.
Description	Description configured for the interface.
Overflow: more than 14 decimal digits	The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits.
--: not supported	The statistical item is not supported.

‌

Related commands

flow-interval

reset counters interface

display ethernet statistics

Use display ethernet statistics to display the Ethernet module statistics.

Syntax

display ethernet statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display the Ethernet module statistics.

<Sysname> display ethernet statistics

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.This field is not supported in the current software version.‌ · 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.This field is not supported in the current software version.‌ · FastOutNum—Number of packets fast forwarded. · L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.This field is not supported in the current software version.‌
ETH send error statistics	Statistics about the error Ethernet packets in the outbound direction on the Ethernet module: · MbufRelayNum—Number of packets transparently sent. · NullMbuf—Number of packets with null pointers. · ErrAdjFwd—Number of packets with adjacency table errors. · ErrPrepend—Number of packets with extension errors. · ErrHdrLen—Number of packets with header length errors. · ErrPad—Number of packets with padding errors. · ErrQoSTrs—Number of packets that failed to be sent by QoS. · ErrVLANTrs—Number of packets that failed to be sent in VLANs.This field is not supported in the current software version.‌‌ · 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.This field is not supported in the current software version.‌ · 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.

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 1/0/6.

<Sysname> display interface gigabitethernet 1/0/6

GigabitEthernet1/0/6

Interface index: 4354

Current state: UP

Line protocol state: UP

Description: GigabitEthernet1/0/6 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 address: 4.0.0.1/24 (Primary)

IP packet frame type: Ethernet II, hardware address: 542b-de14-0013

IPv6 packet frame type: Ethernet II, hardware address: 542b-de14-0013

Media type is optical fiber, port hardware type is 10G_BASE_SR_SFP

Vendor PN:210231A0A6N204000862

Vendor Name:H3C

Wavelength(nm):850,Transfer Distance(m):300

RX power: -177 dBm/100, Alarm thresholds:[99, -950]dBm/100

TX power: -262 dBm/100, Alarm thresholds:[0, -1030]dBm/100

Ethernet port mode: LAN

Port priority: 0

10Gbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10000

Last link flapping: 0 hours 32 minutes 32 seconds

Last clearing of counters: Never

Current system time:2020-08-04 18:04:05

Last time when physical state changed to up:2020-08-04 17:31:34

Last time when physical state changed to down:2020-08-04 17:30:47

Peak input rate: 25 bytes/sec, at 2020-08-04 16:28:14

Peak output rate: 25 bytes/sec, at 2020-08-04 16:28:14

Last 5 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec 0.00%

Last 5 seconds output: 0 packets/sec 0 bytes/sec 0 bits/sec 0.00%

Input (total): 33 packets, 2244 bytes

9 unicasts, 24 broadcasts, 0 multicasts, 0 pauses

Input (normal): 33 packets, - bytes

9 unicasts, 24 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): 32 packets, 2176 bytes

9 unicasts, 23 broadcasts, 0 multicasts, 0 pauses

Output (normal): 32 packets, - bytes

9 unicasts, 23 broadcasts, 0 multicasts, 0 pauses

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

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. · mac-address moving down—The interface has been shut down by the MAC address move suppression 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: ¡ LAGG—Shuts down the data link layer when it detects that the aggregate interface does not have Selected ports. ¡ BFD—Shuts down the data link layer when it detects a link failure.
Bandwidth	Expected bandwidth of the interface.
Maximum transmission unit	MTU of the interface.
Internet protocol processing	IP configuration parameter of the interface when the interface is not assigned an IP address: · Disabled—The interface cannot process IP packets. · Enabled—The interface can process IP packets.
Internet address: ip-address/mask-length (Type)	IP address of the interface and type of the address in parentheses. Possible IP address types include: · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. · DHCP-allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · Unnumbered—IP address borrowed from another interface.
IP packet frame type	IPv4 packet framing format.
hardware address	MAC address of the interface.
IPv6 packet frame type	IPv6 packet framing format.
FEC mode	FEC mode of the interface, which depends on the configuration. When the FEC mode of an interface is set to autonegotiation, the actual FEC mode depends on the model of the transceiver module installed in the fiber port.
Port priority	Port priority of the interface.
Loopback is set internal	An internal loopback test is running on the interface. This field depends on your configuration .
Loopback is set external	An external loopback test is running on the interface. This field depends on your configuration.
Loopback is not set	No loopback test is running on the interface. This field depends on your configuration.
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.
25Gbps-speed mode	The interface is operating at 25 Gbps. This field depends on your configuration and the link parameter negotiation result.
50Gbps-speed mode	The interface is operating at 50 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.
200Gbps-speed mode	The interface is operating at 200 Gbps. This field depends on your configuration and the link parameter negotiation result.
400Gbps-speed mode	The interface is operating at 400 Gbps. This field depends on your configuration and the link parameter negotiation result.
Unknown-speed mode	The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.
full-duplex mode	The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result.
unknown-duplex mode	The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.
Link speed type is autonegotiation	The interface is configured with the speed auto command.
Link speed type is force link	The interface is manually configured with a speed (for example, 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, full) by using the duplex command.
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-	This field is not supported in the current software version.‌Broadcast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Multicast max-	This field is not supported in the current software version.‌Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Unicast max-	This field is not supported in the current software version. ‌Unknown unicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
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 hardware down reason	Last hardware down reason of the interface: · The interface receives the remote fault from the peer device. · The interface receives the local fault from the peer device. · The interface auto-negotiation process is not completed. · The PHY layer state of the interface changes to down. · The MAC layer state of the interface changes to down. · Electrical signal loss on the receiving side of the interface. · Optical signal loss on the receiving side of the interface. · The transceiver module transmission function of the interface is disabled. · The physical layer of the interface is disabled. · The interface is manually shut down. · The transceiver module is absent. · SDH loss of signal alarm occurred. · SDH loss of frame alarm occurred. · SDH multiplex section indication alarm occurred. · SDH signal fault bit error rate threshold alarm occurred. · SDH signal degrade bit error rate threshold alarm occurred. · SDH multiplex section remote defect indication alarm occurred. · SDH indication signal of branch unit alarm occurred. · SDH branch unit pointer loss alarm occurred. · The subcard is absent. · The subcard is not initialized. · Rx loss of signal occurred on the transceiver module. · Remote loopback. · Transceiver module is not ready. · Invalid interface configuration. · Interface physical exception. · Interface MAC exception. · Interface transceiver module exception. · MAC down because the remote interface is faulty.
Last clearing of counters	Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup.
Current system time	Current system time in the YYYY/MM/DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS 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 seconds input: 0 packets/sec 0 bytes/sec 0% Last interval seconds output: 0 packets/sec 0 bytes/sec 0%	Average inbound or outbound traffic rate (in pps and Bps) in the last statistics polling interval, and the ratio of the actual rate to the interface bandwidth. To set the statistics polling interval, execute the flow-interval command. A hyphen (-) indicates that the statistical item is not supported.
Traffic statistic	Whether to include interframe gap and preamble statistics in the traffic statistics: · Include Inter-frame Gaps and Preambles · Not include Inter-frame Gaps and Preambles
Input(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of inbound unicast packets. · Number of inbound broadcasts. · Number of inbound multicasts. · Number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Input(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of inbound normal unicast packets. · Number of inbound normal broadcasts. · Number of inbound normal multicasts. · Number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
input errors	Statistics of incoming error packets.
runts	Number of inbound frames meeting the following conditions: · Shorter than 64 bytes. · In correct format. · Containing valid CRCs.
giants	Number of inbound or outbound 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, 0 pauses	The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of outbound unicast packets. · Number of outbound broadcasts. · Number of outbound multicasts. · Number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Output(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of outbound normal unicast packets. · Number of outbound normal broadcasts. · Number of outbound normal multicasts. · Number of outbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
output errors	Number of outbound packets with errors.
underruns	Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.
buffer failures	Number of packets dropped because the transmitting buffer of the interface ran low.
aborts	Number of packets that failed to be transmitted, for example, because of Ethernet collisions.
deferred	Number of frames that the interface deferred to transmit because of detected collisions.
collisions	Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.
late collisions	Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.
lost carrier	This field is not supported in the current software version.Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.
no carrier	This field is not supported in the current software version.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.
IPv4 traffic statistics	IPv4 packet statistics.
IPv6 traffic statistics	IPv6 packet statistics.
Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec	Average inbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported.
Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec	Average outbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported.
Input: 0 packets, 0 bytes	Inbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported.
Output: 0 packets, 0 bytes	Outbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported.

‌

# Display brief information about all interfaces.

<Sysname> display interface brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) – spoofing

Interface Link Protocol Primary IP Description

GE1/0/6 DOWN DOWN --

Loop0 UP UP(s) 2.2.2.9

NULL0 UP UP(s) --

# 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

GE1/0/6 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.
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. This field is not supported in the current software version.
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. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

‌

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 [ interface-type [ interface-number | interface-number.subnumber ] ] link-info [ down | up ] [ description ] [ main ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

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

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

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

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

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

Examples

# Display brief information such as status and statistics of all interfaces.

<Sysname> display interface link-info

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Pro InUsage OutUsage InErrs OutErrs Description

GE1/0/6 UP UP 0.05% 0.05% 3000 3000

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

BAGG11 ADM DOWN -- -- -- --

GE1/0/7 DOWN DOWN -- -- -- --

RAGG11 ADM DOWN -- -- -- --

GE1/0/8 DOWN DOWN -- -- -- --

Overflow: More than 7 digits.

--: Not supported.

# Display detailed information such as status and statistics of all interfaces.

<Sysname> display interface link-info verbose

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Pro InUsage OutUsage InTotal(pps) Ou

tTotal(pps) InTotal(pkt) OutTotal(pkt) InErrs OutErrs Description

GE1/0/7 DOWN DOWN -- -- -- --

-- -- -- --

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.
Pro	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.
InTotal(pps)	Average receiving rate (in pps) for all packets within the most recent statistics polling interval.
OutTotal(pps)	Average sending rate (in pps) for all packets within the most recent statistics polling interval.
InTotal(pkt)	Total number of received packets.
OutTotal(pkt)	Total number of sent packets.
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 for all interfaces except subinterfaces.

<Sysname> display interface main

GigabitEthernet1/0/6

Interface index: 4353

Current state: DOWN

Line protocol state: DOWN

Description: GigabitEthernet1/0/6 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: 78aa-8212-301b

IPv6 packet frame type: Ethernet II, hardware address: 78aa-8212-301b

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

Port priority: 0

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10000

Last link flapping: Never

Last clearing of counters: Never

Current system time:2021-04-26 09:09:20 bj+08:00:00

Last time when physical state changed to up:-

Last time when physical state changed to down:2021-04-25 10:55:13 bj+08:00:00

Peak input rate: 0 bytes/sec, at 2021-04-25 10:55:17 bj+08:00:00

Peak output rate: 0 bytes/sec, at 2021-04-25 10:55:17 bj+08:00:00

Last 5 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec -%

Last 5 seconds output: 0 packets/sec 0 bytes/sec 0 bits/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, 0 buffer failures

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

0 lost carrier, - no carrier

IPv4 traffic statistics:

Last 5 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 5 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

IPv6 traffic statistics:

Last 5 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 5 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

GigabitEthernet1/0/7

Interface index: 4359

Current state: DOWN

Line protocol state: DOWN

Description: GigabitEthernet1/0/7 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: 78aa-8212-301c

IPv6 packet frame type: Ethernet II, hardware address: 78aa-8212-301c

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

Port priority: 0

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10000

Last link flapping: Never

Last clearing of counters: Never

Current system time:2021-04-26 09:09:20 bj+08:00:00

Last time when physical state changed to up:-

Last time when physical state changed to down:2021-04-25 10:55:13 bj+08:00:00

Peak input rate: 0 bytes/sec, at 2021-04-25 10:55:17 bj+08:00:00

Peak output rate: 0 bytes/sec, at 2021-04-25 10:55:17 bj+08:00:00

Last 5 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec -%

Last 5 seconds output: 0 packets/sec 0 bytes/sec 0 bits/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, 0 buffer failures

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

0 lost carrier, - no carrier

IPv4 traffic statistics:

Last 5 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 5 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

IPv6 traffic statistics:

Last 5 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 5 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

# 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

GE1/0/6 DOWN DOWN --

Loop0 UP UP(s) 2.2.2.9

NULL0 UP UP(s) --

# Display information about interfaces (except subinterfaces) 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

GE1/0/6 DOWN Not connected

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

display interface phy-option

Use display interface phy-option to display the physical attributes of an interface.

Syntax

display interface [ interface-type [ interface-number ] ] phy-option

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command displays the physical attributes of all interfaces.

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

Examples

# Display the physical attributes of Layer 3 Ethernet interface GigabitEthernet 1/0/6.

<Sysname> display interface gigabitethernet 1/0/6 phy-option

GigabitEthernet1/0/6

Interface index: 49

Current state: UP

Flow-control is not enabled

Media type is optical fiber, port hardware type is 1000_BASE_LX_SFP

Vendor PN:210231A1RQN216001N0G

Vendor Name:H3C

Wavelength(nm):1310,Transfer Distance(m):10000

RX power: -714 dBm/100, Alarm thresholds:[-299, -1899]dBm/100

TX power: -592 dBm/100, Alarm thresholds:[-100, -1100]dBm/100

1000Mbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

The maximum frame length is 10000

Table 7 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. · mac-address moving down—The interface has been shut down by the MAC address move suppression feature. · UP—The interface is both administratively and physically up.
Media type is	Media type of the interface.
Loopback is set internal	An internal loopback test is running on the interface. This field depends on your configuration.
Loopback is set external	An external loopback test is running on the interface. This field depends on your configuration.
Loopback is not set	No loopback test is running on the interface. This field depends on your configuration.
1000Mbps-speed mode	The interface is operating at 1000 Mbps. This field depends on your configuration and the link parameter negotiation result.
10Gbps-speed mode	The interface is operating at 10 Gbps. This field depends on your configuration and the link parameter negotiation result.
25Gbps-speed mode	The interface is operating at 25 Gbps. This field depends on your configuration and the link parameter negotiation result.
50Gbps-speed mode	The interface is operating at 50 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.
400Gbps-speed mode	The interface is operating at 400 Gbps. This field depends on your configuration and the link parameter negotiation result.
Unknown-speed mode	The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.
full-duplex mode	The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result.
unknown-duplex mode	The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.
Link speed type is autonegotiation	The interface is configured with the speed auto command.
Link speed type is force link	The interface is manually configured with a speed (for example, 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.
Maximum frame length	Maximum length of Ethernet frames allowed to pass through the interface.
Transceiver information	Transceiver module information.
Transceiver Type	Physical model of the transceiver module.
Wavelength(nm)	Central wavelength (in nm) of the transmit laser. If the transceiver module supports multiple wavelengths, every two wavelength values are separated by a comma. For a copper cable, this field displays N/A.
Transfer Distance(xx)	Transmission distance, where xx indicates the distance unit: · km—Kilometers, for single-mode transceiver modules. · m—Meters, for other transceiver modules. If the transceiver module supports multiple types of transmission media, this field displays the transmission distance for each type, in the form of transmission distance (medium type). Transmission medium types include: · 9 um—9/125 µm single-mode fiber. · 50 um—50/125 µm multimode fiber. · 62.5 um—62.5/125 µm multimode fiber. · TP—Twisted pair. · CX4—CX4 cable.
Digital Diagnostic Monitoring	Support for digital diagnostic monitoring: · YES. · NO.
Vendor Name	Manufacturer or custom vendor of the transceiver module.
RX power(dBm/100)	Rx power in dBm/100.
TX power(dBm/100)	Tx power in dBm/100.
Alarm thresholds	Alarm thresholds for the Rx or Tx power.

‌

Related commands

display interface

display transceiver interface (Fundamentals Command Reference)

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 ] ] [ verbose ] | summary }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

Table 8 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 rate-limit	Packets that are dropped due to the rate limit set on the device.
Packets dropped due to Tx packet aging	Outbound packets that are timed out.
Slot	Slot number.
Total	Statistics about dropped packets.

‌

display this interface

Use display this interface to display the operating status and information of an interface.

Syntax

display this interface

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

In interface view, to quickly view the operating status or packet statistics of the interface, execute this command.

For an interface, the output from the display this interface command in interface view is the same as the output from the display interface interface-type interface-number command in any view.

Related commands

display interface

duplex

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

Use undo duplex to restore the default.

Syntax

duplex { auto | full }

undo duplex

Default

Ethernet interfaces autonegotiate the duplex 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.

Usage guidelines

If you install a GE transceiver module on a 25G or 10G Ethernet fiber port, the autonegotiation for the duplex mode or speed is not supported. To connect the local device to the peer device, perform the following operations:

· Use the duplex full command to set the duplex mode to full for the peer device.

· Use the speed command to set a fixed interface speed for the peer device. For example, you can set the interface speed to 1000 Mbps by executing the speed 1000 command.

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] duplex full

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

Predefined user roles

network-admin

Parameters

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

Usage guidelines

The statistics polling interval configured in system view takes effect on all interfaces.

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 seconds input and Last interval seconds output fields in the display interface command output.

Examples

# Set the statistics polling interval to 100 seconds.

<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

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

undo ifmonitor crc-error

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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets crosses the upper threshold on the interface.

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 crosses the upper threshold, the interface generates an upper threshold crossing 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.

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

Examples

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

<Sysname> system-view

[Sysname] ifmonitor crc-error slot 1 high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor input-buffer-drop

Use ifmonitor input-buffer-drop to configure packet-drop alarm parameters for the ingress buffer globally.

Use undo ifmonitor input-buffer-drop to restore the default.

Syntax

ifmonitor input-buffer-drop high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-buffer-drop

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

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

shutdown: Shuts down an interface when the number of dropped packets in the ingress buffer crosses the upper threshold on that interface. 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 crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the ingress buffer crosses the upper threshold on the interface.

Usage guidelines

With this feature configured, when the number of dropped packets in the ingress buffer on an interface crosses the upper threshold within the specified interval, the interface generates an alarm and enters alarm state. When the number of dropped packets on that interface drops below the lower threshold within the specified interval, the interface generates an alarm and restores to normal state.

You can configure packet-drop alarm parameters for the ingress buffer 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.

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

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for ingress buffer packet-drop alarms.

<Sysname> system-view

[Sysname] ifmonitor input-buffer-drop slot 1 high-threshold 5000 low-threshold 400 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

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

undo ifmonitor input-error

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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of input error packets crosses the upper threshold on the interface.

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 crosses the upper threshold, the interface generates an upper threshold crossing 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.

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

Examples

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

<Sysname> system-view

[Sysname] ifmonitor input-error slot 1 high-threshold 5000 low-threshold 400 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

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

undo ifmonitor input-usage

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.

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 crosses the upper threshold, the interface generates an upper threshold crossing 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.

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

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.

If you execute 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 slot 1 high-threshold 95 low-threshold 80

Related commands

flow-interval

snmp-agent trap enable ifmonitor

ifmonitor output-buffer-drop

Use ifmonitor output-buffer-drop to configure packet-drop alarm parameters for the egress buffer globally.

Use undo ifmonitor output-buffer-drop to restore the default.

Syntax

ifmonitor output-buffer-drop high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-buffer-drop

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the egress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the egress buffer, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds. The value range for this parameter depends on the device model.

shutdown: Shuts down an interface when the number of dropped packets in the egress buffer crosses the upper threshold on that interface. 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 crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the egress buffer crosses the upper threshold on the interface.

Usage guidelines

With the egress buffer packet-drop alarm function enabled, when the number of egress buffer packet-drops on an interface in normal state within the specified interval crosses the upper threshold, the interface generates an upper threshold crossing alarm and enters the alarm state. When the number of packet-drops 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 packet-drop alarm parameters for the egress buffer 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.

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

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for egress buffer packet-drop alarms.

<Sysname> system-view

[Sysname] ifmonitor output-buffer-drop slot 1 high-threshold 5000 low-threshold 400 interval 6

Related commands

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

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

undo ifmonitor output-error

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. The value range for this parameter depends on the device model.

shutdown: Shuts down an interface when the number of output error packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of output error packets crosses the upper threshold on the interface.

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 crosses the upper threshold, the interface generates an upper threshold crossing 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.

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

Examples

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

<Sysname> system-view

[Sysname] ifmonitor output-error slot 1 high-threshold 5000 low-threshold 400 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

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

undo ifmonitor output-usage

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.

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 crosses the upper threshold, the interface generates an upper threshold crossing 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.

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

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.

If you execute 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 slot 1 high-threshold 80 low-threshold 60

Related commands

flow-interval

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.

Examples

# Enter the view of GigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6]

# Create Ethernet subinterface GigabitEthernet 1/0/6.1 and enter its view.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.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 10000 bytes to pass through.

Views

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. The value range for this argument is 1536 to 10000.

Usage guidelines

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

Examples

# Allow jumbo frames to pass through GigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] jumboframe enable

link-delay

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

Use undo link-delay to restore the default.

Syntax

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

undo link-delay { down | up }

Default

An interface immediately reports its physical state changes to the CPU.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

down: Suppresses link-down events.

up: Suppresses link-up events.

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

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

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

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

Usage guidelines

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

When you configure this feature, follow these guidelines:

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

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

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

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

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

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

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] link-delay down 8

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] link-delay up msec 800

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

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 and loopback commands are mutually exclusive.

Examples

# Enable internal loopback testing on GigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] loopback internal

port auto-power-down

Use port auto-power-down to enable auto power-down on an Ethernet interface.

Use undo port auto-power-down to disable auto power-down on an Ethernet interface.

Syntax

port auto-power-down

undo port auto-power-down

Default

Auto power-down is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

When an interface with auto power-down enabled has been down for a specific period of time, both of the following events occur:

· The device automatically stops supplying power to the interface.

· The interface enters the power save mode.

The time period depends on the chip specifications and is not configurable.

When the interface comes up, both of the following events occur:

· The device automatically restores the power supply to the interface.

· The interface restores to its normal state.

Examples

# Enable auto power-down on GigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port auto-power-down

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. The value range for this parameter depends on the device model.

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.

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

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor crc-error high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-buffer-drop

Use ifmonitor input-buffer-drop to configure packet-drop alarm parameters for the ingress buffer on an interface.

Use undo port ifmonitor input-buffer-drop to restore the default.

Syntax

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

undo port ifmonitor input-buffer-drop

Default

An interface uses the packet-drop alarm parameters globally configured for the ingress buffer.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds. The value range for this parameter depends on the device model.

Usage guidelines

You can configure packet-drop alarm parameters for the ingress buffer 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.

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

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for ingress buffer packet-drop alarms on GigabitEthernet1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor input-buffer-drop high-threshold 5000 low-threshold 400 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. The value range for this parameter depends on the device model.

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.

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

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor input-error high-threshold 5000 low-threshold 400 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

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

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.

If you execute 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 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor input-usage high-threshold 80 low-threshold 60

Related commands

flow-interval

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

CAUTION:

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

Interfaces operate differently depending on the hardware structure of interface cards. For a device:

· Some Ethernet interfaces can operate only as Layer 2 Ethernet interfaces (in bridge mode).

· Some Ethernet interfaces can operate only as Layer 3 Ethernet interfaces (in route mode).

· Some Ethernet interfaces can operate either as Layer 2 or Layer 3 Ethernet interfaces. You can use this command to set the link mode to bridge or route for these Ethernet interfaces.

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port link-mode bridge

The configuration of the interface will be restored to the default. Continue? [Y/N]:y

port ifmonitor output-buffer-drop

Use port ifmonitor output-buffer-drop to configure packet-drop alarm parameters for the egress buffer.

Use undo port ifmonitor output-buffer-drop to restore the default.

Syntax

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

undo port ifmonitor output-buffer-drop

Default

An interface uses the packet-drop alarm parameters globally configured for the egress buffer.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

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

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

interval interval: Specifies the statistics collection and comparison interval for egress buffer packet-drop, in the range of 1 to 65535 seconds. The value range for this parameter depends on the device model.

Usage guidelines

With this feature configured, when the number of dropped packets in the egress buffer on an interface crosses the upper threshold within the specified interval, the interface generates an alarm and enters alarm state. When the number of dropped packets on that interface drops below the lower threshold within the specified interval, the interface generates an alarm and restores to normal state.

You can configure packet-drop alarm parameters for the egress buffer 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.

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

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for egress buffer packet-drop alarms on GigabitEthernet1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor output-buffer-drop high-threshold 5000 low-threshold 400 interval 6

Related commands

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.

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.

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

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor output-error high-threshold 5000 low-threshold 400 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

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

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.

If you execute 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 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] port ifmonitor output-usage high-threshold 9 low-threshold 7

Related commands

flow-interval

snmp-agent trap enable ifmonitor

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.

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 1/0/6.

<Sysname> reset counters interface gigabitethernet 1/0/6

Related commands

display counters interface

display counters rate interface

display interface

reset counters mib interface

Use reset counters interface to clear the interface statistics on MIB.

Syntax

reset counters mib 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.

Usage guidelines

Use this command to clear history statistics on MIB 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 on MIB.

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

Examples

# Clear the statistics on MIB for GigabitEthernet 1/0/6.

<Sysname> reset counters interface gigabitethernet 1/0/6

reset ethernet statistics

Use reset ethernet statistics to clear the Ethernet module statistics.

Syntax

reset ethernet statistics

Views

User view

Predefined user roles

network-admin

Parameters

Examples

# Clear the Ethernet module statistics.

<Sysname> reset ethernet statistics

Related commands

display ethernet statistics

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

CAUTION:

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

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

The shutdown and loopback commands are mutually exclusive.

Examples

# Shut down and then bring up GigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] shutdown

[Sysname-GigabitEthernet1/0/6] undo shutdown

# Shut down and then bring up GigabitEthernet 1/0/6.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.1] shutdown

[Sysname-GigabitEthernet1/0/6.1] undo shutdown

shutdown all-physical-interface

Use shutdown all-physical-interfaces to shut down all physical interfaces.

Use undo shutdown all-physical-interfaces to bring up all physical interfaces.

Syntax

shutdown all-physical-interfaces

undo shutdown all-physical-interfaces

Default

The shutdown all-physical-interfaces command is not executed.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

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

To bring up a shutdown interface, execute the undo shutdown all-physical-interfaces command in system view and execute the undo shutdown command in interface view.

Examples

# Shut down all physical interfaces.

<Sysname> system-view

[Sysname] shutdown all-physical-interfaces

Related commands

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-buffer-drop: Enables the packet-drop alarm function for the ingress buffer.

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

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

output-buffer-drop: Enables the packet-drop alarm function for the egress buffer.

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

output-usage: Enables the output bandwidth usage 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 { 100 | 1000 | 10000 | 25000 | 50000 | 100000 | auto }

undo speed

Default

The speed of an Ethernet interface is autonegotiated.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

100: Sets the interface speed to 100 Mbps.

1000: Sets the interface speed to 1000 Mbps.

10000: Sets the interface speed to 10000 Mbps.

25000: Sets the interface speed to 25000 Mbps.

50000: Sets the interface speed to 50000 Mbps.

100000: Sets the interface speed to 100000 Mbps.

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

Usage guidelines

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

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

Additionally, you must select a speed for a fiber port according to the transceiver module installed to ensure that the transceiver module can be used properly. If the transceiver module installed in a fiber port does not support the speed for the fiber port, the transceiver module cannot be used. For example, the transceiver module cannot be used if either of the following conditions exists:

· The transceiver module installed in an SFP+ fiber port is an SFP GE transceiver module and the speed 10000 command is executed on the fiber port.

· The transceiver module installed in an SFP+ fiber port is a 10-GE transceiver module and the speed 1000 command is executed on the fiber port.

· Use the duplex full command to set the duplex mode to full for the peer device.

· Use the speed command to set a fixed interface speed for the peer device. For example, you can set the interface speed to 1000 Mbps by executing the speed 1000 command.

Examples

# Configure GigabitEthernet 1/0/6 to autonegotiate the speed.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] speed auto

Related commands

speed auto

traffic-statistic include-interframe

Use traffic-statistic include-interframe to enable interframe gap and preamble statistics in the traffic statistics.

Use traffic-statistic include-interframe to restore the default.

Syntax

traffic-statistic include-interframe

undo traffic-statistic include-interframe

Default

The interframe gap and preamble statistics are enabled in the traffic statistics.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

If you execute the display interface command, the Last 300 seconds input rate or Last 300 seconds output rate field in the command output displays the average outbound or inbound traffic rate in the last 300 seconds.

By default, traffic rate = native frame length × packet count per second. Execute the traffic-statistic include-interframe command if you need the total traffic statistics, including the native frame length, interframe gap length, and preamble length, for a specific time period. With this command executed, traffic rate = (native frame length + interframe gap length + preamble length) × packet throughput per second.

Examples

# Enable interframe gap and preamble statistics in the traffic statistics forGigabitEthernet 1/0/6.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] traffic-statistic include-interframe

Traffic statistic will be set to include Inter-frame Gaps and Preambles. Continue? [Y/N]:y

Related commands

display interface

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

No MAC address is set for an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] 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 [ spread ]

undo mtu [ spread ]

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 9600 bytes.

spread: Batch modifies the MTU for the subinterfaces of a main interface. Subinterfaces do not support this keyword.

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.

The mtu size command executed in main interface view takes effect only on the main interface. The mtu size command executed in subinterface view takes effect only on the subinterface.

The mtu size spread command executed in main interface view can modify the MTU for both the main interface and its subinterfaces. However, the MTU separately configured for a subinterface takes priority.

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] mtu 1430

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.1] mtu 1430

# Set the MTU to 1430 bytes for GigabitEthernet 1/0/6 and its subinterfaces.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6

[Sysname-GigabitEthernet1/0/6] mtu 1430 spread

This operation may take a long time to modify the MTU of subinterfaces on this interface. Continue? [Y/N]:y

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

The default setting for this command varies by device model.

Views

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Usage guidelines

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.

Examples

# Enable packet statistics collection for GigabitEthernet 1/0/6.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/6.1

[Sysname-GigabitEthernet1/0/6.1] traffic-statistic enable

Related commands

display counters

display interface

flow-interval

02-Interface Command Reference

display interface phy-option

flow-interval

ifmonitor input-buffer-drop

port ifmonitor input-buffer-drop

reset counters interface

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