Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-Ethernet interface commands | 240.96 KB |
Ethernet interface commands
Common Ethernet interface commands
bandwidth
Use bandwidth to set the expected bandwidth of an interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
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 Ten-GigabitEthernet 1/0/1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] bandwidth 1000
Related commands
speed
broadcast-suppression
Use broadcast-suppression to enable broadcast suppression and set the broadcast suppression threshold.
Use undo broadcast-suppression to disable broadcast suppression.
Syntax
broadcast-suppression { ratio | pps max-pps | kbps max-kbps }
undo broadcast-suppression
Default
Ethernet interfaces do not suppress broadcast traffic.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
ratio: Sets the broadcast suppression threshold as a percentage of the interface bandwidth. The value range for this argument is 0 to 100. A smaller value means that less broadcast traffic is allowed to pass through.
pps max-pps: Specifies the maximum number of broadcast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.
kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.
Usage guidelines
The broadcast storm suppression features limits the size of broadcast traffic to a threshold on an interface. When the broadcast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.
Examples
# Set the broadcast suppression threshold to 10000 kbps on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] broadcast-suppression kbps 10000
Related commands
multicast-suppression
dampening
Use dampening to enable the device to dampen an interface when the interface is flapping.
Use undo dampening to restore the default.
Syntax
dampening [ half-life reuse suppress max-suppress-time ]
undo dampening
Default
Interface dampening is disabled on Ethernet interfaces.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to 120 seconds. The default value is 54 seconds.
reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The reuse threshold must be less than the suppression threshold.
suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is 2000.
max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).
Usage guidelines
When configuring the dampening command, follow these rules to set the values mentioned above:
· The ceiling is equal to 2 (Max-suppress-time/Decay) × reuse-limits. It is not user configurable.
· The configured suppress limit is lower than or equal to the ceiling.
· The ceiling is lower than or equal to the maximum suppress limit supported.
This command does not take effect on the administratively down events. When you execute the shutdown command, the penalty restores to 0, and the interface reports the down event to the higher layer protocols.
Do not enable the dampening function on an interface with spanning tree protocols enabled.
After an interface in down state is dampened, the interface state displayed through the display interface command, MIB, or Web is always down.
Examples
# Enable interface dampening on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] dampening
# Enable interface dampening on Ten-GigabitEthernet 1/0/1, and set the following parameters:
· Half life time to 2 seconds.
· Reuse value to 800.
· Suppression threshold to 3000.
· Maximum suppression interval to 5 seconds.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] 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
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 Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] default
This command will restore the default settings. Continue? [Y/N]:y
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, Ten-GigabitEthernet1/0/1 Interface).
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Set the description of Ten-GigabitEthernet 1/0/1 to lan-interface.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] description lan-interface
display counters
Use display counters to display interface traffic statistics.
Syntax
display counters { inbound | outbound } interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Displays inbound traffic statistics.
outbound: Displays outbound traffic statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
To clear the Ethernet interface traffic statistics, use the reset counters interface command.
If you do not specify an interface type, this command displays traffic statistics for all interfaces that have traffic counters.
If you specify an interface type but do not specify an interface number, this command displays traffic statistics for all interfaces of the specified type.
If you specify an interface type and number, this command displays traffic statistics for the specified interface.
Examples
# Display inbound traffic statistics for all interfaces.
<Sysname> display counters inbound interface
Interface Total (pkts) Broadcast (pkts) Multicast (pkts) Err (pkts)
GE1/0/2 0 0 0 0
XGE1/0/1 1988046 603465 1207457 0
Overflow: More than 14 digits (7 digits for column "Err").
--: Not supported.
Table 1 Command output
|
Field |
Description |
|
Interface |
Abbreviated interface name. |
|
Total (pkts) |
Total number of packets received or sent through the interface. |
|
Broadcast (pkts) |
Total number of broadcast packets received or sent through the interface. |
|
Multicast (pkts) |
Total number of multicast packets received or sent through the interface. |
|
Err (pkts) |
Total number of error packets received or sent through the interface. |
|
Overflow: More than 14 digits (7 digits for column "Err") |
The command displays Overflow when any of the following conditions exist: · The data length of an Err field value is greater than 7 decimal digits. · The data length of a non-Err field value is greater than 14 decimal digits. |
|
--: Not supported |
The statistical item is not supported. |
Related commands
reset counters interface
display counters rate
Use display counters rate to display traffic rate statistics for interfaces in up state for the most recent statistics polling interval.
Syntax
display counters rate { inbound | outbound } interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Displays inbound traffic rate statistics.
outbound: Displays outbound traffic rate statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
If you do not specify an interface type, this command displays traffic rate statistics for all up interfaces that have traffic counters.
If you specify an interface type but do not specify an interface number, this command displays traffic rate statistics for all up interfaces of the specified type.
If you specify an interface type and an interface, this command displays traffic rate statistics for the specified interface.
If an interface that you specify is always down for the most recent statistics polling interval, the system prompts that the interface does not support the command.
You can use the flow-interval command to set the statistics polling interval.
Examples
# Display the inbound traffic rate statistics for all interfaces.
<Sysname> display counters rate inbound interface
Usage: Bandwidth utilization in percentage
Interface Usage (%) Total (pps) Broadcast (pps) Multicast (pps)
XGE1/0/1 0 0 -- --
Overflow: More than 14 digits.
--: Not supported.
Table 2 Command output
|
Field |
Description |
|
Interface |
Abbreviated interface name. |
|
Usage (%) |
Bandwidth usage (in percentage) of the interface for the last statistics polling interval. The method for calculating the bandwidth usage of an interface varies by networking mode: · In a regular network, the formula for calculating the bandwidth usage of an interface is: local physical interface bandwidth/total bandwidth of all selected local interfaces. · In an M-LAG network, the formula for calculating the bandwidth usage of an interface is: local physical interface bandwidth/(total bandwidth of all selected local interfaces + total bandwidth of all selected remote interfaces). |
|
Total (pps) |
Average receiving or sending rate (in pps) for unicast packets for the last statistics polling interval. |
|
Broadcast (pps) |
Average receiving or sending rate (in pps) for broadcast packets for the last statistics polling interval. |
|
Multicast (pps) |
Average receiving or sending rate (in pps) for multicast packets for the last statistics polling interval. . |
|
Overflow: more than 14 decimal digits |
The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits. |
|
--: not supported |
The statistical item is not supported. |
Related commands
flow-interval
reset counters interface
display ethernet statistics
Use display ethernet statistics to display the Ethernet module statistics.
Syntax
display ethernet statistics
Views
Any view
Predefined user roles
network-admin
network-operator
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. · ISISNum—Number of packets encapsulated by using ISIS. This field is not supported in the current software version. · LLCNum—Number of packets encapsulated by using LLC. · UnknownNum—Number of packets encapsulated by using unknown methods. · ForwardNum—Number of packets forwarded at Layer 2 or sent to the CPU. · ARP—Number of ARP packets. · MPLS—Number of MPLS packets. This field is not supported in the current software version. · ISIS—Number of IS-IS packets.This field is not supported in the current software version. · ISIS2—Number of large 802.3/802.2 frames encapsulated by using IS-IS.This field is not supported in the current software version. · IP—Number of IP packets. · IPv6—Number of IPv6 packets. |
|
ETH receive error statistics |
Statistics about the error Ethernet packets in the inbound direction on the Ethernet module. Errors might be included in packets or occur during the receiving process. The items include: · NullPoint—Number of packets that include null pointers. · ErrIfindex—Number of packets that include incorrect interface indexes. · ErrIfcb—Number of packets that include incorrect interface control blocks. · IfShut—Number of packets that are being received when the interface is shut down. · ErrAnalyse—Number of packets that include packet parsing errors. · ErrSrcMAC—Number of packets that include incorrect source MAC addresses. · ErrHdrLen—Number of packets that include header length errors. |
|
ETH send packet statistics |
Statistics about the Ethernet packets sent by the Ethernet module: · L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces.This field is not supported in the current software version. · VLANOutNum—Number of packets sent out of VLAN interfaces. · FastOutNum—Number of packets fast forwarded. · L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces. |
|
ETH send error statistics |
Statistics about the error Ethernet packets in the outbound direction on the Ethernet module: · MbufRelayNum—Number of packets transparently sent. · NullMbuf—Number of packets with null pointers. · ErrAdjFwd—Number of packets with adjacency table errors. · ErrPrepend—Number of packets with extension errors. · ErrHdrLen—Number of packets with header length errors. · ErrPad—Number of packets with padding errors. · ErrQoSTrs—Number of packets that failed to be sent by QoS. · ErrVLANTrs—Number of packets that failed to be sent in VLANs. · ErrEncap—Number of packets that failed to be sent due to link header encapsulation failures. · ErrTagVLAN—Number of packets that failed to be sent due to VLAN tag encapsulation failures. · IfShut—Number of packets that are being sent when the interface is shut down. · IfErr—Number of packets with incorrect outgoing interfaces. |
Related commands
reset ethernet statistics
display interface
Use display interface to display interface information.
Syntax
display interface [ interface-type [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 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 except VA interfaces. For more information about VA interfaces, see PPP in Network Connectivity Configuration Guide.
If you specify an interface type but do not specify an interface number, this command displays information about all interfaces of the specified type.
Examples
# Display detailed information about Layer 2 interface Ten-GigabitEthernet 1/0/1.
<Sysname> display interface ten-gigabitethernet 1/0/1
Ten-GigabitEthernet1/0/1
Current state: DOWN
Line protocol state: DOWN
IP packet frame type: Ethernet II, hardware address: 000c-2963-b767
Description: Ten-GigabitEthernet1/0/1 Interface
Bandwidth: 100000 kbps
Loopback is not set
Media type is twisted pair, port hardware type is 1000_BASE_T_AN_SFP
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Flow-control is not enabled
Maximum frame length: 1600
Allow jumbo frame to pass
Broadcast max-ratio: 100%
Multicast max-ratio: 100%
Unicast max-ratio: 100%
PVID: 1
Port link-type: Access
Tagged VLANs: None
UnTagged VLANs: 1
Port priority: 2
Last link flapping: 6 hours 39 minutes 25 seconds
Last hardware down reason: PHY line side is down
Last clearing of counters: 14:34:09 Tue 11/01/2011
Current system time:2017-12-09 10:59:08
Last time when physical state changed to up:-
Last time when physical state changed to down:2017-12-09 10:59:07
Last 300 second input: 0 packets/sec 0 bytes/sec -%
Last 300 second output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
0 ignored, 0 parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, 0 buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, 0 no carrier
|
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. · STP DOWN—The interface has been shut down by the BPDU guard feature. · UP—The interface is both administratively and physically up. |
|
Line protocol state |
Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer. · UP—The data link layer protocol is up. · UP (spoofing)—The data link layer protocol is up, but the link is an on-demand link or does not exist. This attribute is typical of null interfaces and loopback interfaces. · DOWN—The data link layer protocol is down. · DOWN (protocols)—The data link layer has been shut down by protocols included in the parentheses. Available protocols include: ¡ LAGG—Shuts down the data link layer when it detects that the aggregate interface does not have Selected ports. |
|
The peer line protocol state is DOWN(Bit-error down) |
Bit errors occur on the peer interface, so the data link layer state of the interface is down. This field is displayed when the local interface receives bit error messages from the peer interface. |
|
Bandwidth |
Expected bandwidth of the interface. |
|
Maximum transmission unit |
MTU of the interface. |
|
Internet protocol processing: Disabled |
The interface is not assigned an IP address and cannot process IP packets. |
|
IP packet frame type |
IPv4 packet framing format. |
|
hardware address |
MAC address of the interface. |
|
Port priority |
Port priority of the interface. |
|
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. |
|
2.5Gbps-speed mode |
The interface is operating at 2.5 Gbps. This field depends on your configuration and the link parameter negotiation result. |
|
5Gbps-speed mode |
The interface is operating at 5 Gbps. This field depends on your configuration and the link parameter negotiation result. |
|
Unknown-speed mode |
The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected. |
|
half-duplex mode |
The interface is operating in half duplex mode. This field depends on your configuration and the link parameter negotiation result. |
|
full-duplex mode |
The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result. |
|
unknown-duplex mode |
The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected. |
|
Link speed type is autonegotiation |
The interface is configured with the speed auto command. |
|
Link speed type is force link |
The interface is manually configured with a speed (for example, 1000 Mbps) by using the speed command. |
|
link duplex type is autonegotiation |
The interface is configured with the duplex auto command. |
|
link duplex type is force link |
The interface is manually configured with a duplex mode (for example, half or full) by using the duplex command. |
|
Flow-control is not enabled |
Generic flow control is disabled on the interface. This field depends on your configuration and the link parameter negotiation result. |
|
Maximum frame length |
Maximum length of Ethernet frames allowed to pass through the interface. |
|
Allow jumbo frame to pass |
The interface allows jumbo frames to pass through. |
|
Broadcast max- |
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. |
|
PVID |
Port VLAN ID (PVID) of the interface. |
|
Port link-type |
Link type of the interface: · access. · trunk. · hybrid. |
|
Tagged VLANs |
VLANs for which the interface sends packets without removing VLAN tags. |
|
Untagged VLANs |
VLANs for which the interface sends packets after removing VLAN tags. |
|
VLAN Passing |
VLANs whose packets can be forwarded by the port. The VLANs must have been created. |
|
VLAN permitted |
VLANs whose packets are permitted by the port. |
|
Trunk port encapsulation |
Encapsulation protocol type for the trunk port. |
|
Last link flapping |
The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup. |
|
Last clearing of counters |
Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup. |
|
Current system time |
Current system time in the YYYY/MM/DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS 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 300 second input: 0 packets/sec 0 bytes/sec 0% Last 300 second output: 0 packets/sec 0 bytes/sec 0% |
Average inbound or outbound traffic rate (in pps and Bps) in the last 300 seconds, and the ratio of the actual rate to the interface bandwidth. A hyphen (-) indicates that the statistical item is not supported. |
|
Input(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of inbound unicast packets. · Number of inbound broadcasts. · Number of inbound multicasts. · Number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported. |
|
Input(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of inbound normal unicast packets. · Number of inbound normal broadcasts. · Number of inbound normal multicasts. · Number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported. |
|
input errors |
Statistics of incoming error packets. |
|
runts |
Number of inbound frames meeting the following conditions: · Shorter than 64 bytes. · In correct format. · Containing valid CRCs. |
|
giants |
Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface. For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1600 bytes. 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 1600 bytes. ¡ For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface. · Symbol error frames—Frames that contained a minimum of one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes). |
|
ignored |
Number of inbound frames dropped because the receiving buffer of the port ran low. |
|
parity errors |
Total number of frames with parity errors. |
|
Output(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of outbound unicast packets. · Number of outbound broadcasts. · Number of outbound multicasts. · Number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported. |
|
Output(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of outbound normal unicast packets. · Number of outbound normal broadcasts. · Number of outbound normal multicasts. · Number of outbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported. |
|
output errors |
Number of outbound packets with errors. |
|
underruns |
Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly. |
|
buffer failures |
Number of packets dropped because the transmitting buffer of the interface ran low. |
|
aborts |
Number of packets that failed to be transmitted, for example, because of Ethernet collisions. |
|
deferred |
Number of frames that the interface deferred to transmit because of detected collisions. |
|
collisions |
Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission. |
|
late collisions |
Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions. |
|
lost carrier |
Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces. |
|
no carrier |
Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces. |
# Display brief information about all interfaces.
<Sysname> display interface brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) – spoofing
Interface Link Protocol Primary IP Description
Loop0 UP UP(s) 2.2.2.9
NULL0 UP UP(s) --
Vlan1 UP UP --
Vlan999 UP UP 192.168.1.42
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) - auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
GE1/0/2 DOWN auto A A 1
GE1/0/3 UP 1G(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaa
# Display brief information about Ten-GigabitEthernet 1/0/1, including the complete description of the interface.
<Sysname> display interface ten-gigabitethernet 1/0/1 brief description
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) - auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
XGE1/0/1 UP 1G(a) F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
# Display information about interfaces in DOWN state and the causes.
<Sysname> display interface brief down
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
Vlan2 DOWN Not connected
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
GE1/0/2 DOWN Not connected
|
Field |
Description |
|
Brief information on interfaces in route mode: |
Brief information about Layer 3 interfaces. |
|
Interface |
Interface name. |
|
Link |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. |
|
Protocol |
Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces. |
|
Primary IP |
Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address. |
|
Description |
Description of the interface. |
|
Brief information of interfaces in bridge mode: |
Brief information about Layer 2 interfaces. |
|
Type: A - access; T - trunk; H – hybrid |
Link type options for interfaces. |
|
Speed |
Speed of the interface, in bps. This field displays the (a) flag next to the speed if the speed is automatically negotiated. This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started. |
|
Duplex |
Duplex mode of the interface: · A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started. · F—Full duplex. · F(a)—Autonegotiated full duplex. · H—Half duplex. · H(a)—Autonegotiated half duplex. |
|
Type |
Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk. |
|
PVID |
Port VLAN ID. |
|
Cause |
Cause for the physical link state of an interface to be DOWN: · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · DOWN ( Link-Aggregation interface down )—The interface is a member port of an aggregate interface, and the aggregate interface is down. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty). · STP DOWN—The interface has been shut down by the BPDU guard feature. |
Related commands
reset counters interface
display interface link-info
Use display interface link-info to display the status and packet statistics of interfaces.
Syntax
display interface link-info [ main ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
main: Specifies all interfaces except subinterfaces. If you do not specify this keyword, this command displays status and packet statistics of all interfaces.
Examples
# Display status and statistics of all interfaces.
<Sysname> display interface link-info
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol InUsage OutUsage InErrs OutErrs
GE1/0/1 DOWN DOWN -- -- -- --
InLoop0 UP UP(s) -% -% 0 0
NULL0 UP UP(s) -% -% 0 0
SGE1/0/1 UP UP 0% 0% 1 0
Vlan1 UP UP -- -- -- --
Vlan100 DOWN DOWN -- -- -- --
Vlan4094 DOWN DOWN -- -- -- --
WLAN-Radio1/0/1 UP UP -- -- -- --
WLAN-Radio1/0/2 UP UP -- -- -- --
Overflow: More than 7 digits.
--: Not supported.
Table 6 Command output
|
Field |
Description |
|
Link: ADM - administratively down; Stby - standby |
Physical link state of the interface: · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. |
|
Protocol: (s) – spoofing |
The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces. |
|
Interface |
Abbreviated interface name. |
|
Link |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. |
|
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. |
|
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 .
Syntax
display interface [ interface-type ] [ brief [ description | down ] ] main
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type. If you do not specify this argument, the command displays information about interfaces of all types.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.
Examples
# Display operating status and information of all interfaces except subinterfaces.
<Sysname> display interface main
Ten-GigabitEthernet1/0/1
Current state: DOWN
Line protocol state: DOWN
IP packet frame type: Ethernet II, hardware address: 7057-bf53-22e0
Description: GigabitEthernet1/0/1 Interface
Loopback is not set
Media type is twisted pair, promiscuous mode not set
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Flow-control is not enabled
Maximum frame length: 1600
Allow jumbo frames to pass
Broadcast max-ratio: 100%
Multicast max-ratio: 100%
Unicast max-ratio: 100%
PVID: 1
Port link-type: Access
Tagged VLANs: None
Untagged VLANs: 1
Port priority: 0
Last link flapping: Never
Last clearing of counters: Never
Current system time:2022-02-16 01:38:16 Beijing+08:00:00
Last time when physical state changed to up:-
Last time when physical state changed to down:2022-02-16 01:18:39 Beijing+08:00:
00
Last 300 second input: 0 packets/sec 0 bytes/sec -%
Last 300 second output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, - throttles
0 CRC, - frame, 0 overruns, 0 aborts
- ignored, - parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, - buffer failures
- aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
…
# Display brief information of all interfaces.
<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
Loop0 UP UP(s) 2.2.2.9
NULL0 UP UP(s) --
Vlan1 UP DOWN --
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) - auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
GE1/0/2 DOWN auto A A 1
XGE1/0/1 UP 1G(a) F(a) A 1
WLAN-Radio1/0/1 UP -- -- -- --
WLAN-Radio1/0/2 UP -- -- -- --
WLAN-Radio1/0/3 UP -- -- -- --
# Display brief information about all interfaces, including the complete interface descriptions.
<Sysname> display interface brief description main
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) - auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
GE1/0/3 UP auto F(a) A 1 aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
# Display information about interfaces in DOWN state and the causes.
<Sysname> display interface brief down main
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
XGE1/0/1 DOWN Not connected
For the command output, see the display interface command.
duplex
Use duplex to set the duplex mode for an Ethernet interface.
Use undo duplex to restore the default.
Syntax
duplex { auto | full | half }
undo duplex
Default
Ethernet interfaces operate in autonegotiation mode.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
auto: Configures the interface to autonegotiate the duplex mode with the peer.
full: Configures the interface to operate in full duplex mode. In this mode, the interface can receive and transmit packets simultaneously.
half: Configures the interface to operate in half duplex mode. In this mode, the interface can only receive or transmit packets at a given time.
For fiber ports, devices only support the auto keyword of this command.
Examples
# Configure Ten-GigabitEthernet 1/0/1 to operate in full duplex mode.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] 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
Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Sets the statistics polling interval in seconds. The interval is in the range of 5 to 300 and must be a multiple of 5.
Examples
# Set the statistics polling interval to 100 seconds on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] flow-interval 100
interface
Use interface to enter interface view.
Syntax
interface interface-type interface-number
Views
System view
Predefined user roles
network-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Examples
# Enter the view of Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1]
jumboframe enable
Use jumboframe enable to allow jumbo frames within the specified length to pass through.
Use undo jumboframe enable to prevent jumbo frames from passing through.
Use undo jumboframe enable size to restore the default.
Syntax
jumboframe enable [ size ]
undo jumboframe enable [ size ]
Default
The device allows jumbo frames within 1600 bytes to pass through.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value for this argument is 1600 bytes.
Examples
# Allow jumbo frames to pass through Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] jumboframe enable
multicast-suppression
Use multicast-suppression to enable multicast storm suppression and set the multicast storm suppression threshold.
Use undo multicast-suppression to disable multicast storm suppression.
Syntax
multicast-suppression { ratio | pps max-pps | kbps max-kbps }
undo multicast-suppression
Default
Ethernet interfaces do not suppress multicast traffic.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
ratio: Sets the multicast suppression threshold as a percentage of the interface bandwidth. The value range for this argument (in percentage) is 0 to 100. A smaller value means that less multicast traffic is allowed to pass through.
pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.
kbps max-kbps: Specifies the maximum number of kilobits of multicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.
Usage guidelines
The multicast storm suppression feature limits the size of multicast traffic to a threshold on an interface. When the multicast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.
Examples
# Set the multicast storm suppression threshold to 10000 kbps on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] multicast-suppression kbps 10000
Related commands
broadcast-suppression
reset counters interface
Use reset counters interface to clear the interface statistics.
Syntax
reset counters interface [ interface-type [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.
If you do not specify an interface type, this command clears statistics for all interfaces except VA interfaces. For more information about VA interfaces, see PPPoE in Layer 2—WAN Access Configuration Guide.
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 Ten-GigabitEthernet 1/0/1.
<Sysname> reset counters interface ten-gigabitethernet 1/0/1
Related commands
display counters interface
display counters rate interface
display interface
reset counters mib interface
Use reset counters mib interface to clear the interface statistics on MIB.
Syntax
reset counters mib interface [ interface-type [ interface-number ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
Use this command to clear history statistics 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 except VA 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/1.
<Sysname> reset counters mib interface ten-gigabitethernet 1/0/1
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
Examples
# Clear the Ethernet module statistics.
<Sysname> reset ethernet statistics
Related commands
display ethernet statistics
shutdown
Use shutdown to shut down an Ethernet interface.
Use undo shutdown to bring up an Ethernet interface.
Syntax
shutdown
undo shutdown
Default
An Ethernet interface or subinterface is up.
Views
Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
|
|
CAUTION: Executing the shutdown command on an interface will disconnect the link of the interface and interrupt communication. Use this command with caution. |
Some interface configurations might require an interface restart before taking effect.
Examples
# Shut down and then bring up Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] shutdown
[Sysname-Ten-GigabitEthernet1/0/1] undo shutdown
shutdown all-physical-interfaces
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
Physical interfaces are up.
Views
System view
Predefined user roles
network-admin
Usage guidelines
With the shutdown all-physical-interfaces command, you can shut down all physical 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
speed
Use speed to set the speed of an Ethernet interface.
Use undo speed to restore the default.
Syntax
speed { 10 | 100 | 1000 | 2500 | 5000 | 10000 | auto }
undo speed
Default
An Ethernet interface autonegotiates its speed.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
10: Sets the interface speed to 10 Mbps.
10: Sets the interface speed to 10 Mbps.
100: Sets the interface speed to 100 Mbps.
1000: Sets the interface speed to 1000 Mbps.
2500: Sets the interface speed to 2500 Mbps.
5000: Sets the interface speed to 5000 Mbps.
10000: Sets the interface speed to 10000 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.
Examples
# Configure Ten-GigabitEthernet 1/0/1 to autonegotiate the speed.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] speed auto
