igmp-snooping group-policy dot1q vid

Format

igmp-snooping group-policy { acl-number | acl-name acl-name } [ version number ] dot1q vid { vid1 [ to vid2 ] } &<1-10>

undo igmp-snooping group-policy [ { acl-number | acl-name acl-name } [ version number ] ] dot1q vid { vid1 [ to vid2 ] } &<1-10>

Parameters

Parameter	Description	Value
acl-number	Specifies the number of an ACL.	The value is an integer ranging from 2000 to 3999.
acl-name acl-name	Specifies the name of a named ACL.	The value is a string of 1 to 64 case-sensitive characters, spaces not supported. The name must start with a letter or digit, and cannot contain only digits.
version number	Specifies the version number of IGMP packets.	The value is an integer that is 1, 2, or 3.
vid1	Specifies the VLAN range of multicast groups to which the group policy will be applied. vlan-id1 specifies the start VLAN ID.	The value is an integer ranging from 1 to 4094.
to vid2	Specifies the VLAN range of multicast groups to which the group policy will be applied. to vlan-id2 specifies the end VLAN ID.If the to vlan-id2 parameter is not specified, the group policy is effective only for the multicast groups that have the specified start VLAN ID.	The value is an integer ranging from 1 to 4094. vlan-id2 must be greater than vlan-id1. vlan-id2 and vlan-id1 specify a VLAN range.

Views

100ge sub-interface view, 10GE sub-interface view, 200GE sub-interface view, 25GE sub-interface view, 400GE sub-interface view, 40GE sub-interface view, 50GE sub-interface view, Eth-Trunk sub-interface view, GE sub-interface view, Global VE sub-interface view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
l2mc	write

Usage Guidelines

Usage Scenario

The igmp-snooping group-policy command is used to limit the range of multicast groups that user hosts can join.

Prerequisites

IGMP snooping has been enabled globally and in a VLAN.

Rules have been configured for a specified basic ACL.

Configuration Impact

After the igmp-snooping group-policy command is run, user hosts cannot join multicast groups beyond the configured multicast group range. If the igmp-snooping group-policy command is run more than once, all configurations take effect.

Precautions

If no IGMP version is specified, the device will apply the configured group policy to all IGMP messages (IGMPv1/IGMPv2/IGMPv3 messages) and the ACL configured for the group policy must be a basic ACL.

Example

# Allow the user hosts connected to Dot1q VLAN tag termination sub-interface GE 0/1/1.1 to join only multicast group 225.1.1.123.

<HUAWEI> system-view
[~HUAWEI] igmp-snooping enable
[*HUAWEI] vlan 100
[*HUAWEI-vlan100] igmp-snooping enable
[*HUAWEI] acl number 2008
[*HUAWEI-acl-basic-2008] rule permit source 225.1.1.123 0
[*HUAWEI-acl-basic-2008] rule deny source any
[*HUAWEI-acl-basic-2008] quit
[*HUAWEI] interface GigabitEthernet 0/1/1.1
[*HUAWEI-GigabitEthernet0/1/1.1] igmp-snooping group-policy 2008 dot1q vid 100