To set a limit on the maximum number of Protocol Independent Multicast sparse mode (PIM-SM) register messages sent per second for each (S, G) routing entry, use the ip pim register-rate-limit command in global configuration mode. To disable this limit, use the no form of this command.
ip pim [ vrf vrf-name ] register-rate-limit rate
no ip pim [ vrf vrf-name ] register-rate-limit

Syntax Description


vrf
(Optional) Supports the multicast Virtual Private Network (×××) routing and forwarding (VRF) instance.
vrf-name
(Optional) Name assigned to the VRF.
rate
Maximum number of register messages sent per second by the router. By default, there is no maximum rate set.

Defaults

No limit is defined.

Command Modes

Global configuration

Command History


Release
Modification
11.3T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
This command was integrated into Cisco IOS Release 12.2(13)T.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(18)SXE
Support for this command was introduced on the Supervisor Engine 720.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.

Usage Guidelines

Use this command to limit the number of register messages that the designated router (DR) will allow for each (S, G) entry. Enabling this command will limit the load on the DR and RP at the expense of dropping those register messages that exceed the set limit. Receivers may experience data packet loss within the first second in which register messages are sent from bursty sources.
If the ip pim command is configured with the dense-mode and proxy-register keywords, you must set a limit on the maximum number of PIM-SM register messages sent because of the potentially large number of sources from the dense mode area that may send data into the sparse mode region (and thus need registering in the border router).
This command applies only to sparse mode (S, G) multicast routing entries.

Examples

The following example shows how to configure the ip pim register-rate-limit command with a maximum rate of two register messages per second: 
ip pim register-rate-limit 2

Related Commands


Command
Description
ip pim
Enables PIM on an interface.