API Guide

Supported IGMP versions
IGMP has three versions. Version 3 obsoletes and is backwards-compatible with version 2; version 2 obsoletes version 1.
OS10 supports the following IGMP versions:
● Router—IGMP versions 2 and 3. The default is version 3.
● Host—IGMP versions 1, 2, and 3.
In IGMP version 2, the host expresses interest in a particular group membership (*, G). In IGMP version 3, the host expresses
interest in a particular group membership, and specifies the source from which it wants the multicast traffic (S, G).
Query interval
The IGMP querier periodically sends a general query to discover which multicast groups are active. A group must have at least
one host to be active. By default, the periodic query messages are sent every 60 seconds. You can configure this value using
the ip igmp query-interval command.
To configure a query interval:
OS10# configure terminal
OS10# interface vlan120
OS10(conf-if-vl-120)# ip igmp query-interval 60
Last member query interval
When the IGMP querier receives a leave message, it sends a group-specific query message to ensure if any other host in the
network is interested in the multicast flow. By default, the group-specific query messages are sent every 1000 milliseconds. You
can configure this value using the ip igmp last-member-query-interval command.
To configure last member query interval:
OS10# configure terminal
OS10# interface vlan120
OS10(conf-if-vl-120)# ip igmp last-member-query-interval 200
Maximum response time
The maximum response time is the amount of time that the querier waits for a response to a query before taking action.
When a host receives a query, it does not respond immediately, but rather starts a delay timer. The delay time is set to a random
value between 0 and the maximum response time. The host sends a response when the timer expires; in IGMP version 2, if
another host responds before the timer expires, the timer nullifies, and no response is sent.
The querier advertises the maximum response time in the query. Lowering this value decreases leave latency but increases
response burstiness because all host membership reports are sent before the maximum response time expires. Inversely,
increasing this value decreases burstiness, but increases leave latency.
To configure maximum response time:
OS10# configure terminal
OS10# interface vlan120
OS10(conf-if-vl-120)# ip igmp query-max-resp-time 20
IGMP immediate leave
If the IGMP querier does not receive a response to a group-specific or group-and-source query, it sends another query based on
the configured querier robustness value. This value determines the number of times the querier sends the message. If the
querier does not receive a response, it removes the group from the outgoing interface for the subnet.
Multicast
781