- Table of Contents
-
- 04-IP Multicast Volume
- 00-IP Multicast Volume Organization
- 01-Multicast Routing and Forwarding Commands
- 02-IGMP Commands
- 03-PIM Commands
- 04-MSDP Commands
- 05-MBGP Commands
- 06-Multicast VPN Commands
- 07-IGMP Snooping Commands
- 08-Multicast VLAN Commands
- 09-IPv6 Multicast Routing and Forwarding Commands
- 10-MLD Commands
- 11-IPv6 PIM Commands
- 12-IPv6 MBGP Commands
- 13-MLD Snooping Commands
- 14-IPv6 Multicast VLAN Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
07-IGMP Snooping Commands | 136.53 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)
source-deny (IGMP-Snooping view)
l Configurations made in IGMP Snooping view are effective for all VLANs, while configurations made in VLAN view are effective only for ports belonging to the current VLAN. For a given VLAN, a configuration made in IGMP Snooping view is effective only if the same configuration is not made in VLAN view.
l Configurations made in IGMP Snooping view are effective for all ports; configurations made in Ethernet interface view are effective only for the current port; configurations made in Layer 2 aggregate interface view are effect only for the current interface; configurations made in port group view are effective only for all the ports in the current port group. For a given port, a configuration made in IGMP Snooping view is effective only if the same configuration is not made in Ethernet interface view, Layer 2 aggregate interface view or port group view.
l An IGMP Snooping configuration made on a Layer 2 aggregate interface is independent of the same configuration made on its member ports and is not involved in aggregation calculations. The member ports run the configuration made on the Layer 2 aggregate interface they belong to, and the configuration made on a member port takes effect only when the port is removed from the aggregate group.
IGMP Snooping Configuration Commands
display igmp-snooping group
Syntax
display igmp-snooping group [ vlan vlan-id ] [ slot slot-number ] [ 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.
slot slot-number: Displays the IGMP Snooping multicast group information for the specified card. If you do not specify a slot, this command will display the IGMP Snooping multicast group information on the SRPU.
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 unit board: Mask(0x8 3)
Router port(s):total 1 port.
Eth2/0/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(0x8 3)
Host port(s):total 1 port.
Eth2/0/2 (D)
MAC group(s):
MAC group address:0100-5e01-0101
Host port unit board: Mask(0x8 3)
Host port(s):total 1 port.
Eth2/0/2
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. On a distributed device, to get this time value of a non-aggregation port that does not belong to the SRPU, 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), where 0.0.0.0 implies any multicast source |
MAC group address |
Address of MAC multicast group |
Attribute |
Attribute of IP multicast group |
Host port(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 IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.
Related commands: igmp-snooping drop-unknown.
Examples
# Globally enable the device 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.
Use the undo fast-leave command to disable fast leave processing globally.
By default, fast leave processing is disabled.
Note that:
l This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
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.
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.
When defining an advanced ACL, include in the rule command only the source and destination keywords without other rule information 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 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 valid 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
# Apply ACL 2000 as a 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, 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
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, so that such multicast data will only be forwarded to router ports.
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, Layer 2 aggregate interface view, port group 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 or group of ports.
Use the undo igmp-snooping fast-leave command to disable fast leave processing on the current port or group of ports.
By default, fast leave processing is disabled.
Note that:
l This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
l If you do not specify any VLAN when using this command in Ethernet interface view or Layer 2 aggregate interface view, the command will take effect for all VLANs the interface belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the interface belongs to the specified VLAN(s).
l If you do not specify any VLAN when using this command in port group view, the command will take effect on all the ports in this group; if you specify a VLAN or multiple VLANs, the command will take effect only on those ports in this group that belong to the specified VLAN(s).
Related commands: fast-leave.
Examples
# Enable fast leave processing on Ethernet 2/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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
Default Level
2: System level
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.
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] qui
[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, 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, in the range 1 to 1000.
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.
The default setting depends on the specific product model.
Note that:
l For a switch that supports both IGMP Snooping and IGMP, you can also use the igmp group-limit command to limit the number of multicast groups that can be joined on an interface. However, if you configure a limit of the number of groups for ports in a VLAN while you have configured a limit of the number of groups for the VLAN interface of the same VLAN, or vice versa, this may cause inconsistencies between Layer 2 and Layer 3 table entries. Therefore, it is recommended to configure a limit of the number of multicast groups only on the VLAN interface..
l If you do not specify any VLAN when using this command in Ethernet interface view or Layer 2 aggregate interface view, the command will take effect for all VLANs the interface belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the interface belongs to the specified VLAN(s).
l If you do not specify any VLAN when using this command in port group view, the command will take effect on all the ports in this group; if you specify a VLAN or multiple VLANs, the command will take effect only 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 Ethernet 2/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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, 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. 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(s).
By default, no multicast group filter is configured on an interface, namely a host can join any valid multicast group.
Note that:
l If you do not specify any VLAN when using this command in Ethernet interface view or Layer 2 aggregate interface view, the command will take effect for all VLANs the interface belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the interface belongs to the specified VLAN(s).
l If you do not specify any VLAN when using this command in port group view, the command will take effect on all the ports in this group; if you specify a VLAN or multiple VLANs, the command will take effect only 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
# Apply ACL 2000 as a multicast group filter on Ethernet 2/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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 , 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, 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. 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(s), 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(s) as simulated member host(s) for the specified multicast group or source and group.
By default, this function is disabled.
Note that:
l 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 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 interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface 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 Ethernet 2/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 ethernet 2/0/1
[Sysname-Ethernet2/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, 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, 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, Layer 2 aggregate interface view, port group 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(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:
l This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
l Be sure to configure the maximum number of multicast groups allowed on a port which cannot be the default value 1000 (refer to igmp-snooping group-limit ) before enabling multicast group replacement. Otherwise, the multicast group replacement functionality will not take effect.
l If you do not specify any VLAN when using this command in Ethernet interface view or Layer 2 aggregate interface view, the command will take effect for all VLANs the interface belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the interface belongs to the specified VLAN(s).
l If you do not specify any VLAN when using this command in port group view, the command will take effect on all the ports in this group; if you specify a VLAN or multiple VLANs, the command will take effect only on those ports in this group that belong to the specified VLAN(s).
Related commands: overflow-replace.
Examples
# Enable the multicast group replacement function on Ethernet 2/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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.
Note that:
l This command takes effect only if IGMP Snooping is enabled in the VLAN.
l This command does not take effect in a sub-VLAN of a multicast VLAN.
Related commands: igmp-snooping enable; subvlan in Multicast VLAN Commands in the IP Multicast Volume.
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, 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, 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 source-deny
Syntax
igmp-snooping source-deny
undo igmp-snooping source-deny
View
Ethernet interface view, port group view
Default Level
2: System level
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.
This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
Examples
# Enable source port filtering for multicast data on Ethernet 2/0/1.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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
Default Level
2: System level
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.
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] qui
[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, Layer 2 aggregate interface view, port group view
Default Level
2: System level
Parameters
group-address: Address of the multicast group to be statically joined, in the range of 224.0.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(s), 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 or port group as static multicast group or source-group member(s).
Use the undo igmp-snooping static-group command to restore the system default.
By default, no ports are static member ports.
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 interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface 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 Ethernet 20/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 ethernet 2/0/1
[Sysname-Ethernet2/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, 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(s) as static router port(s).
Use the undo igmp-snooping static-router-port command to restore the system default.
By default, no ports are static router ports.
Note that:
l This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
l This command does not take effect in a sub-VLAN of a multicast VLAN.
l If configured in Ethernet interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface 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.
Related commands: subvlan in Multicast VLAN Commands in the IP Multicast Volume.
Examples
# Enable the static router port function on Ethernet 2/0/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface ethernet 2/0/1
[Sysname-Ethernet2/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.
Note that:
l This command can take effect only if IGMP Snooping is enabled in the VLAN.
l This command does not take effect in a sub-VLAN of a multicast VLAN.
Related commands: igmp-snooping enable; subvlan in Multicast VLAN Commands in the IP Multicast Volume.
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, 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 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 their 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 (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.
Note that:
l This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
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.
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 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.
Note that:
l This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on their VLAN interfaces.
l This command 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, 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
source-deny (IGMP-Snooping view)
Syntax
source-deny port interface-list
undo source-deny port interface-list
View
IGMP-Snooping view
Default Level
2: System level
Parameters
interface-list: Specifies one or multiple ports. You can provide up to ten port lists, by each of which you can specify an individual port in the form of interface-type interface-number, or a port range in the form of interface-type start-interface-number to interface-type end-interface-number, where the end interface number must be greater than the start interface 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.
This command works on both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on their VLAN interfaces.
Examples
# Enable source port filtering for multicast data on interfaces Ethernet 2/0/1 through Ethernet 2/0/4.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] source-deny port ethernet 2/0/1 to ethernet 2/0/4