Displays Protocol Independent Multicast
(PIM) Sparse configuration information, including whether the hardware-drop feature
is
enabled or disabled, 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 IPv6 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
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. 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
Register stop message. The default is 10 seconds.
Register Suppress interval
Number of seconds that it takes the designated router to send a Register-encapsulated
date 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
Disabling of slow path forwarding of all multicast data packets.
Slow Path Enable SSM
Slow path forwarding for SSM groups.
Slow Path Filter Acl
Slow path forwarding of IP multicast data
packets for groups in an access control list (ACL)..
Examples
New example
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
History
Release version
Command history
08.0.95
The output for this command was enhanced to include information about slow path forwarding
configurations.