display interface tunnel

Syntax

display interface [ tunnel ] [ brief [ description | down ] ] [ | { begin | exclude | include } regular-expression ]

display interface tunnel number [ brief [ description ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

number: Specifies the number of a tunnel interface. With this argument, the command displays information about the specified 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 DOWN state and the causes. If you do not specify this keyword, this 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.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Related commands: interface tunnel, source, destination, and tunnel-protocol.

Examples

# Display detailed information about interface Tunnel 0.

<Sysname> display interface tunnel 0
Tunnel0 current state: UP
Line protocol current state: UP
Description: Tunnel0 Interface
The Maximum Transmit Unit is 1476
Internet Address is 58.0.0.1/24 Primary
Encapsulation is TUNNEL, service-loopback-group ID is 1.
Tunnel source 20.0.0.2 (Vlan-interface2000), destination 20.0.0.1
Tunnel bandwidth 64 (kbps)
Tunnel protocol/transport GRE/IP
    GRE key disabled
Checksumming of GRE packets disabled
Output queue : (Urgent queuing : Size/Length/Discards)  0/100/0
Output queue : (Protocol queuing : Size/Length/Discards)  0/500/0
Output queue : (FIFO queuing : Size/Length/Discards)  0/75/0
Last clearing of counters:  Never
    Last 300 seconds input:  0 bytes/sec, 0 packets/sec
    Last 300 seconds output:  28 bytes/sec, 0 packets/sec
    1847 packets input,  136451 bytes
    0 input error
    5572 packets output,  428860 bytes
    0 output error

Table 55: Command output

Field

Description

Tunnel0 current state

Physical state of the tunnel interface:

  • DOWN (Administratively)—The interface is administratively down. That is, the interface is shut down with 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 current state

Link layer state of the tunnel interface:

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

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

Description

Description of the tunnel interface.

Maximum Transmit Unit

Maximum transmit unit allowed on the tunnel interface.

Internet Address

IP address of the tunnel interface.

If no IP address is assigned to the interface, Internet protocol processing : disabled is displayed, which means that packets cannot be processed.

Primary indicates the primary IP address of the interface. Sub indicates a secondary IP address of the interface.

Encapsulation is TUNNEL

The encapsulation protocol is tunnel.

service-loopback-group ID

ID of the service loopback group referenced by the tunnel.

If service loopback group is not specified, service-loopback-group ID not set is displayed.

Tunnel source

Source address of the tunnel.

destination

Destination address of the tunnel.

Tunnel bandwidth

Bandwidth of the tunnel interface.

Tunnel protocol/transport

Tunnel mode and transport protocol:

  • GRE/IP—GRE over IPv4 tunnel mode.

  • GRE/IPv6—GRE over IPv6 tunnel mode.

  • IP/IP—IPv4 over IPv4 tunnel mode.

  • IP/IPv6—IPv4 over 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.

  • IPv6/IPv6—IPv6 over IPv6 tunnel mode.

GRE key disabled

The tunnel interface key option of GRE is not configured.

Checksumming of GRE packets disabled

The GRE packet checksum function is disabled.

Last clearing of counters

Last time of clearing of counters.

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

Average input rate in the last 300 seconds in bytes/sec or packets/sec.

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

Average output rate in the last 300 seconds in bytes/sec or packets/sec.

packets input

Total number of input packets.

input error

Number of input error packets.

packets output

Total number of output packets.

output error

Number of output error packets.

# Display brief information about interface Tunnel 0.

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

# Display brief information about interface Tunnel 1 in DOWN state.

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

Table 56: Command output

Field

Description

The brief information of interface(s) under route mode

Brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

Link status. If the interface has been administratively shut down, ADM is displayed. To recover its physical state, perform the undo shutdown command.

Protocol: (s) - spoofing

(s) indicates that the network layer protocol state is UP, but the link is not available because it is an on-demand link or not present at all.

Interface

Abbreviated interface name.

Link

Physical link state of the interface:

  • UP—The link is up.

  • DOWN—The link is down.

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

Protocol

Protocol state:

  • DOWN—The protocol is disabled.

  • UP—The protocol is enabled.

Main IP

Primary IP address of the interface.

Description

Description of the interface.

Cause

Cause of a DOWN physical link. If the port has been shut down with the shutdown command, this field displays Administratively. To bring up the port, use the undo shutdown command.