Table of Contents

Contents

Preface

New and Changed Information

Multicast Routing Commands

Multicast Routing Show Commands

Cisco Nexus 3548 Switch NX-OS Multicast Routing Command Reference

Preface

. It also provides information on how to obtain related documentation.

This preface includes the following sections:

- Audience

- Document Conventions

- Related Documentation

- Documentation Feedback

- Obtaining Documentation and Submitting a Service Request

Audience

This publication is for experienced network administrators who configure and maintain Cisco Nexus Series switches.

Document Conventions

Command descriptions use these conventions:

Convention

Description

boldface font

Commands and keywords are in boldface.

italic font

Arguments for which you supply values are in italics.

[ ]

Elements in square brackets are optional.

[ x | y | z ]

Optional alternative keywords are grouped in brackets and separated by vertical bars.

string

A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

Screen examples use these conventions:

Terminal sessions and information that the switch displays are in screen font.

Information that you must enter is in boldface screen font.

Arguments for which you supply values are in italic screen font.

< >

Nonprinting characters, such as passwords, are in angle brackets.

[ ]

Default responses to system prompts are in square brackets.

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

This document uses the following conventions:

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Related Documentation

Documentation for the Cisco Nexus 3000 Series Switch is available at the following URL:

The documentation set is divided into the following categories:

Release Notes

The release notes are available at the follwing URL:

Installation and Upgrade Guides

The installation and upgrade guides are available at the following URL:

Command References

The command references are available at the following URL:

Technical References

The technical references are available at the following URL:

Configuration Guides

The configuration guides are available at the following URL:

Error and System Messages

The system message reference guide is available at the following URL:

Documentation Feedback

. We appreciate your feedback.

Obtaining Documentation and Submitting a Service Request

.

. The RSS feeds are a free service.

New and Changed Information

This chapter provides release-specific information for each new and changed feature in the Cisco Nexus 3548 Switch NX-OS Multicast Routing Command Reference. The latest version of this document is available at the following Cisco website:

available at the following Cisco website:

The following table summarizes the new and changed features for Cisco NX-OS Release 5.x and Release 6.x and tells you where they are documented.

Table 1 New and Changed Information for Release 5.x and Release 6.x

Feature

Description

Changed in Release

Where Documented

6.0(2)A8(3)

ip multicast rpf select vrf

CLI command hardware profile multicast rpf-check-optimization

The hardware profile multicast prefer-source-tree CLI command has been replaced by the command hardware profile multicast rpf-check-optimization.

6.0(2)A6(4)

hardware profile multicast rpf-check-optimization

Multicast Service Reflection: Fast-pass and fast-pass no-rewrite mode

The fast-pass and fast-pass no-rewrite modes are supported for the SR feature.

6.0(2)A6(2)

ip service-reflect mode

show forwarding multicast-sr loopback interface

Multicast Service Reflection: Regular Mode

The Multicast Service Reflection (SR) feature provides the capability for users to translate the externally received multicast destination addresses to addresses that confirm to their organization's internal addressing policy.

Note The multicast service reflect feature is supported only on Cisco Nexus 3548X platforms from Release 6.0(2)A6(1).

6.0(2)A6(1)

hardware profile multicast service-reflect port

ip service-reflect mode

ip service-reflect destination <G1> to <G2> mask-len <M1> source <S1> to <S2> mask-len <M2>

show forwarding multicast-sr loopback interface

show forwarding multicast-sr loopback interface

IGMP Snooping Filter

You can filter out IGMP snooping reports and access groups at the interface level. This filtering is based on a prefix-list or a route-map policy.

6.0(2)A4(1)

ip igmp snooping access-group

ip igmp snooping report-policy

IPv4 Protocol Independent Multicast (PIM) (*, G) state only

and prebuild SPT.

This feature was introduced to create the IPv4 PIM (*, G) state only and enabling prebuild of SPT.

5.0(3)A1(2)

ip pim pre-build-spt

ip pim spt-threshold infinity

Multicast Routing Commands

This chapter describes the Cisco NX-OS multicast routing commands available on the Cisco Nexus 3548 switch.

clear ip igmp event-history

command.

}

Syntax Description

Clears the CLI event history buffer.

Clears the debug event history buffer.

Clears the event history buffer.

Clears the high availability (HA) event history buffer.

Clears the mtrace event history buffer.

Clears the policy event history buffer.

Clears the virtual routing and forwarding (VRF) event history buffer.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear information in the IGMP HA event history buffer:

switch(config)# clear ip igmp event-history ha

switch(config)#

Related Commands

Command

Description

Configures the size of the IGMP event history buffers.

clear ip igmp groups

command.

}]

Syntax Description

Specifies all routes.

.

(Optional) Source (S, G) route.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to clear all the IGMP-related routes in the IPv4 multicast routing table:

switch(config)# clear ip igmp groups *

switch(config)#

Related Commands

Command

Description

Clears IGMP-related information in the IPv4 multicast routing table.

Displays information about the IPv4 multicast routing table.

clear ip igmp interface statistics

command.

]]

Syntax Description

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the loopback interface. The loopback interface number is from 0 to 1023.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear IGMP statistics for an interface:

switch# clear ip igmp interface statistics ethernet 2/1

switch#

Related Commands

Command

Description

Displays information about IGMP interfaces.

clear ip igmp route

command.

}]

Syntax Description

Specifies all routes.

.

(Optional) Source (S, G) route.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to clear all the IGMP-related routes in the IPv4 multicast routing table:

switch(config)# clear ip igmp route *

switch(config)#

Related Commands

Command

Description

Clears IGMP-related information in the IPv4 multicast routing table.

Displays information about the IPv4 multicast routing table.

clear ip igmp snooping event-history

command.

}

Syntax Description

Clears the unicast Routing Information Base (RIB) event history buffer.

Clears the multicast FIB distribution (MFDM) event history buffer.

Clears the MFDM sum event history buffer.

Clears the VLAN event history buffer.

Clears the VLAN-events event history buffer.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear information in the IGMP snooping VLAN event history buffer:

switch(config)# clear ip igmp event-history vlan

switch(config)#

Related Commands

Command

Description

Configures the size of the IGMP snooping event history buffers.

clear ip igmp snooping explicit-tracking vlan

command.

Syntax Description

VLAN number. The range is from 1 to 3968 and 4049 to 4093.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the explicit tracking information for VLAN 1:

switch# clear ip igmp snooping explicit-tracking vlan 1

switch#

Related Commands

Command

Description

Displays explicit host tracking information for IGMPv3.

clear ip igmp snooping statistics vlan

command.

]

Syntax Description

(Optional) VLAN number. The range is from 1 to 3968 and 4049 to 4093.

(Optional) Applies to all VLANs.

Command Default

All VLANs

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear IGMP snooping statistics for VLAN 1:

switch# clear ip igmp snooping statistics vlan 1

switch#

Related Commands

Command

Description

Displays IGMP snooping statistics by VLAN.

clear ip mfwd event-history

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Examples

This example shows how to clear the multicast forwarding static routes configured on the switch:

switch# clear ip mfwd event-history

switch#

Related Commands

Command

Description

Registers multicast forwarding static routes.

clear ip mroute

command.

}]

Syntax Description

Specifies all mismatched routes between the hardware and software multicast routing tables.

.

Note Make sure that you provide an address that is not a reserved multicast address.

(Optional) Source (S, G) route.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the multicast routing table.

Specifies that the default VRF entry be cleared from the multicast routing table.

Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command is used to delete routes from the multicast Forwarding Information Base (FIB). It is generally used to clear the mismatched routes in the hardware and software multicast routing tables. When routes are cleared from the multicast FIB, the individual processes (such as PIM, IGMP) that create the routes would repopulate the routes into the multicast FIB.

commands to remove the routes for each process:

- clear ip pim route

- clear ip igmp groups

This command does not require a license.

Examples

This example shows how to clear the mismatched routes in the multicast routing table:

switch# clear ip mroute *

This command does not clear mroutes permanently, Please use clear commands from

all mroute owners:

Pim : clear ip pim route

IGMP: clear ip igmp groups

IP/MFWD: clear ip mfwd mroute

to avoid owner process from repopulating routes into multicast routing table.

For further information regarding this behavior please check documentation.

switch#

Related Commands

Command

Description

Clears the routes specific to Protocol Independent Multicast (PIM) for IPv4.

Clears the IGMP-related information in the IPv4 multicast routing table.

Clears the multicast routing table.

Displays information about the multicast routing table.

clear ip msdp event-history

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear information in the MSDP event history buffers:

switch(config)# clear ip msdp event-history

switch(config)#

Related Commands

Command

Description

Configures the size of the MSDP event history buffers.

Displays information in the MSDP event history buffers.

clear ip msdp peer

command.

}]

Syntax Description

IP address of the MSDP peer.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that the default VRF entry be cleared from the multicast routing table.

Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear a TCP connection to an MSDP peer:

switch# clear ip msdp peer 192.168.1.10

switch#

Related Commands

Command

Description

Displays information about MSDP peers.

clear ip msdp policy statistics sa-policy

command.

}]

Syntax Description

IP address of the MSDP peer for the SA policy.

Specifies the input policy.

Specifies the output policy.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

(Optional) Specifies that the default VRF entry be cleared from the multicast routing table.

(Optional) Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear an SA policy for an MSDP peer:

switch# clear ip msdp policy statistics sa-policy

switch#

Related Commands

Command

Description

Displays information about MSDP peers.

clear ip msdp route

command.

}]

Syntax Description

Specifies all sources for the group from the SA cache.

.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the SA-cache.

Specifies that the default VRF entry be cleared from the SA-cache.

Specifies that the management VRF entry be cleared from the SA-cache.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command for the same function.

This command requires the LAN Base Services license.

Examples

This example shows how to clear the MSDP SA cache:

switch# clear ip msdp route *

switch#

Related Commands

Command

Description

Clears the MSDP SA cache.

clear ip msdp sa-cache

command.

}]

Syntax Description

Specifies all sources for the group from the SA cache.

.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the SA-cache.

Specifies that the default VRF entry be cleared from the SA-cache.

Specifies that the management VRF entry be cleared from the SA-cache.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command for the same function.

This command requires the LAN Base Services license.

Examples

This example shows how to clear the MSDP SA cache:

switch# clear ip msdp sa-cache

switch#

Related Commands

Command

Description

Clears the MSDP SA cache.

Displays route information in the MSDP Source-Active cache.

clear ip msdp statistics

command.

]

Syntax Description

(Optional) IP address of the MSDP peer.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

(Optional) Specifies that the default VRF entry be cleared from the multicast routing table.

(Optional) Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear MSDP statistics for all MSDP peers:

switch# clear ip msdp statistics

switch#

Related Commands

Command

Description

Displays information about MSDP peers.

clear ip pim event-history

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear information in the PIM event history buffers:

switch(config)# clear ip pim event-history

switch(config)#

Related Commands

Command

Description

Configures the size of the PIM event history buffers.

Displays information in the PIM event history buffers.

clear ip pim interface statistics

command.

]

Syntax Description

(Optional) Specifies the Ethernet interface. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

(Optional) Specifies the VLAN. The range is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear the PIM counters for a specified interface:

switch# clear ip pim interface statistics ethernet 2/1

switch#

Related Commands

Command

Description

Displays PIM statistics.

clear ip pim policy statistics

command.

}

}]

Syntax Description

Specifies statistics for the join-prune policy.

Specifies statistics for the neighbor policy.

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Specifies the VLAN.

VLAN number. The range is from 1 to 4094.

Specifies statistics for the register policy.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear PIM register policy counters:

switch# clear ip pim policy statistics register-policy

switch#

Related Commands

Command

Description

Displays PIM policy statistics.

clear ip pim route

command.

}]

Syntax Description

Specifies all routes.

.

(Optional) Source (S, G) route.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the multicast routing table.

Specifies that the default VRF entry be cleared from the multicast routing table.

Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear the all the routes specific to PIM:

switch(config)# clear ip pim route *

switch(config)#

Related Commands

Command

Description

Displays information about PIM specific routes.

clear ip pim statistics

command.

}]

Syntax Description

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the multicast routing table.

Specifies that the default VRF entry be cleared from the multicast routing table.

Specifies that the management VRF entry be cleared from the multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear PIM statistics counters:

switch# clear ip pim statistics

switch#

Related Commands

Command

Description

Displays PIM statistics.

clear ip routing multicast event-history

command.

}

Syntax Description

Clears the CLI event history buffer.

Clears the multicast FIB distribution (MFDM) debug history buffer.

Clears the MFDM events history buffer.

Clears the MFDM sum event history buffer.

Clears the RIB event history buffer.

Clears the virtual routing and forwarding (VRF) event history buffer.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear information in the MRIB RIB event history buffer:

switch(config)# clear ip routing multicast event-history rib

switch(config)#

Related Commands

Command

Description

Configures the size of the IPv4 MRIB event history buffers.

Displays information in the IPv4 MRIB event history buffers.

clear routing multicast

command.

}]

Syntax Description

(Optional) Clears IP commands.

(Optional) Clears IPv4 commands.

Specifies all routes.

.

(Optional) Source (S, G) route.

.

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to clear the IPv4 multicast routing table:

switch(config)# clear routing multicast *

switch(config)#

Related Commands

Command

Description

Clears the multicast routing table.

Displays information about IPv4 multicast routes.

feature msdp

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modified

5.0(3)A1

This command was introduced.

Usage Guidelines

You must enable the MSDP feature before you can configure MSDP.

This command requires the LAN Base Services license.

Examples

This example shows how to enable a MSDP configuration:

switch(config)# feature msdp

switch(config#

Related Commands

Command

Description

Displays the MSDP running configuration information.

Displays the status of features on a switch.

Configures a MSDP peer.

feature pim

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modified

5.0(3)A1

This command was introduced.

Usage Guidelines

You must enable the PIM feature before you can configure PIM.

This command requires the LAN Base Services license.

Examples

This example shows how to enable a PIM configuration:

switch(config)# feature pim

switch(config#

Related Commands

Command

Description

Displays the PIM running configuration information.

Displays the status of features on a switch.

Enables IPv4 PIM sparse mode on an interface.

hardware profile multicast rpf-check-optimization

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)A6(4)

This command was introduced.

Usage Guidelines

This command applies to the Last Hop Router (LHR) only when the LHR transitions from RPT to SPT. Use this command to ensure that there are no duplicate packets in the hardware when the transition from RPT to SPT is in progress.

Note When multicast rpf-check-optimization is enabled, the NXOS does not install any OIF for the *,G entries to avoid packet duplication during the transition from RPT to SPT or any other potential scenarios where the multicast traffic may be duplicated. The *,G entries still have non-empty OIL in the software that can be displayed in show ip mroute CLI output.

Examples

This example shows how to prevent duplication of packets during a RPT to SPT switchover:

switch# configure terminal

switch(config)# hardware profile multicast rpf-check-optimized

switch(config)#

Related Commands

Command

Description

Displays information about the *,G entries.

hardware profile multicast service-reflect port

Use the hardware profile multicast service-reflect port command to create a multicast service reflect loopback port from the range <1-48>.

Syntax Description

Range <1-48> for the loopback port.

Command Default

None

Command Modes

Configuration mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

Use this command to configure the multicast service reflect loopback port for the multicast service reflection feature on the Cisco Nexus 3548X platform switches.

Note The configuration of hardware profile multicast service-reflect port is required only for ip service-reflect mode regular mode.

Note The selected loopback port is burnt and it is not usable for the regular purpose. A reload is required after configuring the loopback port using the CLI.

Examples

This example shows how to create a multicast service reflect loopback port:

switch# configure terminal

switch(config)# hardware profile multicast service-reflect port ?

<1-48> Loopback port-num

switch(config)# hardware profile multicast service-reflect port 12

Related Commands

Command

Description

Configures the multicast service reflect mode.

ip igmp access-group

form of this command.

]

Syntax Description

Route-map policy name. The route map name can be a maximum of 100 alphanumeric characters.

Command Default

Disabled

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to enable a route-map policy:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp access-group my_access_group_policy

switch(config-if)#

This example shows how to disable a route-map policy:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp access-group

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp any-query-destination

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Examples

This example shows how to configure any destination IP address for IGMP general queries:

switch# configure terminal

switch(config)# ip igmp any-query-destination

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration for IGMP.

ip igmp enforce-router-alert

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the enforce router alert option check:

switch(config)# ip igmp enforce-router-alert

switch(config)#

This example shows how to disable the enforce router alert option check:

switch(config)# no ip igmp enforce-router-alert

switch(config)#

Related Commands

Command

Description

Displays information about the IGMP running-system configuration.

ip igmp event-history

form of this command.

Syntax Description

Configures the IGMP CLI event history buffer size.

Configures the error event history buffer size.

Configures the IGMP group debug event history buffer size.

Configures the IGMP group-event event history buffer size.

Configures the IGMP HA event history buffer size.

Configures the IGMP interface debug event history buffer size.

Configures the IGMP interface-event event history buffer size.

Configures the message event history buffer size.

Configures the IGMP mtrace event history buffer size.

Configures the IGMP policy event history buffer size.

Configures the statistics event history buffer size.

Configures the IGMP VRF event history buffer size.

Specifies the size of the buffer to allocate.

.

Command Default

All history buffers are allocated as small.

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IGMP HA event history buffer size:

switch(config)# ip igmp event-history ha size large

switch(config)#

Related Commands

Command

Description

Clears the contents of IGMP event history buffers.

Displays information in the IGMP event history buffers.

Displays information about the IGMP running-system configuration.

ip igmp flush-routes

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The routes are not flushed.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display whether flush routes are configured, use this command line:

switch(config)# show running-config | include flush-routes

This command does not require a license.

Examples

This example shows how to remove routes when the IGMP process is restarted:

switch(config)# ip igmp flush-routes

switch(config)#

This example shows how to leave routes in place when the IGMP process is restarted:

switch(config)# no ip igmp flush-routes

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip igmp global-leave-ignore-gss-mrt

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

When you use this command, the switch uses the configured Maximum Response Time (MRT) value in group-specific queries against a lower MRT value in response to IGMP global leave messages (IGMP leave reports to group 0.0.0.0).

This command does not require a license.

Examples

This example shows how to set the MRT for IGMP general queries:

switch# configure terminal

switch(config)# ip igmp global-leave-ignore-gss-mrt

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration for IGMP.

ip igmp group-timeout

form of this command.

]

Syntax Description

Timeout in seconds. The range is from 3 to 65,535. The default is 260.

Command Default

The group membership timeout is 260 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a group membership timeout:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp group-timeout 200

switch(config-if)#

This example shows how to reset a group membership timeout to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp group-timeout

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp immediate-leave

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The immediate leave feature is disabled.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command only when there is one receiver behind the interface for a given group.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to enable the immediate leave feature:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp immediate-leave

switch(config-if)#

This example shows how to disable the immediate leave feature:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp immediate-leave

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp join-group

form of this command.

}

}

Syntax Description

Multicast group IP address.

(Optional) Configures a source IP address for the IGMPv3 (S,G) channel.

Specifies the route-map policy name that defines the group prefixes where this feature is applied. The route map name can be a maximum of 63 alphanumeric characters.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

If you specify only the group address, the (*, G) state is created. If you specify the source address, the (S, G) state is created.

command. You can specify the group prefix and source prefix.

Note A source tree is built for the (S, G) state only if you enable IGMPv3.

Caution When you enter this command, the traffic generated is handled by the device CPU, not the hardware.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to statically bind a group to an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp join-group 230.0.0.0

switch(config-if)#

This example shows how to remove a group binding from an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp join-group 230.0.0.0

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp last-member-query-count

form of this command.

]

Syntax Description

Query count. The range is from 1 to 5. The default is 2.

Command Default

The query count is 2.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp last-member-query-count 3

switch(config-if)#

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp last-member-query-count

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp last-member-query-response-time

form of this command.

]

Syntax Description

Query interval in seconds. The range is from 1 to 25. The default is 1.

Command Default

The query interval is 1 second.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp last-member-query-response-time 3

switch(config-if)#

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp last-member-query-response-time

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp querier-timeout

form of this command.

]

Syntax Description

Timeout in seconds. The range is from 1 to 65,535. The default is 255.

Command Default

The querier timeout is 255 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp querier-timeout 200

switch(config-if)#

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp querier-timeout

switch(config-if)#

Related Commands

Command

Description

Configures a querier timeout.

Displays IGMP information about the interface.

ip igmp query-interval

form of this command.

]

Syntax Description

Interval in seconds. The range is from 1 to 18,000. The default is 125.

Command Default

The query interval is 125 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp query-interval 100

switch(config-if)#

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp query-interval

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp query-max-response-time

form of this command.

]

Syntax Description

Query maximum response time in seconds. The range is from 1 to 25. The default is 10.

Command Default

The query maximum response time is 10 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a query maximum response time:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp query-max-response-time 15

switch(config-if)#

This example shows how to reset a query maximum response time to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp query-max-response-time

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp query-timeout

form of this command.

]

Syntax Description

Timeout in seconds. The range is from 1 to 65,535. The default is 255.

Command Default

The query timeout is 255 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp query-timeout 200

switch(config-if)#

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp query-timeout

switch(config-if)#

Related Commands

Command

Description

Configures a querier timeout.

Displays IGMP information about the interface.

ip igmp report-link-local-groups

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to enable sending reports to link-local groups:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp report-link-local-groups

switch(config-if)#

This example shows how to disable sending reports to link-local groups:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp report-link-local-groups

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp report-policy

form of this command.

]

Syntax Description

Route-map policy name. The route name is a maximum of 100 alphanumeric characters.

Command Default

Disabled

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

You can configure the route map to prevent state from being created in the multicast routing table.

command.

command. You can specify the group prefix, group range, and source prefix to filter messages.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to enable an access policy for IGMP reports:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp report-policy my_report_policy

switch(config-if)#

This example shows how to disable an access policy for IGMP reports:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp report-policy

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp robustness-variable

form of this command.

]

Syntax Description

Robustness count. The range is from 1 to 7. The default is 2.

Command Default

The robustness count is 2.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a robustness count:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp robustness-variable 3

switch(config-if)#

This example shows how to reset a robustness count to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp robustness-variable

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp snooping (Global)

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

By default, snooping is enabled and the no ip igmp snooping is hidden.

If the global configuration of IGMP snooping is disabled, then all VLANs are treated as disabled, whether they are enabled or not.

This command does not require a license.

Examples

This example shows how to enable IGMP snooping:

switch(config)# ip igmp snooping

switch(config)#

This example shows how to disable IGMP snooping:

switch(config)# no ip igmp snooping

switch(config)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping (VLAN)

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

By default, snooping is enabled and the no ip igmp snooping is hidden.

If the global configuration of IGMP snooping is disabled, then all VLANs are treated as disabled, whether they are enabled or not.

This command does not require a license.

Examples

This example shows how to enable IGMP snooping on a VLAN interface:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping

switch(config-vlan)#

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping access-group

form of this command.

Syntax Description

Specifies the use of a prefix-list policy as a filter.

Specifies the use of a route-map policy as a filter.

Specifies the name of the prefix-list or route-map policy.

Specifies an interface for filtering.

Specifies the type of interface and the slot number and port number.

Command Default

None.

Command Modes

VLAN configuration mode

Command History

Release

Modification

6.0(2)A4

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a filter for IGMP snooping access groups based on a prefix-list policy:

switch(config)# ip igmp snooping

switch(config)# vlan configuration 2

switch(config-vlan-config)# ip igmp snooping access-group prefix-list plist interface ethernet 1/2

This example shows how to configure a filter for IGMP snooping access groups based on a route-map policy:

switch(config)# ip igmp snooping

switch(config)# vlan configuration 2

switch(config-vlan-config)# ip igmp snooping access-group route-map rmap interface ethernet 1/2

Related Commands

Command

Description

Filters IGMP snooping reports by prefix-list or route-map policy

Displays information about the IGMP running-system configuration.

ip igmp snooping event-history

form of this command.

Syntax Description

Clears the multicast FIB distribution (MFDM) event history buffer.

Clears the MFDM sum event history buffer.

Clears the Routing Information Base (RIB) event history buffer.

Clears the VLAN event history buffer.

Clears the VLAN-event event history buffer.

Specifies the size of the buffer to allocate.

.

Command Default

All history buffers are allocated as small.

Command Modes

Switch profile configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

5.0(3)A1

Support was added to configure IGMP snooping event history buffers in a switch profile.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IGMP snooping VLAN event history buffer size:

switch(config)# ip igmp snooping event-history vlan size large

switch(config)#

Related Commands

Command

Description

Clears the contents of the IGMP snooping event history buffers.

Displays information in the IGMP snooping event history buffers.

Displays information about the IGMP running-system configuration.

Displays information about the switch profile and the configuration revision.

Creates and configures a switch profile.

ip igmp snooping explicit-tracking

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable tracking of IGMPv3 membership reports on a VLAN interface:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping explicit-tracking

switch(config-vlan)#

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping explicit-tracking

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping fast-leave

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

When you enable fast leave, the IGMP software assumes that no more than one host is present on each VLAN port.

This command does not require a license.

Examples

This example shows how to enable support of IGMPv2 hosts:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping fast-leave

switch(config-vlan)#

This example shows how to disable support of IGMPv2 hosts:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping fast-leave

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping last-member-query-interval

form of this command.

]

Syntax Description

Query interval in seconds. The range is from 1 to 25. The default is 1.

Command Default

The query interval is 1.

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query interval in which the software removes a group:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping last-member-query-interval 3

switch(config-vlan)#

This example shows how to reset a query interval to the default:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping last-member-query-interval

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping link-local-groups-suppression

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

Switch profile configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

5.0(3)A1

Support was added to suppress IGMP reports from link-local groups in a switch profile.

Usage Guidelines

If this setting is disabled on the entire device, then it is disabled on all VLANs on device, irrespective of the specific VLAN setting.

This command does not require a license.

Examples

This example shows how to enable suppression of IGMP reports from link-local groups:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping link-local-groups-suppression

switch(config-vlan)#

This example shows how to disable suppression of IGMP reports from link-local groups:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping link-local-groups-suppression

switch(config-vlan)#

This example shows how to enable suppression of IGMP reports from link-local groups in a switch profile:

switch# configure sync

Enter configuration commands, one per line. End with CNTL/Z.

switch(config-sync)# switch-profile s5010

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# ip igmp snooping link-local-groups-suppression

switch(config-sync-sp)#

Related Commands

Command

Description

Displays IGMP snooping information.

Displays information about the switch profile and the configuration revision.

Creates and configures a switch profile.

ip igmp snooping mrouter interface

form of this command.

]}

]}

Syntax Description

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Command Default

None

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

The interface to the router must be in the selected VLAN.

This command does not require a license.

Examples

This example shows how to configure a static connection to a multicast router:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping mrouter interface ethernet 2/1

switch(config-vlan)#

This example shows how to remove a static connection to a multicast router:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping mrouter interface ethernet 2/1

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping optimise-multicast-flood

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Switch profile configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

5.0(3)A1

Support was added to configure IGMP snooping Optimized Multicast Flood in a switch profile.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure OMF on all VLANs:

switch(config)# ip igmp snooping optimise-multicast-flood

switch(config)#

This example shows how to remove OMF from all VLANs:

switch(config)# no ip igmp snooping optimise-multicast-flood

switch(config)#

This example shows how to configure OMF in a switch profile:

switch# configure sync

Enter configuration commands, one per line. End with CNTL/Z.

switch(config-sync)# switch-profile s5010

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# ip igmp snooping optimise-multicast-flood

switch(config-sync-sp)#

Related Commands

Command

Description

Displays IGMP snooping information.

Displays information about the switch profile and the configuration revision.

Creates and configures a switch profile.

ip igmp snooping querier

form of this command.

]

Syntax Description

Querier IP address.

Command Default

None

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

The querier IP address cannot be a multicast address.

This command does not require a license.

Examples

This example shows how to configure a snooping querier:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping querier 192.168.0.106

switch(config-vlan)#

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping querier

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping report-policy

form of this command.

Syntax Description

Specifies the use of a prefix-list policy as a filter.

Specifies the use of a route-map policy as a filter.

Specifies the name of the prefix-list or route-map policy.

Specifies an interface for filtering.

Specifies the type of interface and the slot number and port number.

Command Default

None.

Command Modes

VLAN configuration mode

Command History

Release

Modification

6.0(2)A4

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a filter for IGMP snooping reports based on a prefix-list policy:

switch(config)# ip igmp snooping

switch(config)# vlan configuration 2

switch(config-vlan-config)# ip igmp snooping report-policy prefix-list plist interface ethernet 1/2

This example shows how to configure a filter for IGMP snooping reports based on a route-map policy:

switch(config)# ip igmp snooping

switch(config)# vlan configuration 2

switch(config-vlan-config)# ip igmp snooping report-policy route-map rmap interface ethernet 1/2

Related Commands

Command

Description

Filters access groups by prefix-list or route-map policy.

Displays information about the IGMP running-system configuration.

ip igmp snooping report-suppression

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

Switch profile configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

5.0(3)A1

Support was added to configure IGMP snooping report suppression in a switch profile.

Usage Guidelines

When you disable report suppression, all IGMP reports are sent as is to multicast-capable routers.

This command does not require a license.

Examples

This example shows how to enable limiting the membership report traffic:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping report-suppression

switch(config-vlan)#

This example shows how to disable limiting the membership report traffic:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping report-suppression

switch(config-vlan)#

This example shows how to enable limiting the membership report traffic in a switch profile:

switch# configure sync

Enter configuration commands, one per line. End with CNTL/Z.

switch(config-sync)# switch-profile s5010

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# ip igmp snooping report-suppression

switch(config-sync-sp)#

Related Commands

Command

Description

Displays IGMP snooping information.

Displays information about the switch profile and the configuration revision.

Creates and configures a switch profile.

ip igmp snooping static-group

form of this command.

]}

]}

Syntax Description

Group IP address.

(Optional) Configures a static (S, G) channel for the source IP address.

Specifies an interface for the static group.

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Command Default

None

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a static member of a multicast group:

switch(config)# vlan 1

switch(config-vlan)# ip igmp snooping static-group 230.0.0.1 interface ethernet 2/1

switch(config-vlan)#

This example shows how to remove a static member of a multicast group:

switch(config)# vlan 1

switch(config-vlan)# no ip igmp snooping static-group 230.0.0.1 interface ethernet 2/1

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping v3-report-suppression (Global)

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disbled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure IGMPv3 report suppression and proxy reporting for VLANs:

switch(config)# ip igmp snooping v3-report-suppression

switch(config)#

This example shows how to remove IGMPv3 report suppression:

switch(config)# no ip igmp snooping v3-report-suppression

switch(config)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp snooping syslog-threshold

form of this command.

no ip igmp snooping syslog-threshold

Syntax Description

Percentage of table capacity. The range is from 1 to 100. The default value is 90 percent.

Defaults

The IP IGMP snooping table threshold is 90 percent.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to set the syslog threshold to 20 percent for the IP IGMP snooping table:

switch# configure terminal

switch(config)# ip igmp snooping syslog-threshold 20

switch(config)#

Related Commands

Command

Description

Copies the running configuration to the startup configuration file.

Displays the information for the running configuration.

ip igmp snooping v3-report-suppression (switch profile)

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disbled

Command Modes

Switch profile configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure IGMPv3 report suppression in a switch profile:

switch# configure sync

Enter configuration commands, one per line. End with CNTL/Z.

switch(config-sync)# switch-profile s5010

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# ip igmp snooping v3-report-suppression

switch(config-sync-sp)#

Related Commands

Command

Description

Displays IGMP snooping information.

Displays information about the switch profile and the configuration revision.

Creates and configures a switch profile.

ip igmp snooping v3-report-suppression (VLAN)

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

VLAN configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

If this setting is disabled for the device, which is the default value, then it is disabled for all VLANs, irrespective of how you set this value for an individual VLAN. However, once you set the global setting to enabled, the settings for all the VLANs are enabled by default.

This command does not require a license.

Examples

This example shows how to configure IGMPv3 report suppression and proxy reporting for specified VLANs:

switch(config)# vlan 10-20

switch(config-vlan)# ip igmp snooping v3-report-suppression

switch(config-vlan)#

This example shows how to remove IGMPv3 report suppression on specified VLANs:

switch(config)# vlan 10-20

switch(config-vlan)# no ip igmp snooping v3-report-suppression

switch(config-vlan)#

Related Commands

Command

Description

Displays IGMP snooping information.

ip igmp ssm-translate

form of this command.

Syntax Description

command.

IP multicast address source.

Command Default

None

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display SSM translation commands, use this command line:

switch(config)# show running-config | include ssm-translation

This command does not require a license.

Examples

This example shows how to configure a translation:

switch(config)# ip igmp ssm-translate 232.0.0.0/8 10.1.1.1

switch(config)#

This example shows how to remove a translation:

switch(config)# no ip igmp ssm-translate 232.0.0.0/8 10.1.1.1

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip igmp startup-query-count

form of this command.

]

Syntax Description

Query count. The range is from 1 to 10. The default is 2.

Command Default

The query count is 2.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp startup-query-count 3

switch(config-if)#

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp startup-query-count

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp startup-query-interval

form of this command.

]

Syntax Description

Query interval in seconds. The range is from 1 to 18,000. The default is 31.

Command Default

The query interval is 31 seconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a startup query interval:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp startup-query-interval 25

switch(config-if)#

This example shows how to reset a startup query interval to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp startup-query-interval

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp state-limit

form of this command.

]

]]

Syntax Description

Maximum states allowed. The range is from 1 to 4,294,967,295.

(Optional) Specifies to use the route-map policy name for the reserve policy. The route map name can be a maximum of 100 alphanumeric characters.

(Optional) Maximum number of (*, G) and (S, G) entries allowed on the interface.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure a state limit:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp state-limit 5000

switch(config-if)#

This example shows how to remove a state limit:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp state-limit

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip igmp static-oif

form of this command.

}

}

Syntax Description

Multicast group IPv4 address. If you specify only the group address, the (*, G) state is created.

(Optional) Configures the source IP address for IGMPv3 and creates the (S, G) state.

Note A source tree is built for the (S, G) state only if you enable IGMPv3.

Specifies the route-map policy name that defines the group prefixes where this feature is applied. The route map name can be a maximum of 63 alphanumeric characters.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command.

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to statically bind a group to the OIF:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp static-oif 230.0.0.0

switch(config-if)#

This example shows how to remove a static binding from the OIF:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp static-oif 230.0.0.0

switch(config-if)#

Related Commands

Command

Description

Enables IPv4 PIM sparse mode on an interface.

Configures the interface as a routed interface.

Displays information about the IGMP local group membership.

ip igmp version

form of this command.

]

Syntax Description

Version number. The number is 2 or 3. The default is 2.

Command Default

The version number is 2.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to configure the IGMP version to use on an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip igmp version 3

switch(config-if)#

This example shows how to reset the IGMP version to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip igmp version

switch(config-if)#

Related Commands

Command

Description

Displays IGMP information about the interface.

ip mfwd mstatic

form of this command.

Syntax Description

Registers the multicast static routes.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

If the switch receives multicast traffic from a source that is not attached, a (S, G) route is not created and the traffic continuously enters the CPU.

Use this command after configuring multicast reverse path forwarding (RPF) static routes to create (S, G) routes and prevent the multicast traffic from coming to the CPU. For each multicast static route, the register messages are periodically sent to the rendezvous point (RP) and the Multicast Source Discovery Protocol (MSDP) Source-Active (SA) messages are sent to the peer.

This command does not require a license.

Examples

This example shows how to register a multicast forwarding static route:

switch(config)# ip mroute 192.0.2.33/24 192.0.2.1

switch(config)# ip mfwd mstatic register

switch(config)#

This example shows how to deregister a multicast forwarding static route:

switch(config)# no mfwd mstatic register

switch(config)#

Related Commands

Command

Description

Configures multicast reverse path forwarding (RPF) static routes.

Displays information about multicast routes.

Displays information about IGMP snooping.

ip mroute

form of this command.

]

]

Syntax Description

IP prefix in the format i.i.i.i.

IP network mask in the format m.m.m.m.

IP prefix and network mask length in the format x.x.x.x/m.

IP next-hop address in the format i.i.i.i.

IP next-hop prefix in the format i.i.i.i/m.

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the loopback interface. The loopback interface number is from 0 to 1023.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

Specifies the VLAN interface. The range is from 1 to 4094.

(Optional) Route preference. The range is from 1 to 255. The default is 1.

(Optional) Specifies the virtual routing and forwarding (VRF) context name. The name can be any case-sensitive, alphanumeric string up to 32 characters.

Command Default

The route preference is 1.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an RPF static route:

switch(config)# ip mroute 192.0.2.33/24 192.0.2.1

switch(config)#

This example shows how to remove an RPF static route:

switch(config)# no ip mroute 192.0.2.33/24 192.0.2.1

switch(config)#

Related Commands

Command

Description

Displays information about multicast routes.

ip msdp description

form of this command.

]

Syntax Description

IP address of MSDP peer.

Text description.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure an MSDP peer description:

switch(config)# ip msdp description 192.168.1.10 engineering peer

switch(config)#

This example shows how to remove an MSDP peer description:

switch(config)# no ip msdp description 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp event-history

form of this command.

Syntax Description

Configures the CLI event history buffer.

Configures the peer-events event history buffer.

Configures the routes event history buffer.

Configures the TCP event history buffer.

Specifies the size of the buffer to allocate.

.

Command Default

All history buffers are allocated as small.

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the size of the MSDP event history buffer:

switch(config)# ip msdp event-history events size medium

switch(config)#

Related Commands

Command

Description

Clears information in the IPv4 MRIB event history buffers.

Displays information in the IPv4 MRIB event history buffers.

Displays information about the running-system MSDP configuration.

ip msdp flush-routes

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The routes are not flushed.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display whether flush routes is configured, use this command line:

switch(config)# show running-config | include flush-routes

This command requires the LAN Base Services license.

Examples

This example shows how to configure flushing routes when the MSDP process is restarted:

switch(config)# ip msdp flush-routes

switch(config)#

This example shows how to configure leaving routes when the MSDP process is restarted:

switch(config)# no ip msdp flush-routes

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip msdp group-limit

form of this command.

Syntax Description

Limit on number of groups. The range is from 0 to 4294967295. The default is no limit.

Specifies the prefix to match sources against.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the maximum number of (S, G) entries to create for a source:

switch(config)# ip msdp group-limit 4000 source 192.168.1.0/24

switch(config)#

This example shows how to remove the limit entries to create:

switch(config)# no ip msdp group-limit 4000 source 192.168.1.0/24

switch(config)#

Related Commands

Command

Description

Displays information about the MSDP learned sources and group limit.

ip msdp keepalive

form of this command.

]

Syntax Description

IP address of an MSDP peer.

Keepalive interval in seconds. The range is from 1 to 60. The default is 60.

Keepalive timeout in seconds. The range is from 1 to 90. The default is 90.

Command Default

The keepalive interval is 60 seconds.

The keepalive timeout is 90 seconds.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure an MSDP peer keepalive interval and timeout:

switch(config)# ip msdp keepalive 192.168.1.10 60 80

switch(config)#

This example shows how to reset a keepalive interval and timeout to the default:

switch(config)# no ip msdp keepalive 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp mesh-group

form of this command.

]

Syntax Description

IP address of an MSDP peer in a mesh group.

Name of mesh-group.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a mesh group with a peer:

switch(config)# ip msdp mesh-group 192.168.1.10 my_admin_mesh

switch(config)#

This example shows how to remove a peer from a mesh group:

switch(config)# no ip msdp mesh-group 192.168.1.10 my_admin_mesh

switch(config)#

Related Commands

Command

Description

Displays information about MSDP mesh groups.

ip msdp originator-id

form of this command.

]

Syntax Description

Interface type. For more information, use the question mark (?) online help function.

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

Command Default

The MSDP process uses the RP address of the local system.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the IP address used in the RP field of SA messages:

switch(config)# ip msdp originator-id loopback0

switch(config)#

This example shows how to reset the RP address to the default:

switch(config)# no ip msdp originator-id loopback0

switch(config)#

Related Commands

Command

Description

Displays a summary of MDSP information.

ip msdp password

form of this command.

]

Syntax Description

IP address of an MSDP peer.

MD5 password.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to enable an MD5 password for a peer:

switch(config)# ip msdp password 192.168.1.10 my_password

switch(config)#

This example shows how to disable an MD5 password for a peer:

switch(config)# no ip msdp password 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays MDSP peer information.

ip msdp peer

form of this command.

]

]

Syntax Description

IP address of the MSDP peer.

Configures a local IP address for a TCP connection.

Interface type. For more information, use the question mark (?) online help function.

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

(Optional) Configures a remote autonomous system (AS) number.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

The software uses the source IP address of the interface for the TCP connection with the peer. If the AS number is the same as the local AS, then the peer is within the Protocol Independent Multicast (PIM) domain; otherwise, this peer is external to the PIM domain.

This command requires the LAN Base Services license.

Examples

This example shows how to configure an MSDP peer:

switch(config)# ip msdp peer 192.168.1.10 connect-source ethernet 1/0 remote-as 8

switch(config)#

This example shows how to remove an MSDP peer:

switch(config)# no ip msdp peer 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays a summary of MSDP information.

ip msdp reconnect-interval

form of this command.

]

Syntax Description

Reconnect interval in seconds. The range is from 1 to 60. The default is 10.

Command Default

The reconnect interval is 10 seconds.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a reconnect interval for the TCP connection:

switch(config)# ip msdp reconnect-interval 20

switch(config)#

This example shows how to reset a reconnect interval to the default:

switch(config)# no ip msdp reconnect-interval

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp sa-interval

form of this command.

]

Syntax Description

SA transmission interval in seconds. The range is from from 60 to 65,535. The default is 60.

Command Default

The SA message interval is 60 seconds.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display the SA interval configuration command, use this command line:

switch(config)# show running-config | include sa-interval

This command requires the LAN Base Services license.

Examples

This example shows how to configure an SA transmission interval:

switch(config)# ip msdp sa-interval 100

switch(config)#

This example shows how to reset the interval to the default:

switch(config)# no ip msdp sa-interval

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip msdp sa-limit

form of this command.

]

Syntax Description

IP address of an MSDP peer.

Number of (S, G) entries. The range is from 0 to 4294967295. The default is none.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a Source-Active (SA) limit for a peer:

switch(config)# ip msdp sa-limit 192.168.1.10 5000

switch(config)#

This example shows how to reset the limit to the default:

switch(config)# no ip msdp sa-limit 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp sa-policy in

form of this command.

Syntax Description

IP address of an MSDP peer.

Route-map policy name.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to enable filtering of incoming SA messages:

switch(config)# ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy in

switch(config)#

This example shows how to disable filtering:

switch(config)# no ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy in

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp sa-policy out

form of this command.

Syntax Description

IP address of an MSDP peer.

Route-map policy name.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to enable filtering of SA messages:

switch(config)# ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy out

switch(config)#

This example shows how to disable filtering:

switch(config)# no ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy out

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip msdp shutdown

form of this command.

Syntax Description

IP address of an MSDP peer.

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to disable an MSDP peer:

switch(config)# ip msdp shutdown 192.168.1.10

switch(config)#

This example shows how to enable an MSDP peer:

switch(config)# no ip msdp shutdown 192.168.1.10

switch(config)#

Related Commands

Command

Description

Displays information about MSDP peers.

ip multicast rpf select vrf

form of this command.

Syntax Description

Applies to a virtual routing and forwarding (VRF) instance. VRF for a RPF lookup.

The source VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Group range for the RPF select. The format is A.B.C.D/LEN with a maximum length of 32.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)A8(3)

This command was introduced.

Usage Guidelines

None

Examples

This example shows how to use the command:

switch(config)# ip multicast rpf select vrf red group-list 224.1.1.0/24

switch(config)#

Related Commands

Command

Description

Displays information about the IPv4 multicast routing table.

ip pim anycast-rp

form of this command.

Syntax Description

Anycast-RP address of the peer.

Address of the rendezvous point (RP) in the Anycast-RP set.

Command Default

None

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

Each command with the same Anycast-RP address forms an Anycast-RP set. The IP addresses of rendezvous points (RPs) are used for communication with RPs in the set.

To configure PIM Anycast-RP, you must configure the static RP address that will be used as the Anycast-RP address for all routes, and then configure the peer Anycast-RP address.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a PIM Anycast-RP peer:

switch# configure terminal

switch(config)# ip pim rp-address 192.0.2.3

switch(config)# ip pim anycast-rp 192.0.2.3 192.0.2.31

switch(config)#

This example shows how to remove a peer:

switch# configure terminal

switch(config)# no ip pim anycast-rp 192.0.2.3 192.0.2.31

switch(config)#

Related Commands

Command

Description

Configures an IPv4 PIM static RP address for a multicast group range.

Displays information about PIM RPs.

ip pim auto-rp listen

form of this command.

]}

]}]

Syntax Description

Specifies to listen to Auto-RP messages.

Specifies to forward Auto-RP messages.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to enable listening and forwarding of Auto-RP messages:

switch(config)# ip pim auto-rp listen forward

switch(config)#

This example shows how to disable listening and forwarding of Auto-RP messages:

switch(config)# no ip pim auto-rp listen forward

switch(config)#

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim auto-rp mapping-agent

form of this command.

]

]

Syntax Description

Interface type. For more information, use the question mark (?) online help function.

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

(Optional) Specifies the time-to-live (TTL) value for the scope of Auto-RP Discovery messages. The range is from 1 to 255. The default is 32.
argument.

Command Default

The TTL is 32.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to configure an Auto-RP mapping agent:

switch(config)# ip pim auto-rp mapping-agent ethernet 2/1

switch(config)#

This example shows how to remove the Auto-RP mapping agent configuration:

switch(config)# no ip pim auto-rp mapping-agent ethernet 2/1

switch(config)#

Related Commands

Command

Description

Configures a router to be on the edge of a PIM domain.

Configures a router as an Auto-RP mapping agent.

Displays information about PIM rendezvous points (RPs).

ip pim auto-rp mapping-agent-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command can be used on client routers where you can specify mapping agent addresses.

command in a route-map policy.

This command requires the LAN Base Services license.

Examples

This example shows how to enable a route-map policy to filter Auto-RP Discover messages:

switch(config)# ip pim auto-rp mapping-agent-policy my_mapping_agent_policy

switch(config)#

This example shows how to disable filtering:

switch(config)# no ip pim auto-rp mapping-agent-policy

switch(config)#

Related Commands

Command

Description

Displays information about PIM rendezvous points (RPs).

ip pim auto-rp rp-candidate

form of this command.

]}

]}

Syntax Description

Interface type. For more information, use the question mark (?) online help function.

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

Specifies the group range used for the access list.

(Optional) Specifies a time-to-live (TTL) value for the scope of Auto-RP Announce messages. The range is from 1 to 255. The default is 32.
argument.

(Optional) Specifies an Auto-RP Announce message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

Command Default

The Announce message interval is 60 seconds

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

keywords can be entered once and in any order.

command is an alternative form of this command.

Using a route map, you can add group ranges that this auto rendezvous point (RP) candidate-RP can serve.

Note Use the same configuration guidelines for the route-map auto-rp-range that you used when you create a route map for static RPs.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a PIM Auto-RP candidate RP:

switch(config)# ip pim auto-rp rp-candidate ethernet 2/1 group-list 239.0.0.0/24

switch(config)#

This example shows how to remove a PIM Auto-RP candidate RP:

switch(config)# no ip pim auto-rp rp-candidate ethernet 2/1 group-list 239.0.0.0/24

switch(config)#

Related Commands

Command

Description

Configures a PIM Auto-RP candidate RP.

Displays information about PIM-enabled interfaces.

ip pim auto-rp rp-candidate-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command in a route-map policy.

This command requires the LAN Base Services license.

Examples

This example shows how to allow the Auto-RP mapping agents to filter Auto-RP Announce messages:

switch(config)# ip pim auto-rp rp-candidate-policy my_policy

This example shows how to disable filtering:

switch(config)# no ip pim auto-rp rp-candidate-policy

switch(config)#

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim border

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The interface is not on a PIM border.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure an interface on a PIM border:

switch(config)# ip pim border

This example shows how to remove an interface from a PIM border:

switch(config)# no ip pim border

switch(config)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim bsr bsr-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command in a route-map policy.

This command requires the LAN Base Services license.

Examples

This example shows how to allow the BSR client routers to filter BSR messages:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim bsr bsr-policy my_bsr_policy

This example shows how to disable filtering:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim bsr bsr-policy

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM rendezvous points (RPs).

ip pim bsr-candidate

form of this command.

]

]

Syntax Description

(Optional) Specifies the BSR protocol RP-distribution configuration.

Interface type. For more information, use the question mark (?) online help function.

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

(Optional) Specifies the hash mask length used in BSR messages. The range is from 0 to 32. The default is 30.

(Optional) Specifies the BSR priority used in BSR messages. The range is from 0 to 255. The default is 64.

Command Default

The BSR priority is 64.

Command Modes

Global configuration mode

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

The interface specified is used to derive the BSR source IP address used in BSR messages.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a router as a BSR candidate:

switch(config)# ip pim bsr-candidate ethernet 2/2

This example shows how to remove a router as a BSR candidate:

switch(config)# no ip pim bsr-candidate

switch(config)#

Related Commands

Command

Description

Displays information about PIM rendezvous points (RPs).

ip pim bsr forward

form of this command.

]

]]

Syntax Description

Specifies to forward BSR and Candidate-RP messages.

(Optional) Specifies to listen to BSR and Candidate-RP messages.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

A router configured as either a candidate rendezvous point (RP) or a candidate BSR will automatically listen to and forward all BSR protocol messages, unless an interface is configured with the domain border feature.

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to forward BSR and Candidate-RP messages:

switch(config)# ip pim bsr forward

This example shows how to disable forwarding:

switch(config)# no ip pim bsr forward

switch(config)#

Related Commands

Command

Description

Enables listening to and forwarding of BSR messages.

Displays information about PIM RPs.

ip pim bsr listen

form of this command.

]

]]

Syntax Description

Specifies to listen to BSR and Candidate-RP messages.

(Optional) Specifies to forward BSR and Candidate-RP messages.

Command Default

Disabled

Command Modes

Global configuration mode

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

A router configured as either a candidate rendezvous point (RP) or a candidate BSR will automatically listen to and forward all BSR protocol messages, unless an interface is configured with the domain border feature.

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to listen to and forward BSR and Candidate-RP messages:

switch(config)# ip pim bsr listen forward

This example shows how to disable listening and forwarding:

switch(config)# no ip pim bsr listen forward

switch(config)#

Related Commands

Command

Description

Enables listening to and forwarding of BSR messages.

Displays information about PIM RPs.

ip pim bsr rp-candidate-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command in a route-map policy.

This command requires the LAN Base Services license.

Examples

This example shows how to filter Candidate-RP messages:

switch(config)# ip pim bsr rp-candidate-policy my_bsr_rp_candidate_policy

This example shows how to disable message filtering:

switch(config)# no ip pim bsr rp-candidate-policy

switch(config)#

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim dr-priority

form of this command.

]

Syntax Description

Priority value. The range is from 1 to 4294967295. The default is 1.

Command Default

The DR priority is 1.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure DR priority on an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim dr-priority 5

This example shows how to reset DR priority on an interface to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim dr-priority

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim event-history

form of this command.

Syntax Description

Configures the assert receive event history buffer.

Configures the CLI event history buffer.

Configures the hello event history buffer.

Configures the join-prune event history buffer.

Configures the null register event history buffer.

Configures the packet event history buffer.

Configures the rendezvous point (RP) event history buffer.

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

Command Default

All history buffers are allocated as small.

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the size of the PIM hello event history buffer:

switch(config)# ip pim event-history hello size medium

switch(config)#

Related Commands

Command

Description

Clears information in the IPv4 PIM event history buffers.

Displays information in the IPv4 PIM event history buffers.

Displays information about the running-system PIM configuration.

ip pim flush-routes

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The routes are not flushed.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display whether flush routes are configured, use this command line:

switch(config)# show running-config | include flush-routes

This command requires the LAN Base Services license.

Examples

This example shows how to remove routes when the PIM process is restarted:

switch(config)# ip pim flush-routes

switch(config)#

This example shows how to leave routes in place when the PIM process is restarted:

switch(config)# no ip pim flush-routes

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip pim hello-authentication ah-md5

form of this command.

]

Syntax Description

MD5 authentication key. You can enter an unencrypted (cleartext) key, or one of these values followed by a space and the MD5 authentication key:

- 0—Specifies an unencrypted (cleartext) key

- 3—Specifies a 3-DES encrypted key

- 7—Specifies a Cisco Type 7 encrypted key

The key can be from 1 to 16 characters.

Command Default

Disabled

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

Triple Data Encryption Standard (3-DES) is a strong form of encryption (168-bit) that allows sensitive information to be transmitted over untrusted networks. Cisco Type 7 encryption uses the algorithm from the Vigenère cipher.

This command requires the LAN Base Services license.

Examples

This example shows how to enable a 3-DES encrypted key for PIM hello-message authentication:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim hello-authentication ah-md5 3 myauthkey

This example shows how to disable PIM hello-message authentication:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim hello-authentication ah-md5

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim hello-interval

form of this command.

]

Syntax Description

Interval in milliseconds. The range is from 1 to 18,724,286. The default is 30000.

Command Default

The PIM hello interval is 30,000 milliseconds.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the PIM hello-message interval on an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim hello-interval 20000

This example shows how to reset the PIM hello-message interval on an interface to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim hello-interval

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim jp-policy

form of this command.

]

]

Syntax Description

Route-map policy name.

Specifies that the system applies a filter only for incoming messages.

Specifies that the system applies a filter only for outgoing messages.

Command Default

Disabled; no filter is applied for either incoming or outgoing messages.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

keyword. When you enter the command with no keywords, that is no explicit direction, the system rejects further configurations if given with explicit direction.

command to filter incoming messages. You can configure the route map to prevent state from being created in the multicast routing table.

command.

This command requires the LAN Base Services license.

Examples

This example shows how to filter PIM join-prune messages:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim jp-policy my_jp_policy

This example shows how to disable filtering:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim jp-policy

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim log-neighbor-changes

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to generate syslog message that list the PIM neighbor state changes:

switch(config)# ip pim log-neighbor-changes

This example shows how to disable logging:

switch(config)# no ip pim log-neighbor-changes

switch(config)#

Related Commands

Command

Description

Configures the logging level of PIM messages.

ip pim neighbor-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Forms adjacency with all neighbors.

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command in a route-map policy to specify which groups to become adjacent to.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a policy that determines which PIM neighbors should become adjacent:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim neighbor-policy

This example shows how to reset to the default:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim neighbor-policy

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim pre-build-spt

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Joins are triggered only if the OIF list is not empty.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1(2)

This command was introduced.

Usage Guidelines

command.

By default, PIM (S,G) joins are triggered upstream only if the OIF-list for the (S,G) is not empty. It is useful in certain scenarios to prebuild the SPTs and maintain the (S,G) states even when the system is not forwarding on these routes.

This command requires the LAN Base Services license.

Examples

This example shows how to prebuild the SPT in the absence of receivers:

switch(config)# vrf context Enterprise

switch(config-vrf)# ip pim pre-build-spt

switch(config-vrf)#

Related Commands

Command

Description

Displays information about PIM routes.

ip pim register-policy

form of this command.

]

Syntax Description

Route-map policy name.

Command Default

Disabled

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command in a route-map policy to specify the group or group and source addresses whose register messages that should be filtered.

This command requires the LAN Base Services license.

Examples

This example shows how to enable filtering of PIM Register messages:

switch(config)# ip pim register-policy my_register_policy

This example shows how to disable message filtering:

switch(config)# no ip pim register-policy

switch(config)#

Related Commands

Command

Description

Displays statistics for PIM Register messages.

ip pim register-rate-limit

form of this command.

]

Syntax Description

Rate in packets per second. The range is from 1 to 65,535.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a rate limit for PIM data registers:

switch(config)# ip pim register-rate-limit 1000

This example shows how to remove a rate limit:

switch(config)# no ip pim register-rate-limit

switch(config)#

Related Commands

Command

Description

Displays information about the PIM configuration.

ip pim register-source

To configure the IP source address of a register message to an interface address other than the outgoing interface address of the designated router (DR) leading toward the rendezvous point (RP), use the ip pim register-source command. To remove the IP source address register message configuration, use the no form of this command.

ip pim register-source [ethernet slot/port | loopback if_number | port-channel pc_number | tunnel tunne_number | vlan vlan_number]

no ip pim register-source [ethernet slot/port | loopback if_number | port-channel pc_number | tunnel tunne_number | vlan vlan_number]

Syntax Description

ethernet slot/port

(Optional) Specifies the Ethernet interface. The range is from 1 to 255.

loopback if_number

(Optional) Specifies the virtual interface. The range is from 0 to 1023.

port-channel pc_number

(Optional) Specifies the port-channel number. The range is from 1 to 4096.

tunnel tunnel_number

(Optional) Specifies the tunnel interface. The range is from 0 to 4095.

vlan vlan_number

(Optional) Specifies the VLAN interface. The range is from 1 to 4094.

Command Default

By default, the IP address of the outgoing interface of the DR leading toward the RP is used as the IP source address of a register message.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command is required only when the IP source address of a register message is not a uniquely routed address to which the RP can send packets.This situation might occur if the source address is filtered so that packets sent to it are not be forwarded or if the source address is not unique to the network. In these cases, the replies sent from the RP to the source address fail to reach the DR, which results in Protocol Independent Multicast sparse mode (PIM-SM) protocol failures.

If no IP source address is configured or if the configured source address is not in service, the IP address of the outgoing interface of the DR leading toward the RP is used as the IP source address of the register message.

We recommend that you use a loopback interface with an IP address that is uniquely routed throughout the PIM-SM domain.

This command requires the LAN Base Services license.

Examples

This example shows how to configure the IP source address of the register message:

switch(config)# vrf context Enterprise

switch(config-vrf)# ip pim register-source ethernet 2/3

switch(config-vrf)#

This example shows how to remove the IP source address register message configuration:

switch(config-vrf)# no ip pim register-source ethernet 2/3

switch(config-vrf)#

Related Commands

Command

Description

Displays information about the PIM configuration.

ip pim rp-address

form of this command.

]

]

Syntax Description

IP address of a router which is the RP for a group range.

(Optional) Specifies a group range for a static RP.

(Optional) Specifies the RP address. The RP address overrides the dynamically learned RP addresses.

(Optional) Specifies a route-map policy name.

Command Default

The group range is treated in ASM or Bidir mode.

Command Modes

Global configuration mode

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command.

Customers can use this “override” provision, if they want the static RPs always to override the dynamic ones.

Matches the group, RP, and RP type specified. You can specify the RP type (ASM or Bidir). This configuration method requires the group and RP specified.

Note BSR RP, auto-RP, and static RP cannot use the group-range keyword. This command allows both permit or deny. Some match mask commands do not allow permit or deny.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a PIM static RP address for a serving group range and to override any dynamically learned (through BSR) RP addresses:

switch(config)# ip pim rp-address 1.1.1.1 group-list 225.1.0.0/16 override

This example shows how to configure a PIM static RP address for a group range:

switch(config)# ip pim rp-address 192.0.2.33 group-list 224.0.0.0/9

This example shows how to remove a static RP address:

switch(config)# no ip pim rp-address 192.0.2.33

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim rp-candidate

form of this command.

]

]

Syntax Description

(Optional) Specifies the BSR protocol RP-distribution configuration.

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the loopback interface. The loopback interface number is from 0 to 1023.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

Specifies a group range handled by the RP.

(Optional) Specifies the RP priority used in candidate-RP messages. The range is from 0 to 65,535. The default is 192.

(Optional) Specifies the BSR message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

Command Default

The BSR message interval is 60 seconds.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

We recommend that you configure the candidate RP interval to be a minimum of 15 seconds.

Using this route map, you can add a range of group lists that this candidate-RP can serve.

Note Use the same configuration guidelines for the route-map auto-rp-range that you used when you created a route map for static RPs.

This command requires the LAN Base Services license.

Examples

This example shows how to configure the router as a PIM BSR RP candidate:

switch(config)# ip pim rp-candidate ethernet 2/11 group-list 239.0.0.0/24

This example shows how to remove the router as an RP candidate:

switch(config)# no ip pim rp-candidate

switch(config)#

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim send-rp-announce

form of this command.

]}

]}

Syntax Description

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the loopback interface. The loopback interface number is from 0 to 1023.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

Specifies a group range handled by the RP.

(Optional) Specifies a time-to-live (TTL) value for the scope of Auto-RP Announce messages. The range is from 1 to 255. The default is 32.
argument.

(Optional) Specifies an Auto-RP Announce message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

Command Default

The Auto-RP Announce message interval is 60 seconds.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

keywords can be entered once and in any order.

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a PIM Auto-RP candidate RP:

switch(config)# ip pim send-rp-announce ethernet 2/1 group-list 239.0.0.0/24

This example shows how to remove a PIM Auto-RP candidate RP:

switch(config)# no ip pim send-rp-announce ethernet 2/1 group-list 239.0.0.0/24

switch(config)#

Related Commands

Command

Description

Configures a PIM Auto-RP candidate RP.

Displays information about PIM-enabled interfaces.

ip pim send-rp-discovery

form of this command.

]

]

Syntax Description

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the loopback interface. The loopback interface number is from 0 to 1023.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Specifies the time-to-live (TTL) value for the scope of Auto-RP Discovery messages. The range is from 1 to 255. The default is 32.
argument.

Command Default

The TTL is 32.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to configure an Auto-RP mapping agent:

switch(config)# ip pim send-rp-discovery ethernet 2/1

This example shows how to remove an Auto-RP mapping agent:

switch(config)# no ip pim send-rp-discovery ethernet 2/1

switch(config)#

Related Commands

Command

Description

Displays information about PIM RPs.

Configures a router as an Auto-RP mapping agent.

Configures a router to be on the edge of a PIM domain.

ip pim sg-expiry-timer

form of the command.

]

]

Syntax Description

(Optional) Specifies sparse mode.

Expiry-timer interval. The range is from 181 to 57600 seconds.

(Optional) Specifies S,G values to which the timer applies. The route map name can be a maximum of 100 alphanumeric characters.

Command Default

The default expiry time is 180 seconds.

The timer applies to all (S, G) entries in the routing table.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure the expiry interval to 300 seconds for all (S, G) entries:

switch(config)# vrf context Enterprise

switch(config-vrf)# ip pim sg-expiry-timer 300

switch(config-vrf)#

Related Commands

Command

Description

Displays information about the PIM configuration.

ip pim sparse-mode

form of this command.

]

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to enable PIM sparse mode on an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# ip pim sparse-mode

This example shows how to disable PIM on an interface:

switch(config)# interface ethernet 2/2

switch(config-if)# no switchport

switch(config-if)# no ip pim

switch(config-if)#

Related Commands

Command

Description

Displays information about PIM-enabled interfaces.

ip pim spt-threshold infinity

To create the IPv4 Protocol Independent Multicast (PIM) (*, G) state only (where no source state is created), use the ip pim spt-threshold infinity command. To remove the creation of the shared tree state only, use the no form of this command.

ip pim spt-threshold infinity group-list route-map-name

no ip pim spt-threshold infinity [group-list route-map-name]

Syntax Description

route-map-name

Route-map policy name that defines the group prefixes where this feature is applied. A route-map policy name can be a maximum of 100 alphanumeric characters.

Command Default

None

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1(2)

This command was introduced.

Usage Guidelines

You can specify up to 500 sequence lines in a route map.

The match ip multicast command is the only match command that is evaluated in the route map. You can specify the group prefix to filter messages with the match ip multicast command.

You must have enabled PIM before you can use the ip pim spt-threshold infinity command.

This command requires the Enterprise Services license.

Examples

This example shows how to create the PIM (*, G) state only for the group prefixes defined in my_group_map:

switch(config)# ip pim spt-threshold infinity group-list my_group_map

This example shows how to remove the creation of the (*, G) state only:

switch(config)# no ip pim spt-threshold infinity

Related Commands

Command

Description

Displays information about PIM RPs.

ip pim ssm policy

form of this command.

Syntax Description

Route-map policy name that defines the group prefixes where this feature is applied.

Command Default

The SSM range is 232.0.0.0/8.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a group range for SSM:

switch(config)# ip pim ssm policy my_ssm_policy

This example shows how to reset the group range to the default:

switch(config)# no ip pim ssm policy my_ssm_policy

switch(config)#

Related Commands

Command

Description

Displays information about PIM group ranges.

ip pim ssm range

keyword.

}

}

Syntax Description

List of up to four group range prefixes.

Removes all group ranges.

Command Default

The SSM range is 232.0.0.0/8.

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command.

This command requires the LAN Base Services license.

Examples

This example shows how to configure a group range for SSM:

switch(config)# ip pim ssm range 239.128.1.0/24

This example shows how to reset the group range to the default:

switch(config)# no ip pim ssm range none

This example shows how to remove all group ranges:

switch(config)# ip pim ssm range none

switch(config)#

Related Commands

Command

Description

Displays information about PIM group ranges.

ip pim ssm route-map

form of this command.

Syntax Description

Route-map policy name. The name can be a maximum of 63 characters.

Command Default

None

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to configure a group range policy for SSM:

switch(config)# ip pim ssm route-map my_ssm_policy

switch(config)#

Related Commands

Command

Description

Displays information about IPV4 PIM routes.

ip pim state-limit

form of this command.

]

]]

Syntax Description

Maximum number of (*, G) and (S, G) entries allowed in this VRF. The range is from 1 to 429,496,7295. The default is no limit.

(Optional) Specifies that a number of state entries are to be reserved for the routes specified in a policy map.

(Optional) Route-map policy name.

(Optional) Maximum reserved (*, G) and (S, G) entries allowed in this VRF. Must be less than or equal to the maximum states allowed. The range is from 1 to 429,496,7295.

Command Default

None

Command Modes

VRF configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display commands where state limits are configured, use this command line:

switch(config)# show running-config | include state-limit

This command requires the LAN Base Services license.

Examples

This example shows how to configure a state entry limit with a number of state entries reserved for routes in a policy map:

switch(config)# ip pim state-limit 100000 reserved my_reserved_policy 40000

This example shows how to remove the limits on state entries:

switch(config)# no ip pim state-limit

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip routing multicast event-history

form of this command.

Syntax Description

Configures the CLI event history buffer.

Configures the multicast FIB distribution (MFDM) debug event history buffer.

Configures the multicast FIB distribution (MFDM) non-periodic events event history buffer.

Configures the MFDM sum event history buffer.

Configures the RIB event history buffer.

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

Command Default

All history buffers are allocated as small.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

To display configured buffer sizes, use this command line:

switch(config)# show running-config | include “ip routing”

This command does not require a license.

Examples

This example shows how to configure the size of the MRIB MFDM event history buffer:

switch(config)# ip routing multicast event-history mfdm size large

switch(config)#

Related Commands

Command

Description

Clears information in the IPv4 MRIB event history buffers.

Displays information in the IPv4 MRIB event history buffers.

Displays information about the running-system configuration.

ip routing multicast software-replicate

form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

No software replication.

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

By default, these packets are used by the software only for (S,G) state creation and then dropped.

This command does not require a license.

Examples

This example shows how to enable software replication of IPv4 PIM ASM packets:

switch(config)# ip routing multicast software-replicate

switch(config)#

Related Commands

Command

Description

Displays information about the running-system configuration.

ip service-reflect mode

Use the ip service-reflect mode to configure the multicast service reflect mode. The feature is supported in the following flavors: fas t-pass mode, fast -pas s no-rewrite mode, and regular mode.

The regular mode translates theG1 to G2 interface and it rewrites the MAC address for G2, as per the multicast protocol.

The fast-pass mode translates the G1 to G2 interface and it does not rewrite the MAC address for the G2 interface. The G2 MAC address still holds good as per the multicast protocol, as the /9mask-length restriction keeps the MAC address of the G2 interface same as the MAC address of theG1 interface. The mask-length for the group translation must-be less than equal to 9 for this mode.

The fast-pass mode with no-rewrite option translates the G1 to G2 interface but it does not rewrite the MAC address for the G2 interface. The MAC address of the G2 interface does not hold good as per the multicast protocol. It is up to the user to use this mode option with due diligence, if the MAC address of the G2 interface is not taken account in their topology. The mask-length for the group translation has no restriction.

Syntax Description

Regular mode for the SR feature

fast-pass mode

Fast-pass mode for the SR feature

fast-pass no-rewrite mode

Fast-pass no-rewrite mode for the SR feature

Command Default

None

Command Modes

Configuration mode

Command History

Release

Modification

6.0(2)A6(1)

Regular mode command was introduced.

6.0(2)A6(2)

Fast-pass mode command was introduced.

Usage Guidelines

Use the ip service-reflect mode to configure the multicast service reflect mode.

Examples

This example shows how to configure the regular mode:

The following example shows how to configure the fast-pass or fast-pass no-rewrite mode:

(config)# ip service-reflect mode fast-pass

OR

(config)# ip service-reflect mode fast-pass no-rewrite

See the Cisco Nexus 3548 Switch NX-OS Multicast Routing Configuration Guide, Release 6.x for the complete configuration of the SR feature.

Related Commands

Command

Description

hardware profile multicast service-reflect port

Creates a multicast service reflect loopback port from the range <1-48>. This CLI is applicable only for the regular mode.

ip service-reflect destination <G1> to <G2> mask-len <M1> source <S1> to <S2> mask-len <M2>

Use the ip service-reflect destination <G1> to <G2> mask-len <M1> source <S1> to <S2> mask-len <M2> command to specify the rule to NAT translate the ingress interface (S1,G1) to an egress interface (S2,G2).

Syntax Description

Command Default

None

Command Modes

Configuration mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

Use the ip service-reflect destination <G1> to <G2> mask-len <M1> source <S1> to <S2> mask-len <M2> command to specify the rule to NAT translate the ingress interface (S1,G1) to an egress interface (S2,G2).

Examples

See the following examples for the default (32) subnet-masks and non-default (less than 32) subnet-masks:

Example 1:

#ip service-reflect destination 225.0.0.2 to 226.0.0.2 mask-len 32 source 10.0.0.2 to 12.0.0.2 mask-len 32

The configuration rule in example 1 installs the following (S1,G1) to (S2,G2) mapping rules:

a. (225.0.0.2, 10.0.0.2) -> (226.0.0.2, 12.0.0.2)

Example 2:

#ip service-reflect destination 225.0.0.2 to 226.0.0.2 mask-len 31 source 10.0.0.2 to 12.0.0.2 mask-len 31

The configuration rule in example 2 installs the following (S1,G1) to (S2,G2) mapping rules:

a. (225.0.0.2, 10.0.0.2) -> (226.0.0.2, 12.0.0.2)

b. (225.0.0.3, 10.0.0.3) -> (226.0.0.3, 12.0.0.3)

a. (225.0.0.2, 10.0.0.3) -> (226.0.0.2, 12.0.0.3)

b. (225.0.0.3, 10.0.0.2) -> (226.0.0.3, 12.0.0.2)

Example 3:

#ip service-reflect destination 225.0.0.2 to 226.0.0.2 mask-len 31 source 10.0.0.2 to 12.0.0.2 mask-len 32

The configuration rule in example 3 installs the following (S1,G1) to (S2,G2) mapping rules:

a. (225.0.0.2, 10.0.0.2) -> (226.0.0.2, 12.0.0.2)

b. (225.0.0.3, 10.0.0.2) -> (226.0.0.3, 12.0.0.2)

ip service-reflect destination <G1> to <G2> mask-len <M1> source <S2>

Use the ip service-reflect destination <G1> to <G2> mask-len <M1> source <S2> command to specify the rule to NAT translate the ingress interface (*,G1) to an egress interface (S2,G2).

Syntax Description

S1: A.B.C.D Incoming Source Address that is not taken into account

Command Default

None

Command Modes

Configuration mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

Use the ip service-reflect destination <G1> to <G2> mask-len <M1> source <S2> command to specify the rule to NAT translate the ingress interface (*,G1) to an egress interface (S2,G2).

Examples

See the following examples for the default (32) subnet-masks:

Example:

#ip service-reflect destination 225.0.0.2 to 226.0.0.2 mask-len 32 source 12.0.0.2 // G1 to G2, Any S1 to S2 (12.0.0.2)

no switchport

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

You can configure any Ethernet port as a routed interface. When you configure an interface as a Layer 3 interface, any configuration specific to Layer 2 on this interface is deleted.

command.

This command requires the LAN Base Services license.

Examples

This example shows how to enable an interface as a Layer 3 routed interface:

switch(config)# interface ethernet 1/5

switch(config-if)# no switchport

switch(config-if)#

This example shows how to configure a Layer 3 interface as a Layer 2 interface:

switch(config)# interface ethernet 1/5

switch(config-if)# switchport

switch(config-if)#

Related Commands

Command

Description

Saves the running configuration to the startup configuration file.

Sets a primary or secondary IP address for an interface.

Displays interface information.

Multicast Routing Show Commands

commands available on the Cisco Nexus 3548 switch.

Note The internal CLI commands are not supported on the Cisco Nexus Series switches.

show forwarding distribution ip igmp snooping

command.

]]]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

(Optional) Specifies a group address.

(Optional) Specifies a source address.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about Layer 2 IGMP snooping multicast FIB distribution:

switch(config)# show forwarding distribution ip igmp snooping

Related Commands

Command

Description

Displays the running configuration information.

show forwarding distribution multicast

command.

]

Syntax Description

(Optional) Displays message information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about multicast distribution messages:

switch(config)# show forwarding distribution multicast

Number of Multicast FIB Processes Active: 1

Slot FIB State

1 ACTIVE

switch(config)#

Related Commands

Command

Description

Displays the running configuration information.

show forwarding distribution multicast client

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the multicast FIB distribution client:

switch# show forwarding distribution multicast client

Number of Clients Registered: 1

Client-name Client-id Shared Memory Name

mrib 1 mrib-mfdm

switch#

Related Commands

Command

Description

Displays the running configuration information.

show forwarding distribution multicast outgoing-interface-list

command.

]

Syntax Description

Specifies the Layer 2 OIF list.

Specifies the Layer 3 OIF list.

(Optional) OIF list index.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the multicast OIF list for Layer 3:

switch# show forwarding distribution multicast outgoing-interface-list L3

Related Commands

Command

Description

Displays the running configuration information.

show forwarding distribution multicast route

command.

]

Syntax Description

(Optional) Specifies IPV4 information.

(Optional) Specifies IPV4 information.

(Optional) Specifies the multicast routing table ID. The range is from 0 to 2147483647.

(Optional) Specifies a virtual routing and forwarding (VRF) name. The name can be a maximum of 32 alphanumeric characters.

(Optional) Specifies an IPv4 multicast group.

IPv4 multicast group address.

(Optional) Mask for the group address.

(Optional) IPv4 multicast group prefix.

(Optional) Specifies an IPv4 multicast source.

IPv4 source address.

(Optional) Mask for the group address.

(Optional) IPv4 multicast source prefix.

(Optional) Displays the route counts.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about all the multicast FIB distribution routes:

switch(config)# show forwarding distribution multicast route

IPv4 Multicast Routing Table for table-id: 1

Total number of groups: 5

Legend:

C = Control Route

D = Drop Route

G = Local Group (directly connected receivers)

O = Drop on RPF Fail

P = Punt to supervisor

d = Decap Route

(*, 224.0.0.0/4), RPF Interface: NULL, flags: D

Received Packets: 0 Bytes: 0

Number of Outgoing Interfaces: 0

Null Outgoing Interface List

<--Output truncated-->

switch(config)#

Related Commands

Command

Description

Displays the running configuration information.

show forwarding ipv4 multicast route group <ip-address>

Use the show forwarding ipv4 multicast route group <ip-address> CLI command to find the egress counters for each specific multicast route group. The egress counters of the interface can be found, but if multiple groups are there, it is difficult to find the counters for each multicast group. The show forwarding ipv4 multicast group <ip-address> is the only command used for it, but the egress counters for this are not supported in Cisco Nexus 3548 Series switches.

Syntax Description

IP address of the multicast route group.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the egress counters for each specific multicast route group:

switch# show forwarding ipv4 multicast route group 225.1.1.1

(*, 225.1.1.1/32), RPF Interface: port-channel8, flags: G

Received Packets: 349 Bytes: 488600

Number of Outgoing Interfaces: 1

Outgoing Interface List Index: 1

Vlan200 Outgoing Packets:0 Bytes:0

(169.1.1.10/32, 225.1.1.1/32), RPF Interface: port-channel8, flags:

Received Packets: 1340171 Bytes: 1876239400

Number of Outgoing Interfaces: 1

Outgoing Interface List Index: 1

Vlan200 Outgoing Packets:0 Bytes:0

Related Commands

Command

Description

Displays the running configuration information.

show forwarding multicast outgoing-interface-list

command.

]

Syntax Description

(Optional) OIF list index. The OIF list index is from 1 to 65535.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the multicast FIB OIF list:

switch# show forwarding multicast outgoing-interface-list

Related Commands

Command

Description

Binds a multicast group to the outgoing interface (OIF).

Clears the IGMP statistics for an interface.

show forwarding multicast route

command.

Note Cisco NX-OS 3548 switch does not support per multicast group statistics command for the show forward multicast route command.

}]}

Syntax Description

(Optional) Displays information for a specified virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Displays information for all VRFs.

(Optional) Specifies IPv4.

(Optional) Specifies IPv4.

(Optional) Specifies an IPv4 multicast group address.

IPv4 multicast group address.

(Optional) IPv4 multicast group address mask.

(Optional) IPv4 multicast group prefix.

(Optional) Specifies an IPv4 multicast source address.

IPv4 multicast source address.

IPv4 multicast source address mask.

IPv4 multicast source prefix.

Displays route counts.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the IPv4 multicast FIB routes:

switch# show forwarding multicast route

This example shows how to display the summary information about the IPv4 multicast FIB routes:

switch# show forwarding multicast route summary

IPv4 Multicast Routing Table for Context "default"

Total number of routes: 0

Total number of (*,G) routes: 0

Total number of (S,G) routes: 0

Total number of (*,G-prefix) routes: 0

Group count: 0

Prefix insert fail count: 10

switch#

Related Commands

Command

Description

Clears the multicast routing table.

show forwarding multicast-sr loopback interface

command.

loopback interface

Syntax Description

This command does not have any arguments.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

command to display information about the loopback interface.

Examples

This example shows how to view the loopback interface list as displayed in the following example:

# sh forwarding multicast-sr loopback interface

Multicast SR loopback interface list

12

show hardware profile status

command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Examples

This example shows how to display the status of the multicast routing table:

switch# show hardware profile status

Warp Mode Hardware table usage:

Max Host Entries = 8192, Used = 625

Max Unicast LPM Entries = 4096, Used = 1963

Max Multicast LPM Entries = 8192, Used (L2:L3)= 7769 (2003:5766)

Max L2 Entries = 8192, Used = 162

switch#

Related Commands

Command

Description

Sets the maximum entries for the multicast routing table.

show ip igmp event-history

command.

}

Syntax Description

Displays events of type CLI.

Displays events of type debug.

Displays events of type error.

Displays events of type event.

Displays events of type HA.

Displays events of type msg.

Displays events of type mtrace.

Displays events of type policy.

Displays events of type statistics.

Displays events of type VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information in the IGMP HA event history buffer:

switch(config)# show ip igmp event-history ha

ha events for IGMP process

2011 Aug 30 09:10:40.124500 igmp [4421]: : Router-port PSS entry for vlan 1 upda

ted [count 1]

2011 Aug 30 09:09:39.810392 igmp [4421]: : Router-port PSS entry for vlan 1 upda

ted [count 0]

2011 Aug 29 08:44:12.368317 igmp [4421]: : Router-port PSS entry for vlan 1 upda

ted [count 1]

2011 Aug 29 08:39:24.860388 igmp [4421]: : Router-port PSS entry for vlan 1 upda

ted [count 0]

2011 Aug 26 09:52:58.390295 igmp [4421]: : Router-port PSS entry for vlan 1 upda

ted [count 1]

<--Output truncated-->

switch(config)#

Related Commands

Command

Description

Clears the contents of the IGMP event history buffers.

Configures the size of IGMP event history buffers.

sh int eth <slot/port> | i rate

> | i rate command to check the rate of the stream.

Syntax Description

Slot number on the switch.

Port number on the switch.

Specifies the rate of the stream.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

6.0(2)A6(1)

This command was introduced.

Usage Guidelines

Use this command to check the rate of the stream.

Examples

These examples show how to check the rate of the stream:

# sh int eth 1/10 | i rate

30 seconds input rate 1536904 bits/sec, 3000 packets/sec \\ 1X of (S1,G1) UDP stream

30 seconds output rate 208 bits/sec, 0 packets/sec

input rate 1.54 Mbps, 3.00 Kpps; output rate 152 bps, 0 pps

# sh int eth 1/12 | i rate

30 seconds input rate 3072112 bits/sec, 5999 packets/sec \\ 2X Stream

30 seconds output rate 2811704 bits/sec, 5999 packets/sec \\ 2X Stream

input rate 3.07 Mbps, 6.00 Kpps; output rate 3.05 Mbps, 6.00 Kpps

# sh int eth 1/11 | i rate

30 seconds input rate 160 bits/sec, 0 packets/sec

30 seconds output rate 1683024 bits/sec, 2999 packets/sec \\ 1X of (S2,G2) UDP stream

input rate 136 bps, 0 pps; output rate 1.52 Mbps, 3.00 Kpps

show ip igmp groups

command.

}]

Syntax Description

Source IP address.

(Optional) Multicast IP address of the single group to display.

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

(Optional) Specifies the VLAN. The range is from 1 to 4094.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to display information about the IGMP-attached group membership:

switch(config)# show ip igmp groups

Related Commands

Command

Description

Displays information about the IGMP-attached group membership.

show ip igmp interface

command.

}

}]

Syntax Description

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

Subinterface number. The range is from 1 to 4093.

Specifies the VLAN. The range is from 1 to 4094.

(Optional) Displays one line status per interface.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to display information about IGMP on an interface:

switch# show ip igmp interface vlan 5

This example shows how to display information about IGMP on an interface in a brief format:

switch# show ip igmp interface brief

Related Commands

Command

Description

Displays information about the running-system configuration.

show ip igmp local-groups

command.

}]

Syntax Description

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

(Optional) Specifies the VLAN. The range is from 1 to 4094.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to display information about IGMP local groups:

switch(config)# show ip igmp local-groups

Related Commands

Command

Description

Displays information about the running-system configuration.

show ip igmp route

command.

}]

Syntax Description

Source IP address.

(Optional) Multicast IP address of single group to display.

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

(Optional) Specifies the VLAN. The range is from 1 to 4094.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to display information about the IGMP-attached group membership:

switch# show ip igmp route

Related Commands

Command

Description

Displays information about the IGMP-attached group membership.

show ip igmp snooping

command.

]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093. The default is all VLANs.

Command Default

Displays all VLANs.

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about IGMP snooping information on a switch :

switch# show ip igmp snooping

Global IGMP Snooping Information:

IGMP Snooping enabled

Optimised Multicast Flood (OMF) disabled

IGMPv1/v2 Report Suppression enabled

IGMPv3 Report Suppression disabled

Link Local Groups Suppression enabled

IGMP Snooping information for vlan 1

IGMP snooping enabled

Optimised Multicast Flood (OMF) disabled

IGMP querier present, address: 10.1.1.7, version: 2, interface Ethernet1/13

Switch-querier disabled

IGMPv3 Explicit tracking enabled

IGMPv2 Fast leave disabled

IGMPv1/v2 Report suppression enabled

IGMPv3 Report suppression disabled

Link Local Groups suppression enabled

Router port detection using PIM Hellos, IGMP Queries

Number of router-ports: 1

Number of groups: 0

Active ports:

Eth1/11 Eth1/13

switch#

This example shows how to display information about IGMP snooping for a VLAN:

switch# show ip igmp snooping vlan 1

IGMP Snooping information for vlan 1

IGMP snooping enabled

Optimised Multicast Flood (OMF) disabled

IGMP querier present, address: 10.1.1.7, version: 2, interface Ethernet1/13

Switch-querier disabled

IGMPv3 Explicit tracking enabled

IGMPv2 Fast leave disabled

IGMPv1/v2 Report suppression enabled

IGMPv3 Report suppression disabled

Link Local Groups suppression enabled

Router port detection using PIM Hellos, IGMP Queries

Number of router-ports: 1

Number of groups: 0

Active ports:

Eth1/11 Eth1/13

switch#

Related Commands

Command

Description

Registers IP multicast forwarding (MFWD) static routes.

Enables IGMP snooping on specified VLAN interfaces.

show ip igmp snooping event-history

command.

}

Syntax Description

Displays the event history buffer of type multicast FIB distribution (MFDM).

Displays the event history buffer of type MFDM sum.

Displays the event history buffer of type VLAN.

Displays the event history buffer of type VLAN events.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information in the IGMP snooping VLAN event history buffer:

switch# show ip igmp snooping event-history vlan

vlan Events for IGMP Snoop process

2011 Sep 2 08:23:06.508225 igmp [4421]: : igmp_cl_output_l2: Before IP api ...

2011 Sep 2 08:23:06.508223 igmp [4421]: : igmp_cl_output_l2: ...

2011 Sep 2 08:23:06.508220 igmp [4421]: : Flooding the packet to <vlan 1> (iif

Ethernet1/11)

2011 Sep 2 08:23:06.508216 igmp [4421]: : Received a v2 leave on Ethernet1/11 f

or group 0.0.0.0

2011 Sep 2 08:23:06.508169 igmp [4421]: : Process a valid IGMP packet

2011 Sep 2 08:23:04.880614 igmp [4421]: : Not STP root, ignoring topology chang

e notification

2011 Sep 2 08:23:04.880605 igmp [4421]: : Received a STP Topology change notifi

cation

2011 Sep 2 08:23:04.508334 igmp [4421]: : igmp_cl_output_l2: Before IP api ...

2011 Sep 2 08:23:04.508332 igmp [4421]: : igmp_cl_output_l2: ...

2011 Sep 2 08:23:04.508330 igmp [4421]: : Flooding the packet to <vlan 1> (iif

Ethernet1/11)

<--Output truncated-->

switch#

Related Commands

Command

Description

Configures the size of the IGMP snooping event history buffers.

Clears information in the IGMP snooping event history buffers.

show ip igmp snooping explicit-tracking

command.

]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

argument, the system displays information for all VLANs.

This command does not require a license.

Examples

This example shows how to display information about explicit tracking for IGMP snooping for VLAN 33:

switch# show ip igmp snooping explicit-tracking vlan 33

Related Commands

Command

Description

Clears the IGMP snooping explicit host tracking information for VLANs.

Enables tracking of IGMPv3 membership reports from individual hosts for each port on a VLAN.

show ip igmp snooping groups

command.

]

Syntax Description

(Optional) Source address for route.

(Optional) Group address for route.

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

(Optional) Displays detailed information for the group.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about the group membership for IGMP snooping:

switch(config)# show ip igmp snooping groups

Related Commands

Command

Description

Displays the IGMP running configuration.

show ip igmp snooping mrouter

command.

]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the multicast routers detected by IGMP snooping:

switch(config)# show ip igmp snooping mrouter

Type: S - Static, D - Dynamic, I - Internal

Vlan Router-port Type Uptime Expires

1 Eth1/13 D 2d23h 00:04:59

switch(config)#

Related Commands

Command

Description

Displays the IGMP running configuration.

show ip igmp snooping querier

command.

]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about IGMP snooping queriers:

switch# show ip igmp snooping querier

Vlan IP Address Version Expires Port

1 7.1.1.7 v2 00:03:27 Ethernet1/13

switch#

Related Commands

Command

Description

Displays the IGMP running configuration.

show ip igmp snooping statistics

command.

]

Syntax Description

(Optional) Specifies a VLAN. The range is from 1 to 3967 and 4048 to 4093.

(Optional) Specifies the global statistics.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

When you use this command without any options, the system prints statistics for all VLANs.

This command does not require a license.

Examples

This example shows how to display information about IGMP snooping statistics for VLAN 1:

switch(config)# show ip igmp snooping statistics vlan 1

Related Commands

Command

Description

Displays the IGMP running configuration.

show ip mroute

command.

}]

Syntax Description

Group address for route.

Source address for route.

(Optional) Displays route counts and packet rates.

(Optional) Displays software-switched route counts only.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 multicast routes:

switch(config)# show ip mroute

IP Multicast Routing Table for VRF "default"

(*, 226.1.1.27/32), uptime: 04:13:17, igmp ip pim

Incoming interface: Vlan30, RPF nbr: 10.10.30.1, uptime: 04:13:16

Outgoing interface list: (count: 1)

Vlan203, uptime: 04:13:17, igmp

(193.168.1.13/32, 226.1.1.27/32), uptime: 04:13:13, ip mrib pim

Incoming interface: Ethernet1/2, RPF nbr: 10.10.20.1, uptime: 04:13:13

Outgoing interface list: (count: 1)

Vlan203, uptime: 04:13:13, mrib

switch(config)#

Related Commands

Command

Description

Displays summary information about IPv4 multicast routes.

show ip mroute summary

command.

}]

}]

Syntax Description

(Optional) Displays only route counts.

(Optional) Displays software-switched route counts only.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

(Optional) Specifies a group address for a route.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display summary information about IPv4 multicast routes:

switch(config)# show ip mroute summary

This example shows how to display the number of IPv4 multicast routes:

switch# show ip mroute summary count

IP Multicast Routing Table for VRF "default"

Total number of routes: 1

Total number of (*,G) routes: 0

Total number of (S,G) routes: 0

Total number of (*,G-prefix) routes: 1

Group count: 0, rough average sources per group: 0.0

switch#

Related Commands

Command

Description

Displays information about IPv4 multicast routes.

show ip msdp count

command.

}]

Syntax Description

(Optional) Autonomous system (AS) number.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display MSDP counts:

switch(config)# show ip msdp count

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp event-history

command.

}

Syntax Description

Displays events of type error.

Displays events of type msg.

Displays events of type statistics.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information in the MSDP msgs event history buffer:

switch(config)# show ip msdp event-history msgs

Related Commands

Command

Description

Clears the contents of the MSDP event history buffers.

Configures the size of MSDP event history buffers.

show ip msdp mesh-group

command.

}]

Syntax Description

(Optional) Mesh group name.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about MSDP mesh groups:

switch(config)# show ip msdp mesh-group

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp peer

command.

}]

Syntax Description

(Optional) IP address of an MSDP peer.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about MSDP peers:

switch(config)# show ip msdp peer

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp policy statistics sa-policy

command.

}]

Syntax Description

IP address of the MSDP peer for the SA policy.

Specifies the input policy.

Specifies the output policy.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about MSDP SA policies:

switch(config)# show ip msdp policy statistics sa-policy 192.168.1.10 in

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp route

command.

}]

Syntax Description

Source address for SA cache information.

(Optional) Group address for SA cache information.

(Optional) Autonomous system (AS) number.

(Optional) Specifies the IP address of a peer.

(Optional) Displays detailed information.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the MSDP SA cache:

switch(config)# show ip msdp route

Related Commands

Command

Description

Clears routes in the MSDP Source-Active cache.

Displays information about the MSDP SA cache.

show ip msdp rpf

command.

}]

Syntax Description

IP address of the RP.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about MSDP reverse path forwarding (RPF) peers:

switch(config)# show ip msdp rpf 192.168.1.10

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp sa-cache

command.

}]

Syntax Description

Source address for SA cache information.

(Optional) Group address for SA cache information.

(Optional) Autonomous system (AS) number.

(Optional) Specifies the IP address of a peer.

(Optional) Displays detailed information.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

command is an alternative form of this command.

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the MSDP SA cache:

switch(config)# show ip msdp sa-cache

Related Commands

Command

Description

Clears routes in the MSDP Source-Active cache.

Displays information about the MSDP SA cache.

show ip msdp sources

command.

}]

Syntax Description

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about MSDP learned sources:

switch(config)# show ip msdp sources

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip msdp summary

command.

}]

Syntax Description

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display summary information about MSDP peers:

switch(config)# show ip msdp summary

Related Commands

Command

Description

Displays information about the MSDP running configuration.

show ip pim event-history

command.

}

Syntax Description

Displays events of type error.

Displays events of type msg.

Displays events of type statistics.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information in the IPv4 PIM msgs event history buffer:

switch(config)# show ip pim event-history msgs

Related Commands

Command

Description

Clears the contents of the PIM event history buffers.

Configures the size of PIM event history buffers.

show ip pim group-range

command.

}]

Syntax Description

(Optional) Group address.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM group ranges:

switch(config)# show ip pim group-range

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim interface

command.

}]

}

Syntax Description

(Optional) Specifies a brief format for display.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Specifies the VLAN. The range is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display brief information about IPv4 PIM-enabled interfaces:

switch# show ip pim interface brief

This example shows how to display information about PIM-enabled interfaces:

switch# show ip pim interface ethernet 2/5

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim neighbor

command.

}]

Syntax Description

(Optional) Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Specifies the VLAN. The range is from 1 to 4094.

(Optional) IP address of a neighbor.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about PIM neighbors:

switch(config)# show ip pim neighbor

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim oif-list

command.

}]

Syntax Description

Group address.

(Optional) Source address.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display IPv4 PIM interfaces for a group:

switch(config)# show ip pim oif-list 232.0.0.0

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim policy statistics auto-rp

command.

}]

Syntax Description

Specifies candidate-RP messages.

Specifies mapping agent messages.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics auto-rp rp-candidate-policy

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim policy statistics bsr

command.

}]

Syntax Description

Specifies BSR messages.

Specifies candidate-RP messages.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics bsr bsr-policy

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim policy statistics jp-policy

command.

}

Syntax Description

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Specifies the VLAN. The range is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about PIM policy statistics:

switch(config)# show ip pim policy statistics jp-policy ethernet 2/12

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim policy statistics neighbor-policy

command.

}

Syntax Description

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

(Optional) Subinterface number. The range is from 1 to 4093.

Specifies the VLAN. The range is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics neighbor-policy ethernet 2/12

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim policy statistics register-policy

command.

}]

Syntax Description

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about PIM policy statistics:

switch(config)# show ip pim policy statistics register-policy vrf all

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim route

command.

}]

Syntax Description

Source address.

Group address.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display IPv4 PIM routes:

switch(config)# show ip pim route 232.0.0.0

Related Commands

Command

Description

Removes routes when the IPv4 PIM process is restarted.

Displays information about the PIM running configuration.

show ip pim rp

command.

}]

Syntax Description

(Optional) Group address.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM RPs:

switch(config)# show ip pim rp

Related Commands

Command

Description

Configures an IPv4 PIM static RP address for a multicast group range.

Configures the router as an IPv4 PIM bootstrap router (BSR) RP candidate.

Displays information about the PIM running configuration.

show ip pim rp-hash

command.

}]

Syntax Description

Group address for RP lookup.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM RP-hash values:

switch(config)# show ip pim rp-hash 224.1.1.1

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim statistics

command.

}]

Syntax Description

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM statistics:

switch(config)# show ip pim statistics

Related Commands

Command

Description

Displays information about the PIM running configuration.

show ip pim vrf

command.

]

Syntax Description

(Optional) VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

(Optional) Specifies all VRFs.

(Optional) Specifies the default VRF.

(Optional) Displays detailed PIM VRF information.

(Optional) Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM by VRF:

switch(config)# show ip pim vrf

This example shows how to display the detailed information about IPv4 PIM by VRF:

switch# show ip pim vrf detail

Related Commands

Command

Description

Configures the maximum number of IPv4 PIM state entries in the current VRF instance.

show ip static-route

command.

]

Syntax Description

(Optional) Specifies the virtual routing and forwarding (VRF) context name. The name can be any case-sensitive, alphanumeric string up to 32 characters.

(Optional) Specifies all VRF instances.

(Optional) Specifies the default VRF.

(Optional) Specifies the management VRF.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the static routes:

switch(config)# show ip static-route

Related Commands

Command

Description

Configures a static route.

show routing ip multicast event-history

command.

}

Syntax Description

Displays the event history buffer of type CLI.

Displays the event history buffer of type errors.

Displays the event history buffer of type multicast FIB distribution (MFDM).

Displays the event history buffer of type MFDM sum.

Displays the event history buffer of type msgs.

Displays the event history buffer of type RIB.

Displays information about the event history buffers.

Displays the event history buffer of type virtual routing and forwarding (VRF).

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information in the MRIB msgs event history buffer:

switch# show routing ip multicast event-history msgs

Msg events for MRIB Process

1) Event:E_DEBUG, length:38, at 724454 usecs after Fri Sep 2 06:56:42 2011

[100] : nvdb: transient thread created

2) Event:E_DEBUG, length:38, at 723779 usecs after Fri Sep 2 06:56:42 2011

[100] : nvdb: create transcient thread

3) Event:E_DEBUG, length:76, at 723775 usecs after Fri Sep 2 06:56:42 2011

[100] : comp-mts-rx opc - from sap 11227 cmd mrib_internal_event_hist_comman

d

4) Event:E_MTS_RX, length:60, at 240798 usecs after Fri Sep 2 06:56:01 2011

[RSP] Opc:MTS_OPC_MFDM_V4_ROUTE_STATS(75785), Id:0X00A5EDE6, Ret:SUCCESS

<--Output truncated-->

switch#

Related Commands

Command

Description

Configures the size of the IPv4 MRIB event history buffers.

Clears information in the IPv4 MRIB event history buffers.

show routing multicast

command.

]}}

Syntax Description

(Optional) Specifies IPv4 routes.

(Optional) Specifies IPv4 routes.

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

Specifies all VRFs.

Specifies the default VRF.

Specifies the management VRF.

Source address for routes.

Group address for routes.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 multicast routes:

switch# show routing multicast

IP Multicast Routing Table for VRF "default"

(*, 232.0.0.0/8), uptime: 1w1d, pim ip

Incoming interface: Null, RPF nbr: 0.0.0.0

Outgoing interface list: (count: 0)

switch#

Related Commands

Command

Description

Configures the size of the IPv4 Multicast Routing Information Base (MRIB) event history buffers.

Configures the IPv4 multicast routing initial holddown period.

show routing multicast clients

command.

]

Syntax Description

(Optional) Specifies IPv4 multicast clients.

(Optional) Specifies IPv4 multicast clients.

(Optional) One of the following multicast routing client names:

- mrib

- igmp

- static

- msdp

- ip

- pim

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 multicast clients:

switch# show routing multicast clients pim

IP Multicast Routing Client information

Client: pim, client-id: 5, pid: 4449, mts-sap: 310

Shared-memory: pim, Notifications: joins prunes rpf delete repopulate

Protocol is ssm owner, bidir owner, shared-only mode owner, internal owner

Join notifications: sent 1, fail 0, ack rcvd 1

Prune notifications: sent 0, fail 0, ack rcvd 0

RPF notifications: sent 0, fail 0, ack rcvd 0

Delete notifications: sent 0, fail 0, ack rcvd 0

Repopulate notifications: sent 0, fail 0, ack rcvd 0

Clear mroute notifications: sent 0, fail 0

Add route requests: rcvd 2, ack sent 2, ack fail 0

Delete route requests: rcvd 0, ack sent 0, ack fail 0

Update route requests: rcvd 0, ack sent 0, ack fail 0

MTS update route requests: rcvd 0, ack sent 0, ack fail 0

Per VRF notification markers: 1

switch#

Related Commands

Command

Description

Configures the size of the IPv4 Multicast Routing Information Base (MRIB) event history buffers.

Configures the IPv4 multicast routing initial holddown period.

show running-config igmp

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to display information about the IGMP running-system configuration:

switch(config)# show running-config igmp

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

Displays information about the IGMP startup configuration.

show running-config msdp

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the MSDP running-system configuration:

switch(config)# show running-config msdp

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

Displays information about the MSDP startup configuration.

show running-config pim

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the IPv4 PIM running-system configuration:

switch(config)# show running-config pim

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

Displays information about the IPv4 PIM startup configuration.

show startup-config igmp

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command does not require a license but if you want to enable Layer 3 interfaces, you must install the LAN Base Services license.

Examples

This example shows how to display information about the IGMP startup-system configuration:

switch(config)# show startup-config igmp

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

show startup-config msdp

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the startup-system configuration for MSDP:

switch(config)# show startup-config msdp

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

Clears the statistics for MSDP peers.

show startup-config pim

command.

]

Syntax Description

(Optional) Displays configured and default information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.0(3)A1

This command was introduced.

Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about the startup-system configuration for IPv4 PIM:

switch(config)# show startup-config pim

Related Commands

Command

Description

Copies the running configuration information to the startup configuration file.

Clears PIM statistics counters.

Cisco Nexus 3548 Switch NX-OS Multicast Routing Command Reference

First Published: November 2012

Last Modified: October 2016

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

Cisco Nexus 3548 Switch NX-OS Multicast Routing Command Reference

© 2015 Cisco Systems, Inc. All rights reserved.