show ip igmp interface

Displays information about the interfaces where Internet Group Management Protocol (IGMP) is enabled. If you do not specify a VRF name or range of VRF IDs, the results show information for the Global Router. If you do specify a VRF name or range of VRF IDs, the results show information only for the VRFs you specify.

Syntax

Command Parameters

gigabitethernet {slot/port[/sub-port] [-slot/port[/sub-port]] [,...]}

Identifies the slot and port in one of the following formats: a single slot and port (slot/port), a range of slots and ports (slot/port-slot/port), or a series of slots and ports (slot/port,slot/port,slot/port). If the platform supports channelization and the port is channelized, you must also specify the sub-port in the format slot/port/sub-port.

interface
Shows Internet Group Management Protocol (IGMP) interfaces.
vlan <1-4059>

Specifies the VLAN ID in the range of 1 to 4059. By default, VLAN IDs 1 to 4059 are configurable and the system reserves VLAN IDs 4060 to 4094 for internal use. On switches that support the vrf-scaling and spbm-config-mode boot configuration flags, if you enable these flags, the system also reserves VLAN IDs 3500 to 3998. VLAN ID 1 is the default VLAN and you cannot create or delete VLAN ID 1.

vrf WORD<1-16>
Specifies a VRF by name.
vrfids <0-512>
Specifies a VRF by ID.

Default

None

Command Mode

Privileged EXEC

Command Output

The following table shows the field descriptions for the show ip igmp interface if you do not use the interface parameters.

Output Field

Description

IF

Indicates the interface where IGMP is configured.

QUERY INTVL

Indicates the frequency at which IGMP host query packets transmit on this interface.

STATUS

Indicates the activation of a row, which activates IGMP on the interface. The destruction of a row disables IGMP on the interface.

VERS.

Indicates the version of IGMP that runs on this interface. This object configures a router capable of running either version. For IGMP to function correctly, you must configure all routers on a LAN to run the same version of IGMP.

OPER VERS

Indicates the operational version of IGMP.

QUERIER

Indicates the address of the IGMP querier on the IP subnet to which this interface attaches.

QUERY MAXRSPT

Indicates the maximum query response time (in tenths of a second) advertised in IGMPv2 queries on this interface.

WRONG QUERY

Indicates the number of queries received where the IGMP version does not match the interface version. You must configure all routers on a LAN to run the same version of IGMP. If queries are received with the wrong version, a configuration error occurs.

JOINS

Indicates the number of times this interface added a group membership.

ROBUST

Indicates the robustness variable, which you can configure for the expected packet loss on a subnet. If you expect packet loss on a subnet, increase the robustness variable.

LASTMEM QUERY

Indicates the maximum response time (in tenths of a second) inserted into group-specific queries sent in response to leave group messages, and is also the amount of time between group-specific query messages. Use this value to modify the leave latency of the network. A reduced value results in reduced time to detect the loss of the last member of a group. This variable does not apply to IGMPv1.

MODE

Indicates the protocol configured on the VLAN added.

  • snoop—Indicates IGMP snooping is enabled on a VLAN.

  • snoop-spb—Indicates IGMP is enabled on a VLAN with an associated I-SID (IP multicast over Fabric Connect for a Layer 2 VSN).

  • pim—Indicates PIM is enabled.

  • routed-spb—Indicates IP multicast over Fabric Connect is enabled on the Layer 3 VSN or for IP Shortcuts.

  • pim-gw-spb—Indicates the SPB-PIM Gateway is enabled on the interface.

L2ISID

Indicates the I-SID associated with the Layer 2 interface.

The following table shows the field descriptions for the show ip igmp interface if you use the interface parameters.

Output Field

Description

VLAN ID or PORT NUM

Identifies the VLAN or port where IGMP is configured.

QUERY INTVL

Indicates the frequency at which IGMP host query packets transmit on this interface.

QUERY MAX RESP

Indicates the maximum query response time (in tenths of a second) advertised in IGMPv2 queries on this interface.

ROBUST

Indicates the robustness variable, which you can configure for the expected packet loss on a subnet. If you expect packet loss on a subnet, increase the robustness variable.

VERSION

Indicates the version of IGMP that runs on this interface. This object configures a router capable of running either version. For IGMP to function correctly, you must configure all routers on a LAN to run the same version of IGMP.

LAST MEMB QUERY

Indicates the maximum response time (in tenths of a second) inserted into group-specific queries sent in response to leave group messages, and is also the amount of time between group-specific query messages. Use this value to modify the leave latency of the network. A reduced value results in reduced time to detect the loss of the last member of a group. This variable does not apply to IGMPv1.

PROXY SNOOP ENABLE

Indicates if proxy snoop is enabled on the interface.

SNOOP ENABLE

Indicates if snoop is enabled on the interface.

SNOOP ORIGIN

Specifies the origin of the IGMP Snooping configuration on the port. The supported values are:

  • config - Set by the user.

  • radius - Set by the Remote Authentication Dail-In User Service (RADIUS) attribute.

SSM SNOOP ENABLE

Indicates if SSM snoop is enabled on the interface.

UPnP FILTER ENABLE

Indicates if Universal Plug and Play (uPnP) Filtering is enabled to filter multicast packets destined for a specific range.

The default is disabled.

FAST LEAVE ENABLE

Indicates if fast leave mode is enabled on the interface.

FAST LEAVE PORTS (VLAN parameter only)

Indicates the set of ports that are enabled for fast leave

SNOOP QUERIER ENABLE (VLAN parameter only)

Indicates if the IGMP Layer 2 Querier feature is enabled.

SNOOP QUERIER ADDRESS (VLAN parameter only)

Indicates the IP address of the IGMP Layer 2 querier.

DYNAMIC DOWNGRADE VERSION

Indicates if the dynamic downgrade feature is enabled.

COMPATIBILITY MODE

Indicates if compatibility mode is enabled.

EXPLICIT HOST TRACKING

Indicates if explicit host tracking is enabled to track all the source and group members.

UPnP FILTER ADDRESS

Indicates the multicast destination IP address to filter on an IGMP-enabled interface.

The default is 239.255.255.250/32.

Examples

The following examples display information about the interfaces where IGMP is enabled.

Switch:1#show ip igmp interface

=========================================================================================
                         Igmp Interface - GlobalRouter
=========================================================================================
       QUERY              OPER            QUERY   WRONG              LASTMEM
IF     INTVL STATUS VERS. VERS QUERIER    MAXRSPT QUERY JOINS ROBUST QUERY   MODE   L2ISID
-----------------------------------------------------------------------------------------
V100   125    activ  2     2   0.0.0.0    100     0     0     2      10      snoop-spb 1100 

1 out of 1 entries displayed
Switch:1#show ip igmp interface vlan 2
========================================================================================
                                  Vlan Ip Igmp
========================================================================================
VLAN QUERY QUERY ROBUST VERSION LAST  PROXY  SNOOP  SNOOP    SSM    UPnP   FAST   FAST
ID   INTVL MAX                  MEMB  SNOOP  ENABLE ORIGIN   SNOOP  FILTER LEAVE  LEAVE
           RESP                 QUERY ENABLE                 ENABLE ENABLE ENABLE PORTS
----------------------------------------------------------------------------------------
2   125   100   2      2       10    false   false   RADIUS   false   false   false        

VLAN SNOOP   SNOOP           DYNAMIC   COMPATIBILITY EXPLICIT UPnP  
ID   QUERIER QUERIER         DOWNGRADE MODE          HOSTS    FILTER
     ENABLE  ADDRESS         VERSION                 TRACKING ADDRESS
----------------------------------------------------------------------------------------
2   false   0.0.0.0         enable    disable       disable  239.255.255.250/32
Switch:1#show ip igmp interface gigabitethernet 1/2

====================================================================================
                                  Port Ip Igmp
====================================================================================
PORT     QUERY QUERY ROBUST VERSION LAST  PROXY  SNOOP  SNOOP    SSM    UPnP   FAST
NUM      INTVL MAX                  MEMB  SNOOP  ENABLE ORIGIN   SNOOP  FILTER LEAVE
               RESP                 QUERY ENABLE                 ENABLE ENABLE ENABLE
-------------------------------------------------------------------------------------
1/2      125   100   2      2       10    false  false  RADIUS   false  false  false

-------------------------------------------------------------------------------------
PORT  DOWNGRADE   COMPATIBILITY   EXPLICIT    UPNP
NUM   VERSION     MODE            HOST        FILTER
                                  TRACKING    ADDRESS
-------------------------------------------------------------------------------------
1/2    enable     disable         disable     239.255.255.250/32