Cisco IOS IP Multicast Command Reference
ip pim vc-count through show ip igmp snooping statistics

Table Of Contents

ip pim vc-count

ip pim version

ip rgmp

ip sap cache-timeout

ip sap listen

ip sdr cache-timeout

ip sdr listen

ip urd

manager

mdt data

mdt default

mdt log-reuse

mls ip multicast (global configuration)

mls ip multicast (interface configuration)

mls ip multicast bidir gm-scan-interval

mls ip multicast connected

mls ip multicast consistency-check

mls ip multicast flow-stat-timer

mls ip multicast non-rpf aging

mls ip multicast replication-mode

mls ip multicast sso

mls ip multicast stub

mls ip multicast threshold

mode bypass

mrinfo

mrm

mstat

mtrace

receivers

router-guard ip multicast

router-guard ip multicast switchports

senders

show ip dvmrp route

show ip igmp groups

show ip igmp interface

show ip igmp membership

show ip igmp snooping

show ip igmp snooping explicit-tracking

show ip igmp snooping filter

show ip igmp snooping mrouter

show ip igmp snooping rate-limit

show ip igmp snooping statistics

show ip igmp snooping subscriber-rate


ip pim vc-count

To change the maximum number of virtual circuits (VCs) that Protocol Independent Multicast (PIM) can open, use the ip pim vc-count command in interface configuration mode. To restore the default value, use the no form of this command.

ip pim vc-count number

no ip pim vc-count

Syntax Description

number

Maximum number of VCs that PIM can open. The default is 200 VCs. The range is from 1 to 65535.


Defaults

200 VCs per ATM interface or subinterface

Command Modes

Interface configuration

Command History

Release
Modification

11.3

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following example allows PIM to open a maximum of 250 VCs:

ip pim vc-count 250

Related Commands

Command
Description

ip pim minimum-vc-rate

Configures the minimum traffic rate to keep VCs from being idled.

ip pim multipoint-signalling

Enables PIM to open ATM multipoint switched VCs for each multicast group that a receiver joins.

ip pim

Enables PIM on an interface.

show ip pim vc

Displays ATM VCs status information for multipoint VCs opened by PIM.


ip pim version

To configure the Protocol Independent Multicast (PIM) version of the interface, use the ip pim version command in interface configuration mode. To restore the default value, use the no form of this command.

ip pim version [1 | 2]

no ip pim version

Syntax Description

1

(Optional) Configures PIM Version 1.

2

(Optional) Configures PIM Version 2.


Defaults

Version 2

Command Modes

Interface configuration

Command History

Release
Modification

11.3 T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

An interface in Version 2 mode automatically downgrades to Version 1 mode if that interface has a PIM Version 1 neighbor. The interface returns to Version 2 mode after all Version 1 neighbors disappear (that is, they are shut down or upgraded).

Examples

The following example configures the interface to operate in PIM Version 1 mode:

interface ethernet 0 
 ip address 10.0.0.0 255.0.0.0 
 ip pim sparse-dense-mode 
 ip pim version 1

ip rgmp

To enable the Router-Port Group Management Protocol (RGMP) on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces, use the ip rgmp command in interface configuration mode. To disable RGMP on the interfaces, use the no form of this command.

ip rgmp

no ip rgmp

Syntax Description

This command has no arguments or keywords.

Defaults

RGMP is not enabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(10)S

This command was introduced.

12.1(1)E

This command was integrated into Cisco IOS Release 12.1(1)E.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

RGMP is supported only on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces.

Before you enable RGMP, the following features must be enabled on your router:

IP routing

IP multicast

PIM in sparse mode, sparse-dense mode, source specific mode, or bidirectional mode

If your router is in a bidirectional group, make sure to enable RGMP only on interfaces that do not function as a designated forwarder (DF). If you enable RGMP on an interface that functions as a DF, the interface will not forward multicast packets up the bidirectional shared tree to the rendezvous point (RP).

The following features must be enabled on your switch:

IP multicast

IGMP snooping

Examples

The following example enables RGMP on Ethernet interface 1/0:

interface ethernet 1/0
 ip rgmp

Related Commands

Command
Description

debug ip rgmp

Logs debug messages sent by an RGMP-enabled router.

show ip igmp interface

Displays multicast-related information about an interface.


ip sap cache-timeout

To limit how long a Session Announcement Protocol (SAP) cache entry stays active in the cache, use the ip sap cache-timeout command in global configuration mode. To restore the default value, use the no form of this command.

ip sap cache-timeout minutes

no ip sap cache-timeout

Syntax Description

minutes

Time (in minutes) that a SAP cache entry is active in the cache.


Defaults

By default, session announcements remain for 1440 minutes (24 hours) in the cache.

Command Modes

Global configuration

Command History

Release
Modification

11.2

The ip sdr cache-timeout command was introduced.

12.2

The ip sdr cache-timeout command was replaced by the ip sap cache-timeout command.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command defines how long session announcements are cached by the router. Active session announcements are periodically re-sent by the originating site, refreshing the cached state in the router. The minimum interval between announcements for a single group is 5 minutes. Setting the cache timeout to a value less than 30 minutes is not recommended. Set the cache timeout to 0 to keep entries in the cache indefinitely.

Examples

The following example causes SAP cache entries to remain in the cache for 30 minutes:

ip sap cache-timeout 30

Related Commands

Command
Description

clear ip sap

Deletes a SAP cache entry or the entire SAP cache.

show ip sap

Displays the SAP cache.


ip sap listen

To enable the Cisco IOS software to listen to session directory announcements, use the ip sap listen command in interface configuration mode. To disable the function, use the no form of this command.

ip sap listen

no ip sap listen

Syntax Description

This command has no arguments or keywords.

Defaults

The command is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

11.1

The ip sdr listen command was introduced.

12.2

The ip sdr listen command was replaced by the ip sap listen command.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Cisco IOS software can receive and store Session Description Protocol (SDP) and Session Announcement Protocol (SAP) session announcements. When the ip sap listen command is configured on an interface, the well-known session directory groups on that interface can receive and store session announcements. The announcements can be displayed with the show ip sap command. The ip multicast rate-limit command uses stored session announcements. To configure the period of time after which received announcements will expire, use the ip sap cache-timeout command.

When the no ip multicast routing command is configured, announcements are only stored if they are received on an interface configured with the ip sap listen command. When a system is configured as a multicast router, it is sufficient to configure the ip sap listen command on only a single multicast-enabled interface. The well-known session directory groups are handled as local joined groups after the ip sap listen command is first configured (see the L flag of the show ip mroute command). This configuration causes announcements received from all multicast-enabled interfaces to be routed and stored within the system.

Examples

The following example shows how to enable a router to listen to session directory announcements:

ip routing
interface loopback 0
 ip address 10.0.0.51 255.255.255.0
 ip pim sparse-dense mode
 ip sap listen

Related Commands

Command
Description

clear ip sap

Deletes a SAP cache entry or the entire SAP cache.

ip multicast rate-limit

Controls the rate a sender from the source list can send to a multicast group in the group list.

ip multicast-routing

Enables IP multicast routing or multicast distributed switching.

ip sap cache-timeout

Limits how long a SAP cache entry stays active in the cache.

show ip mroute

Displays the contents of the IP mroute routing table.

show ip sap

Displays the SAP cache.


ip sdr cache-timeout

The ip sdr cache-timeout command is replaced by the ip sap cache-timeout command. See the description of the ip sap cache-timeout command for more information.

ip sdr listen

The ip sdr listen command is replaced by the ip sap listen command. See the description of the ip sap listen command for more information.

ip urd

To enable interception of TCP packets sent to the reserved URL Rendezvous Directory (URD) port 465 on an interface and processing of URD channel subscription reports, use the ip urd command in interface configuration mode. To disable URD on an interface, use the no form of this command.

ip urd [proxy]

no ip urd [proxy]

Syntax Description

proxy

(Optional) Allows an interface to accept URL requests from any TCP connection sent to that interface. If the proxy keyword is not configured, the interface will accept URL requests from TCP connections only if the requests originated from directly connected hosts.

The proxy option must be enabled on an interface if it is unnumbered or if it has downstream routers configured with Internet Group Management Protocol (IGMP) proxy routing. To prevent users on the backbone from creating URD state on your router, do not enable the proxy option on a backbone interface of your router.


Defaults

The command is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

To use this command, you must first define a Source Specific Multicast (SSM) range of IP addresses using the ip pim ssm global configuration command. When URD is enabled, it is supported in the SSM range of addresses only. We recommend that you not enable URD on backbone interfaces, but only on interfaces connecting to hosts.

URD functionality is available for multicast process switching, fast switching, and distributed fast-switching paths.

Examples

The following example shows how to configure URD on Ethernet interface 3/3:

interface ethernet 3/3
 ip urd

Related Commands

Command
Description

ip pim ssm

Defines the SSM range of IP multicast addresses.


manager

To specify the interface that is to act as the Manager for Multicast Routing Monitor (MRM), and to specify the multicast group address the Test Receiver will listen to, use the manager command in MRM manager configuration mode. To remove the Manager or group address, use the no form of this command.

manager interface-type interface-number group ip-address

no manager interface-type interface-number group ip-address

Syntax Description

interface-type interface-number

Interface type and number of the Manager. The IP address associated with this interface is the source address of the Manager.

group ip-address

Specifies the IP multicast group address that the Test Receiver will listen to.


Command Default

There is no MRM Manager configured.

Command Modes

MRM manager configuration (config-mrm-manager)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command identifies the interface that acts as the Manager, and therefore is required in order to run MRM.

Examples

The following example shows how to configure Ethernet interface 0 as the Manager and the Test Receiver to listen to multicast group 239.1.1.1:

ip mrm manager test1
 manager ethernet 0 group 239.1.1.1

Related Commands

Command
Description

beacon (multicast routing monitor)

Changes the frequency, duration, or scope of beacon messages that the Manager sends to Test Senders and Test Receivers during an MRM test.

ip mrm accept-manager

Configures a Test Sender or Test Receiver to accept requests only from Managers that pass an access list.

show ip mrm manager

Displays test information for MRM.


mdt data

To configure the multicast group address range for data multicast distribution tree (MDT) groups, use the mdt data command in VRF configuration mode. To disable this function, use the no form of this command.

mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]

no mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]

Syntax Description

group-address-range

Multicast group address range. The range is from 224.0.0.1 to 239.255.255.255.

wildcard-bits

Wildcard bits to be applied to the multicast group address range.

threshold threshold-value

(Optional) Defines the bandwidth threshold value. The range is from 1 through 4294967.

list access-list

(Optional) Defines the access list name or number.


Defaults

The command is disabled.

Command Modes

VRF configuration

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

A data MDT group can include a maximum of 256 multicast groups per Virtual Private Network (VPN). Multicast groups used to create the data MDT group are dynamically chosen from a pool of configured IP addresses.

This command configures a range of alternative multicast destination addresses for the tunnel header. The destination address chosen depends on the traffic profile (that is, the source and destination match the specified access list and the rate of the traffic has exceeded the bandwidth threshhold value).

Examples

In the following example, Protocol Independent Multicast (PIM) Source Specific Multicast (SSM) is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.

!
ip vrf vrf1
 rd 1:1
 route-target export 1:1
 route-target import 1:1
 mdt default 232.0.0.1
 mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101
!
.
.
.
!
ip pim ssm default
ip pim vrf vrf1 accept-rp auto-rp
!

Related Commands

Command
Description

mdt default

Configures a default MDT group for a VPN VRF.


mdt default

To configure a default multicast distribution tree (MDT) group for a Virtual Private Network (VPN) routing and forwarding (VRF) instance, use the mdt default command in VRF configuration mode. To disable this function, use the no form of this command.

mdt default group-address

no mdt default group-address

Syntax Description

group-address

IP address of the default MDT group. This address serves as an identifier for the community in that provider-edge (PE) routers configured with the same group address become members of the group, allowing them to receive packets sent by each other.


Defaults

The command is disabled.

Command Modes

VRF configuration

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The default MDT group must be the same group configured on all PE routers that belong to the same VPN.

If Source Specific Multicast (SSM) is used as the protocol for the default MDT, the source IP address will be the address used to source the Border Gateway Protocol (BGP) sessions.

A tunnel interface is created as a result of this command. By default, the destination address of the tunnel header is the group-address argument.

Examples

In the following example, Protocol Independent Multicast (PIM) SSM is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.

!
ip vrf vrf1
 rd 1:1
 route-target export 1:1
 route-target import 1:1
 mdt default 232.0.0.1 
 mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101
!
.
.
.
!
ip pim ssm default
ip pim vrf vrf1 accept-rp auto-rp
!

Related Commands

Command
Description

mdt data

Configures the multicast group address range for data MDT groups.


mdt log-reuse

To enable the recording of data multicast distribution tree (MDT) reuse, use the mdt log-reuse command in VRF configuration mode. To disable this function, use the no form of this command.

mdt log-reuse

no mdt log-reuse

Syntax Description

This command has no arguments or keywords.

Defaults

The command is disabled.

Command Modes

VRF configuration

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The mdt log-reuse command generates a syslog message whenever a data MDT is reused.

Examples

The following example shows how to enable MDT log reuse:

mdt log-reuse

Related Commands

Command
Description

mdt data

Configures the multicast group address range for data MDT groups.

mdt default

Configures a default MDT group for a VPN VRF.


mls ip multicast (global configuration)

To enable MLS IP and configure the hardware switching globally, use the mls ip multicast command in global configuration mode. To disable MLS IP, use the no form of this command.

mls ip multicast [capability]

mls ip multicast [vrf name] [connected | egress local | mfd | refresh-state | shared-tree-mfd | syslog | threshold ppsec]

no mls ip multicast [vrf]

Syntax Description

capability

(Optional) Exports the information about the egress capability from the switch processor to the route processor.

vrf name

(Optional) Specifies the VRF name.

connected

(Optional) Installs the interface/mask entries for bridging directly connected sources to the internal router.

egress local

(Optional) Populates the multicast expansion table with local Layer 3-routed interfaces.

mfd

(Optional) Enables complete hardware switching.

refresh-state

(Optional) Refreshes the expiration time of the (S,G) entry or the (*,G) entry with NULL OIF.

shared-tree-mfd

(Optional) Enables the complete shortcut for (*,G) flows.

syslog

(Optional) Enables the display of multicast related syslog messages on console.

threshold ppsec

(Optional) Sets the minimum traffic rate; below this rate, the flow is software-switched instead of hardware-switched. Valid values are from 10 to 10000 seconds.


Defaults

The defaults are as follows:

Multicast is disabled.

Hardware switching is allowed for all eligible multicast routes.

connected is enabled.

egress local is disabled.

mfd is enabled.

refresh-state is enabled.

shared-tree-mfd is enabled.

syslog is disabled.

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17a)SX

This command was changed to include the capability keyword.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(18)SXF

This command was changed to include the egress local keywords.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXI

Support for the syslog feature was added.


Usage Guidelines


Note After you enter the mls ip multicast egress local command, you must perform a system reset for the configuration to take effect.


Egress multicast replication is not supported on sysems that are configured with a Supervisor Engine 32.

When entering the mls ip multicast egress local command, ensure that IPv6 multicast is not enabled. Since the egress multicast replication performance enhancement feature cannot separately turn on or turn off IPv4 and IPv6, you cannot have IPv4 and IPv6 multicast enabled when this feature is turned on.

These optional keywords are supported only on systems that are configured with a Supervisor Engine 720 with a PFC3:

threshold

connected

refresh-state

shared-tree-mfd

mfd

The threshold ppsec optional keyword and argument do not impact flows that are already populated in the hardware cache.

The expiration time refresh is updated when flow statistics are received (indicating that the traffic is received from the RPF interface).

Examples

This example shows how to enable the MLS IP shortcuts:

Router(config)# mls ip multicast

This example shows how to enable the hardware switching on a specific multicast route:

Router(config)# mls ip multicast vrf test1

This example shows how to export the information about egress capability from the switch processor to the route processor:

Router(config)# mls ip multicast capability

This example shows how to populate the multicast expansion table with local Layer 3-routed interfaces:

Router(config)# mls ip multicast egress local

Related Commands

Command
Description

mls rp ip (global configuration mode)

Enables external systems to establish IP shortcuts to the MSFC.

show mls ip multicast

Displays the MLS IP information.


mls ip multicast (interface configuration)

To enable MLS IP shortcuts on the interface, use the mls ip multicast command in interface configuration mode. To disable MLS IP shortcuts on the interface, use the no form of this command.

mls ip multicast

no mls ip multicast

Syntax Description

This command has no arguments or keywords.

Defaults

Multicast is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Examples

This example shows how to enable the MLS IP shortcuts:

Router(config-if)# mls ip multicast

Related Commands

Command
Description

show mls ip multicast

Displays the MLS IP information.


mls ip multicast bidir gm-scan-interval

To set the RPF scan interval for the Bidir rendevous point, use the mls ip multicast bidir gm-scan-interval command in global configuration mode. To disable the RPF scan interval for the Bidir rendevous point, use the no form of this command.

mls ip multicast bidir gm-scan-interval interval

no mls ip multicast bidir gm-scan-interval

Syntax Description

interval

RPF scan interval for the Bidir rendevous point; valid values are from
1 to 1000 seconds.


Defaults

10 seconds

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

When you set the RPF scan interval for the Bidir rendevous point, you set the time that the periodic scan timer updates the RPF in the DF table for all Bidir rendevous points in the hardware.

Examples

This example shows how to set the RPF scan interval for the Bidir rendevous point:

Router(config)# mls ip multicast bidir gm-scan-interval 30

Related Commands

Command
Description

show mls ip multicast bidir

Displays the Bidir hardware-switched entries.


mls ip multicast connected

To enable the downloading of directly connected subnets globally, use the mls ip multicast connected command in global configuration mode. To disable the downloading of directly connected subnets globally, use the no form of this command.

mls ip multicast connected

no mls ip multicast connected

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

Do not create directly connected subnets for the following cases:

To make more room available in the FIB TCAM

The switch is the first-hop router for a source

The entries are for Bidir, SSM, and DM mode groups

In these cases, if you enable the downloading of directly connected subnets, the directly connected source hits the MMLS (*,G) entry and is switched using the MMLS (*,G) entry. The registers are not sent to the route processor (in the case of PIM-SM), and the (S,G) state is not created on the first hop (in the case of PIM-DM).

The subnet entry is installed in the TCAM entries with a shorter mask to catch directly connected sources before they hit such entries. You can punt traffic from directly connected sources to the MSFC. Once the MSFC sees this traffic, it can install an MMLS (S,G) entry for this source, which gets installed before the subnet entry in the TCAM. New packets from this source are now switched with the (S,G) entry.

Examples

This example shows how to enable the downloading of directly connected subnets:

Router(config)# mls ip multicast connected

Related Commands

Command
Description

mls ip multicast (global configuration)

Enables MLS IP and configures the hardware switching globally.

show mls ip multicast

Displays the MLS IP information.


mls ip multicast consistency-check

To enable and configure the hardware-shortcut consistency checker, use the mls ip multicast consistency-check command in global configuration mode. To disable the consistency checkers, use the no form of this command.

mls ip multicast consistency-check [auto-repair | error-message | settle-time seconds | type [rp-sp [table | vrf] | scan-mroute [count count-number] | settle-time seconds | period seconds]

no mls ip multicast consistency-check

Syntax Description

auto-repair

(Optional) Specifies the automatic repair for the consistency checker.

error-message

(Optional) Specifies the error message for the consistency checker.

settle-time seconds

(Optional) Specifies the settle time for the consistency checker; valid values are from 2 to 3600 seconds.

type rp-sp

(Optional) Specifies the type of consistency check as a MLSM route switch processor.

table

(Optional) Specifies the VRF multicast table to check. Valid values are 0 to 65535.

vrf

(Optional) Specifies the VPN routing/forwarding instance to check.

type scan-mroute

(Optional) Specifies the type of consistency check as a scan check of the mroute table.

count count-number

(Optional) Specifies the maximum number of prefixes to check per scan; valid values are from 2 to 500.

period seconds

(Optional) Specifies the period between scans; valid values are from 2 to 3600 seconds.


Defaults

The defaults are as follows:

Consistency check is enabled.

count count-number is 20.

period seconds is 2 seconds.

settle-time seconds is 60 seconds.

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The consistency checker scans the mroute table and assures that the multicast-hardware entries are consistent with the mroute table. Whenever an inconsistency is detected, the inconsistency is automatically corrected.

To display the inconsistency error, use the show mls ip multicast consistency-check command.

Examples

This example shows how to enable the hardware-shortcut consistency checker:

Router(config)# mls ip multicast consistency-check

This example shows how to enable the hardware-shortcut consistency checker and configure the scan check of the mroute table:

Router(config)# mls ip multicast consistency-check type scan-mroute count 20 period 35

This example shows how to enable the hardware-shortcut consistency checker and specify the period between scans:

Router(config)# mls ip multicast consistency-check type scan-mroute period 35

Related Commands

Command
Description

show mls ip multicast consistency-check

Displays the MLS IP information.


mls ip multicast flow-stat-timer

To set the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor, use the mls ip multicast flow-stat-timer command in global configuration mode. To return to the default settings, use the no form of this command.

mls ip multicast flow-stat-timer num

no mls ip multicast flow-stat-timer

Syntax Description

num

Time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor.


Defaults

25 seconds

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

This example shows how to configure the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor:

Router(config)# mls ip multicast flow-stat-timer 10 

Related Commands

Command
Description

show mls ip multicast

Displays the MLS IP information.


mls ip multicast non-rpf aging

To enable rate-limiting of non-RPF traffic, use the mls ip multicast non-rpf aging command in global configuration mode. To return to the default settings, use the no form of this command.

mls ip multicast non-rpf aging {global | fast} time

no mls ip multicast non-rpf aging {global | fast}

Syntax Description

global time

Specifies the global aging time interval. Valid values are 1 to 180; by default the time is set to 20 seconds.

fast time

Specifies the fast aging time interval. Valid values are 2 to 10; by default the time is set to 2 seconds.


Defaults

The fast aging time default is 2 seconds and the global aging time default is 20 seconds.

Command Modes

Global configuration

Command History

Release
Modification

12.2(18)SXE

Support for this command was introduced for the Supervisor Engine 720.


Usage Guidelines

You should not configure ACL-based filtering of RPF failures.

Examples

This example shows how to enable rate-limiting of non-RPF traffic:

Router(config)# mls ip multicast non-rpf aging global 90

This example shows how to display the multicast configuration of the router:

Router# show running | incl mls ip multicast
mls ip multicast non-rpf aging global 90
mls ip multicast non-rpf aging fast 4
Router#

Related Commands

Command
Description

show mls ip multicast

Displays the MLS IP information.


mls ip multicast replication-mode

To enable and specify the replication mode, use the mls ip multicast replication-mode command in global configuration mode. To restore the system to automatic detection mode, use the no form of this command.

mls ip multicast replication-mode {egress | ingress}

no mls ip multicast replication-mode {egress | ingress}

Syntax Description

egress

Forces the system to the egress mode of replication.

ingress

Forces the system to the ingress mode of replication.


Defaults

The Supervisor Engine 720 automatically detects the replication mode based on the module types that are installed in the system. If all modules are capable of egress replication, the system uses egress-replication mode. If the supervisor engine detects the modules that are not capable of egress replication, the replication mode automatically switches to ingress replication.

If the system is functioning in the automatic-detection egress mode, and you install a module that cannot perform egress replication, the following occurs:

The Cisco 7600 series router reverts to ingress mode.

A system log is generated.

A system reload occurs to revert to the old configuration.

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(18)SXF

Thic command was changed to support the egress keyword.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.


Note During the change from egress- to ingress-replication mode, traffic interruptions may occur because the shortcuts are purged and reinstalled. To avoid interruptions in traffic forwarding, enter the mls ip multicast replication-mode ingress command.


If you enter the no mls ip multicast replication-mode egress command, only the forced-egress mode resets and not the forced-ingress mode.

If you enter the no mls ip multicast replication-mode ingress command, only the forced-ingress mode resets and not the forced-egress mode.

Examples

This example shows how to enable the ingress-replication mode:

Router(config)# mls ip multicast replication-mode ingress

This example shows how to enable the egress-replication mode:

Router(config)# mls ip multicast replication-mode egress

This example shows how to disable the current egress-replication mode and return to automatic detection mode:

Router(config)# no mls ip multicast replication-mode egress

Related Commands

Command
Description

show mls ip multicast capability

Displays the MLS IP information.


mls ip multicast sso

To configure the stateful switchover (SSO) parameters, use the mls ip multicast sso command in global configuration mode. To return to the default settings, use the no form of this command.

mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}

no mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}

Syntax Description

convergence-time time

Specifies the maximum time to wait for protocol convergence; valid values are from 0 to 3600 seconds.

leak interval seconds

Specifies the packet-leak interval; valid values are from 0 to 3600 seconds.

leak percent percentage

Specifies the percentage of multicast packets leaked to the router during switchover so that protocol convergence can take place; valid values are from 1 to 100 percent.


Command Default

The defaults are as follows:

convergence-time time—20 seconds

leak interval—60 seconds

leak percentage—10 percent

Command Modes

Global configuration

Command History

Release
Modification

12.2(18)SXD

Support for this command was introduced on the Supervisor Engine 720.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

This example shows how to set the maximum time to wait for protocol convergence to 300 seconds:

Router(config)# mls ip multicast sso convergence-time 300
Router(config)# 

This example shows how to set the packet-leak interval to 200 seconds:

Router(config)# mls ip multicast sso leak interval 200
Router(config)# 

This example shows how to set the packet-leak percentage to 55 percent:

Router(config)# mls ip multicast sso leak percent 55
Router(config)# 

Related Commands

Command
Description

show mls ip multicast sso

Displays information about multicast high-availability SSO.


mls ip multicast stub

To enable the support for non-RPF traffic drops for PIM sparse-mode stub networks, use the mls ip multicast stub command in interface configuration mode. To disable support for non-RPF traffic drops for PIM sparse-mode stub networks, use the no form of this command.

mls ip multicast stub

no mls ip multicast stub

Syntax Description

This command has no arguments or keywords.

Defaults

Multicast is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

When you enable the ACL-based method of filtering RPF failures by entering the mls ip multicast stub command on the redundant router, the following ACLs automatically download to the PFC and are applied to the interface that you specify:

access-list 100 permit ip A.B.C.0 0.0.0.255 any

access-list 100 permit ip A.B.D.0 0.0.0.255 any

access-list 100 permit ip any 224.0.0.0 0.0.0.255

access-list 100 permit ip any 224.0.1.0 0.0.0.255

access-list 100 deny ip any 224.0.0.0 15.255.255.255

The ACLs filter the RPF failures and drop them in the hardware so that they are not forwarded to the router.

Use the ACL-based method of filtering the RPF failures only in sparse-mode stub networks where there are no downstream routers. For dense-mode groups, the RPF failure packets have to be seen on the router for the PIM-assert mechanism to function properly. Use CEF-or NetFlow-based rate limiting to rate limit the RPF failures in dense-mode networks and sparse-mode transit networks.

Examples

This example shows how to enable the support for the non-RPF traffic drops for the PIM sparse-mode stub networks:

Router(config-if)# mls ip multicast stub

Related Commands

Command
Description

show mls ip multicast

Displays the MLS IP information.


mls ip multicast threshold

To configure a threshold rate for installing hardware shortcuts, use the mls ip multicast threshold command in global configuration mode. To deconfigure the threshold rate, use the no form of this command.

mls ip multicast threshold pps

no mls ip multicast threshold

Syntax Description

pps

Threshold in packets per seconds. Valid values are from 10 to 10000.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

Use this command to prevent creation of MLS entries for short-lived multicast flows such as join requests.

If multicast traffic drops below the configured multicast rate threshold, all multicast traffic is routed by the MSFC.

This command does not affect already installed routes. For example, if you enter this command and the shortcuts are already installed, the shortcuts are not removed if they are disqualified. To apply the threshold to existing routes, clear the route and let it reestablish.

Examples

This example shows how to configure the IP MLS threshold to 10 packets per second:

Router(config)# mls ip multicast threshold 10 

Related Commands

Command
Description

mls rp ip (global configuration)

Enables external systems to establish IP shortcuts to the MSFC.

show mls ip multicast

Displays the MLS IP information.


mode bypass

To enable Virtual Multipoint Interfaces (VMI) to support multicast traffic, use the mode bypass command in interface configuration mode. To return the interface to the default mode of aggregate, use the no form of this command.

mode [aggregate | bypass]

no mode bypass

Syntax Description

aggregate

Sets the mode to aggregate. All virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI.

bypass

Sets the mode to bypass.


Command Default

No mode

Command Modes

Interface configuration

Command History

Release
Modification

12.4(15)XF

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T to support multicast traffic on Virtual Multipoint Interfaces (VMIs).


Usage Guidelines

Use the mode bypass command when you need to support multicast traffic in router-to-radio configurations.

Aggregate Mode

The default mode for operation of the VMI is aggregate mode. In aggregate mode, all of the virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI. As such, applications above Layer 2, such as, EIGRP and OSPFv3, should be defined on the VMI interface only. Packets sent to the VMI will be correctly forwarded to the correct virtual-access interface.

Bypass Mode

Using bypass mode is recommended for multicast applications.

In bypass mode, the virtual-access interfaces are directly exposed to applications running above Layer2. In bypass mode, definition of a VMI is still required because the VMI will continue to manage presentation of cross-layer signals, such as, neighbor up, neighbor down, and metrics. However, applications will still be aware on the actual underlying virtual-access interfaces and send packets to them directly.

Using bypass mode can cause databases in the applications to be larger because knowledge of more interfaces are required for normal operation.

After you enter the mode bypass command, Cisco recommends that you copy the running configuration to NVRAM. because the default mode of operation for VMI is to logically aggregate the virtual-access interfaces.

Examples

Bypass Mode on VMI Interfaces

Enabling Multicast on VMI interfaces includes changing the VMI interface to bypass mode and enabling Protocol Independent Multicast (PIM) sparse mode on the virtual-template interface.

Router# enable
Router# configure terminal
!
Router(config)#interface Virtual-Template1
Router(config-if)#ip address 10.3.3.1 255.255.255.0
Router(config-if)# load-interval 30
Router(config-if)# no keepalive
Router(config-if)# ip pim sparse-dense-mode
Router(config-if)#service-policy output FQ
!
!
Router(config)#interface vmi1
Router(config-if)#ip address 10.3.9.1 255.255.255.0
Router(config-if)# load-interval 30
Router(config-if)# physical-interface FastEthernet0/0
Router(config-if)# mode bypass
!
Router(config)#end

OSPF v3 Using Bypass Mode for IPv6 Multicast Traffic Example

The ipv6 ospf network point-to-multipoint command in this OSPF example is needed to allow OSPFv3 to learn dynamic metrics from the link.

version 12.4
!
hostname host1
!
enable
configure terminal
!
no aaa new-model
clock timezone EST -5
!
!
!
ip cef
no ip domain lookup
ipv6 unicast-routing
ipv6 cef
subscriber authorization enable
!
subscriber profile host1
 pppoe service manet_radio
!
multilink bundle-name authenticated
no virtual-template subinterface
!
!
archive
 log config
!
policy-map FQ
 class class-default
  fair-queue
!
bba-group pppoe VMI1
 virtual-template 1
 service profile host1
!
interface Loopback1
 no ip address 
 load-interval 30
 ipv6 address 2001:0DB1::1/64
 ipv6 enable

pv6 ospf 1 area 0
!
interface FastEthernet0/0
 no ip address
 no ip mroute-cache
 load-interval 30
 speed 100
 full-duplex
 ipv6 enable
 pppoe enable group VMI1
!
interface Serial1/0
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/1
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/2
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/3
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface FastEthernet2/0
 switchport access vlan 2
 duplex full
 speed 100
!
interface FastEthernet2/1
 switchport access vlan 503
 load-interval 30
 duplex full
 speed 100
!
interface FastEthernet2/2
 shutdown
!
interface FastEthernet2/3
shutdown
!
interface Virtual-Template1
 no ip address
 load-interval 30
 ipv6 address 2001:0DB2::1/64
 ipv6 enable
! 
ipv6 ospf network point-to-multipoint
ipv6 ospf cost dynamic
 ipv6 ospf 1 area 0
 no keepalive
 service-policy output FQ
!
interface Vlan1
 no ip address
 no ip mroute-cache
 shutdown
!
interface Vlan2
 no ip address 
 no ip mroute-cache
load-interval 30
 ipv6 address 2001:0DB5::1/64
 ipv6 enable
 ipv6 ospf 1 area 0
!
interface Vlan503
 load-interval 30
 ipv6 address 2001:0DB8::1/64
 ipv6 enable
 ipv6 ospf 1 area 0
!
interface vmi1
 no ip address
 load-interval 30
 ipv6 enable
 physical-interface FastEthernet0/0
 mode bypass
!
!
no ip http server
no ip http secure-server
!ipv6 router ospf 1
 log-adjacency-changes
 redistribute connected metric-type 1
!
!
!
control-plane
!
!
line con 0
 exec-timeout 0 0
 stopbits 1
line aux 0
line vty 0 4
 login
!
end

EIGRP IPv4 with Bypass Mode Example

In this example, the IP address of the VMI1 interface needs to be defined, but it will not be routable because the vmi interface will be configured as down/down.


version 12.4

ostname host1
!
no aaa new-model
clock timezone EST -5
ip cef
!
no ip domain lookup
subscriber authorization enable
!
subscriber profile host1
 pppoe service manet_radio
!
!
multilink bundle-name authenticated
no virtual-template subinterface
!
archive
 log config
!
policy-map FQ
 class class-default
  fair-queue
!
!
!bba-group pppoe VMI1
 virtual-template 1
 service profile host1
!
!
interface Loopback1
ip address 10.9.1.1 255.255.255.0
 load-interval 30
!
interface FastEthernet0/0
 no ip address
 no ip mroute-cache
 load-interval 30
 speed 100
 full-duplex
 pppoe enable group VMI1
!
interface Serial1/0
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/1
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/2
 no ip address
 no ip mroute-cache
shutdown
 clock rate 2000000
!
interface Serial1/3
no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface FastEthernet2/0
 switchport access vlan 2
 duplex full
speed 100
!
interface FastEthernet2/1
 switchport access vlan 503
 load-interval 30
 duplex full
 speed 100
!
interface FastEthernet2/2
 shutdown
!
interface FastEthernet2/3
 shutdown
!
interface Virtual-Template1
 ip address 10.3.3.1 255.255.255.0
 load-interval 30
 no keepalive
 service-policy output FQ
!
interface Vlan1
 no ip address
 no ip mroute-cache
 shutdown
!
interface Vlan2
 ip address 10.15.60.144 255.255.255.0
 no ip mroute-cache
 load-interval 30
!
interface Vlan503
 ip address 10.2.2.2 255.255.255.0
 load-interval 30
 ipv6 address 3514:8::1/64
ipv6 enable
!
interface vmi1
ip address 10.3.9.1 255.255.255.0
 load-interval 30
 physical-interface FastEthernet0/0
 mode bypass
!
router eigrp 1
 redistribute connected
 network 10.2.0.0 0.0.255.255
 network 10.3.0.0 0.0.255.255

EIGRP for IPv6 Example

version 12.4
enable
configure terminal

ip cef
!
!
!
no ip domain lookup
ipv6 unicast-routing
ipv6 cef
subscriber authorization enable
!
subscriber profile host1
 pppoe service manet_radio
!
multilink bundle-name authenticated
no virtual-template subinterface
!
!
!
archive
 log config
!
!
policy-map FQ
class class-default
 fair-queue
!
!
!
bba-group pppoe VMI1
 virtual-template 1
service profile host1
!
!
interface Loopback1
load-interval 30
 ipv6 address 2001:)DB1::1/64
 ipv6 enable
 ipv6 eigrp 1
!
interface FastEthernet0/0
 no ip address
 no ip mroute-cache
 load-interval 30
 speed 100
 full-duplex
 pppoe enable group VMI1
!
interface Serial1/0
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/1
 no ip address
 no ip mroute-cache
 shutdown

clock rate 2000000
!
interface Serial1/2
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/3
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface FastEthernet2/0
 switchport access vlan 2
 duplex full
 speed 100
!
interface FastEthernet2/1
 switchport access vlan 503
 load-interval 30
 duplex full
 speed 100
!
interface FastEthernet2/2
 shutdown
!
interface FastEthernet2/3
 shutdown
!
interface Virtual-Template1
 no ip address
 load-interval 30
 ipv6 address 2001:0DB2::1/64
 ipv6 enable
 ipv6 eigrp 1
 no keepalive
 service-policy output FQ
!
interface Vlan1
 no ip address
 no ip mroute-cache
 shutdown
!
interface Vlan2
 no ip address 
 no ip mroute-cache
 load-interval 30
 ipv6 address 2001:0DB5::1/64
 ipv6 enable
 ipv6 eigrp 1
!
interface Vlan503
 no ip address 
 load-interval 30
 ipv6 address 2001:0DB8::1/64
 ipv6 enable
 ipv6 eigrp 1
!
interface vmi1
no ip address
 load-interval 30
 ipv6 enable
 physical-interface FastEthernet0/0
 mode bypass
!
!
no ip http server
no ip http secure-server
!
ipv6 router eigrp 1
 no shutdown
 redistribute connected
!
!
!

EIGRP with IPv4 and IPv6 Traffic Using Bypass Mode Example

version 12.4T
!
hostname host1
!
enable
configure terminal

ip cef
no ip domain lookup
ipv6 unicast-routing
ipv6 cef
subscriber authorization enable
!
subscriber profile host1
 pppoe service manet_radio
!
multilink bundle-name authenticated
no virtual-template subinterface
!
archive
 log config
!
!
policy-map FQ
 class class-default
  fair-queue
!
bba-group pppoe VMI1
 virtual-template 1
 service profile host1
!
!
interface Loopback1
 ip address 10.9.1.1 255.255.255.0
 load-interval 30
 ipv6 address 2001:0DB1::1/64
 ipv6 enable
 ipv6 eigrp 1
!
interface FastEthernet0/0
 no ip address
 no ip mroute-cache
 load-interval 30
 speed 100
 full-duplex
 pppoe enable group VMI1
!
interface Serial1/0
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/1
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/2
no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface Serial1/3
 no ip address
 no ip mroute-cache
 shutdown
 clock rate 2000000
!
interface FastEthernet2/0
 switchport access vlan 2
 duplex full
 speed 100
!
interface FastEthernet2/1
 switchport access vlan 503
 load-interval 30
 duplex full
 speed 100
!
interface FastEthernet2/2
 shutdown
!
interface FastEthernet2/3
 shutdown
!
interface Virtual-Template1
 ip address 10.3.3.1 255.255.255.0
 load-interval 30
 ipv6 address 2001:0DB8:0000:0000::/64
 ipv6 enable
 ipv6 eigrp 1
 no keepalive
 service-policy output FQ
!
interface Vlan1
 no ip address
 no ip mroute-cache
 shutdown
!
interface Vlan2
 ip address 10.15.60.144 255.255.255.0
 no ip mroute-cache
 load-interval 30
!
interface Vlan503
 ip address 10.2.2.2 255.255.255.0
 load-interval 30
 ipv6 address 2001:0DB8::1/64
 ipv6 enable
 ipv6 eigrp 1
!
interface vmi1
 ip address 10.3.9.1 255.255.255.0
 load-interval 30
 ipv6 enable
 physical-interface FastEthernet0/0
 mode bypass
!
router eigrp 1
 redistribute connected
 network 10.2.0.0 0.0.255.255
 network 10.3.0.0 0.0.255.255
 auto-summary
!
!
no ip http server
no ip http secure-server
!
ipv6 router eigrp 1
 eigrp router-id 10.9.1.1
 no shutdown
 redistribute connected
!
!
!
end

Related Commands

Command
Description

interface vmi

Creates a VMI interface.


mrinfo

To query which neighboring multicast routers are "peering" with the local router, use the mrinfo command in user EXEC or privileged EXEC mode.

mrinfo [host-name | host-address] [source-address | interface]

Syntax Description

host-name | host-address

(Optional) The Domain Name System (DNS) name or IP address of the multicast router to query. If omitted, the router queries itself.

source-address

(Optional) Source address used on multicast routing information (mrinfo) requests. If omitted, the source is based on the outbound interface for the destination.

interface

(Optional) Source interface used on mrinfo requests. If omitted, the source is based on the outbound interface for the destination.


Defaults

The command is disabled.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

The mrinfo command is the original tool of the multicast backbone (MBONE) to determine which neighboring multicast routers are peering with a multicast router. Cisco routers have supported responding to mrinfo requests since Cisco IOS Release 10.2.

Now you can query a multicast router using this command. The output format is identical to the multicast routed version of Distance Vector Multicast Routing Protocol (DVMRP). (The mrouted software is the UNIX software that implements DVMRP.)

Examples

The following is sample output from the mrinfo command:

Router# mrinfo

192.31.7.37 (barrnet-gw.cisco.com) [version cisco 11.1] [flags: PMSA]:
  192.31.7.37 -> 192.31.7.34 (sj-wall-2.cisco.com) [1/0/pim]
  192.31.7.37 -> 192.31.7.47 (dirtylab-gw-2.cisco.com) [1/0/pim]
  192.31.7.37 -> 192.31.7.44 (dirtylab-gw-1.cisco.com) [1/0/pim]
  131.119.26.10 -> 131.119.26.9 (su-pr2.bbnplanet.net) [1/32/pim]

The flags indicate the following:

P: prune-capable

M: mtrace-capable

S: SNMP-capable

A: Auto-RP-capable

mrm

To start or stop a Multicast Routing Monitor (MRM) test, use the mrm command in privileged EXEC mode.

mrm test-name {start | stop}

Syntax Description

test-name

Name of the MRM test to start or stop.

start

Starts the MRM test specified for the test-name argument.

stop

Stops the MRM test specified for the test-name argument.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

You must use this command to run an MRM test. When the test runs, the Test Sender sends User Datagram Protocol (UDP) or UDP/Real-Time Transport Protocol (RTP) packets (depending on the senders command) to the Test Receiver.

Examples

The following example shows how to start an MRM test. In this example, the MRM test named test1 is started.

Router# mrm test1 start

Related Commands

Command
Description

ip mrm manager

Identifies an MRM test and enters the mode in which you specify the test parameters.

senders

Configures Test Sender parameters used in MRM.

show ip mrm status-report

Displays the status reports in the MRM status report cache.


mstat

To display IP multicast packet rate and loss information, use the mstat command in user EXEC or privileged EXEC mode.

mstat {source-name | source-address} [destination-name | destination-address] [group-name | group-address]

Syntax Description

source-name | source-address

Domain Name System (DNS) name or the IP address of the multicast-capable source.

destination-name | destination-address

(Optional) DNS name or address of the destination. If omitted, the command uses the system at which the command is typed.

group-name | group-address

(Optional) DNS name or multicast address of the group to be displayed. Default address is 224.2.0.1 (the group used for multicast backbone [MBONE] Audio).


Defaults

The command is disabled.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

If no arguments are entered, the router will interactively prompt you for them.

This command is a form of UNIX mtrace that reports packet rate and loss information.

Examples

The following is sample output from the mstat command in user EXEC mode:

Router> mstat lwei-home-ss2 172.16.0.1 224.0.255.255

Type escape sequence to abort.
Mtrace from 172.16.0.0 to 172.16.0.10 via group 224.0.255.255
>From source (lwei-home-ss2.cisco.com) to destination (lwei-ss20.cisco.com)
Waiting to accumulate statistics......
Results after 10 seconds:

  Source        Response Dest    Packet Statistics For    Only For Traffic
172.16.0.0      172.16.0.10 All Multicast Traffic     From 172.16.0.0
     |       __/  rtt 48   ms   Lost/Sent = Pct  Rate     To 224.0.255.255
     v      /     hop 48   ms   ---------------------     --------------------
172.16.0.1      lwei-cisco-isdn.cisco.com  
     |     ^      ttl   1   
     v     |      hop 31   ms    0/12 = 0%      1 pps    0/1 = --%  0 pps
172.16.0.2 
172.16.0.3      eng-frmt12-pri.cisco.com  
     |     ^      ttl   2   
     v     |      hop -17  ms    -735/12 = --%      1 pps    0/1 = --%  0 pps
172.16.0.4    
172.16.0.5      eng-cc-4.cisco.com  
     |     ^      ttl   3   
     v     |      hop -21  ms    -678/23 = --%      2 pps    0/1 = --%  0 pps
172.16.0.6 
172.16.0.7      eng-ios-2.cisco.com  
     |     ^      ttl   4   
     v     |      hop 5    ms    605/639 = 95%      63 pps    1/1 = --%  0 pps
172.16.0.8 
172.16.0.9      eng-ios-f-5.cisco.com  
     |      \__   ttl   5   
     v         \  hop 0    ms        4         0 pps           0    0 pps
172.16.0.0      172.16.0.10 
  Receiver      Query Source

Table 9 describes the significant fields shown in the display.

Table 9 mstat Field Descriptions 

Field
Description

Source

Traffic source of packet.

Response Dest

Place where the router sends the results of the mstat command.

  ttl

Number of hops required from the traffic source to the current hop.

  hop

Number of milliseconds of delay.

Only For Traffic From

0 packets dropped out of 2 packets received. If, for example, -2/2 was indicated, then there are 2 extra packets, which could indicate a loop condition.


Related Commands

Command
Description

mtrace

Traces the path from a source to a destination branch for a multicast distribution tree.


mtrace

To trace the path from a source to a destination branch for a multicast distribution tree, use the mtrace user command in user EXEC or privileged EXEC mode.

mtrace {source-name | source-address} [destination-name | destination-address] [group-name | group-address]

Syntax Description

source-name | source-address

Domain Name System (DNS) name or the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.

destination-name | destination-address

(Optional) DNS name or address of the unicast destination. If omitted, the mtrace starts from the system at which the command is typed.

group-name | group-address

(Optional) DNS name or multicast address of the group to be traced. Default address is 224.2.0.1 (the group used for multicast backbone [MBONE] Audio). When address 0.0.0.0 is used, the software invokes a weak mtrace. A weak mtrace is one that follows the RPF path to the source, regardless of whether any router along the path has multicast routing table state.


Defaults

The command is disabled.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

The trace request generated by the mtrace command is multicast to the multicast group to find the last hop router to the specified destination. The trace then follows the multicast path from destination to source by passing the mtrace request packet via unicast to each hop. Responses are unicast to the querying router by the first hop router to the source. This command allows you to isolate multicast routing failures.

If no arguments are entered, the router will interactively prompt you for them.

This command is identical in function to the UNIX version of mtrace.

Examples

The following is sample output from the mtrace command in user EXEC mode:

Router> mtrace 172.16.0.0 172.16.0.10 239.254.254.254

Type escape sequence to abort.
Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254
From source (?) to destination (?)
Querying full reverse path... 
 0  172.16.0.10
-1  172.16.0.8 PIM  thresh^ 0  0 ms  
-2  172.16.0.6 PIM  thresh^ 0  2 ms  
-3  172.16.0.5 PIM  thresh^ 0  894 ms  
-4  172.16.0.3 PIM  thresh^ 0  893 ms  
-5  172.16.0.2 PIM  thresh^ 0  894 ms  
-6  172.16.0.1 PIM  thresh^ 0  893 ms 

Table 10 describes the significant fields shown in the display.

Table 10 mtrace Field Descriptions 

Field
Description

Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254

Name and address of source, destination, and group for which routes are being traced.

-3 172.16.0.5

Hops away from destination (-3) and address of intermediate router.

PIM thresh^ 0

Multicast protocol in use on this hop, and time-to-live (TTL) threshold.

893 ms

Time taken for trace to be forwarded between hops.


Related Commands

Command
Description

mstat

Displays IP multicast packet rate and loss information.


receivers

To establish Test Receivers for Multicast Routing Monitor (MRM) tests or modify the parameters of Test Receivers, use the receivers command in MRM manager configuration mode. To restore the default values, use the no form of this command.

Form of the Command to Establish Test Receivers

receivers access-list sender-list access-list [packet-delay]

no receivers access-list

Form of the Command to Modify the Parameters of Test Receivers

receivers access-list [window seconds] [report-delay seconds] [loss percentage] [no-join] [monitor | poll]

no receivers access-list

Syntax Description

access-list

IP named or numbered access list that establishes the Test Receivers. Only these Test Receivers are subject to the other keywords and arguments specified in this command.

sender-list access-list

Specifies the sources that the Test Receiver should monitor. If the named or numbered access list matches any access list specified in the senders command, the associated packet-delay milliseconds keyword and argument of that senders command are used in this command. Otherwise, the packet-delay argument is required in this receivers command.

packet-delay

(Optional) Specifies the delay between test packets (in milliseconds). The range is from 50 to 10000. If the sender-list access list matches any access list specified in a senders command, the associated packet-delay milliseconds keyword and argument of that senders command are used in this command. Otherwise, the packet-delay argument is required in this receivers command.

window seconds

(Optional) Specifies the duration (in seconds) of a test period. This is a sliding window of time in which the packet count is collected, so that the loss percentage can be calculated. The range is from 1 to 10. The default is 5 seconds.

report-delay seconds

(Optional) Specifies the delay (in seconds) between status reports. The delay prevents multiple Test Receivers from sending status reports to the Manager at the same time for the same failure. This value is relevant only if there are multiple Test Receivers. The range is from 1 to 60. The default is 1 second.

loss percentage

(Optional) Specifies the threshold percentage of packet loss required before a status report is triggered. The range is from 0 to 100. The default is 0 percent, which means that a status report is sent for any packet loss. (This value is not applied to packet duplication; a fault report is sent for any duplicated packets.) Loss percentage calculation is explained in the "Usage Guidelines" section of this command.

no-join

(Optional) Specifies that the Test Receiver does not join the monitored group. The default is that the Test Receiver joins the monitored group.

monitor | poll

(Optional) Specifies whether the Test Receiver monitors the test group or polls for receiver statistics. The monitor keyword means the Test Receiver reports only if the test criteria are met. The poll keyword means the Test Receiver sends status reports regularly, whether test criteria are met or not. The default is the behavior set with the monitor keyword.


Command Default

No Test Receivers are configured for MRM tests.

Command Modes

MRM manager configuration (config-mrm-manager)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command is required for MRM to work; the receivers access-list and sender-list access-list keyword-argument pairs must be specified.


Note The Cisco IOS CLI parser accepts the command entered without the required sender-list access-list keyword-argument pair. This keyword-argument pair, however, is not optional. For an MRM test to work, you must specify the sources that the Test Receiver should monitor using the sender-list keyword and access-list argument.


Optionally, you can use the receivers command to modify the parameters for Test Receivers.

Loss percentage is calculated based on the packet-delay value of the senders command, which defaults to 200 milliseconds, or 5 packets per second. If the window keyword defaults to 5 seconds, then the Test Receiver expects 5 packets per second for 5 seconds = 25 packets. If the Test Receiver receives only 15 packets, then 25 - 15 = 10 lost packets. Lost packets divided by packets expected equals loss percentage; 10/25 equals a loss percentage of 40 percent.

Examples

The following example shows how to establish a Test Receiver for an MRM test:

ip mrm manager test1
 manager Ethernet0/0 group 239.1.1.1
 senders 1
 receivers 2 sender-list 1
!
access-list 1 permit 10.1.1.2
access-list 2 permit 10.1.4.2
!

Related Commands

Command
Description

senders

Establishes Test Senders for MRM.


router-guard ip multicast

To enable the router guard for switch ports that are connected to multicast routers, use the router-guard ip multicast command in interface configuration mode. To disable the router guard on switch ports that are connected to multicast routers, use the no form of this command.

router-guard ip multicast [vlan vlan-id]

no router-guard ip multicast [vlan vlan-id]

Syntax Description

vlan vlan-id

(Optional) Specifies the Layer 2 VLAN identification.


Command Default

The router guard for switch ports that are connected to multicast routers is disabled by default.

Command Modes

Interface configuration (config-if)

Command History

Release
Modification

12.2(33)SXH

This command was introduced.


Usage Guidelines

You can enter the vlan vlan-id keyword and argument if the port is a trunk port.

You cannot enter a range or multiple VLANs in a single command.

For the router guard to work on switch ports, you must enter the router-guard ip multicast switchports global configuration command before entering the router-guard ip multicast interface configuration command.

Examples

This example shows how to enable the router guard on an interface:

Router(config-if)# router-guard ip multicast

This example shows how to disable router guard on an interface:

Router(config-if)# no router-guard ip multicast vlan 100

Related Commands

Command
Description

clear router-guard ip multicast statistics

Clears the router guard statistical information.

router-guard ip multicast switchports

Enables or disables the router guard on all switch ports.


router-guard ip multicast switchports

To enable the router guard on all switch ports, use the router-guard ip multicast switchports command in global configuration mode. To disable the router guard on all switch ports, use the no form of this command.

router-guard ip multicast switchports

no router-guard ip multicast switchports

Syntax Description

This command has no arguments or keywords.

Command Default

The router guard is disabled on all switch ports.

Command Modes

Global configuration (config)

Command History

Release
Modification

12.2(33)SXH

This command was introduced.


Usage Guidelines

If received on a port that has router guard enabled, the following packet types are discarded and the statistics are updated indicating that packets are being dropped by the router guard:

Internet Group Management Protocol (IGMP) query messages

IPv4 Peripheral Interface Manager version 2 messages

IGMP PIM messages (PIMv1)

IGMP Distance Vector Multicast Routing Protocol (DVMRP) messages

Router-port Group Management Protocol (RGMP)messages

Cisco Group Multicast Protocol (CGMP)messages

Examples

This example shows how to enable the router guard on all switch ports:

Router(config)# router-guard ip multicast switchports

This example shows how to disable the router guard on all switch ports:

Router(config)# no router-guard ip multicast switchports

Related Commands

Command
Description

clear router-guard ip multicast statistics

Clears the router guard statistical information.

router-guard ip multicast

Enables or disables the router guard for switch ports that are connected to multicast routers.

show router-guard

Displays the router guard status and configuration information.


senders

To configure Test Sender parameters used for a Multicast Routing Monitor (MRM) test, use the senders command in MRM manager configuration mode. To restore the default settings, use the no form of this command.

senders access-list [packet-delay milliseconds] [rtp | udp] [target-only | all-multicasts | all-test-senders] [proxy-src]

no senders access-list

Syntax Description

access-list

IP named or numbered access list that defines which Test Senders are involved in the test and which Test Senders these parameters apply to.

packet-delay milliseconds

(Optional) Specifies the delay between test packets (in milliseconds). The range is from 50 to 10000. The default is 200 milliseconds, which results in 5 packets per second.

rtp | udp

(Optional) Specifies the encapsulation of test packets, either Real-Time Transport Protocol (RTP)-encapsulated or User Datagram Protocol (UDP)-encapsulated. By default, test packets are RTP-encapsulated.

target-only

(Optional) Specifies that test packets are sent out on the targeted interface only (that is, the interface with the IP address that is specified in the Test Sender request target field). By default, test packets are sent out on all interfaces that are enabled with IP multicast.

all-multicasts

(Optional) Specifies that the test packets are sent out on all interfaces that are enabled with IP multicast. This is the default method for sending test packets.

all-test-senders

(Optional) Specifies that test packets are sent out on all interfaces that have test-sender mode enabled. By default, test packets are sent out on all interfaces that are enabled with IP multicast.

proxy-src

(Optional) Source IP address for which the Test Sender will proxy test packets. Enter an address if you want to test, for a specific source, whether the multicast distribution tree is working.


Command Default

No test senders are configured to be involved in MRM tests.

Command Modes

MRM manager configuration (config-mrm-manager)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to specify which Test Senders are involved in the test and are affected by these parameters.

Examples

The following example shows how to configure a Test Sender for an MRM test:

ip mrm manager test1
 manager Ethernet0/0 group 239.1.1.1
 senders 1
 receivers 2 sender-list 1
!
access-list 1 permit 10.1.1.2
access-list 2 permit 10.1.4.2

Related Commands

Command
Description

receivers

Establishes Test Receivers for MRM.


show ip dvmrp route


Note The show ip dvmrp route command is not available in 12.2(33)SRB, 15.0(1)M, and later 12.2SR, 15.0M, and T releases.


To display the contents of the Distance Vector Multicast Routing Protocol (DVMRP) routing table, use the show ip dvmrp route command in user EXEC or privileged EXEC mode.

show ip dvmrp route [name | ip-address | interface-type interface-number]

Syntax Description

name

(Optional) Name of an entry in the DVMRP routing table.

ip-address

(Optional) IP address of an entry in the DVMRP routing table.

interface-type interface-number

(Optional) Interface type and number.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

10.3

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SRB

This command was removed.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

15.0(1)M

This command was removed.


Examples

The following is sample output from the show ip dvmrp route command:

Router# show ip dvmrp route

DVMRP Routing Table - 1 entry
172.16.0.0/16 [100/11] uptime 07:55:50, expires 00:02:52
    via 192.168.0.0, Tunnel3

Table 11 describes the significant fields shown in the display.

Table 11 show ip dvmrp route Field Descriptions 

Field
Description

1 entry

Number of entries in the DMVRP routing table.

172.16.0.0/16

Source network.

[100/11]

Administrative distance/metric.

uptime

How long (in hours, minutes, and seconds) that the route has been in the DVMRP routing table.

expires

How long (in hours, minutes, and seconds) until the entry is removed from the DVMRP routing table.

via 192.168.0.0

Next hop router to the source network.

Tunnel3

Interface to the source network.


Related Commands

Command
Description

ip dvmrp accept-filter

Configures an acceptance filter for incoming DVMRP reports.


show ip igmp groups

To display the multicast groups with receivers that are directly connected to the router and that were learned through Internet Group Management Protocol (IGMP), use the show ip igmp groups command in user EXEC or privileged EXEC mode.

show ip igmp [vrf vrf-name] groups [group-name | group-address | interface-type interface-number] [detail]

Syntax Description

vrf vrf-name

(Optional) Supports the multicast VPN routing and forwarding (VRF) instance and indicates the name assigned to the VRF.

group-name

(Optional) Name of the multicast group, as defined in the Domain Name System (DNS) hosts table.

group-address

(Optional) Address of the multicast group. This is a multicast IP address in four-part, dotted-decimal notation.

interface-type interface-number

(Optional) Interface type and Interface number.

detail

(Optional) Provides a detailed description of the sources known through IGMP Version 3 (IGMPv3), IGMPv3lite, or URL Rendezvous Directory (URD).


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

12.1(3)T

Fields were added to the output of this command to support the Source Specific Multicast (SSM) feature.

12.1(5)T

The detail keyword was added.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.3(2)T

A field was added to the output of this command to support the SSM mapping feature.

12.2(18)S

A field was added to the output of this command to support the SSM mapping feature.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

If you omit all optional arguments and keywords, the show ip igmp groups command displays by group address, interface type, and interface number all directly connected multicast groups.

Examples

The following is sample output from the show ip igmp groups command:

Router# show ip igmp groups

IGMP Connected Group Membership
Group Address     Interface         Uptime      Expires     Last Reporter
239.255.255.254   Ethernet3/1       1w0d        00:02:19    172.21.200.159
224.0.1.40        Ethernet3/1       1w0d        00:02:15    172.21.200.1
224.0.1.40        Ethernet3/3       1w0d        never       172.16.214.251
224.0.1.1         Ethernet3/1       1w0d        00:02:11    172.21.200.11
224.9.9.2         Ethernet3/1       1w0d        00:02:10    172.21.200.155
232.1.1.1         Ethernet3/1       5d21h       stopped     172.21.200.206

The following is sample output from the show ip igmp groups command with the group-address argument and detail keyword:

Router# show ip igmp groups 192.168.1.1 detail

Interface:      Ethernet3/2
Group:          192.168.1.1
Uptime:         01:58:28
Group mode:     INCLUDE
Last reporter:  10.0.119.133
CSR Grp Exp:    00:02:38
Group source list: (C - Cisco Src Report, U - URD, R - Remote 
                    S- Static, M - SSM Mapping)
  Source Address   Uptime    v3 Exp    CSR Exp   Fwd  Flags
  172.16.214.1     01:58:28  stopped   00:02:31  Yes  C

Table 12 describes the significant fields shown in the displays.

Table 12 show ip igmp groups Field Descriptions 

Field
Description

Group Address

Address of the multicast group.

Interface

Interface through which the group is reachable.

Uptime

Time in weeks, days, hours, minutes, and seconds that this multicast group has been known.

Expires

Time in weeks, days, hours, minutes, and seconds until the entry expires. If an entry expires, then the entry (for a short period) shows "now" before it is removed.

"never" indicates that the entry will not time out, because a local receiver is on this router for this entry.

"stopped" indicates that timing out of this entry is not determined by this expire timer. If the router is in INCLUDE mode for a group, then the whole group entry times out after the last source entry has timed out (unless the mode is changed to EXCLUDE mode before it times out).

Last Reporter

Last host to report being a member of the multicast group. Both IGMP v3lite and URD require a v2-report.

Group mode:

Either INCLUDE or EXCLUDE. The group mode is based on the type of membership reports that are received on the interface for the group. In the output for the show ip igmp groups detail command, the EXCLUDE mode also shows the Expires: field for the group entry (not shown in the output).

CSR Grp Exp

Shown for multicast groups in the SSM range. It indicates the time (in hours, minutes, and seconds) since the last received group membership report was received. Cisco IOS software needs to use these reports for the operation of URD and IGMP v3lite, but they do not indicate group membership by themselves.

Group source list:

Details of which sources have been requested by the multicast group.

Source Address

IP address of the source.

Uptime

Time since the source state was created.

v3 Exp

Time in hours, minutes, and seconds until the membership for the source times out according to IGMP operations. "stopped" displays if no member uses IGMPv3 (but only IGMP v3lite or URD).

CSR Exp

Time in hours, minutes, and seconds until the membership for the source times out according to IGMP v3lite or URD reports. "stopped" displays if members use only IGMPv3.

Fwd

Status of whether the router is forwarding multicast traffic due to this entry.

Flags

Information about the entry. The Remote flag indicates that an IGMPv3 report has been received by this source. The C flag indicates that an IGMP v3lite or URD report was received by this source. The U flag indicates that a URD report was received for this source.


Related Commands

Command
Description

ip igmp query-interval

Configures the frequency at which the Cisco IOS software sends IGMP host query messages.

ip igmp ssm-map enable

Enables SSM mapping for groups in a configured SSM range.

show ip igmp ssm-mapping

Displays information about SSM mapping or displays the sources that SSM mapping uses for a particular group.


show ip igmp interface

To display multicast-related information about an interface, use the show ip igmp interface command in user EXEC or privileged EXEC mode.

show ip igmp [vrf vrf-name] interface [interface-type interface-number]

Syntax Description

vrf

(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name assigned to the VRF.

interface-type

(Optional) Interface type.

interface-number

(Optional) Interface number.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

If you omit the optional arguments, the show ip igmp interface command displays information about all interfaces.

This command also displays information about dynamically learned Distance Vector Multicast Routing Protocol (DVMRP) routers on the interface.

Examples

The following is sample output from the show ip igmp interface command:

Router# show ip igmp interface

Ethernet0 is up, line protocol is up
  Internet address is 192.168.37.6, subnet mask is 255.255.255.0
  IGMP is enabled on interface
  IGMP query interval is 60 seconds
  Inbound IGMP access group is not set
  Multicast routing is enabled on interface
  Multicast TTL threshold is 0
  Multicast designated router (DR) is 192.168.37.33
  No multicast groups joined
Ethernet1 is up, line protocol is up
  Internet address is 192.168.36.129, subnet mask is 255.255.255.0
  IGMP is enabled on interface
  IGMP query interval is 60 seconds
  Inbound IGMP access group is not set
  Multicast routing is enabled on interface
  Multicast TTL threshold is 0
  Multicast designated router (DR) is 192.168.36.131
  Multicast groups joined: 225.2.2.2 226.2.2.2
Tunnel0 is up, line protocol is up
  Internet address is 10.1.37.2, subnet mask is 255.255.0.0
  IGMP is enabled on interface
  IGMP query interval is 60 seconds
  Inbound IGMP access group is not set
  Multicast routing is enabled on interface
  Multicast TTL threshold is 0
  No multicast groups joined

Table 13 describes the significant fields shown in the display.

Table 13 show ip igmp interface Field Descriptions 

Field
Description

Ethernet0 is up, line protocol is up

Interface type, number, and status.

Internet address is..., subnet mask is...

Internet address of the interface and subnet mask being applied to the interface, as specified with the ip address command.

IGMP is enabled on interface

Indicates whether IGMP has been enabled on the interface with the ip pim command.

IGMP query interval is 60 seconds

Interval at which the Cisco IOS software sends Protocol Independent Multicast (PIM) router query messages, as specified with the ip igmp query-interval command.

Inbound IGMP access group is not set

Indicates whether an IGMP access group has been configured with the ip igmp access-group command.

Multicast routing is enabled on interface

Indicates whether multicast routing has been enabled on the interface with the ip pim command.

Multicast TTL threshold is 0

Packet time-to-live threshold, as specified with the ip multicast ttl-threshold command.

Multicast designated router (DR) is...

IP address of the designated router for this LAN segment (subnet).

No multicast groups joined

Indicates whether this interface is a member of any multicast groups and, if so, lists the IP addresses of the groups.


Related Commands

Command
Description

ip address

Sets a primary or secondary IP address for an interface.

ip igmp access-group

Controls the multicast groups that hosts on the subnet serviced by an interface can join.

ip igmp query-interval

Configures the frequency at which the Cisco IOS software sends IGMP host query messages.

ip multicast ttl-threshold

Configures the TTL threshold of packets being forwarded out an interface.

ip pim

Enables PIM on an interface.


show ip igmp membership

To display Internet Group Management Protocol (IGMP) membership information for multicast groups and (S, G) channels, use the show ip igmp membership command in user EXEC or privileged EXEC mode.

show ip igmp membership [group-address | group-name] [tracked] [all]

Syntax Description

group-address

(Optional) The IP address of the multicast group for which to display IGMP membership information.

group-name

(Optional) The name of the multicast group, as defined in the Domain Name System (DNS) hosts table, for which to display IGMP membership information.

tracked

(Optional) Displays the multicast groups with the explicit tracking feature enabled.

all

(Optional) Displays the detailed information about the multicast groups with and without the explicit tracking feature enabled.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(19)S

This command was introduced.

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to display IGMP membership information for multicast groups and (S, G) channels. This command allows you to display detailed information about multicast group and channel membership and explicit tracking.

Examples

The following is sample output from the show ip igmp membership user EXEC command. Each entry in the output shows the aggregate membership information (indicated by the A flag) for a particular multicast group or channel from the IGMP cache. If the entry is prepended with a forward slash ("/") flag, the entry is a filtering entry that is blocking the data forwarding of the multicast group or channel.

Router> show ip igmp membership

Flags:A  - aggregate, T - tracked
       L  - Local, S - static, V - virtual, R - Reported through v3
       I - v3lite, D - Urd, M - SSM (S,G) channel
       1,2,3 - The version of IGMP, the group is in
Channel/Group-Flags:
       / - Filtering entry (Exclude mode (S,G), Include mode (*,G))
Reporter:
       <ip-address> - last reporter if group is not explicitly tracked
       <n>/<m>      - <n> reporter in include mode,<m> reporter in exclude

 Channel/Group                  Reporter        Uptime   Exp.  Flags  Interface
 *,224.0.1.40                   10.10.0.1       00:01:34 02:41 2LA   Et2/0
 *,239.1.1.1                    2/0             00:00:10 stop  3AT    Et2/0

The following is sample output from the show ip igmp membership user EXEC command with the multicast group address 239.1.1.1 and the tracked keyword specified:

Router> show ip igmp membership 239.1.1.1 tracked

Flags:A  - aggregate, T - tracked
       L  - Local, S - static, V - virtual, R - Reported through v3
       I - v3lite, D - Urd, M - SSM (S,G) channel
       1,2,3 - The version of IGMP, the group is in
Channel/Group-Flags:
       / - Filtering entry (Exclude mode (S,G), Include mode (*,G))
Reporter:
       <ip-address> - last reporter if group is not explicitly tracked
       <n>/<m>      - <n> reporter in include mode,<m> reporter in exclude

 Channel/Group                  Reporter        Uptime   Exp.  Flags  Interface
 *,239.1.1.1                    2/0             00:00:11 stop  3AT    Et2/0
 10.30.0.100,239.1.1.1          10.10.0.10      00:00:11 02:48 RT     Et2/0
 10.30.0.101,239.1.1.1          10.10.0.20      00:00:03 02:56 RT     Et2/0
 10.30.0.101,239.1.1.1          10.10.0.10      00:00:11 02:48 RT     Et2/0
 10.30.0.102,239.1.1.1          10.10.0.20      00:00:03 02:56 RT     Et2/0

Table 14 describes the significant fields shown in the displays.

Table 14 show ip igmp membership Field Descriptions 

Field
Description

Channel/Group

(S, G) channel or multicast group filtering entry.

Reporter

Displays information about the hosts reporting membership with the (S, G) channel or multicast group entry.

Uptime

The Uptime timer is how long (in hours, minutes, and seconds) the entry has been known.

Exp.

The Exp. timer is how long (in minutes and seconds) until the entry expires.

Flags

Provides information about the entry:

A—aggregate. Indicates that the aggregate information for the (S, G) channel or multicast group is being displayed.

T—tracked—Indicates that the multicast group is configured with the explicit tracking feature.

L—local. Indicates that the router itself is interested in receiving the traffic for this multicast group or channel. In order for the application to receive this traffic, the packets are sent to the process level of the router. When the ip igmp join-group command is configured for a multicast group, the L flag is set.

S—static. Indicates that the multicast group or channel is forwarded on the interface. When the ip igmp static-group command is configured on the interface, the S flag is set.

V—virtual. Indicates that service such as Hoot and Holler is running on the router requesting the traffic for the multicast group or channel. These services can process IP multicast traffic in the fast switching path. The L flag will not be set by these applications.

 

R—reported through v3. Indicates that an IGMP Version 3 (IGMPv3) report was received for this entry.

I—v3lite. Indicates that an IGMP Version 3 lite (IGMP v3lite) report was received for this entry.

D—URD. Indicates that a URL Rendezvous Directory (URD) report was received for this entry.

M—SSM (S, G) channel. Indicates that the multicast group address is in the Source Specific Multicast (SSM) range.

1, 2, 3—The version of IGMP. The version of IGMP that the multicast group is running.

Interface

Interface type and number.


Related Commands

Command
Description

ip igmp explicit-tracking

Enables explicit tracking of hosts, groups, and channels for IGMP Version 3.

ip igmp version

Configures the version of IGMP that the router uses.

show ip igmp groups

Displays the multicast groups with receivers that are directly connected to the router and that were learned through IGMP.


show ip igmp snooping

To display the Internet Group Management Protocol (IGMP) snooping configuration of a device, use the show ip igmp snooping command in privileged EXEC mode.

show ip igmp snooping [groups [count] | mrouter | querier] [vlan vlan-id]

Syntax Description

groups

(Optional) Displays group information.

count

(Optional) Displays the number of multicast groups learned by IGMP snooping.

mrouter

(Optional) Displays information about dynamically learned and manually configured multicast router ports.

querier

(Optional) Displays IGMP querier information.

vlan vlan-id

(Optional) Specifies a VLAN. Valid values are 1 to 1001. If this keyword is not configured, information is displayed for all VLANs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(5.2)WC(1)

This command was introduced.

12.2(15)ZJ

This command was implemented on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

12.3(4)T

This command was integrated into Cisco IOS Release 12.3(4)T on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

12.4(4)XC

This command was integrated into Cisco IOS Release 12.4(4)XC on Cisco 870 series Integrated Services Routers (ISRs). The groups and querier keywords were added.

12.4(15)T

The groups and count keywords were added on the Cisco 87x and the Cisco 1800 series Integrated Services Routers (ISRs) and on EtherSwitch high-speed WAN interface cards (HWICs) and EtherSwitch network modules running on the Cisco 1841, 2800, and 3800 series ISRs.


Usage Guidelines

You can also use the show mac-address-table multicast command to display entries in the MAC address table for a VLAN that has IGMP snooping enabled.

Examples

The following is sample output from the show ip igmp snooping command:

Router# show ip igmp snooping

Global IGMP Snooping configuration:
-----------------------------------
IGMP snooping              : Enabled
IGMPv3 snooping (minimal)  : Enabled
Report suppression         : Enabled
TCN solicit query          : Disabled
TCN flood query count      : 2
Last Member Query Interval : 1000
Vlan 1:
--------
IGMP snooping                       : Enabled
IGMPv2 immediate leave              : Enabled
Explicit host tracking              : Enabled
Multicast router learning mode      : pim-dvmrp
Last Member Query Interval          : 1000
CGMP interoperability mode          : IGMP_ONLY
Vlan 11:
--------
IGMP snooping                       : Enabled
IGMPv2 immediate leave              : Disabled
Explicit host tracking              : Enabled
Multicast router learning mode      : pim-dvmrp
Last Member Query Interval          : 1000
CGMP interoperability mode          : IGMP_ONLY

The information in the output display is self-explanatory.

The following is sample output from the show ip igmp snooping command using the vlan keyword:

Router# show ip igmp snooping vlan 1

vlan 1
----------
  IGMP snooping is globally enabled
  IGMP snooping is enabled on this Vlan
  IGMP snooping immediate-leave is enabled on this Vlan
  IGMP snooping mrouter learn mode is pim-dvmrp on this Vlan

The information in the output display is self-explanatory.

The following is sample output from the show ip igmp snooping command using the mrouter keyword:


Note In this example, Fa0/3 is a dynamically learned router port, and Fa0/2 is a configured static router port.


Router# show ip igmp snooping mrouter vlan 1

Vlan    ports
----    -----
   1    Fa0/2(static), Fa0/3(dynamic)

The information in the output display is self-explanatory.

The following is sample output from the show ip igmp snooping command using the groups keyword:

Router #show ip igmp snooping groups 
Vlan      Group          Version     Port List
---------------------------------------------------------
1         192.168.1.2      v2          Fa0/1/0
11        192.168.1.2      v2          Fa0/1/1

The information in the output display is self-explanatory.

The following is sample output from the show ip igmp snooping groups command with the count keyword specified:

Router# show ip igmp snooping groups count 

Total number of groups:   2

The information in the output is self-explanatory.

Related Commands

Command
Description

ip igmp snooping

Globally enables IGMP snooping. IGMP snooping must be globally enabled in order to be enabled on a VLAN.

ip igmp snooping vlan

Enables IGMP snooping on the VLAN interface.

ip igmp snooping vlan immediate-leave

Enables IGMP Immediate-Leave processing.

ip igmp snooping vlan mrouter

Configures a Layer 2 port as a multicast router port.

show mac-address-table multicast

Displays the Layer 2 multicast entries for a VLAN.


show ip igmp snooping explicit-tracking

To display the information about the explicit host-tracking status for IGMPv3 hosts, use the show ip igmp snooping explicit-tracking command in user EXEC or privileged EXEC mode.

show ip igmp snooping explicit-tracking vlan vlan-id

Syntax Description

vlan vlan-id

Specifies the VLAN to display.


Defaults

If you do not specify a VLAN, information for VLAN 1 is displayed.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

:This example shows how to display the information about the explicit host-tracking status for all IGMPv2 and IGMPv3 hosts:

Router# show ip igmp snooping explicit-tracking
Current number of entries: 3 Configured DB size limit: 32000 
VLAN 1 
Source/Group Interface Reporter Filter_mode 
--------------------------------------------------------------------------- 
VLAN 2 
Source/Group Interface Reporter Filter_mode 
--------------------------------------------------------------------------- 
VLAN 6 
Source/Group Interface Reporter Filter_mode 
--------------------------------------------------------------------------- 
VLAN 7 
Source/Group Interface Reporter Filter_mode 
--------------------------------------------------------------------------- 
VLAN 10 
Source/Group Interface Reporter Filter_mode 
--------------------------------------------------------------------------- 
0.0.0.0/224.0.1.40 Vl10: 11.10.0.2 EXCLUDE 
: 
Router#

:This example shows how to display the information about the explicit host-tracking status for IGMPv2 and IGMPv3 hosts:

Router# show ip igmp snooping explicit-tracking vlan 25

Source/Group          Interface   Reporter     Filter_mode 
------------------------------------------------------------------------ 
10.1.1.1/226.2.2.2    Vl25:1/2    10.27.2.3    INCLUDE 
10.2.2.2/226.2.2.2    Vl25:1/2    10.27.2.3    INCLUDE 
Router#

Related Commands

Command
Description

ip igmp snooping explicit-tracking

Enables explicit host tracking.


show ip igmp snooping filter

To display the Internet Group Management Protocol (IGMP) filtering rules, use the show ip igmp snooping filter command in privileged EXEC mode.

show ip igmp snooping filter interface type mod/port [statistics]

Syntax Description

interface type

Interface type; possible valid values are fastethernet, gigabitethernet, tengigabitethernet, port-channel num, and vlan vlan-id.

mod/port

Module and port number

statistics

(Optional) Displays IGMP filtering statistics.


Command Default

This command has no default settings.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SXH

This command was introduced.


Usage Guidelines

IGMP filtering allows you to configure filters on a per-port basis, a per-switch virtual interface (SVI) basis, or both.

The mod/port is not supported when you enter the vlan vlan-id keyword and argument.

IGMP filtering is supported for IPv4 only.

IGMP filters is not supported on routed ports.

If the port is in the shutdown state, the system cannot determine if the port is in trunk mode or access mode, and you will not be able to display the filter status by entering the show ip igmp snooping filter command. In this case, you can enter the show running-config interface command to display the configuration.

IGMP filtering statistics are maintained for the following only:

A specific switch port in an SVI.

A specific VLAN in a trunk.

Examples

The following example displays the default filters configured on the SVI:

Router# show ip igmp snooping filter interface vlan 20

Access-Group: Channel1-Acl 
Groups/Channels Limit: 100 (Exception List: Channel6-Acl) 
IGMP Minimum-Version: Not Configured
Router#

The following example displays the output on a switch port that is in access mode:

Router# show ip igmp snooping filter interface gigabitethernet3/48

Access-Group: Channel4-Acl 
Groups/Channels Limit: 10 (Exception List: Channel3-Acl)
Router#

The following example displays the filters configured for all switch ports in access mode under this SVI:

Router# show ip igmp snooping filter interface vlan 20 detail
VLAN20 :

Access-Group: Not Configured 
Groups/Channels Limit: Not Configured 
VLAN20 :
Access-Group: Channel4-ACL 
Groups/Channels Limit: 10 (Exception-list: Channel3-Acl)
Router#

The following example displays the default trunk port filters:

Router# show ip igmp snooping filter interface gigabitethernet3/46

Access-Group: Channel1-Acl 
Groups/Channels Limit: 10 (Exception List: Channel3-Acl)
Router#

The following example displays the per-VLAN filters for all VLANs on this trunk:

Router# show ip igmp snooping filter interface gigabitethernet3/46 detail

Vlan 10 :
Access-Group: Not Configured 
Groups/Channels Limit: Not Configured 
Vlan 20 :
Access-Group: Not Configured 
Groups/Channels Limit: 8 (Exception List: Channel4-Acl)
Router#

The following example displays the output on a trunk port for a specific VLAN:

Router# show ip igmp snooping filter interface gigabitethernet3/46 vlan 20

Access-Group: Not Configured
Groups/Channels Limit: 8 (Exception List: Channel4-Acl)
Router#

The following example displays the statistics for each switch port in access mode under the SVI:

Router# show ip igmp snooping filter interface vlan 20 statistics

GigabitEthernet3/47 :
IGMP Filters are not configured 
GigabitEthernet3/48 :
Access-group denied : 0 
Limit denied : 2 
Limit status : 0 active out of 2 max
Minimum-version denied : 0 

Table 15 describes the significant fields shown in the displays.

Table 15 show ip igmp snooping Field Descriptions

Field
Description

Access-Group: Channel1-Acl

Name of the access group.

Groups/Channels Limit: 100 (Exception List: Channel6-Acl)

Number of IGMP groups or channels allowed on an interface is set to 100, with the exception of group Channel1-Acl.

IGMP Minimum-Version: Not Configured

Minimum version not configured (ip igmp snooping minimum-version command).

IGMP Filters are not configured

Filtering on the IGMP protocol is disabled.

Access-group denied : 0

Number of access groups denied.

Limit denied : 2

 

Limit status : 0 active out of 2 max

Number of active groups.

Minimum-version denied : 0

 

Related Commands

Command
Description

ip igmp snooping access-group

Configures an IGMP group access group.

ip igmp snooping limit

Limits the number of IGMP groups or channels allowed on an interface.

ip igmp snooping minimum-version

Filters on the IGMP protocol.



show ip igmp snooping mrouter


Note The documentation for this command has been integrated into the documentation for the show ip igmp snooping command. Please see the show ip igmp snooping command for complete and up-to-date information about displaying information for dynamically learned and manually configured multicast router ports.


To display information on dynamically learned and manually configured multicast router ports, use the show ip igmp snooping mrouter command in privileged EXEC mode.

show ip igmp snooping mrouter [vlan vlan-id]

Syntax Description

vlan vlan-id

(Optional) Specifies a VLAN. Valid values are 1 to 1001.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(5.2)WC(1)

This command was introduced.

12.2(15)ZJ

This command was implemented on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

12.3(4)T

This command was integrated into Cisco IOS Release 12.3(4)T on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

You can also use the show mac-address-table multicast command to display entries in the MAC address table for a VLAN that has Internet Group Management Protocol (IGMP) snooping enabled.

Examples

The following is sample output from the show ip igmp snooping mrouter vlan 1 command:


Note In this example, Fa0/3 is a dynamically learned router port, and Fa0/2 is a configured static router port.


Router# show ip igmp snooping mrouter vlan 1

Vlan    ports
----    -----
   1    Fa0/2(static), Fa0/3(dynamic) 

Related Commands

Command
Description

ip igmp snooping

Globally enables IGMP snooping. IGMP snooping must be globally enabled in order to be enabled on a VLAN.

ip igmp snooping vlan

Enables IGMP snooping on the VLAN interface.

ip igmp snooping vlan immediate-leave

Enables IGMP Immediate-Leave processing.

ip igmp snooping vlan mrouter

Configures a Layer 2 port as a multicast router port.

show mac-address-table multicast

Displays the Layer 2 multicast entries for a VLAN.


show ip igmp snooping rate-limit

To display the information about the IGMP-snooping rate limit, use the show ip igmp snooping rate-limit command in user EXEC or privileged EXEC mode.

show ip igmp snooping rate-limit [statistics | vlan vlan-id]

Syntax Description

statistics

(Optional) Displays IGMP-snooping statistics.

vlan vlan-id

(Optional) Specifies a VLAN; valid values are from 1 to 4094.


Defaults

This command has no default settings.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(17a)SX

Support for this command was introduced on the Supervisor Engine 720.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

This example shows how to display the statistics for IGMP-snooping rate limiting:

Router# show ip igmp snooping rate-limit statistics

Max IGMP messages incoming rate : Not configured
Vlan   Incoming rate  Rate-limiting ON  Disable count  Time to Enable
-----+---------------+----------------+---------------+---------------+
222   1000            No               0 
111   5999            Yes              3               185


This example shows how to display IGMP-snooping rate-limit information for a specific VLAN:

Router# show ip igmp snooping rate-limit vlan 19

Max IGMP messages incoming rate : 200 pps
Vlan       Incoming IGMP rate (in pps)    
--------+---------------------------------
19       200

Related Commands

Command
Description

ip igmp snooping rate

Sets the rate limit for IGMP-snooping packets.


show ip igmp snooping statistics

To display IGMPv3 statistics, use the show ip igmp snooping statistics command in user EXEC or privileged EXEC mode.

show ip igmp snooping statistics [interface type [number]} | port-channel number | vlan vlan-id]

Syntax Description

interface type

(Optional) Displays IGMP statistics for the specified interface type; possible valid values are ethernet, fastethernet, and gigabitethernet.

number

(Optional) Multicast-related statistics for the specified module and port; see the "Usage Guidelines" section for valid values.

port-channel number

(Optional) Displays multicast-related statistics for the specified port-channel; valid values are from 1 to 282.

vlan vlan-id

(Optional) Displays multicast-related statistics for the specified VLAN; valid values for vlan-id are from 1 to 4094.


Defaults

This command has no default settings.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

The show ip igmp snooping statistics command displays the following statistics:

List of ports that are members of a group

Filter mode

Reporter-address behind the port

Additional information (such as the last-join and last-leave collected since the previous time that a clear ip igmp snooping statistics command was issued)

The number argument designates the module and port number. Valid values for number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.

The port-channel number values from 257 to 282 are supported on the CSM and the FWSM only.

The #hosts behind the VLAN is displayed only if you define the max-hosts policy on the specified VLAN and enable the log policy for the specified VLAN.

Examples

This example shows how to display IGMPv3 statistics:

Router# show ip igmp snooping statistics interface FastEthernet5/1

IGMP Snooping statistics
Service-policy: Policy1policy tied with this interface
#Channels: 3 
#hosts : 3
Query Rx: 2901 GS Query Rx: 0 V3 Query Tot Rx: 0 
Join Rx: 8686 Leave Rx: 0 V3 Report Rx: 2300
Join Rx from router ports: 8684 Leave Rx from router ports: 0 
Total Rx: 11587
Channel/Group         Interface  Reporter    Uptime     Last-Join  Last-Leave
10.7.20.1,239.1.1.1   F5/1       10.5.20.1   00:12:00   1:10:00    -
10.7.30.1,239.1.1.1   F5/1       10.5.30.1   00:50:10   1:10:02    0:30:02
10.7.40.1,239.1.1.1   F5/1       10.5.40.1   00:10:10   1:10:03    -

Table 16 describes the fields that are shown in the example.

Table 16 show ip igmp snooping statistics Field Descriptions 

Field
Description

Service-policy: Policy1

Policy tied to this interface.

#Channels: 3

Number of channels behind the specified interface.

#hosts

Number of hosts behind the specified interface. This field is displayed only if max-hosts policy is used.


Related Commands

Command
Description

clear ip igmp snooping statistics

Clears the IGMP-snooping statistics.


show ip igmp snooping subscriber-rate

To display the total rate subscribed by the host, use the show ip igmp snooping subscriber-rate command in user EXEC or privileged EXEC mode.

show ip igmp snooping subscriber-rate ip-address

Syntax Description

ip-address

Specifies the IP address.


Defaults

This command has no default settings.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(33)SXI

Support for this command was introduced on the Supervisor Engine 720.


Examples

This example shows how to display the total rate subscribed for IP address 10.10.10.10:

Router# show ip igmp snooping subscriber-rate 10.10.10.10
200.0.0.15/232.1.1.1    Vl15:Gi2/13    10.10.10.10    248 pps/91 kbps (1 sec) 
200.0.0.16/232.1.1.1    Vl15:Gi2/13    10.10.10.10    248 pps/91 kbps (1 sec) 
200.0.0.17/232.1.1.1    Vl15:Gi2/13    10.10.10.10    247 pps/91 kbps (1 sec) 
200.0.0.18/232.1.1.1    Vl15:Gi2/13    10.10.10.10    248 pps/91 kbps (1 sec) 
200.0.0.19/232.1.1.1    Vl15:Gi2/13    10.10.10.10    248 pps/91 kbps (1 sec) 
200.0.0.20/232.1.1.1    Vl15:Gi2/13    10.10.10.10    248 pps/91 kbps (1 sec) 
                                                   -------------------------- 
                                          Total = 1487 pps/546 kbps (1 sec) 
Router#

Related Commands

Command
Description

ip igmp snooping

Enables IGMP snooping.