igmp-snooping group-policy (VLAN view)

Function

The igmp-snooping group-policy command limits the range of multicast groups that hosts 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 ]

undo igmp-snooping group-policy

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.

Views

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

This command fails to be run in a VLAN when a dot1q termination sub-interface has been added to the VLAN.

Example

# Allow the user hosts in VLAN 100 to join only multicast group 225.1.1.123.
<HUAWEI> system-view
[~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] vlan 100 e-tree
[*HUAWEI-vlan-100] igmp-snooping enable
[*HUAWEI-vlan-100] igmp-snooping group-policy 2008
Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >