Technical Documentation

Related Topics
clear pim join

show pim join

Syntax

Syntax (EX Series Switch)

show pim join<brief | detail | extensive | summary><inet | inet6><instance instance-name><range>

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

summary option introduced in Junos OS Release 9.6.

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

Description

Display information about Protocol Independent Multicast (PIM) groups.

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.
inet | inet6: (Optional) Display PIM group information for IPv4 or IPv6 family addresses, respectively.
instance instance-name: (Optional) Display information about groups for the specified PIM-enabled routing instance only.
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.

Required Privilege Level

view

List of Sample Output

show pim join summary
show pim join
show pim join instance
show pim join detail
show pim join extensive
show pim join instance extensive

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.

Table 1: show pim join Output Fields

Field Name	Field Description	Level of Output
Instance	Name of the routing instance.	brief detail extensive summary none
Family	Name of the address family: inet (IPv4) or inet6 (IPv6).	brief detail extensive summary none
Route type	Type of multicast route: (S,G) or (*,G).	summary
Route count	Number of (S,G) routes and number of (*,G) routes.	summary
R	Rendezvous Point Tree	brief detail extensive none
S	Sparse	brief detail extensive none
W	Wildcard	brief detail extensive none
Group	Group address.	brief detail extensive none
Source	Multicast source: * (wildcard value) ipv4-address ipv6-address	brief detail extensive none
RP	Rendezvous point for the PIM group.	brief detail extensive none
Flags	PIM flags: dense—Dense mode entry. rptree—Entry is on the rendezvous point tree. sparse—Sparse mode entry. spt—Entry is on the shortest-path tree for the source. wildcard—Entry is on the shared tree.	brief detail extensive none
Upstream interface	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).	brief detail extensive none
Upstream neighbor	Information about the upstream neighbor: Direct, Local, Unknown, or a specific IP address.	extensive
Upstream state	Information about the upstream interface: Join to RP—Sending a join to the rendezvous point. Join to Source—Sending a join to the source. Local RP—Sending neither joins nor prunes toward the RP, because this router is the rendezvous point. Local Source—Sending neither joins nor prunes toward the source, because the source is locally attached to this routing device. Prune to RP—Sending a prune to the rendezvous point. Prune to Source—Sending a prune to the source.	extensive
Downstream neighbors	Information about downstream interfaces: Interface—Interface name for the downstream neighbor. Note: A pseudo PIM-SM interface appears for all IGMP-only interfaces. Interface address—Address of the downstream neighbor. State—Information about the downstream neighbor: join or prune. Flags—PIM join flags: R (RPtree),S (Sparse), W (Wildcard), or zero.	extensive
Assert Timeout	Length of time between assert cycles on downstream interface. Not displayed if assert timer is null.	extensive
Timeout	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, Timeout is Infinity.	extensive

Sample Output

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

user@host> show pim join

Instance: PIM.master Family: INET
R = Rendezvous Point Tree, S = Sparse, W = Wildcard

Group: 239.1.1.1
    Source: *
    RP: 10.255.14.144
    Flags: sparse,rptree,wildcard
    Upstream interface: Local

Group: 239.1.1.1
    Source: 10.255.14.144
    Flags: sparse,spt
    Upstream interface: Local

Group: 239.1.1.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 instance

user@host> show pim join instance VPN-A

Instance: PIM.VPN-A Family: INET
R = Rendezvous Point Tree, S = Sparse, W = Wildcard

Group: 235.1.1.2
    Source: *
    RP: 10.10.47.100
    Flags: sparse,rptree,wildcard
    Upstream interface: Local

Group: 235.1.1.2
    Source: 192.168.195.74
    Flags: sparse,spt
    Upstream interface: at-0/3/1.0

Group: 235.1.1.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 detail

user@host> show pim join detail

Instance: PIM.master Family: INET
R = Rendezvous Point Tree, S = Sparse, W = Wildcard

Group: 239.1.1.1
    Source: *
    RP: 10.255.14.144
    Flags: sparse,rptree,wildcard
    Upstream interface: Local

Group: 239.1.1.1
    Source: 10.255.14.144
    Flags: sparse,spt
    Upstream interface: Local

Group: 239.1.1.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

user@host> show pim join extensive

Instance: PIM.master Family: INET
R = Rendezvous Point Tree, S = Sparse, W = Wildcard

Group: 239.1.1.1
    Source: *
    RP: 10.255.14.144
    Flags: sparse,rptree,wildcard
    Upstream interface: Local
    Upstream neighbor: Local
    Upstream state: Local RP
    Downstream neighbors:
        Interface: so-1/0/0.0
            10.111.10.2 State: Join Flags: SRW Timeout: 174
        Interface: mt-1/1/0.32768
            10.10.47.100 State: Join Flags: SRW  Timeout: Infinity

Group: 239.1.1.1
    Source: 10.255.14.144
    Flags: sparse,spt
    Upstream interface: Local
    Upstream neighbor: Local
    Upstream state: Local Source, Local RP
    Keepalive timeout: 344
    Downstream neighbors:
        Interface: so-1/0/0.0
            10.111.10.2 State: Join Flags: S Timeout: 174
        Interface: mt-1/1/0.32768
            10.10.47.100 State: Join Flags: S   Timeout: Infinity

Group: 239.1.1.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
    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
        Interface: mt-1/1/0.32768
            10.10.47.100 State: Join Flags: S   Timeout: Infinity

Instance: PIM.master Family: INET6
R = Rendezvous Point Tree, S = Sparse, W = Wildcard

show pim join instance 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: 235.1.1.2
    Source: *
    RP: 10.10.47.100
    Flags: sparse,rptree,wildcard
    Upstream interface: Local
    Upstream neighbor: Local
    Upstream state: Local RP
    Downstream neighbors:
        Interface: mt-1/1/0.32768
            10.10.47.101 State: Join Flags: SRW Timeout: 156

Group: 235.1.1.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

Group: 235.1.1.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