show pim cache

show pim { ipv4 | ipv6 } cache {{detail} | {state-refresh} {mlag-peer-info} {group_addr {source_addr}}}

Description

Displays the multicast cache entries created by PIM.

Syntax Description

ipv4 Displays IPv4 PIM information
ipv6 Displays IPv6 PIM information.
detail Specifies to display the information in detailed format.
group_addr Specifies an IP group address.
source_addr Specifies an IP source address.
state-refresh Specifies to display the PIM cache entries with state refresh parameters.
mlag-peer-info Shows MLAG peer related information.

Default

N/A.

Usage Guidelines

Displays the following information:

  • IP group address
  • IP source address / source mask
  • Upstream neighbor (RPF neighbor)
  • Interface (VLAN) to upstream neighbor
  • Cache expire time
  • Egress and prune interface list

When the detail option is specified, the switch displays the egress VLAN list and the pruned VLAN list.

Example

The following command displays the PIM cache entry for group 239.255.255.1:

Switch.33 # show pim cache 239.255.255.1
Index  Dest Group      Source             InVlan   Origin
[0000] 239.255.255.1   124.124.124.124 (WR) v4    Sparse
Entry timer is not run; UpstNbr: 200.124.124.24
EgressIfList =  vbs15(0)(FW)(SM)(I)
[0001] 239.255.255.1   118.5.1.1 (S)      vbs5  Sparse
Expires after 186 secs UpstNbr: 0.0.0.0
RP: 124.124.124.124 via 200.124.124.24 in v4
EgressIfList =  vbs15(0)(FW)(SM)(I) , vpim5(170)(FW)(SM)(S)
PrunedIfList =  v4(0)(SM)
Number of multicast cache = 20
Entry flags :-
R: RP tree. S: Source tree. W: Any source.
Egress/Pruned interface flags :-
SM: Sparse Mode           DM: Dense Mode
Fw: Forwarding            PP: Prune pending
AL: Assert Loser           N: Neighbor present
I: IGMP member present    S: (s,g) join received
Z: (*,g) join received    Y: (*,*,rp) join received

The following command displays the PIM-DM cache entry with state-refresh information for group 225.0.0.1:

Switch.5 # show pim cache state-refresh 225.0.0.1
Index  Dest Group      Source             InVlan   Origin
[0001] 225.0.0.1       64.1.1.100 (S)     vixia    Dense   Not Pruned
Expires after 204 secs UpstNbr: 0.0.0.0
Refresh State: Originator(20), TTL: 16
EgressIfList =  v36(0)(FW)(DM)(N)
[0001] 225.0.0.1       65.1.1.100 (S)     vixia    Dense   Not Pruned
Expires after 195 secs UpstNbr: 65.1.1.200
Refresh State: Not-Originator(25), TTL: 8
EgressIfList =  v36(0)(FW)(DM)(N)

The following command displays the ingress VLAN information of all MLAG peers:

* (pacman debug) sw6.2 # show pim c mlag-peer-info 
Index  Dest Group      Source             InVlan   Origin 
[0000] 226.1.1.1       61.2.2.2 (WR)      fifthteen Sparse         
       Entry timer is not run; UpstNbr: 51.15.15.2
       Peer Ingress VLAN (ISC 1): 51.15.15.4/24 (Same)
       EgressIfList =  eight(0)(FW)(SM)(I) , five(0)(FW)(SM)(I) , ten(0)(FW)(SM)(I) 

[0001] 226.1.1.1       112.2.2.202 (S)    fifthteen Sparse         
       Expires after 203 secs UpstNbr: 51.15.15.2
       RP: 61.2.2.2 via 51.15.15.2 in fifthteen
       Peer Ingress VLAN (ISC 1): 51.15.15.4/24 (Same)
       EgressIfList =  eight(0)(FW)(SM)(I) , five(0)(FW)(SM)(I) 
       PrunedIfList =  ten(0)(SM)(AL) 

History

This command was first available in ExtremeXOS 10.1.

This command was modified in ExtremeXOS 15.2 to display MLAG peer information.

The ipv4 and ipv6 keyword options were added in ExtreameXOS 15.3.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the PIM feature, see the Feature License Requirements document.