07-IP Multicast Command Reference

HomeSupportResource CenterRoutersH3C SR8800 Series RoutersH3C SR8800Technical DocumentsCommandCommand ReferenceH3C SR8800 Command Reference-Release3347-6W10307-IP Multicast Command Reference
01-IGMP Snooping Commands
Title Size Download
01-IGMP Snooping Commands 198.22 KB

IGMP snooping configuration commands

display igmp-snooping group

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

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

slot slot-number: Displays the IGMP snooping group information for the specified card. If you do not specify a slot, this command displays the IGMP snooping group information on the main processing unit (MPU).

verbose: Specifies to display 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.

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

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

regular-expression: Specifies a regular expression, 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.

Examples

# Display detailed IGMP snooping group information in VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

  Total 1 IP Group(s).

  Total 1 IP Source(s).

  Total 1 MAC Group(s).

 

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

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

  Vlan(id):2.

    Total 1 IP Group(s).

    Total 1 IP Source(s).

    Total 1 MAC Group(s).

    Router port unit board: Mask(0x000004)

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

            GE2/1/1                (D)

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

      IP group address:224.1.1.1

        (0.0.0.0, 224.1.1.1):

          Attribute:    Host Port

          Host port unit board: Mask(0x000004)

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

            GE2/1/2                (D)

    MAC group(s):

      MAC group address:0100-5e01-0101

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

            GE2/1/2

Table 1 Output description

Field

Description

Total 1 IP Group(s).

Total number of IP multicast groups

Total 1 IP Source(s).

Total number of multicast sources

Total 1 MAC Group(s).

Total number of MAC multicast groups

Port flags: D-Dynamic port, S-Static port, C-Copy port, 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

Number of the card where the router port resides (represented by a mask)

Router port(s)

Number of router ports

( 00:01:30 )

Remaining time of the dynamic member port or router port aging timer. To get this time value of a non-aggregation port that does not belong to the MPU, you must specify the number of the slot where the corresponding board resides; this is not required on an aggregation port.

IP group address

Address of IP multicast group

(0.0.0.0, 224.1.1.1)

An (S, G) entry, where 0.0.0.0 implies all multicast sources.

MAC group address

Address of MAC multicast group

Attribute

Attribute of IP multicast group

Host port unit board

Number of the card where the member port resides (represented by a mask)

Host port(s)

Number of member ports

 

display igmp-snooping host

Syntax

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

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

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

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

regular-expression: Specifies a regular expression, 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 in VLAN 2 that are in multicast group 224.1.1.1.

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

VLAN(ID) : 2

  (0.0.0.0, 224.1.1.1)

    Port : GigabitEthernet3/1/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/1/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.

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

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

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

Description

Use the display igmp-snooping statistics command to display statistics for IGMP messages learned by IGMP snooping.

Examples

# Display statistics for IGMP messages learned by IGMP snooping.

<Sysname> display igmp-snooping statistics

  Received IGMP general queries:0.

  Received IGMPv1 reports:0.

  Received IGMPv2 reports:19.

  Received IGMP leaves:0.

  Received IGMPv2 specific queries:0.

  Sent     IGMPv2 specific queries:0.

  Received IGMPv3 reports:1.

  Received IGMPv3 reports with right and wrong records:0.

  Received IGMPv3 specific queries:0.

  Received IGMPv3 specific sg queries:0.

  Sent     IGMPv3 specific queries:0.

  Sent     IGMPv3 specific sg queries:0.

  Received error IGMP messages:19.

Table 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(s)

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, in the range of 0 to 2000.

Description

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

Use the undo fast-leave command to restore the default.

By default, the IGMP snooping forwarding table can maintain up to 2000 entries.

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 for the specified VLANs only.

Description

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

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

By default, fast-leave processing is disabled.

This command works on both IGMP snooping-enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.

Related commands: igmp-snooping fast-leave.

Examples

# Enable fast-leave processing globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

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

group-policy (IGMP-snooping view)

Syntax

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

undo group-policy [ vlan vlan-list ]

View

IGMP-snooping view

Default level

2: System level

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. With the ACL number specified, a host can join only the multicast groups that match the permit rule in the ACL. The source address or address range specified in the advanced ACL rule is used to match the multicast source address(es) 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.

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 for the specified VLANs only.

Description

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

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

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

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

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

Related commands: igmp-snooping group-policy.

Examples

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

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] igmp-snooping

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

host-aging-time (IGMP-snooping view)

Syntax

host-aging-time interval

undo host-aging-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Dynamic member port aging time, in seconds. The 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.

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.

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

Examples

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

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

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.

Related commands: igmp-snooping host-tracking.

Examples

# Enable the IGMP snooping host tracking function globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-tracking

igmp-snooping

Syntax

igmp-snooping

undo igmp-snooping

View

System view

Default level

2: System level

Parameters

None

Description

Use 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 the function of dropping unknown multicast data in the current VLAN.

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

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

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

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping drop-unknown

igmp-snooping enable

Syntax

igmp-snooping enable

undo igmp-snooping enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

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

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

By default, IGMP snooping is disabled in a VLAN.

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

Related commands: igmp-snooping.

Examples

# Enable IGMP snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

igmp-snooping fast-leave

Syntax

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

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

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group 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.

Description

Use the igmp-snooping fast-leave command to enable fast-leave processing on the current port. With this function enabled, when the device 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.

By default, fast-leave processing is disabled.

This command works on both IGMP snooping–enabled VLANs and 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 for the specified VLANs that the interface belongs to.

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

Related commands: fast-leave.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping group-limit

Syntax

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

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

View

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

Default level

2: System level

Parameters

limit: Maximum number of multicast groups that can be joined on a port. The value ranges from 1 to 1024.

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.

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.

The default setting 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.

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 port belongs to. If you specify one or multiple VLANs, the command takes effect only if the port belongs to the specified VLANs.

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 multiple VLANs, the command takes effect on those ports in this group that belong to the specified VLANs.

Examples

# Specify to allow GigabitEthernet 2/1/1 in VLAN 2 to join up to 10 multicast groups.

<Sysname> system-view

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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. With the ACL number specified, a host can join only the multicast groups that match the permit rule in the ACL. The source address or address range specified in the advanced ACL rule is used to match the multicast source address(es) 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.

vlan vlan-list: Defines one or multiple VLANs. You can provide up to 10 VLAN lists, by each of which 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.

Description

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

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

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

·           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 port belongs to. If you specify one or multiple VLANs, the command takes effect only if the port belongs to the specified VLANs.

·           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 multiple VLANs, the command takes effect on those ports in this group that belong to the specified VLANs.

·           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 overwrite the existing one.

Related commands: group-policy.

Examples

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

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping host-join

Syntax

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

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

View

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

Default level

2: System level

Parameters

group-address: Address of the multicast group that the simulated host is to 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 is to 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 Ethernet port, 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 configure the current port as a member host for the specified multicast group or source and group.

Use the undo igmp-snooping host-join command to restore the default.

By default, this function is disabled.

This command works on both IGMP snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces. The version of IGMP on the simulated member host is consistent with the version of IGMP snooping that is running in the VLAN or the version of IGMP that is running on the VLAN interface.

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

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this command takes effect only if the port belongs to the specified VLAN. In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 2/1/1 as a simulated member host in VLAN 2 for multicast source 1.1.1.1 and multicast group 232.1.1.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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: igmp-snooping enable and host-tracking.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-tracking

igmp-snooping last-member-query-interval

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: 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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping leave source-ip

Syntax

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

undo igmp-snooping leave source-ip

View

VLAN view

Default level

2: System level

Parameters

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

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

Description

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

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

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

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

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

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

View

VLAN view

Default level

2: System level

Parameters

interval: Maximum response time to IGMP general queries, in seconds. The 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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping overflow-replace

Syntax

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

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

View

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

Default level

2: System level

Parameters

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.

Description

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

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

By default, the multicast group replacement function is disabled.

This command works on both IGMP snooping–enabled VLANs and 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 for the specified VLANs that the interface belongs to.

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

Related commands: overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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 configuring this command in a VLAN, enable IGMP snooping in the VLAN.

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping proxying enable

igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

Default level

2: System level

Parameters

None

Description

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

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

By default, the IGMP snooping querier function is disabled.

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

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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping querier

igmp-snooping query-interval

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: Interval between IGMP general queries, in seconds. The 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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping report source-ip

Syntax

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

undo igmp-snooping report source-ip

View

VLAN view

Default level

2: System level

Parameters

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

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

Description

Use the igmp-snooping report source-ip command to configure the source IP address of the IGMP reports sent by the IGMP snooping proxy.

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

By default, the source IP address of the IGMP reports sent by the IGMP snooping proxy is 0.0.0.0.

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

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

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

View

VLAN view

Default level

2: System level

Parameters

interval: Dynamic router port aging time, in seconds. The 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 in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping router-port-deny

Syntax

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

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

View

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

Default level

2: System level

Parameters

vlan vlan-list: Specifies one or multiple VLANs. You can provide up to 10 VLAN lists, by each of which 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.

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 change into a dynamic router port.

This command works on both IGMP snooping–enabled VLANs and 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 multiple VLANs, the command takes effect for the specified VLANs that the interface belongs to.

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

Examples

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

<Sysname> system-view

[Sysname] interface Gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] port link-mode bridge

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

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

igmp-snooping static-group

Syntax

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

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

View

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

Default level

2: System level

Parameters

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

source-address: Address of multicast source that the port will join statically. 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 Ethernet port, where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping static-group command to configure the current port  as a static member of the specified multicast group or source and group.

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

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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 are to be configured, where vlan-id is in the range of 1 to 4094.

Description

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

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

By default, no ports are static router ports.

This command works on both IGMP snooping–enabled VLANs and 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 command takes effect only if the port belongs to the specified VLAN. In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Related commands: subvlan.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet2/1/1

[Sysname-GigabitEthernet2/1/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 in VLAN 2, and specify IGMPv3 snooping.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

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

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP-snooping view

Default level

2: System level

Parameters

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

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.

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.

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

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

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 for the specified VLANs only.

Description

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

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

By default, the multicast group replacement function is disabled.

This command works on both IGMP snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.

Related commands: igmp-snooping overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

report-aggregation (IGMP-snooping view)

Syntax

report-aggregation

undo report-aggregation

View

IGMP-snooping view

Default level

2: System level

Parameters

None

Description

Use the report-aggregation command to enable IGMP report suppression.

Use the undo report-aggregation command to disable IGMP report suppression.

By default, IGMP report suppression is enabled.

This command works on both IGMP snooping–enabled VLANs and 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: Clears the information about the specified multicast group. The value range of group-address  is 224.0.1.0 to 239.255.255.255.

all: Clears all IGMP snooping group information.

vlan vlan-id: Clears the IGMP snooping group information in the specified VLAN. The value range of vlan-id is 1 to 4094.

Description

Use the reset igmp-snooping group command to clear IGMP snooping group information.

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.

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 statistics for IGMP messages learned by IGMP snooping.

Examples

# Clear statistics for all IGMP messages learned by IGMP snooping.

<Sysname> reset igmp-snooping statistics

router-aging-time (IGMP-snooping view)

Syntax

router-aging-time interval

undo router-aging-time

View

IGMP-snooping view

Default level

2: System level

Parameters

interval: Dynamic router port aging time, in seconds. The 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.

This command works only on IGMP snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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