display interface

Function

The display interface command displays the interface status and statistics.

Format

display interface [ interface-type [ interface-number | main ]

Parameters

Parameter	Description	Value
interface-type	Specifies the type of an interface. If no interface-type is specified, the operating status of and statistics about all interfaces are displayed.	-
interface-number	Specifies the number of an interface. If no interface-number is specified, the operating status of and statistics about all interfaces of the interface-type are displayed.	-
main	Displays running status and traffic statistics about an interface. If an interface has no sub-interfaces, status and traffic statistics about the interface are displayed whether you specify the main parameter or not. If an interface has sub-interfaces, status and traffic statistics about the interface and sub-interfaces are displayed if you do not specify the main parameter.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can view the display interface command output before monitoring traffic and diagnosing interface faults.

Example

# Display the current operating status of and statistics about GigabitEthernet 0/0/1.

<sysname> display interface GigabitEthernet 0/0/1
GigabitEthernet0/0/1 current state : UP        
Line protocol current state : UP                                                
Description :  Interface Route Port
The Maximum Transmit Unit is 1500 bytes, Hold timer is 10(sec)                  
Internet Address is 10.1.1.1/24                                                 
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 0022-a106-0e5b 
Media type is twisted pair, loopback not set, promiscuous mode not set          
1000Mb/s-speed mode, full-duplex mode, link type is auto negotiation            
Max-bandwidth : 1000000 kbps                                                
Last physical up time   : -                                                     
Last physical down time : 2018-01-16 20:33:13                                   
Current system time: 2018-01-17 10:08:18 
Top 3 input bit rate: 672688 bits/sec at 2018-01-15 11:11:41                                                                        
                      20872 bits/sec at 2018-01-15 11:11:40                                                                         
                      17456 bits/sec at 2018-01-14 19:23:00                                                                         
Top 3 output bit rate: 672000 bits/sec at 2018-01-15 11:11:41                                                                       
                       19568 bits/sec at 2018-01-15 11:11:40                                                                        
                       9064 bits/sec at 2018-01-14 11:11:53                                                                         
Top 3 input packet rate: 8008 packets/sec at 2018-01-15 11:11:41                                                                    
                         248 packets/sec at 2018-01-15 11:11:40                                                                     
                         216 packets/sec at 2018-01-14 11:11:56                                                                     
Top 3 output packet rate: 8000 packets/sec at 2018-01-15 11:11:41                                                                   
                          232 packets/sec at 2018-01-15 11:11:40                                                                    
                          80 packets/sec at 2018-01-14 11:11:53
Last 300 seconds input rate 2619  bytes/sec, 16  packets/sec                
Last 300 seconds output rate 28627  bytes/sec, 26  packets/sec              
    Input: 277618 packets, 46890659 bytes                                       
          275866 unicasts, 1740 broadcasts, 12 multicasts, 0 pauses             
          0 overruns, 0 runts, 0 jumbos, 0 FCS errors                           
          0 length errors,  0 code errors, 0 align errors                       
          0 fragment errors,  0 giants, 0 jabber errors                         
          0 dribble condition detected,  0 other errors                         
    Output: 303774 packets, 157242945 bytes                                     
          285539 unicasts, 6 broadcasts, 18229 multicasts, 0 pauses             
          0 underruns, 0 runts, 0 jumbos, 0 FCS errors                          
          0 fragment errors, 0 giants, 0 jabber errors                          
          0 collisions, 0 late collisions                                       
          0 ex. collisions, 0 deferred, * other errors

**Table 1** Description of the **display interface** command output
Item	Description
current state	Physical status of the interface: UP: The physical layer status of the interface is normal. DOWN: The physical layer of the interface fails. Administratively down: The shutdown command is run on the interface by the administrator. Flow Down: The status of the data flow on the interface is Down. This status is consistent with the status of the bound mVRRP virtual router. If the status of the bound mVRRP virtual router is Backup or Initialize, the status of the data flow on the service interface is Down.
Line protocol current state	Status of the link protocol of the interface: UP: The link protocol status of the interface is normal. DOWN: The link protocol status of the interface fails or the interface is not configured with an IP address. UP (spoofing): The link protocol status of the interface has the spoofing feature. That is, the link protocol status of the interface keeps Up.
Description	Description about the interface. Up to 80 characters can be entered. The description can help the user to get familiar with the interface function.
The Maximum Transmit Unit	The packet larger than the MTU is fragmented before being sent. If the non-fragmentation is configured, the packet is discarded.
Hold timer	Life cycle of the packet. If the packet is not sent out during the life cycle, it is discarded.
Internet Address	IP address and the subnet mask of the interface.
IP Sending Frames' Format	Format of Ethernet frames sent by the interface: Ethernet_2 Ethernet_SNAP 802.2 802.3 The default value is Ethernet_2.
Hardware address	MAC address of the interface.
Max-bandwidth	Maximum bandwidth of the interface.
Last physical up time	The last time when the interface is up.
Last physical down time	The last time when the interface is down.
Current system time	The time of the current system.
Top 3 input bit rate	Top 3 bits inputted per second on the interface.
Top 3 output bit rate	Top 3 bits outputted per second on the interface.
Top 3 input packet rate	Top 3 packets inputted per second on the interface.
Top 3 output packet rate	Top 3 packets outputted per second on the interface.
Last 300 seconds input/output rate	Average rate of packets received/sent within the last 300s. The time range can be set through set flow-stat interval.
Input	Total number of packets and bytes received by the interface: NOTE: On the USG6510E/6510E-POE, USG6530E, USG6515E/6550E/6560E/6580E, and USG6525E/6555E/6565E/6575E-B/6585E/6605E-B, unicast, broadcast, and multicast statistics packets contain Grant packets. unicasts: number of unicast packets. broadcasts: number of broadcast packets. multicasts: number of multicast packets. pauses: number of received pause frames. overruns: number of packets discarded because of overflow errors. runts: number of frames less than 64 bytes, in the correct format, and containing valid CRC fields jumbos: number of frames greater than 1518 bytes (greater than 1522 bytes if VLAN is involved) and less than the maximum jumbo length in a scenario where jumbo is enabled FCS errors: number of received packets with CRC errors and normal length length errors: number of packets with incorrect packet length when the value in the length field of a standard Ethernet frame is inconsistent with the actual packet length (46 to 1500) bytes code errors: number of packets with invalid data after the valid carrier align errors: number of packets with align errors, that is, the transmitted packets have incomplete bytes, including preambles and interframe gaps fragment errors: number of received packets less than 64 bytes and with incorrect CRCs giants: number of oversized packets of 1519 to 16383 bytes jabber errors: number of jabber errors, in which only frames (for CRC error packets) greater than the maximum length of the jumbo can be counted into the jabber when jumbo is enabled dribble condition detected: number of incorrect packets with 4bit data after CRC checks other errors: number of other error packets
output	Total number of packets and bytes sent by the interface: NOTE: On the USG6510E/6510E-POE, USG6530E, USG6515E/6550E/6560E/6580E, and USG6525E/6555E/6565E/6575E-B/6585E/6605E-B, unicast, broadcast, and multicast statistics packets contain Grant packets. unicasts: number of unicast packets. broadcasts: number of broadcast packets. multicasts: number of multicast packets. pauses: number of sent pause frames. underruns: number of packets discarded when the sending rate of the port exceeds the processing capability of the sending queue runts: number of frames less than 64 bytes, in the correct format, and containing valid CRC fields jumbos: number of frames greater than 1518 bytes (greater than 1522 bytes if VLAN is involved) and less than the maximum jumbo length in a scenario where jumbo is enabled FCS errors: number of sent frames with CRC errors and normal length fragment errors: number of sent packets less than 64 bytes and with incorrect CRCs giants: number of oversized packets of 1519 to 16383 bytes jabber errors: number of jabber errors, in which only frames (for CRC error packets) greater than the maximum length of the jumbo can be counted into the jabber when jumbo is enabled collisions: number of packets that are not sent when a collision is detected late collisions: number of delayed collision frames because a collision is detected when the first 512 bits of a frame are sent ex. collisions: number of times that a collision occurs after 16 consecutive frame collisions ( For example, if one collision occurs again, the count is 1; if two consecutive collisions occur, the count is 2.) deferred: number of packets delayed from transmitting due to collisions detected before the transmission other errors: number of other error packets

Compared with the command output of an electrical interface, the command output of an optical module interface displays more keyword information. The following describes supplemented information in the command output of an optical module.

**Table 2** Supplemented information in the command output of an optical module
Item	Description
SFP Module
Vendor Name	Name of an optical module vendor
Vendor PN	PN of an optical module vendor
SN	SN of an optical module
Note: The optical module was not certified by Huawei Unified Security Gateway.	Non-Huawei-certified optical module alarm
Transceiver max BW	Maximum transmit bandwidth of an optical module
WaveLengh	Wavelength of an optical module
Transmission Distance	Transmission distance of an optical module
Current Optical module temperature	Current temperature and temperature threshold of an optical module
Current Optical module supply	Current voltage and voltage threshold of an optical module
Current Tx bias(mA)	Current bias current of an optical module
Default Tx bias High Threshold(mA)	Upper limit on the bias current of an optical module
Default Tx bias Low Threshold(mA)	Lower limit on the bias current of an optical module
Current Rx Power(dBM)	Current receive power of an optical module
Default Rx Power High Threshold(dBM)	Upper limit on the receive power of an optical module
Default Rx Power Low Threshold(dBM)	Lower limit on the receive power of an optical module
Current Tx Power(dBM)	Current transmit power of an optical module
Default Tx Power High Threshold(dBM)	Upper limit on the receive power of an optical module
Default Tx Power Low Threshold(dBM)	Lower limit on the transmit power of an optical module
QSFP Module
Vendor Name	Name of an optical module vendor
Vendor PN	PN of an optical module vendor
SN	SN of an optical module
Transceiver max BW	Maximum transmit bandwidth of an optical module
WaveLengh	Wavelength of an optical module
Transmission Distance	Transmission distance of an optical module
Current Optical module temperature	Current temperature and temperature threshold of an optical module
Current Optical module supply	Current voltage and voltage threshold of an optical module
Current Tx bias(mA)	Current bias current of each lane of an optical module
Default Tx bias High Threshold(mA)	Upper limit on the bias current of an optical module
Default Tx bias Low Threshold(mA)	Lower limit on the bias current of an optical module
Current Rx Power(dBM)	Current receive power of each lane of an optical module
Default Rx Power High Threshold(dBM)	Upper limit on the receive power of an optical module
Default Rx Power Low Threshold(dBM)	Lower limit on the receive power of an optical module
Current Tx Power(dBM)	Current transmit power of each lane of an optical module
Default Tx Power High Threshold(dBM)	Upper limit on the receive power of an optical module
Default Tx Power Low Threshold(dBM)	Lower limit on the transmit power of an optical module