The term switch in this document refers to a switch in a generic sense or an access controller configured with the switching function unless otherwise specified.

IGMP Snooping Configuration Commands

display igmp-snooping group

Syntax

display igmp-snooping group [ vlan vlan-id ] [ verbose ]

View

Any view

Parameters

vlan vlan-id: Displays the IGMP Snooping forwarding table 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 will display the multicast group information in all VLANs.

verbose: Specifies to display the detailed IGMP Snooping forwarding table information.

Description

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

Examples

# View the detailed IGMP Snooping forwarding table 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, A-Aggregation port, C-Copy port

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

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port.

GE0/0/2 (D) ( 00:01:30 )

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

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Port

Host port(s):total 1 port.

GE0/0/1 (D) ( 00:03:23 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):total 1 port.

GE0/0/1

Table 1-1 Description of the fields of the display igmp-snooping group command

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

display igmp-snooping statistics

Syntax

display igmp-snooping statistics

View

Any view

Parameters

None

Description

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

Examples

# View the statistics information of IGMP messages learned by IGMP Snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries:0.

Received IGMPv1 reports:0.

Received IGMPv2 reports:19.

Received IGMP leaves:0.

Received IGMPv2 specific queries:0.

Sent IGMPv2 specific queries:0.

Received IGMPv3 reports:1.

Received IGMPv3 reports with right and wrong records:0.

Received IGMPv3 specific queries:0.

Received IGMPv3 specific sg queries:0.

Sent IGMPv3 specific queries:0.

Sent IGMPv3 specific sg queries:0.

Received error IGMP messages:19.

Table 1-2 Description of the fields of the display igmp-snooping statistics command

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

fast-leave

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

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 effective range of a VLAN ID is 1 to 4094.

Description

Use the fast-leave command to enable the fast leave feature globally.

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

By default, the fast leave feature is disabled.

Note that:

If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: igmp-snooping fast-leave.

Examples

# Enable the fast leave feature globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

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

group-policy

Syntax

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

undo group-policy [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the group-policy command to configure a global multicast group filter.

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

Note that:

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

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

l 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

# Configure ACL 2000 as the multicast group filter in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

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

host-aging-time

Syntax

host-aging-time interval

undo host-aging-time

View

IGMP-Snooping view

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

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

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

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

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 host-aging-time.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

igmp-snooping

Syntax

igmp-snooping

undo igmp-snooping

View

System view

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

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.

Examples

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

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping drop-unknown

igmp-snooping enable

Syntax

igmp-snooping enable

undo igmp-snooping enable

View

VLAN view

Parameters

None

Description

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

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

By default, IGMP Snooping is disabled in a VLAN.

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

Related commands: igmp-snooping.

Examples

# Enable IGMP Snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

igmp-snooping fast-leave

Syntax

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

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

View

Ethernet port view, port group view

Parameters

Description

Use the igmp-snooping fast-leave command to enable the fast leave feature on the current port or group of ports.

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

By default, the fast leave feature is disabled.

Note that:

l If you do not specify any VLAN when you use this command in Ethernet port view, the command will take effect no matter which VLAN the port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the port belongs to the specified VLAN(s).

l If you do not specify any VLAN in manual port group view, the command will take effect on all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

l Configurations made in aggregation port group view are effective only for the master port in the group. If you do not specify any VLAN in aggregation port group view, the command will take effect no matter which VLAN the master port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the master port belongs to the specified VLAN(s).

Related commands: fast-leave.

Examples

# Enable the fast leave feature on GigabitEthernet 0/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

igmp-snooping general-query source-ip

Syntax

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

undo igmp-snooping general-query source-ip

View

VLAN view

Parameters

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.

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

Description

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

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

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

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

Examples

# Set the IP address of the interface of VLAN 2 to 10.1.1.1, with the subnet mask of 255.255.255.0, and specify this IP address as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip address 10.1.1.1 255.255.255.0

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping general-query source-ip current-interface

igmp-snooping group-limit

Syntax

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

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

View

Ethernet port view, port group view

Parameters

limit: Maximum number of multicast groups that can be joined on a port. The effective range is 1 to 128.

Description

Use the igmp-snooping group-limit command to configure the maximum number of multicast groups that can be joined on a port.

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

The default setting is 128.

Note that:

l If you do not specify any VLAN in Ethernet port view, the command will take effect on the port no matter which VLAN the port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect on the port only if the port belongs to the specified VLAN(s).

l If you do not specify any VLAN in port group view, the command will take effect on all the ports in this group no matter which VLANs these ports belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

Examples

# Specify to allow a maximum of 10 multicast groups to be joined on GigabitEthernet 0/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

igmp-snooping group-policy

Syntax

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

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

View

Ethernet port view, port group view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the igmp-snooping group-policy command to configure a multicast group filter on the current port(s).

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

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

Note that:

l If you do not specify any VLAN in port group view, the command will take effect on all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

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

l 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

# Configure ACL 2000 as the multicast group filter on GigabitEthernet 0/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

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

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

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

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

Related commands: host-aging-time.

Examples

# Set the aging time of group member ports to 300 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

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

igmp-snooping host-join

Syntax

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

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

View

Ethernet port view, port group view

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. If the value is 0.0.0.0, this means that no multicast source is specified.

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

Description

Use the igmp-snooping host-join command to configure the current port(s) as simulated multicast group member host(s).

Use the undo igmp-snooping host-join command to remove the current port(s) as simulated multicast group member host(s).

By default, this function is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces. The version of IGMP on the simulated host depends on the version of IGMP Snooping running in the VLAN or the version of IGMP running on the VLAN interface.

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

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

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

Examples

# Configure GigabitEthernet 0/0/1 as a simulated member host in VLAN 2 for multicast source 1.1.1.1 and multicast group 224.0.0.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 0/0/1

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

igmp-snooping last-member-query-interval

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

View

VLAN view

Parameters

interval: Interval between IGMP last-member queries, in units of seconds. The effective range is 1 to 5.

Description

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

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

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

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

Related commands: last-member-query-interval.

Examples

# Set the interval between IGMP last-member queries to 3 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

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

igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

View

VLAN view

Parameters

interval: Maximum response time to IGMP general queries, in units of seconds. The effective range is 1 to 25.

Description

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

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

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

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

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

Examples

# Set the maximum response time to IGMP general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

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

igmp-snooping overflow-replace

Syntax

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

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

View

Ethernet port view, port group view

Parameters

Description

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

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

By default, the multicast group replacement function is disabled.

Note that:

Related commands: overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

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.

Examples

# Enable the IGMP Snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping querier

igmp-snooping query-interval

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

View

VLAN view

Parameters

interval: Interval between IGMP general queries, in units of seconds. The effective range is 2 to 300.

Description

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

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

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

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

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

Examples

# Set the interval between IGMP general queries to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

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

igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

View

VLAN view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

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

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

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

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

Related commands: router-aging-time.

Examples

# Set the aging time of router ports to 100 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

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

igmp-snooping source-deny

Syntax

igmp-snooping source-deny

undo igmp-snooping source-deny

View

Ethernet port view, port group view

Parameters

None

Description

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

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

By default, multicast source port filtering is disabled.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

igmp-snooping special-query source-ip

Syntax

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

undo igmp-snooping special-query source-ip

View

VLAN view

Parameters

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.

ip-address: Sets the source address of IGMP group-specific queries to the specified address.

Description

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

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

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

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

Examples

# Set the IP address of the interface of VLAN 2 to 10.1.1.1, with the subnet mask of 255.255.255.0, and specify this IP address as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip address 10.1.1.1 255.255.255.0

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping special-query source-ip current-interface

igmp-snooping static-group

Syntax

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

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

View

Ethernet port view, port group view

Parameters

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

source-address: Address of multicast source to be statically joined. The value of this argument should be a valid unicast address or 0.0.0.0. If the value is 0.0.0.0, this means no multicast source is specified.

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

Description

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

Use the undo igmp-snooping static-group command to disable the static (*, G) or (S, G) joining function.

By default, this function is disabled.

Note that:

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

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

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

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 0/0/1

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

igmp-snooping static-router-port

Syntax

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

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

View

Ethernet port view, port group view

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 enable the static router port function.

Use the undo igmp-snooping static-router-port command to disable the static router port function.

By default, the static router port function is not enabled.

Note that:

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

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

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 0/0/1

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

Parameters

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

Description

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

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

By default, the IGMP version is 2.

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

Related commands: igmp-snooping enable.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

last-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP-Snooping view

Parameters

interval: Interval between IGMP last-member queries, in units of seconds. The effective range is 1 to 5.

Description

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

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

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

This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding 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

Syntax

max-response-time interval

undo max-response-time

View

IGMP-Snooping view

Parameters

interval: Maximum response time to IGMP general queries, in units of seconds. The effective range is 1 to 25.

Description

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

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

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

Related commands: igmp-snooping max-response-time, 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

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

Description

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

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

By default, the multicast group replacement function is disabled.

Note that:

If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: igmp-snooping overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

report-aggregation

Syntax

report-aggregation

undo report-aggregation

View

IGMP-Snooping view

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.

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

Parameters

group-address: Address of the multicast group for which the IGMP Snooping forwarding entries are to be cleared. The value range is 224.0.1.0 to 239.255.255.255.

all: Specifies to clear all IGMP Snooping forwarding entries.

vlan vlan-id: Specifies a VLAN in which all IGMP Snooping forwarding entries are to be cleared, where vlan-id is in the range of 1 to 4094.

Description

Use the reset igmp-snooping group command to clear IGMP Snooping forwarding entries.

Note that:

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

l This command cannot clear IGMP Snooping forwarding entries of static joins.

Examples

# Clear all IGMP Snooping forwarding entries saved in the switch.

<Sysname> reset igmp-snooping group all

reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Parameters

None

Description

Use the reset igmp-snooping statistics command to clear the statistics information of IGMP messages learned by IGMP Snooping.

Examples

# Clear the statistics information of all kinds of IGMP messages learned by IGMP Snooping.

<Sysname> reset igmp-snooping statistics

router-aging-time

Syntax

router-aging-time interval

undo router-aging-time

View

IGMP-Snooping view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

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

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

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

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 router-aging-time.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

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

source-deny

Syntax

source-deny port interface-list

undo source-deny port interface-list

View

IGMP-Snooping view

Parameters

interface-list: Ethernet port list. You can specify multiple Ethernet ports or port ranges by providing the this argument in the form of interface-list = { interface-type interface-number [ to interface-type interface-number ] }, where interface-type is port type and interface-number is port number.

Description

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

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

By default, multicast source port filtering is not enabled.

Examples

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

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] source-deny port GigabitEthernet0/0/1 to
GigabitEthernet0/0/5

2 Multicast VLAN Configuration Commands

Multicast VLAN Configuration Commands

display multicast-vlan

Syntax

display multicast-vlan [ vlan-id ]

View

Any view

Parameters

vlan-id: VLAN ID of a multicast VLAN, in the range of 1 to 4094. If this argument is not provided, the information about all multicast VLANs and their sub-VLANs will be displayed.

Description

Use the display multicast-vlan command to view the information about the specified multicast VLAN and its sub-VLANs.

Examples

# View the information about all multicast VLANs and their sub-VLANs.

<Sysname> display multicast-vlan

multicast vlan 100's subvlan list:

vlan 2 4-8

multicast-vlan enable

Syntax

multicast-vlan vlan-id enable

undo multicast-vlan vlan-id enable

View

System view

Parameters

vlan-id: Specifies a VLAN by its ID, in the range of 1 to 4094.

Description

Use the multicast-vlan enable command to configure the specified VLAN as a multicast VLAN.

Use the undo multicast-vlan enable command to remove the specified VLAN as a multicast VLAN.

No VLAN is a multicast VLAN by default.

Note that:

l The specified VLAN must exist.

l The multicast VLAN feature cannot be enabled on a device with IP multicast routing enabled.

l After a VLAN is configured into a multicast VLAN, IGMP Snooping must be enabled in the VLAN before the multicast VLAN feature can be implemented, while it is not necessary to enable IGMP Snooping in the sub-VLANs of the multicast VLAN.

Examples

# Configure VLAN 100 as a multicast VLAN.

<Sysname> system-view

[Sysname] multicast-vlan 100 enable

multicast-vlan subvlan

Syntax

multicast-vlan vlan-id subvlan vlan-list

undo multicast-vlan vlan-id subvlan vlan-list

View

System view

Parameters

vlan-id: VLAN ID of a multicast VLAN, in the range 1 to 4094.

subvlan vlan-list: Defines one or multiple VLANs as sub-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 effective range of a VLAN ID is 1 to 4094.

Description

Use the multicast-vlan subvlan command to configure sub-VLAN(s) for the specified multicast VLAN.

Use the undo multicast-vlan subvlan command to remove the specified sub-VLAN(s) from the specified multicast VLAN.

A multicast VLAN has no sub-VLANs by default.

Note that:

l The VLAN to be configured as the multicast VLAN and the VLANs to be configured as sub-VLANs of the multicast VLAN must exist.

l The number of sub-VLANs of the multicast VLAN must not exceed the system-defined limit.

Examples

# Configure VLAN 10 through VLAN 15 as sub-VLANs of multicast VLAN 100.

<Sysname> system-view

[Sysname] multicast-vlan 100 subvlan 10 to 15

H3C WX6103 Access Controller Switch Interface Board Command Reference-6W102

1 IGMP Snooping Configuration Commands

fast-leave

group-policy

host-aging-time

igmp-snooping

igmp-snooping drop-unknown

igmp-snooping enable

igmp-snooping fast-leave

igmp-snooping general-query source-ip

igmp-snooping group-policy

igmp-snooping host-aging-time

igmp-snooping last-member-query-interval

igmp-snooping max-response-time

igmp-snooping overflow-replace

igmp-snooping querier

igmp-snooping query-interval

igmp-snooping source-deny

igmp-snooping static-group

max-response-time

overflow-replace

report-aggregation

router-aging-time

2 Multicast VLAN Configuration Commands

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