vlan vlan-id: Displays the IGMP snooping group information in the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command displays the IGMP snooping group information in all VLANs.

verbose: Displays the detailed IGMP snooping group information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display igmp-snooping group to display IGMP snooping group information, including both dynamic entries and static entries.

Examples

# Display detailed IGMP snooping group information in VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port(s).

GE1/0/1 (D) ( 00:01:30 )

IP group(s):the following ip group(s) match to one mac group.

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Port

Host port(s):total 1 port(s).

GE1/0/2 (D) ( 00:03:23 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):total 1 port(s).

GE1/0/2

Table 1 Command output

Field	Description
Total 1 IP Group(s).	Total number of IP multicast groups
Total 1 IP Source(s).	Total number of multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port	Port flags: · D—A dynamic port · S—A static port · C—A port copied from a (*, G) entry to an (S, G) entry · P—A port added by PIM snooping
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: · R—Real egress sub-VLAN under the current entry · C—Sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
( 00:01:30 )	Remaining time of the aging timer for the dynamic member port or router port
IP group address	Address of IP multicast group
MAC group address	Address of MAC multicast group
Attribute	Attribute of IP multicast group
Host port(s)	Number of member ports

display igmp-snooping host

Syntax

display igmp-snooping host vlan vlan-id group group-address [ source source-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays information about the hosts tracked by IGMP snooping in the specified VLAN, where vlan-id is in the range of 1 to 4094.

group group-address: Displays information about the hosts tracked by IGMP snooping that are in the specified IGMP snooping group. The value of group-address ranges from 224.0.1.0 to 239.255.255.255.

source source-address: Displays information about the hosts tracked by IGMP snooping that are in the specified multicast source, where source-address is a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display igmp-snooping host to display information about the hosts tracked by IGMP snooping.

Examples

# Display information about the hosts tracked by IGMP snooping in VLAN 2 that are in multicast group 224.1.1.1.

<Sysname> display igmp-snooping host vlan 2 group 224.1.1.1

VLAN(ID) : 2

(0.0.0.0, 224.1.1.1)

Port : GE1/0/1

Host Uptime Expires

1.1.1.1 00:02:20 00:00:40

2.2.2.2 00:02:21 00:00:39

Port : GE1/0/2

Host Uptime Expires

3.3.3.3 00:02:20 00:00:40

Table 2 Command output

Field	Description
VLAN(ID)	VLAN ID
(0.0.0.0, 224.1.1.1)	(S, G) entry, where "0.0.0.0" indicates all multicast sources
Port	Member port
Host	Host IP address
Uptime	Host running duration
Expires	Host expiration time, where "timeout" means that the host has expired

display igmp-snooping statistics

Syntax

display igmp-snooping statistics [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display igmp-snooping statistics to display the statistics information of IGMP messages learned through IGMP snooping.

Examples

# Display the statistics information of IGMP messages learned through IGMP snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries:0.

Received IGMPv1 reports:0.

Received IGMPv2 reports:19.

Received IGMP leaves:0.

Received IGMPv2 specific queries:0.

Sent IGMPv2 specific queries:0.

Received IGMPv3 reports:1.

Received IGMPv3 reports with right and wrong records:0.

Received IGMPv3 specific queries:0.

Received IGMPv3 specific sg queries:0.

Sent IGMPv3 specific queries:0.

Sent IGMPv3 specific sg queries:0.

Received error IGMP messages:19.

Table 3 Command output

Field	Description
general queries	General query messages
specific queries	Group-specific query messages
reports	Report messages
leaves	Leave messages
reports with right and wrong records	Report messages with correct and incorrect records
specific sg query packet(s)	Group-and-source-specific query message or messages
error IGMP messages	IGMP messages with errors

dot1p-priority (IGMP-snooping view)

Syntax

dot1p-priority priority-number

undo dot1p-priority

View

IGMP-snooping view

Default level

2: System level

Parameters

priority-number: Specifies 802.1p precedence for IGMP messages, in the range of 0 to 7. The higher the number, the higher the precedence.

Description

Use dot1p-priority to configure 802.1p precedence for IGMP messages globally.

Use undo dot1p-priority to restore the default.

The default 802.1p precedence for IGMP messages is 0.

Examples

# Set 802.1p precedence for IGMP messages to 3 globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] dot1p-priority 3

drop-unknown (IGMP-snooping view)

Syntax

drop-unknown

undo drop-unknown

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

Use drop-unknown to enable the function of dropping unknown multicast data globally.

Use undo drop-unknown to disable the function of dropping unknown multicast data globally.

By default, this function is disabled. That is, unknown multicast data is flooded.

Related commands: igmp-snooping drop-unknown.

Examples

# Enable the device to drop unknown multicast data globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] drop-unknown

fast-leave (IGMP-snooping view)

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

IGMP-snooping view

Default level

2: System level

Parameters

vlan vlan-list: Specifies one or multiple VLANs. You can provide up to 10 VLAN lists. For each list, you can specify an individual VLAN in the form of vlan-id, or a VLAN range in the form of start-vlan-id to end-vlan-id, where the end VLAN ID must be greater than the start VLAN ID. The effective range of a VLAN ID is 1 to 4094. If you do not specify any VLAN, the command takes effect for all VLANs. If you specify one or more VLANs, the command takes effect for the specified VLANs only.

Description

Use fast-leave to enable IGMP snooping fast-leave processing globally. With this function enabled, when the access controller receives an IGMP leave message on a port, it directly removes that port from the multicast forwarding entry of the specific group.

Use undo fast-leave to disable IGMP snooping fast-leave processing globally.

By default, IGMP snooping fast-leave processing is disabled.

This command works on IGMP snooping–enabled VLANs.

Related commands: igmp-snooping fast-leave.

Examples

# Enable IGMP snooping fast-leave processing globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

group-policy (IGMP-snooping view)

Syntax

group-policy acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

View

IGMP-snooping view

Default level

2: System level

Parameters

acl-number: Specifies a basic or advanced ACL number, in the range of 2000 to 3999.

Description

Use group-policy to configure a global multicast group filter, namely, to control the multicast groups that a host can join.

Use undo group-policy to remove the configured global multicast group filter.

By default, no global multicast group filter is configured. Namely, a host can join any multicast group.

This command works on IGMP snooping–enabled VLANs.

If the specified ACL does not exist or the ACL rule is null, all multicast groups are filtered out.

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule overrides the existing one.

Related commands: igmp-snooping group-policy.

Examples

# Apply ACL 2000 as a multicast group filter in VLAN 2 so that hosts in this VLAN can join 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] igmp-snooping

[Sysname-igmp-snooping] group-policy 2000 vlan 2

host-aging-time (IGMP-snooping view)

Syntax

host-aging-time interval

undo host-aging-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Specifies an aging timer for the dynamic member ports in seconds. The value ranges from 200 to 1000.

Description

Use host-aging-time to configure the aging timer for the dynamic member ports globally.

Use undo host-aging-time to restore the default.

By default, the aging timer of the dynamic member ports is 260 seconds.

Related commands: igmp-snooping host-aging-time.

Examples

# Set the aging time for the dynamic member ports to 300 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-aging-time 300

host-tracking (IGMP-snooping view)

Syntax

host-tracking

undo host-tracking

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

Use host-tracking to enable the IGMP snooping host tracking function globally.

Use undo host-tracking to disable the IGMP snooping host tracking function globally.

By default, this function is disabled.

This command works only on IGMP snooping–enabled VLANs.

Related commands: igmp-snooping host-tracking.

Examples

# Enable the IGMP snooping host tracking function globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-tracking

igmp-snooping

Syntax

igmp-snooping

undo igmp-snooping

View

System view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

By default, IGMP snooping is disabled.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping globally and enter IGMP-snooping view.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

igmp-snooping dot1p-priority

Syntax

igmp-snooping dot1p-priority priority-number

undo igmp-snooping dot1p-priority

View

VLAN view

Default level

2: System level

Parameters

priority-number: Specifies 802.1p precedence for IGMP messages, in the range of 0 to 7. The higher the number, the higher the precedence.

Description

Use igmp-snooping dot1p-priority to configure 802.1p precedence for IGMP messages in a VLAN.

Use undo igmp-snooping dot1p-priority to restore the default.

The default 802.1p precedence for IGMP messages is 0.

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping in VLAN 2 and set 802.1p precedence for IGMP messages in the VLAN to 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping dot1p-priority 3

igmp-snooping drop-unknown

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping drop-unknown to enable the function of dropping unknown multicast data in the current VLAN.

Use undo igmp-snooping drop-unknown to disable the function of dropping unknown multicast data in the current VLAN.

By default, this function is disabled. That is, unknown multicast data is flooded.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: drop-unknown and igmp-snooping enable.

Examples

# In VLAN 2, enable IGMP snooping and the function of dropping unknown multicast data.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping drop-unknown

igmp-snooping enable

Syntax

igmp-snooping enable

undo igmp-snooping enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping enable to enable IGMP snooping in the current VLAN.

Use undo igmp-snooping enable to disable IGMP snooping in the current VLAN.

By default, IGMP snooping is disabled in a VLAN.

IGMP snooping must be enabled globally before it can be enabled in a VLAN.

Related commands: igmp-snooping.

Examples

# Enable IGMP snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

igmp-snooping fast-leave

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use igmp-snooping fast-leave to enable IGMP snooping fast-leave processing on the current port. When this function is enabled on a port and the access controller receives an IGMP leave message through a port, it directly removes that port from the multicast forwarding entry of the specific group.

Use undo igmp-snooping fast-leave to disable IGMP snooping fast-leave processing on the current port.

By default, IGMP snooping fast-leave processing is disabled.

This command works on IGMP snooping–enabled VLANs.

If you do not specify any VLAN when using this command in Layer 2 Ethernet interface view or Layer 2 aggregate interface view, the command takes effect for all VLANs that the interface belongs to. If you specify one or more VLANs, the command takes effect for the specified VLANs that the interface belongs to.

If you do not specify any VLAN when using this command in port group view, the command takes effect on all the ports in this group. If you specify one or more VLANs, the command takes effect only on those ports in this group that belong to the specified VLANs.

Related commands: fast-leave.

NOTE:

Support for this command depends on the device model. For the command matrixes, see About the WX Series Access Controllers Command References.

Examples

# Enable IGMP snooping fast-leave processing on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2

igmp-snooping general-query source-ip

Syntax

igmp-snooping general-query source-ip { ip-address | current-interface }

undo igmp-snooping general-query source-ip

View

VLAN view

Default level

2: System level

Parameters

ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.

current-interface: Sets the source address of IGMP general queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 is used as the source IP address of IGMP general queries.

Description

Use igmp-snooping general-query source-ip to configure the source address of IGMP general queries.

Use undo igmp-snooping general-query source-ip to restore the default.

By default, the source IP address of IGMP general queries is 0.0.0.0.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable.

Examples

# In VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1

igmp-snooping group-limit

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ]

undo igmp-snooping group-limit [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

limit: Specifies the maximum number of multicast groups that a port can join. The value range depends on the device model. For more information, see About the WX Series Access Controllers Command References.

vlan vlan-list: Specifies one or multiple VLANs. You can provide up to 10 VLAN lists. For each list, you can specify an individual VLAN in the form of vlan-id, or a VLAN range in the form of start-vlan-id to end-vlan-id, where the end VLAN ID must be greater than the start VLAN ID. The effective range of a VLAN ID is 1 to 4094. If the vlan vlan-list option is not provided, this configuration limits the maximum number of multicast groups that a port can join in each VLAN that the port belongs to.

Description

Use igmp-snooping group-limit to set the maximum number of multicast groups that a port can join.

Use undo igmp-snooping group-limit to restore the default.

The default upper limit depends on the device model. For more information, see About the WX Series Access Controllers Command References.

This command works on IGMP snooping–enabled VLANs.

Related commands: igmp group-limit.

NOTE:

Support for this command depends on the device model. For the command matrixes, see About the WX Series Access Controllers Command References.

Examples

# Allow GigabitEthernet 1/0/1 in VLAN 2 to join up to 10 multicast groups.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2

igmp-snooping group-policy

Syntax

igmp-snooping group-policy acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

acl-number: Specifies a basic ACL number, in the range of 2000 to 3999.

Description

Use igmp-snooping group-policy to configure a multicast group filter on the current port, namely, to control the multicast groups that the port can join.

Use undo igmp-snooping group-policy to remove a multicast group filter on the current port.

By default, no multicast group filter is configured on an interface. Namely a host can join any valid multicast group.

This command works on IGMP snooping–enabled VLANs.

If you do not specify any VLAN when using this command in Layer 2 Ethernet interface view or Layer 2 aggregate interface view, the command takes effect for all VLANs the interface belongs to. If you specify one or more VLANs, the command takes effect for the specified VLANs that the interface belongs to.

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule overrides the existing one.

Related commands: group-policy.

Examples

# Apply ACL 2000 as a multicast group filter so that hosts on GigabitEthernet 1/0/1 in VLAN 2 can join 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2

igmp-snooping host-aging-time

Syntax

igmp-snooping host-aging-time interval

undo igmp-snooping host-aging-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies an aging timer for the dynamic member ports in seconds. The value ranges from 200 to 1000.

Description

Use igmp-snooping host-aging-time to configure the aging timer for the dynamic member ports in the current VLAN.

Use undo igmp-snooping host-aging-time to restore the default.

By default, the aging timer of the dynamic member ports is 260 seconds.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: host-aging-time and igmp-snooping enable.

Examples

# Enable IGMP snooping and set the aging timer for the dynamic member ports to 300 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-aging-time 300

igmp-snooping host-join

Syntax

igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

group-address: Specifies the address of the multicast group that the simulated host will join, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies the address of the multicast source that the simulated host will join. This argument must be a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

vlan vlan-id: Specifies the VLAN that comprises the port, where vlan-id is in the range of 1 to 4094.

Description

Use igmp-snooping host-join to enable simulated joining on a port. Namely, you configure the current port as a simulated member host for the specified multicast group or multicast source group.

Use undo igmp-snooping host-join to remove the simulated member host from the specified multicast group or source and group.

By default, this function is disabled.

This command works on IGMP snooping–enabled VLANs.

The source-ip source-address option in the command is meaningful only for IGMPv3 snooping. If IGMPv2 snooping is running, the source-ip source-address option does not take effect although you can include source-ip source-address in the command.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host in VLAN 2 for multicast source and group (1.1.1.1, 224.1.1.1).

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 224.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping host-tracking

Syntax

igmp-snooping host-tracking

undo igmp-snooping host-tracking

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping host-tracking to enable the IGMP snooping host tracking function in a VLAN.

Use undo igmp-snooping host-tracking to disable the IGMP snooping host tracking function in a VLAN.

By default, this function is disabled.

Before you configure this command, enable IGMP snooping in the VLAN first.

Related commands: host-tracking and igmp-snooping enable.

Examples

# Enable IGMP snooping and IGMP snooping host tracking in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-tracking

igmp-snooping last-member-query-interval

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies an interval between IGMP last-member queries, in seconds. The value ranges from 1 to 5.

Description

Use igmp-snooping last-member-query-interval to configure the interval between IGMP last-member queries in the VLAN.

Use undo igmp-snooping last-member-query-interval to restore the default.

By default, the IGMP last-member query interval is 1 second.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable and last-member-query-interval.

Examples

# Enable IGMP snooping and set the interval between IGMP last-member queries to 3 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping last-member-query-interval 3

igmp-snooping leave source-ip

Syntax

igmp-snooping leave source-ip { ip-address | current-interface }

undo igmp-snooping leave source-ip

View

VLAN view

Default level

2: System level

Parameters

ip-address: Specifies a source address for the IGMP leave messages sent by the IGMP snooping proxy, which can be any legal IP address.

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP leave messages sent by the IGMP snooping proxy. If no IP address has been assigned to the current VLAN interface, the default IP address 0.0.0.0 is used.

Description

Use igmp-snooping leave source-ip to configure the source IP address of the IGMP leave messages that the IGMP snooping proxy sends.

Use undo igmp-snooping leave source-ip to restore the default.

By default, the source IP address of the IGMP leave messages that the IGMP snooping proxy sends is 0.0.0.0.

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

The source IP address configured in the igmp-snooping leave source-ip command also applies when the simulated host sends IGMP leave messages.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping in VLAN 2 and configure the source IP address of IGMP leave messages sent by the IGMP snooping proxy in VLAN 2 to 10.1.1.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping leave source-ip 10.1.1.1

igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies the maximum response time for IGMP general queries, in seconds. The value ranges from 1 to 25.

Description

Use igmp-snooping max-response-time to configure the maximum response time for IGMP general queries in the VLAN.

Use undo igmp-snooping max-response-time to restore the default.

By default, the maximum response time for IGMP general queries is 10 seconds.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable, igmp-snooping query-interval, and max-response-time.

Examples

# Enable IGMP snooping and set the maximum response time for IGMP general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping max-response-time 5

igmp-snooping overflow-replace

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use igmp-snooping overflow-replace to enable the multicast group replacement function on the current port.

Use undo igmp-snooping overflow-replace to disable the multicast group replacement function on the current port.

By default, the multicast group replacement function is disabled.

This command works on IGMP snooping–enabled VLANs.

Related commands: overflow-replace.

Examples

# Enable the multicast group replacement function on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2

igmp-snooping proxying enable

Syntax

igmp-snooping proxying enable

undo igmp-snooping proxying enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping proxying enable to enable the IGMP snooping proxying function in a VLAN.

Use undo igmp-snooping proxying enable to disable the IGMP snooping proxying function in a VLAN.

By default, IGMP snooping proxying is disabled in all VLANs.

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping and then IGMP snooping proxying in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping proxying enable

igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use igmp-snooping querier to enable the IGMP snooping querier function.

Use undo igmp-snooping querier to disable the IGMP snooping querier function.

By default, the IGMP snooping querier function is disabled.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping and the IGMP snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping querier

igmp-snooping query-interval

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies the interval between IGMP general queries in seconds. The value ranges from 2 to 300.

Description

Use igmp-snooping query-interval to configure the interval between IGMP general queries.

Use undo igmp-snooping query-interval to restore the default.

By default, the IGMP general query interval is 60 seconds.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable, igmp-snooping max-response-time, igmp-snooping querier, and max-response-time.

Examples

# Enable IGMP snooping and set the interval between IGMP general queries to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping query-interval 20

igmp-snooping report source-ip

Syntax

igmp-snooping report source-ip { ip-address | current-interface }

undo igmp-snooping report source-ip

View

VLAN view

Default level

2: System level

Parameters

ip-address: Specifies a source address for the IGMP reports sent by the IGMP snooping proxy, which can be any legal IP address.

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP reports sent by the IGMP snooping proxy. If no IP address has been assigned to the current VLAN interface, the default IP address 0.0.0.0 is used.

Description

Use igmp-snooping report source-ip to configure the source IP address of the IGMP reports that the IGMP snooping proxy sends.

Use undo igmp-snooping report source-ip to restore the default.

By default, the source IP address of the IGMP reports that the IGMP snooping proxy sends is 0.0.0.0.

Before you configure this command in a VLAN, enable IGMP snooping in the VLAN.

The source IP address configured in the igmp-snooping report source-ip command also applies when the simulated host sends IGMP reports.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping in VLAN 2 and configure the source IP address of IGMP reports sent by the IGMP snooping proxy in VLAN 2 to 10.1.1.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping report source-ip 10.1.1.1

igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies an aging timer for the dynamic router ports in seconds. The value ranges from 1 to 1000.

Description

Use igmp-snooping router-aging-time to configure the aging timer for the dynamic router ports in the current VLAN.

Use undo igmp-snooping router-aging-time to restore the default.

By default, the aging timer of the dynamic router ports is 105 seconds.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable and router-aging-time.

Examples

# Enable IGMP snooping and set the aging timer for the dynamic router ports to 100 seconds in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping router-aging-time 100

igmp-snooping router-port-deny

Syntax

igmp-snooping router-port-deny [ vlan vlan-list ]

undo igmp-snooping router-port-deny [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use igmp-snooping router-port-deny to disable a port from becoming a dynamic router port.

Use undo igmp-snooping router-port-deny to restore the default.

By default, a port can become a dynamic router port.

This command works only on IGMP snooping–enabled VLANs.

Examples

# Disable GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping router-port-deny vlan 2

igmp-snooping special-query source-ip

Syntax

igmp-snooping special-query source-ip { ip-address | current-interface }

undo igmp-snooping special-query source-ip

View

VLAN view

Default level

2: System level

Parameters

ip-address: Specifies a source address for IGMP group-specific queries.

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP group-specific queries. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 is used as the source IP address of IGMP group-specific queries.

Description

Use igmp-snooping special-query source-ip to configure the source IP address of IGMP group-specific queries.

Use undo igmp-snooping special-query source-ip to restore the default.

By default, the source IP address of IGMP group-specific queries is 0.0.0.0.

This command takes effect only if IGMP snooping is enabled in the VLAN.

Related commands: igmp-snooping enable.

Examples

# In VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1

igmp-snooping static-group

Syntax

igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

group-address: Specifies the address of the multicast group that the port will join statically, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies the address of the multicast source that the port will join statically. This argument must be a valid unicast address or 0.0.0.0. A source IP address of 0.0.0.0 specifies all multicast sources.

vlan vlan-id: Specifies the VLAN that comprises the port, where vlan-id is in the range of 1 to 4094.

Description

Use igmp-snooping static-group to configure the static member ports. Namely, you can configure the current port as a static member port of a multicast group or multicast source-group.

Use undo igmp-snooping static-group to remove the port from the multicast group or multicast source-group.

By default, no ports are static member ports.

This command works on IGMP snooping–enabled VLANs.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

NOTE:

Support for this command depends on the device model. For the command matrixes, see About the WX Series Access Controllers Command References.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 to be a static member port of (1.1.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-group 224.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping static-router-port

Syntax

igmp-snooping static-router-port vlan vlan-id

undo igmp-snooping static-router-port vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

vlan vlan-id: Specifies a VLAN, where vlan-id is in the range of 1 to 4094.

Description

Use igmp-snooping static-router-port to configure the current port as a static router port.

Use undo igmp-snooping static-router-port to cancel the configuration.

By default, no ports are static router ports.

This command does not take effect in a sub-VLAN of a multicast VLAN.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the interface belongs to the specified VLAN.

In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

NOTE:

Support for this command depends on the device model. For the command matrixes, see About the WX Series Access Controllers Command References.

Examples

# Enable the static router port function on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2

igmp-snooping version

Syntax

igmp-snooping version version-number

undo igmp-snooping version

View

VLAN view

Default level

2: System level

Parameters

version-number: Specifies an IGMP snooping version, in the range of 2 to 3.

Description

Use igmp-snooping version to configure the IGMP snooping version.

Use undo igmp-snooping version to restore the default.

By default, the IGMPv2 snooping is used.

This command can take effect only if IGMP snooping is enabled in the VLAN.

This command does not take effect in a sub-VLAN of a multicast VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping in VLAN 2, and specify IGMPv3 snooping.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

last-member-query-interval (IGMP-snooping view)

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Specifies an interval between IGMP last-member queries in seconds. The value ranges from 1 to 5.

Description

Use last-member-query-interval to configure the interval between IGMP last-member queries globally.

Use undo last-member-query-interval to restore the default.

By default, the interval between IGMP last-member queries is 1 second.

This command works only on IGMP snooping–enabled VLANs.

Related commands: igmp-snooping last-member-query-interval.

Examples

# Set the interval between IGMP last-member queries to 3 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] last-member-query-interval 3

max-response-time (IGMP-snooping view)

Syntax

max-response-time interval

undo max-response-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Specifies the maximum response time for IGMP general queries, in seconds. The value ranges from 1 to 25.

Description

Use max-response-time to configure the maximum response time for IGMP general queries globally.

Use undo max-response-time to restore the default.

This command works only on IGMP snooping–enabled VLANs.

Related commands: igmp-snooping max-response-time and igmp-snooping query-interval.

Examples

# Set the maximum response time for IGMP general queries to 5 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] max-response-time 5

overflow-replace (IGMP-snooping view)

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

IGMP-snooping view

Default level

2: System level

Parameters

Description

Use overflow-replace to enable the multicast group replacement function globally.

Use undo overflow-replace to disable the multicast group replacement function globally.

By default, the multicast group replacement function is disabled.

This command works only on IGMP snooping–enabled VLANs.

If you do not specify any VLAN, the command takes effect for all VLANs; if you specify a VLAN or multiple VLANs, the command takes effect for the specified VLANs only.

Related commands: igmp-snooping overflow-replace.

Examples

# Enable the multicast group replacement function globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

report-aggregation (IGMP-snooping view)

Syntax

report-aggregation

undo report-aggregation

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

Use report-aggregation to enable IGMP report suppression.

Use undo report-aggregation to disable IGMP report suppression.

By default, IGMP report suppression is enabled.

This command works only on IGMP snooping–enabled VLANs.

Examples

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

reset igmp-snooping group

Syntax

reset igmp-snooping group { group-address | all } [ vlan vlan-id ]

View

User view

Default level

2: System level

Parameters

group-address: Specifies an IGMP snooping group. The value range of group-address is 224.0.1.0 to 239.255.255.255.

all: Specifies all IGMP snooping groups.

vlan vlan-id: Specifies a VLAN, where vlan-id is in the range of 1 to 4094.

Description

Use reset igmp-snooping group to remove the dynamic group entries of a specific IGMP snooping group or all IGMP snooping groups.

This command works only on IGMP snooping–enabled VLANs.

This command cannot remove the static group entries of IGMP snooping groups.

Examples

# Remove the dynamic group entries of all IGMP snooping groups.

<Sysname> reset igmp-snooping group all

reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Default level

2: System level

Parameters

None

Description

Use reset igmp-snooping statistics to clear the statistics information of IGMP messages learned through IGMP snooping.

Examples

# Clear the statistics information of all kinds of IGMP messages learned through IGMP snooping.

<Sysname> reset igmp-snooping statistics

router-aging-time (IGMP-snooping view)

Syntax

router-aging-time interval

undo router-aging-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Specifies an aging timer for the dynamic router port in seconds. The value ranges from 1 to 1000.

Description

Use router-aging-time to configure the aging timer for the dynamic router ports globally.

Use undo router-aging-time to restore the default.

By default, the aging timer of dynamic router ports is 105 seconds.

This command works only on IGMP snooping–enabled VLANs.

Related commands: igmp-snooping router-aging-time.

Examples

# Set the aging timer for the dynamic router ports to 100 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] router-aging-time 100

05-IP Multicast Command Reference

IGMP snooping configuration commands

display igmp-snooping group

dot1p-priority (IGMP-snooping view)

drop-unknown (IGMP-snooping view)

fast-leave (IGMP-snooping view)

group-policy (IGMP-snooping view)

host-aging-time (IGMP-snooping view)

host-tracking (IGMP-snooping view)

igmp-snooping dot1p-priority

igmp-snooping enable

igmp-snooping fast-leave

igmp-snooping group-policy

igmp-snooping host-aging-time

igmp-snooping host-tracking

igmp-snooping leave source-ip

igmp-snooping overflow-replace

igmp-snooping proxying enable

igmp-snooping query-interval

igmp-snooping router-port-deny

igmp-snooping static-group

max-response-time (IGMP-snooping view)

overflow-replace (IGMP-snooping view)

report-aggregation (IGMP-snooping view)

router-aging-time (IGMP-snooping view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us