Supported Platforms
show multicast route
List of Syntax
SyntaxSyntax (EX Series Switch and the QFX Series)
Syntax
Syntax (EX Series Switch and the QFX Series)
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced in Junos OS Release 9.0 for EX Series switches.
inet6 and instance options introduced in Junos OS Release 10.0 for EX Series switches.
Command introduced in Junos OS Release 11.3 for the QFX Series.
Support for bidirectional PIM added in Junos OS Release 12.1.
Description
Display the entries in the IP multicast forwarding table. You can display similar information with the show route table inet.1 command.
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. |
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. |
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
List of Sample Output
show multicast routeshow multicast route (Bidirectional PIM)
show multicast route brief
show multicast route detail
show multicast route extensive (Bidirectional PIM)
show multicast route instance <instance-name>
show multicast route summary
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 |
|---|---|---|
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 |
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. | 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, this field does not report valid 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 | Protocol running on the interface on which the packet with this source prefix is expected to arrive. | 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 |
Sample Output
show multicast route
user@host> show multicast route Family: INET
Group: 228.0.0.0
Source: 10.255.14.144/32
Upstream interface: local
Downstream interface list:
so-1/0/0.0
Group: 239.1.1.1
Source: 10.255.14.144/32
Upstream interface: local
Downstream interface list:
so-1/0/0.0
Group: 239.1.1.1
Source: 10.255.70.15/32
Upstream interface: so-1/0/0.0
Downstream interface list:
mt-1/1/0.49152
Family: INET6show multicast route (Bidirectional PIM)
user@host> show multicast route Family: INET
Group: 224.1.1.0/24
Source: *
Incoming interface list:
lo0.0 ge-0/0/1.0
Downstream interface list:
ge-0/0/1.0
Group: 224.1.3.0/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: 225.1.1.0/24
Source: *
Incoming interface list:
lo0.0 ge-0/0/1.0
Downstream interface list:
ge-0/0/1.0
Group: 225.1.3.0/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 detail
user@host> show multicast route detail Family: INET
Group: 228.0.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: 239.1.1.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: 239.1.1.1
Source: 10.255.70.15/32
Upstream interface: so-1/0/0.0
Downstream interface list:
mt-1/1/0.49152
Session description: Administratively Scoped
Statistics: 46 kBps, 1000 pps, 921077 packets
Next-hop ID: 262143
Upstream protocol: PIM
Family: INET6show multicast route extensive (Bidirectional PIM)
user@host> show multicast route extensive Family: INET
Group: 224.1.1.0/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: 224.1.3.0/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 instance <instance-name>
user@host> show multicast route instance v1
extensive Instance: v1 Family: INET
Group: 224.1.1.1
Source: (null)/0
Upstream interface: fe-1/3/0.111
Downstream interface list:
lt-0/3/0.42 lt-0/3/0.46 lt-0/3/0.43
Number of outgoing interfaces: 3
Group: 224.1.1.2
Source: (null)/0
Upstream interface: fe-1/3/0.111
Downstream interface list:
lt-0/3/0.42 lt-0/3/0.46 lt-0/3/0.43
Number of outgoing interfaces: 3
Group: 224.1.1.3
Source: (null)/0
Upstream interface: fe-1/3/0.111
Downstream interface list:
lt-0/3/0.42 lt-0/3/0.46 lt-0/3/0.43
Number of outgoing interfaces: 3
Instance: v1 Family: INET6
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
