ip igmp access-group

Configures the Internet Group Management Protocol (IGMP) report filter policy globally, for a non-default virtual routing and forwarding (VRF) instance, or for an Interface.
Syntax
ip igmp access-group { acl-name | acl-number }
no ip igmp access-group { acl-name | acl-number }
Command Default

The IGMP report filter policy is not configured.

Parameters
acl-name
Specifies an ACL name.
acl-number
Specifies an ACL number. Valid values range from 1 through 199.
Modes

Global configuration mode

Interface subtype configuration mode

VRF configuration mode

Usage Guidelines

ACL rules are used to configure which multicast group addresses, source addresses, or report and leave messages are to be dropped or allowed. For standard ACLs, only multicast group addresses and prefixes are configured, because this ACL is used for group filtering only. For extended ACLs, multicast group addresses or prefixes are configured as destination IP prefixes and the source addresses and prefixes are configured as the source IP address and prefix.

If the specified ACL is not configured, the IGMP report messages for all multicast group addresses and source addresses are dropped.

If an IGMP report filter policy is configured both globally and at the interface level, only the interface filter is applied.

The no form of the command disables the configured IGMP report filter policy.

Examples

The following example configures the IGMP report filter policy globally. 

device# configure terminal
device(config)# ip igmp access-group test1-v4

The following example configures the IGMP report filter policy for a VE interface. 

device# configure terminal
device(config)# interface ve 10
device(config-vif-10)# ip igmp access-group test1-v4
History
Release version Command history
09.0.10 This command was introduced.
Parent topic: Commands I