更新时间：2023-12-07
1IGMP-SNOOPING配置命令
IGMP-SNOOPING配置命令包括：
• ip igmp-snooping
• ip igmp-snooping static
• ip igmp-snooping immediate-leave
• ip igmp-snooping mrouter
• ip igmp-snooping dlf-drop
• ip igmp-snooping policy
• ip igmp-snooping router age
• ip igmp-snooping response time
• ip igmp-snooping querier
• ip igmp-snooping querier timer
• ip igmp-snooping forward-l3-to-mrouter
• ip igmp-snooping sensitive
• ip igmp-snooping v3-leave-check
• ip igmp-snooping forward-wrongiif-within-vlan
• ip igmp-snooping limit
• show ip igmp-snooping
• show ip igmp-snooping vlan
• show ip igmp-snooping timer
• show ip igmp-snooping groups
• show ip igmp-snooping statistics
• debug ip igmp-snooping packet
• debug ip igmp-snooping timer
• debug ip igmp-snooping event
• debug ip igmp-snooping error
• debug ip igmp-snooping
1.1.1igmp-snooping
命令描述
ip igmp-snooping [ vlan vlan_id ]
no ip igmp-snooping [ vlan vlan_id ]
配置VLAN的IGMP-snooping功能开启和关闭，no命令恢复到默认值。
参数
| 参数 |
参数说明 |
| vlan id |
VLAN标识。取值范围：1-4094。 |
缺省
关闭指定vlan的igmp-snooping 功能。
说明
如果不指定vlan参数，则开启和关闭动作将对系统中所有的vlan（包括后来创建的）生效(IGMP-snooping目前最大支持在16个VLAN上同时运行)。
示例
下面的命令将开启VLAN 1的IGMP snooping功能：
switch_config# ip igmp-snooping vlan 1
switch_config#
1.1.2igmp-snooping static
命令描述
ip igmp-snooping vlan vlan_id static A.B.C.D interface intf
no ip igmp-snooping vlan vlan_id static A.B.C.D interface intf
参数
| 参数 |
参数说明 |
| vlan id |
VLAN标识。取值范围：1-4094。 |
| A.B.C.D |
组播IP地址。 |
| inft |
端口 。 |
缺省
无
说明
配置VLAN的静态组播地址，no命令删除地址。
示例
下面的命令将在VLAN 2的G1/5号快速以太网端口上添加静态组播地址234.5.6.7
switch_config# ip igmp-snooping vlan 2 static 234.5.6.7 interface gigaEthernet1/5
switch_config#
注意：
224.0.0.0-224.0.0.255作为不可路由的组播地址，不能被注册到各端口上。
1.1.3igmp-snooping immediate-leave
命令描述
全局配置模式下：
ip igmp-snooping vlan vlan_id immediate-leave
no ip igmp-snooping vlan vlan_id immediate-leave
配置VLAN的immediate-leave特性，no命令恢复到默认值。
参数
| 参数 |
参数说明 |
| vlan id |
VLAN标识 。取值范围：1-4094。 |
缺省
关闭immediate-leave特性。
接口配置模式下：
ip igmp-snooping immediate-leave
no ip igmp-snooping immediate-leave
配置端口的immediate-leave特性，no命令恢复到默认值。
参数
无。
缺省
关闭immediate-leave特性。
说明
配置VLAN或端口的immediate-leave特性可以使交换机在该端口收到leave 报文后立即从对应组播组的端口列表中删除该端口，而不再开启定时器等待是否还有其他主机加入了这个组播。如果同一端口下的其他主机也属于这个组但并不想离开，这些用户的组播通信可能会受到影响，此时不应启用immediate-leave功能。
端口的immediate-leave配置和VLAN下的immediate-leave配置同时起作用。
示例
下面的命令将开启VLAN 1的immediate-leave特性：
switch_config# ip igmp-snooping vlan 1 immediate-leave
switch_config#
下面的命令将开启端口g0/8的immediate-leave特性：
switch_config_g0/8#ip igmp-snooping immediate-leave
1.1.4igmp-snooping mrouter
命令描述
ip igmp-snooping vlan vlan_id mrouter interface intf
no ip igmp-snooping vlan vlan_id mrouter interface intf
参数
| 参数 |
参数说明 |
| vlan id |
VLAN标识。取值范围：1-4094。 |
| intf |
端口。 |
缺省
无
说明
配置VLAN的静态路由端口，no命令删除路由端口。
只能为已经存在的vlan配置静态路由端口。
示例
下面的命令将在VLAN 2的G1/5号千兆以太网端口添加为VLAN 2的静态路由端口
switch_config# ip igmp-snooping vlan 2 mrouter interface GigaEthernet1/5
switch_config#
1.1.5igmp-snooping policy
命令描述
ip igmp-snooping policy word
no ip igmp-snooping policy
参数
缺省
无
说明
配置igmp-snooping在添加组播转发表时要检测的IP ACL列表，用于指定端口下收到的哪些目的地址的组播报文需要处理或忽略；no取消对该列表的检测。 在配置该命令时ipacl必须已经存在。
示例
下面的命令将配置添加组播转发表时检测名为123的IP ACl。
switch_config# ip igmp-snooping policy 123
switch_config#
1.1.6igmp-snooping dlf-drop
命令描述
ip igmp-snooping dlf-drop
no ip igmp-snooping dlf-drop
参数
缺省
无
说明
配置交换机对目的组播地址未注册的组播报文的处理方式为过滤模式，no命令恢复到默认设置（vlan内广播）。
示例
下面的命令将配置在所有vlan内丢弃目的地址未注册的组播报文。
switch_config# ip igmp-snooping dlf-drop
switch_config#
1.1.7igmp-snooping router age
命令描述
ip igmp-snooping timer router-age timer_value
no ip igmp-snooping timer router-age
参数
| 参数 |
参数说明 |
| time value |
查询定时器时间 ，取值范围：10 – 2147483647。 |
缺省
260 秒
说明
配置igmp-snooping的查询定时器时间，no命令恢复到默认值。
示例
下面的命令将配置路由器端口查询时间为300秒。
switch_config# ip igmp-snooping timer router-age 300
switch_config#
1.1.8igmp-snooping response time
命令描述
ip igmp-snooping timer response-time timer_value
no ip igmp-snooping timer response-time
配置 IGMP-snooping的最大响应时间，no命令恢复为默认值。
参数
| 参数 |
参数说明 |
| time value |
查询定时器时间 。取值范围：1-2147483647。 |
缺省
15 秒
说明
无
示例
下面的命令将配置响应查询时间为20秒。
switch_config# ip igmp-snooping timer response-time 20
switch_config#
1.1.9igmp-snooping querier
命令描述
ip igmp-snooping querier [address <ip_addr>]
no ip igmp-snooping querier [address <ip_addr>]
激活IGMP-snooping querier机制，或设置自发query报文的源ip地址，no命令恢复为默认值。
参数
缺省
不启动Querier功能，源IP地址默认为10.0.0.200。
说明
无
示例
下面的命令将激活IGMP querier，使之在没有组播路由器的情况下代替其工作。
switch_config# ip igmp-snooping querier
switch_config#
1.1.10igmp-snooping querier querier-timer
命令描述
ip igmp-snooping querier querier-timer time_value
no ip igmp-snooping querier querier-timer
设置本地querier发送query报文的发送间隔，no命令恢复为默认值。
参数
| 参数 |
参数说明 |
| time_value |
本地querier查询间隔 |
缺省
启动Querier功能的情况下，默认间隔为200秒
说明
无
示例
下面的命令将本地querier的查询周期设置为140秒。
switch_config# ip igmp-snooping querier querier-timer 140
switch_config#
1.1.11igmp-snooping forward-l3-to-mrouter
命令描述
ip igmp-snooping forward-l3-to-mrouter
no ip igmp-snooping forward-l3-to-mrouter
开启该命令可以将数据报文送往多播路由端口，no命令恢复为默认值。
参数
无
缺省
不开启forward-l3-to-mrouter，数据报文不会转发给相关的多播路由端口。
说明
该命令主要是将数据报文在送往igmp join端口的同时，将多播数据报文送往多播路由端口；特别是在三层多播级联的情况下，上游三层交换机无法收到相关组的igmp join报文，因而就无法学到该组的信息，这时会把报文向三层出口vlan内的所有物理端口发送；开启该命令后，数据报文仅会送往PIM-SM注册的多播路由器端口。
示例
下面的命令将激活IGMP forward-l3-to-mrouter，使上游的组播数据报文转发给多播路由端口。
switch_config# ip igmp-snooping forward-l3-to-mrouter
switch_config#
1.1.12igmp-snooping sensitive
命令描述
ip igmp-snooping sensitive [value int<3-30>]
no ip igmp-snooping sensitive [value]
激活IGMP-snooping sensitive机制，或设置sensitive的value值；no命令停止IGMP-snooping sensitive机制，或恢复sensitive的value值为默认值。
参数
缺省
不启动sensitive功能。sensitive的value默认值为5秒。
说明
该命令主要是在trunk模式的端口shutdown时，使用该命令修改处于active状态下的mrouter端口的router-age时间，快速发送新的query报文。
示例
下面的命令将激活IGMP sensitive，使mrouter的router-age时间更为收敛。
switch_config# ip igmp-snooping sensitive
switch_config# ip igmp-snooping sensitive value 10
1.1.13igmp-snooping v3-leave-check
命令描述
ip igmp-snooping v3-leave-check
no ip igmp-snooping v3-leave-check
开启该命令收到v3的leave报文后，发送special query报文，no命令恢复为默认值。
参数
无
缺省
不开启v3-leave-check，收到v3 leave报文后不发送special query报文。
说明
无
示例
下面的命令将激活IGMP v3-leave-check，收到v3报文后发送special query报文。
switch_config# ip igmp-snooping v3-leave-check
switch_config#
1.1.14igmp-snooping forward-wrongiif-within-vlan
命令描述
ip igmp-snooping forward-wrongiif-within-vlan
no ip igmp-snooping forward-wrongiif-within-vlan
开启该命令后从wrongiif端口收到的组播数据报文在本vlan内发送到相关物理端口，no命令恢复为默认值。
参数
无
缺省
开启，将wrongiif端口的组播数据报文转发到相关的物理端口。
说明
该命令只有在三层组播开启时才有意义。开启该命令后，从wrongiif端口进入的组播数据报文发送给在wrongiif的vlan下加入了组的物理端口，否则报文被丢弃。
示例
下面的命令将激活IGMP forward-wrongiif-within-vlan，收到wrongiif端口的组播数据报文被转发到本vlan下的相关物理端口。
switch_config# ip igmp-snooping forward-wrongiif-within-vlan
switch_config#
1.1.15igmp-snooping filter
命令描述
ip igmp-snooping filter word
no ip igmp-snooping filter
参数
缺省
无
说明
如果启用IGMP-snooping的端口下IPACL功能，则将在端口下使用IPACL来指定某组播IP地址的报文需要处理或忽略。
配置状态
端口配置
示例
下面的命令在端口g0/2下配置IP ACL deny-pc：
switch_config#ip access-list standard deny-pc
switch_config_std#deny 239.255.255.250 255.255.255.255
switch_config_std#permit any
switch_config_std#exit
switch_config#interface g0/2
switch_config_g0/2#ip igmp-snooping filter deny-pc
1.1.16igmp-snooping vlan filter
命令描述
ip igmp-snooping vlan vlanid-list filter ipaddr-list
no ip igmp-snooping vlan vlanid-list filter ipaddr-list
参数
| 参数 |
参数说明 |
| Vlanid-list |
VLAN ID列表, 用“，”和“-”连接。1-4094 |
| ipaddr-list |
多播IP地址列表，用“，”和“-”连接（“，”和“-”须跟至少1个空格）。 |
缺省
无
说明
如果启用IGMP-snooping的VLAN下的组播过滤功能，则在VLAN下只有过滤列表中的组播组report请求才被接受并加组，否则被丢弃并且不加组。
配置状态
全局配置
示例
下面的命令在VLAN 2下的过滤列表：
switch_config#ip igmp-snooping vlan 2 filter 230.1.1.1 - 230.1.1.100
1.1.17igmp-snooping limit
命令描述
ip igmp-snooping limit value
no ip igmp-snooping limit
参数
缺省
2048
说明
配置IGMP-snooping的端口下最大组播IP地址数量功能则会在IGMP-snooping生成转发表项时判断该端口下已申请的组是否达到了该配置的数量，若超过该数目则不再生成该端口的表项。
配置状态
端口配置
示例
下面的命令将端口下所能加入组的最大数量设为1000。
switch_config_G1/1# ip igmp-snooping limit 1000
switch_config_G1/1#
1.1.18igmp-snooping report-suppression
命令描述
ip igmp-snooping report-suppression [max-number value]
no ip igmp-snooping report-suppression
参数
| 参数 |
参数说明 |
| value |
该参数指定开启report-suppression后，同一VLAN内对同一组播组在一个query周期内转发report的最大数目。取值为1-5．若配置该命令，但忽略max-number关键字，则最大report转发数为1。 |
缺省
该功能关闭。
说明
如果配置了IGMP-snooping的report-suppression功能，则同一VLAN中，对一个组播组的report请求，无论是客户端初始状态下主动发起，还是对query的应答，交换机只向mrouter端口转发有限的个数。转发个数由max-number后的参数决定，范围为1-5。若省略max-number关键字，则转发个数缺省为1。
此功能是为了保证IGMP Snooping功能正常的情况下，减轻本交换机和上游交换机的处理开销，节省转发report报文的带宽。
配置状态
全局配置
示例
下面的命令将开启IGMP-snooping的report-suppression功能。
switch_config# ip igmp-snooping report-suppression
switch_config#
1.1.19igmp-snooping proxy-leave
命令描述
ip igmp-snooping proxy-leave
no ip igmp-snooping proxy-leave
参数
无。
缺省
该功能关闭。
说明
如果配置了IGMP-snooping的proxy-leave功能，则同一VLAN中，只有当一个组播组的成员全部真正离组后，才由交换机向上游设备发送该组播组的leave报文。
此功能是为了保证IGMP Snooping功能正常的情况下，减轻本交换机和上游交换机的处理开销，节省转发leave的带宽。
配置状态
全局配置
示例
下面的命令将开启IGMP-snooping的proxy-leave功能。
switch_config# ip igmp-snooping proxy-leave
switch_config#
1.1.20show ip igmp-snooping
命令描述
show ip igmp-snooping
参数
无
缺省
无
说明
显示 IGMP-snooping的配置信息。
示例
下面的命令将显示运行igmp-snooping的各vlan的信息
switch_config# show ip igmp-snooping
Global IGMP snooping configuration:
-----------------------------------
Globally enable : Enabled
VLAN nodes : 1,50,100,200,400,500
Dlf-frames filtering : Disabled
Sensitive : Disabled
Querier : Enabled
Querier address : 10.0.0.200
Querier interval : 140 s
Router age : 260 s
Response time : 15 s
vlan_id Immediate-leave Ports Router Ports
--------------------------------------------------------------
1 Disabled 5-10 SWITCH(querier);
50 Disabled 1-4 SWITCH(querier);
100 Disabled NULL SWITCH(querier);G0/1(static);
200 Disabled NULL SWITCH(querier);
400 Disabled NULL SWITCH(querier);
500 Disabled NULL SWITCH(querier);
switch_config#
1.1.21show ip igmp-snooping timer
命令描述
show ip igmp-snooping timer
参数
无
缺省
无
说明
显示 IGMP-snooping的定时器信息。
示例
下面的命令将显示igmp-snooping的定时器信息。
switch_config# show ip igmp-snooping timer
vlan 1 mrouter on port 3 : 251
switch_config#
1.1.22show ip igmp-snooping groups
命令描述
show ip igmp-snooping groups
参数
无
缺省
无
说明
显示IGMP-snooping的多播组信息。
示例
下面的命令将显示igmp-snooping的多播组信息。
switch_config# show ip igmp-snooping groups
The total number of groups 2
Vlan Group Type Port(s)
---- --------------- ---- ----------------------------------------------------
1 226.1.1.1 IGMP G1/1 G0/3
1 225.1.1.16 IGMP G1/1 G0/3
switch_config#
1.1.23show ip igmp-snooping groups interface
命令描述
show ip igmp-snooping groups interface
参数
无
缺省
无
说明
显示端口所加的IGMP-snooping的多播组信息。
示例
下面的命令将显示端口g0/4所加igmp-snooping多播组信息。
Switch#show ip igmp-snooping groups interface g0/4
Number of joined groups: 1
Vlan Group Mode Source Num
---- --------------- ------- ----------
2 230.1.1.1 Exclude 0
Switch#
1.1.24show ip igmp-snooping statistics
命令描述
show ip igmp-snooping statistics [message|packet|hardware|vlan vlanid]
参数
| 参数 |
参数说明 |
| vlanid |
当命令带可选关键字VLAN时，指定vlan ID。 |
缺省
无
说明
显示 IGMP-snooping的统计信息。关键字messge、packet、hardware、VLAN可选。若带可选关键字，则分别显示IGMP-Snooping任务接收的消息统计、接收报文统计、硬件操作统计，以及分VLAN的统计。不带可选关键字时，显示全局的消息、报文和硬件操作统计。带关键字VLAN时，需要指定参数vlanid，显示该VLAN下的统计。
示例
下面的命令将显示igmp-snooping的统计信息 。
Switch#show ip igmp-snooping statistics
IGMP Snooping Message Statistics
------------------------------------
L2 main messages sent OK : 305
L2 main messages sent failed : 0
L2 packets received : 302
L2 packets sent : 302
L2 packets sent failed : 0
L2 link-status messages : 3
IGMP Snooping messages received: 313
IGMP packet messages received : 302
IGMP Snooping Packet Statistics
-----------------------------------------
Received packets : 302
IGMP packets : 259
M-routing protocol packets : 0
Other packets : 43
Received IGMP general queries : 0
Received IGMPv2 specific queries : 0
Received IGMPv3 g specific queries : 0
Received IGMPv3 gs specific queries: 0
Received IGMPv1 reports : 0
Received IGMPv2 reports : 230
Received IGMP leaves : 0
Received IGMPv3 reports : 29
Flooded queries : 0
Forwarded and proxy-sent reports : 0
Forwarded and proxy-sent leaves : 0
IGMP Snooping Hardware Operation Statistics
-------------------------------------------
Total : 9
Succeeded : 9
Failed : 0
Report/leave processing: 5
Response timer expiring: 4
Group creating/updating: 7
Group deleting : 2
1.1.25show ip igmp-snooping vlan
命令描述
show ip igmp-snooping vlan vlan-id
参数
缺省
无
说明
显示 IGMP-snooping的vlan有关信息。
示例
下面的命令将显示igmp-snooping的vlan信息 。
Switch_config#show ip igmp-snooping vlan
vlan_id Immediate-leave Ports Router Ports
-----------------------------------------------------------------
1 Disabled 7-30
2 Disabled NULL
switch_config#
1.1.26debug ip igmp-snooping packet
命令描述
debug ip igmp-snooping packet
no debug ip igmp-snooping packet
参数
无
缺省
无
说明
打开/关闭 IGMP-snooping的packet调试开关。
示例
下面的命令将打开igmp-snooping的packet调试开关。
switch# debug ip igmp-snooping packet
switch#
1.1.27debug ip igmp-snooping timer
命令描述
debug ip igmp-snooping timer
no debug ip igmp-snooping timer
参数
无
缺省
无
说明
打开/关闭 IGMP-snooping的timer调试开关。
示例
下面的命令将打开igmp-snooping的timer调试开关。
switch# debug ip igmp-snooping timer
switch#
1.1.28debug ip igmp-snooping event
命令描述
debug ip igmp-snooping event
no debug ip igmp-snooping event
参数
无
缺省
无
说明
打开/关闭igmp-snooping的event调试开关
示例
下面的命令将打开igmp-snooping的event调试开关
Switch#debug ip igmp-snooping event
Switch#
1.1.29debug ip igmp-snooping error
命令描述
debug ip igmp-snooping error
no debug ip igmp-snooping error
参数
无
缺省
无
说明
打开/关闭igmp-snnoping的error调试开关
示例
下面的命令将打开igmp-snooping的error调试开关
Switch#debug ip igmp-snooping error
Switch#
1.1.30debug ip igmp-snooping
命令描述
debug ip igmp-snooping
no debug ip igmp-snooping
参数
无
缺省
无
说明
打开/关闭igmp-snnoping的所有调试开关
示例
下面的命令将打开igmp-snooping的所有调试开关
Switch#debug ip igmp-snooping
IGMP-snooping packet debugging is on
IGMP-snooping timer debugging is on
IGMP-snooping event debugging is on
IGMP-snooping error debugging is on
Switch#
