Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show interfaces vlan

Syntax

Description

Display status information about routed VLAN interfaces (RVIs).

Options

vlan | vlan.vlan-id

Display status information for the specified RVI.

brief | detail | extensive | terse

(Optional) Display the specified level of output.

descriptions

(Optional) Display interface description strings.

media

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

routing-instance (all | instance-name)

(Optional) Associate this RVI with the named routing instance.

snmp-index snmp-index

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

statistics

(Optional) Display static interface statistics.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show interfaces vlan command. Output fields are listed in the approximate order in which they appear. The level of output none means the basic command with no optional options—that is, either just show interfaces vlan or show interfaces vlan.vlan-id.

Table 1: show interfaces vlan Output Fields

Field Name

Field Description

Level of Output

Physical Interface  

Physical interface

Name of the physical interface, which is always vlan.

All levels

Enabled

State of the interface: Enabled or Disabled, followed by the statement Physical link is <Up/Down>

All levels

Interface index

Index number of the physical interface, 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

Because this is routed VLAN interface information, this entry is always VLAN.

detail extensive none

Link-level type

Encapsulation (added control information) being used on the physical interface. Because this is routed VLAN interface information, this entry is always VLAN.

All levels

MTU

Maximum transmission unit (MTU) size on the physical interface. The default MTU size depends on the switch platform. Changing either the media MTU or protocol MTU causes an interface to be deleted and added again.

All levels

Clocking

Value is always Unspecified—not applicable on switches.

detail extensive

Speed

Speed of the interface, either Auto if autonegotiation of speed is enabled or a number representing the configured speed in megabits per second.

detail extensive none

Device flags

Information about the physical device such as:Dest-route-down—The routing process detected that the link was not operational and changed the interface routes to nonforwarding status. Down—Device has been administratively disabled. Hear-Own-Xmit—Device receives its own transmissions. Is-Default—This address is the default address of the switch. The default address is used as the source address by SNMP, ping, traceroute, and other network utilities.Is-Preferred—This address is the default local address for packets originating from the local switch and sent to destinations on the subnet. Is-Primary—This address is the default local address for broadcast and multicast packets originated locally and sent out the interface.Link-Layer-Down—The link-layer protocol has failed to connect with the remote endpoint. Loopback—Switch is in physical loopback. Loop-Detected—The link layer has received frames that it sent, thereby detecting a physical loopback. No-Carrier—On media that support carrier recognition, no carrier is currently detected. No-Multicast—Device does not support multicast traffic. Preferred—This address is a candidate to become the preferred address. Present—Device is physically present and recognized. Promiscuous—Device is in promiscuous mode and recognizes frames addressed to all physical addresses on the media. Primary—This address is a candidate to become the primary address. Quench—Transmission on the device is quenched, because the output buffer is overflowing Recv-All-Multicasts—Device is in multicast promiscuous mode and therefore provides no multicast filtering. Running—Device is active and enabled.

detail extensive none

Link type

Link mode of the interface—Auto if autonegotiation is enabled, or the configured Full-Duplex or Half-Duplex.

detail extensive none

Link flags

Value is always None—not applicable on switches.

detail extensive none

Physical Info

Value is always Unspecified—not applicable on switches.

detail extensive

Hold-times

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

detail extensive

Current address

MAC address of the hardware.

detail extensive none

Hardware address

MAC address of the switch.

detail extensive none

Alternate link address

Value is always Unspecified—not applicable on switches.

detail extensive

Last flapped

Date, time, and how long ago the interface went from down to up. The format is Last flapped: year-month-day hour:minute:second timezone (hour:minute:second ago). For example, Last flapped: 2008–01–16 10:52:40 UTC (3d 22:58 ago). The entry can also be Never.

detail extensive none

Statistics last cleared

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

detail extensive none

Traffic statistics

Number and rate of bytes and packets transmitted or received on the physical interface for supported switches.

  • Input bytes—Number of bytes received on the interface for this switch. This value reflects the information gathered by the automatic ingress counter on EX3200 switches and EX4200 switches. EX8200 switches can also be configured to collect this information with the command l3-interface-ingress-counting.

  • Output bytes—Number of bytes sent on the interface. This value reflects the information gathered by the automatic egress counter for EX8200 switches.

  • Input packets—Number of packets received on the interface for this switch. This value reflects the information gathered by the automatic ingress counter for EX3200 and EX4200 switches. EX8200 switches can also be configured to collect this information with the command l3-interface-ingress-counting.

  • Output packets—Number of packets sent on the interface. This value reflects the information gathered by the automatic egress counter for EX8200 switches.

detail extensive

IPv6 transit statistics

Number and rate of bytes and packets transmitted and/or received on the IPv6 interface for supported switches.

  • Input bytes—Number of bytes received on the interface. This value reflects the information gathered by the automatic ingress counter for EX3200 and EX4200 switches. EX8200 switches can also be configured to collect this information with the command l3-interface-ingress-counting.

  • Output bytes—Number of bytes sent on the IPv6 interface. This value reflects the information gathered by the automatic egress counter for EX8200 switches.

  • Input packets—Number of packets received on the interface. This value reflects the information gathered by the automatic ingress counter for EX3200 and EX4200 switches. EX8200 switches can also be configured to collect this information with the command l3-interface-ingress-counting.

  • Output packets—Number of packets sent on the IPv6 interface. This value reflects the information gathered by the automatic egress counter for and EX8200 switches.

detail extensive

Input Errors

Input errors on the interface. The following paragraphs explain some of the counters whose meaning may not be obvious.

  • Errors—Sum of the incoming frame terminated and FCS errors.

  • Drops—Number of packets dropped by the input queue of the I/O Manager ASIC. If the interface is saturated, this value increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Framing errors—Number of packets received with an invalid frame checksum (FCS).

  • Runts—Number of frames received that are smaller than the runt threshold.

  • Policed discards—Number of frames that the incoming packet match code discarded because they were not recognized or not of interest. Usually, this field reports protocols that Junos OS does not handle.

  • L3 incompletes—Number of incoming packets discarded because they failed Layer 3 sanity checks of the headers. For example, a frame with less than 20 bytes of available IP header is discarded.

  • L2 channel errors—Number of times the software did not find a valid logical interface for an incoming frame.

  • L2 mismatch timeouts—Number of malformed or short packets that caused the incoming packet handler to discard the frame as unreadable.

  • FIFO errors—Number of FIFO errors in the receive direction that are reported by the ASIC. If this value is ever nonzero, the interface is probably malfunctioning.

  • Resource errors—Sum of transmit drops.

extensive

Output errors

Output errors on the interface. The following paragraphs explain the counters whose meaning might not be obvious:

  • Carrier transitions—Number of times the interface has gone from down to up. This value does not normally increment quickly, increasing only when the cable is unplugged, the far-end system is powered down and then up, or another problem occurs. If the number of carrier transitions increments quickly (perhaps once every 10 seconds), the cable, the far-end system, or the interface is malfunctioning.

  • Errors—Sum of the outgoing frame terminated and FCS errors.

  • Drops—Number of packets dropped by the output queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Collisions—Number of Ethernet collisions. Both Gigabit Ethernet interfaces and 10 Gigabit Ethernet interfaces support only full-duplex operation, so for those two interfaces, this value should always be zero. If the value is nonzero for either Gigabit Ethernet or 10 Gigabit Ethernet, there is a software bug.

  • Aged packets—Number of packets that remained in shared packet SDRAM so long that the system automatically purged them. The value in this field should never increment. If it does, it is most likely a software bug or possibly malfunctioning hardware.

  • FIFO errors—Number of FIFO errors in the send direction as reported by the ASIC on the interface. If this value is ever nonzero, the interface is probably malfunctioning.

  • HS link CRC errors—Number of errors on the high-speed links between the ASICs responsible for handling the switch interfaces.

  • MTU errors—Number of packets whose size exceeded the MTU of the interface.

  • Resource errors—Sum of transmit drops.

extensive

Logical Interface  

vlan.vlan-id, Index, SNMP ifIndex

VLAN ID, index, and SNMP index number for the logical interface. The logical interface index values reflect the item’s initialization sequence.

detail extensive none

Generation

Unique number for Juniper Networks Technical support use only.

detail extensive none

Flags

Errors that have occurred on this interface, such as Link Layer Down. Other possible flags include:

  • Device-down—Device has been administratively disabled.

  • Disabled—Interface is administratively disabled.

  • Down—A hardware failure has occurred.

  • Hardware-Down—Interface protocol initialization failed to complete successfully.

  • SNMP-Traps—SNMP trap notifications are enabled.

  • Up—Interface is enabled and operational.

detail extensive none

SNMP-Traps

Each configured SNMP trap has a number that appears here—0x0 is always displayed for logical interface SNMP traps.

detail extensive none

Encapsulation

Encapsulation method, which is the process of adding control information. The value is always Ethernet 2 (ENET2) for logical encapsulation.

detail extensive none

Traffic statistics

Number and rate of bytes and packets received and transmitted on the logical interface of supported switches. Traffic statistics represent the sum of the next two fields, Local statistics and Transit statistics. Note that these are not the values for the RVI ingress or egress counters—for that value, see Transit statistics below.

  • Input bytes—Number of bytes received on the interface. Same value as the physical interface.

  • Output bytes—Number of bytes sent on the interface. Same value as the physical interface.

  • Input packets—Number of packets received on the interface. Same value as the physical interface.

  • Output packets—Number of bytes sent on the interface. Same value as the physical interface.

Note:

The bandwidth bps counter is not enabled on the switches.

detail extensive

Local statistics

Number and rate of bytes and packets received and transmitted locally by the Routing Engine on the logical interface of supported switches. All packets for protocols and process statistics are counted here.

  • Input bytes—Number of bytes received on the interface. Same value as for the physical interface.

  • Output bytes—Number of bytes sent on the interface. Same value as for the physical interface.

  • Input packets—Number of packets received on the interface. Same value as for the physical interface.

  • Output packets—Number of bytes sent on the interface. Same value as for the physical interface.

detail extensive none

Transit statistics

Number and rate of bytes and packets received and transmitted on the RVI logical interface of supported switches. Look at this value to see the RVI ingress and egress count.

  • Input bytes—Number of bytes received on the interface. This ingress counter is automatic for EX3200 and EX4200 switches and configurable for EX8200 switches.

  • Output bytes—Number of bytes sent on the interface. This egress counter is automatic for EX8200.

  • Input packets—Number of packets received on the interface. This ingress counter is automatic for EX3200 and EX4200 switches and configurable for EX8200 switches.

  • Output packets—Number of packets sent on the interface. This egress counter is automatic for EX8200 switches.

detail extensive

IPv6 transit statistics

Number and rate of IPv6 bytes and packets received and transmitted on the RVI logical interface of supported switches. Transit values are unique to the logical interface and do not appear in physical interface output. Look at the values listed below to see the RVI ingress and egress count for IPv6 traffic.

  • Input bytes—Number of bytes received on the interface. This ingress counter is automatic for EX3200 and EX4200 switches and configurable for EX8200 switches.

  • Output bytes—Number of bytes sent by the interface. This egress counter is automatic for EX8200 switches.

  • Input packets—Number of packets received on the interface. This ingress counter is automatic for EX3200 and EX4200 and configurable for EX8200 switches.

  • Output packets—Number of packets sent by the interface. This egress counter is automatic for EX8200 switches.

Note:

The bandwidth bps counter is not enabled on the switches.

detail extensive

Protocol

Protocol used for the logical interface—this value is inet for IPv4 traffic and inet6 for IPv6 traffic.

All levels

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Route table

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

detail extensive none

Protocol flags

Information about the protocol such as Targeted-broadcast.

detail extensive none

Protocol addresses and Address flags

Protocol address values here can be:Dest-route-down—The routing process detected that the link was not operational and changed the interface routes to nonforwarding status Device-down—Device has been administratively disabled. Disabled—Interface is administratively disabled. Down—A hardware failure has occurred. Hardware-Down—Interface protocol initialization failed to complete successfully. Is-Default—This address is the default address of the switch. The default address is used as the source address by SNMP, ping, traceroute, and other network utilities.Is-Preferred—This address is the default local address for packets originating from the local switch and sent to destinations on the subnet. Is-Primary—This address is the default local address for broadcast and multicast packets originated locally and sent out the interface.Preferred—This address is a candidate to become the preferred address. Primary—This address is a candidate to become the primary address.

SNMP-Traps—SNMP trap notifications are enabled. Up—Interface is enabled and operational.

detail extensive none

Address destination

Logical destination’s network address.

detail extensive none

Local address

IP address of the logical interface.

detail extensive none

Broadcast address

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 vlan

show interfaces vlan terse

show interfaces vlan extensive

show interfaces vlan detail

Release Information

Command introduced in Junos OS Release 9.0.