Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show interfaces (GRE)

Syntax

Description

Display status information about the specified generic routing encapsulation (GRE) interface.

Options

interface-type

On M Series and T Series routers and EX Series switches, the interface type is gr-fpc/pic/port.

brief | detail | extensive | terse

(Optional) Display the specified output level of interface information.

descriptions

(Optional) Display interface description strings.

media

(Optional) Display media-specific information about network interfaces.

snmp-index snmp-index

(Optional) Display information for the specified SNMP index of the interface.

statistics

(Optional) Display static interface statistics.

Note:

You can configure generic routing encapsulation (GRE) interfaces (gre-x/y/z) only for GMPLS control channels. GRE interfaces are not supported or configurable for other applications. For more information about GMPLS, see the MPLS Applications User Guide.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show interfaces (GRE) command. Output fields are listed in the approximate order in which they appear.

Table 1: GRE show interfaces Output Fields

Field Name

Field Description

Level of Output

Physical Interface  

Physical interface

Name of the physical interface.

All levels

Enabled

State of the interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description.

All levels

Interface index

Physical interface's index number, which reflects its initialization sequence.

detail extensive none

SNMP ifIndex

SNMP index number for the physical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Type

Type of interface.

All levels

Link-level type

Encapsulation used on the physical interface.

All levels

MTU

MTU size on the physical interface.

All levels

Speed

Speed at which the interface is running.

All levels

Hold-times

Current interface hold-time up and hold-time down, in milliseconds.

detail extensive

Device Flags

Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description.

All levels

Interface Flags

Information about the interface. Possible values are described in the “Interface Flags” section under Common Output Fields Description.

All levels

Input rate

Input rate in bits per second (bps) and packets per second (pps).

None specified

Output rate

Output rate in bps and pps.

None specified

Statistics last cleared

Time when the statistics for the interface were last set to zero.

detail extensive

Traffic statistics

The number of and the rate at which input and output bytes and packets are received and transmitted on the physical interface.

  • Input bytes—Number of bytes received on the interface.

  • Output bytes—Number of bytes transmitted on the interface.

  • Input packets—Number of packets received on the interface.

  • Output packets—Number of packets transmitted on the interface.

detail extensive

Logical Interface  

Logical interface

Name of the logical interface.

All levels

Index

Logical interface index number, which reflects its initialization sequence.

detail extensive none

SNMP ifIndex

Logical interface SNMP interface index number.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support.

detail extensive

Flags

Information about the logical interface. Possible values listed in the “Logical Interface Flags” section under Common Output Fields Description. describe general information about the logical interface.

GRE-specific information about the logical interface is indicated by the presence or absence of the following value in this field:

  • Reassemble-Pkts—If the Flags field includes this string, the GRE tunnel is configured to reassemble tunnel packets that were fragmented after tunnel encapsulation.

All levels

IP-Header

IP header of the logical interface. If the tunnel key statement is configured, this information is included in the IP Header entry.

GRE-specific information about the logical interface is indicated by the presence or absence of the following value in this field:

  • df—If the IP-Header field includes this string immediately following the 16 bits of identification information (that is, if :df: displays after the twelfth byte), the GRE tunnel is configured to allow fragmentation of GRE packets after encapsulation.

All levels

Encapsulation

Encapsulation on the logical interface.

All levels

L2 Routing Instance

Name of the Layer 2 routing instance associated with the GRE interface.

All levels

L3 Routing Instance

Name of the Layer 3 routing instance associated with the GRE interface.

All levels

Copy-tos-to- outer-ip-header

Status of type of service (ToS) bits in the GRE packet header:

  • On—ToS bits were copied from the payload packet header into the header of the IP packet sent through the GRE tunnel.

  • Off—ToS bits were not copied from the payload packet header and are set to 0 in the GRE packet header.

Note:

EX Series switches do not support copying ToS bits to the encapsulated packet, so the value of this field is always Off in switch output.

detail extensive

Gre keepalives configured

Indicates whether a GRE keepalive time and hold time are configured for the GRE tunnel.

Note:

EX Series switches do not support configuration of GRE tunnel keepalive times and hold times, so the value of this field is always Off in switch output.

detail extensive

Gre keepalives adjacency state

Status of the other end of the GRE tunnel: Up or Down. If keepalive messages are not received by either end of the GRE tunnel within the hold-time period, the GRE keepalive adjacency state is down even when the GRE tunnel is up.

detail extensive

Input packets

Number of packets received on the logical interface.

None specified

Output packets

Number of packets transmitted on the logical interface.

None specified

Traffic statistics

Total number of bytes and packets received and transmitted on the logical interface. These statistics are the sum of the local and transit statistics. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It takes awhile (generally, less than 1 second) for this counter to stabilize.

  • Input rate—Rate of bits and packets received on the interface.

  • Output rate—Rate of bits and packets transmitted on the interface.

detail extensive

Local statistics

Statistics for traffic received from and transmitted to the Routing Engine. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It takes awhile (generally, less than 1 second) for this counter to stabilize.

detail extensive

Transit statistics

Statistics for traffic transiting the router. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It takes awhile (generally, less than 1 second) for this counter to stabilize.

detail extensive none

Protocol

Protocol family configured on the logical interface, such as iso, inet6, or mpls.

detail extensive none

protocol-family

Protocol family configured on the logical interface. If the protocol is inet, the IP address of the interface is also displayed.

brief

MTU

MTU size on the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Route table

Routing table in which the logical interface address is located. For example, 0 refers to the routing table inet.0.

detail extensive

Flags

Information about the protocol family flags. Possible values are described in the “Family Flags” section under Common Output Fields Description.

detail extensive none

Addresses, Flags

Information about the address flags. Possible values are described in the “Addresses Flags” section under Common Output Fields Description.

detail extensive none

Destination

IP address of the remote side of the connection.

detail extensive none

Local

IP address of the logical interface.

detail extensive none

Broadcast

Broadcast address of the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Sample Output

show interfaces (GRE)

show interfaces brief (GRE)

show interfaces detail (GRE)

show interfaces (Layer 2 Services Over GRE Interfaces)

show interfaces extensive (Layer 2 Services Over GRE Interfaces)

show interfaces detail (GRE) on an EX4200 Virtual Chassis Member Switch

show interfaces extensive (GRE)

The output for the show interfaces extensive command is identical to that for the show interfaces detail command. For sample output, see show interfaces detail (GRE) and show interfaces detail (GRE) on an EX4200 Virtual Chassis Member Switch.

show interfaces gr-2/0/10 for GRE IPv6 tunnel

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced before Junos OS Release 17.3R1.