igmp-snooping learning

Function

The igmp-snooping learning command enables learning of multicast group memberships on an interface.

The undo igmp-snooping learning command disables learning of multicast group memberships on an interface.

By default, learning of multicast group memberships is enabled on an interface.

Format

igmp-snooping learning vlan { { vlan-id1 [ to vlan-id2 ] } &<1-10> | all }

undo igmp-snooping learning vlan { { vlan-id1 [ to vlan-id2 ] } &<1-10> | all }

Parameters

Parameter	Description	Value
vlan { vlan-id1 [ to vlan-id2 ] }	Enables learning of multicast group memberships in specified VLANs. The interface must have been added to the specified VLAN. vlan-id1 [ to vlan-id2 ] specifies the range of VLAN IDs. vlan-id1: specifies the first VLAN ID. to vlan-id2: specifies the last VLAN ID. If to vlan-id2 is not specified, learning of multicast group memberships is enabled only in the VLAN specified by vlan-id1.	The values of vlan-id1 and vlan-id2 are integers that range from 1 to 4094. The value of vlan-id2 must be greater than the value of vlan-id1. The vlan-id1 and vlan-id2 parameters identify a range of VLANs.
all	Enables learning of multicast group memberships in all VLANs that an interface has joined.	-

Parameter

Description

Value

vlan { vlan-id1 [ to vlan-id2 ] }

Enables learning of multicast group memberships in specified VLANs. The interface must have been added to the specified VLAN.

vlan-id1 [ to vlan-id2 ] specifies the range of VLAN IDs.

vlan-id1: specifies the first VLAN ID.
to vlan-id2: specifies the last VLAN ID. If to vlan-id2 is not specified, learning of multicast group memberships is enabled only in the VLAN specified by vlan-id1.

The values of vlan-id1 and vlan-id2 are integers that range from 1 to 4094.

The value of vlan-id2 must be greater than the value of vlan-id1. The vlan-id1 and vlan-id2 parameters identify a range of VLANs.

all

Enables learning of multicast group memberships in all VLANs that an interface has joined.

Views

MultiGE interface view, Ethernet interface view, GE interface view, XGE interface view, 25GE interface view, 40GE interface view, 100GE interface view, port group view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A group member port is a user-side interface that connects to multicast group members. Group memberships can be learned dynamically or configured statically. After IGMP snooping is enabled in a VLAN, all interfaces in the VLAN are enabled to learn forwarding entries from multicast packets. An interface is identified as a dynamic group member port when it receives an IGMP Report message.

If users connected to an interface need to receive data of a fixed multicast group, the interface can be statically bound to the multicast group. In this case, run the undo igmp-snooping learning command on the interface to disable learning of group memberships. This reduces the system resources used for protocol packet exchange.

Prerequisites

IGMP snooping has been enabled globally using the igmp-snooping enable (system view) command.

Precautions

The configuration takes effect only when all the following conditions are met:

IGMP snooping is enabled in the VLAN using the igmp-snooping enable (VLAN view) command.
The interface belongs to the specified VLANs.

If you run the undo igmp-snooping learning command multiple times, all the configurations take effect.

Example

# Disable learning of group memberships in VLAN 3 and VLAN 4 on GE0/0/1.

<HUAWEI> system-view
[HUAWEI] igmp-snooping enable
[HUAWEI] vlan 3
[HUAWEI-vlan3] igmp-snooping enable
[HUAWEI-vlan3] quit
[HUAWEI] vlan 4
[HUAWEI-vlan4] igmp-snooping enable
[HUAWEI-vlan4] quit
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] port link-type trunk
[HUAWEI-GigabitEthernet0/0/1] port trunk allow-pass vlan 3 to 4
[HUAWEI-GigabitEthernet0/0/1] undo igmp-snooping learning vlan 3 to 4