close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

show multicast route

date_range 04-Oct-24

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
show multicast route
<brief | detail | extensive | summary>
<active | all | inactive>
<display-origin-protocol>
<display-tunnel-name>
<group group>
<inet | inet6>
<instance (all | instance name)>
<logical-system (all |  logical-system-name)>
<oif-count>
<regular-expression>
<source-prefix source-prefix>

Syntax (EX Series Switch and the QFX Series)

content_copy zoom_out_map
show multicast route
<brief | detail | extensive | summary>
<active | all | inactive>
<group group>
<inet | inet6>
<instance (all | instance name)>
<regular-expression>
<source-prefix source-prefix>

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 (all \| `instance-name`)	(Optional) Display entries in the multicast forwarding table for all multicast-enabled routing instances or 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.

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
show multicast route summary
show multicast route detail
show multicast route extensive (BGP Multicast)
show multicast route extensive (sender based RPF MoFRR)
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)

show multicast route

content_copy zoom_out_map
user@host> show multicast route  
Family: INET

Group: 233.252.0.0
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0

Group: 233.252.0.1
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0

Group: 233.252.0.1
    Source: 10.255.70.15/32
    Upstream interface: so-1/0/0.0
    Downstream interface list:
        mt-1/1/0.1081344

Family: INET6

show multicast route (Bidirectional PIM)

content_copy zoom_out_map
user@host> show multicast route  
Family: INET

Group: 233.252.0.1/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0
    Downstream interface list: 
        ge-0/0/1.0

Group: 233.252.0.3/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0 xe-4/1/0.0
    Downstream interface list: 
        ge-0/0/1.0

Group: 233.252.0.11/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0
    Downstream interface list: 
        ge-0/0/1.0

Group: 233.252.0.13/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0 xe-4/1/0.0
    Downstream interface list: 
        ge-0/0/1.0
Family: INET6

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

content_copy zoom_out_map
user@host>show multicast route summary  
Instance: master Family: INET

Route type   Route state    Route count
(S,G)             Active             2
(S,G)             Inactive           3

Instance: master Family: INET6

show multicast route detail

content_copy zoom_out_map
user@host> show multicast route detail  
Family: INET

Group: 233.252.0.0
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Unknown
    Statistics: 8 kBps, 100 pps, 45272 packets
    Next-hop ID: 262142
    Upstream protocol: PIM

Group: 233.252.0.1
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Administratively Scoped
    Statistics: 0 kBps, 0 pps, 13404 packets
    Next-hop ID: 262142
    Upstream protocol: PIM

Group: 233.252.0.1
    Source: 10.255.70.15/32
    Upstream interface: so-1/0/0.0
    Downstream interface list:
        mt-1/1/0.1081344
    Session description: Administratively Scoped
    Statistics: 46 kBps, 1000 pps, 921077 packets

    Next-hop ID: 262143
    Upstream protocol: PIM

Family: INET6

show multicast route extensive (BGP Multicast)

content_copy zoom_out_map
user@host> show multicast route extensive
Family: INET

Group: 225.1.1.1/32
    Source: 10.0.0.1
    Upstream interface: ge-2/1/0.0
    Downstream interface list:
        ge-2/1/1.1 ge-2/1/1.0
    Number of outgoing interfaces: 2
    Session description: Unknown
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 123456
    Upstream protocol: BGPMCAST
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0

show multicast route extensive (sender based RPF MoFRR)

content_copy zoom_out_map
user@host> show multicast route extensive  
Instance: BLACK Family: INET6

Group: 233.252.0.1
    Source: 101.1.1.2/32
    Upstream rpf interface list:
        vt-16/0/0.0 (P)
            Session Id: 0x16b Session Status: Up
            Min-rate: 4000 kbps Weight: 1
            Sender Id: Label 57
        vt-16/0/0.0 (B)
            Session Id: 0x167 Session Status: Up & Forwarding
            Min-rate: 4000 kbps Weight: 65533
            Sender Id: Label 53
    Downstream interface list:
        et-19/4/1.0
    Number of outgoing interfaces: 1
    Session description: NOB Cross media facilities
    Statistics: 1842 kBps, 16741 pps, 1250285 packets
    RPF Next-hop ID: 1039
    Next-hop ID: 1048588
    Upstream protocol: MVPN
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:01:15

Note:

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

show multicast route extensive (Bidirectional PIM)

content_copy zoom_out_map
user@host> show multicast route extensive  
Family: INET

Group: 233.252.0.1/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0
    Downstream interface list: 
        ge-0/0/1.0
    Number of outgoing interfaces: 1
    Session description: NOB Cross media facilities
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 2097153
    Incoming interface list ID: 585
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0

Group: 233.252.0.3/24
    Source: *
    Incoming interface list: 
        lo0.0 ge-0/0/1.0 xe-4/1/0.0
    Downstream interface list: 
        ge-0/0/1.0
    Number of outgoing interfaces: 1
    Session description: NOB Cross media facilities
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 2097153
    Incoming interface list ID: 589
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0

Family: INET6

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

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 225.0.0.1
    Source: 192.0.2.0/24 
    Upstream interface: st0.1
+   Upstream neighbor: 203.0.113.0/24
    Downstream interface list: 
+        st0.0-198.51.100.0 st0.0-198.51.100.1
    Session description: Unknown
    Statistics: 0 kBps, 1 pps, 119 packets
    Next-hop ID: 262142
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 0
    Uptime: 00:02:00

show multicast route extensive (traffic counters)

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 225.0.0.1
    Source: 192.0.2.0/24
    Upstream interface: ge-3/0/12.0
    Downstream interface list:
        ge-0/0/18.0 ge-0/0/7.0 ge-2/0/11.0 ge-2/0/7.0 ge-3/0/20.0 ge-3/0/21.0
    Number of outgoing interfaces: 6
    Session description: Unknown
    Statistics: 102 kBps, 801 pps, 5735 packets
    Next-hop ID: 131076
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 0
    Uptime: 00:03:57

show multicast route instance <instance-name> extensive

content_copy zoom_out_map
user@host> show multicast route instance mvpn extensive  
Family: INET
roup: 233.252.0.10
    Source: 10.0.0.2/32 
    Upstream interface: xe-0/0/0.102
    Downstream interface list: 
        xe-10/3/0.0 xe-0/3/0.0 xe-0/0/0.106 xe-0/0/0.105 
        xe-0/0/0.103 xe-0/0/0.104 xe-0/0/0.107 xe-0/0/0.108 
    Session description: Administratively Scoped
    Statistics: 256 kBps, 3998 pps, 670150 packets
    Next-hop ID: 1048579
    Upstream protocol: MVPN
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 58
    Uptime: 00:00:04

Instance: master Family: INET

Group: 225.0.0.1
    Source: 101.0.0.2/32
    Upstream interface: ge-2/2/0.101
    Downstream interface list: 
        distributed-gmp
    Number of outgoing interfaces: 1
    Session description: Unknown
    Statistics: 105 kBps, 2500 pps, 4153361 packets
    Next-hop ID: 1048575
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 0
    Uptime: 00:31:46

Group: 225.0.0.1
    Source: 101.0.0.3/32
    Upstream interface: ge-2/2/0.101
    Downstream interface list: 
        distributed-gmp
    Number of outgoing interfaces: 1
    Session description: Unknown
    Statistics: 105 kBps, 2500 pps, 4153289 packets
    Next-hop ID: 1048575
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 0
    Uptime: 00:31:46

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

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 233.252.0.1
    Source: 10.3.3.3/32
    Upstream interface: ge-3/1/2.0
    Downstream interface list: 
        -(593) 
    Number of outgoing interfaces: 1
    Session description: Organisational Local Scope
    Statistics: 0 kBps, 0 pps, 27 packets
    Next-hop ID: 1048576
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding (Forwarding state is set as 'Forwarding' in master RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:06:38

Group: 233.252.0.1
    Source: 10.2.1.4/32
    Upstream interface: local
    Downstream interface list: 
        ge-3/1/2.0
    Number of outgoing interfaces: 1
    Session description: Organisational Local Scope
    Statistics: 0 kBps, 0 pps, 86 packets
    Next-hop ID: 1048575
    Upstream protocol: PIM
    Route state: Active                 
    Forwarding state: Forwarding (Forwarding state is set as 'Forwarding' in master RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:07:45

Instance: master Family: INET6

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

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 233.252.0.1
    Source: 10.3.3.3/32
    Upstream interface: ge-3/1/2.0
    Number of outgoing interfaces: 0
    Session description: Organisational Local Scope
    Forwarding statistics are not available
    Next-hop ID: 0
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Pruned (Forwarding state is set as 'Pruned' in backup RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:06:46

Group: 233.252.0.1
    Source: 10.2.1.4/32
    Upstream interface: local
    Number of outgoing interfaces: 0
    Session description: Organisational Local Scope
    Forwarding statistics are not available
    Next-hop ID: 0
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Pruned  (Forwarding state is set as 'Pruned' in backup RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:07:54

Instance: master Family: INET6

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

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 233.252.0.1
    Source: 10.3.3.3/32
    Upstream interface: ge-3/1/2.0
    Downstream interface list: 
        -(593) 
    Number of outgoing interfaces: 1
    Session description: Organisational Local Scope
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 1048576
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding (Forwarding state is set as 'Forwarding' in backup RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:06:38

Group: 233.252.0.1
    Source: 10.2.1.4/32
    Upstream interface: local
    Downstream interface list: 
        ge-3/1/2.0
    Number of outgoing interfaces: 1
    Session description: Organisational Local Scope
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 1048575
    Upstream protocol: PIM
    Route state: Active                 
    Forwarding state: Forwarding (Forwarding state is set as 'Forwarding' in backup RE.)
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 00:07:45

Instance: master Family: INET6

show multicast route extensive (Junos OS Evolved)

content_copy zoom_out_map
user@host> show multicast route extensive
Instance: master Family: INET

Group: 232.255.255.100
    Source: 10.1.1.2/32
    Upstream interface: et-0/0/0:0.0
    Downstream interface list: 
        et-0/0/2:1.0 et-0/0/1:0.0
    Number of outgoing interfaces: 2
    Session description: Source specific multicast
    Statistics: 0 kBps, 0 pps, 0 packets
    Next-hop ID: 11066
    Upstream protocol: Multicast
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: forever
    Wrong incoming interface notifications: 0
    Uptime: 14:58:34
    Sensor ID: 0xf0000002

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.

arrow_backward PREVIOUS show multicast pim-to-mld-proxy

NEXT arrow_forward show multicast rpf

Junos CLI Reference

ON THIS PAGE

show multicast route

Syntax

Syntax (EX Series Switch and the QFX Series)

Description

Options

Required Privilege Level

Output Fields

Sample Output

show multicast route

show multicast route (Bidirectional PIM)

show multicast route brief

show multicast route summary

show multicast route detail

show multicast route extensive (BGP Multicast)

show multicast route extensive (sender based RPF MoFRR)

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

Stay in touch

Helped me install or use the product
Accelerated my deployment

Discuss the product with a co-worker
Make a purchase inquiry

Junos CLI Reference

ON THIS PAGE

show multicast route

Syntax

Syntax (EX Series Switch and the QFX Series)

Description

Options

Required Privilege Level

Output Fields

Sample Output

show multicast route

show multicast route (Bidirectional PIM)

show multicast route brief

show multicast route summary

show multicast route detail

show multicast route extensive (BGP Multicast)

show multicast route extensive (sender based RPF MoFRR)

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

Related Documentation

Stay in touch