display igmp-snooping group [ vlan vlan-id ] [ chassis chassis-number slot slot-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays IGMP snooping group information on the specified VLAN, where vlan-id is in the range of 1 to 4094.

slot slot-number: Displays information about IGMP snooping groups on the card specified by its slot number. If no slot is specified, the command displays the IGMP snooping group information on the main board. (Standalone mode)

chassis chassis-number slot slot-number: Displays information about IGMP snooping groups on a card in an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the number of the slot that holds the card. If this option is not specified, this command displays the information of IGMP snooping groups on all main boards in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (IRF mode)

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 the display igmp-snooping group command to display IGMP snooping group information, including both dynamic entries and static entries. If you do not specify a VLAN, this command displays information about IGMP snooping groups in all VLANs.

Examples

# Display detailed IGMP snooping group information on VLAN 2000 on the card in slot 5.

<Sysname> display igmp-snooping group vlan 22000 slot 5 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):2000.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port unit board: Mask(0x0)

Router port(s):total 0 port.

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

IP group address:225.0.0.1

(0.0.0.0, 225.0.0.1):

Attribute: Host Port

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE5/0/33 (D) ( 00:04:12 )

MAC group(s):

MAC group address:0100-5e00-0001

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE5/0/33

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, P-PIM 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, and P for a port added by PIM snooping.
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 unit board	Mask indicating a board with a router port residing on it.
Router port(s)	Number of router ports.
( 00:04:12)	Remaining time of the aging timer for the dynamic member port or router port: · In standalone mode, to display the remaining life of a non-aggregation port that does not belong to the main board, you must specify the number of the slot where the corresponding card resides by using slot slot-number. This is not required for an aggregation port. · In IRF mode, to display the remaining life of a non-aggregation port that does not belong to the main board, you must specify the member ID of the device in the IRF and the slot number of the card with chassis chassis-number slot slot-number. For an aggregation port, you do not need to do this.
IP group address	Address of IP multicast group.
(0.0.0.0, 225.0.0.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 unit board	Mask indicating a board with a member port residing on it.
Host port(s)	Number of member ports.

display igmp-snooping host

Syntax

Standalone mode:

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

IRF mode:

display igmp-snooping host vlan vlan-id group group-address [ source source-address ] [ chassis chassis-number slot slot-number ] [ | { 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.

slot slot-number: Displays information about the hosts tracked by IGMP snooping on the card specified by its slot number. If no slot is specified, the command displays information about the IGMP snooping tracked host on the main board. (Standalone mode)

chassis chassis-number slot slot-number: Displays information about the hosts tracked by IGMP snooping on a card in an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the number of the slot that holds the card. If this option is not specified, this command displays information about the hosts tracked by IGMP snooping on all main boards in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (IRF mode)

|: 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 the display igmp-snooping host command to display information about the hosts tracked by IGMP snooping.

Examples

# Display information about the hosts tracked by IGMP snooping on 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 : GigabitEthernet3/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 : GigabitEthernet3/0/2

Host Uptime Expires

3.3.3.3 00:02:20 00:00:40

Table 2 Output description

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 the display igmp-snooping statistics command to display statistics for IGMP messages learned through IGMP snooping.

Examples

# Display statistics for 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 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

entry-limit (IGMP-snooping view)

Syntax

entry-limit limit

undo entry-limit

View

IGMP-snooping view

Default level

2: System level

Parameters

limit: Maximum number of entries in the IGMP snooping forwarding table. The value ranges from 0 to 2000.

Description

Use the entry-limit command to configure the maximum number of entries in the IGMP snooping forwarding table globally.

Use the undo entry-limit command to restore the default.

By default, the upper limit is 2000.

Related commands: multicast-vlan entry-limit.

Examples

# Configure the IGMP snooping forwarding table to contain at most 512 entries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] entry-limit 512

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 value 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 on 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 also works on VLANs with IGMP enabled on their VLAN interfaces.

Related commands: igmp-snooping fast-leave.

Examples

# Enable fast-leave processing globally on 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. A host can only join the multicast groups that match the permit statement in the specified ACL. 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.

This command also works on VLANs with IGMP enabled on their VLAN interfaces.

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 on 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 value ranges from 200 to 1000.

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.

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

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

host-tracking (IGMP-snooping view)

Syntax

host-tracking

undo host-tracking

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

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

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

By default, this function is disabled.

Related commands: display igmp-snooping host and 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 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 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 dropping unknown multicast data in the current VLAN.

Use the undo igmp-snooping drop-unknown command to disable 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

# On 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 on 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 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 also works on VLANs with IGMP enabled on their VLAN interfaces.

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 on 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.

Examples

# Enable fast-leave processing on GigabitEthernet 3/0/1 on VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/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.

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

# On 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: Maximum number of multicast groups that a port can join. The value ranges from 1 to 1024.

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.

By default, the upper limit is 1024.

You can also use the igmp group-limit command to limit the number of multicast groups that an interface can join. However, if you configure the limit both on a VLAN and on a VLAN interface of this VLAN by using these two commands, inconsistencies might exist between Layer 2 and Layer 3 table entries. Therefore, H3C recommends you to configure the limit only on the VLAN interface.

Related commands: igmp group-limit.

Examples

# Specify to allow GigabitEthernet 3/0/1 on VLAN 2 to join up to 10 multicast groups.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/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: Basic or advanced ACL number, in the range of 2000 to 3999. A host can only join the multicast groups that match the permit statement in the specified ACL. 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 3/0/1 on 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 3/0/1

[Sysname-GigabitEthernet3/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 value ranges from 200 to 1000.

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.

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 on 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: 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.

The version of IGMP on the simulated host is consistent with the version of IGMP snooping running in the VLAN.

This command also works on VLANs with IGMP enabled on their VLAN interfaces. The version of IGMP on the simulated host is consistent with the version of IGMP running on the VLAN interfaces.

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 feature takes effect only if the interface belongs to the specified VLAN.

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 3/0/1 as a simulated member host on 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 3/0/1

[Sysname-GigabitEthernet3/0/1] igmp-snooping host-join 232.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 the igmp-snooping host-tracking command to enable the IGMP snooping host tracking function in a VLAN.

Use the undo igmp-snooping host-tracking command 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: display igmp-snooping host, host-tracking, and igmp-snooping enable.

Examples

# Enable IGMP snooping and IGMP snooping host tracking on 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: Interval between IGMP last-member queries, in seconds. The value ranges from 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.

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 on 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 on VLAN 2 and configure the source IP address of IGMP leave messages sent by the IGMP snooping proxy on 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 value ranges from 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.

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 on 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 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 also works on VLANs with IGMP enabled on their VLAN interfaces.

Related commands: overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/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 on 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.

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

Related commands: igmp-snooping enable and subvlan.

Examples

# Enable IGMP snooping and the IGMP snooping querier function on 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 value ranges from 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.

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 on 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 on VLAN 2 and configure the source IP address of IGMP reports sent by the IGMP snooping proxy in the VLAN 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 value ranges from 1 to 1000.

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.

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 on 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 the igmp-snooping router-port-deny command to disable a port from becoming a dynamic router port.

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

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

This command also works on VLANs with IGMP enabled on their VLAN interfaces.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/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: 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.

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

# On 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: 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 default.

By default, no ports are static member ports.

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 feature takes effect only if the interface belongs to the specified VLAN.

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 3/0/1 on 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 3/0/1

[Sysname-GigabitEthernet3/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

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 in which one or more static router ports will 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 default.

By default, no ports are static router ports.

This command also works on VLANs with IGMP enabled on their VLAN interfaces.

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 feature takes effect only if the interface belongs to the specified VLAN.

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

Related commands: subvlan.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/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.

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 and subvlan.

Examples

# Enable IGMP snooping on 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: Interval between IGMP last-member queries, in seconds. The value ranges from 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.

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

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

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 value ranges from 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.

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 also works on VLANs with IGMP enabled on their VLAN interfaces.

Related commands: igmp-snooping overflow-replace.

Examples

# Enable the multicast group replacement function globally on 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 also works on VLANs with IGMP enabled on their VLAN interfaces.

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 value 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 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 for IGMP messages learned through IGMP snooping.

Examples

# Clear the statistics for all 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: Dynamic router port aging time, in seconds. The value ranges from 1 to 1000.

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.

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

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

Examples

# Set the aging time of dynamic router ports to 100 seconds globally.

<Sysname> system-view

[Sysname] igmp-snooping

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

08-IP Multicast Command Reference

IGMP snooping configuration commands

entry-limit (IGMP-snooping view)

group-policy (IGMP-snooping view)

host-aging-time (IGMP-snooping view)

host-tracking (IGMP-snooping view)

igmp-snooping drop-unknown

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)

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us