show pim join
Syntax
show pim join <brief | detail | extensive | summary> <bidirectional | dense | sparse> <downstream-count> <exact> <inet | inet6> <instance (all | instance-name)> <logical-system (all | logical-system-name)> <range> <resolve-mvpn-neighbor> <rp ip-address/prefix | source ip-address/prefix> <sg | star-g>
Syntax (EX Series Switch and the QFX Series)
show pim join <brief | detail | extensive | summary> <dense | sparse> <exact> <inet | inet6> <instance (all | instance-name)> <range> <rp ip-address/prefix | source ip-address/prefix> <sg | star-g>
Description
Display information about Protocol Independent Multicast (PIM) groups for all PIM modes.
For bidirectional PIM, display information about PIM group ranges (*,G-range) for each active bidirectional RP group range, in addition to each of the joined (*,G) routes.
Options
none |
Display the standard information about PIM groups for all supported family addresses for all routing instances. |
brief | detail | extensive | summary |
(Optional) Display the specified level of output. |
bidirectional | dense | sparse |
(Optional) Display information about PIM bidirectional mode, dense mode, or sparse and source-specific multicast (SSM) mode entries. |
downstream-count |
(Optional) Display the downstream count instead of a list. |
exact |
(Optional) Display information about only the group that exactly matches the specified group address. |
inet | inet6 |
(Optional) Display PIM group information for IPv4 or IPv6 family addresses, respectively. |
instance (all | instance-name) |
(Optional) Display information about groups for all PIM-enabled routing instances or a specific PIM-enabled routing instance. |
logical-system (all | logical-system-name) |
(Optional) Perform this operation on all logical systems or on a particular logical system. |
range |
(Optional) Address range of the group, specified as prefix/prefix-length. |
resolve-mvpn-neighbor |
(Optional) Display BGP-MVPN neighbor. |
rp ip-address/prefix | source ip-address/prefix |
(Optional) Display information about the PIM entries with a specified rendezvous point (RP) address and prefix or with a specified source address and prefix. You can omit the prefix. |
sg | star-g |
(Optional) Display information about PIM (S,G) or (*,G) entries. |
Required Privilege Level
view
Output Fields
Table 1 describes the output fields
for the show pim join
command. Output fields are listed in the
approximate order in which they appear.
Field Name |
Field Description |
Level of Output |
---|---|---|
|
Name of the routing instance. |
|
|
Name of the address family: |
|
|
Type of multicast route: (S,G) or (*,G). |
|
|
Number of (S,G) routes and number of (*,G) routes. |
|
|
Rendezvous Point Tree. |
|
|
Sparse. |
|
|
Wildcard. |
|
|
Group address. |
|
|
For bidirectional PIM, length of the IP prefix for RP group ranges. |
All levels |
|
Multicast source:
|
|
|
Rendezvous point for the PIM group. |
|
|
PIM flags:
|
|
|
RPF interface toward the source address for the source-specific state (S,G) or toward the rendezvous point (RP) address for the non-source-specific state (*,G). For bidirectional PIM, A pseudo multipoint LDP (M-LDP) interface appears on egress nodes in M-LDP point-to-multipoint LSPs with inband signaling. |
|
|
Information about the upstream neighbor: For bidirectional PIM, The multipoint LDP (M-LDP) root appears on egress nodes in M-LDP point-to-multipoint LSPs with inband signaling. |
|
Upstream rpf-vector |
Information about the upstream Reverse Path Forwarding (RPF)
vector; appears in conjunction with the |
|
Active upstream interface |
When multicast-only fast reroute (MoFRR) is configured in a PIM domain, the upstream interface for the active path. A PIM router propagates join messages on two upstream RPF interfaces to receive multicast traffic on both links for the same join request. Preference is given to two paths that do not converge to the same immediate upstream router. PIM installs appropriate multicast routes with upstream neighbors as RPF next hops with two (primary and backup) interfaces. |
|
Active upstream neighbor |
On the MoFRR primary path, the IP address of the neighbor that is directly connected to the active upstream interface. |
|
MoFRR Backup upstream interface |
The MoFRR upstream interface that is used when the primary path fails. When the primary path fails, the backup path is upgraded to primary, and traffic is forwarded accordingly. If there are alternate paths available, a new backup path is calculated and the appropriate multicast route is updated or installed. |
|
MoFRR Backup upstream neighbor |
IP address of the MoFRR upstream neighbor. |
extensive |
|
Information about the upstream interface:
Note:
RP group range entries have |
|
|
Information about downstream interfaces:
|
|
|
Total number of outgoing interfaces for each (S,G) entry. |
|
|
Length of time between assert cycles on the downstream interface. Not displayed if the assert timer is null. |
|
|
Time remaining until the downstream join state is updated (in
seconds). If the downstream join state is not updated before
this keepalive timer reaches zero, the entry is deleted. If
there is a directly connected host, |
|
|
Time since the creation of (S,G) or (*,G) state. The uptime is not refreshed every time a PIM join message is received for an existing (S,G) or (*,G) state. |
|
|
Interfaces on the routing device that forward bidirectional PIM traffic. The reasons for forwarding bidirectional PIM traffic are that the
interface is the winner of the designated forwarder election
( |
|
Sample Output
- show pim join summary
- show pim join (PIM Sparse Mode)
- show pim join (Bidirectional PIM)
- show pim join inet6
- show pim join inet6 star-g
- show pim join instance <instance-name>
- show pim join instance <instance-name> downstream-count
- show pim join instance <instance-name> downstream-count extensive
- show pim join detail
- show pim join extensive (PIM Resolve TLV for Multicast in Seamless MPLS)
- show pim join extensive (PIM Sparse Mode)
- show pim join extensive (Bidirectional PIM)
- show pim join extensive (Bidirectional PIM with a Directly Connected Phantom RP)
- show pim join instance <instance-name> extensive
- show pim join extensive (Ingress Node with Multipoint LDP Inband Signaling for Point-to-Multipoint LSPs)
- show pim join extensive (Egress Node with Multipoint LDP Inband Signaling for Point-to-Multipoint LSPs)
show pim join summary
user@host> show pim join summary Instance: PIM.master Family: INET Route type Route count (s,g) 2 (*,g) 1 Instance: PIM.master Family: INET6
show pim join (PIM Sparse Mode)
user@host> show pim join Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: * RP: 10.255.14.144 Flags: sparse,rptree,wildcard Upstream interface: Local Group: 233.252.0.1 Source: 10.255.14.144 Flags: sparse,spt Upstream interface: Local Group: 233.252.0.1 Source: 10.255.70.15 Flags: sparse,spt Upstream interface: so-1/0/0.0 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join (Bidirectional PIM)
user@host> show pim join Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Bidirectional group prefix length: 24 Source: * RP: 10.10.13.2 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 Group: 233.252.0.2 Bidirectional group prefix length: 24 Source: * RP: 10.10.1.3 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 (RP Link) Group: 233.252.0.3 Bidirectional group prefix length: 24 Source: * RP: 10.10.13.2 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 Group: 233.252.0.4 Bidirectional group prefix length: 24 Source: * RP: 10.10.1.3 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 (RP Link) Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join inet6
user@host> show pim join inet6 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 2001:db8::e000:101 Source: * RP: ::10.46.0.13 Flags: sparse,rptree,wildcard Upstream interface: Local Group: 2001:db8::e000:101 Source: ::10.1.1.1 Flags: sparse Upstream interface: unknown (no neighbor) Group: 2001:db8::e800:101 Source: ::10.1.1.1 Flags: sparse Upstream interface: unknown (no neighbor) Group: 2001:db8::e800:101 Source: ::10.1.1.2 Flags: sparse Upstream interface: unknown (no neighbor)
show pim join inet6 star-g
user@host> show pim join inet6 star-g Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 2001:db8::e000:101 Source: * RP: ::10.46.0.13 Flags: sparse,rptree,wildcard Upstream interface: Local
show pim join instance <instance-name>
user@host> show pim join instance VPN-A Instance: PIM.VPN-A Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.2 Source: * RP: 10.10.47.100 Flags: sparse,rptree,wildcard Upstream interface: Local Group: 233.252.0.2 Source: 192.168.195.74 Flags: sparse,spt Upstream interface: at-0/3/1.0 Group: 233.252.0.2 Source: 192.168.195.169 Flags: sparse Upstream interface: so-1/0/1.0 Instance: PIM.VPN-A Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join instance <instance-name> downstream-count
user@host> show pim join instance VPN-A downstream-count Instance: PIM.SML_VRF_4 Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: * RP: 10.11.11.6 Flags: sparse,rptree,wildcard Upstream interface: mt-1/2/10.32813 Number of downstream interfaces: 4 Group: 233.252.0.1 Source: 10.1.1.1 Flags: sparse,spt Upstream interface: ge-0/0/3.5 Number of downstream interfaces: 5
show pim join instance <instance-name> downstream-count extensive
user@host> show pim join instance VPN-A downstream-count extensive Instance: PIM.SML_VRF_4 Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: * RP: 10.11.11.6 Flags: sparse,rptree,wildcard Upstream interface: mt-1/2/10.32813 Upstream neighbor: 10.2.2.7 (assert winner) Upstream state: Join to RP Uptime: 02:51:41 Number of downstream interfaces: 4 Number of downstream neighbors: 4 Group: 233.252.0.1 Source: 10.1.1.1 Flags: sparse,spt Upstream interface: ge-0/0/3.5 Upstream neighbor: 10.1.1.17 Upstream state: Join to Source, Prune to RP Keepalive timeout: 0 Uptime: 02:51:42 Number of downstream interfaces: 5 Number of downstream neighbors: 7
show pim join detail
user@host> show pim join detail Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: * RP: 10.255.14.144 Flags: sparse,rptree,wildcard Upstream interface: Local Group: 233.252.0.1 Source: 10.255.14.144 Flags: sparse,spt Upstream interface: Local Group: 233.252.0.1 Source: 10.255.70.15 Flags: sparse,spt Upstream interface: so-1/0/0.0 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join extensive (PIM Resolve TLV for Multicast in Seamless MPLS)
user@host> show pim join extensive Group: 228.26.1.5 Source: 10.60.0.101 Flags: sparse,spt Upstream interface: ge-5/0/0.1 Upstream neighbor: 10.100.1.13 Upstream state: Join to Source Upstream rpf-vector: 10.100.20.1 Keepalive timeout: 178 Uptime: 17:44:38 Downstream neighbors: Interface: xe-2/0/3.1 10.203.2.190 State: Join Flags: S Timeout: 156 Uptime: 17:44:38 Time since last Join: 00:00:54 rpf-vector: 10.100.20.1 Interface: xe-2/0/2.1 10.203.1.190 State: Join Flags: S Timeout: 156 Uptime: 17:44:38 Time since last Join: 00:00:54 rpf-vector: 10.100.20.2 Number of downstream interfaces: 2 Number of downstream neighbors: 2
show pim join extensive (PIM Sparse Mode)
user@host> show pim join extensive Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: * RP: 10.255.14.144 Flags: sparse,rptree,wildcard Upstream interface: Local Upstream neighbor: Local Upstream state: Local RP Uptime: 00:03:49 Downstream neighbors: Interface: so-1/0/0.0 10.111.10.2 State: Join Flags: SRW Timeout: 174 Uptime: 00:03:49 Time since last Join: 00:01:49 Interface: mt-1/1/0.32768 10.10.47.100 State: Join Flags: SRW Timeout: Infinity Uptime: 00:03:49 Time since last Join: 00:01:49 Number of downstream interfaces: 2 Group: 233.252.0.1 Source: 10.255.14.144 Flags: sparse,spt Upstream interface: Local Upstream neighbor: Local Upstream state: Local Source, Local RP Keepalive timeout: 344 Uptime: 00:03:49 Downstream neighbors: Interface: so-1/0/0.0 10.111.10.2 State: Join Flags: S Timeout: 174 Uptime: 00:03:49 Time since last Prune: 00:01:49 Interface: mt-1/1/0.32768 10.10.47.100 State: Join Flags: S Timeout: Infinity Uptime: 00:03:49 Time since last Prune: 00:01:49 Number of downstream interfaces: 2 Group: 233.252.0.1 Source: 10.255.70.15 Flags: sparse,spt Upstream interface: so-1/0/0.0 Upstream neighbor: 10.111.10.2 Upstream state: Local RP, Join to Source Keepalive timeout: 344 Uptime: 00:03:49 Downstream neighbors: Interface: Pseudo-GMP fe-0/0/0.0 fe-0/0/1.0 fe-0/0/3.0 Interface: so-1/0/0.0 (pruned) 10.111.10.2 State: Prune Flags: SR Timeout: 174 Uptime: 00:03:49 Time since last Prune: 00:01:49 Interface: mt-1/1/0.32768 10.10.47.100 State: Join Flags: S Timeout: Infinity Uptime: 00:03:49 Time since last Prune: 00:01:49 Number of downstream interfaces: 3 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join extensive (Bidirectional PIM)
user@host> show pim join extensive Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.0 Bidirectional group prefix length: 24 Source: * RP: 10.10.13.2 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 Upstream neighbor: 10.10.1.2 Upstream state: None Uptime: 00:03:49 Bidirectional accepting interfaces: Interface: ge-0/0/1.0 (RPF) Interface: lo0.0 (DF Winner) Number of downstream interfaces: 0 Group: 233.252.0.1 Bidirectional group prefix length: 24 Source: * RP: 10.10.13.2 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 Upstream neighbor: 10.10.1.2 Upstream state: None Uptime: 00:03:49 Bidirectional accepting interfaces: Interface: ge-0/0/1.0 (RPF) Interface: lo0.0 (DF Winner) Downstream neighbors: Interface: lt-1/0/10.24 10.0.24.4 State: Join RW Timeout: 185 Interface: lt-1/0/10.23 10.0.23.3 State: Join RW Timeout: 184 Number of downstream interfaces: 2 Group: 233.252.0.2 Bidirectional group prefix length: 24 Source: * RP: 10.10.1.3 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 (RP Link) Upstream neighbor: Direct Upstream state: Local RP Uptime: 00:03:49 Bidirectional accepting interfaces: Interface: ge-0/0/1.0 (RPF) Interface: lo0.0 (DF Winner) Interface: xe-4/1/0.0 (DF Winner) Number of downstream interfaces: 0 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard
show pim join extensive (Bidirectional PIM with a Directly Connected Phantom RP)
user@host> show pim join extensive Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.0 Bidirectional group prefix length: 24 Source: * RP: 10.10.1.3 Flags: bidirectional,rptree,wildcard Upstream interface: ge-0/0/1.0 (RP Link) Upstream neighbor: Direct Upstream state: Local RP Uptime: 00:03:49 Bidirectional accepting interfaces: Interface: ge-0/0/1.0 (RPF) Interface: lo0.0 (DF Winner) Interface: xe-4/1/0.0 (DF Winner) Number of downstream interfaces: 0
show pim join instance <instance-name> extensive
user@host> show pim join instance VPN-A extensive Instance: PIM.VPN-A Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.2 Source: * RP: 10.10.47.100 Flags: sparse,rptree,wildcard Upstream interface: Local Upstream neighbor: Local Upstream state: Local RP Uptime: 00:03:49 Downstream neighbors: Interface: mt-1/1/0.32768 10.10.47.101 State: Join Flags: SRW Timeout: 156 Uptime: 00:03:49 Time since last Join: 00:01:49 Number of downstream interfaces: 1 Group: 233.252.0.2 Source: 192.168.195.74 Flags: sparse,spt Upstream interface: at-0/3/1.0 Upstream neighbor: 10.111.30.2 Upstream state: Local RP, Join to Source Keepalive timeout: 156 Uptime: 00:14:52 Group: 233.252.0.2 Source: 192.168.195.169 Flags: sparse Upstream interface: so-1/0/1.0 Upstream neighbor: 10.111.20.2 Upstream state: Local RP, Join to Source Keepalive timeout: 156 Uptime: 00:14:52
show pim join extensive (Ingress Node with Multipoint LDP Inband Signaling for Point-to-Multipoint LSPs)
user@host> show pim join extensive Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.1 Source: 192.168.219.11 Flags: sparse,spt Upstream interface: fe-1/3/1.0 Upstream neighbor: Direct Upstream state: Local Source Keepalive timeout: Uptime: 11:27:55 Downstream neighbors: Interface: Pseudo-MLDP Interface: lt-1/2/0.25 10.2.5.2 State: Join Flags: S Timeout: Infinity Uptime: 11:27:55 Time since last Join: 11:27:55 Group: 233.252.0.2 Source: 192.168.219.11 Flags: sparse,spt Upstream interface: fe-1/3/1.0 Upstream neighbor: Direct Upstream state: Local Source Keepalive timeout: Uptime: 11:27:41 Downstream neighbors: Interface: Pseudo-MLDP Group: 233.252.0.3 Source: 192.168.219.11 Flags: sparse,spt Upstream interface: fe-1/3/1.0 Upstream neighbor: Direct Upstream state: Local Source Keepalive timeout: Uptime: 11:27:41 Downstream neighbors: Interface: Pseudo-MLDP Group: 233.252.0.22 Source: 10.2.7.7 Flags: sparse,spt Upstream interface: lt-1/2/0.27 Upstream neighbor: Direct Upstream state: Local Source Keepalive timeout: Uptime: 11:27:25 Downstream neighbors: Interface: Pseudo-MLDP Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 2001:db8::1:2 Source: 2001:db8::1:2:7:7 Flags: sparse,spt Upstream interface: lt-1/2/0.27 Upstream neighbor: Direct Upstream state: Local Source Keepalive timeout: Uptime: 11:27:26 Downstream neighbors: Interface: Pseudo-MLDP
show pim join extensive (Egress Node with Multipoint LDP Inband Signaling for Point-to-Multipoint LSPs)
user@host> show pim join extensive Instance: PIM.master Family: INET R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 233.252.0.0 Source: * RP: 10.1.1.1 Flags: sparse,rptree,wildcard Upstream interface: Local Upstream neighbor: Local Upstream state: Local RP Uptime: 11:31:33 Downstream neighbors: Interface: fe-1/3/0.0 192.168.209.9 State: Join Flags: SRW Timeout: Infinity Uptime: 11:31:33 Time since last Join: 11:31:32 Group: 233.252.0.1 Source: 192.168.219.11 Flags: sparse,spt Upstream protocol: MLDP Upstream interface: Pseudo MLDP Upstream neighbor: MLDP LSP root <10.1.1.2> Upstream state: Join to Source Keepalive timeout: Uptime: 11:31:32 Downstream neighbors: Interface: so-0/1/3.0 192.168.92.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:30 Time since last Join: 11:31:30 Downstream neighbors: Interface: fe-1/3/0.0 192.168.209.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:32 Time since last Join: 11:31:32 Group: 233.252.0.2 Source: 192.168.219.11 Flags: sparse,spt Upstream protocol: MLDP Upstream interface: Pseudo MLDP Upstream neighbor: MLDP LSP root <10.1.1.2> Upstream state: Join to Source Keepalive timeout: Uptime: 11:31:32 Downstream neighbors: Interface: so-0/1/3.0 192.168.92.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:30 Time since last Join: 11:31:30 Downstream neighbors: Interface: lt-1/2/0.14 10.1.4.4 State: Join Flags: S Timeout: 177 Uptime: 11:30:33 Time since last Join: 00:00:33 Downstream neighbors: Interface: fe-1/3/0.0 192.168.209.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:32 Time since last Join: 11:31:32 Group: 233.252.0.3 Source: 192.168.219.11 Flags: sparse,spt Upstream protocol: MLDP Upstream interface: Pseudo MLDP Upstream neighbor: MLDP LSP root <10.1.1.2> Upstream state: Join to Source Keepalive timeout: Uptime: 11:31:32 Downstream neighbors: Interface: fe-1/3/0.0 192.168.209.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:32 Time since last Join: 11:31:32 Group: 233.252.0.22 Source: 10.2.7.7 Flags: sparse,spt Upstream protocol: MLDP Upstream interface: Pseudo MLDP Upstream neighbor: MLDP LSP root <10.1.1.2> Upstream state: Join to Source Keepalive timeout: Uptime: 11:31:30 Downstream neighbors: Interface: so-0/1/3.0 192.168.92.9 State: Join Flags: S Timeout: Infinity Uptime: 11:31:30 Time since last Join: 11:31:30 Instance: PIM.master Family: INET6 R = Rendezvous Point Tree, S = Sparse, W = Wildcard Group: 2001:db8::1:2 Source: 2001:db8::1:2:7:7 Flags: sparse,spt Upstream protocol: MLDP Upstream interface: Pseudo MLDP Upstream neighbor: MLDP LSP root <10.1.1.2> Upstream state: Join to Source Keepalive timeout: Uptime: 11:31:32 Downstream neighbors: Interface: fe-1/3/0.0 2001:db8::21f:12ff:fea5:c4db State: Join Flags: S Timeout: Infinity Uptime: 11:31:32 Time since last Join: 11:31:32
Release Information
Command introduced before Junos OS Release 7.4.
summary option introduced in Junos OS Release 9.6.
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.
Multiple new filter options introduced in Junos OS Release 13.2.
downstream-count
option introduced in Junos OS Release 16.1.
Support for PIM NSR support for VXLAN added in Junos OS Release 16.2
Support for RFC 5496 (via rpf-vector
) added in Junos OS Release
17.3R1.