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: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255. If this argument is not specified, the command displays the IGMP group information of all multicast groups.

interface interface-type interface-number: Specifies an interface by its type and number. If the interface-type interface-number argument is not specified, this command displays the IGMP group information on all interfaces.

static: Specifies IGMP groups that the interface has statically joined. If this keyword is not specified, the command displays only dynamic group entries of IGMP groups.

verbose: Displays detailed information about 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 display igmp group 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

Vlan-interface200(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 detailed information about 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

Vlan-interface200 (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

Group mode: exclude

Version1-host-present-timer-expiry: off

Version2-host-present-timer-expiry: off

Table 1 Command output

Field	Description
Group	Multicast group address.
Uptime	Length of time since the multicast group was reported.
Expires	Remaining time of the multicast group. If the multicast group never times out, this field displays off.
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. If the timer never expires, this field displays off.
Group mode	Multicast source filtering modes: include and 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. If the timer never expires, this field displays off.
Version2-host-present-timer-expiry	Remaining time of the IGMPv2 host present timer. If the timer never expires, this field displays off. This field is displayed only when the device is running IGMPv3.

display igmp group port-info

Syntax

In standalone mode:

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

In IRF mode:

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

View

Any view

Default level

1: Monitor level

Parameters

vlan-id: Specifies a VLAN ID in the range of 1 to 4094. If no VLAN is specified, this command displays the Layer 2 port information of IGMP groups in all VLANs .

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the Layer 2 port information of IGMP groups on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument refers to the ID of the IRF member device, and the slot-number argument refers to the number of the slot where the card resides. If this option is not specified, the Layer 2 port information of IGMP groups on all MPUs in the IRF member device is displayed. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

verbose: Displays 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 display igmp group port-info 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 about IGMP groups.

<Sysname> display igmp group port-info slot 3 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):4000.

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 0 port(s)..

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

IP group address:225.1.1.1

(0.0.0.0, 225.1.1.1):

Attribute: Host Port

Host port unit board: Mask(0x0)

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

GE3/0/23 (D) ( 00:01:28 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

Table 2 Command output

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—dynamic port. · S—Static port. · C—Port copied from a (*, G) entry to an (S, G) entry.
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: · R—Real egress sub-VLAN under the current entry. · C—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:28 )	Remaining time of the aging timer for the dynamic member port or router port: · In standalone mode, 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. · In IRF mode, to display the remaining life of a non-aggregation port that does not belong to the MPU, you must specify the member ID of the IRF member device and the slot number of the card with chassis chassis-number slot slot-number. For an aggregation port, you do not need to do this.
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: Specifies a multicast group address. The value range for the group-address argument is 224.0.1.0 to 239.255.255.255.

source source-address: Specifies a source address. The value range for the source-address argument 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 display igmp host interface 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/0/1.

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

Host information of VPN-Instance: public net

GigabitEthernet3/0/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 Command output

Field	Description
Host information of VPN-Instance: public net	Information about the hosts tracked by IGMP on the public network interface.
GigabitEthernet3/0/1(192.168.1.1)	Interface and IP address.
(0.0.0.0, 224.1.1.1)	(S, G) entry. If the multicast source is not specified, the field in the S position displays 0.0.0.0.
Host	Host IP address.
Uptime	Host running duration.
Expires	Host expiration time. If the host has expired, this field displays timeout.

display igmp host port-info

Syntax

In standalone mode:

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

In IRF mode:

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

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

group group-address: Specifies a multicast group address. The value range for the group-address argument is 224.0.1.0 to 239.255.255.255.

source source-address: Specifies a multicast source address. The value range for the source-address argument 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: Specifies a card by its slot number. If no slot is specified, the command displays the Layer 2 information of the IGMP hosts on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the number of the slot that holds the card. If this option is not specified, this command displays information about the hosts tracked by IGMP on the Layer 2 ports on all MPUs in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

|: 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 display igmp host port-info 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/0/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/0/2

Host Uptime Expires

3.3.3.3 00:02:20 00:00:40

Table 4 Command output

Field	Description
VLAN(ID)	VLAN ID.
(0.0.0.0, 224.1.1.1)	(S, G) entry. If the multicast source is not specified, the field in the S position displays 0.0.0.0.
Port	Member port.
Host	Host IP address.
Uptime	Host running duration.
Expires	Host expiration time. If the host has expired, this field displays timeout.

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 detailed IGMP configuration 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 display igmp interface to display IGMP configuration information on 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 IGMP configuration information on VLAN-interface 300 (downstream interface) on the public network.

<Sysname> display igmp interface Vlan-interface200 verbose

Vlan-interface200(10.10.1.20):

IGMP is enabled

Current IGMP version is 2

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

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): 15

Value of startup query count: 2

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

Querier for IGMP: 10.10.1.20 (this router)

IGMP activity: 1 joins, 0 leaves

Multicast routing on this interface: enabled

Robustness: 2

Require-router-alert: disabled

Fast-leave: disabled

Ssm-mapping: disabled

Startup-query-timer-expiry: off

Other-querier-present-timer-expiry: off

Proxying interface: Vlan-interface300(20.10.1.20)

Total 1 IGMP Group reported

# Display detailed IGMP configuration information on VLAN-interface 300 (upstream interface) on the public network.

<Sysname> display igmp interface Vlan-interface 300 verbose

Vlan-interface300(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 Command output

Field	Description
Vlan-interface200 (10.10.1.20)	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. If the timer never expires, this field displays off.
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	Whether the function of dropping IGMP messages without Router-Alert is enabled.
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. If the timer never expires, this field displays off.
Other-querier-present-timer-expiry	Remaining time of the other querier present timer. If the timer never expires, this field displays off.
Proxying interface	IGMP proxy interface. If no proxy interface exists, this field displays None.
Total 1 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,. If the timer never expires, this field displays off.
Version2-querier-present-timer-expiry	Remaining time of the IGMPv2 querier present timer. If the timer never expires, this field displays off.

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: Specifies a 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 display igmp proxying group 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 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 detailed information about 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 Command output

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. If the multicast group never times out, this field displays off.
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: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

mask: Specifies the address subnet mask, 255.255.255.255 by default.

mask-length: Specifies the address subnet mask length. The default is 32. For a multicast source address, the value range for this argument is 0 to 32. For a multicast group address, the value range for this argument is 4 to 32.

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 display igmp routing-table 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 2 entries

00001. (*, 225.1.1.1)

List of 1 downstream interface

Vlan-interface200(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

Vlan-interface300 (30.1.1.1),

Protocol: IGMP

00003. (*, 239.255.255.250)

List of 1 downstream interface

Vlan-interface200(20.20.20.20),

Protocol: IGMP

Table 7 Command output

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)	(*, G) entry of the IGMP routing table.
Flag	IGMP route flags: · ACT—IGMP routing entries that have been used for forwarding data packets but have the multicast group address out of the SSM group range. · SUC—IGMP routing entries that have been added to the forwarding table and have the multicast group address within the SSM group range.
List of 1 downstream interface	List of downstream interfaces to which multicast data for this group will be forwarded.
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.
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 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 display igmp ssm-mapping to display the configured IGMP SSM mappings for the specified multicast group.

If neither all-instance nor vpn-instance is specified, this command displays 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 Command output

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 address in the range of 224.0.1.0 to 239.255.255.255. If no multicast group address is specified, the command displays information about 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 no interface is specified, the command displays multicast group information created based on the configured IGMP SSM mappings on all the interfaces.

verbose: Displays 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 display igmp ssm-mapping group 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 detailed information about 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

Vlan-interface200(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 Command output

Field	Description
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. If the multicast group never times out, this field displays off.
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. If the timer never expires, this field displays off.
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. If the timer never expires, this field displays off.

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: Specifies an interface by its type and number.

group group-address: Specifies a multicast group address. The value range for the group-address argument is 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 display igmp ssm-mapping host interface 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/0/1.

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

Host information of VPN-Instance: public net

GigabitEthernet3/0/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 Command output

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/0/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. If the host has expired, this field displays timeout.

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: Specifies a basic ACL number in the range of 2000 to 2999. The fast-leave processing function takes effect only on the multicast groups that match the permit statement in the ACL. If you do not include this option in your command, this command takes effect on all multicast groups.

Description

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

Use undo fast-leave 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.

In IGMP view, this command takes effect on only Layer 3 interfaces except VLAN interfaces.

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 host-tracking to enable the IGMP host tracking function globally.

Use undo host-tracking 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 igmp to enter public network IGMP view or VPN instance IGMP view .

Use undo igmp 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 and 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 igmp enable to enable IGMP on the current interface.

Use undo igmp enable 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.

This command is not supported in tunnel interface view.

Related commands: igmp and multicast routing-enable.

Examples

# Enable IP multicast routing on the public network, and then enable IGMP on VLAN-interface 100.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp fast-leave to configure fast-leave processing on the current interface.

Use undo igmp fast-leave 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, because these two commands take effect on VLANs with IGMP enabled on their 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/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] port link-mode route

[Sysname-GigabitEthernet3/0/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: Specifies the maximum number of multicast groups that an interface can join, in the range of 1 to 1024.

Description

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

Use undo igmp group-limit to restore the default.

By default, the upper limit is 1024.

This command takes effect on only 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 that you configure the limit only on the VLAN interface.

This command is not supported in tunnel interface view.

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

Examples

# Allow VLAN-interface 100 to join up to 128 multicast groups.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies a basic or advanced ACL number in the range of 2000 to 3999. A host can join only the multicast groups that match the permit statement 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: Specifies an IGMP version in the range of 1 to 3. If you do not specify an IGMP version, the configured group filter will apply to IGMP reports of all versions.

Description

Use igmp group-policy 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 undo igmp group-policy 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, configure the same multicast group filter in the corresponding VLAN.

This command does not take effect on statically joined multicast groups.

This command is not supported in tunnel interface view.

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

Examples

# Configure an ACL rule so that hosts on VLAN-interface 100 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 vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp host-tracking to enable the IGMP host tracking function on an interface.

Use undo igmp host-tracking 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 VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies an IGMP last member query interval in seconds, in the range of 1 to 5.

Description

Use igmp last-member-query-interval 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 undo igmp last-member-query-interval to restore the default.

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

This command is not supported in tunnel interface view.

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

Examples

# Set the IGMP last member query interval to 3 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies the maximum response time in seconds for IGMP general queries, in the range of 1 to 25.

Description

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

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

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

This command is not supported in tunnel interface view.

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

Examples

# Set the maximum response time for IGMP general queries to 8 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp proxying enable to enable IGMP proxying on an interface.

Use undo igmp proxying enable 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.

This command is not supported in tunnel interface view.

Related commands: multicast routing-enable.

Examples

# Enable IP multicast routing on the public network and enable IGMP proxying on VLAN-interface 100.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp proxying forwarding to enable a non-querier downstream interface to forward multicast traffic.

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

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

This command is not supported in tunnel interface view.

Examples

# Enable the multicast forwarding capability on VLAN-interface 100, a non-querier downstream interface on the IGMP proxy device.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp require-router-alert to configure the interface to discard IGMP messages that do not carry the Router-Alert option.

Use undo igmp require-router-alert 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.

This command is not supported in tunnel interface view.

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

Examples

# Configure VLAN-interface 100 to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies an IGMP querier's robustness variable in the range of 2 to 5.

Description

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

Use undo igmp robust-count 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 multicast groups and multicast sources.

This command is not supported in tunnel interface view.

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

Examples

# Set the IGMP querier's robustness variable to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp send-router-alert on the current interface to enable insertion of the Router-Alert option in IGMP messages to be sent.

Use undo igmp send-router-alert 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.

This command is not supported in tunnel interface view.

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

Examples

# Disable insertion of the Router-Alert option into IGMP messages that leave VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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 igmp ssm-mapping enable to enable the IGMP SSM mapping feature on the current interface.

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

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

This command is not supported in tunnel interface view.

Examples

# Enable the IGMP SSM mapping feature on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies a startup query count (the number of queries the IGMP querier sends on startup) in the range of 2 to 5.

Description

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

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

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

This command is not supported in tunnel interface view.

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

Examples

# Set the startup query count to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies a startup query interval (interval between general queries that the IGMP querier sends on startup) in the range of 1 to 18000 seconds.

Description

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

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

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

This command is not supported in tunnel interface view.

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

Examples

# Set the startup query interval to 5 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies a multicast source address.

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

Description

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

Use undo igmp static-group 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.

This command is not supported in tunnel interface view.

Related commands: igmp-snooping static-group.

Examples

# Configure VLAN-interface 100 to be a statically connected member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp static-group 224.1.1.1

# Configure VLAN-interface 100 to be a statically connected member of multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies an other querier present interval in seconds, in the range of 60 to 300.

Description

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

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

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

This command is not supported in tunnel interface view.

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

Examples

# Set the other querier present interval to 200 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies an IGMP general query interval (interval for sending IGMP general queries) in the range of 1 to 18000 seconds.

Description

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

Use undo igmp timer query to restore the default.

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

This command is not supported in tunnel interface view.

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

Examples

# Set the IGMP general query interval to 125 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies an IGMP version in the range of 1 to 3.

Description

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

Use undo igmp version to restore the default IGMP version.

The default IGMP version is version 2.

This command is not supported in tunnel interface view.

Related commands: version.

Examples

# Set the IGMP version to IGMPv1 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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: Specifies a last-member query interval in seconds, in the range of 1 to 5.

Description

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

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

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

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

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: Specifies the maximum response time for IGMP general queries, in the range of 1 to 25 seconds.

Description

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

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

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

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

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 require-router-alert to configure globally the router to discard IGMP messages that do not carry the Router-Alert option.

Use undo require-router-alert 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: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source address.

mask: Specifies the address subnet mask, 255.255.255.255 by default.

mask-length: Specifies the address subnet mask length. The default is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

Description

Use reset igmp group to remove the dynamic group entries of an 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 interfaces on the public network.

<Sysname> reset igmp group all

# Remove dynamic group entries of IGMP groups on VLAN-interface 100 on the public network.

<Sysname> reset igmp group interface vlan-interface 100 all

# Remove the dynamic IGMP group entry of IGMP group 225.0.0.1 on VLAN-interface 100 on the public network.

<Sysname> reset igmp group interface vlan-interface 100 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 address in the range of 224.0.1.0 to 239.255.255.255.

vlan-id: Specifies a VLAN ID in the range of 1 to 4094.

Description

Use reset igmp group port-info to remove dynamic Layer 2 port entries of an 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 address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source address.

mask: Specifies the address subnet mask, 255.255.255.255 by default.

mask-length: Specifies the address subnet mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

Description

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

If neither all-instance nor vpn-instance is specified, this command will clear the information 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

robust-value: Specifies an IGMP querier's robustness variable in the range of 2 to 5.

Description

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

Use undo robust-count to restore the default.

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

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

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

· The number of IGMP group-specific queries that 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 multicast groups and multicast sources.

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

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 send-router-alert to globally enable insertion of the Router-Alert option into IGMP messages to be sent.

Use undo send-router-alert 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 address in the range of 224.0.0.0 to 239.255.255.255.

mask: Specifies the address subnet mask.

mask-length: Specifies the address subnet mask length in the range of 4 to 32.

source-address: Specifies a multicast source address.

all: Removes all IGMP SSM mappings.

Description

Use ssm-mapping to configure an IGMP SSM mapping.

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

By default, no IGMP SSM mappings are configured.

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

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: Specifies a startup query count (the number of queries that the IGMP querier sends on startup) in the range of 2 to 5.

Description

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

Use undo startup-query-count 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: Specifies a startup query interval (interval between general queries that the IGMP querier sends on startup) in the range of 1 to 18000 seconds.

Description

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

Use undo startup-query-interval 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: Specifies an other querier present interval in the range of 60 to 300 seconds.

Description

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

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

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

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

Examples

# Set the 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 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: Specifies an IGMP general query interval (interval for sending IGMP general queries) in the range of 1 to 18000 seconds.

Description

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

Use undo timer query to restore the default.

By default, IGMP general query interval is 60 seconds.

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

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: Specifies an IGMP version in the range of 1 to 3.

Description

Use version to configure the IGMP version globally.

Use undo version 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

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

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us