display interface tunnel

Function

The display interface tunnel command displays details of the tunnel interface.

Format

display interface tunnel [ interface-number | main ]

Parameters

Parameter	Description	Value
interface-number	Specifies the number of the tunnel interface. If this parameter is not specified, the command displays information about all tunnel interfaces.	The value must be the number a tunnel interface that has been created.
main	Displays status and traffic statistics about main interface. The interface has no sub-interfaces. Status and traffic statistics about the interface are displayed whether you specify the main parameter or not.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check status of tunnels or diagnose the fault in these tunnels, run the display interface tunnel command. You can run this command to obtain tunnel interface information when configuring tunnels or when locating the fault on these tunnels.

Prerequisites

Before run display interface tunnel, please ensure that tunnel interface has been created using the interface tunnel command.

Example

# Display the details of the tunnel interface.

<HUAWEI> display interface tunnel 1
Tunnel1 current state : UP             
Line protocol current state : UP                                                
Last line protocol up time : 2012-11-16 19:16:33 UTC+08:00                      
Description:                                                                    
Route Port,The Maximum Transmit Unit is 1500                                    
Internet Address is 10.3.1.2/24                                                 
Encapsulation is TUNNEL, loopback not set                                       
Tunnel source 10.2.1.2 (Vlanif1234), destination 10.2.1.1                       
Tunnel protocol/transport GRE/IP, key disabled                                  
keepalive enable period 5 retry-times 3                                         
Checksumming of packets disabled                                                
Current system time: 2012-11-16 19:17:39+08:00                                  
Last 300 seconds input rate 16 bits/sec, 0 packets/sec                          
Last 300 seconds output rate 0 bits/sec, 0 packets/sec                          
Input:  5 packets, 650 bytes                                                    
Output:  0 packets, 0 bytes                                                     
    Input bandwidth utilization  :    0%                                        
    Output bandwidth utilization :    0%

**Table 1** Description of the display interface tunnel command output
Item	Description
Tunnel1 current state	Physical layer status of the tunnel interface: UP: The interface is in normal state. Administratively DOWN: The network administrator executes the shutdown command on the interface. After a tunnel interface is created, its physical layer status is Up.
Line protocol current state	Link protocol status: UP: The link layer protocol of the tunnel interface works normally. Down: The link layer protocol of the tunnel interface is abnormal.
Last line protocol up time	Last time the link layer protocol of the tunnel interface goes UP. NOTE: This field is displayed only when the link layer protocol status of the tunnel interface is UP.
Description	Description of the tunnel interface.
Route Port	Indicates the Layer 3 interface.
The Maximum Transmit Unit is 1500	MTU of tunnel interfaces, which is 1500 bytes by default. Any packet larger than the MTU is fragmented before being sent. If non-fragmentation is configured, the packet is discarded.
Internet Address is 10.3.1.2/24	IP address of the tunnel interface is 10.3.1.2. The mask is 24 bits, that is, 255.255.255.0.
Encapsulation is TUNNEL,	Encapsulation type of packets on a tunnel interface. Packet encapsulation protects a whole IP packet.
loopback not set	The tunnel interface does not support a loopback test.
Tunnel source 10.2.1.2 (Vlanif1234)	The source address of the tunnel is 10.2.1.2. That is, the IP address of the VLANIF 1234 interface sending packets at the source side is 10.2.1.2.
destination 10.2.1.1	Destination address of the tunnel.
Tunnel protocol/transport GRE/IP, key disabled	The tunnel encapsulation protocol is the GRE protocol, and the transport protocol is the IP protocol. Encapsulation protocol types of a tunnel are as follows: GRE: indicates Generic Routing Encapsulation. MPLS: encapsulates packets into MPLS packets. IPv6 over IPv4: encapsulates IPv6 packets into IPv4 packets. IPv4 over IPv6: encapsulates IPv4 packets into IPv6 packets. none: indicates no encapsulation. This is the default mode of the tunnel interface. key disabled: the key word recognition function of GRE is not enabled.
keepalive enable period 5 retry-times 3	The keepalive function of GRE.
Checksumming of packets disabled	The check sum function of GRE is not enabled.
Current system time	Current system time. If the time zone is configured and the daylight saving time is used, the time is in YYYY/MM/DD HH:MM:SS UTC±HH:MM DST format.
Last 300 seconds input rate	Incoming packet rate (bits per second and packets per second) within the last 300 seconds.
Last 300 seconds output rate	Outgoing packet rate (bits per second and packets per second) within the last 300 seconds.
Input	Total number of received packets.
Output	Total number of sent packets.
Input bandwidth utilization : --	Input bandwidth usage.
Output bandwidth utilization : --	Output bandwidth usage.