Skip to content
Ask AI

IGMP Snooping

Table 1 IGMP Snooping View

****Command** Purpose **
** show igmp-snooping [ vlan ** vlan_id]Display IGMP Snooping information for VLANs.
**show igmp-snooping l2mc-table ** [vlan vlan_id]Display the IGMP Snooping multicast forwarding table.
**show igmp-snooping router-port ** [vlan vlan_id]Display the multicast router ports for IGMP Snooping.

[Command] **show igmp-snooping ** [vlan vlan_id]

[Purpose] Display IGMP Snooping information for VLANs.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]

[View] Privileged User View

[Use Cases]

sonic# show igmp-snooping
VLAN ID VERSION SNOOPING PROMPT LEAVE ROBUSTNESS PROXY QUERIER QUERY INTERVAL LAST MEMBER INTERVAL MAX RESPONSE TIME QUERIER IP
--------- --------- ---------- -------------- ------------ ------- --------- ---------------- ---------------------- ------------------- ------------
1 v3 disable disable 2 disable disable 125 1 10 0.0.0.0
10 v3 disable disable 2 disable disable 125 1 10 0.0.0.0
sonic# show igmp-snooping vlan 1
VLAN ID VERSION SNOOPING PROMPT LEAVE ROBUSTNESS PROXY QUERIER QUERY INTERVAL LAST MEMBER INTERVAL MAX RESPONSE TIME QUERIER IP
--------- --------- ---------- -------------- ------------ ------- --------- ---------------- ---------------------- ------------------- ------------
1 v3 disable disable 2 disable disable 125 1 10 0.0.0.0
sonic#

[Command] **show igmp-snooping l2mc-table ** [vlan vlan_id]

[Purpose] Display the IGMP Snooping multicast forwarding table.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]

[View] Privileged User View

[Use Cases]

sonic# show igmp-snooping l2mc-table
sonic# show igmp-snooping l2mc-table vlan 1

[Command] **show igmp-snooping router-port ** [vlan vlan_id]

[Purpose] Display the multicast router ports for IGMP Snooping.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]

[View] Privileged User View

[Use Cases]

sonic# show igmp-snooping router-port
sonic# show igmp-snooping router-port vlan 1

Table 2 IGMP Snooping Config

CommandPurpose
igmp-snooping enableEnable IGMP Snooping for the VLAN.
igmp-snooping version {v1|v2|v3}Configure the IGMP protocol version.
igmp-snooping querier enableEnable IGMP Snooping Querier.
igmp-snooping querier interval intervalConfigure the General Query interval for IGMP Snooping Querier.
igmp-snooping querier last-member-interval intervalConfigure the Group-Specific Query interval for IGMP Snooping Querier.
igmp-snooping querier max-response-time intervalConfigure the maximum response time for IGMP Snooping Querier.
igmp-snooping querier source-address x.x.x.xConfigure the source IP for IGMP Snooping Querier.
igmp-snooping robustness valueConfigure the robustness value for IGMP Snooping.
igmp-snooping proxy enableEnable the IGMP Snooping Proxy.
igmp-snooping prompt-leave enableEnable fast leave for IGMP Snooping member ports in a VLAN.
igmp-snooping prompt-leave {enable|disable} vlan vlan_idConfigure the state of fast leave for IGMP Snooping member ports in the interface.
igmp-snooping group-limitlimit_valuevlan vlan_idConfigure the maximum number of dynamically multicast entries for IGMP Snooping member interfaces.
igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked}Configuring IGMP Snooping static multicast entries.
igmp-snooping static-router-port vlan vlan_idConfiguring IGMP Snooping static router port.

[Command] igmp-snooping enable

[Purpose] Enable IGMP Snooping for the VLAN.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping enable to disable IGMP Snooping for the VLAN.

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping enable

[Command] igmp-snooping version {v1|v2|v3}

[Purpose] Configure the IGMP protocol version.

[View] VLAN Configuration View

[Notes] The default IGMP protocol version is **v3. ** Run command no igmp-snooping version to set IGMP version to default(v3).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping version v3

[Command] igmp-snooping querier enable

[Purpose] Enable IGMP Snooping Querier.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping querier enable to disable IGMP Snooping querier.

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping querier enable

[Command] igmp-snooping querier interval interval

[Purpose] Configure the General Query interval for IGMP Snooping Querier.

[Parameters]

ParameterDescription
intervalSpecify the interval for general query messages in seconds. The range is [1,18000], and the default value is 125.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping querier interval to set the general query interval to default(125s).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping querier interval 1000

igmp-snooping querier last-member-interval

Section titled “igmp-snooping querier last-member-interval”

[Command] igmp-snooping querier last-member-interval interval

[Purpose] Configure the Group-Specific Query interval for IGMP Snooping Querier.

[Parameters]

ParameterDescription
intervalSpecify the interval for Group-Specific Query messages in seconds. The range is [1,25], and the default value is 1.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping querier last-member-interval to set the Group-Specific query interval to default(1s).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping querier last-member-interval 10

[Command] igmp-snooping querier max-response-time interval

[Purpose] Configure the maximum response time for IGMP Snooping Querier.

[Parameters]

ParameterDescription
intervalSpecify the maximum response interval in seconds. The range is [1,25], and the default value is 10.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping querier max-response-time to set the maximum response interval to default(10s).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping querier max-response-time 20
sonic(config-vlan-10)# no igmp-snooping querier max-response-time

[Command] igmp-snooping querier source-address x.x.x.x

[Purpose] Configure the source IP for IGMP Snooping Querier.

[Parameters]

ParameterDescription
x.x.x.xSource IP for query message, the default is 0.0.0.0.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping querier source-address to set source IP to default (0.0.0.0).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping querier source-address 10.193.1.129
sonic(config-vlan-10)# no igmp-snooping querier source-address

[Command] igmp-snooping robustness value

[Purpose] Configure the robustness value for IGMP Snooping.

[Parameters]

ParameterDescription
valueThe robustness value for IGMP Snooping. The range is [1,255] and the default is 2.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping robustness to set the robustness value to default (2).

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping robustness 10
sonic(config-vlan-10)# no igmp-snooping robustness

[Command] igmp-snooping proxy enable

[Purpose] Enable the IGMP Snooping Proxy.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping proxy enable to disable the IGMP Snooping Proxy.

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping proxy enable
sonic(config-vlan-10)# no igmp-snooping proxy enable

[Command] igmp-snooping prompt-leave enable

[Purpose] Enable fast leave for IGMP Snooping member ports in a VLAN.

[View] VLAN Configuration View

[Notes] Run command no igmp-snooping prompt-leave enable to disable the fast leave feature.

[Use Cases]

sonic# configure terminal
sonic(config)# vlan 10
sonic(config-vlan-10)# igmp-snooping prompt-leave enable
sonic(config-vlan-10)# no igmp-snooping prompt-leave enable

igmp-snooping prompt-leave {enable|disable} vlan

Section titled “igmp-snooping prompt-leave {enable|disable} vlan”

[Command] igmp-snooping prompt-leave {enable|disable} vlan vlan_id

[Purpose] Configure the state of fast leave for IGMP Snooping member ports in the interface.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]

[View] Physical interface/LAG interface configuration view

[Notes] Run command no igmp-snooping prompt-leave vlan vlan_id to set the fast leave feature state to default. The default state depends on the configuration in VLAN view.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/4
sonic(config-if-0/4)# igmp-snooping prompt-leave enable vlan 10
sonic(config-if-0/4)# no igmp-snooping prompt-leave vlan 10
sonic(config-if-0/4)#

[Command] igmp-snooping group-limit limit_value vlan vlan_id

[Purpose] Configure the maximum number of dynamically multicast entries for IGMP Snooping member interfaces.

[Parameters]

ParameterDescription
limit_valueThe maximum number of dynamically multicast entries. The range is [1,4095] and the default is 4095.
vlan_idVLAN ID, the range is [1,4094]

[View] Physical interface/LAG interface configuration view

[Notes] Run command no igmp-snooping group-limit vlan vlan_id to set maximum number of dynamically multicast entries to default (4095).

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/4
sonic(config-if-0/4)# igmp-snooping group-limit 100 vlan 10
sonic(config-if-0/4)# no igmp-snooping group-limit vlan 10

[Command] igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked}

[Purpose] Configuring IGMP Snooping static multicast entries.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]
IP_Addr1The multicast source IP address. When the source-address is omitted, it is set to 0.0.0.0 by default
IP_Addr2The multicast group IP address. The range is 224.0.1.0-239.255.255.255

[View] Physical interface/LAG interface configuration view

[Notes] Run command no igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 to remove the static multicast entry.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/4
sonic(config-if-0/4)# igmp-snooping static-group vlan 10 group-address 224.0.3.2 mode forward
sonic(config-if-0/4)# igmp-snooping static-group vlan 10 source-address 1.1.1.1 group-address 224.0.2.1 mode forward

[Command] igmp-snooping static-router-port vlan vlan_id

[Purpose] Configuring IGMP Snooping static router port.

[Parameters]

ParameterDescription
vlan_idVLAN ID, the range is [1,4094]

[View] Physical interface/LAG interface configuration view

[Notes] Run command no igmp-snooping static-router-port vlan vlan_id to remove the static router port.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/4
sonic(config-if-0/4)# igmp-snooping static-router-port vlan 10
sonic(config-if-0/4)# no igmp-snooping static-router-port vlan 10