Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

show interfaces (Multilink Services)

Syntax

show interfaces ml-fpc/pic/port<brief | detail | extensive | terse> <descriptions><media><snmp-index><statistics>

Release Information

Command introduced before Junos OS Release 7.4.

Description

(M Series and T Series routers only) Display status information about the specified multilink services interface.

Options

ml-fpc/pic/port

Display standard status information about the specified multilink services interface.

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.

snmp-index

(Optional) Display the SNMP index of interface.

statistics

(Optional) Display static interface statistics.

Required Privilege Level

view

List of Sample Output

show interfaces extensive (Multilink Services)

Output Fields

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

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

Link-level type

Encapsulation being used on the physical interface: Multilink.

All levels

MTU

MTU size on the physical interface.

All levels

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

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: 2002-04-26 10:52:40 PDT (04:33:20 ago).

detail extensive none

Statistics last cleared

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

detail extensive

Traffic statistics

Number and rate of bytes and packets received and transmitted on the physical interface. All references to traffic direction (input or output) are defined with respect to the router. Input fragments received by the router are assembled into input packets; output packets are segmented into output fragments for transmission out of the router.

detail extensive

Frame exceptions

Information about framing exceptions. Includes events recorded under Exception Events for each logical interface:

  • Oversized frames—Number of frames received that exceed maximum frame length. Maximum length is 4500 Kb (kilobits).
  • Errored input frames—Number of input frame errors.
  • Input on disabled link/bundle—Number of frames received on disabled links. These can result either from an inconsistent configuration, or from a bundle or link being brought up or down with traffic actively flowing through it.
  • Output for disabled link/bundle—Number of frames sent for a disabled or unavailable link. These can result either from an inconsistent configuration, or from a bundle being brought up or down with traffic actively flowing through it.
  • Queuing drops—Total number of packets dropped before traffic enters the link services IQ interface. Indicates that the interface is becoming oversubscribed.

extensive

Buffering exceptions

Information about buffering exceptions. Includes events recorded under Exception Events for each logical interface:

  • Packet data buffer overflow—Packet buffer memory is full. This overflow can occur when the aggregate data rate exceeds the physical multilink services interface capacity.
  • Fragment data buffer overflow—Fragment buffer memory is full. This overflow can occur when excessive differential delay is experienced across the links within a single bundle, or when the aggregate data rate exceeds the physical multilink services interface capacity. Check the logical interface exception event counters to determine which bundle is responsible.

extensive

Assembly exceptions

Information about assembly exceptions. Includes events recorded under Exception Events for each logical interface.

An assembly exception does not necessarily indicate an operational problem with the Multilink PIC itself. If multilink-encapsulated traffic is dropped or reordered after a sequence number has been assigned, the assembling multilink interface records one or more exception events. The multilink interface can drop multilink-encapsulated fragments itself as a result. Any multilink packets or fragments dropped by the Multilink PIC itself result in packet or fragment drop counts on individual logical interfaces. If the logical interface drop counts are zero, but exception events are seen, the most likely cause is a problem with the individual link interfaces. Even if the logical interface fragment drop counts are nonzero, excess differential delay or traffic losses on individual interfaces can be the root cause.

  • Fragment timeout—Drop-timer expired while a fragment sequence number was outstanding. Occurs only if drop-timer is enabled. This can occur if the differential delay across the links in a bundle exceeds the drop-timer setting, or if a multilink packet is lost in transit while the drop timer is enabled. These events do not necessarily indicate any problem with the operation of the Multilink PIC itself. If one or more individual links drop traffic, these events can occur. Check the logical interface exception event counters to determine which bundle is responsible.
  • Missing sequence number—A gap was detected in the sequence numbers of fragments on a bundle. These events do not necessarily indicate any problem with the operation of the Multilink PIC itself. If one or more individual links drop traffic, these events can occur. Check the logical interface exception event counters to determine which bundle is responsible.
  • Out-of-order sequence number—Two frames with out-of-order sequence numbers occurred within a single link. This event indicates that an individual link within a bundle reordered traffic, making the multilink interface unable to correctly process the resulting stream. Check the logical interface exception event counters to determine which bundle is responsible.
  • Out-of-range sequence number—Frame was received with out-of-range sequence number. These events can occur when a large amount of multilink-encapsulated traffic is lost, or the multilink peer is reset, so that a large jump in sequence numbers results. A small number of these events can occur when the far end of a bundle is taken down or brought up. Check the logical interface exception event counters to determine which bundle is responsible.

extensive

Hardware errors

Information about hardware errors:

  • Data memory error—A memory error was detected on the interface DRAM. Indicates possible hardware failure. Contact Juniper Networks technical support.
  • Control memory error—A memory error was detected on the interface DRAM. Indicates possible hardware failure. Contact Juniper Networks technical support.

extensive

Logical Interface 

Logical interface

Logical interface name.

All levels

Index

Logical interface index number, which reflects its initialization sequence.

detail extensive none

SNMP ifIndex

SNMP interface index number.

detail extensive none

Encapsulation

Encapsulation being used: PPP or Multilink PPP.

All levels

Bandwidth

Speed at which the interface is running.

All levels

Flags

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

detail extensive none

Bundle options

Information about configured bundle options:

  • MRRU—Configured size of the MRRU (maximum received reconstructed unit). It can be 1500 to 4500 bytes.
  • Drop timer period—Configured drop timeout period. It can be 0 through 127 ms. A value of 0 disables the timer. The default setting is 0.
  • Sequence number format—Configured size of the sequence header: 12 or 24 bits. The default is 24 bits.
  • Fragmentation threshold—Configured fragmentation threshold. A value of 0 results in no fragmentation. Nonzero values can be 128 through 16,320 bytes, in integer multiples of 64 bytes. The default is 0.
  • Links needed to sustain bundle—Minimum number of links to sustain the bundle: 1 through 8.

detail extensive none

Bundle status (MLPPP) or Multilink class status (MC-MLPPP)

Information about bundle status:

  • Remote MRRU—MRRU value received from remote peer. If negotiation has not been initiated, the default value is displayed.
  • Received sequence number—Sequence number for received packets.
  • Transmitted sequence number—Sequence number for transmitted packets.
  • Packet drops—Number and byte count of output packets that were dropped, rather than being encapsulated and sent out of the router as fragments. The packet drop counter is incremented if there is a temporary shortage of packet memory on the AS PIC, which causes packet fragmentation to fail.
  • Fragment drops—Number and byte count of input fragments that were dropped, rather than being reassembled and handled by the router as packets. This counter also includes fragments that have been received successfully but had to be dropped because not all fragments that constituted a packet had been received. The fragment drop counter is incremented when a fragment received on constituent links is dropped. Drop fragments can be triggered by sequence ordering errors, duplicate fragments, timed-out fragments, and bad multilink headers.
  • MRRU exceeded—Number of reassembled packets exceeding the MRRU. This counter is not implemented in this release.
  • Fragment timeout—Drop timer expired while a fragment sequence number was outstanding. Occurs only if the drop timer is enabled. This timeout can occur if the differential delay across the links in a bundle exceeds the drop-timer setting, or if a multilink packet is lost in transit while the drop timer is enabled.
  • Missing sequence number—Gap detected in the sequence numbers of fragments on a bundle.
  • Out-of-order sequence number—Two frames with out-of-order sequence numbers within a single link. This event indicates that an individual link within a bundle reordered traffic, making the multilink interface unable to correctly process the resulting stream.
  • Out-of-range sequence number—Frame with an out-of-range sequence number. These events can occur when a large amount of multilink-encapsulated traffic is lost or the multilink peer is reset, so that a large jump in sequence numbers results. A small number of these events can occur when the far end of a bundle is taken down or brought up.
  • Packet data buffer overflow—Packet buffer memory full. This overflow can occur when the aggregate data rate exceeds the physical link services IQ interface capacity.
  • Fragment data buffer overflow—Fragment buffer memory full. This overflow can occur when excessive differential delay is experienced across the links within a single bundle, or when the aggregate data rate exceeds the physical link services IQ capacity.

detail extensive

Remote MRRU

MRRU value received from remote peer. If negotiation has not been initiated, the default value is displayed.

detail extensive none

Bundle errors

Information about bundle errors:

  • Packet drops—Number and byte count of output packets dropped, rather than being encapsulated and sent out of the router as fragments.
  • Fragment drops—Number and byte count of input fragments dropped, rather than being reassembled and handled by the router as packets.
  • MRRU exceeded—Number of reassembled packets exceeding the MRRU.
  • Exception events—Number of exceptional events encountered while handling traffic on the bundle, other than MRRU exceeded errors. These events are categorized under the physical interface: Frame exceptions, Buffering exceptions, and Fragment exceptions. Exception events do not necessarily indicate that the multilink interface is not operating properly. Individual link failures can produce exceptional events.

detail extensive

Statistics

Information about fragments and packets received and sent by the router. All references to traffic direction (input or output) are defined with respect to the router. Input fragments received by the router are assembled into input packets; output packets are segmented into output fragments for transmission out of the router.

  • Bundle—Information about bundles.
  • Link—Information about links used in the multilink operation.

detail extensive

Protocol

Protocol family configured on the logical interface.

detail extensive none

MTU

MTU size on the logical interface. If the MTU value is negotiated down to meet the MRRU requirement on the remote side, this value is marked Adjusted.

detail extensive none

Flags

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

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Route table

Route table in which this address exists. For example, Route table:0 refers to inet.0.

detail extensive

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 on the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Sample Output

show interfaces extensive (Multilink Services)

user@host> show interfaces ml-0/3/0 extensive
Physical interface: ml-0/3/0, Enabled, Physical link is Up
  Interface index: 273, SNMP ifIndex: 196, Generation: 535
  Link-level type: Multilink, MTU: 4474
  Device flags   : Present Running
  Interface flags: Point-To-Point SNMP-Traps
  Last flapped   : 2002-04-25 14:21:34 PDT (21:06:59 ago)
  Statistics last cleared: Never
  Traffic statistics:
   Input  bytes  :                 3535                    0 bps
   Output bytes  :                 4135                    0 bps
   Input  packets:                   87                    0 pps
   Output packets:                  103                    0 pps
  Frame exceptions:
    Oversized frames                  0
    Errored input frames              0
    Input on disabled link/bundle     0
    Output for disabled link/bundle   0
    Queuing drops                     0
  Buffering exceptions:
    Packet data buffer overflow       0
    Fragment data buffer overflow     0
  Assembly exceptions:
    Fragment timeout                  0
    Missing sequence number           0
    Out-of-order sequence number      0
    Out-of-range sequence number      0
  Hardware errors (sticky):
    Data memory error                 0
    Control memory error              0

  Logical interface ml-0/3/0.1 (Index 110) (SNMP ifIndex 674) 
(Generation 402)
    Flags: Point-To-Point SNMP-Traps Encapsulation: Multilink-PPP
    Bandwidth: 12288kbps
    Bundle options:
      MRRU                            1524
      Drop timer period               0
      Sequence number format          long (24 bits)
      Fragmentation threshold         0
      Links needed to sustain bundle  1
    Bundle status:
      Remote MRRU                     1500
      Received sequence number        0x19ec14
      Transmit sequence number        0x38cfa8
      Packet drops                    0 (0 bytes)
      Fragment drops                  0 (0 bytes)
      MRRU exceeded                   0
      Fragment timeout                0
      Missing sequence number         0
      Out-of-order sequence number    0
      Out-of-range sequence number    0
      Packet data buffer overflow     0
      Fragment data buffer overflow   0
    Bundle errors:
      Packet drops                    0 (0 bytes)
      Fragment drops                  0 (0 bytes)
      MRRU exceeded                   0
      Exception events                0
    Statistics         Frames        fps         Bytes          bps
    Bundle:
      Fragments:
        Input :             5          0           450            0
        Output:             6          0           499            0
      Packets:
        Input :             5          0           450            0
        Output:            12          0          1202            0
    Link:
      t1-0/1/0:11.0
        Input :             1          0            90            0
        Output:             1          0            92            0
      t1-0/1/0:12.0
        Input :             1          0            90            0
        Output:             1          0            92            0
      t1-0/1/0:10.0
        Input :             1          0            90            0
        Output:             1          0            92            0
      t1-0/1/0:14.0
        Input :             1          0            90            0
        Output:             1          0            92            0
      t1-0/1/0:13.0
        Input :             1          0            90            0
        Output:             1          0            92            0
      t1-0/1/0:8.0
        Input :             0          0             0            0
        Output:             0          0             0            0
      t1-0/1/0:9.0
        Input :             0          0             0            0
        Output:             0          0             0            0
    Protocol inet, MTU: 1500 [Adjusted], Flags: Generation: 752 Route table: 0
      Addresses, Flags: Is-Preferred Is-Primary, MTU-Protocol-Adjusted
        Destination: 1.1.2.2, Local: 1.1.2.1, Broadcast: Unspecified,
        Generation: 1090
    Protocol iso, MTU: 1500 [Adjusted], Flags: Is-Primary, 
    Generation: 753 Route table: 0

Published: 2013-03-14

Supported Platforms

Published: 2013-03-14