igmp limit

Function

The igmp limit command sets the maximum number of IGMP group memberships that the current interface can maintain.

The undo igmp limit command deletes the set maximum number of IGMP group memberships that the current interface can maintain.

Format

igmp limit number [ except acl-number ]

undo igmp limit

Parameters

Parameter	Description	Value
number	Specifies the maximum number of IGMP entries that the current interface can create.	The value is an integer ranging from 1 to 2048. The number varies according to products.
except	Specifies the range of multicast groups whose IGMP entries do not need to be limited.	-
acl-number	Specifies the basic or advanced ACL.	Depends on the type of ACL. The basic ACL number ranges from 2000 to 2999. The basic ACL filters group addresses only, without distinguishing (*, G) entries and (S, G) entries. The advanced ACL number ranges from 3000 to 3999. The advanced ACL filters (S, G) entries of the interface only.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

When the number of IGMP entries reaches the limit, the system does not create any IGMP entries. To make the FW allow more new join requests, delete some useless entries or modify the limit. Alternatively, you can enable static addition to a multicast group or source group .

If except is not set in the command, the maximum number of IGMP entries corresponding to all the groups or source/groups is limited. Before setting except, configure the associated ACL. The interface then filters the received IGMP Join messages according to the ACL. The maximum number of entries corresponding to the multicast groups that match the ACL is not limited.

The igmp limit command and the acl command should be used together.

In the basic ACL view, specify the source parameter in the rule command for setting the range of multicast groups whose IGMP entries do not need to be limited.
In the advanced ACL view, specify the source parameter in the rule command for setting the range of sources that are allowed to send multicast data to the multicast groups. Specify the destination parameter in the rule command for setting the range of multicast groups whose IGMP entries do not need to be limited.

You must run the multicast routing-enable command to enable the multicast function before using the command.

This command is cyclical in nature. That is, the latest configuration overwrites the previous one.

Each of the following entries is counted as one IGMP entry:

(*, G) entry
(S, G) entry
(*, G) entry to which Source-Specific Multicast (SSM)-Mapping is applied

Example

# Set the maximum number of IGMP entries that can be created on GE 1/0/0 to 1024.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] igmp limit 1024