Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show multicast route

Syntax

Syntax (EX Series Switch and the QFX Series)

Description

Display the entries in the IP multicast forwarding table. You can display similar information with the show route table inet.1 command.

Note:

On all SRX Series Firewalls, when a multicast route is not available, pending sessions are not torn down, and subsequent packets are queued. If no multicast route resolve comes back, then the traffic flow has to wait for the pending session to timed out. Then packets can trigger new pending session create and route resolve.

Options

none

Display standard information about all entries in the multicast forwarding table for all routing instances.

brief | detail | extensive | summary

(Optional) Display the specified level of output.

active | all | inactive

(Optional) Display all active entries, all entries, or all inactive entries, respectively, in the multicast forwarding table.

display-origin-protocol

(Optional) Display originating protocol instead of upstream protocol.

display-tunnel-name

(Optional) Display provider tunnel name instead of branch information.

group group

(Optional) Display the cache entries for a particular group.

inet | inet6

(Optional) Display multicast forwarding table entries for IPv4 or IPv6 family addresses, respectively.

instance instance-name

(Optional) Display entries in the multicast forwarding table for a specific multicast instance.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

oif-count

(Optional) Display a count of outgoing interfaces rather than listing them.

regular-expression

(Optional) Display information about the multicast forwarding table entries that match a UNIX OS-style regular expression.

source-prefix source-prefix

(Optional) Display the cache entries for a particular source prefix.

Required Privilege Level

view

Output Fields

Table 1 describes the output fields for the show multicast route command. Output fields are listed in the approximate order in which they appear.

Table 1: show multicast route Output Fields

Field Name

Field Description

Level of Output

Instance

Name of the routing instance.

summary extensive

family

IPv4 address family (INET) or IPv6 address family (INET6).

All levels

Group

Group address.

For any-source multicast routes, for example for bidirectional PIM, the group address includes the prefix length.

All levels

Source

Prefix and length of the source as it is in the multicast forwarding table.

All levels

Incoming interface list

List of interfaces that accept incoming traffic. Only shown for routes that do not use strict RPF-based forwarding, for example for bidirectional PIM.

All levels

Upstream interface

Name of the interface on which the packet with this source prefix is expected to arrive.

All levels

Upstream rpf interface list

When multicast-only fast reroute (MoFRR) is enabled, a PIM router propagates join messages on two upstream RPF interfaces to receive multicast traffic on both links for the same join request.

All levels

Downstream interface list

List of interface names to which the packet with this source prefix is forwarded.

distributed-gmp

Added in Junos OS Release 17.4R1 to indicate that line cards with distributed IGMP interfaces are receiving multicast traffic for a given (s,g).

All levels

Number of outgoing interfaces

Total number of outgoing interfaces for each (S,G) entry.

extensive

Session description

Name of the multicast session.

detail extensive

Statistics

Rate at which packets are being forwarded for this source and group entry (in KBps and pps), and number of packets that have been forwarded to this prefix. If one or more of the kilobytes per second packet forwarding statistic queries fails or times out, the statistics field displays Forwarding statistics are not available.

Note:

On QFX Series switches and OCX Series switches, this field does not report valid statistics.

EX4300 Series switches don’t report valid multicast statistics.

detail extensive

Next-hop ID

Next-hop identifier of the prefix. The identifier is returned by the routing device’s Packet Forwarding Engine and is also displayed in the output of the show multicast nexthops command.

detail extensive

Incoming interface list ID

For bidirectional PIM, incoming interface list identifier.

Identifiers for interfaces that accept incoming traffic. Only shown for routes that do not use strict RPF-based forwarding, for example for bidirectional PIM.

detail extensive

Upstream protocol

The protocol that maintains the active multicast forwarding route for this group or source.

When the show multicast route extensive command is used with the display-origin-protocol option, the field name is only Protocol and not Upstream Protocol. However, this field also displays the protocol that installed the active route.

detail extensive

Route type

Type of multicast route. Values can be (S,G) or (*,G).

summary

Route state

Whether the group is Active or Inactive.

summary extensive

Route count

Number of multicast routes.

summary

Forwarding state

Whether the prefix is pruned or forwarding.

extensive

Cache lifetime/timeout

Number of seconds until the prefix is removed from the multicast forwarding table. A value of never indicates a permanent forwarding entry. A value of forever indicates routes that do not have keepalive times.

extensive

Wrong incoming interface notifications

Number of times that the upstream interface was not available.

extensive

Uptime

Time since the creation of a multicast route.

extensive

Sensor ID

Sensor ID corresponding to multicast route.

extensive

Sample Output

Starting in Junos OS Release16.1, show multicast route displays the top-level hierarchical next hop.

show multicast route

show multicast route (Bidirectional PIM)

show multicast route brief

The output for the show multicast route brief command is identical to that for the show multicast route command. For sample output, see show multicast route or show multicast route (Bidirectional PIM).

show multicast route summary

show multicast route detail

show multicast route extensive (BGP Multicast)

show multicast route extensive (sender based RPF MoFRR)

Note:

Session Status: Up & Forwarding indicates that the specific session is the current forwarding path.

show multicast route extensive (Bidirectional PIM)

show multicast route extensive (PIM using point-to-multipoint mode)

show multicast route extensive (traffic counters)

show multicast route instance <instance-name> extensive

show multicast route extensive (PIM NSR support for VXLAN on primary Routing Engine)

show multicast route extensive (PIM NSR support for VXLAN on backup Routing Engine)

show multicast route extensive (PIM NSR support for VXLAN on backup Routing Engine)

show multicast route extensive (Junos OS Evolved)

Release Information

Command introduced before Junos OS Release 7.4.

inet6 and instance options introduced in Junos OS Release 10.0 for EX Series switches.

Support for bidirectional PIM added in Junos OS Release 12.1.

oif-count option introduced in Junos OS Release 16.1 for the MX Series.

Support for PIM NSR support for VXLAN added in Junos OS Release 16.2.

Support for multicast traffic counters added in Junos OS 19.2R1 for EX4300 switches.