show multicast route
Syntax
show multicast route <brief | detail | extensive | summary> <active | all | inactive> <display-origin-protocol> <display-tunnel-name> <group group> <inet | inet6> <instance instance name> <logical-system (all | logical-system-name)> <oif-count> <regular-expression> <source-prefix source-prefix>
Syntax (EX Series Switch and the QFX Series)
show multicast route <brief | detail | extensive | summary> <active | all | inactive> <group group> <inet | inet6> <instance 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.
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.
Field Name |
Field Description |
Level of Output |
||
|---|---|---|---|---|
Instance |
Name of the routing instance. |
|
||
family |
IPv4 address family ( |
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.
|
All levels |
||
Number of outgoing interfaces |
Total number of outgoing interfaces for each (S,G) entry. |
|
||
Session description |
Name of the multicast session. |
|
||
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 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. |
|
||
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 |
|
||
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. |
|
||
Upstream protocol |
The protocol that maintains the active multicast forwarding route for this group or source. When the |
|
||
Route type |
Type of multicast route. Values can be (S,G) or (*,G). |
|
||
Route state |
Whether the group is |
|
||
Route count |
Number of multicast routes. |
|
||
Forwarding state |
Whether the prefix is pruned or forwarding. |
|
||
Cache lifetime/timeout |
Number of seconds until the prefix is removed from the
multicast forwarding table. A value of |
|
||
Wrong incoming interface notifications |
Number of times that the upstream interface was not available. |
|
||
Uptime |
Time since the creation of a multicast route. |
|
||
Sensor ID |
Sensor ID corresponding to multicast route. |
|
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
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: INET6show multicast route (Bidirectional PIM)
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: INET6show 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
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
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: INET6show multicast route extensive (BGP Multicast)
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)
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
Session Status: Up & Forwarding
indicates that the specific session is the current forwarding path.
show multicast route extensive (Bidirectional PIM)
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)
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)
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
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)
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)
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)
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)
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.