clear pim cache

clear pim {ipv4 | ipv6} cache {group_addr {source_addr}}

Description

Clears PIM multicast cache table.

Syntax Description

ipv4 Specifies an IPv4 address.
ipv6 Specifies an IPv6 address.
group_addr Specifies a group address.
source_addr Specifies a source IP address.

Default

If no options are specified, all PIM cache entries are flushed.

Usage Guidelines

This command can be used by network operators to manually remove IPMC software and hardware forwarding cache entries instantly. If the stream is available, caches are re-created; otherwise, caches are removed permanently. This command can disrupt the normal forwarding of multicast traffic.

Example

The following example resets the IP multicast table for group 224.1.2.3:

clear pim cache 224.1.2.3

History

This command was first available in ExtremeXOS 10.1.

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 Switch Engine v33.1.1 Licensing Guide document.