`show ip pim sparse`

Displays Protocol Independent Multicast (PIM) Sparse configuration information, including whether hardware-drop is enabled, and information for PIM Source-Specific Multicast (SSM) range and access control list (ACL) configuration.

Syntax

show ip pim sparse

Modes

User EXEC mode

The show ip pim sparse command displays the following information:

Output Field	Description
Maximum mcache	Maximum number of multicast cache entries.
Current Count	Number of multicast cache entries used.
Hello interval	How often the device sends PIM Sparse hello messages to its PIM Sparse neighbors. This field shows the number of seconds between hello messages. PIM Sparse routers use hello messages to discover one another.
Neighbor timeout	Number of seconds the device waits for a hello message from a neighbor before determining that the neighbor is no longer present and is not removing cached PIM Sparse forwarding entries for the neighbor. The default is 105 seconds.
Join/Prune interval	How frequently the device sends PIM Sparse Join or Prune messages for the multicast groups it is forwarding. This field shows the number of seconds between Join or Prune messages. The device sends Join or Prune messages on behalf of multicast receivers that want to join or leave a PIM Sparse group. When forwarding packets from PIM Sparse sources, the device sends the packets only on the interfaces on which it has received join requests in Join or Prune messages for the source group.
Inactivity interval	Number of seconds a forwarding entry can remain unused before the router deletes it. The default is 180 seconds.
Hardware Drop Enabled	Indicates whether hardware-drop is enabled or disabled. To prevent unwanted multicast traffic from being sent to the CPU, PIM Routing and Passive Multicast Route Insertion (PMRI) can be used together to ensure that multicast streams are only forwarded out ports with interested receivers and unwanted traffic is dropped in the hardware on Layer 3 switches.
Prune Wait Interval	Number of seconds a PIM device waits before stopping traffic to neighbor devices that do not want the traffic. The range is 0 to 3 seconds. The default is 3 seconds.
Bootstrap Msg interval	How frequently the BSR configured on the device sends the RP set to the RPs within the PIM Sparse domain in seconds. The RP set is a list of candidate RPs and their group prefixes. The group prefix of a candidate RP indicates the range of PIM Sparse group numbers for which it can be an RP. Note: This field contains a value only if an interface on the device is elected to be the BSR. Otherwise, the field is blank.
Candidate-RP Msg interval	Number of seconds the candidate RP configured on the Layer 3 switch sends candidate RP advertisement messages to the BSR. The default is 60 seconds.
Register Suppress Time	The mean interval between receiving a Register-Stop and allowing registers to be sent again. A lower value means more frequent register bursts at the RP, while a higher value means longer join latency for new receivers. The default is 60 seconds.
Register Probe Time	Number of seconds the PIM router waits for a Register-Stop from an RP before it generates another NULL register to the PIM RP. The default is 10 seconds.
Register Stop Delay	How often a Register-Stop message is displayed.
Join/Prune Policy	Join and Prune policy configurations.
Register Suppress interval	Number of seconds that it takes the designated router to send Register-encapsulated data to the RP after receiving a Register-Stop message. The default is 60 seconds.
SSM Enabled	If yes, Source-Specific Multicast (SMM) is configured globally on this router.
SPT threshold	Number of packets the device sends using the path through the RP before switching to the SPT path. The default is 1 packet.
SSM Group Range	Source-Specific Multicast (SSM) group range.
Route Precedence	The route precedence configured to control the selection of routes based on the four route types: Non-default route from the mRTM Default route from the mRTM Non-default route from the uRTM Default route from the uRTM
Slow Path Disable All	Whether disabling of slow path forwarding of all multicast data packets is enabled.
Slow Path Enable SSM	Whether slow path forwarding for SSM groups is enabled.
Slow Path Filter Acl	The number of slow path forwarding of IP multicast data packets for groups in an access control list (ACL).

Examples

The following example displays PIM Sparse configuration information, including information about slow path forwarding configurations.

device> show ip pim sparse

Global PIM Sparse Mode Settings
  Maximum Mcache         : 16384       Current Count              : 3
  Hello interval         : 30          Neighbor timeout           : 105
  Join/Prune interval    : 60          Inactivity interval        : 180
  Hardware Drop Enabled  : Yes         Prune Wait Interval        : 3
  Bootstrap Msg interval : 60          Candidate-RP Msg interval  : 60
  Register Suppress Time : 60          Register Probe Time        : 10
  Register Stop Delay    : 10
  SSM Enabled            : Yes         SPT Threshold              : 1
  SSM Group Range        : 232.0.0.0/8
  Route Precedence       : uc-non-default uc-default mc-non-default mc-default
  Slow Path Disable All  : Yes	
  Slow Path Enable SSM   : Yes
  Slow Path Filter Acl   : acl

The following example displays PIM Sparse configuration information, including information about the register rate limitations and the register message filter rule.

device> show ip pim sparse
Global PIM Sparse Mode Settings
Maximum Mcache             : 2048             Current Count                 : 0
Hello interval             : 30               Neighbor timeout              : 105
Join/Prune interval        : 60               Inactivity interval           : 180
Hardware Drop Enabled      : Yes               Prune Wait Interval          : 3
Bootstrap Msg interval     : 60                Candidate-RP Msg interval    : 60
Register Suppress Time     : 60                Register Probe Time          : 10
Register Stop Delay        : 10                SPT Threshold                : 1
SSM Enabled                : No
Route Precedence           : uc-non-default uc-default mc-non-default mc-default
Embedded RP Enabled        : Yes
Slow Path Disable All      : No               Slow Path Enable SSM         : No
Slow Path Filter Acl       : None           
Register Rate Limit        : 20 pps        Register Filter                 :  pim_reg_filter

History

Release version	Command history
08.0.95	The output for this command was enhanced to include information about slow path forwarding configurations.
09.0.10	The output for this command was enhanced to include information about Join and Prune configurations and the register rate limitations.

Show Commands

show ip pim sparse

`show ip pim sparse`