The igmp group-policy command sets the filter for multicast groups on an interface to control the multicast groups that hosts can join.
The undo igmp group-policy command restores the default configuration.
| Parameter | Description | Value |
|---|---|---|
| acl-number | Specifies a basic or an advanced ACL that defines the range of a multicast group. | The basic ACL number ranges from 2000 to 2999, and the advanced ACL number ranges from 3000 to 3999. |
| 1 | Controls the multicast groups that IGMPv1 hosts can join. |
- |
| 2 | Controls the multicast groups that IGMPv2 hosts can join. |
- |
| 3 | Controls the multicast groups that IGMPv3 hosts can join. |
- |
By default, no filter is configured. A host can join any multicast group.
Before using the command, configure the ACL to be referenced for limiting the range of multicast groups hosts can join on this interface.
You must run the multicast routing-enable command to enable the multicast function before using the command.
After you run this command on the interface, the following situations occur:
The interface filters the received Report messages based on the ACL. It maintains membership only for the groups that match the ACL.
The interface does not accept the received Report messages for groups that do not match the ACL, nor does it immediately delete the entries of existing groups that do not match the ACL. Instead, the interface automatically deletes the entries when they time out.
If the IGMP version is not specified, the ACL applies to IGMPv1, IGMPv2, and IGMPv3 hosts.
In the basic ACL view, specify the source parameter in the rule command to set the range of multicast groups hosts can join on the interface.
In the advanced ACL view, specify the source parameter in the rule to set the range of sources that are allowed to send multicast data to multicast groups. Specify the destination parameter in the rule command to set the range of multicast groups hosts can join on the interface.
This command is cyclical in nature, meaning that the latest configuration overwrites the previous one.
# Create ACL 2005, and configure a rule for permitting hosts to receive messages from multicast group 225.1.1.1. Configure a filter on GE 1/0/0 to limit the attached hosts to joining only multicast group 225.1.1.1.
<sysname> system-view [sysname] multicast routing-enable [sysname] acl number 2005 [sysname-acl-basic-2005] rule permit source 225.1.1.1 0 [sysname-acl-basic-2005] quit [sysname] interface GigabitEthernet 0/0/0 [sysname-GigabitEthernet0/0/0] igmp group-policy 2005