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.

slot slot-number: Displays information about IGMP snooping groups on the specified device. The slot-number argument refers to the number of the slot where the device resides, and it s value is 1.

verbose: Displays the detailed IGMP snooping group information.

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

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

exclude: Displays all lines that do not match the specified regular expression.

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

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

Description

Use the display igmp-snooping group command to view the IGMP snooping group information.

Examples

# Display the 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

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

(0.0.0.0, 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 Output description

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	Port flags: D for a dynamic port, S for a static port, C for a port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for real egress sub-VLAN under the current entry, C for 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
(0.0.0.0, 224.1.1.1)	An (S, G) entry, where 0.0.0.0 implies any multicast source
MAC group address	Address of MAC multicast group
Attribute	Attribute of IP multicast group
Host port(s)	Number of member ports

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 the Fundamentals Configuration Guide.

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

exclude: Displays all lines that do not match the specified regular expression.

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

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

Description

Use the display igmp-snooping statistics command to view the statistics information of IGMP messages learned by IGMP snooping.

Examples

# Display the statistics information of IGMP messages learned by 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 2 Output description

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

display mac-address multicast

Syntax

display mac-address [ mac-address [ vlan vlan-id ] | [ multicast ] [ vlan vlan-id ] [ count ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

mac-address: Displays the multicast MAC address entry for the specified MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where x represents an arbitrary hexadecimal number from 0 to F.

vlan vlan-id: Displays multicast MAC address entries for the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command will display the static multicast MAC address entries for all VLANs.

multicast: Displays static multicast MAC address entries.

count: Displays the number of matched static multicast MAC address entries. With this argument specified, the number of matched static multicast MAC address entries is displayed, without displaying any content of the matched entries.

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

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

exclude: Displays all lines that do not match the specified regular expression.

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

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

Description

Use the display mac-address multicast command to display the static multicast MAC address entries.

With no parameters specified or with only vlan, count, or both of them specified, this command displays all MAC address table entries, including static multicast MAC address entries and unicast MAC address entries.

Related commands: mac-address multicast; display mac-address (Layer 2—LAN Switching Command Reference).

Examples

# Display the static multicast MAC address entries for VLAN 2.

<Sysname> display mac-address multicast vlan 2

MAC ADDR VLAN ID STATE PORT INDEX AGING TIME(s)

0100-0001-0001 2 Multicast GigabitEthernet1/0/1 NOAGED

GigabitEthernet1/0/2

GigabitEthernet1/0/3

GigabitEthernet1/0/4

--- 1 mac address(es) found ---

Table 3 Table 1 Output description

Field	Description
MAC ADDR	MAC address
VLAN ID	ID of the VLAN to which the network device identified by the MAC address belongs
STATE	Status of the MAC address; multicast indicates a static multicast MAC address entry
PORT INDEX	Outgoing ports of the multicast MAC address entry
AGING TIME(s)	State of the aging timer. The aging timer for static multicast MAC addresses has only one state NOAGED, which indicates that this entry never expires
1 mac address(es) found	One static multicast MAC address entry is found.

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 the dot1p-priority command to configure 802.1p precedence for IGMP messages globally.

Use the undo dot1p-priority command 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

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 the fast-leave command to enable fast leave processing globally. With this function enabled, when the switch receives an IGMP leave message on a port, it directly removes that port from the multicast forwarding entry of the specific group.

Use the undo fast-leave command to disable fast leave processing globally.

By default, fast leave processing is disabled.

This command works only on IGMP snooping-enabled VLANs.

Related commands: igmp-snooping fast-leave.

Examples

# Enable 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: Basic or advanced ACL number, in the range of 2000 to 3999. The source address or address range specified in the advanced ACL rule matches the multicast source addresses specified in IGMPv3 reports, rather than the source address in the IP packets. The system assumes that an IGMPv1 or IGMPv2 report or an IGMPv3 IS_EX or TO_EX report that does not carry a multicast source address carries a multicast source address of 0.0.0.0.

Description

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

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

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

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

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule will override 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: Dynamic member port aging time, in seconds. The effective range is 200 to 1,000.

Description

Use the host-aging-time command to configure the aging time of dynamic member ports globally.

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

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

This command works only on IGMP snooping–enabled VLANs

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

igmp-snooping

Syntax

igmp-snooping

undo igmp-snooping

View

System view

Default level

2: System level

Parameters

None

Description

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

Use the undo igmp-snooping command 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 the igmp-snooping dot1p-priority command to configure 802.1p precedence for IGMP messages in a VLAN.

Use the undo igmp-snooping dot1p-priority command 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 the igmp-snooping drop-unknown command to enable the function of dropping unknown multicast data in the current VLAN.

Use the undo igmp-snooping drop-unknown command 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: 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 the igmp-snooping enable command to enable IGMP snooping in the current VLAN.

Use the undo igmp-snooping enable command 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

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

Default level

2: System level

Parameters

Description

Use the igmp-snooping fast-leave command to enable fast leave processing on the current port or group of ports. With this function enabled, when the switch receives an IGMP leave message on a port, it directly removes that port from the multicast forwarding entry of the specific group.

Use the undo igmp-snooping fast-leave command to disable fast leave processing on the current port or group of ports.

By default, fast leave processing is disabled.

This command works only on IGMP snooping–enabled VLANs.

If you do not specify any VLAN when using this command in 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 VLAN or 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 VLAN or VLANs.

Related commands: fast-leave.

Examples

# Enable 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 will be used as the source IP address of IGMP general queries.

Description

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

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

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

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

Default level

2: System level

Parameters

limit: Maximum number of multicast groups that a port can join. The value ranges from 1 to 256.

Description

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

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

The default upper limit is 256.

Related commands: igmp group-limit.

Examples

# Specify to 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

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

Default level

2: System level

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. The source address or address range specified in the advanced ACL rule matches the multicast source address or addresses specified in IGMPv3 reports, rather than the source address in the IP packets. The system assumes that an IGMPv1 or IGMPv2 report or an IGMPv3 IS_EX and TO_EX report that does not carry a multicast source address carries a multicast source address of 0.0.0.0.

Description

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

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

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

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

You can configure different ACL rules for a port in different VLANs. For a given VLAN, a newly configured ACL rule will override 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: Dynamic member port aging time, in seconds. The effective range is 200 to 1,000.

Description

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

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

By default, the aging time of 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 time of 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

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

Default level

2: System level

Parameters

group-address: 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: Address of the multicast source that the simulated host will join. The value of this argument should 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 or ports, where vlan-id is in the range of 1 to 4094.

Description

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

Use the undo igmp-snooping host-join command to remove the current port or ports as simulated member host or hosts for the specified multicast group or source and group.

By default, this function is disabled.

This command works only on IGMP snooping–enabled VLANs. The version of IGMP on the simulated host is consistent with the version of IGMP snooping running in the VLAN.

The source-ip source-address option in the command is meaningful only for IGMP snooping version 3. If IGMP snooping version 2 is running, although you can include source-ip source-address in the command, the simulated host does not respond to a query message.

If configured in Ethernet interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface belongs to the specified VLAN.

If configured in port group view, this feature 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 1.1.1.1 and multicast group 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 host-join 232.1.1.1 source-ip 1.1.1.1 vlan 2

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: Interval between IGMP last-member queries, in seconds. The effective range is 1 to 5.

Description

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

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

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 the igmp-snooping leave source-ip command to configure the source IP address of the IGMP leave messages sent by the IGMP snooping proxy.

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

By default, the source IP address of the IGMP leave messages sent by the IGMP snooping proxy 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: Maximum response time to IGMP general queries, in seconds. The effective range is 1 to 25.

Description

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

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

By default, the maximum response time to 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 to 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

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

Default level

2: System level

Parameters

Description

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

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

By default, the multicast group replacement function is disabled.

This command works only 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 the igmp-snooping proxying enable command to enable the IGMP snooping proxying function in a VLAN.

Use the undo igmp-snooping proxying enable command 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 the igmp-snooping querier command to enable the IGMP snooping querier function.

Use the undo igmp-snooping querier command 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: Interval between IGMP general queries, in seconds. The effective range is 2 to 300.

Description

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

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

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 the igmp-snooping report source-ip command to configure the source IP address of the IGMP reports sent by the IGMP snooping proxy.

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

By default, the source IP address of the IGMP reports sent by the IGMP snooping proxy 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: Dynamic router port aging time, in seconds. The effective range is 1 to 1,000.

Description

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

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

By default, the aging time of 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 time of 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

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

Default level

2: System level

Parameters

Description

Use the igmp-snooping router-port-deny command to disable a port or a group of ports from changing into dynamic router ports.

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

By default, a port can change into a dynamic router port.

This command works only on IGMP snooping–enabled VLANs.

Examples

# Disable GigabitEthernet 1/0/1 from changing into 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 source-deny

Syntax

igmp-snooping source-deny

undo igmp-snooping source-deny

View

Ethernet interface view, port group view

Default level

2: System level

Parameters

None

Description

Use the igmp-snooping source-deny command to enable multicast source port filtering.

Use the undo igmp-snooping source-deny command to disable multicast source port filtering.

By default, multicast source port filtering is disabled.

This command works only on IGMP snooping–enabled VLANs.

Examples

# Enable source port filtering for multicast data on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping source-deny

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: Sets the source address of IGMP group-specific queries to the specified address.

current-interface: Sets the source address of IGMP group-specific 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 will be used as the source IP address of IGMP group-specific queries.

Description

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

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

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

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

Default level

2: System level

Parameters

group-address: Address of the multicast group to be statically joined, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Address of the multicast source to be statically joined. The value of this argument should 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 or ports, where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping static-group command to configure the static (*, G) or (S, G) joining function. Namely, you can configure the current port or port group as static multicast group or source-group member(s).

Use the undo igmp-snooping static-group command to restore the system default.

By default, no ports are static member ports.

The source-ip source-address option in the command is meaningful only for IGMP snooping version 3. If IGMP snooping version 2 is running, although you can include the source-ip source-address option in your command, the configuration will not take effect.

If configured in Ethernet interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface belongs to the specified VLAN.

If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 to be a static member port for (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 232.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

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

Default level

2: System level

Parameters

vlan vlan-id: Specifies a VLAN in which one or more static router ports are to be configured, where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping static-router-port command to configure the current port or ports as static router port or ports.

Use the undo igmp-snooping static-router-port command to restore the system default.

By default, no ports are static router ports.

This command works only on IGMP snooping–enabled VLANs.

If configured in Ethernet interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface belongs to the specified VLAN.

If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

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: IGMP snooping version, in the range of 2 to 3.

Description

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

Use the undo igmp-snooping version command to restore the default setting.

By default, the IGMP snooping version is 2.

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

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping in VLAN 2, and set the IGMP snooping version to version 3.

<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: Interval between IGMP last-member queries, in seconds. The effective range is 1 to 5.

Description

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

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

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 globally to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

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

mac-address multicast

Syntax

In system view:

mac-address multicast mac-address interface interface-list vlan vlan-id

undo mac-address [ multicast ] [ [ mac-address [ interface interface-list ] ] vlan vlan-id ]

In Ethernet interface view or Layer 2 aggregate interface view:

mac-address multicast mac-address vlan vlan-id

undo mac-address [ multicast ] mac-address vlan vlan-id

In port group view:

mac-address multicast mac-address vlan vlan-id

undo mac-address multicast mac-address vlan vlan-id

View

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

Default level

2: System level

Parameters

mac-address: Static multicast MAC address, which can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where x represents an arbitrary hexadecimal number from 0 to F. Multicast MAC addresses are the MAC addresses whose the least signification bit of the most significant octet is 1. The system will give a prompt if the configured static multicast MAC address conflicts with the MAC address of other protocols.

interface-list: Specifies a list of interfaces. You can specify up to n single interfaces, interface ranges, or combinations of both for the list. A single interface takes the form of interface-type interface-number. An interface range takes the form of interface-type interface-number to interface-type interface-number, where the end interface number must be greater than the start interface number.

vlan vlan-id: Specifies the VLAN to which the interface belongs. vlan-id is in the range of 1 to 4094. The specified VLAN must exist and the system gives a prompt if the specified interface does not belong to the VLAN.

Description

Use the mac-address multicast command to configure a static multicast MAC address entry.

Use the undo mac-address multicast command to delete a static multicast MAC address entry.

By default, no static multicast MAC address entry is configured.

If multicast is not specified when using the undo mac-address multicast command, all MAC address entries including static multicast MAC address entries and unicast MAC address entries will be deleted.

Related commands: display mac-address multicast; mac-address (Layer 2 Command Reference).

Examples

# Configure a static multicast MAC address entry with the MAC address of 0100-0001-0001 and outgoing interfaces GigabitEthernet 1/0/1 through GigabitEthernet 1/0/5 in VLAN 2.

<Sysname> system-view

[Sysname] mac-address multicast 0100-0001-0001 interface gigabitethernet 1/0/1 to gigabitethernet 1/0/5 vlan 2

# Configure a static multicast MAC address entry with the MAC address of 0100-0001-0001 in interface view of GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mac-address multicast 0100-0001-0001 vlan 2

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: Maximum response time to IGMP general queries, in seconds. The effective range is 1 to 25.

Description

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

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

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 to IGMP general queries globally to 5 seconds.

<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 the overflow-replace command to enable the multicast group replacement function globally.

Use the undo overflow-replace command 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.

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 the report-aggregation command to enable IGMP report suppression.

Use the undo report-aggregation command 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. The effective range of vlan-id is 1 to 4094.

Description

Use the reset igmp-snooping group command 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 the reset igmp-snooping statistics command to clear the statistics information of IGMP messages learned by IGMP snooping.

Examples

# Clear the statistics information of all kinds of IGMP messages learned by 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: Dynamic router port aging time, in seconds. The effective range is 1 to 1,000.

Description

Use the router-aging-time command to configure the aging time of dynamic router ports globally.

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

By default, the aging time 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 time of dynamic router ports globally to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

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

source-deny (IGMP-snooping view)

Syntax

source-deny port interface-list

undo source-deny port interface-list

View

IGMP-snooping view

Default level

2: System level

Parameters

interface-list: Specifies one or multiple ports. You can provide up to ten port lists. For each list, you can specify an individual port in the form of interface-type interface-number, or a port range in the form of interface-type start-interface-number to interface-type end-interface-number, where the end interface number must be greater than the start interface number.

Description

Use the source-deny command to enable multicast source port filtering so that all multicast data packets are blocked.

Use the undo source-deny command to disable multicast source port filtering.

By default, multicast source port filtering is not enabled.

This command works only on IGMP snooping–enabled VLANs.

Examples

# Enable source port filtering for multicast data on interfaces GigabitEthernet 1/0/1 through GigabitEthernet 1/0/4.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] source-deny port gigabitethernet 1/0/1 to gigabitethernet 1/0/4

04-IP Multicast Command Reference

IGMP snooping configuration commands

display igmp-snooping group

dot1p-priority (IGMP-snooping view)

fast-leave (IGMP-snooping view)

group-policy (IGMP-snooping view)

host-aging-time (IGMP-snooping view)

igmp-snooping

igmp-snooping dot1p-priority

igmp-snooping enable

igmp-snooping fast-leave

igmp-snooping group-policy

igmp-snooping host-aging-time

igmp-snooping last-member-query-interval

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

mac-address multicast

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