igmp-snooping group-policy vlan

Function

The igmp-snooping group-policy vlan command limits the range of multicast groups that hosts in VLANs can join.

The undo igmp-snooping group-policy command cancels the configuration.

By default, hosts can join any multicast group.

Format

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

undo igmp-snooping group-policy [ { acl-number | acl-name acl-name } [ version number ] ] [ vlan { all | { 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.
version number	Specifies the version number of IGMP packets.	The value is an integer that is 1, 2, or 3.
vid1	Specifies the start VLAN ID.	The value is an integer ranging from 1 to 4094.
to vid2	Specifies the end VLAN ID.	The value is an integer ranging from 1 to 4094.
all	Indicates all VLANs.	-

Views

Layer 2 100GE interface view, Layer 2 10GE interface view, 25GE-L2 view, 400GE-L2 view, Layer 2 40GE interface view, Layer 2 50GE interface view, Eth-Trunk interface view, Layer 2 GE 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.

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 in VLAN10 matched the ACL a1 to join only multicast group 225.0.0.1 on a GE sub interface view.

<HUAWEI> system-view
[~HUAWEI] acl name a1
[*HUAWEI-acl4-advance-a1] rule 1 permit ip source any destination 225.0.0.1 0
[*HUAWEI-acl4-advance-a1] quit
[*HUAWEI] interface GigabitEthernet0/1/1.1
[*HUAWEI-GigabitEthernet 0/1/1.1] igmp-snooping group-policy acl-name a1 vlan 10