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: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. If you do not specify a VLAN, this command displays information about IGMP snooping groups in all VLANs.

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the IGMP snooping group information on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on 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 MPUs in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In 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 display igmp-snooping group to display IGMP snooping group information, including both dynamic entries and static entries.

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 Command output

Field	Description
Total 1 IP Group(s).	Total number of IP multicast groups.
Total 1 IP Source(s).	Total number of multicast sources.
Total 1 MAC Group(s).	Total number of MAC multicast groups.
Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port	Port flags: · D—Dynamic port. · S—Static port. · C—Port copied from a (*, G) entry to an (S, G) entry. · P—Port added by PIM snooping.
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: · R—Real egress sub-VLAN under the current entry. · C—sub-VLAN copied from a (*, G) entry to an (S, G) entry.
Router port 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 MPU, 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 MPU, 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)	(S, G) entry. If the multicast source is not specified, the field in the S position displays 0.0.0.0.
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: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

group group-address: Specifies a multicast group address. The value range for the group-address argument ranges is 224.0.1.0 to 239.255.255.255.

source source-address: Specifies a source address. The value for the source-address argument 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: Specifies a card by its slot number. If no slot is specified, the command displays information about the IGMP snooping tracked host on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on 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 MPUs in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In 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 display igmp-snooping host 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 Command output

Field	Description
(0.0.0.0, 224.1.1.1)	(S, G) entry. If the multicast source is not specified, the field in the S position displays 0.0.0.0.
Port	Member port.
Host	Host IP address.
Uptime	Host running duration.
Expires	Host expiration time. If the host has expired, this field displays timeout.

display igmp-snooping statistics

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

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

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

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

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

Description

Use display igmp-snooping statistics to display 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 Command output

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

entry-limit (IGMP-snooping view)

Syntax

entry-limit limit

undo entry-limit

View

IGMP-snooping view

Default level

2: System level

Parameters

limit: Specifies the maximum number of entries in the IGMP snooping forwarding table, in the range of 0 to 2000.

Description

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

Use undo entry-limit 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 fast-leave to enable IGMP snooping 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 a specific group.

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

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

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

Related commands: igmp-snooping fast-leave.

Examples

# Enable IGMP snooping 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: Specifies a 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 group-policy to configure a global multicast group filter to control the multicast groups a host can join.

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

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

This command is also effective 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: Specifies a dynamic member port aging timer in seconds, in the range of 200 to 1000.

Description

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

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

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

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

host-tracking (IGMP-snooping view)

Syntax

host-tracking

undo host-tracking

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

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

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

By default, this function is disabled.

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 igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

By default, IGMP snooping is disabled.

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

igmp-snooping drop-unknown

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

View

VLAN view

Default level

2: System level

Parameters

None

Description

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

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

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

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

After you enable dropping unknown multicast data, the switch does not drop the unknown multicast data with the multicast MAC address of 0100-5E00-00xx (where "x" represents any hexadecimal number from 0 to F) or 0100-5E00-0101. Instead, the switch floods the multicast data in the VLANs to which they belong.

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 igmp-snooping enable to enable IGMP snooping in the current VLAN.

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

By default, IGMP snooping is disabled in a VLAN.

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

Related commands: igmp-snooping.

Examples

# Enable IGMP snooping 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 igmp-snooping fast-leave to enable IGMP snooping 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 a specific group.

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

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

This command is also effective 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 on all VLANs to which the interface belongs. If you specify one or more VLANs, the command takes effect on the specified VLANs to which the interface belongs.

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 IGMP snooping 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 igmp-snooping general-query source-ip to configure the source address of IGMP general queries.

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

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

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

Related commands: igmp-snooping enable.

Examples

# 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: Specifies the maximum number of multicast groups that a port can join, in the range of 1 to 1024.

Description

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

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

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 that you 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: Specifies a 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 igmp-snooping group-policy to configure a multicast group filter on the current port or ports to control the multicast groups that the port or ports can join.

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

By default, no multicast group filter is configured on an interface and 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 only 225.1.1.1.

<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: Specifies a dynamic member port aging timer in seconds, in the range of 200 to 1000.

Description

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

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

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

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

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping host-join

Syntax

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

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

View

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

Default level

2: System level

Parameters

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies a source address. The value for 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 a VLAN that comprises the port or ports. The value range for the vlan-id argument is 1 to 4094.

Description

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

Use undo igmp-snooping host-join 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 is also effective 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 the multicast source and group (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 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 igmp-snooping host-tracking to enable the IGMP snooping host tracking function in a VLAN.

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

By default, this function is disabled.

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

Related commands: 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: Specifies an IGMP last-member query interval in seconds, in the range of 1 to 5.

Description

Use igmp-snooping last-member-query-interval to configure the IGMP last-member query interval for a VLAN.

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

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

The IGMP last-member query interval for a VLAN determines the interval for sending IGMP group-specific queries and the maximum response delay for IGMP group-specific queries in the VLAN.

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 IGMP last-member query interval for VLAN 2 to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping leave source-ip

Syntax

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

undo igmp-snooping leave source-ip

View

VLAN view

Default level

2: System level

Parameters

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

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

Description

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

Use undo igmp-snooping leave source-ip 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.

You must enable IGMP snooping for a VLAN before you configure this command for 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: Specifies the maximum response delay in seconds for IGMP general queries, in the range of 1 to 25.

Description

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

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

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

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

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

Examples

# Enable IGMP snooping and set the maximum response delay for 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 igmp-snooping overflow-replace to enable the multicast group replacement function for a port.

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

By default, the multicast group replacement function on a port is disabled.

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

Related commands: overflow-replace.

Examples

# Enable the multicast group replacement function for 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 igmp-snooping proxying enable to enable the IGMP snooping proxying function for a VLAN.

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

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

You must enable IGMP snooping for a VLAN before you configure this command for 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 igmp-snooping querier to enable the IGMP snooping querier function.

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

By default, the IGMP snooping querier function is disabled.

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

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: Specifies an interval between IGMP general queries, in the range of 2 to 300 seconds.

Description

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

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

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

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

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

Examples

# Enable IGMP snooping and set the interval between IGMP general queries to 20 seconds 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 igmp-snooping report source-ip to configure the source IP address of the IGMP reports sent by the IGMP snooping proxy.

Use undo igmp-snooping report source-ip 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.

You must enable IGMP snooping for a VLAN before you configure this command for 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: Specifies a dynamic router port aging timer in the range of 1 to 1000 seconds.

Description

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

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

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

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

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping router-port-deny

Syntax

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

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

View

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

Default level

2: System level

Parameters

Description

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

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

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

This command is also effective 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 igmp-snooping special-query source-ip to configure the source IP address of IGMP group-specific queries.

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

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

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

Related commands: igmp-snooping enable.

Examples

# 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: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies a source address. The value for 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 a VLAN that comprises the port or ports. The value range for the vlan-id argument is 1 to 4094.

Description

Use igmp-snooping static-group to configure the static (*, G) or (S, G) joining function. You can configure the current port or port group as static multicast group or source-group members.

Use undo igmp-snooping static-group 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. The value range for the vlan-id argument is 1 to 4094.

Description

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

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

By default, no ports are static router ports.

This command is also effective 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: Specifies an IGMP snooping version, 2 or 3.

Description

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

Use undo igmp-snooping version to restore the default.

By default, the IGMPv2 snooping is used.

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

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

Related commands: igmp-snooping enable 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: Specifies an IGMP last-member query interval in seconds, in the range of 1 to 5.

Description

Use last-member-query-interval to set the IGMP last-member query globally.

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

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

The IGMP last-member query interval determines the interval for sending IGMP group-specific queries and the maximum response delay for IGMP group-specific queries.

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

max-response-time (IGMP-snooping view)

Syntax

max-response-time interval

undo max-response-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Specifies the maximum response time to IGMP general queries, in the range of 1 to 25 seconds.

Description

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

Use undo max-response-time 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 overflow-replace to enable the multicast group replacement function globally.

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

By default, the multicast group replacement function is disabled.

This command is also effective 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 report-aggregation to enable IGMP report suppression.

Use undo report-aggregation to disable IGMP report suppression.

By default, IGMP report suppression is enabled.

This command is also effective 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 in the range of 224.0.1.0 to 239.255.255.255.

all: Specifies all IGMP snooping groups.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

Description

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

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

Examples

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

<Sysname> reset igmp-snooping group all

reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Default level

2: System level

Parameters

None

Description

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

Examples

# Clear 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: Specifies a dynamic router port aging timer in the range of 1 to 1000 seconds.

Description

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

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

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

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

Examples

# Set the aging timer for 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)

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