Cisco IOS XR Multicast Command Reference, Release 3.4
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software

Table Of Contents

Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software

access-group (IGMP)

clear igmp counters

clear igmp group

clear igmp reset

clear mld counters

clear mld group

clear mld reset

explicit-tracking

interface all router disable (IGMP/MLD)

join-group

maximum groups

maximum groups per-interface

nsf lifetime (IGMP/MLD)

query-interval

query-max-response-time

query-timeout

router

router igmp

router mld

show igmp groups

show igmp interface

show igmp nsf

show igmp summary

show igmp traffic

show mld groups

show mld interface

show mld nsf

show mld summary

show mld traffic

static-group

version


Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software


This chapter describes the commands used to configure and monitor IPv4 and IPv6 protocol using Cisco IOS XR software.

The commands in this chapter apply to

Internet Group Management Protocol (IGMP) (Versions 1, 2, and 3), and

Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2)


Note IGMP Versions 2 and 3 are equivalent to MLD Versions 1 and 2.
IGMP Version 1 does not have a complimentary MLD version.


For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module.

access-group (IGMP)

To set limits on an interface for multicast group join requests by hosts, use the access-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

access-group access-list

no access-group access-list

Syntax Description

access-list

Number or name of a standard IP access list. Range is 1 to 99.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the global access group specified in router IGMP or MLD configuration mode.

If this command is not specified in router IGMP or MLD configuration mode, the interface accepts all multicast join requests by hosts.

Command Modes

Router IGMP interface configuration (IPv4)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

Task ID

Task ID
Operations

multicast

read, write


Examples

In the following example, hosts serviced by Packet-over-SONET/SDH (POS) interface 0/1/0/1 can join only group 225.2.2.2:

RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# ipv4 access-list mygroup permit 225.2.2.2 0.0.0.0
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/1
RP/0/RP0/CPU0:router(config-igmp-if)# access-group mygroup

In the following example, an access group is configured for IPv6:

RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# ipv6 access-list mld-acl
RP/0/RP0/CPU0:router(config-ipv6-acl)# 10 permit ipv6 any host ff3e::8000:1bb8
RP/0/RP0/CPU0:router(config-ipv6-acl)# exit
RP/0/RP0/CPU0:router(config)# router mld access-group mld-acl

clear igmp counters

To clear IGMP traffic statistics, use the clear igmp counters command in EXEC mode.

clear igmp [ipv4] counters

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

After IGMP statistics are cleared, statistics begin incrementing again.

Task ID

Task ID
Operations

multicast

execute


Examples

The following example shows sample output before and after clearing IGMP traffic statistics:

RP/0/RP0/CPU0:router# show igmp traffic
IGMP Traffic Counters
Elapsed time since counters cleared: 18:46:34
                                  Received        Sent
Valid IGMP Packets                       0        9102
Queries                                  0        4512
Reports                                  0        4590
Leaves                                   0           0
Mtrace packets                           0           0
DVMRP packets                            0           0
PIM packets                              0           0
Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0
RP/0/RP0/CPU0:router# clear igmp counters 
RP/0/RP0/CPU0:router# show igmp traffic 
IGMP Traffic Counters
Elapsed time since counters cleared: 00:00:12
                                  Received        Sent
Valid IGMP Packets                       0           1
Queries                                  0           1
Reports                                  0           0
Leaves                                   0           0
Mtrace packets                           0           0
DVMRP packets                            0           0
PIM packets                              0           0
Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0

Related Commands

Command
Description

show igmp traffic

Displays all IGMP traffic-related counters.


clear igmp group

To clear IGMP groups on one or all interfaces, use the clear igmp group command in EXEC mode.

clear igmp [ipv4] group [ip-address | type instance]

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.

ip-address

IP hostname or group address.

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

If no group address is specified, all IGMP groups are cleared.

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

To clear all igmp groups, use the clear igmp group command without using an argument. To clear a particular group, use the ipname/group address or type instance argument.

The following groups cannot be cleared:

224.0.0.2

224.0.0.13

224.0.0.22

224.0.0.40

Task ID

Task ID
Operations

multicast

execute


Examples

The following example uses the show igmp group command to display the IGMP Connected Group Membership, the clear igmp group command to clear address 239.1.1.1, and the show igmp group command again to display the updated list.

RP/0/RP0/CPU0:router# show igmp group pos 0/4/0/0 
[IGMP Connected Group Membership
Group Address    Interface    Uptime    Expires   Last Reporter
224.0.0.2        POS0/4/0/0   2w2d      never     40.40.1.1
224.0.0.13       POS0/4/0/0   2w2d      never     40.40.1.1
224.0.0.22       POS0/4/0/0   2w2d      never     40.40.1.1
239.1.1.1        POS0/4/0/0   00:00:02  00:02:07  40.40.1.22
RP/0/RP0/CPU0:router# clear igmp group pos 0/4/0/0
RP/0/RP0/CPU0:router# show igmp group pos 0/4/0/0
[IGMP Connected Group Membership
Group Address    Interface    Uptime    Expires   Last Reporter
224.0.0.2        POS0/4/0/0   2w2d      never     40.40.1.1
224.0.0.13       POS0/4/0/0   2w2d      never     40.40.1.1
224.0.0.22       POS0/4/0/0   2w2d      never     40.40.1.1

Related Commands

Command
Description

show igmp groups

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


clear igmp reset

To clear all IGMP membership entries and reset connection in the Multicast Routing Information Base (MRIB), use the clear igmp reset command in EXEC mode.

clear igmp [ipv4] reset

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

Every IGMP group membership that IGMP learns is downloaded to the MRIB database.

This command is used to clear all information from the IGMP topology table and reset the MRIB connection.


Note This command is strictly reserved to force synchronization of IGMP and MRIB entries when communication between the two components is malfunctioning.


Task ID

Task ID
Operations

multicast

execute


Examples

The following example clears the group memberships in MRIB:

RP/0/RP0/CPU0:router# clear igmp reset

Related Commands

Command
Description

show igmp groups

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

show mfib route

Displays all entries in the MRIB table.


clear mld counters

To clear MLD traffic statistics, use the clear mld counters command in EXEC mode.

clear mld [ipv6] counters

Syntax Description

ipv6

(Optional) Specifies IPv6 addressing. IPv6 is the default for MLD groups.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

After MLD statistics are cleared, statistics begin incrementing once again.

Task ID

Task ID
Operations

multicast

execute


Examples

The following example shows how to clear MLD traffic statistics:

RP/0/RP0/CPU0:router# clear mld counters 

Note See the clear igmp counters command examples for complete output.


Related Commands

Command
Description

show mld traffic

Displays all MLD traffic-related counters.


clear mld group

To clear MLD groups on one or all interfaces, use the clear mld group command in EXEC mode.

clear mld [ipv6] group [type instance]

Syntax Description

ipv6

(Optional) Specifies IPv6 addressing. IPv6 is the default for MLD groups.

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

If no group address is specified, all MLD groups are cleared.

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to clear user-specified or all MLD membership learned from external hosts. Use the type and number arguments to clear specific MLD membership, or if no interface arguments are specified, clear MLD membership from all interfaces. This command does not clear local static group members.

Task ID

Task ID
Operations

multicast

execute


Examples

The following example shows how to clear MLD groups for Packet-over-SONET/SDH (POS) interface 0/4/0/0:

RP/0/RP0/CPU0:router# clear mld group pos 0/4/0/0

Note See the clear igmp group command examples for complete output.


Related Commands

Command
Description

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.


clear mld reset

To clear all MLD membership entries and reset connection in the Multicast Routing Information Base (MRIB), use the clear mld reset command in EXEC mode.

clear igmp [ipv6] reset

Syntax Description

ipv6

(Optional) Specifies IPv6 addressing. IPv6 is the default for MLD groups.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

Every MLD group membership that MLD learns is downloaded to the MRIB database.

This command is used to clear all information from the MLD topology table and reset the MRIB connection.


Note This command is strictly reserved to force synchronization of MLD and MRIB entries when communication between the two components is malfunctioning.


Task ID

Task ID
Operations

multicast

execute


Examples

The following example clears the group memberships in MRIB:

RP/0/RP0/CPU0:router# clear mld reset

Related Commands

Command
Description

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.

show mfib route

Displays all entries in the MRIB table.


explicit-tracking

To configure IGMP Version 3 (under IPv4) and MLD Version 2 (under IPv6) explicit host tracking, use the explicit-tracking command in the appropriate configuration mode. To disable explicit host tracking, use the no form of this command.

explicit-tracking [access-list] [disable]

no explicit-tracking

Syntax Description

access-list

(Optional) Access list that specifies the group range for host tracking.

disable

(Optional) Disables explicit host tracking on a specific interface. This option is available only in interface configuration mode.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the explicit tracking parameter specified in router IGMP/MLD configuration mode.
If this command is not specified in router IGMP/MLD configuration mode, then explicit host tracking is disabled.

Command Modes

Router IGMP configuration (IPv4)

Router IGMP interface configuration (IPv4)

Router MLD configuration (IPv6)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

The enable keyword was removed. The disable keyword was removed from IGMP interface and MLD interface configuration modes.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.


Note As this command is applicable to IGMPv3 and MLDv2, all references in this section to IGMPv3 apply also to MLDv2.


By default, IGMP supports Version 3, unless a Version 2 or Version 1 IGMP host message is detected in the network. For backward compatibility, IGMP will downgrade to run at the IGMP version level that is installed.

This feature allows the router to achieve minimal leave latencies when hosts leave a multicast group or channel. To monitor IGMP membership of hosts, use the show igmp groups command in EXEC mode.

In router configuration mode, the explicit-tracking command enables explicit host tracking for all interfaces. To disable the feature on specific interfaces, use the explicit-tracking command in interface configuration mode with the disable keyword.


Note If you configure this command in router IGMP configuration mode or router MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from router IGMP interface configuration mode or router MLD interface configuration mode.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example enables explicit host tracking for the access list named router1 on all interfaces, and disables explicit host tracking for a specific POS interface.

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# explicit-tracking router1
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0
RP/0/RP0/CPU0:router(config-igmp-if)# explicit-tracking disable

Related Commands

Command
Description

show igmp groups

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

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.


interface all router disable (IGMP/MLD)

To disable IGMP/MLD membership tracking on all interfaces, use the interface all router disable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

interface all router disable

no interface all router disable

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled (on all enabled interfaces)

Command Modes

Router IGMP configuration (IPv4)

Router MLD configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

Task ID

Task ID
Operations

multicast

read, write


Examples

The following example disables IGMP membership tracking for all interfaces:

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# interface all router disable

join-group

To have the router join a multicast group, use the join-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

join-group group-address [include | exclude] source-address

no join-group group-address [include | exclude] source-address

Syntax Description

group-address

Address of the multicast group. This is a multicast IP address in either IPv4 or IPv6 format.

include

(Optional) Switches to include mode. If not specified, include is the default.

exclude

(Optional) Switches to exclude mode.

source-address

(Optional) Source address of the multicast group to include or exclude.


Defaults

No multicast group memberships are predefined.
If not specified, include is the default.

Command Modes

Router IGMP interface configuration (IPv4)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command permits the IP packets that are addressed to the group address to pass to the IP client process in the Cisco IOS XR software.

If all the multicast-capable routers that you administer are members of a multicast group, pinging that group causes all routers to respond. This command can be a useful administrative and debugging tool.

Another reason to have a router join a multicast group is when other hosts on the network are prevented from correctly answering IGMP/MLD queries. When the router joins the multicast group, upstream devices learn multicast routing table information for that group and keep the paths for that group active.


Caution Joining a multicast group can result in a significant performance impact, because all subscribed multicast packets are punted to the route processor.

Task ID

Task ID
Operations

multicast

read, write


Examples

In the following example, the router joins multicast group 225.2.2.2:

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0
RP/0/RP0/CPU0:router(config-igmp-if)# join-group 225.2.2.2

Related Commands

Command
Description

ping

Checks host reachability and network connectivity on IP networks.


maximum groups

To configure the maximum number of groups used by IGMP/MLD and accepted by a router, use the maximum groups command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

maximum groups number

no maximum groups

Syntax Description

number

Maximum number of groups accepted by a router. Range is 1 to 75000.


Defaults

number: 50000

Command Modes

Router IGMP configuration (IPv4)

Router MLD configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

The maximum combined number of groups on all interfaces can be 75,000. Once the maximum groups value is met, all additional membership learned are ignored. The maximum number includes external and local membership.

The following groups obtain local membership on each interface when multicast is enabled and are added into the group totals per interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for IGMP).

You cannot use this command to configure the maximum number of groups below the number of existing groups. For instance, if the number of groups is 39, and you set the maximum number of groups to 10, the configuration is rejected.

Furthermore, you can use the maximum groups per-interface command to configure the maximum number of groups per interface accepted by a router.

Task ID

Task ID
Operations

multicast

read, write


Examples

The following example displays the number of groups (39) and the maximum number of groups configured (50,000). Through use of the maximum groups command, a configuration is committed to change the maximum number of groups to 40. Before and after configuration, the show igmp summary command is used to confirm the configuration change:

RP/0/RP0/CPU0:router# show igmp summary 
[IGMP summary
Number of groups 39
Maximum number of groups 50000
Interface                 Grp No    Max Grp No
Loopback0                 11        25000 
Loopback1                 10        25000 
Loopback2                 9         25000 
Loopback3                 9         25000 
POS0/3/0/0                0         25000
RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# maximum groups 10
RP/0/RP0/CPU0:router(config-igmp)# commit
RP/0/RP0/CPU0:May 13 12:25:49.717 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration 
committed by user 'cisco'.   Use 'show commit changes 1000000024' to view the changes. 
% Failed to commit one or more configuration items. Please use 'show configuration failed' 
to view the errors
RP/0/RP0/CPU0:router# show configuration failed
[!! CONFIGURATION FAILED DUE TO SEMANTIC ERRORS
router igmp
maximum groups 10
!!% Invalid argument: The desired new maximum for the number of groups 10 must be equal or 
larger than the present number of groups, which is 39
RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# maximum groups 40
RP/0/RP0/CPU0:router(config-igmp)# commit
RP/0/RP0/CPU0:May 13 12:26:59.108 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration 
committed by user 'cisco'.   Use 'show commit changes 1000000025' to view the changes. 
RP/0/RP0/CPU0:router# show igmp summary 
Number of groups 39
Maximum number of groups 40
Interface                 Grp No    Max Grp No
Loopback0                 11        25000 
Loopback1                 10        25000 
Loopback2                 9         25000 
Loopback3                 9         25000 
POS0/3/0/0                0         25000

Related Commands

Command
Description

maximum groups per-interface

Configures the maximum number of groups per interface accepted by a router.

show igmp summary

Displays group membership information for IGMP.

show mld summary

Displays group membership information for MLD.


maximum groups per-interface

To configure the maximum number of groups per interface accepted by a router, use the maximum groups per-interface command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

maximum groups per-interface number

no maximum groups per-interface

Syntax Description

number

Maximum number of groups accepted by a router per interface. Range is 1 to 40000.


Defaults

number: 20000

Command Modes

Router IGMP configuration (IPv4)

Router IGMP interface configuration (IPv4)

Router MLD configuration (IPv6)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

The following groups obtain local membership on each interface when multicast is enabled and are added into the group totals per interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for IGMP). The number of groups per interface reflects both external and local group membership.

You cannot use this command to configure the maximum number of groups per interface below the number of existing groups on an interface. For instance, if the number of groups is 39, and you set the maximum number of groups to 10, the configuration is rejected.

When you use this command for a specific interface, it overrides the inheritance property of this command specified under router IGMP/MLD configuration mode.

Task ID

Task ID
Operations

multicast

read, write


Examples

The following example displays the maximum number of groups per interface (25,000). A configuration is committed to change the maximum number of groups per interface to 12. Before and after configuration, use the show igmp summary command to confirm the configuration change:

RP/0/RP0/CPU0:router# show igmp summary 
[IGMP summary
Number of groups 39
Maximum number of groups 50000
Interface                 Grp No    Max Grp No
Loopback0                 11        25000 
Loopback1                 10        25000 
Loopback2                 9         25000 
Loopback3                 9         25000 
POS0/3/0/0                0         25000
RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# maximum groups per-interface 5
RP/0/RP0/CPU0:router(config-igmp)# commit
RP/0/RP0/CPU0:May 13 12:25:49.717 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration 
committed by user 'User1'.   Use 'show commit changes 1000000024' to view the changes. 
% Failed to commit one or more configuration items. Please use 'show configuration failed' 
to view the errors
RP/0/RP0/CPU0:router# show configuration failed
[!! CONFIGURATION FAILED DUE TO SEMANTIC ERRORS
router igmp
 maximum groups-per-interface 5
!!% Invalid argument: The desired new maximum for the number of groups-per-interface 5 
must be equal or larger than the present number of groups-per-interface in each interface.  
Please do 'show igmp summary' to find out
RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# maximum groups per-interface 12
RP/0/RP0/CPU0:router(config-igmp)# commit
RP/0/RP0/CPU0:May 13 12:26:59.108 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration 
committed by user 'User1'.   Use 'show commit changes 1000000025' to view the changes. 
RP/0/RP0/CPU0:router# show igmp summary 
Number of groups 39
Maximum number of groups 40
Interface                 Grp No    Max Grp No
Loopback0                 11        12 
Loopback1                 10        12 
Loopback2                 9         12 
Loopback3                 9         12 
POS0/3/0/0                0         12

The following example configures all interfaces with 3000 maximum groups per interface except Packet-over-SONET/SDH (POS) interface 0/4/0/0, which is set to 4000:

RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# maximum groups per-interface 3000
RP/0/RP0/CPU0:router(config-igmp)# interface POS 0/4/0/0
RP/0/RP0/CPU0:router(config-igmp-if)# maximum groups per-interface 4000

Related Commands

Command
Description

maximum groups

Configures the maximum number of groups accepted by a router.

show igmp summary

Displays group membership information for IGMP.

show mld summary

Displays group membership information for MLD.


nsf lifetime (IGMP/MLD)

To configure the maximum time for the nonstop forwarding (NSF) timeout on the IGMP/MLD process, use the nsf lifetime command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

nsf lifetime seconds

no nsf lifetime

Syntax Description

seconds

Maximum time for NSF mode. Range is 10 to 3600 seconds.


Defaults

seconds: 60

Command Modes

Router IGMP configuration (IPv4)

Router MLD configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

The IGMP NSF process is triggered by the restart of the IGMP process. While in IGMP NSF mode, the Multicast Routing Information Base (MRIB) purges the routes installed by the previous IGMP process when the IGMP NSF process times out.

The IGMP NSF lifetime is the period for IGMP to relearn all the host membership of the attached network through membership queries and reports. During this NSF period, PIM will continue to maintain forwarding state for the local members while IGMP recovers their membership reports.

Additionally, IGMP recovers the internal receiver state from Local Packet Transport Services (LPTS) for IP group member applications (including the Auto-RP and the Session Announcement Protocol (SAP) Listener) and updates the MRIB.


Note The NSF process for MLD under IPv6 is as described (above) for IGMP under IPv4.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example sets the IGMP NSF timeout value to 120 seconds:

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# nsf lifetime 120 

Related Commands

Command
Description

nsf

Enables NSF capability for the multicast routing system.

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show igmp nsf

Displays the state of NSF operation in IGMP.

show mld nsf

Displays the state of NSF operation in MLD.

show mfib nsf

Displays the state of NSF operation for the MFIB line cards.


query-interval

To configure the frequency at which the Cisco IOS XR software sends IGMP/MLD host-query messages, use the query-interval command in the appropriate configuration mode. To return to the default frequency, use the no form of this command.

query-interval seconds

no query-interval

Syntax Description

seconds

Frequency used to send IGMP host-query messages. Range is 1 to 3600.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the query interval parameter specified in router IGMP/MLD configuration mode.
If this command is not specified in router IGMP/MLD configuration mode, the query interval time is 60 seconds.

Command Modes

Router IGMP configuration (IPv4)

Router IGMP interface configuration (IPv4)

Router MLD configuration (IPv6)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

Multicast routers send host membership query messages (host-query messages) to discover which multicast groups have members on the attached networks of the router. Hosts respond with IGMP/MLD report messages indicating that they want to receive multicast packets for specific groups (that is, that the host wants to become a member of the group). Host-query messages are addressed to the all-hosts multicast group, which has the address 224.0.0.1, and has an IP time-to-live (TTL) value of 1.

The designated router for a LAN is the only router that sends IGMP/MLD host-query messages:

For IGMP Version 1 (only), the designated router is elected according to the multicast routing protocol that runs on the LAN.

For IGMP Versions 2 and 3 and MLD Versions 1 and 2, the designated querier is the lowest IP-addressed multicast router on the subnet.

If the router hears no queries for the timeout period (controlled by the query-timeout command), it becomes the querier.


Note Changing the value of the seconds argument may severely impact network performance. A short query interval may increase the amount of traffic on the attached network and a long query interval may reduce the querier convergence time.



Note If you configure this command in router IGMP/MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from interface configuration mode.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example shows how to change the frequency at which the designated router sends IGMP host-query messages to 2 minutes:

RP/0/RP0/CPU0:router(config)# router igmp 
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0 
RP/0/RP0/CPU0:router(config-igmp-if)# query-interval 120

Related Commands

Command
Description

hello-interval (PIM)

Configures the frequency of PIM hello messages.

query-timeout

Configures the timeout value before the router takes over as the querier for the interface.

show igmp groups

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

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.


query-max-response-time

To configure the maximum response time advertised in IGMP/MLD queries, use the query-max-response-time command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

query-max-response-time seconds

no query-max-response-time

Syntax Description

seconds

Maximum response time, in seconds, advertised in IGMP/MLD queries. Range is 1 to 12.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the maximum response time parameter specified in router IGMP/MLD configuration mode.
If this command is not specified in router IGMP/MLD configuration mode, the maximum response time is 10 seconds.

Command Modes

Router IGMP configuration (IPv4)

Router IGMP interface configuration (IPv4)

Router MLD configuration (IPv6)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is not supported on IGMP Version 1.

This command is used to control the maximum response time for hosts to answer an IGMP/MLD query message. Configuring a value less than 10 seconds enables the router to prune groups much faster but this action results in network burstiness as hosts are restricted to a shorter response time period.

If you configure this command in router IGMP/MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces in interface configuration mode.


Note If the hosts do not read the maximum response time in the query message correctly, group membership might be pruned inadvertently. Therefore, the hosts must know to respond faster than 10 seconds (or the value you configure).


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example configures a maximum response time of 8 seconds:

RP/0/RP0/CPU0:router(config)# router igmp 
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0 
RP/0/RP0/CPU0:router(config-igmp-if)# query-max-response-time 8

Related Commands

Command
Description

hello-interval (PIM)

Configures the frequency of PIM hello messages.

show igmp groups

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

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.


query-timeout

To configure the timeout value before the router takes over as the querier for the interface, use the query-timeout command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

query-timeout seconds

no query-timeout

Syntax Description

seconds

Number of seconds that the router waits after the previous querier has stopped querying before it takes over as the querier. Range is 60 to 300.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the timeout value parameter specified in router IGMP configuration mode. If this command is not specified in router IGMP configuration mode, the maximum response time is equal to twice the query interval set by the query-interval command.

Command Modes

Router IGMP configuration (IPv4)

Router IGMP interface configuration (IPv4)

Router MLD configuration (IPv6)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is not supported on IGMP Version 1.

By default, the router waits twice the query interval specified by the query-interval command, after which, if the router has heard no queries, it becomes the querier. By default, the query interval is 60 seconds, which means that the query timeout value defaults to 120 seconds.


Note If you configure a query timeout value less than twice the query interval, routers in the network may determine a query timeout and take over the querier without good reason.



Note If you configure this command in router IGMP/MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces in interface configuration mode.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example configures the router to wait 30 seconds from the time it received the last query before it takes over as the querier for the interface:

RP/0/RP0/CPU0:router(config)# router igmp 
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0 
RP/0/RP0/CPU0:router(config-igmp-if)# query-timeout 30

Related Commands

Command
Description

query-interval

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


router

To disable or enable IGMP/MLD membership tracking, use the router command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

router {disable | enable}

no router {disable | enable}

Syntax Description

disable

Turns off IGMP/MLD membership tracking.

enable

Turns on IGMP/MLD membership tracking.


Defaults

If this command is not specified in router IGMP configuration mode, router functionality is enabled on all interfaces.

Command Modes

Router IGMP interface configuration (IPv4)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to enable and disable the IGMP/MLD router functionality on a specific interface. For instance, IGMP/MLD will stop queries from an interface when the router functionality is disabled on that interface. Disabling IGMP/MLD router functionality does not prevent local group membership to be announced through the group membership report.

Router functionality can be inherited through the interface all router disable command in router IGMP/MLD configuration mode, but can be overridden using the router command in interface configuration mode.


Note This command is useful if you want to disable or enable interfaces that have been previously enabled through the multicast-routing command.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example disables IGMP router functionality on all multicast enabled interfaces, except Packet-over-SONET/SDH (POS) interface 0/1/0/0:

RP/0/RP0/CPU0:router(config)# router igmp 
RP/0/RP0/CPU0:router(config-igmp)# interface all router disable
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0 
RP/0/RP0/CPU0:router(config-igmp-if)# router enable

Related Commands

Command
Description

interface all router disable (IGMP/MLD)

Disables IGMP/MLD membership tracking on all interfaces.

multicast-routing

Enables multicast routing and forwarding on all enabled interfaces of the router and enters multicast routing configuration mode.


router igmp

To enter IGMP configuration mode, use the router igmp command in global configuration mode. To return to the default behavior, use the no form of this command.

router igmp

no router igmp

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

From router IGMP configuration mode, you can configure the maximum response time advertised in IGMP queries and modify the host query interval.


Note The IGMP process is turned on when the router igmp command or the multicast-routing command is initiated.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example enters router IGMP configuration mode and configures the frequency at which the Cisco IOS XR software sends IGMP host-query messages:

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# query-interval 160

Related Commands

Command
Description

multicast-routing

Enables multicast routing and forwarding on all enabled interfaces of the router and enters multicast routing configuration mode.


router mld

To enter router MLD configuration mode, use the router mld command in global configuration mode. To return to the default behavior, use the no form of this command.

router mld

no router mld

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

From router MLD configuration mode, you can configure the maximum response time advertised in MLD queries and modify the host query interval.


Note The MLD process is turned on when the router mld command or the multicast-routing command is initiated.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example enters router MLD configuration mode and configures the frequency at which the Cisco IOS XR software sends MLD host-query messages:

RP/0/RP0/CPU0:router(config)# router mld
RP/0/RP0/CPU0:router(config-mld)# query-interval 160

Related Commands

Command
Description

multicast-routing

Enables multicast routing and forwarding on all enabled interfaces of the router and enters multicast routing configuration mode.


show igmp groups

To display the multicast groups that are directly connected to the router and that were learned through IGMP, use the show igmp groups command in EXEC mode.

show igmp [old-output] groups [group-address | type instance | detail | explicit | not-active | summary]

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

group-address

(Optional) Address or name of the multicast group. An address is a multicast IP address in four-part dotted-decimal notation. A name is as defined in the Domain Name System (DNS) hosts table

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

explicit

(Optional) Displays explicit tracking information.

detail

(Optional) Displays detail information such as IGMP Version 3 source list, host, and router mode.

not-active

(Optional) Displays group joins that are not processed.

summary

(Optional) Displays the total number of (* , G) and (S, G) states in IGMP.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

If you omit all optional arguments, the show igmp groups command displays (by group address and interface name) all the multicast memberships that the directly connected networks have subscribed.

Task ID

Task ID
Operations

multicast

read


Examples

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

RP/0/RP0/CPU0:router# show igmp groups
IGMP Connected Group Membership
Group Address    Interface       Uptime    Expires   Last Reporter
224.0.255.1      POS0/2/1/0       18:51:41  0:02:15   172.20.37.192
224.2.226.60     POS0/2/1/0       1:51:31   0:02:17   172.20.37.192
224.2.127.255    POS0/2/1/0       18:51:45  0:02:17   172.20.37.192
226.2.2.2        POS0/2/1/1       18:51:47  never     0.0.0.0
224.2.0.1        POS0/2/1/0       18:51:43  0:02:14   172.20.37.192
225.2.2.2        POS0/2/1/0       18:51:43  0:02:21   172.20.37.33
225.2.2.2        POS0/2/1/1       18:51:47  never     0.0.0.0
225.2.2.4        POS0/2/1/0       18:18:02  0:02:20   172.20.37.192
225.2.2.4        POS0/2/1/1       18:23:32  0:02:55   172.20.36.128

Table 2 describes the significant fields shown in the display.

Table 2 show igmp groups Field Descriptions 

Field
Description

Group Address

Address of the multicast group.

Interface

Interface through which the group is reachable.

Uptime

How long (in hours, minutes, and seconds) this multicast group has been known.

Expires

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

Last Reporter

Last host to report being a member of the multicast group.


Related Commands

Command
Description

show igmp interface

Displays IGMP multicast-related information about an interface.


show igmp interface

To display IGMP multicast-related information about an interface, use the show igmp interface command in EXEC mode.

show igmp [old-output] interface [type instance | state-on | state-off]

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

state-on

(Optional) Displays all interfaces with IGMP enabled.

state-off

(Optional) Displays all interfaces with IGMP disabled.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

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

Task ID

Task ID
Operations

multicast

read


Examples

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

RP/0/RP0/CPU0:router# show igmp interface
MgmtEth0/0/CPU0/0 is up, line protocol is up 
  Internet address is 239.1.1.1/16 
  IGMP is disabled on interface 
MgmtEth0/1/CPU0/0 is up, line protocol is up 
  Internet address is 239.1.1.1/16 
  IGMP is disabled on interface 
POS0/4/0/0 is up, line protocol is up 
  Internet address is 239.1.1.1/24 
  IGMP is enabled on interface 
  Current IGMP version is 3 
  IGMP query interval is 60 seconds 
  IGMP querier timeout is 125 seconds 
  IGMP max query response time is 10 seconds 
  Last member query response interval is 1 seconds 
  IGMP activity: 8 joins, 4 leaves 
  IGMP querying router is 142.50.12.1 (this system) 
POS0/4/0/1 is up, line protocol is up 
  Internet address is 239.2.1.1/24 
  IGMP is enabled on interface 
  Current IGMP version is 3 
  IGMP query interval is 60 seconds 
  IGMP querier timeout is 125 seconds 
  IGMP max query response time is 10 seconds 
  Last member query response interval is 1 seconds 
  IGMP activity: 6 joins, 3 leaves 
  IGMP querying router is 239.3.1.1 (this system) 
POS0/4/0/2 is up, line protocol is up 
  Internet address is 239.1.1.1/24 
  IGMP is enabled on interface 
  Current IGMP version is 3 
  IGMP query interval is 60 seconds 
  IGMP querier timeout is 125 seconds 
  IGMP max query response time is 10 seconds 
  Last member query response interval is 1 seconds 
  IGMP activity: 6 joins, 3 leaves 
  IGMP querying router is 239.4.1.1 (this system) 
POS0/4/0/3 is up, line protocol is up 
  Internet address is 239.1.1.1/24 
  IGMP is enabled on interface 
  Current IGMP version is 3 
  IGMP query interval is 60 seconds 
  IGMP querier timeout is 125 seconds 
  IGMP max query response time is 10 seconds 
  Last member query response interval is 1 seconds 
  IGMP activity: 6 joins, 3 leaves 
  IGMP querying router is 239.5.1.1 (this system)

Table 3 describes the significant fields shown in the display.

Table 3 show igmp interface Field Descriptions 

Field
Description

MgmtEth0/0/CPU0/0 is up, line protocol is up

Interface type, number, and status.

Internet address is...

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

IGMP is disabled on interface

Indicates whether IGMP router functionality has been enabled on the interface.

Note Multicast protocols will not run on management ethernet interfaces even if they are enabled with the CLI.

IGMP query interval is 60 seconds

Interval at which the Cisco IOS XR software sends PIM query messages, as specified with the query-interval command.

IGMP querier timeout is...

Timeout that is set by non-querier routers. When this timeout expires, the non-querier routers begin to send queries.

IGMP max query response time is...

Query response time, in seconds, that is used by administrators to tune the burstiness of IGMP messages on the network. This is the maximum time within which a response to the query is received.

Last member query response is...

Query response time in seconds since a host replied to a query that was sent by the querier.

IGMP activity:

Total number of joins and total number of leaves received.

IGMP querying router is 239.122.41.51 (this system)

Indicates the elected querier on the link.


Related Commands

Command
Description

address

Sets a primary or secondary IP address for an interface.

query-interval

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

router

Disables or enables IGMP membership tracking.


show igmp nsf

To display the state of NSF operation in IGMP, use the show igmp nsf command in EXEC mode.

show igmp [old-output] nsf

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command displays the current multicast NSF state for IGMP. The NSF state that is displayed may be either normal or activated for NSF. The latter state indicates that recovery is in progress due to an IGMP failure. The total NSF timeout and time remaining are displayed until NSF expiration.

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show igmp nsf command:

RP/0/RP0/CPU0:router# show igmp nsf 
IP IGMP Non-Stop Forwarding Status:
Multicast routing state: Non-Stop Forwarding Activated
NSF Lifetime: 00:01:00
NSF Time Remaining: 00:00:06

Table 4 describes the significant fields shown in the display.

Table 4 show igmp nsf Field Descriptions 

Field
Description

Multicast routing state

Multicast NSF status of IGMP (Normal or Non-Stop Forwarding Activated).

NSF Lifetime

Timeout for IGMP NSF. IGMP remains in NSF state, recovering IGMP route state via IGMP reports for this period of time before making the transition back to Normal state and signalling MRIB.

NSF Time Remaining

If IGMP NSF state is activated, the time remaining until IGMP reverts to Normal mode displays.


Related Commands

Command
Description

nsf

Turns on NSF capability for the multicast routing system.

nsf lifetime (IGMP/MLD)

Configures the maximum time for the NSF timeout value on the IGMP.

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show mfib nsf

Displays the state of NSF operation for the MFIB line cards.

show mrib nsf

Displays the state of NSF operation in the MRIB.

show pim nsf

Displays the state of NSF operation for PIM.


show igmp summary

To display group membership information for IGMP, use the show igmp summary command in EXEC mode.

show igmp [old-output] summary

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to display the total group membership. The value for number of groups is the total number of group members on all interfaces. The value for maximum number of groups is the total number of external and local members possible for all interfaces. The maximum number of groups and the default value for the maximum number of groups is 50,000 members. The maximum number of groups per interface and the default value for the maximum number of groups per interface is 25,000 members.

Task ID

Task ID
Operations

multicast

read


Examples

The following example shows the number of groups per interface that are IGMP members and the maximum number of groups that can become members on each interface:

RP/0/RP0/CPU0:router# show igmp summary
Number of groups 39
Maximum number of groups 50000
Interface                 Grp No    Max Grp No
Loopback0                 11        25000 
Loopback1                 10        25000 
Loopback2                 9         25000 
Loopback3                 9         25000 

Table 5 describes the significant fields shown in the display.

Table 5 show igmp summary Field Descriptions 

Field
Description

Interface

Interfaces through which the multicast groups are reachable.

Grp No

Number of multicast groups that are joined through the interface.

Max Grp No

Maximum number of multicast groups that can be joined through the interface.


Related Commands

Command
Description

show igmp groups

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


show igmp traffic

To display all the IGMP traffic-related counters, use the show igmp traffic command in EXEC mode.

show igmp [old-output] traffic

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to display the state of all counters for IGMP traffic. It gives information about the length of time the counters have been active, and the count of different types of IGMP packets received, such as queries, leaves, and reports. Also, this command keeps a count of all the erroneous IGMP packets received.

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show igmp traffic command:

RP/0/RP0/CPU0:router# show igmp traffic 
IGMP Traffic Counters
Elapsed time since counters cleared: 15:27:38
                                  Received        Sent
Valid IGMP Packet                     2784        5576
Queries                               0           2784
Reports                               2784        2792
Leaves                                0           0
Mtrace packets                        0           0
DVMRP packets                         0           0
PIM packets                           0           0
Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0

Table 6 describes the significant fields shown in the display.

Table 6 show igmp traffic Field Descriptions 

Field
Description

Valid IGMP Packet

Total number of valid IGMP packets sent and received. Valid packets include IGMP queries, IGMP reports, and IGMP leave packets.

Queries

Total number of IGMP queries sent and received. IP multicast routers send membership queries to determine the multicast reception state of neighboring interfaces.

Reports

Total number of IGMP reports sent and received. IGMP reports indicate the neighboring router's current multicast reception state or changes in the multicast reception state of its interfaces.

Leaves

Total number of IGMP leaves sent and received. A hosts sends leaves (leave messages) to multicast routers indicating that it has left a group and will not receive packets destined for that group.

Mtrace packets

Total number of Mtrace packets sent and received. Mtrace traces the route from a receiver to a source using a particular multicast address.

DVMRP packets

Total number of DVMRP packets sent and received. Multicast Routing Protocol (DVMRP) is an Internet routing protocol that provides a mechanism for connectionless datagram delivery to a group of hosts across an internetwork. This protocol dynamically generates IP multicast delivery trees using Reverse Path Multicasting. Packet type 0x13 indicates a DVMRP packet.

PIM packets

Total number of sent and received PIM packets.

Malformed Packets

Total number of malformed packets. Malformed packets are packets smaller than a valid IGMP packet.

Bad Checksums

Total number of packets with bad checksums. Bad checksum packets are packets larger than a valid IGMP packet.

Socket Errors

Total number of socket errors. Socket errors refer to read/write failures during IGMP transmission.

Auxiliary Data Len Errors

Total number of packets received with a non-zero auxilary data length.

Subnet Errors

Total number of packets received that were not sourced on the same subnet as the router. DVMRP and MTRACE packets received are not checked for this error as they may be validly sourced from a different subnet.

Packets dropped due to invalid socket

Total number of packets dropped due to invalid socket.

Packets which couldn't be accessed

Total number of packets that could not be sent or received.

This might occur if

the packet buffer does not form an IGMP packet

the IP header is not written to the packet

the outgoing packet interface handle was not set

there are errors calculating the packet checksum

Other Packet Drops

Packets dropped for any other reason.


Related Commands

Command
Description

show pim traffic

Displays PIM traffic counter information.


show mld groups

To display the multicast groups that are directly connected to the router and that were learned through MLD, use the show mld groups command in EXEC mode.

show mld [old-output] groups [group-address | type instance | explicit | detail | not-active | summary]

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

group-address

(Optional) Name or address of the multicast group. Name is as defined in the Domain Name System (DNS) hosts table. Address is a multicast IP address in IPv6 format.

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

explicit

(Optional) Displays explicit tracking information.

detail

(Optional) Displays detail information such as MLD Version 3 source list, host, and router mode.

not-active

(Optional) Displays group joins that are not processed.

summary

(Optional) Displays the total number of (* , G) and (S, G) states in MLD.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

If you omit all optional arguments, the show mld groups command displays (by group address and interface name) all the multicast memberships that the directly connected networks have subscribed.

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show mld groups command:

RP/0/RP0/CPU0:router# show mld groups
MLD Connected Group Membership
POS0/2/0/0
Group Address : ff02::2
Last Reporter : fe80::b000:ff:fe00:fb00
       Uptime : 01:56:39
      Expires : never
Group Address : ff02::d
Last Reporter : fe80::b000:ff:fe00:fb00
       Uptime : 01:56:39
      Expires : never
Group Address : ff02::16
Last Reporter : fe80::b000:ff:fe00:fb00
       Uptime : 01:56:39
      Expires : never

Table 2 describes the significant fields shown in the display.

Related Commands

Command
Description

show mld interface

Displays MLD multicast-related information about an interface.


show mld interface

To display MLD multicast-related information about an interface, use the show mld interface command in EXEC mode.

show mld [old-output] interface [type instance | state-on | state-off]

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

type

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

instance

Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

state-on

(Optional) Displays all interfaces with IGMP enabled.

state-off

(Optional) Displays all interfaces with IGMP disabled.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

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

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show mld interface command:

RP/0/RP0/CPU0:router# show mld interface
Loopback0 is up, line protocol is up
  Internet address is fe80::5000:ff:fe00:5c00
  MLD is enabled on interface
  Current MLD version is 2
  MLD query interval is 125 seconds
  MLD querier timeout is 255 seconds
  MLD max query response time is 10 seconds
  Last member query response interval is 1 seconds
  MLD activity: 3 joins, 0 leaves
  MLD querying router is fe80::5000:ff:fe00:5c00 (this system)
TenGigE0/5/0/2 is up, line protocol is up
  Internet address is fe80::215:c6ff:fe3e:8c85
  MLD is enabled on interface
  Current MLD version is 2
  MLD query interval is 125 seconds
  MLD querier timeout is 255 seconds
  MLD max query response time is 10 seconds
  Last member query response interval is 1 seconds
  MLD activity: 5 joins, 0 leaves
  MLD querying router is fe80::215:c6ff:fe3e:8c85 (this system)
TenGigE0/5/0/3 is up, line protocol is up
  Internet address is fe80::215:c6ff:fe3e:8c86
  MLD is enabled on interface
  Current MLD version is 2
  MLD query interval is 125 seconds
  MLD querier timeout is 255 seconds
  MLD max query response time is 10 seconds
  Last member query response interval is 1 seconds
  MLD activity: 5 joins, 0 leaves
  MLD querying router is fe80::215:c6ff:fe3e:8c86 (this system)
TenGigE0/5/0/3.4 is up, line protocol is up
  Internet address is fe80::215:c6ff:fe3e:8c86
  MLD is enabled on interface
  Current MLD version is 2
  MLD query interval is 125 seconds
  MLD querier timeout is 255 seconds
  MLD max query response time is 10 seconds
  Last member query response interval is 1 seconds
  MLD activity: 3 joins, 0 leaves
  MLD querying router is fe80::215:c6ff:fe3e:8c86 (this system)
TenGigE0/5/0/3.5 is up, line protocol is up
  Internet address is fe80::215:c6ff:fe3e:8c86
  MLD is enabled on interface
  Current MLD version is 2
  MLD query interval is 125 seconds
  MLD querier timeout is 255 seconds
  MLD max query response time is 10 seconds
  Last member query response interval is 1 seconds
  MLD activity: 3 joins, 0 leaves
  MLD querying router is fe80::215:c6ff:fe3e:8c86 (this system)

Table 3 describes the significant fields shown in the display.

Related Commands

Command
Description

address

Sets a primary or secondary IP address for an interface.

query-interval

Configures the frequency at which Cisco IOS XR software sends MLD host-query messages.

router

Disables or enables MLD membership tracking.


show mld nsf

To display the state of NSF operation in MLD, use the show mld nsf command in EXEC mode.

show mld [old-output] nsf

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command displays the current multicast NSF state for MLD. The NSF state that is displayed may be either normal or activated for NSF. The latter state indicates that recovery is in progress due to an MLD failure. The total NSF timeout and time remaining are displayed until NSF expiration.

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show mld nsf command:

RP/0/RP0/CPU0:router# show mld nsf 
IP MLD Non-Stop Forwarding Status:
Multicast routing state: Non-Stop Forwarding Activated
NSF Lifetime: 00:01:00
NSF Time Remaining: 00:00:06

Table 4 describes the significant fields shown in the display.

Related Commands

Command
Description

nsf

Turns on NSF capability for the multicast routing system.

nsf lifetime (IGMP/MLD)

Configures the maximum time for the NSF timeout value on the IGMP/MLD.

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show mfib nsf

Displays the state of NSF operation for the MFIB line cards.

show mrib nsf

Displays the state of NSF operation in the MRIB.

show pim nsf

Displays the state of NSF operation for PIM.


show mld summary

To display group membership information for MLD, use the show mld summary command in EXEC mode.

show mld [old-output] summary

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to display the total group membership. The value for number of groups is the total number of group members on all interfaces. The value for maximum number of groups is the total number of external and local members possible for all interfaces. The maximum number of groups and the default value for the maximum number of groups is 50,000 members. The maximum number of groups per interface and the default value for the maximum number of groups per interface is 25,000 members.

Task ID

Task ID
Operations

multicast

read


Examples

The following example shows the number of groups per interface that are MLD members and the maximum number of groups that can become members on each interface:

RP/0/RP0/CPU0:router# show mld summary
Number of groups 39
Maximum number of groups 50000
Interface                 Grp No    Max Grp No
Loopback0                 11        25000 
Loopback1                 10        25000 
Loopback2                 9         25000 
Loopback3                 9         25000 

Table 5 describes the significant fields shown in the display.

Related Commands

Command
Description

show mld groups

Displays the multicast groups that are directly connected to the router and that were learned through MLD.


show mld traffic

To display all the MLD traffic-related counters, use the show mld traffic command in EXEC mode.

show mld [old-output] traffic

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

Support was added for Multicast Listener Discovery (MLD) Protocol (Versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

This command is used to display the state of all counters for MLD traffic. It gives information about the length of time the counters have been active, and the count of different types of MLD packets received, such as queries, leaves, and reports. Also, this command keeps a count of all the erroneous MLD packets received.

Task ID

Task ID
Operations

multicast

read


Examples

The following is sample output from the show mld traffic command:

RP/0/RP0/CPU0:router# show mld traffic 
MLD Traffic Counters
Elapsed time since counters cleared: 15:27:38
                                  Received        Sent
Valid MLD Packet                      2784        5576
Queries                               0           2784
Reports                               2784        2792
Leaves                                0           0
Mtrace packets                        0           0
DVMRP packets                         0           0
PIM packets                           0           0
Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0

Table 6 describes the significant fields shown in the display.

Related Commands

Command
Description

show pim traffic

Displays PIM traffic counter information.


static-group

To configure the router to be a statically configured member of the specified group on the interface, or to statically forward for a multicast group onto the interface, use the static-group command in router IGMP configuration mode. To return to the default behavior, use the no form of this command.

static-group group-address [source-address | inc-mask mask count cnt]

no static-group group-address [source-address | inc-mask mask count cnt]

Syntax Description

group-address

Address of the multicast group. This is a multicast IP address in IPv4 or IPv6 notation according to the addressing mode.

inc-mask mask

(Optional) Mask for the increment range. This is an IP address expressed in either IPv4 or IPv6 format. This mask is used with the group address to generate subsequent group addresses.

count cnt

Number of group addresses to generate using the increment mask.

source address

Source address of the multicast group to include.


Defaults

A router is not a statically connected member of an IP multicast group.

Command Modes

Router IGMP interface configuration (IPv4)

Router MLD interface configuration (IPv6)

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router and Cisco XR 12000 Series Router.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

When you configure the static-group command, packets to the group are switched out the interface, provided that packets were received on the correct reverse path forwarding (RPF) interface.

The static-group command differs from the join-group command. The join-group command allows the router to join the multicast group and draw traffic to an IP client process (that is, the route processor). If you configure both the join-group and static-group command for the same group address, the join-group command takes precedence and the group behaves like a locally joined group.


Note The static-group command has no impact on system performance.


Task ID

Task ID
Operations

multicast

read, write


Examples

In the following example, the router statically joins two multicast groups 225.2.2.2 and 225.2.2.4 for the specific source 1.1.1.1 :

RP/0/RP0/CPU0:router(config)# router igmp
RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0

RP/0/RP0/CPU0:router(config-igmp-if)# static-group 225.2.2.2 inc-mask 0.0.0.2 count 2 1.1.1.1

version

To configure an IGMP/MLD version for the router, use the version command in the appropriate configuration mode. To restore the default value, use the no form of this command.

version {1 | 2 | 3}

no version

Syntax Description

1

IGMP Version 1. Available for IGMP and MLD.

2

IGMP Version 2. Available for IGMP and MLD.

3

IGMP Version 3. Available for IGMP only.


Defaults

If this command is not specified in interface configuration mode, the interface adopts the IGMP/MLD version parameter specified in router IGMP configuration mode.

If this command is not specified in router IGMP/MLD configuration mode, IGMP uses Version 3 and MLD uses Version 1.

Command Modes

Router IGMP configuration

Router MLD configuration

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1 router.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Support was added for Multicast Listener Discovery (MLD) Protocol (versions 1 and 2).

Release 3.3.0

No modification.

Release 3.4.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.

All routers on the subnet must be configured with the same version of IGMP/MLD. For example, a router running Cisco IOS XR software does not automatically detect Version 1 systems and switch to Version 1. Hosts can have any IGMP/MLD version and the router will correctly detect their presence and query them appropriately.

The query-max-response-time and query-timeout commands require IGMP Version 2 or 3 or MLD Version 1 or 2.


Note If you configure this command in router IGMP/MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from interface configuration mode.


Task ID

Task ID
Operations

multicast

read, write


Examples

The following example configures the router to use IGMP Version 3:

RP/0/RP0/CPU0:router(config)# router igmp 
RP/0/RP0/CPU0:router(config-igmp)# version 3

Related Commands

Command
Description

query-max-response-time

Configures the maximum response time advertised in IGMP/MLD queries.

query-timeout

Configures the timeout value before the router takes over as the querier for the interface.