Command Line Reference
IP Multicast
43 min
igmp snooping configuration 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 \[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 \[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 | aging | +===========+===========+========+=========+ \| 10 | ethernet1 | static | 180 | + + + + + 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 \[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 \[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 \[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 \[comment] 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 \[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 \[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 \[comment] 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 \[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 \[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 \[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 \[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 \[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 \[comment] 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 \[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 l2mc static group \[command] l2mc static group ethernet interface name vlan id a b c d no 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 \[comment] 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)# l2mc static group ethernet 2 20 224 1 1 1 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 mld snooping configuration show vlan mld snooping \[command] show vlan mld snooping \[ vlan id ] \[purpose] display mld snooping information \[view] system view \[ use cases ] sonic(config)# do show vlan mld snooping + + + + + + + + + + + + \| vlan id | mld snp | proxy | version | fast leave | querier | querier ip | robustness | query interval(s) | last member query interval(ms) | query max response time(s) | +===========+===========+==========+===========+==============+===========+==============+==============+=====================+==================================+==============================+ \| 10 | enabled | disabled | 1 | disabled | disabled | 0 0 0 0 | 2 | 125 | 1000 | 10 | + + + + + + + + + + + + show vlan mld snooping mrouter \[command] show vlan mld snooping mrouter \[purpose] display the router port information of mld snooping \[view] system view \[ use cases ] sonic# show vlan mld snooping mrouter + + + + + \| vlan id | mrouter | type | aging | +===========+===========+========+=========+ \| 10 | ethernet1 | static | 180 | + + + + + mld snooping enable \[command] mld snooping enable no mld snooping enable \[purpose] enable mld snooping for vlan \[view] vlan view \[usage scenario] mld snooping operates on a layer 2 switching network between routers and user terminals it maintains multicast forwarding tables by listening to ipv6 multicast protocol messages from routers and user terminals, allowing multicast packets to be broadcast between specified interfaces within the vlan \[ use cases ] sonic(config)# vlan 20 sonic(config vlan 20)# mld snooping enable mld snooping version \[command] mld snooping version 1 2 \[purpose] configure the mld version \[view] vlan view \[ use cases ] sonic(config vlan 10)# mld snooping version 1 mld snooping proxy enable \[command] mld snooping proxy enable \[purpose] enable mld snooping proxy for vlan \[view] vlan view \[usage scenario] enabling mld snooping proxy functionality allows the switch to substitute for routers in sending mld query messages and receiving mld report/leave messages from users this alleviates the burden on router devices when there are numerous terminals in the network \[ use cases ] sonic(config)# vlan 20 sonic(config vlan 20)# mld snooping proxy enable mld snooping querier enable \[command] mld snooping querier enable \[purpose] enable mld querier functionality \[view] vlan view \[usage scenario] configuring a querier on the device allows it to replace upstream devices in sending mld query messages the device will periodically broadcast mld query messages to all interfaces within the vlan, including router ports \[comment] if an mld querier already exists in the multicast network, it may trigger a re election of the mld querier \[ use cases ] sonic(config)# vlan 20 sonic(config vlan 20)# mld snooping proxy enable mld snooping querier ip \[command] mld snooping querier ip x\ x x \ x no mld snooping querier ip x\ x x \ x \[purpose] configuring the source ip address of mld 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)# mld snooping querier enable sonic(config vlan 10)# mld snooping querier ip 1000 1 mld snooping fast leave enable \[command] mld snooping fast leave enable no mld snooping fast leave enable \[purpose] enable fast leave of multicast groups on member interfaces \[view] vlan view \[usage scenario] upon receiving an mld leave message from a host indicating departure from a multicast group, the corresponding multicast forwarding table entry for that host is removed immediately without waiting for aging time \[ use cases ] sonic(config)# vlan 10 sonic(config vlan 10)# mld snooping fast leave enable mld snooping robustness \[command] mld 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 mld 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 for downstream hosts to reply to the querier \[ use cases ] sonic(config)# vlan 10 sonic(config vlan 10)# mld snooping robustness 100 mld snooping query interval \[command] mld 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)# mld snooping query interval 200 mld snooping query max response time \[command] mld 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 \[comment] 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)# mld snooping query max response time 20 mld snooping last member query interval \[command] mld 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 25500 \[ use cases ] sonic(config)# vlan 10 sonic(config vlan 10)# mld snooping last member query interval 2000 l2mc static group \[command] l2mc static group etherne interface name vlan id x\ x x \ x no l2mc static group ethernet interface name vlan id x\ x x \ x \[purpose] static addition of interfaces to multicast groups \[parameter] parameter description interface name interface name vlan id vlan id of the interface x\ x x \ x interface statically added multicast group address \[view] system configuration view \[comment] 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 mld snooping function \[ use cases ] sonic(config)# interface l2mc static group ethernet 11 10 ff1e 0 0 0 0 0 0 1 mld snooping mrouter ethernet \[command] mld snooping mrouter ethernet interface name no mld snooping mrouter ethernet interface name \[purpose] configure the interface as a static router port for vlan \[view] vlan view \[ use cases ] sonic(config)# vlan 10 sonic(config vlan 10)# mld snooping mrouter ethernet 1 multicast vlan configuration show vlan igmp snooping mvlan \[command] show vlan igmp snooping mvlan vlan id \[purpose] show the binding relationship between vlan and multicast vlan \[view] system view \[ use cases ] sonic# show vlan igmp snooping mvlan + + + \| mvlan id | uvlan ids | +============+=============+ \| 2 | 3 | + + + igmp snooping mvlan \[command] igmp snooping mvlan mvlan id uvlan id no igmp snooping mvlan mvlan id uvlan ids \[purpose] configure the vlan as a multicast vlan \[parameter] parameter description mvlan id multicast vlan uvlan ids user vlan, support multiple configurations at intervals, or connection range configuration \[view] system configuration view \[usage scenario] when users from different vlans need to receive multicast data from the same multicast source, the device needs to replicate the data for each vlan in this scenario, you can configure multicast vlans, where the vlan where users are located is configured as the user vlan and the vlan where the router interface is located is configured as the multicast vlan data is replicated from the multicast vlan to the user vlan \[comment] igmp snooping needs to be enabled in both the multicast vlan and the user vlan for this configuration to work \[ use cases ] sonic(config)# igmp snooping mvlan 20 200,201
