multicast-route-limit <limit>

no multicast-route-limit <limit>


Configures the limit on the maximum number of multicast route entries that can be programmed. When the limit is configured, multicast route entries created because of IGMP or MLD membership reports, and multicast route entries created because of multicast streams are restricted to the configured limit.

The no form of this command removes the currently configured limit value.

Command context




Specifies the value to be configured as the multicast route limit. Range: 1 to 4294967295.


Administrators or local user group members with execution rights for this command.


Flows exceeding the configured multicast route limit will be programmed as a bridge entry and will not have the outgoing interfaces list populated. This configuration prevents creation of new multicast routes when limits are reached. At the time of configuration, if the device has more multicast routes than the configured limit, existing multicast routes continue to exist until they are removed.

The flows are programmed in the HW on a FCFS basis. There could be scenarios where the flow is forwarded in neighbor router, but it may not be forwarded on the current router because of exceeding the limits configured on the current router. In such cases, it is recommended to configure higher limits to avoid traffic outage.


Configuring and removing the multicast route rate limit:

switch(config)# router pim
switch(config-pim)# multicast-route-limit 1024
switch(config-pim)# no multicast-route-limit