igmp group-policy

Use igmp group-policy to configure a multicast group policy on an interface to control the multicast groups that hosts attached to the interface can join.

Use undo igmp group-policy to delete the multicast group policy on an interface.

Syntax

igmp group-policy ipv4-acl-number [ version-number ]

undo igmp group-policy

Default

No multicast group policy exists on an interface. Hosts attached to the interface can join any multicast groups.

Views

Interface view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, hosts cannot join any multicast groups.

version-number: Specifies an IGMP version in the range of 1 to 3. By default, this command takes effect on IGMP reports of all versions.

Usage guidelines

A multicast group policy filters IGMP reports to control the multicast groups that the hosts can join.

This command does not take effect on static member interfaces because static member interfaces do not send IGMP reports.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Configure a multicast group policy on VLAN-interface 100 so that hosts attached to the interface can join only multicast group 225.1.1.1.

<Sysname> system-view
[Sysname] acl basic 2005
[Sysname-acl-ipv4-basic-2005] rule permit source 225.1.1.1 0
[Sysname-acl-ipv4-basic-2005] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp group-policy 2005