This section describes the commands you use to view and configure IGMP settings.
ip igmp
This command sets the administrative mode of IGMP in the system to active.
Default: disabled
Format: ip igmp
Mode: Global Config, Interface Config
no ip igmp
This command sets the administrative mode of IGMP in the system to inactive.
Format: no ip igmp
Mode: Global Config, Interface Config
ip igmp version
This command configures the version of IGMP for an interface. The value for <version> is either 1, 2 or 3.
Default: 2
Format: ip igmp version <version>
Mode: Interface Config
no ip igmp version
This command resets the version of IGMP to the default value.
Format: no ip igmp version
Mode: Interface Config
ip igmp last-member-query-count
This command sets the number of Group-Specific Queries sent before the router assumes that there are no local members on the interface. The range for<count> is 1 to 20.
Format: ip igmp last-member-query-count <count>
Mode: Interface Config
no ip igmp last-member-query-count
This command resets the number of Group-Specific Queries to the default value.
Format: no ip igmp last-member-query-count
Mode: Interface Config
ip igmp last-member-query-interval
This command configures the Maximum Response Time inserted in Group-Specific Queries which are sent in response to Leave Group messages. The range for <seconds> is 0 to 255 tenths of a second.
Default: 10 tenths of a second (1 second)
Format: ip igmp last-member-query-interval <seconds>
Mode: Interface Config
no ip igmp last-member-query-interval
This command resets the Maximum Response Time to the default value.
Format: no ip igmp last-member-query-interval
Mode: Interface Config
ip igmp query-interval
This command configures the query interval for the specified interface. The query interval determines how fast IGMP Host-Query packets are transmitted on this interface. The range for <queryinterval> is 1 to 3600 seconds.
Default: 125 seconds
Format: ip igmp query-interval <seconds>
Mode: Interface Config
no ip igmp query-interval
This command resets the query interval for the specified interface to the default value. This is the frequency at which IGMP Host-Query packets are transmitted on this interface.
Format: no ip igmp query-interval
Mode: Interface Config
ip igmp query-max-response-time
This command configures the maximum response time interval for the specified interface, which is the maximum query response time advertised in IGMPv2 queries on this interface.The time interval is specified in tenths of a second. The range for <maxresptime> is 0 to 255 tenths of a second.
Default: 100
Format: ip igmp query-max-response-time <seconds>
Mode: Interface Config
no ip igmp query-max-response-time
This command resets the maximum response time interval for the specified interface, which is the maximum query response time advertised in IGMPv2 queries on this interface to the default value. The maximum response time interval is reset to the default time.
Format: no ip igmp query-max-response-time
Mode: Interface Config
ip igmp robustness
This command configures the robustness that allows tuning of the interface. The robustness is the tuning for the expected packet loss on a subnet. If a subnet is expected to have a lot of loss, the Robustness variable may be increased for the interface. The range for <robustness> is 1 to 255.
Default: 2
Format: ip igmp robustness <robustness>
Mode: Interface Config
no ip igmp robustness
This command sets the robustness value to default.
Format: no ip igmp robustness
Mode: Interface Config
ip igmp startup-query-count
This command sets the number of Queries sent out on startup, separated by the Startup Query Interval on the interface. The range for <count> is 1 to 20.
Default: 2
Format: ip igmp startup-query-count <count>
Mode: Interface Config
no ip igmp startup-query-count
This command resets the number of Queries sent out on startup, separated by the Startup Query Interval on the interface to the default value.
Format: no ip igmp startup-query-count
Mode: Interface Config
ip igmp startup-query-interval
This command sets the interval between General Queries sent on startup on the interface. The time interval value is in seconds. The range for <interval> is 1 to 300 seconds.
Default: 31
Format: ip igmp startup-query-interval <interval>
Mode: Interface Config
no ip igmp startup-query-interval
This command resets the interval between General Queries sent on startup on the interface to the default value.
Format: no ip igmp startup-query-interval
Mode: Interface Config
show ip igmp
This command displays the system-wide IGMP information.
Format: show ip igmp
Modes: Privileged EXEC User EXEC
IGMP Admin Mode: The administrative status of IGMP. This is a configured value.
Interface: Valid slot and port number separated by a forward slash.
Interface Mode: Indicates whether IGMP is enabled or disabled on the interface. This is a configured value.
Protocol State: The current state of IGMP on this interface. Possible values are Operational or Non-Operational.
show ip igmp groups
This command displays the registered multicast groups on the interface. If [detail] is specified this command displays the registered multicast groups on the interface in detail.
Format: show ip igmp groups <unit/slot/port> [detail]
Mode: Privileged EXEC
If you do not use the detail keyword, the following fields appear:
IP Address: The IP address of the interface participating in the multicast group.
Subnet Mask: The subnet mask of the interface participating in the multicast group.
Interface Mode: This displays whether IGMP is enabled or disabled on this interface.
The following fields are not displayed if the interface is not enabled:
Querier Status: This displays whether the interface has IGMP in Querier mode or Non-Querier mode.
Groups: The list of multicast groups that are registered on this interface.
If you use the detail keyword, the following fields appear:
Multicast IP Address: The IP address of the registered multicast group on this interface.
Last Reporter: The IP address of the source of the last membership report received for the specified multicast group address on this interface.
Up Time: The time elapsed since the entry was created for the specified multicast group address on this interface.
Expiry Time: The amount of time remaining to remove this entry before it is aged out.
Version1 Host Timer: The time remaining until the local router assumes that there are no longer any IGMP version 1 multicast members on the IP subnet attached to this interface. This could be an integer value or “-----” if there is no Version 1 host present.
Version2 Host Timer: The time remaining until the local router assumes that there are no longer any IGMP version 2 multicast members on the IP subnet attached to this interface. This could be an integer value or “-----” if there is no Version 2 host present.
Group Compatibility Mode: The group compatibility mode (v1, v2 or v3) for this group on the specified interface.
show ip igmp groups membership-state <mcast-group-addr>
This command shows the membership states in specified multi cast group address.
Format: show ip igmp groups membership-state <mcast-group-IP>
Mode: Privileged EXEC
Acceptable value:< mcast-group-IP > - denotes valid multi cast group address
The display parameters for above command are:
Interface: Interface on which group memberships states is getting displayed
Mcast Group IP: Multi cast group address
Membership State: Membership state is no members or checking members or member present or V1 members
V1_Hosts present: present or none
V2_Hosts present: present or none
Group Compat Mode: V1 or V2
show ip igmp interface
This command displays the IGMP information for the interface.
Format: show ip igmp interface <unit/slot/port>
Modes: Privileged EXEC User EXEC
Interface: Valid slot and port number separated by a forward slash.
IGMP Admin Mode: The administrative status of IGMP.
Interface Mode: Indicates whether IGMP is enabled or disabled on the interface.
IGMP Version: The version of IGMP running on the interface. This value can be configured to create a router capable of running either IGMP version 1 or 2.
Query Interval (secs): The frequency at which IGMP Host-Query packets are transmitted on this interface.
Query Max Response Time (1/10 of a second): The maximum query response time advertised in IGMPv2 queries on this interface.
Robustness: The tuning for the expected packet loss on a subnet. If a subnet is expected to be have a lot of loss, the Robustness variable may be increased for that interface.
Startup Query Interval (secs): The interval between General Queries sent by a Querier on startup.
Startup Query Count: The number of Queries sent out on startup, separated by the Startup Query Interval.
Last Member Query Interval (1/10 of a second): The Maximum Response Time inserted into Group-Specific Queries sent in response to Leave Group messages.
Last Member Query Count: The number of Group-Specific Queries sent before the router assumes that there are no local members.
show ip igmp interface membership
This command displays the list of interfaces that have registered in the multicast group.
Format: show ip igmp interface membership <multiipaddr> [detail]
Mode: Privileged EXEC
Interface: Valid unit, slot and port number separated by forward slashes.
Interface IP: The IP address of the interface participating in the multicast group.
State: The interface that has IGMP in Querier mode or Non-Querier mode.
Group Compatibility Mode: The group compatibility mode (v1, v2 or v3) for the specified group on this interface.
Source Filter Mode: The source filter mode (Include/Exclude) for the specified group on this interface. This is “-----” for IGMPv1 and IGMPv2 Membership Reports.
If you use the detail keyword, the following fields appear:
Interface: Valid unit, slot and port number separated by forward slashes.
Group Compatibility Mode: The group compatibility mode (v1, v2 or v3) for the specified group on this interface.
Source Filter Mode: The source filter mode (Include/Exclude) for the specified group on this interface. This is “-----” for IGMPv1 and IGMPv2 Membership Reports.
Source Hosts: The list of unicast source IP addresses in the group record of the IGMPv3 Membership Report with the specified multicast group IP address. This is “-----” for IGMPv1 and IGMPv2 Membership Reports.
Expiry Time: The amount of time remaining to remove this entry before it is aged out. This is “-----” for IGMPv1 and IGMPv2 Membership Reports.
show ip igmp interface stats
This command displays the IGMP statistical information for the interface. The statistics are only displayed when the interface is enabled for IGMP.
Format: show ip igmp interface stats <unit/slot/port>
Modes: Privileged EXEC User EXEC
Querier Status: The status of the IGMP router, whether it is running in Querier mode or Non-Querier mode.
Querier IP Address: The IP address of the IGMP Querier on the IP subnet to which this interface is attached.
Querier Up Time: The time since the interface Querier was last changed.
Querier Expiry Time: The amount of time remaining before the Other Querier Present Timer expires. If the local system is the querier, the value of this object is zero.
Wrong Version Queries: The number of queries received whose IGMP version does not match the IGMP version of the interface.
Number of Joins: The number of times a group membership has been added on this interface.
Number of Groups: The current number of membership entries for this interface
