Cisco IOS XR Commands by Software Package, Release 3.8.0

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 these protocols:

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

•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 complementary MLD version.

For detailed information about multicast routing concepts, configuration tasks, and examples, refer to Cisco IOS XR Software Multicast Configuration Guide.

access-group (IGMP/MLD)

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

Defaults

No default behavior or values

Command Modes

Router IGMP interface configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

If this command is not specified in interface configuration mode, the interface adopts the global access group specified in router Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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.

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-default-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 

RP/0/RP0/CPU0:router(config-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 vrf vrf-name | vrf vrf-name] counters

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

After IGMP statistics are cleared, statistics begin incrementing again.

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: 00:00:19

                                  Received        Sent

Valid IGMP Packets                       0          12

Queries                                  0           3

Reports                                  0           9

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

Bad Scope Errors                                     0

Auxiliary Data Len Errors													 0

Subnet Errors                                        0

Packets dropped due to invalid socket                0

Packets which couldn't be accessed                   0

Other packets drops                                  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

Bad Scope Errors                                     0

Auxiliary Data Len Errors                            0

Subnet Errors                                        0

Packets dropped due to invalid socket                0

Packets which couldn't be accessed                   0

Other packets drops                                  0

Related Commands

clear igmp group

To clear Internet Group Management Protocol (IGMP) groups on one or all interfaces, use the clear igmp group command in EXEC mode.

clear igmp [ipv4 vrf vrf-name | vrf vrf-name] group [ip-address | type path-id]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

To clear all IGMP groups, use the clear igmp group command without using an argument. To clear a particular group, use the ip-address or type path-id arguments.

The following groups cannot be cleared:

•224.0.0.2

•224.0.0.13

•224.0.0.22

•224.0.0.40

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

clear igmp reset

To clear all Internet Group Management Protocol (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 vrf vrf-name | vrf vrf-name] reset

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

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

Examples

The following example shows how to clear the group memberships in MRIB:

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

Related Commands

clear mld counters

To clear Multicast Listener Discovery (MLD) traffic statistics, use the clear mld counters command in EXEC mode.

clear mld [ipv6 vrf vrf-name | vrf vrf-name] counters

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

clear mld group

To clear Multicast Listener Discovery (MLD) groups on one or all interfaces, use the clear mld group command in EXEC mode.

clear mld [ipv6 vrf vrf-name | vrf vrf-name] group [type path-id]

Syntax Description

Defaults

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

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The clear mld group command is used to clear user-specified MLD membership 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.

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

clear mld reset

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

clear mld [ipv6 vrf vrf-name | vrf vrf-name] reset

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

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

Examples

The following example shows how to clear the group memberships in MRIB:

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

Related Commands

explicit-tracking

To configure Internet Group Management Protocol (IGMP) Version 3 (under IPv4) and Multicast Listener Discovery (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

Defaults

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

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Note Because 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 downgrades 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 VRF 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.

Examples

The following example shows how to enable explicit host tracking for the access list named router1 on all interfaces and how to disable 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-default-if)# explicit-tracking disable

Related Commands

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 [source-address]

no join-group group-address [source-address]

Syntax Description

Defaults

No multicast group memberships are predefined.

Command Modes

Router IGMP interface configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The join-group 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 or 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.

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-default-if)# join-group 225.2.2.2

Related Commands

maximum groups

To configure the maximum number of groups used by Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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

Defaults

number: 50000

Command Modes

Router IGMP configuration
Router IGMP VRF configuration
Router MLD configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

When configuring this command within router IGMP VRF configuration mode, you may either use the default (unspecified) VRF or a specific VRF by specifying its name.

The maximum combined number of groups on all interfaces can be 75000. After the maximum groups value is met, all additional memberships 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 for each interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for IGMP).

You cannot use the maximum groups 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 for each interface accepted by a router.

Examples

The following example shows how to display the number of groups (39) and the maximum number of groups configured (50000). 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

Robustness Value 2

No. of Group x Interfaces 61

Maximum number of Group x Interfaces 50000

Supported Interfaces   : 18

Unsupported Interfaces : 2

Enabled Interfaces     : 18

Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No

MgmtEth0/RP0/CPU0/0       0         25000 

Loopback0                 4         25000 

Bundle-POS24              3         25000 

Bundle-Ether28            3         25000 

Bundle-Ether28.1          3         25000 

Bundle-Ether28.2          3         25000 

Bundle-Ether28.3          3         25000 

MgmtEth0/RP1/CPU0/0       0         25000 

GigabitEthernet0/1/5/0    3         25000 

GigabitEthernet0/1/5/1    5         25000 

GigabitEthernet0/1/5/2    5         25000 

POS0/1/0/1                5         25000 

POS0/1/4/2                3         25000 

GigabitEthernet0/6/5/1    3         25000 

GigabitEthernet0/6/5/2    3         25000 

GigabitEthernet0/6/5/7    3         25000 

POS0/6/0/1                3         25000 

POS0/6/4/4                3         25000 

POS0/6/4/5                3         25000 

POS0/6/4/6                3         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

% Failed to commit one or more configuration items during an atomic operation, n

o changes have been made. 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 61

RP/0/RP0/CPU0:router# configure

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

RP/0/RP0/CPU0:router(config-igmp)# maximum groups 65

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 

Robustness Value 2

No. of Group x Interfaces 61

Maximum number of Group x Interfaces 65

Supported Interfaces   : 18

Unsupported Interfaces : 2

Enabled Interfaces     : 18

Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No

MgmtEth0/RP0/CPU0/0       0         25000 

Loopback0                 4         25000 

Bundle-POS24              3         25000 

Bundle-Ether28            3         25000 

Bundle-Ether28.1          3         25000 

Bundle-Ether28.2          3         25000 

Bundle-Ether28.3          3         25000 

MgmtEth0/RP1/CPU0/0       0         25000 

GigabitEthernet0/1/5/0    3         25000 

GigabitEthernet0/1/5/1    5         25000 

GigabitEthernet0/1/5/2    5         25000 

POS0/1/0/1                5         25000 

POS0/1/4/2                3         25000 

GigabitEthernet0/6/5/1    3         25000 

GigabitEthernet0/6/5/2    3         25000 

GigabitEthernet0/6/5/7    3         25000 

POS0/6/0/1                3         25000 

POS0/6/4/4                3         25000 

POS0/6/4/5                3         25000 

POS0/6/4/6                3         25000 

Related Commands

maximum groups-per-interface

To configure the maximum number of groups for each 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

Defaults

number: 20000

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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 for each interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for Internet Group Management Protocol [IGMP]). The number of groups for each interface reflects both external and local group membership.

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

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

Examples

The following example shows how to display the maximum number of groups for each interface (25000). A configuration is committed to change the maximum number of groups for each 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

Robustness Value 2

No. of Group x Interfaces 61

Maximum number of Group x Interfaces 50000

Supported Interfaces   : 18

Unsupported Interfaces : 2

Enabled Interfaces     : 18

Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No

MgmtEth0/RP0/CPU0/0       0         25000 

Loopback0                 4         25000 

Bundle-POS24              3         25000 

Bundle-Ether28            3         25000 

Bundle-Ether28.1          3         25000 

Bundle-Ether28.2          3         25000 

Bundle-Ether28.3          3         25000 

MgmtEth0/RP1/CPU0/0       0         25000 

GigabitEthernet0/1/5/0    3         25000 

GigabitEthernet0/1/5/1    5         25000 

GigabitEthernet0/1/5/2    5         25000 

POS0/1/0/1                5         25000 

POS0/1/4/2                3         25000 

GigabitEthernet0/6/5/1    3         25000 

GigabitEthernet0/6/5/2    3         25000 

GigabitEthernet0/6/5/7    3         25000 

POS0/6/0/1                3         25000 

POS0/6/4/4                3         25000 

POS0/6/4/5                3         25000 

POS0/6/4/6                3         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:router# show igmp summary 

Robustness Value 2

No. of Group x Interfaces 61

Maximum number of Group x Interfaces 65

Supported Interfaces   : 18

Unsupported Interfaces : 2

Enabled Interfaces     : 18

Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No

MgmtEth0/RP0/CPU0/0       0         5     

Loopback0                 4         5     

Bundle-POS24              3         5     

Bundle-Ether28            3         5     

Bundle-Ether28.1          3         5     

Bundle-Ether28.2          3         5     

Bundle-Ether28.3          3         5     

MgmtEth0/RP1/CPU0/0       0         5     

GigabitEthernet0/1/5/0    3         5     

GigabitEthernet0/1/5/1    5         5     

GigabitEthernet0/1/5/2    5         5     

POS0/1/0/1                5         5     

POS0/1/4/2                3         5     

GigabitEthernet0/6/5/1    3         5     

GigabitEthernet0/6/5/2    3         5     

GigabitEthernet0/6/5/7    3         5     

POS0/6/0/1                3         5     

POS0/6/4/4                3         5     

POS0/6/4/5                3         5     

POS0/6/4/6                3         5 

The following example shows how to configure 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-default-if)# maximum groups-per-interface 4000

Related Commands

nsf lifetime (IGMP/MLD)

To configure the maximum time for the nonstop forwarding (NSF) timeout on the Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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

Defaults

seconds: 60

Command Modes

Router IGMP VRF configuration
Router MLD configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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 continues 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.

Examples

The following example shows how to set 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

query-interval

To configure the frequency at which the Cisco IOS XR software sends Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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

Defaults

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

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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 or 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 or 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 the query-interval command in router IGMP or MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from interface configuration mode.

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-default-if)# query-interval 120

Related Commands

query-max-response-time

To configure the maximum response time advertised in Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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

Defaults

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

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The query-max-response-time command is not supported on IGMP Version 1.

This command is used to control the maximum response time for hosts to answer an IGMP or 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 because hosts are restricted to a shorter response time period.

If you configure this command in router IGMP or 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).

Examples

The following example shows how to configure 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-default-if)# query-max-response-time 8

Related Commands

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

Defaults

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

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The query timeout command is not supported on Internet Group Management Protocol (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 or MLD configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces in interface configuration mode.

Examples

The following example shows how to configure 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-default-if)# query-timeout 30

Related Commands

robustness-count

To set the robustness variable to tune for expected packet loss on a network, use the robustness-count command in the appropriate configuration mode. To return to the default setting, use the no form of this command.

robustness-count count

no robustness-count

Syntax Description

Defaults

Default is 2 packets.

Command Modes

Router IGMP VRF configuration
Router IGMP interface configuration
Router MLD configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

IGMP is a soft-state protocol. State must be periodically refreshed or it times out. At a robustness-count command setting, for example, of 4, a network might lose three IGMP packets related to some specific state yet still maintain the state. If, however, a network lost more than three IGMP packets in the sequence, the state would time out. You might then consider changing the robustness-count setting to maintain state.

Examples

The following example illustrates the use of the robustness-count command:

RP/0/RP0/CPU0:router(config)# configure

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

RP/0/RP0/CPU0:router(config-igmp)# robustness-count 2

router

To disable or enable Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (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

Defaults

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

Command Modes

Router IGMP interface configuration
Router MLD interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

Examples

The following example shows how to disable 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 pos 0/1/0/0 

RP/0/RP0/CPU0:router(config-igmp-default-if)# router enable

Related Commands

router igmp

To enter Internet Group Management Protocol (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

Defaults

Global configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

From router IGMP VRF 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.

Examples

The following example shows how to enter router IGMP VRF configuration mode:

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

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

Related Commands

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

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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.

Examples

The following example shows how to enter router MLD configuration mode:

RP/0/RP0/CPU0:router(config)# router mld

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

Related Commands

show igmp groups

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

show igmp [old-output] [vrf vrf-name] groups [group-address | type path-id | not-active | summary] [detail] [explicit]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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.

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.

Related Commands

show igmp interface

To display Internet Group Management Protocol (IGMP) multicast-related information about an interface, use the show igmp interface command in EXEC mode.

show igmp [old-output] [vrf vrf-name] interface [type path-id | state-on | state-off]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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.

Related Commands

show igmp nsf

To display the state of the nonstop forwarding (NSF) operation in Internet Group Management Protocol (IGMP), use the show igmp nsf command in EXEC mode.

show igmp [old-output] [vrf vrf-name] nsf

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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.

Related Commands

show igmp summary

To display group membership information for Internet Group Management Protocol (IGMP), use the show igmp summary command in EXEC mode.

show igmp [old-output] [vrf vrf-name] summary

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The show igmp summary 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 50000 members. The maximum number of groups for each interface, and the default value for the maximum number of groups for each interface, is 25000 members.

Examples

The following example shows the number of groups for each 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

IGMP summary

Robustness Value 2

No. of Group x Interfaces 61

Maximum number of Group x Interfaces 65

Supported Interfaces   : 18

Unsupported Interfaces : 2

Enabled Interfaces     : 18

Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No

MgmtEth0/RP0/CPU0/0       0         5     

Loopback0                 4         5     

Bundle-POS24              3         5     

Bundle-Ether28            3         5     

Bundle-Ether28.1          3         5     

Bundle-Ether28.2          3         5     

Bundle-Ether28.3          3         5     

MgmtEth0/RP1/CPU0/0       0         5     

GigabitEthernet0/1/5/0    3         5     

GigabitEthernet0/1/5/1    5         5     

GigabitEthernet0/1/5/2    5         5     

POS0/1/0/1                5         5     

POS0/1/4/2                3         5     

GigabitEthernet0/6/5/1    3         5     

GigabitEthernet0/6/5/2    3         5     

GigabitEthernet0/6/5/7    3         5     

POS0/6/0/1                3         5     

POS0/6/4/4                3         5     

POS0/6/4/5                3         5     

POS0/6/4/6                3         5 

Table 5 describes the significant fields shown in the display.

Related Commands

show igmp ssm map

To query the source-specific mapping (SSM) state, use the show igmp ssm map command in EXEC mode.

show igmp [vrf vrf-name] ssm map [group-address] [detail]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

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 Cisco IOS XR System Security Configuration Guide.

Examples

The following example illustrates the use of the show igmp ssm map command:

RP/0/RP0/CPU0:router# show igmp ssm map 232.1.1.1 

232.1.1.1 is static with 1 source

show igmp traffic

To display all the Internet Group Management Protocol (IGMP) traffic-related counters, use the show igmp traffic command in EXEC mode.

show igmp [old-output] [vrf vrf-name] traffic

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The show igmp traffic 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.

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

Bad Scope Errors                                  0

Auxiliary Data Len Error                          0

Subnet 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 for both the show igmp traffic and show mld traffic command, since they are identical. For information about the show mld traffic command, see page 66

Related Commands

show mld groups

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

show mld [old-output] [vrf vrf-name] groups [group-address | type path-id | not-active | summary] [detail] [explicit]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of 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.

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

show mld interface

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

show mld [old-output] [vrf vrf-name] interface [type path-id | state-on | state-off]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

show mld nsf

To display the state of the nonstop forwarding (NSF) operation in Multicast Listener Discovery (MLD), use the show mld nsf command in EXEC mode.

show mld [old-output] [vrf vrf-name] nsf

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

show mld ssm map

To display the source-specific mapping (SSM) state in Multicast Listener Discovery (MLD), use the show mld ssm map command in EXEC mode.

show mld [vrf vrf-name] ssm map [group-address] [detail]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Examples

The following example illustrates the use of the show mld ssm map command:

RP/0/RP0/CPU0:router# show mld ssm map 2001:0DB8::/48

2001:0DB8::/48 is static with 1 source

show mld summary

To display group membership information for Multicast Listener Discovery (MLD), use the show mld summary command in EXEC mode.

show mld [old-output] [vrf vrf-name] summary

Syntax Description