Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    show interfaces vlan

    Syntax

    show interfaces (vlan | vlan.vlan-id)<brief | detail | extensive | terse> <descriptions> <media><routing-instance (all | instance-name)><snmp-index snmp-index><statistics>

    Release Information

    Command introduced in Junos OS Release 9.0 for EX Series switches.

    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

    List of Sample Output

    show interfaces vlan
    show interfaces vlan terse
    show interfaces vlan extensive
    show interfaces vlan detail

    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 aborts 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 aborts 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

    user@switch> show interfaces vlan
    Physical interface: vlan, Enabled, Physical link is Up
      Interface index: 150, SNMP ifIndex: 556
      Type: VLAN, Link-level type: VLAN, MTU: 1518, Speed: 1000mbps
      Device flags   : Present Running
      Link type      : Full-Duplex
      Link flags     : None
      Current address: 00:21:59:c5:f0:40, Hardware address: 00:21:59:c5:f0:40
      Last flapped   : Never
        Input packets : 0
        Output packets: 0
    
      Logical interface vlan.0 (Index 82) (SNMP ifIndex 557)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Input packets : 0
        Output packets: 1
        Protocol inet
          Flags: Targeted-broadcast
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.1.1/24, Local: 10.1.1.1, Broadcast: 10.1.1.255
    
      Logical interface vlan.1 (Index 83) (SNMP ifIndex 558)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Input packets : 0
        Output packets: 1
        Protocol inet
          Flags: Targeted-broadcast
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.1.2/24, Local: 10.1.2.1, Broadcast: 10.1.2.255

    show interfaces vlan terse

    user@switch> show interfaces vlan terse
    Interface               Admin Link Proto    Local                 Remote
    vlan                    up    up
    vlan.0                  up    down inet     10.1.1.1/24
    vlan.1                  up    down inet     10.1.2.1/24
    

    show interfaces vlan extensive

    user@switch> show interfaces vlan extensive
    Physical interface: vlan, Enabled, Physical link is Up
      Interface index: 150, SNMP ifIndex: 556, Generation: 153
      Type: VLAN, Link-level type: VLAN, MTU: 1518, Clocking: Unspecified,
      Speed: 1000mbps
      Device flags   : Present Running
      Link type      : Full-Duplex
      Link flags     : None
      Physical info  : Unspecified
      Hold-times     : Up 0 ms, Down 0 ms
      Current address: 00:21:59:c5:f0:40, Hardware address: 00:21:59:c5:f0:40
      Alternate link address: Unspecified
      Last flapped   : Never
      Statistics last cleared: Never
      Traffic statistics:
       Input  bytes  :                    0
       Output bytes  :                    0
       Input  packets:                    0
       Output packets:                    0
       IPv6 transit statistics:
        Input  bytes  :                   0
        Output bytes  :                   0
        Input  packets:                   0
        Output packets:                   0
      Input errors:
        Errors: 0, Drops: 0, Framing errors: 0, Runts: 0, Giants: 0,
        Policed discards: 0, Resource errors: 0
      Output errors:
        Carrier transitions: 0, Errors: 0, Drops: 0, MTU errors: 0,
        Resource errors: 0
    
      Logical interface vlan.0 (Index 82) (SNMP ifIndex 557) (Generation 147)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
         Output packets:                    0                    0 pps
        Protocol inet, Generation: 159, Route table: 0
          Flags: Targeted-broadcast
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.1.1/24, Local: 10.1.1.1, Broadcast: 10.1.1.255,
            Generation: 138
    
      Logical interface vlan.1 (Index 83) (SNMP ifIndex 558) (Generation 148)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
        Output packets:                    0                    0 pps
       Protocol inet, Generation: 160, Route table: 0
         Flags: Targeted-broadcast
         Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
           Destination: 10.1.2/24, Local: 10.1.2.1, Broadcast: 10.1.2.255,
           Generation: 140
       

    show interfaces vlan detail

    user@switch> show interfaces vlan detail
    Physical interface: vlan, Enabled, Physical link is Up
      Interface index: 150, SNMP ifIndex: 556, Generation: 153
      Type: VLAN, Link-level type: VLAN, MTU: 1518, Clocking: Unspecified,
      Speed: 1000mbps
      Device flags   : Present Running
      Link type      : Full-Duplex
      Link flags     : None
      Physical info  : Unspecified
      Hold-times     : Up 0 ms, Down 0 ms
      Current address: 00:21:59:c5:f0:40, Hardware address: 00:21:59:c5:f0:40
      Alternate link address: Unspecified
      Last flapped   : Never
      Statistics last cleared: Never
      Traffic statistics:
       Input  bytes  :                    0
       Output bytes  :                    0
       Input  packets:                    0
       Output packets:                    0
       IPv6 transit statistics:
        Input  bytes  :                   0
        Output bytes  :                   0
        Input  packets:                   0
        Output packets:                   0
    
      Logical interface vlan.0 (Index 82) (SNMP ifIndex 557) (Generation 147)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
         Output packets:                    0                    0 pps
        Protocol inet, Generation: 159, Route table: 0
          Flags: Targeted-broadcast
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.1.1/24, Local: 10.1.1.1, Broadcast: 10.1.1.255,
            Generation: 138
    
      Logical interface vlan.1 (Index 83) (SNMP ifIndex 558) (Generation 148)
        Flags: Link-Layer-Down SNMP-Traps 0x0 Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :                   42
         Input  packets:                    0
         Output packets:                    1
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
         Output packets:                    0                    0 pps
        Protocol inet, Generation: 160, Route table: 0
          Flags: Targeted-broadcast
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.1.2/24, Local: 10.1.2.1, Broadcast: 10.1.2.255,
            Generation: 140

    Published: 2012-12-07