display igmp [ all-instance | vpn-instance vpn-instance-name ] group [ group-address | interface interface-type interface-number ] [ static | verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255. If you do not specify this argument, the command displays the IGMP group information of all multicast groups.

interface interface-type interface-number: Displays the IGMP group information about a particular interface. If you do not specify interface-type interface-number, this command displays the IGMP group information on all interfaces.

static: Displays the information of statically joined IGMP groups. If you do not specify this keyword, the command displays only dynamic group entries of IGMP groups.

verbose: Displays the detailed information of IGMP groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp group command to display IGMP group information.

If neither all-instance nor vpn-instance is specified, this command displays the IGMP group information on the public network.

Examples

# Display the dynamic group entries of IGMP groups on all interfaces on the public network.

<Sysname> display igmp group

Total 3 IGMP Group(s).

Interface group report information of VPN-Instance: public net

GigabitEthernet3/1/1(10.10.1.20):

Total 3 IGMP Groups reported

Group Address Last Reporter Uptime Expires

225.1.1.1 10.10.1.10 00:02:04 00:01:15

225.1.1.3 10.10.1.10 00:02:04 00:01:15

225.1.1.2 10.10.1.10 00:02:04 00:01:17

# Display the detailed information of the dynamic entries of IGMP group 225.1.1.1 on the public network.

<Sysname> display igmp group 225.1.1.1 verbose

Interface group report information of VPN-Instance: public net

GigabitEthernet3/1/1(10.10.1.20):

Total 3 IGMP Groups reported

Group: 225.1.1.1

Uptime: 00:00:34

Expires: 00:00:40

Last reporter: 10.10.1.10

Last-member-query-counter: 0

Last-member-query-timer-expiry: off

Version1-host-present-timer-expiry: off

Table 1 Output description

Field	Description
Interface group report information of VPN-Instance: public net	IGMP group information on a public network interface
Group	Multicast group address
Uptime	Length of time since the multicast group was reported
Expires	Remaining time of the multicast group, where “off” means that the multicast group never times out
Last reporter	Address of the last host that reported its membership for this multicast group
Last-member-query-counter	Number of last-member queries sent
Last-member-query-timer-expiry	Remaining time of the last member query timer, where “off” means that the timer never expires
Group mode	Multicast source filtering modes: · include · exclude This field is displayed only when the device is running IGMPv3.
Version1-host-present-timer-expiry	Remaining time of the IGMPv1 host present timer, where “off” means that the timer never expires
Version2-host-present-timer-expiry	Remaining time of the IGMPv2 host present timer, where “off” means that the timer never expires. This filed is displayed only when the device is running IGMPv3.

display igmp group port-info

Syntax

display igmp group port-info [ vlan vlan-id ] [ slot slot-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan-id: VLAN ID, in the range of 1 to 4094. If you do not specify a VLAN, this command displays the Layer 2 port information of IGMP groups in all VLANs.

slot slot-number: Displays the Layer 2 port information of IGMP groups on the card specified by its slot number. If no slot is specified, the command displays the Layer 2 port information of IGMP groups on the main processing unit (MPU).

verbose: Displays the detailed information about Layer 2 ports of IGMP groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp group port-info command to display Layer 2 port information of IGMP groups, including both dynamic and static Layer 2 port entries.

Examples

# Display detailed Layer 2 port information of IGMP groups.

<Sysname> display igmp group port-info verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, C-Copy port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port unit board: Mask(0x0)

Router port(s):total 1 port(s).

GE3/1/2 (D) ( 00:01:41 )

IP group(s):the following ip group(s) match to one mac group.

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Board

Host port unit board: Mask(0x40 6)

Host port(s):total 1 port(s).

GE3/1/1 (D) ( 00:00:22 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE3/1/1

Table 2 Output description

Field	Description
Total 1 IP Group(s).	Total number of IP multicast groups
Total 1 IP Source(s).	Total number of IP multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, C-Copy port	Port flags: D for a dynamic port, S for a static port, and C for a port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for a real egress sub-VLAN under the current entry, and C for a sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
Router port unit board	Mask indicating a board with a router port residing on it.
( 00:01:41 )	Remaining time of the aging timer for the dynamic member port or router port. To display the remaining life of a non-aggregation port that does not belong to the MPU, you must specify the number of the slot where the corresponding card resides by using slot slot-number. This is not required for an aggregation port.
IP group address	Address of the IP multicast group
MAC group address	Address of the MAC multicast group
Attribute	Attribute of the IP multicast group
Host port unit board	Mask indicating a board with a member port residing on it.
Host port(s)	Number of member ports

display igmp host interface

Syntax

display igmp host interface interface-type interface-number group group-address [ source source-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type interface-number: Displays information about the hosts tracked by IGMP on the specified interface.

group group-address: Displays information about the hosts tracked by IGMP that are in the specified IGMP group. The value of group-address ranges from 224.0.1.0 to 239.255.255.255.

source source-address: Displays information about the hosts tracked by IGMP that are in the specified multicast source, where source-address is a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp host interface command to display information about the hosts tracked by IGMP on the specified interface.

Examples

# Display information about the hosts tracked by IGMP in multicast group 224.1.1.1 on GigabitEthernet 3/1/1.

<Sysname> display igmp host interface GigabitEthernet 3/1/1 group 224.1.1.1

Host information of VPN-Instance: public net

GigabitEthernet3/1/1(192.168.1.1):

(0.0.0.0, 224.1.1.1)

Host Uptime Expires

1.1.1.1 00:02:20 00:00:40

2.2.2.2 00:02:21 00:00:39

Table 3 Output description

Field	Description
Host information of VPN-Instance: public net	Information about the hosts tracked by IGMP on the public network interface
GigabitEthernet3/1/1(192.168.1.1)	Interface and IP address
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 indicates all multicast sources
Host	Host IP address
Uptime	Host running duration
Expires	Host expiration time, where timeout means that the host has expired.

display igmp host port-info

Syntax

display igmp host port-info vlan vlan-id group group-address [ source source-address ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays information about the hosts tracked by IGMP on the Layer 2 ports in the specified VLAN, where vlan-id is in the range of 1 to 4094.

group group-address: Displays information about the hosts tracked by IGMP that join in the specified IGMP group on the Layer 2 ports. The value of group-address ranges from 224.0.1.0 to 239.255.255.255.

source source-address: Displays information about the hosts tracked by IGMP that join in the specified multicast source on the Layer 2 ports, where source-address is a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

slot slot-number: Displays information about the hosts tracked by IGMP on the Layer 2 ports on the card specified by its slot number. If no slot is specified, the command displays the Layer 2 information of the IGMP hosts on the MPU.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp host port-info command to display information about the hosts tracked by IGMP on the Layer 2 ports.

Examples

# Display information about the hosts tracked by IGMP that join in IGMP group 224.1.1.1 on the Layer 2 ports in VLAN 2.

<Sysname> display igmp host port-info vlan 2 group 224.1.1.1

VLAN(ID) : 2

(0.0.0.0, 224.1.1.1)

Port : GigabitEthernet3/1/1

Host Uptime Expires

1.1.1.1 00:02:20 00:00:40

2.2.2.2 00:02:21 00:00:39

Port : GigabitEthernet3/1/2

Host Uptime Expires

3.3.3.3 00:02:20 00:00:40

Table 4 Output description

Field	Description
VLAN(ID)	VLAN ID
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 indicates all multicast sources.
Port	Member port
Host	Host IP address
Uptime	Host running duration
Expires	Host expiration time, where timeout means that the host has expired.

display igmp interface

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

interface-type interface-number: Specifies an interface to display the IGMP configuration and operation information about. If no interface is specified, this command displays the related information of all IGMP-enabled interfaces.

verbose: Displays the detailed IGMP configuration and operation information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp interface command to display IGMP configuration and operation information of the specified interface or all IGMP-enabled interfaces.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display the IGMP configuration and operation information on GigabitEthernet 2/1/11.4000 (downstream interface) on the public network.

<Sysname> display igmp interface GigabitEthernet 2/1/11.4000 verbose

GigabitEthernet2/1/11.4000(199.1.1.13):

IGMP is enabled

Current IGMP version is 3

Value of query interval for IGMP(in seconds): 10

Value of other querier present interval for IGMP(in seconds): 125

Value of maximum query response time for IGMP(in seconds): 10

Value of last member query interval(in seconds): 1

Value of startup query interval(in seconds): 3

Value of startup query count: 2

General query timer expiry (hours:minutes:seconds): 00:00:07

Querier for IGMP: 199.1.1.13 (this router)

IGMP activity: 256 joins, 0 leaves

Multicast routing on this interface: enabled

Robustness: 2

Require-router-alert: enabled

Fast-leave: disabled

Ssm-mapping: disabled

Startup-query-timer-expiry: off

Other-querier-present-timer-expiry: off

Proxying interface: GigabitEthernet2/1/2(20.10.1.20)

Total 256 IGMP Groups reported

# Display the detailed IGMP configuration and operation information on GigabitEthernet 2/1/2 (upstream interface) on the public network.

<Sysname> display igmp interface GigabitEthernet 2/1/2 verbose

GigabitEthernet2/1/2(20.10.1.20):

IGMP proxy is enabled

Current IGMP version is 3

Multicast routing on this interface: enabled

Require-router-alert: disabled

Version1-querier-present-timer-expiry: off

Version2-querier-present-timer-expiry: off

Table 5 Output description

Field	Description
GigabitEthernet2/1/11.4000(199.1.1.13)	Interface and IP address
Current IGMP version	Version of IGMP that runs on the interface
Value of query interval for IGMP(in seconds)	IGMP general query interval, in seconds
Value of other querier present interval for IGMP(in seconds)	Other querier present interval, in seconds
Value of maximum query response time for IGMP(in seconds)	Maximum response time for IGMP general queries, in seconds
Value of last member query interval(in seconds)	IGMP last member query interval, in seconds
Value of startup query interval(in seconds)	IGMP startup query interval, in seconds
Value of startup query count	Number of IGMP general queries the device sends on startup
General query timer expiry	Remaining time of the IGMP general query timer, where “off” means that the timer never expires
Querier for IGMP	IP address of the IGMP querier
IGMP activity	Statistics of IGMP activities (joins and leaves)
Multicast routing on this interface	Whether the multicast routing and forwarding function is enabled
Robustness	Robustness variable of the IGMP querier
Require-router-alert	Dropping IGMP messages without Router-Alert (enabled/disabled)
Fast-leave	Fast-leave processing status (enabled/disabled)
Ssm-mapping	IGMP SSM mapping status (enabled/disabled)
Startup-query-timer-expiry	Remaining time of the startup query timer, where “off” means that the timer never expires
Other-querier-present-timer-expiry	Remaining time of the other querier present timer, where “off” means that the timer never expires
Proxying interface	IGMP proxy interface, where “none” means that no proxy interface exists
Total 256 IGMP Group reported	Total number of IGMP groups the interface has dynamically joined
IGMP proxy is enabled	IGMP proxying is enabled
Version1-querier-present-timer-expiry	Remaining time of the IGMPv1 querier present timer, where “off” means that the timer never expires
Version2-querier-present-timer-expiry	Remaining time of the IGMPv2 querier present timer, where “off” means that the timer never expires

display igmp proxying group

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] proxying group [ group-address ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255. With no multicast group address included, this command displays the information of all the IGMP proxying groups.

verbose: Displays the detailed IGMP proxying group information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp proxying group command to display the IGMP proxying group information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display the IGMP proxying group information on the public network.

<Sysname> display igmp proxying group

Proxying group record(s) information of VPN-Instance: public net

Total 1 IGMP-Proxying group record(s)

Group Address Member state Expires

225.1.1.1 Delay 00:01:15

# Display the detailed information of IGMP proxying group 225.1.1.1 on the public network.

<Sysname> display igmp proxying group 225.1.1.1 verbose

Proxying group record(s) information of VPN-Instance: public net

Total 1 IGMP-Proxying group record(s)

Group: 225.1.1.1

Group mode: include

Member state: Delay

Expires: 00:00:02

Source list (total 1 source(s))

Source: 1.1.1.1

Table 6 Output description

Field	Description
Proxying group record(s) information of VPN-Instance: public net	IGMP proxying group information on the public network
Total 1 IGMP-Proxying group record(s)	One IGMP proxying group is recorded.
Group Address/Group	Multicast group address
Member state	Host member states: · Delay · Idle
Expires	Remaining time of the multicast group, where “off” means that the multicast group never times out
Group mode	Multicast source filtering modes: · Include · Exclude
Source list	A list of sources joining the same multicast group in the IGMP proxying group

display igmp routing-table

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | flags { act | suc } ] * [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

mask: Subnet mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group address or multicast source address. For a multicast source address, this argument has an effective value range of 0 to 32. For a multicast group address, this argument has an effective value range of 4 to 32. The system default is 32 in both cases.

flags: Specifies the route flag.

act: Displays the IGMP routes with the ACT flag.

suc: Displays the IGMP routes with the SUC flag.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp routing-table command to display the IGMP routing table information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display IGMP routing table information on the public network.

<Sysname> display igmp routing-table

Routing table of VPN-Instance: public net

Total 3 entry

00001. (*, 225.1.1.1)

List of 1 downstream interface in include mode

GigabitEthernet3/1/1 (20.1.1.1),

Protocol: STATIC

00002. (1.1.1.1, 225.1.1.1), Flag: ACT

List of 1 downstream interface in include mode

GigabitEthernet3/1/2 (30.1.1.1),

Protocol: IGMP

00003. (*, 239.255.255.250)

List of 1 downstream interface

GigabitEthernet3/1/3 (40.20.20.20),

Protocol: IGMP

Table 7 Output description

Field	Description
Routing table of VPN-Instance: public net	Public network IGMP routing table
00001	Sequence number of this (*, G) entry
(*, 225.1.1.1)	A (*, G) entry of the IGMP routing table
Flag	IGMP route flags: · ACT: Indicates IGMP routing entries that have been used for forwarding data packets but have the multicast group address out of the SSM group range · SUC: Indicates IGMP routing entries that have been added to the forwarding table and have the multicast group address within the SSM group range
in include mode	The downstream interface is in the include mode
in exclude mode	The downstream interface is in the exclude mode
Downstream interface is none	No downstream interfaces exist
List of 1 downstream interface	Downstream interface list, namely, the interfaces to which multicast data for this group will be forwarded
Protocol	Protocol type

display igmp ssm-mapping

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] ssm-mapping group-address [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Specifies a multicast group by its IP address, in the range of 224.0.1.0 to 239.255.255.255.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp ssm-mapping command to display the configured IGMP SSM mappings for the specified multicast group.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Related commands: ssm-mapping.

Examples

# Display the IGMP SSM mappings for multicast group 232.1.1.1 on the public network.

<Sysname> display igmp ssm-mapping 232.1.1.1

VPN-Instance: public net

Group: 232.1.1.1

Source list:

1.2.3.4

5.5.5.5

10.1.1.1

100.1.1.10

Table 8 Output description

Field	Description
VPN-Instance: public net	Public network
Group	Multicast group address
Source list	List of multicast source addresses

display igmp ssm-mapping group

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] ssm-mapping group [ group-address | interface interface-type interface-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Specifies a multicast group by its IP address, in the range of 224.0.1.0 to 239.255.255.255. If you do not specify any multicast group, the command displays the information of all multicast groups created based on the configured IGMP SSM mappings.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify any interface, the command displays the multicast group information created based on the configured IGMP SSM mappings on all the interfaces.

verbose: Displays the detailed multicast group information created based on the configured IGMP SSM mappings.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp ssm-mapping group command to display the multicast group information created based on the configured IGMP SSM mappings.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display the detailed information of multicast group 232.1.1.1 created based on the configured IGMP SSM mappings on the public network.

<Sysname> display igmp ssm-mapping group 232.1.1.1 verbose

Interface group report information of VPN-Instance: public net

GigabitEthernet3/1/1(10.10.10.10):

Total 1 IGMP SSM-mapping Group reported

Group: 232.1.1.1

Uptime: 00:00:31

Expires: off

Last reporter: 1.1.1.1

Version1-host-present-timer-expiry: off

Source list(Total 1 source):

Source: 1.1.1.1

Uptime: 00:00:31

Expires: 00:01:39

Last-member-query-counter: 0

Last-member-query-timer-expiry: off

Table 9 Output description

Field	Description
Interface group report information of VPN-Instance: public net	Multicast group information created based on IGMP SSM mappings on a public network interface
Total 1 IGMP SSM-mapping Group reported	One IGMP SSM mapping multicast group was reported.
Group	Multicast group address
Uptime	Length of time since the multicast group was reported
Expires	Remaining time of the multicast group, where “off” means that the multicast group never times out
Last reporter	Address of the last host that reported its membership for this multicast group
Version1-host-present-timer-expiry	Remaining time of the IGMPv1 host present timer, where “off” means that the timer never expires
Source list(Total 1 source)	Multicast source list (one multicast source)
Source	Multicast source address
Last-member-query-counter	Number of last-member queries sent
Last-member-query-timer-expiry	Remaining time of the last member query timer, where “off” means that the timer never expires

display igmp ssm-mapping host interface

Syntax

display igmp ssm-mapping host interface interface-type interface-number group group-address source source-address [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type interface-number: Displays information about the hosts that join a multicast group based on the IGMP SSM mappings on the specified interface.

group group-address: Displays information about the hosts that join the specified multicast group based on the IGMP SSM mappings. The value of group-address ranges from 224.0.1.0 to 239.255.255.255.

source source-address: Displays information about the hosts that join the specified multicast source based on the IGMP SSM mappings, where source-address is a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display igmp ssm-mapping host interface command to display information about the hosts that join a multicast group based on the IGMP SSM mappings on an interface.

Examples

# Displays information about the hosts that join multicast source group (10.1.1.1, 224.1.1.1) based on the IGMP SSM mappings on GigabitEthernet 3/1/1.

<Sysname> display igmp ssm-mapping host interface GigabitEthernet 3/1/1 group 224.1.1.1 source 10.1.1.1

Host information of VPN-Instance: public net

GigabitEthernet3/1/1(192.168.1.1):

(10.1.1.1, 224.1.1.1)

Host Uptime Expires

1.1.1.1 00:02:20 00:00:40

2.2.2.2 00:02:21 00:00:39

Table 10 Output description

Field	Description
Host information of VPN-Instance: public net	Information about the hosts that join the group based on the IGMP SSM mappings on public network interface
GigabitEthernet3/1/1(192.168.1.1)	Interface and IP address
(10.1.1.1, 224.1.1.1)	(S, G) entry
Host	Host IP address
Uptime	Host running duration
Expires	Host expiration time, where timeout means that the host has expired.

fast-leave (IGMP view)

Syntax

fast-leave [ group-policy acl-number ]

undo fast-leave

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999. With the ACL number specified, the fast-leave feature applies to only the multicast groups that match the permit rule in the ACL. If you do not include this argument in the command, this command takes effect for all multicast groups.

Description

Use the fast-leave command to configure fast-leave processing globally.

Use the undo fast-leave command to disable fast-leave processing globally.

By default, fast-leave processing is disabled. Namely, the IGMP querier sends IGMP group-specific queries or IGMP group-and-source-specific queries after receiving an IGMP leave message from a host, instead of sending a leave notification directly to the upstream.

Related commands: igmp fast-leave and last-member-query-interval.

Examples

# Enable fast-leave processing globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] fast-leave

# Enable fast-leave processing globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] fast-leave

host-tracking (IGMP view)

Syntax

host-tracking

undo host-tracking

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

None

Description

Use the host-tracking command to enable the IGMP host tracking function globally.

Use the undo host-tracking command to disable the IGMP host tracking function globally.

By default, this function is disabled.

Related command: igmp host-tracking.

Examples

# Enable the IGMP host tracking function globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] host-tracking

# Enable the IGMP host tracking function globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] host-tracking

igmp

Syntax

igmp [ vpn-instance vpn-instance-name ]

undo igmp [ vpn-instance vpn-instance-name ]

View

System view

Default level

2: System level

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If this option is not specified, the command applies to the public network.

Description

Use the igmp command to enter public network IGMP view or VPN instance IGMP view .

Use the undo igmp command to remove configurations in public network IGMP view or VPN instance IGMP view.

IP multicast routing must be enabled in the corresponding instance before this command can take effect.

Related commands: igmp enable, multicast routing-enable.

Examples

# Enable IP multicast routing on the public network and enter public network IGMP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] igmp

[Sysname-igmp]

# Enable IP multicast routing in VPN instance mvpn and enter IGMP view for VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] route-distinguisher 100:1

[Sysname-vpn-instance-mvpn] multicast routing-enable

[Sysname-vpn-instance-mvpn] quit

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp enable command to enable IGMP on the current interface.

Use the undo igmp enable command to disable IGMP on the current interface.

By default, IGMP is disabled on all interfaces.

IP multicast routing must be enabled in the corresponding instance before this command can take effect.

IGMP must be enabled on an interface before any other IGMP feature configured on the interface can take effect.

Related commands: igmp, multicast routing-enable.

Examples

# Enable IP multicast routing on the public network, and enable IGMP on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp enable

igmp fast-leave

Syntax

igmp fast-leave [ group-policy acl-number ]

undo igmp fast-leave

View

Interface view

Default level

2: System level

Parameters

Description

Use the igmp fast-leave command to configure fast-leave processing on the current interface.

Use the undo igmp fast-leave command to disable fast-leave processing on the current interface.

The igmp fast-leave command cannot be used in VLAN-interface view. To enable fast-leave processing on a specific Layer 2 port, use the igmp-snooping fast-leave command or the fast-leave (IGMP-snooping view) command.

The igmp-snooping fast-leave and fast-leave (IGMP-snooping view) commands are effective for both IGMP snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: fast-leave (IGMP view), fast-leave (IGMP-snooping view), igmp last-member-query-interval, and igmp-snooping fast-leave.

Examples

# Enable fast-leave processing on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp fast-leave

igmp group-limit

Syntax

igmp group-limit limit

undo igmp group-limit

View

Interface view

Default level

2: System level

Parameters

limit: Maximum number of multicast groups that an interface can join. The value range varies with the system working modes as follows:

· SPE mode: 1 to 16384

· SPC mode: 1 to 32768

· Hybrid mode: 1 to 16384

For more information about the system working modes, see Fundamentals Configuration Guide.

Description

Use the igmp group-limit command to configure the maximum number of multicast groups that an interface can join.

Use the undo igmp group-limit command to restore the default.

By default, the maximum number of multicast groups that an interface can join depends on the system working mode, that is, 16384 in SPE mode, 32768 in SPC mode, and 16384 in hybrid mode.

This command is effective only for dynamically joined multicast groups but not statically joined multicast groups.

If the configured limit value is smaller than the number of the existing multicast groups on the current interface, the system does not automatically remove the multicast groups in excess. To bring this configuration into effect in this case, you need to use the reset igmp group command to clear the IGMP group information manually.

You can also use the igmp-snooping group-limit command to limit the number of multicast groups that an interface can join. However, if you configure the limit both on a VLAN and on a VLAN interface of this VLAN by using these two commands, inconsistencies might exist between Layer 2 and Layer 3 table entries. Therefore, H3C recommends you to configure the limit only on the VLAN interface.

Related commands: igmp static-group and reset igmp group, igmp-snooping group-limit.

Examples

# Allow GigabitEthernet 3/1/1 to join up to 128 multicast groups.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp group-limit 128

igmp group-policy

Syntax

igmp group-policy acl-number [ version-number ]

undo igmp group-policy

View

Interface view

Default level

2: System level

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. With the ACL number specified, a host can join only the multicast groups that match the permit rule in the ACL. The source address or address range specified in the advanced ACL rule matches the multicast source address or addresses specified in IGMPv3 reports, rather than the source address in the IP packets. The system assumes that an IGMPv1 or IGMPv2 report or an IGMPv3 IS_EX and TO_EX report that does not carry a multicast source address carries a multicast source address of 0.0.0.0.

version-number: IGMP version, in the range of 1 to 3. If you do not specify an IGMP version, the configured group filter applies to IGMP reports of all versions.

Description

Use the igmp group-policy command to configure a multicast group filter on the current interface to control the multicast groups that the hosts on the current interface can join.

Use the undo igmp group-policy command to remove the configured multicast group filter.

By default, no multicast group filter is configured. Namely, a host can join any valid multicast group.

You can also use the group-policy (IGMP-snooping view) command to control the multicast groups that hosts in a VLAN can join, achieving the same result as igmp group-policy. If you have configured a multicast group filter on a VLAN interface to control the multicast groups that the hosts on the interface can join, it is recommended to configure the same multicast group filter in the corresponding VLAN.

Related commands: group-policy (IGMP-snooping view).

Examples

# Configure an ACL rule so that hosts on GigabitEthernet 3/1/1 can join multicast group 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2005

[Sysname-acl-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2005] quit

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp group-policy 2005

igmp host-tracking

Syntax

igmp host-tracking

undo igmp host-tracking

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp host-tracking command to enable the IGMP host tracking function on an interface.

Use the undo igmp host-tracking command to disable the IGMP host tracking function on an interface

By default, this function is disabled.

Related commands: host-tracking.

Examples

# Enable the IGMP host tracking function on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp host-tracking

igmp last-member-query-interval

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

View

Interface view

Default level

2: System level

Parameters

interval: IGMP last member query interval in seconds, with an effective range of 1 to 5.

Description

Use the igmp last-member-query-interval command to configure the last-member query interval, namely, the length of time that the device waits between sending IGMP group-specific queries, on the current interface.

Use the undo igmp last-member-query-interval command to restore the default.

By default, the IGMP last member query interval is 1 second.

Related commands: last-member-query-interval, igmp robust-count, and display igmp interface.

Examples

# Set the IGMP last member query interval to 3 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp last-member-query-interval 3

igmp max-response-time

Syntax

igmp max-response-time interval

undo igmp max-response-time

View

Interface view

Default level

2: System level

Parameters

interval: Maximum response time in seconds for IGMP general queries, with an effective range of 1 to 25.

Description

Use the igmp max-response-time command to configure the maximum response time for IGMP general queries on the current interface.

Use the undo igmp max-response-time command to restore the default.

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: max-response-time, igmp timer other-querier-present, and display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp max-response-time 8

igmp proxying enable

Syntax

igmp proxying enable

undo igmp proxying enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp proxying enable command to enable IGMP proxying on an interface.

Use the undo igmp proxying enable command to disable IGMP proxying on the interface.

By default, IGMP proxying is disabled.

This command takes effect only after IP multicast routing is enabled on the corresponding instance.

If IGMP proxying is enabled on a loopback interface, the proxy device maintains only the IGMP routing table without adding the IGMP routes to the multicast routing table and forwarding table.

Related commands: multicast routing-enable.

Examples

# Enable IP multicast routing on the public network and enable IGMP proxying on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp proxying enable

igmp proxying forwarding

Syntax

igmp proxying forwarding

undo igmp proxying forwarding

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp proxying forwarding command to enable a non-querier downstream interface to forward multicast traffic.

Use the undo igmp proxying forwarding command to disable the forwarding capability of a non-querier downstream interface.

By default, a non-querier downstream interface does not forward multicast traffic.

Examples

# Enable the multicast forwarding capability on GigabitEthernet 3/1/1, a non-querier downstream interface on the IGMP proxy device.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp proxying forwarding

igmp require-router-alert

Syntax

igmp require-router-alert

undo igmp require-router-alert

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp require-router-alert command to configure the interface to discard IGMP messages that do not carry the Router-Alert option.

Use the undo igmp require-router-alert command to restore the default.

By default, the device does not check the Router-Alert option. Namely, it passes all the IGMP messages that it receives to the upper layer protocol for processing.

Related commands: require-router-alert and igmp send-router-alert.

Examples

# Configure GigabitEthernet 3/1/1 to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp require-router-alert

igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Default level

2: System level

Parameters

robust-value: IGMP querier robustness variable, with an effective range of 2 to 5. The IGMP robustness variable determines the default number of general queries the IGMP querier sends on startup and the number of IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Description

Use the igmp robust-count command to configure the IGMP querier’s robustness variable on the current interface.

Use the undo igmp robust-count command to restore the default.

By default, the IGMP querier’s robustness variable is 2.

The IGMP querier’s robustness variable defines the maximum number of attempts for transmitting IGMP general queries, group-specific queries or group-and-source-specific queries in case of packet loss due to network problems. A greater value of the robustness variable makes the IGMP querier “more robust”, but results in a longer multicast group timeout time.

The IGMP querier’s robustness variable determines the following values:

· The default number of general queries the IGMPv1/v2/v3 querier sends on startup

· The number of IGMP group-specific queries the IGMPv2 querier sends after receiving an IGMP leave message.

· The number of IGMP group-and-source-specific queries that the IGMPv3 querier sends after receiving an IGMP report that tells relation changes between IPv6 multicast groups and IPv6 multicast sources.

Related commands: robust-count, igmp timer query, igmp last-member-query-interval, igmp startup-query-count, igmp timer other-querier-present, and display igmp interface.

Examples

# Set the IGMP querier’s robustness variable to 3 on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp robust-count 3

igmp send-router-alert

Syntax

igmp send-router-alert

undo igmp send-router-alert

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp send-router-alert command on the current interface to enable insertion of the Router-Alert option in IGMP messages to be sent.

Use the undo igmp send-router-alert command on the current interface to disable insertion of the Router-Alert option in IGMP messages to be sent.

By default, IGMP messages are sent with the Router-Alert option.

Related commands: send-router-alert and igmp require-router-alert.

Examples

# Disable insertion of the Router-Alert option into IGMP messages that leave GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] undo igmp send-router-alert

igmp ssm-mapping enable

Syntax

igmp ssm-mapping enable

undo igmp ssm-mapping enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the igmp ssm-mapping enable command to enable the IGMP SSM mapping feature on the current interface.

Use the undo igmp ssm-mapping enable command to disable the IGMP SSM mapping feature on the current interface.

By default, the IGMP SSM mapping feature is disabled on all interfaces.

Examples

# Enable the IGMP SSM mapping feature on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp ssm-mapping enable

igmp startup-query-count

Syntax

igmp startup-query-count value

undo igmp startup-query-count

View

Interface view

Default level

2: System level

Parameters

value: Startup query count, namely, the number of queries the IGMP querier sends on startup, with an effective range of 2 to 5.

Description

Use the igmp startup-query-count command to configure the startup query count on the current interface.

Use the undo igmp startup-query-count command to restore the default.

By default, the startup query count is set to the IGMP querier’s robustness variable.

Related commands: startup-query-count and igmp robust-count.

Examples

# Set the startup query count to 3 on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp startup-query-count 3

igmp startup-query-interval

Syntax

igmp startup-query-interval interval

undo igmp startup-query-interval

View

Interface view

Default level

2: System level

Parameters

interval: Startup query interval in seconds, namely, the interval between general queries that the IGMP querier sends on startup, with an effective range of 1 to 18000.

Description

Use the igmp startup-query-interval command to configure the startup query interval on the current interface.

Use the undo igmp startup-query-interval command to restore the default.

By default, the startup query interval is 1/4 of the IGMP general query interval.

Related commands: startup-query-interval and igmp timer query.

Examples

# Set the startup query interval to 5 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp startup-query-interval 5

igmp static-group

Syntax

igmp static-group group-address [ source source-address ]

undo igmp static-group { all | group-address [ source source-address ] }

View

Interface view

Default level

2: System level

Parameters

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Multicast source address.

all: Specifies to remove all static multicast groups that the current interface has joined.

Description

Use the igmp static-group command to configure the current interface to be a statically connected member of the specified multicast group or multicast source and group.

Use the undo igmp static-group command to restore the default.

By default, an interface is not a static member of any multicast group or multicast source and group.

If the specified multicast address is in the SSM multicast address range, you must specify a multicast source address at the same time. Otherwise, IGMP routing table entries cannot be established. No such a restriction exists if the specified multicast group address is not in the SSM multicast address range.

If you want to configure a VLAN interface as a static member of a multicast group or multicast source and group, configure the igmp static-group command on the VLAN interface, and configure the igmp-snooping static-group command on the member ports of the corresponding VLAN.

Related commands: igmp-snooping static-group.

Examples

# Configure GigabitEthernet 3/1/1 to be a statically connected member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp static-group 224.1.1.1

# Configure GigabitEthernet 3/1/1 to be a statically connected member of multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp static-group 232.1.1.1 source 192.168.1.1

igmp timer other-querier-present

Syntax

igmp timer other-querier-present interval

undo igmp timer other-querier-present

View

Interface view

Default level

2: System level

Parameters

interval: IGMP other querier present interval in seconds, in the range of 60 to 300.

Description

Use the igmp timer other-querier-present command to configure the IGMP other querier present interval on the current interface.

Use the undo igmp timer other-querier-present command to restore the default.

By default, the IGMP other querier present interval is [ IGMP general query interval ] × [ IGMP querier’s robustness variable ] + [ maximum response time for IGMP general queries ] /2.

Related commands: timer other-querier-present, igmp timer query, igmp robust-count, igmp max-response-time, and display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp timer other-querier-present 200

igmp timer query

Syntax

igmp timer query interval

undo igmp timer query

View

Interface view

Default level

2: System level

Parameters

interval: IGMP general query interval in seconds, namely, the interval between IGMP general queries, with an effective range of 1 to 18,000.

Description

Use the igmp timer query command to configure the IGMP general query interval on the current interface.

Use the undo igmp timer query command to restore the default.

By default, the IGMP general query interval is 60 seconds.

Related commands: timer query, igmp timer other-querier-present, and display igmp interface.

Examples

# Set the IGMP general query interval to 125 seconds on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp timer query 125

igmp version

Syntax

igmp version version-number

undo igmp version

View

Interface view

Default level

2: System level

Parameters

version-number: IGMP version, in the range of 1 to 3.

Description

Use the igmp version command to configure the IGMP version on the current interface.

Use the undo igmp version command to restore the default IGMP version.

The default IGMP version is version 2.

Related commands: version.

Examples

# Set the IGMP version to IGMPv1 on GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] igmp version 1

last-member-query-interval (IGMP view)

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

interval: Last-member query interval in seconds, with an effective range of 1 to 5.

Description

Use the last-member-query-interval command to configure the global IGMP last-member query interval.

Use the undo last-member-query-interval command to restore the default.

By default, the IGMP last-member query interval is 1 second.

Related commands: igmp last-member-query-interval, robust-count, and display igmp interface.

Examples

# Set the global IGMP last-member interval to 3 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-interval 3

# Set the global IGMP last-member interval to 3 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] last-member-query-interval 3

max-response-time (IGMP view)

Syntax

max-response-time interval

undo max-response-time

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

interval: Maximum response time for IGMP general queries in seconds, with an effective range of 1 to 25.

Description

Use the max-response-time command to configure the maximum response time for IGMP general queries globally.

Use the undo max-response-time command to restore the default.

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: igmp max-response-time, timer other-querier-present, and display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 8

# Set the maximum response time for IGMP general queries to 8 seconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] max-response-time 8

require-router-alert (IGMP view)

Syntax

require-router-alert

undo require-router-alert

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

None

Description

Use the require-router-alert command to configure globally the router to discard IGMP messages that do not carry the Router-Alert option.

Use the undo require-router-alert command to restore the default.

By default, the device does not check the Router-Alert option. Namely, it passes all the IGMP messages that it received to the upper layer protocol for processing.

Related commands: igmp require-router-alert and send-router-alert.

Examples

# Configure the router to discard IGMP messages that do not carry the Router-Alert option globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] require-router-alert

# Configure the router to discard IGMP messages that do not carry the Router-Alert option globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] require-router-alert

reset igmp group

Syntax

reset igmp [ all-instance | vpn-instance vpn-instance-name ] group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

View

User view

Default level

2: System level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

all: The first all specifies all interfaces, and the second all specifies all IGMP groups.

interface interface-type interface-number: Specifies an interface by its type and number.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Subnet mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group address or multicast source address. For a multicast group address, this argument has an effective value range of 4 to 32. For a multicast source address, this argument has an effective value range of 0 to 32. The system default is 32 in both cases.

Description

Use the reset igmp group command to remove the dynamic group entries of a specified IGMP group or all IGMP groups.

If neither all-instance nor vpn-instance is specified, this command removes the dynamic IGMP group entries on the public network.

This command cannot remove static IGMP group entries.

Related commands: display igmp group.

Examples

# Remove dynamic group entries of IGMP groups on all the interfaces on the public network.

<Sysname> reset igmp group all

# Remove dynamic group entries of IGMP groups on GigabitEthernet 3/1/1 on the public network.

<Sysname> reset igmp group interface GigabitEthernet 3/1/1 all

# Remove the dynamic IGMP group entry of IGMP group 225.0.0.1 on GigabitEthernet 3/1/1 on the public network.

<Sysname> reset igmp group interface GigabitEthernet 3/1/1 225.0.0.1

reset igmp group port-info

Syntax

reset igmp group port-info { all | group-address } [ vlan vlan-id ]

View

User view

Default level

2: System level

Parameters

all: Specifies all the IGMP groups.

group-address: Specifies an IGMP group. The value range of group-address is 224.0.1.0 to 239.255.255.255.

vlan-id: Specifies a VLAN. The value range of vlan-id is 1 to 4094.

Description

Use the reset igmp group port-info command to remove dynamic Layer 2 port entries of a specified IGMP group or all IGMP groups.

Layer 2 ports for IGMP groups include member ports and router ports.

This command cannot remove static Layer 2 port entries of IGMP groups.

Related commands: display igmp group port-info.

Examples

# Remove dynamic Layer 2 port entries of all IGMP groups in all VLANs.

<Sysname> reset igmp group port-info all

# Remove dynamic Layer 2 port entries of all IGMP groups in VLAN 100.

<Sysname> reset igmp group port-info all vlan 100

# Remove dynamic Layer 2 port entries of multicast group 225.0.0.1 in VLAN 100.

<Sysname> reset igmp group port-info 225.0.0.1 vlan 100

reset igmp ssm-mapping group

Syntax

reset igmp [ all-instance | vpn-instance vpn-instance-name ] ssm-mapping group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

View

User view

Default level

2: System level

Parameters

all-instance: Specifies all MPLS L3VPNs.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

all: The first all specifies to clear multicast group information created based on the configured IGMP SSM mappings on all interfaces, and the second all specifies to clear all multicast group information created based on the configured IGMP SSM mappings.

interface-type interface-number: Specifies an interface by its type and number.

group-address: Specifies a multicast group by its IP address, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source by its IP address.

mask: Subnet mask of the multicast group address or multicast source address, 255.255.255.255 by default.

Description

Use the reset igmp ssm-mapping group command to clear multicast group information created based on the configured IGMP SSM mappings.

If neither all-instance nor vpn-instance is specified, this command clears multicast group information created based on the configured IGMP SSM mappings on the public network.

Related commands: display igmp ssm-mapping group.

Examples

# Clear all multicast group information created based on the configured IGMP SSM mappings on all interfaces on the public network.

<Sysname> reset igmp ssm-mapping group all

robust-count (IGMP view)

Syntax

robust-count robust-value

undo robust-count

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

Description

Use the robust-count command to configure the IGMP querier’s robustness variable globally.

Use the undo robust-count command to restore the default.

By default, the IGMP querier’s robustness variable is 2.

Related commands: igmp robust-count, timer query, last-member-query-interval, startup-query-count, timer other-querier-present, and display igmp interface.

Examples

# Set the IGMP querier’s robustness variable to 3 globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 3

# Set the IGMP querier’s robustness variable to 3 globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] robust-count 3

send-router-alert (IGMP view)

Syntax

send-router-alert

undo send-router-alert

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

None

Description

Use the send-router-alert command to globally enable insertion of the Router-Alert option into IGMP messages to be sent.

Use the undo send-router-alert command to globally disable insertion of the Router-Alert option into IGMP messages to be sent.

By default, an IGMP message carries the Router-Alert option.

Related commands: igmp send-router-alert and require-router-alert.

Examples

# Globally disable the insertion of the Router-Alert option in IGMP messages to be sent on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] undo send-router-alert

# Globally disable the insertion of the Router-Alert option in IGMP messages to be sent in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] undo send-router-alert

ssm-mapping (IGMP view)

Syntax

ssm-mapping group-address { mask | mask-length } source-address

undo ssm-mapping { group-address { mask | mask-length } source-address | all }

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

group-address: Specifies a multicast group by its IP address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Subnet mask of the multicast group address.

mask-length: Subnet mask length of the multicast group address, in the range of 4 to 32.

source-address: Specifies a multicast source by its IP address.

all: Removes all IGMP SSM mappings.

Description

Use the ssm-mapping command to configure an IGMP SSM mapping.

Use the undo ssm-mapping command to remove one or all IGMP SSM mappings.

By default, no IGMP SSM mappings are configured.

Related commands: igmp ssm-mapping enable and display igmp ssm-mapping.

Examples

# Configure an IGMP SSM mapping on the public network for multicast groups in the range of 225.1.1.0/24 and multicast source 125.1.1.1.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] ssm-mapping 225.1.1.0 24 125.1.1.1

# Configure an IGMP SSM mapping in VPN instance mvpn for multicast groups in the range of 225.1.1.0/24 and multicast source 125.1.1.1.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] ssm-mapping 225.1.1.0 24 125.1.1.1

startup-query-count (IGMP view)

Syntax

startup-query-count value

undo startup-query-count

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

value: Startup query count, namely, the number of queries that the IGMP querier sends on startup, with an effective range of 2 to 5.

Description

Use the startup-query-count command to configure the startup query count globally.

Use the undo startup-query-count command to restore the default.

By default, the startup query count is set to the IGMP querier’s robustness variable.

Related commands: igmp startup-query-count and robust-count.

Examples

# Set the startup query count to 3 globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-count 3

# Set the startup query count to 3 globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] startup-query-count 3

startup-query-interval (IGMP view)

Syntax

startup-query-interval interval

undo startup-query-interval

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

interval: Startup query interval in seconds, namely, the interval between general queries that the IGMP querier sends on startup, with an effective range of 1 to 18000.

Description

Use the startup-query-interval command to configure the startup query interval globally.

Use the undo startup-query-interval command to restore the default.

By default, the startup query interval is 1/4 of the “IGMP general query interval”.

Related commands: igmp-startup-query-interval and timer query.

Examples

# Set the startup query interval to 5 seconds globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-interval 5

# Set the startup query interval to 5 seconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] startup-query-interval 5

timer other-querier-present (IGMP view)

Syntax

timer other-querier-present interval

undo timer other-querier-present

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

interval: IGMP other querier present interval, in the range of 60 to 300.

Description

Use the timer other-querier-present command to configure the IGMP other querier present interval globally.

Use the undo timer other-querier-present command to restore the default.

By default, the IGMP other querier present interval is [ IGMP general query interval ] × [ IGMP querier’s robustness variable ] + [ maximum response time for IGMP general queries ] /2.

Related commands: igmp timer other-querier-present, timer query, robust-count, max-response-time, and display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer other-querier-present 200

# Set the IGMP other querier present interval to 200 seconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] timer other-querier-present 200

timer query (IGMP view)

Syntax

timer query interval

undo timer query

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

interval: IGMP general query interval in seconds, namely, interval between IGMP general queries, with an effective range of 1 to 18,000.

Description

Use the timer query command to configure the IGMP general query interval globally.

Use the undo timer query command to restore the default.

By default, IGMP general query interval is 60 seconds.

Related commands: igmp timer query, timer other-querier-present, and display igmp interface.

Examples

# Set the IGMP general query interval to 125 seconds globally on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer query 125

# Set the IGMP general query interval to 125 seconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] timer query 125

version (IGMP view)

Syntax

version version-number

undo version

View

Public network IGMP view, VPN instance IGMP view

Default level

2: System level

Parameters

version-number: IGMP version, in the range of 1 to 3.

Description

Use the version command to configure the IGMP version globally.

Use the undo version command to restore the default.

The default IGMP version is version 2.

Related commands: igmp version.

Examples

# Set the global IGMP version to IGMPv1 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] version 1

# Set the global IGMP version to IGMPv1 in VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn] version 1

07-IP Multicast Command Reference

display igmp host interface

display igmp ssm-mapping

host-tracking (IGMP view)

igmp fast-leave

igmp group-limit

igmp host-tracking

igmp max-response-time

igmp proxying enable

igmp robust-count

igmp ssm-mapping enable

igmp timer other-querier-present

igmp timer query

igmp version

last-member-query-interval (IGMP view)

reset igmp ssm-mapping group

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us