display interface tunnel

Use display interface tunnel to display information about tunnel interfaces, including the source address, destination address, and tunnel mode.

Syntax

display interface tunnel [ number [ brief [ description ] ] | brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

number: Specifies the number of a tunnel interface.

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

down: Displays information about interfaces in the physical state of DOWN and the causes. 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 interface descriptions.

Usage guidelines

If you do not specify the tunnel keyword, this command displays information about all interfaces on the device.

If you specify the tunnel keyword without the number argument, this command displays information about all existing tunnel interfaces.

Examples

# Display detailed information about interface Tunnel 1.

<Sysname> display interface tunnel 1
Tunnel1
Current state: DOWN
Line protocol state: DOWN
Description: Tunnel5 Interface
Bandwidth: 64kbps
Maximum Transmit Unit: 64000
Internet protocol processing: disabled
Tunnel source unknown, destination unknown
Tunnel encapsulation-limit is disabled
Tunnel TTL 255
Tunnel protocol/transport IPv6
Last clearing of counters: Never
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops
Output: 0 packets, 0 bytes, 0 drops  

Table 70: Command output

Field

Description

Tunnel1

Information about the tunnel interface Tunnel 1.

Current state

State of the tunnel 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.

  • UP—Both the administrative and physical states of the interface are up.

Line protocol state

Link layer protocol state of the tunnel interface. The value is determined by the parameter negotiation on the link layer.

  • UP—The protocol state of the interface is up.

  • UP (spoofing)—The link protocol state of the interface is up, but the link is temporarily set up on demand or does not exist. This attribute is available for null interfaces and loopback interfaces.

  • DOWN—The protocol state of the interface is down.

Description

Description of the tunnel interface.

Bandwidth

Intended bandwidth for the tunnel interface.

Maximum Transmit Unit

MTU of the tunnel interface.

Internet Address

IP address of the tunnel interface.

If no IP address is assigned to the interface, this field displays Internet protocol processing: disabled, and the tunnel interface cannot process packets.

Primary indicates it is the primary IP address of the interface.

Tunnel source

Source address of the tunnel. If a source interface is specified for the tunnel interface, this field also displays the source interface in parentheses.

destination

Destination address of the tunnel.

Tunnel encapsulation-limit is disabled

Tunnel nested encapsulation is not supported.

Tunnel TTL

TTL of tunneled packets.

Tunnel protocol/transport

Tunnel mode and transport protocol:

  • GRE/IP—GRE/IPv4 tunnel mode.

  • GRE/IPv6—GRE/IPv6 tunnel mode.

  • IP/IP—IPv4 over IPv4 tunnel mode.

  • IPv6—IPv6 tunnel mode.

  • IPv6/IP—IPv6 over IPv4 manual tunnel mode.

  • IPv6/IP 6to4—IPv6 over IPv4 6to4 tunnel mode.

  • IPv6/IP ISATAP—IPv6 over IPv4 ISATAP tunnel mode.

Last clearing of counters

Last time of clearing counters.

Last 300 seconds input: 0 bytes/sec, 0 packets/sec

Average input rate in the last 300 seconds.

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

Average output rate in the last 300 seconds.

# Display brief information about the interface Tunnel 1.

<Sysname> display interface tunnel 1 brief
Brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface            Link Protocol Main IP         Description
Tun1                 UP   UP      1.1.1.1          aaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display brief information about interface Tunnel 1, including the complete interface description.

<Sysname> display interface tunnel 1 brief description
Brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface            Link Protocol Main IP         Description
Tun1                 UP   UP      1.1.1.1          aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

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

<Sysname> display interface tunnel brief down
Brief information on interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Interface            Link Cause
Tun0                  DOWN Not connected
Tun1                  DOWN Not connected

Table 71: Command output

Field

Description

Brief information of interface(s) under route mode

Brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

Link status:

  • ADM—The interface has been administratively shut down. To recover its physical state, use the undo shutdown command.

  • Stby—The interface is a backup interface.

Protocol: (s) - spoofing

(s) indicates that the data link layer protocol state is UP, but the link is temporarily set up on demand or does not exist. This attribute is available for null interfaces and loopback interfaces.

Interface

Abbreviated interface name.

Link

Physical link state of the interface:

  • UP—The link is physically up.

  • DOWN—The link is physically down.

  • ADM—The link has been administratively shut down. To bring it up, use the undo shutdown command.

  • Stby—The interface is a backup interface.

Protocol

Data link layer protocol state of the interface:

  • UP—The data link protocol state of the interface is up.

  • UP (spoofing)—The link protocol state of the interface is up, but the link is temporarily set up on demand or does not exist. This attribute is available for null interfaces and loopback interfaces.

Main IP

Primary IP address of the interface.

Description

Description of the interface.

Cause

Causes for the physical state of DOWN:

  • Administratively—The link has been shut down by using the shutdown command. To restore its physical state, use the undo shutdown command.

  • Not connected—The tunnel is not established.

Related commands