vlan vlan-id: Specifies a VLAN by its ID, in the range of 1 to 4094. If this option is not specified, this command displays information about IGMP snooping groups on all VLANs.

verbose: Displays detailed IGMP snooping 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.

Examples

# Display detailed IGMP snooping group information in VLAN 2.

<Sysname> display igmp-snooping group vlan 2 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, P-PIM 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(s):total 1 port(s).

GE1/0/1 (D) ( 00:01:30 )

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 Port

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

GE1/0/2 (D) ( 00:03:23 )

MAC group(s):

MAC group address:0100-5e01-0101

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

GE1/0/2

Table 1 Command output

Field	Description
Total 1 IP Group(s)	Total number of IP multicast groups.
Total 1 IP Source(s)	Total number of multicast sources.
Total 1 MAC Group(s)	Total number of MAC multicast groups.
Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port	Port flags: · D—Dynamic port. · S—Static port. · C—Port copied from a (*, G) entry to an (S, G) entry. · P—Port added by PIM snooping.
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.
( 00:01:30 )	Remaining time of the aging timer for the dynamic member port or router port.
IP group address	Address of IP multicast group.
MAC group address	Address of MAC multicast group.
Attribute	Attribute of IP multicast group.
Host port(s)	Number of member ports.

display igmp-snooping host

Use display igmp-snooping host to display information about the hosts tracked by IGMP snooping.

Syntax

display igmp-snooping host vlan vlan-id group group-address [ source source-address ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

group group-address: Specifies a multicast group . 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. The value of the source-address argument is a valid unicast address or 0.0.0.0, where 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.

Examples

# Display information about the hosts tracked by IGMP snooping in VLAN 2 that are in multicast group 224.1.1.1.

<Sysname> display igmp-snooping host vlan 2 group 224.1.1.1

VLAN(ID) : 2

(0.0.0.0, 224.1.1.1)

Port : GE1/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 : GE1/0/2

Host Uptime Expires

3.3.3.3 00:02:20 00:00:40

Table 2 Command output

Field	Description
VLAN(ID)	VLAN ID.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where "0.0.0.0" means 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-snooping statistics

Use display igmp-snooping statistics to display statistics for the IGMP messages learned through IGMP snooping.

Syntax

display igmp-snooping statistics [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: 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.

Examples

# Display statistics for the IGMP messages learned through IGMP snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries:0.

Received IGMPv1 reports:0.

Received IGMPv2 reports:19.

Received IGMP leaves:0.

Received IGMPv2 specific queries:0.

Sent IGMPv2 specific queries:0.

Received IGMPv3 reports:1.

Received IGMPv3 reports with right and wrong records:0.

Received IGMPv3 specific queries:0.

Received IGMPv3 specific sg queries:0.

Sent IGMPv3 specific queries:0.

Sent IGMPv3 specific sg queries:0.

Received error IGMP messages:19.

Table 3 Command output

Field	Description
general queries	Number of IGMP general queries.
specific queries	Number of IGMP group-specific queries.
reports	Number of IGMP reports.
leaves	Number of IGMP leave messages.
reports with right and wrong records	Number of IGMP reports with correct and incorrect records.
specific sg query packet(s)	Number of IGMP group-and-source-specific queries.
error IGMP messages	Number of IGMP messages with errors.

dot1p-priority (IGMP-snooping view)

Use dot1p-priority to set the 802.1p precedence for IGMP messages globally.

Use undo dot1p-priority to restore the default.

Syntax

dot1p-priority priority-number

undo dot1p-priority

Views

IGMP-snooping view

Default command level

2: System level

Parameters

priority-number: Specifies an 802.1p precedence for IGMP messages, in the range of 0 to 7. A higher number means a higher precedence.

Usage guidelines

The default 802.1p precedence for IGMP messages is 0.

Examples

# Set the 802.1p precedence for IGMP messages to 3 globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] dot1p-priority 3

drop-unknown (IGMP-snooping view)

Use drop-unknown to enable dropping unknown multicast data globally.

Use undo drop-unknown to disable dropping unknown multicast data globally.

Syntax

drop-unknown

undo drop-unknown

Default

This function is disabled and unknown multicast data is flooded.

Views

IGMP-snooping view

Default command level

2: System level

Examples

# Enable the device to drop unknown multicast data globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] drop-unknown

Related commands

igmp-snooping drop-unknown

fast-leave (IGMP-snooping view)

Use fast-leave to enable fast-leave processing globally. With this function enabled, when the AC receives an IGMP leave message on a port, it directly removes that port from the multicast forwarding entry of the specific group.

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

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The value range of a VLAN ID is 1 to 4094. If you do not specify any VLAN, the command takes effect on all VLANs. If you specify more VLANs, the command takes effect on only the specified VLANs.

Examples

# Enable fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

Related commands

igmp-snooping fast-leave

group-policy (IGMP-snooping view)

Use group-policy to configure a global multicast group filter to control the multicast groups that a host in the specified VLAN can join.

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

Syntax

group-policy acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

Default

No global multicast group filter is configured. Namely, a host in the specified VLAN can join any multicast group.

Views

IGMP-snooping view

Default command 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 specified ACL.

Usage guidelines

If the specified ACL does not exist or the ACL rule is null, all multicast groups are filtered out.

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule overrides the existing one.

Examples

# Apply ACL 2000 as a multicast group filter in VLAN 2 so that hosts in this VLAN can join only the multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] igmp-snooping

[Sysname-igmp-snooping] group-policy 2000 vlan 2

Related commands

igmp-snooping group-policy

host-aging-time (IGMP-snooping view)

Use host-aging-time to set the aging timer for the dynamic member ports globally.

Use undo host-aging-time to restore the default.

Syntax

host-aging-time interval

undo host-aging-time

Default

The aging timer of the dynamic member ports is 260 seconds.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

interval: Specifies an aging time in seconds for dynamic member ports, in the range of 200 to 1000.

Examples

# Set the aging timer for the dynamic member ports to 300 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-aging-time 300

Related commands

igmp-snooping host-aging-time

host-tracking (IGMP-snooping view)

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

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

Syntax

host-tracking

undo host-tracking

Default

This function is disabled.

Views

IGMP-snooping view

Default command level

2: System level

Examples

# Enable the IGMP snooping host tracking function globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-tracking

Related commands

igmp-snooping host-tracking

igmp-snooping

Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

Syntax

igmp-snooping

undo igmp-snooping

Default

IGMP snooping is disabled.

Views

System view

Default command level

2: System level

Examples

# Enable IGMP snooping globally and enter IGMP-snooping view.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

Related commands

igmp-snooping enable

igmp-snooping dot1p-priority

Use igmp-snooping dot1p-priority to set the 802.1p precedence for IGMP messages in a VLAN.

Use undo igmp-snooping dot1p-priority to restore the default.

Syntax

igmp-snooping dot1p-priority priority-number

undo igmp-snooping dot1p-priority

Default

The default 802.1p precedence for IGMP messages is 0.

Views

VLAN view

Default command level

2: System level

Parameters

priority-number: Specifies an 802.1p precedence for IGMP messages, in the range of 0 to 7. A higher number means a higher precedence.

Usage guidelines

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

Examples

# On VLAN 2, enable IGMP snooping and set the 802.1p precedence for IGMP messages to 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping dot1p-priority 3

Related commands

igmp-snooping enable

igmp-snooping drop-unknown

Use igmp-snooping drop-unknown to enable dropping unknown multicast data in the VLAN.

Use undo igmp-snooping drop-unknown to disable dropping unknown multicast data in the VLAN.

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

Default

This function is disabled and unknown multicast data is flooded.

Views

VLAN view

Default command level

2: System level

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# On VLAN 2, enable IGMP snooping and the function of dropping unknown multicast data.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping drop-unknown

Related commands

· drop-unknown

· igmp-snooping enable

igmp-snooping enable

Use igmp-snooping enable to enable IGMP snooping in the current VLAN.

Use undo igmp-snooping enable to disable IGMP snooping in the current VLAN.

Syntax

igmp-snooping enable

undo igmp-snooping enable

Default

IGMP snooping is disabled in a VLAN.

Views

VLAN view

Default command level

2: System level

Usage guidelines

IGMP snooping must be enabled globally before it can be enabled in a VLAN.

Examples

# Enable IGMP snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

Related commands

igmp-snooping

igmp-snooping fast-leave

Use igmp-snooping fast-leave to enable fast-leave processing on a port. With this function enabled, when the AC receives an IGMP leave message on the port, it directly removes that port from the multicast forwarding entry of the specific group.

Use undo igmp-snooping fast-leave to disable fast-leave processing.

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

Usage guidelines

Configuration views for this command vary by device models. For more information, see About the H3C Access Controllers Command References.

If you do not specify any VLAN when using this command in Layer 2 Ethernet interface view or Layer 2 aggregate interface view, the command takes effect on all VLANs to which the interface belongs. If you specify one or more VLANs, the command takes effect on the specified VLANs to which the interface belongs.

If you do not specify any VLAN when using this command in port group view, the command takes effect on all the ports in this group. If you specify one or more VLANs, the command takes effect only on those ports in this group that belong to the specified VLANs.

Examples

# Enable fast-leave processing on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2

Related commands

fast-leave

igmp-snooping general-query source-ip

Use igmp-snooping general-query source-ip to configure the source address of IGMP general queries.

Use undo igmp-snooping general-query source-ip to restore the default.

Syntax

igmp-snooping general-query source-ip { ip-address | current-interface }

undo igmp-snooping general-query source-ip

Default

The source IP address of IGMP general queries is 0.0.0.0.

Views

VLAN view

Default command level

2: System level

Parameters

ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.

current-interface: Sets the source address of IGMP general queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 is used as the source IP address of IGMP general queries.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# On VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1

Related commands

igmp-snooping enable

igmp-snooping group-limit

Use igmp-snooping group-limit to set the maximum number of multicast groups that a port can join.

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

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ]

undo igmp-snooping group-limit [ vlan vlan-list ]

Default

The default value varies with devices. For more information, see About the H3C Access Controllers Command References.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

limit: Specifies the maximum number of multicast groups that a port can join. The value range varies with devices. For more information, see About the H3C Access Controllers Command References.

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The value range of a VLAN ID is 1 to 4094. If this option is not specified, the command separately takes effect on all VLANs to which the port belongs.

Usage guidelines

Configuration views for this command vary by device models. For more information, see About the H3C Access Controllers Command References.

If you do not specify any VLAN when using this command in Layer 2 Ethernet interface view or Layer 2 aggregate interface view, the command takes effect on all VLANs that the interface belongs to. If you specify one or more VLANs, the command takes effect on the specified VLANs that the interface belongs to.

Examples

# Configure the device to allow GigabitEthernet 1/0/1 in VLAN 2 to join up to 10 multicast groups.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2

Related commands

igmp group-limit

igmp-snooping group-policy

Use igmp-snooping group-policy to configure a multicast group filter on a port to control the multicast groups that the hosts on the port can join.

Use undo igmp-snooping group-policy to remove a multicast group filter.

Syntax

igmp-snooping group-policy acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

Default

No multicast group filter is configured on an interface. A host can join any valid multicast group.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

acl-number: Specifies a basic or advanced ACL number, in the range of 2000 to 3999. A host can only join the multicast groups that match the permit statement in the specified ACL.

Usage guidelines

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule overrides the existing one.

Examples

# Apply ACL 2000 as a multicast group filter so that the hosts on GigabitEthernet 1/0/1 in VLAN 2 can join 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2

Related commands

group-policy

igmp-snooping host-aging-time

Use igmp-snooping host-aging-time to set the aging timer for the dynamic member ports in the current VLAN.

Use undo igmp-snooping host-aging-time to restore the default.

Syntax

igmp-snooping host-aging-time interval

undo igmp-snooping host-aging-time

Default

The aging timer of the dynamic member ports is 260 seconds.

Views

VLAN view

Default command level

2: System level

Parameters

interval: Sets an aging time for the dynamic member port in seconds, in the range of 200 to 1000.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# Enable IGMP snooping for VLAN 2 and set the aging timer for the dynamic member ports in the VLAN to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-aging-time 300

Related commands

· host-aging-time

· igmp-snooping enable

igmp-snooping host-join

Use igmp-snooping host-join to configure a port on the AC as a simulated member host for the specified multicast group or the specified multicast source and group.

Use undo igmp-snooping host-join to remove a simulated member host from the specified multicast group or the specified multicast source and group.

Syntax

igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

Default

This function is disabled.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

group-address: Specifies the address of the multicast group that the simulated host will join, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies the address of the multicast source that the simulated host will join. The value of this argument should be a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

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

Usage guidelines

The source-ip source-address option in the command is meaningful only for IGMPv3 snooping. If IGMPv2 snooping is running, the source-ip source-address option does not take effect, although you can include source-ip source-address in the command.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host in VLAN 2 for the multicast source and group (1.1.1.1, 224.1.1.1).

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 224.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping host-tracking

Use igmp-snooping host-tracking to enable the IGMP snooping host tracking function in a VLAN.

Use undo igmp-snooping host-tracking to disable the IGMP snooping host tracking function in a VLAN.

Syntax

igmp-snooping host-tracking

undo igmp-snooping host-tracking

Default

This function is disabled.

Views

VLAN view

Default command level

2: System level

Usage guidelines

Before you configure this command, enable IGMP snooping in the VLAN.

Examples

# Enable IGMP snooping and IGMP snooping host tracking in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-tracking

Related commands

· host-tracking

· igmp-snooping enable

igmp-snooping last-member-query-interval

Use igmp-snooping last-member-query-interval to set the IGMP last-member query interval for a VLAN.

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

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

Default

The default setting is 1 second.

Views

VLAN view

Default command level

2: System level

Parameters

interval: Sets the IGMP last-member query interval in seconds, in the range of 1 to 5.

Usage guidelines

The IGMP last-member query interval determines the interval for sending IGMP group-specific queries and the maximum response delay for IGMP group-specific queries in a VLAN.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# Enable IGMP snooping for VLAN 2 and set the IGMP last-member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

Related commands

· igmp-snooping enable

· last-member-query-interval

igmp-snooping leave source-ip

Use igmp-snooping leave source-ip to configure the source IP address of the IGMP leave messages that the IGMP snooping proxy sends.

Use undo igmp-snooping leave source-ip to restore the default.

Syntax

igmp-snooping leave source-ip { ip-address | current-interface }

undo igmp-snooping leave source-ip

Default

The source IP address of the IGMP leave messages that the IGMP snooping proxy sends is 0.0.0.0.

Views

VLAN view

Default command level

2: System level

Parameters

ip-address: Specifies a source address for the IGMP leave messages that the IGMP snooping proxy sends, which can be any legal IP address.

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP leave messages that the IGMP snooping proxy sends. If no IP address has been assigned to the current VLAN interface, the default IP address 0.0.0.0 is used.

Usage guidelines

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

The source IP address configured in the igmp-snooping leave source-ip command also applies when the simulated host sends IGMP leave messages.

Examples

# On VLAN 2, enable IGMP snooping and configure the source IP address of IGMP leave messages that the IGMP snooping proxy sends to 10.1.1.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping leave source-ip 10.1.1.1

Related commands

igmp-snooping enable

igmp-snooping max-response-time

Use igmp-snooping max-response-time to set the maximum response delay for IGMP general queries in the VLAN.

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

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

Default

The default setting is 10 seconds.

Views

VLAN view

Default command level

2: System level

Parameters

interval: Specifies the maximum response delay for IGMP general queries in seconds, in the range of 1 to 25.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# Enable IGMP snooping and set the maximum response delay for IGMP general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping max-response-time 5

Related commands

· igmp-snooping enable

· igmp-snooping query-interval

· max-response-time

igmp-snooping overflow-replace

Use igmp-snooping overflow-replace to enable the multicast group replacement function.

Use undo igmp-snooping overflow-replace to disable the multicast group replacement function.

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement function is disabled.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

Usage guidelines

Examples

# Enable the multicast group replacement function on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2

Related commands

overflow-replace

igmp-snooping proxying enable

Use igmp-snooping proxying enable to enable the IGMP snooping proxying function in a VLAN.

Use undo igmp-snooping proxying enable to disable the IGMP snooping proxying function in a VLAN.

Syntax

igmp-snooping proxying enable

undo igmp-snooping proxying enable

Default

IGMP snooping proxying is disabled in all VLANs.

Views

VLAN view

Default command level

2: System level

Usage guidelines

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

Examples

# Enable IGMP snooping and then IGMP snooping proxying in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping proxying enable

Related commands

igmp-snooping enable

igmp-snooping pim-hello-proxy enable

Use igmp-snooping pim-hello-proxy enable to enable the PIM hello proxy.

Use undo igmp-snooping pim-hello-proxy enable to disable the PIM hello proxy.

Syntax

igmp-snooping pim-hello-proxy enable

undo igmp-snooping pim-hello-proxy enable

Default

The PIM hello proxy is disabled.

Views

VLAN view

Default command level

2: System level

Examples

# Enable the PIM hello proxy for VLAN 100.

<Sysname> system-view

[Sysname] vlan 100

[Sysname-vlan100]igmp-snooping pim-hello-proxy enable

igmp-snooping querier

Use igmp-snooping querier to enable the IGMP snooping querier function.

Use undo igmp-snooping querier to disable the IGMP snooping querier function.

Syntax

igmp-snooping querier

undo igmp-snooping querier

Default

The IGMP snooping querier function is disabled.

Views

VLAN view

Default command level

2: System level

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

This command does not take effect on a sub-VLAN of a multicast VLAN.

Examples

# Enable IGMP snooping and the IGMP snooping querier function for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping querier

Related commands

igmp-snooping enable

igmp-snooping query-interval

Use igmp-snooping query-interval to configure the interval for sending IGMP general queries.

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

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

Default

The IGMP general query interval is 60 seconds.

Views

VLAN view

Default command level

2: System level

Parameters

interval: Specifies an interval in seconds for sending IGMP general queries, in the range of 2 to 300.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# Enable IGMP snooping and set the interval for sending IGMP general queries to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping query-interval 20

Related commands

· igmp-snooping enable

· igmp-snooping max-response-time

· igmp-snooping querier

· max-response-time

igmp-snooping report source-ip

Use igmp-snooping report source-ip to configure the source IP address for the IGMP reports that the IGMP snooping proxy sends.

Use undo igmp-snooping report source-ip to restore the default.

Syntax

igmp-snooping report source-ip { ip-address | current-interface }

undo igmp-snooping report source-ip

Default

The source IP address of the IGMP reports that the IGMP snooping proxy sends is 0.0.0.0.

Views

VLAN view

Default command level

2: System level

Parameters

ip-address: Specifies a source address for the IGMP reports that the IGMP snooping proxy sends, which can be any legal IP address.

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP reports that the IGMP snooping proxy sends. If no IP address has been assigned to the current VLAN interface, the default IP address 0.0.0.0 is used.

Usage guidelines

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

The source IP address configured in the igmp-snooping report source-ip command also applies when the simulated host sends IGMP reports.

Examples

# On VLAN 2, enable IGMP snooping and configure the source IP address for IGMP reports that the IGMP snooping proxy sends to 10.1.1.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping report source-ip 10.1.1.1

Related commands

igmp-snooping enable

igmp-snooping router-aging-time

Use igmp-snooping router-aging-time to set the aging timer for the dynamic router ports in the current VLAN.

Use undo igmp-snooping router-aging-time to restore the default.

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

Default

The aging timer of the dynamic router ports is 105 seconds.

Views

VLAN view

Default command level

2: System level

Parameters

interval: Specifies an aging timer for the dynamic router ports in seconds, in the range of 1 to 1000.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# Enable IGMP snooping and set the aging timer for the dynamic router ports to 100 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping router-aging-time 100

Related commands

· igmp-snooping enable

· router-aging-time

igmp-snooping router-port-deny

Use igmp-snooping router-port-deny to disable a port from becoming a dynamic router port.

Use undo igmp-snooping router-port-deny to restore the default.

Syntax

igmp-snooping router-port-deny [ vlan vlan-list ]

undo igmp-snooping router-port-deny [ vlan vlan-list ]

Default

A port can become a dynamic router port.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

Usage guidelines

Examples

# Disable GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping router-port-deny vlan 2

igmp-snooping special-query source-ip

Use igmp-snooping special-query source-ip to configure the source IP address for IGMP group-specific queries.

Use undo igmp-snooping special-query source-ip to restore the default.

Syntax

igmp-snooping special-query source-ip { ip-address | current-interface }

undo igmp-snooping special-query source-ip

Default

The source IP address of IGMP group-specific queries is 0.0.0.0.

Views

VLAN view

Default command level

2: System level

Parameters

ip-address: Specifies a source address for IGMP group-specific queries.

current-interface: Specifies the address of the current VLAN interface as the source address of IGMP group-specific queries. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 is used as the source IP address of IGMP group-specific queries.

Usage guidelines

This command takes effect only if IGMP snooping is enabled in the VLAN.

Examples

# On VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1

Related commands

igmp-snooping enable

igmp-snooping static-group

Use igmp-snooping static-group to configure a port as a static member port of the specified multicast group or the specified multicast source and group.

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

Syntax

igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

Default

No ports are static member ports.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

group-address: Specifies the address of the multicast group that the port joins as a static member port, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies the address of the multicast source that the port joins as a static member port. The value of this argument should be a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

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

Usage guidelines

Configuration views for this command vary by device models. For more information, see About the H3C Access Controllers Command References.

The source-ip source-address option in the command is meaningful only for IGMPv3 snooping. If IGMPv2 snooping is running, the source-ip source-address option does not take effect although you can include source-ip source-address in the command.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 to be a static member port for the multicast source and group (1.1.1.1, 224.1.1.1).

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-group 224.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping static-router-port

Use igmp-snooping static-router-port to configure a port as a static router port.

Use undo igmp-snooping static-router-port to restore the default.

Syntax

igmp-snooping static-router-port vlan vlan-id

undo igmp-snooping static-router-port vlan vlan-id

Default

No ports are static router ports.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default command level

2: System level

Parameters

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

Usage guidelines

Configuration views for this command varies with devices. For more information, see About the H3C Access Controllers Command References.

This command does not take effect on a sub-VLAN of a multicast VLAN.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 as a static router port.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2

igmp-snooping version

Use igmp-snooping version to specify the IGMP snooping version.

Use undo igmp-snooping version to restore the default.

Syntax

igmp-snooping version version-number

undo igmp-snooping version

Default

The IGMP snooping version is IGMPv2 snooping.

Views

VLAN view

Default command level

2: System level

Parameters

version-number: Specifies an IGMP snooping version, in the range of 2 to 3.

Usage guidelines

This command can take effect only if IGMP snooping is enabled in the VLAN.

This command does not take effect on a sub-VLAN of a multicast VLAN.

Examples

# Enable IGMP snooping and specify the IGMP snooping version to IGMPv3 snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

Related commands

igmp-snooping enable

last-member-query-interval (IGMP-snooping view)

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

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

Syntax

last-member-query-interval interval

undo last-member-query-interval

Default

The default setting is 1 second.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

interval: Sets the IGMP last-member query interval in seconds, in the range of 1 to 5.

Usage guidelines

The IGMP last-member query interval determines the interval for sending IGMP group-specific queries and the maximum response delay for IGMP group-specific queries.

Examples

# Set the IGMP last-member query interval to 3 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

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

Related commands

igmp-snooping last-member-query-interval

max-response-time (IGMP-snooping view)

Use max-response-time to set the global maximum response delay for IGMP general queries.

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

Syntax

max-response-time interval

undo max-response-time

Default

The default setting is 10 seconds.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

interval: Sets the maximum response delay in seconds for IGMP general queries, in the range of 1 to 25.

Examples

# Set the global maximum response delay for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] max-response-time 5

Related commands

· igmp-snooping max-response-time

· igmp-snooping query-interval

overflow-replace (IGMP-snooping view)

Use overflow-replace to enable the multicast group replacement function globally.

Use undo overflow-replace to disable the multicast group replacement function globally.

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement function is disabled.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

Examples

# Enable the multicast group replacement function globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

Related commands

igmp-snooping overflow-replace

report-aggregation (IGMP-snooping view)

Use report-aggregation to enable IGMP report suppression.

Use undo report-aggregation to disable IGMP report suppression.

Syntax

report-aggregation

undo report-aggregation

Default

IGMP report suppression is enabled.

Views

IGMP-snooping view

Default command level

2: System level

Examples

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

reset igmp-snooping group

Use reset igmp-snooping group to remove the dynamic group entries for the specified IGMP snooping groups.

Syntax

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

Views

User view

Default command level

2: System level

Parameters

group-address: Specifies an IGMP snooping group. The value range for this argument is 224.0.1.0 to 239.255.255.255.

all: Specifies all IGMP snooping groups.

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

Usage guidelines

This command cannot remove the static group entries for IGMP snooping groups.

Examples

# Remove the dynamic group entries for all IGMP snooping groups.

<Sysname> reset igmp-snooping group all

reset igmp-snooping statistics

Use reset igmp-snooping statistics to clear statistics for the IGMP messages learned through IGMP snooping.

Syntax

reset igmp-snooping statistics

Views

User view

Default command level

2: System level

Examples

# Clear the statistics for all IGMP messages learned through IGMP snooping.

<Sysname> reset igmp-snooping statistics

router-aging-time (IGMP-snooping view)

Use router-aging-time to set the aging timer for the dynamic router ports globally.

Use undo router-aging-time to restore the default.

Syntax

router-aging-time interval

undo router-aging-time

Default

The aging timer of dynamic router ports is 105 seconds.

Views

IGMP-snooping view

Default command level

2: System level

Parameters

interval: Specifies an aging timer in seconds for the dynamic router ports, in the range of 1 to 1000.

Examples

# Set the aging timer for the dynamic router ports to 100 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] router-aging-time 100

Related commands

igmp-snooping router-aging-time

05-IP Multicast Command Reference

IGMP snooping configuration commands

display igmp-snooping group

dot1p-priority (IGMP-snooping view)

drop-unknown (IGMP-snooping view)

igmp-snooping host-tracking

router-aging-time (IGMP-snooping view)

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