Command Line Reference
IP Multicast
IGMP Snooping Configuration
31 min
show l2 multicast table show l2 multicast table \[command] show l2 multicast table \[purpose] view information about a multicast group \[view] system view \[use cases] sonic# show l2 multicast table total l2 multicast forwarding group counters 2 (source,group) interface vlan \ (0 0 0 0, 224 1 1 1) ethernet31 20 ethernet30 20 show vlan igmp snooping show vlan igmp snooping \[command] show vlan igmp snooping \[ vlan id ] \[purpose] display igmp snooping information \[view] system view \[use cases] sonic# show vlan igmp snooping + + + + + + + + + + + + \| vlan id | igmp snp | proxy | version | fast leave | querier | querier ip | robustness | query interval(s) | last member query interval(ms) | query max response time(s) | +===========+============+==========+===========+==============+===========+==============+==============+=====================+==================================+==============================+ \| vlan1000 | enabled | disabled | 2 | disabled | disabled | 0 0 0 0 | 2 | 125 | 1000 | 10 | + + + + + + + + + + + + show vlan igmp snooping mrouter show vlan igmp snooping mrouter \[command] show vlan igmp snooping mrouter \[purpose] display the router port information of igmp snooping \[view] system view \[use cases] sonic# show vlan igmp snooping mrouter + + + + \| vlan id | mrouter | type | +===========+============+========+ \| 20 | ethernet32 | static | + + + + show vlan igmp snoopingmrouter aging show vlan igmp snoopingmrouter aging \[command] show vlan igmp snooping mrouter aging \[purpose] show router port aging time for igmp snooping \[view] system view \[use cases] sonic# show vlan igmp snooping mrouter aging + + + \| vlan id | aging time | +===========+==============+ \| 20 | 180 | + + + \| 200 | 180 | + + + \| 800 | 180 | + + + show ip igmp show ip igmp \[command] show ip igmp \[ vrf { all |< vrf name >}] { join | groups | interface } \[purpose] show the statically configured igmp entries, multicast groups, and querier interface information on the interface \[view] system view \[use cases] sonic# show ip igmp interface interface state address v querier querierip query timer uptime ethernet49 mtrc 20 1 1 2 3 other 20 1 1 2 07 05 57 vlan1000 up 123 1 1 1 3 local 123 1 1 1 00 00 06 01 59 11 sonic# sonic# show ip igmp join interface address source group socket uptime vlan1000 123 1 1 1 120 1 1 122 224 1 1 1 27 00 06 33 sonic# sonic# show ip igmp groups total igmp groups 4 watermark warn limit(not set) 0 interface group mode timer srcs v uptime vlan1000 225 1 3 1 incl 1 3 01 59 16 vlan1000 225 1 3 2 incl 1 3 01 59 16 vlan1000 225 1 3 3 incl 1 3 01 59 16 vlan1000 224 1 1 1 incl 1 3 00 06 40 show ip igmp statistics show ip igmp statistics \[command] show ip igmp statistics \[purpose] show the statistics of received igmp packets \[view] system view \[use cases] sonic# show ip igmp statistics igmp rx statistics interface global v1 query 0 v2 query 0 v3 query 0 v2 leave 0 v1 report 0 v2 report 0 v3 report 130 mtrace response 0 mtrace request 0 unsupported 0 mcast snooping enable mcast snooping enable \[command] mcast snooping enable no mcast snooping enable \[purpose] enable multicast function \[view] system view \[usage scenario] the multicast container is initially disabled by default if the device needs to forward and learn multicast data, this command must be issued in advance \[use cases] sonic(config)# mcast snooping enable igmp snooping enable igmp snooping enable \[command] igmp snooping enable no igmp snooping enable \[purpose] enable igmp snooping for vlan \[view] vlan view \[usage scenario] igmp snooping functionality is typically used in layer 2 switching networks it maintains a multicast forwarding table by listening to multicast protocol messages sent by routers and user terminals this ensures that multicast packets are correctly propagated among specific interfaces within a vlan it helps optimize the transmission of multicast data by ensuring that only the necessary interfaces receive this data, rather than broadcasting it to all interfaces, thereby reducing network bandwidth wastage \[use cases] sonic(config)# vlan 20 sonic(config vlan 20)# igmp snooping enable igmp snooping version igmp snooping version \[command] igmp snooping version 1 3 \[purpose] configure the igmp version \[view] vlan view \[use cases] sonic(config vlan 10)# igmp snooping version 2 mcast snooping group limit ethernet mcast snooping group limit ethernet \[command] mcast snooping group limit ethernet interface name limit no mcast snooping group limit ethernet interface name limit \[purpose] specify the maximum number of multicast table entries that the interface can learn \[parameter] parameter description interface name interface name limit value range 1 4094 \[view] vlan view \[notes] when the maximum learning table entries on the interface are modified, entries exceeding the limit will be learned into the igmp process memory space but will not be forwarded to the chip additionally, these entries will not be relearned during the aging period \[use cases] sonic(config)# vlan 20 sonic(config vlan 20)# mcast snooping group limit ethernet 1 20 igmp snooping proxy enable igmp snooping proxy enable \[command] igmp snooping proxy enable no igmp snooping proxy enable \[purpose] enable igmp snooping for vlan \[view] vlan view \[usage scenario] enabling igmp snooping proxy functionality allows the switch to take on the role of the router in sending igmp query messages and receiving igmp report/leave messages from users this helps alleviate the load on the router, especially in scenarios where there are a large number of terminals in the network \[use cases] sonic(config)# vlan 20 sonic(config vlan 20)# igmp snooping proxy enable igmp snooping querier enable igmp snooping querier enable \[command] igmp snooping querier enable no igmp snooping querier enable \[purpose] enable igmp query function \[view] vlan view \[usage scenario] on the device, configuring the querier involves enabling the device to send igmp query messages in place of the upstream device the device will periodically broadcast igmp query messages to all interfaces within the vlan, including router ports \[commit] if an igmp querier already exists in the multicast network, enabling the igmp querier on another device may trigger a re election process for the igmp querier role \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping querier enable igmp snooping querier ip igmp snooping querier ip \[command] igmp snooping querier ip a b c d no igmp snooping querier ip a b c d \[purpose] configuring the source ip address of igmp query messages \[view] vlan view \[usage scenario] when there are multiple queriers in the network, you can control the selection of the querier by modifying the ip address of the device's query messages \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping querier enable sonic(config vlan 10)# igmp snooping querier ip 10 110 1 1 igmp snooping fast leave enable igmp snooping fast leave enable \[command] igmp snooping fast leave enable no igmp snooping fast leave enable \[purpose] enable member interfaces to quickly leave a multicast group \[view] vlan view \[usage scenario] when an igmp leave packet is received from a host leaving a multicast group, the corresponding member host list table entry is deleted directly \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping fast leave enable igmp snooping robustness igmp snooping robustness \[command] igmp snooping robustness count \[purpose] configure robustness \[parameter] parameter description count default 2, range 1 255 \[view] vlan view \[usage scenario] this command adjusts robustness in two ways adjusts the number of specific group query messages sent by the querier to avoid potential network packet loss when an igmp leave message is received from a user for a specific multicast group, the command sends a specific group query message for a configured number of times, inquiring whether there are still members in that multicast group adjusts the member aging time after receiving a report message from a downstream host, the member aging time is set to specific group query message count × general query message interval + maximum response time for downstream hosts to reply to the querier \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping robustness 100 igmp snooping query interval igmp snooping query interval \[command] igmp snooping query interval interval \[purpose] configure the interval at which the device sends general query messages \[parameter] parameter description interval unit s, the default value is 125s, range 1 18000 \[view] vlan view \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping query interval 200 igmp snooping query max response time igmp snooping query max response time \[command] igmp snooping query max response time time \[purpose] configure the maximum response time for query messages \[parameter] parameter description time unit s, the default value is 10s, range 1 25 \[view] vlan view \[notes] it should be ensured that the interval at which the querier sends general query messages is greater than the maximum response time for downstream hosts to reply to the querier otherwise, there is a possibility of the device mistakenly deleting entries in the member table \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping query max response time 20 igmp snooping last member query interval igmp snooping last member query interval \[command] igmp snooping last member query interval last query interval \[purpose] configure the interval at which the querier sends specific group query messages \[parameter] parameter description last query interval unit ms, the default value is 1000ms,range 100 22500 \[view] vlan view \[use cases] sonic(config)# vlan 10 sonic(config vlan 10)# igmp snooping last member query interval 2000 interface l2mc static group interface l2mc static group \[command] interface l2mc static group ethernet interface name vlan id a b c d no interface l2mc static group ethernet interface name vlan id a b c d \[purpose] static addition of interfaces to multicast groups \[parameter] parameter description interface name interface name vlan id vlan id of the interface a b c d interface statically added multicast group address \[view] system configuration view \[notes] after configuring the interface to statically add a multicast group, users under the interface can receive multicast data from the group in a long term and stable manner, and need to enable the igmp snooping function \[use cases] sonic(config)# interface l2mc static group ethernet 2 20 224 1 1 1 igmp snooping mrouter aging igmp snooping mrouter aging \[command] igmp snooping mrouter aging time \[purpose] configure dynamic router port aging time within a vlan \[parameter] parameter description time value range 1 1000, unit s, default is 180 seconds \[view] vlan view \[usage scenario] within the aging time of the dynamic router port, if no igmp query or pim hello messages are received, it is considered that this port no longer belongs to the router port \[use cases] sonic(config)# vlan 20 sonic(config vlan 20)# igmp snooping mrouter aging 10 igmp snooping mroute ethernet igmp snooping mroute ethernet \[command] igmp snooping mroute ethernet interface name no igmp snooping mroute ethernet interface name \[purpose] configure the interface as a static router port for vlan \[parameter] parameter description interface name interface name \[view] vlan view \[use cases] sonic(config vlan 10)# igmp snooping mrouter ethernet 1 ip igmp ip igmp \[command] ip igmp \[ query interval query interval | query max response time time | last member query count count | last member query interval last query interval | version version ] no ip igmp \[ query interval query interval | query max response time time | last member query count count | last member query interval last query interval | version version ] \[purpose] configure the igmp querier function on the interface \[parameter] parameter description query interval value range 1 1800, unit s, default 125s time value range 10 250, unit s, default 10s count value range 1 7, default 2 last query interval value range 1 255, unit ms, default 10 version value range 2 3, default 3 \[view] vlanif view,interface view,lagif view \[use cases] sonic(config vlan 10)# ip igmp query interval 10 ip igmp join ip igmp join \[command] ip igmp join group address \[ source address ] no ip igmp join group address \[ source address ] \[purpose] statically join the multicast group \[parameter] parameter description group address multicast group address source address the source of multicast group address \[view] vlanif view,interface view,lagif view \[use cases] sonic(config vlan 10)# ip igmp join 224 1 1 1 120 1 1 122
