Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-IGMP Snooping Commands | 135.23 KB |
Table of Contents
1 IGMP Snooping Configuration Commands
IGMP Snooping Configuration Commands
display igmp-snooping statistics
drop-unknown (IGMP-Snooping view)
fast-leave (IGMP-Snooping view)
group-policy (IGMP-Snooping view)
host-aging-time (IGMP-Snooping view)
igmp-snooping general-query source-ip
igmp-snooping last-member-query-interval
igmp-snooping max-response-time
igmp-snooping overflow-replace
igmp-snooping router-aging-time
igmp-snooping special-query source-ip
igmp-snooping static-router-port
last-member-query-interval (IGMP-Snooping view)
max-response-time (IGMP-Snooping view)
overflow-replace (IGMP-Snooping view)
report-aggregation (IGMP-Snooping view)
reset igmp-snooping statistics
router-aging-time (IGMP-Snooping view)
l Support of the H3C WA series WLAN access points (APs) for commands may vary by AP model. For more information, see Feature Matrix.
l The display information varies by AP model and configuration.
l The models listed in this document are not applicable to all regions. Please consult your local sales office for the models applicable to your region.
IGMP Snooping Configuration Commands
display igmp-snooping group
Syntax
display igmp-snooping group [ vlan vlan-id ] [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
vlan vlan-id: Displays the IGMP snooping multicast 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 will display the IGMP snooping multicast group information in all VLANs.
verbose: Specifies to display the detailed IGMP snooping multicast group information.
Description
Use the display igmp-snooping group command to view the IGMP snooping multicast group information.
Examples
# View the detailed IGMP snooping multicast group information in VLAN 2.
<Sysname> display igmp-snooping group vlan 2 verbose
Total 1 IP Group(s).
Total 1 IP Source(s).
Total 1 MAC Group(s).
Port flags: D-Dynamic port, S-Static port, C-Copy port
Subvlan flags: R-Real VLAN, C-Copy VLAN
Vlan(id):2.
Total 1 IP Group(s).
Total 1 IP Source(s).
Total 1 MAC Group(s).
Router port(s):total 1 port.
GigabitEtherne1/0/1 (D) ( 00:01:30 )
IP group(s):the following ip group(s) match to one mac group.
IP group address:224.1.1.1
(0.0.0.0, 224.1.1.1):
Host port(s):total 1 port.
WLAN-BSS1 (D) ( 00:03:23 )
MAC group(s):
MAC group address:0100-5e01-0101
Host port(s):total 1 port.
WLAN-BSS1
Table 1-1 display igmp-snooping group command output description
|
Field |
Description |
|
Total 1 IP Group(s). |
Total number of IP multicast groups |
|
Total 1 IP Source(s). |
Total number of multicast sources |
|
Total 1 MAC Group(s). |
Total number of MAC multicast groups |
|
Port flags: D-Dynamic port, S-Static port, C-Copy port |
Port flags: D for dynamic port, S for static 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 |
|
( 00:01:30 ) |
Remaining time of the dynamic member port or router port aging timer. |
|
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 indicates all multicast sources |
|
MAC group address |
Address of MAC multicast group |
|
Host port(s) |
Number of member ports |
display igmp-snooping statistics
Syntax
display igmp-snooping statistics
View
Any view
Default Level
1: Monitor level
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 display igmp-snooping statistics command 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 |
drop-unknown (IGMP-Snooping view)
Syntax
drop-unknown
undo drop-unknown
View
IGMP-Snooping view
Default Level
2: System level
Parameters
None
Description
Use the drop-unknown command to enable globally the function of dropping unknown multicast data.
Use the undo drop-unknown command to disable globally the function of dropping unknown multicast data.
By default, this function is disabled, that is, unknown multicast data is flooded.
This command works only on an IGMP snooping–enabled VLAN,.
Related commands: igmp-snooping drop-unknown.
Examples
# Globally enable the AP to drop unknown multicast data.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] drop-unknown
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: 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 fast leave processing globally. With this function enabled, when the AP 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.
On an AP that supports IGMP snooping, this command works on only IGMP snooping–enabled VLANs.
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 fast leave processing globally in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] fast-leave vlan 2
group-policy (IGMP-Snooping view)
Syntax
group-policy acl-number [ vlan vlan-list ]
undo group-policy [ vlan vlan-list ]
View
IGMP-Snooping view
Default Level
2: System level
Parameters
acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. The source address or address range specified in the advanced ACL rule 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: 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 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 legal multicast group.
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. 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
# 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 (IGMP-Snooping view)
Syntax
host-aging-time interval
undo host-aging-time
View
IGMP-Snooping view
Default Level
2: System level
Parameters
interval: Dynamic member port aging time, in seconds. The effective range is 200 to 1,000.
Description
Use the host-aging-time command to configure the aging time of dynamic member ports globally.
Use the undo host-aging-time command to restore the default setting.
By default, the aging time of dynamic member ports is 260 seconds.
This command works only on IGMP snooping–enabled VLANs.
Related commands: igmp-snooping host-aging-time.
Examples
# Set the aging time of dynamic member ports 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
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 and drop-unknown.
Examples
# In VLAN 2, enable IGMP snooping and the function of dropping unknown multicast data.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping drop-unknown
igmp-snooping enable
Syntax
igmp-snooping enable
undo igmp-snooping enable
View
VLAN view
Default Level
2: System level
Parameters
None
Description
Use the igmp-snooping enable command to enable IGMP snooping in the current VLAN.
Use the undo igmp-snooping enable command to disable IGMP snooping in the current VLAN.
By default, IGMP snooping is disabled in a VLAN.
IGMP snooping must be enabled globally before it can be enabled in a VLAN.
Related commands: igmp-snooping.
Examples
# Enable IGMP snooping in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
igmp-snooping fast-leave
Syntax
igmp-snooping fast-leave [ vlan vlan-list ]
undo igmp-snooping fast-leave [ vlan vlan-list ]
View
Ethernet interface view
Default Level
2: System level
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 igmp-snooping fast-leave command to enable fast leave processing on the current port. With this function enabled, when the AP 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.
On an AP that supports IGMP snooping, this command works on only IGMP snooping–enabled VLANs.
If you do not specify any VLAN in Ethernet interface 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).
Related commands: fast-leave.
Examples
# Enable fast leave processing on GigabitEthernet 1/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface GigabitEtherne 1/0/1
[Sysname-GigabitEtherne1/0/1] igmp-snooping fast-leave vlan 2
igmp-snooping general-query source-ip
Syntax
igmp-snooping general-query source-ip { ip-address | current-interface }
undo igmp-snooping general-query source-ip
View
VLAN view
Default Level
2: System level
Parameters
ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.
current-interface: Sets the source address of IGMP general queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP general queries.
Description
Use the igmp-snooping general-query source-ip command to configure the source address of IGMP general queries.
Use the undo igmp-snooping general-query source-ip command to restore the default configuration.
By default, the source IP address of IGMP general queries is 0.0.0.0.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable.
Examples
# In VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP general queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1
igmp-snooping group-limit
Syntax
igmp-snooping group-limit limit [ vlan vlan-list ]
undo igmp-snooping group-limit [ vlan vlan-list ]
View
Ethernet interface view
Default Level
2: System level
Parameters
limit: Maximum number of multicast groups that can be joined on a port, in the range of 1 to 16, 16 by default.
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 undo igmp-snooping group-limit command to restore the default setting.
If you do not specify any VLAN in Ethernet interface 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).
Examples
# Specify to allow a maximum of 10 multicast groups to be joined on GigabitEthernet 1/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2
igmp-snooping group-policy
Syntax
igmp-snooping group-policy acl-number [ vlan vlan-list ]
undo igmp-snooping group-policy [ vlan vlan-list ]
View
Ethernet interface view
Default Level
2: System level
Parameters
acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. The source address or address range specified in the advanced ACL rule 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 effective range of a VLAN ID is 1 to 4094.
Description
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 legal multicast group.
If you do not specify any VLAN in Ethernet interface 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). 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
# Configure ACL 2000 as the multicast group filter on GigabitEthernet 1/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2
igmp-snooping host-aging-time
Syntax
igmp-snooping host-aging-time interval
undo igmp-snooping host-aging-time
View
VLAN view
Default Level
2: System level
Parameters
interval: Dynamic member port aging time, in seconds. The effective range is 200 to 1,000.
Description
Use the igmp-snooping host-aging-time command to configure the aging time of dynamic member ports in the current VLAN.
Use the undo igmp-snooping host-aging-time command to restore the default setting.
By default, the aging time of dynamic member ports is 260 seconds.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable and host-aging-time.
Examples
# Enable IGMP snooping and set the aging time of dynamic member ports to 300 seconds in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping host-aging-time 300
igmp-snooping host-join
Syntax
igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id
undo igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id
View
Ethernet interface view
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. 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 port, where vlan-id is in the range of 1 to 4094.
Description
Use the undo igmp-snooping host-join command to remove the current port as a simulated member host for the specified multicast group or source and group.
By default, this function is disabled.
This command works on IGMP snooping–enabled VLANs. The version of IGMP on the simulated host depends on the version of IGMP snooping running in the VLAN.
The source-ip source-address option in the command is meaningful only for IGMP snooping version 3. If IGMP snooping version 2 is running, although you can include source-ip source-address in the command, the simulated host does not respond to a query message.
If configured in Ethernet interface view, this feature takes effect only if the port belongs to the specified VLAN.
Examples
# Configure GigabitEthernet 1/0/1 as a simulated member host in VLAN 2 for multicast source 1.1.1.1 and multicast group 232.1.1.1.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
[Sysname-vlan2] quit
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 232.1.1.1 source-ip 1.1.1.1 vlan 2
igmp-snooping last-member-query-interval
Syntax
igmp-snooping last-member-query-interval interval
undo igmp-snooping last-member-query-interval
View
VLAN view
Default Level
2: System level
Parameters
interval: Interval between IGMP last-member queries, in seconds. The effective range is 1 to 5.
Description
Use the igmp-snooping last-member-query-interval command to configure the interval between IGMP last-member queries in the VLAN.
Use the undo igmp-snooping last-member-query-interval command to restore the default setting.
By default, the IGMP last-member query interval is 1 second.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable and last-member-query-interval.
Examples
# Enable IGMP snooping and set the interval between IGMP last-member queries to 3 seconds in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping last-member-query-interval 3
igmp-snooping max-response-time
Syntax
igmp-snooping max-response-time interval
undo igmp-snooping max-response-time
View
VLAN view
Default Level
2: System level
Parameters
interval: Maximum response time to IGMP general queries, in seconds. The effective range is 1 to 25.
Description
Use the igmp-snooping max-response-time command to configure the maximum response time to IGMP general queries in the VLAN.
Use the undo igmp-snooping max-response-time command to restore the default setting.
By default, the maximum response time to IGMP general queries is 10 seconds.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable, max-response-time, and igmp-snooping query-interval.
Examples
# Enable IGMP snooping and set the maximum response time to IGMP general queries to 5 seconds in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping max-response-time 5
igmp-snooping overflow-replace
Syntax
igmp-snooping overflow-replace [ vlan vlan-list ]
undo igmp-snooping overflow-replace [ vlan vlan-list ]
View
Ethernet interface view
Default Level
2: System level
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 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.
If you do not specify any VLAN in Ethernet interface 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).
Related commands: overflow-replace.
Examples
# Enable the multicast group replacement function on GigabitEthernet 1/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2
igmp-snooping 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.
Examples
# Enable IGMP snooping and the IGMP snooping querier function in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping querier
igmp-snooping query-interval
Syntax
igmp-snooping query-interval interval
undo igmp-snooping query-interval
View
VLAN view
Default Level
2: System level
Parameters
interval: Interval between IGMP general queries, in seconds. The effective range is 2 to 300.
Description
Use the igmp-snooping query-interval command to configure the interval between IGMP general queries.
Use the undo igmp-snooping query-interval command to restore the default setting.
By default, the IGMP general query interval is 60 seconds.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable, igmp-snooping querier, igmp-snooping max-response-time, 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 router-aging-time
Syntax
igmp-snooping router-aging-time interval
undo igmp-snooping router-aging-time
View
VLAN view
Default Level
2: System level
Parameters
interval: Dynamic router port aging time, in seconds. The effective range is 1 to 1,000.
Description
Use the igmp-snooping router-aging-time command to configure the aging time of dynamic router ports in the current VLAN.
Use the undo igmp-snooping router-aging-time command to restore the default setting.
By default, the aging time of dynamic router ports is 105 seconds.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable and router-aging-time.
Examples
# Enable IGMP snooping and set the aging time of dynamic router ports to 100 seconds in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping router-aging-time 100
igmp-snooping special-query source-ip
Syntax
igmp-snooping special-query source-ip { ip-address | current-interface }
undo igmp-snooping special-query source-ip
View
VLAN view
Default Level
2: System level
Parameters
ip-address: Sets the source address of IGMP group-specific queries to the specified address.
current-interface: Sets the source address of IGMP group-specific queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP group-specific queries.
Description
Use the igmp-snooping special-query source-ip command to configure the source IP address of IGMP group-specific queries.
Use the undo igmp-snooping special-query source-ip command to restore the default configuration.
By default, the source IP address of IGMP group-specific queries is 0.0.0.0.
This command takes effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable.
Examples
# In VLAN 2, enable IGMP snooping and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1
igmp-snooping static-group
Syntax
igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id
undo igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id
View
Ethernet interface view
Default Level
2: System level
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 the 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 port, where vlan-id is in the range of 1 to 4094.
Description
Use the igmp-snooping static-group command to configure the static (*, G) or (S, G) joining function, namely to configure the current port as a static multicast group or source-group member.
Use the undo igmp-snooping static-group command to restore the system default.
By default, no ports are static member ports.
The source-ip source-address option in the command is meaningful only for IGMP snooping version 3. If IGMP snooping version 2 is running, although you can include the source-ip source-address option in your command, the configuration will not take effect.
If configured in Ethernet interface view, this feature takes effect only if the port belongs to the specified VLAN.
Examples
# Configure GigabitEthernet 1/0/1 in VLAN 2 to be a static member port for (1.1.1.1, 232.1.1.1).
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
[Sysname-vlan2] quit
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping static-group 232.1.1.1 source-ip 1.1.1.1 vlan 2
igmp-snooping static-router-port
Syntax
igmp-snooping static-router-port vlan vlan-id
undo igmp-snooping static-router-port vlan vlan-id
View
Ethernet interface view
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 system default.
By default, no ports are static router ports.
If configured in Ethernet interface view, this feature takes effect only if the port belongs to the specified VLAN.
Examples
# Enable the static router port function on GigabitEthernet 1/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2
igmp-snooping version
Syntax
igmp-snooping version version-number
undo igmp-snooping version
View
VLAN view
Default Level
2: System level
Parameters
version-number: IGMP snooping version, in the range of 2 to 3.
Description
Use the igmp-snooping version command to configure the IGMP snooping version.
Use the undo igmp-snooping version command to restore the default setting.
By default, the IGMP snooping version is 2.
This command can take effect only if IGMP snooping is enabled in the VLAN.
Related commands: igmp-snooping enable.
Examples
# Enable IGMP snooping in VLAN 2, and set the IGMP snooping version to version 3.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
last-member-query-interval (IGMP-Snooping view)
Syntax
last-member-query-interval interval
undo last-member-query-interval
View
IGMP-Snooping view
Default Level
2: System level
Parameters
interval: Interval between IGMP last-member queries, in seconds. The effective range is 1 to 5.
Description
Use the last-member-query-interval command to configure the interval between IGMP last-member queries globally.
Use the undo last-member-query-interval command to restore the default setting.
By default, the interval between IGMP last-member queries is 1 second.
This command works only on IGMP snooping–enabled VLANs.
Related commands: igmp-snooping last-member-query-interval.
Examples
# Set the interval between IGMP last-member queries globally to 3 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] last-member-query-interval 3
max-response-time (IGMP-Snooping view)
Syntax
max-response-time interval
undo max-response-time
View
IGMP-Snooping view
Default Level
2: System level
Parameters
interval: Maximum response time to IGMP general queries, in seconds. The effective range is 1 to 25.
Description
Use the max-response-time command to configure the maximum response time to IGMP general queries globally.
Use the undo max-response-time command to restore the default value.
This command works only on IGMP snooping–enabled VLANs.
Related commands: igmp-snooping max-response-time and igmp-snooping query-interval.
Examples
# Set the maximum response time to IGMP general queries globally to 5 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] max-response-time 5
overflow-replace (IGMP-Snooping view)
Syntax
overflow-replace [ vlan vlan-list ]
undo overflow-replace [ vlan vlan-list ]
View
IGMP-Snooping view
Default Level
2: System level
Parameters
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 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.
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 (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.
On an AP that supports IGMP snooping, this command works on only IGMP snooping–enabled VLANs.
Examples
# Disable IGMP report suppression.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] undo report-aggregation
reset igmp-snooping group
Syntax
reset igmp-snooping group { group-address | all } [ vlan vlan-id ]
View
User view
Default Level
2: System level
Parameters
group-address: 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 multicast group information.
vlan vlan-id: Clears the IGMP snooping multicast group information in the specified VLAN. The effective range of vlan-id is 1 to 4094.
Description
Use the reset igmp-snooping group command to clear IGMP snooping multicast group information.
This command works only on IGMP snooping–enabled VLANs. It cannot clear IGMP snooping multicast group information of static joins.
Examples
# Clear all IGMP snooping multicast group information.
<Sysname> reset igmp-snooping group all
reset igmp-snooping statistics
Syntax
reset igmp-snooping statistics
View
User view
Default Level
2: System level
Parameters
None
Description
Use the reset igmp-snooping statistics command to clear the statistics information of IGMP messages learned by IGMP snooping.
Examples
# Clear the statistics information of all kinds of IGMP messages learned by IGMP snooping.
<Sysname> reset igmp-snooping statistics
router-aging-time (IGMP-Snooping view)
Syntax
router-aging-time interval
undo router-aging-time
View
IGMP-Snooping view
Default Level
2: System level
Parameters
interval: Dynamic router port aging time, in seconds. The effective range is 1 to 1,000.
Description
Use the router-aging-time command to configure the aging time of dynamic router ports globally.
Use the undo router-aging-time command to restore the default setting.
By default, the aging time of dynamic router ports is 105 seconds.
This command works only on IGMP snooping–enabled VLANs.
Related commands: igmp-snooping router-aging-time.
Examples
# Set the aging time of dynamic router ports globally to 100 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] router-aging-time 100
