display igmp group

Function

The display igmp group command displays information about IGMP multicast groups, including the multicast groups which hosts dynamically join by sending Report messages and the multicast groups to which hosts are statically joined through command lines.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] group [ group-address | interface interface-type interface-number ] ^* [ static ] [ verbose ]

display igmp [ vpn-instance vpn-instance-name | all-instance ] group [ interface interface-type interface-number ] entry-number

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Displays configurations and running information about the IGMP multicast groups that hosts in a specified VPN instance join. vpn-instance-name: specifies the name of a VPN instance.	The name is a string of 1 to 31 characters.
all-instance	Displays configurations and running information about the IGMP multicast groups that hosts in all instances join.	-
group-address	Specifies the multicast group address. After you specify this parameter in the command, the command displays information only about a specific IGMP group.	The address is in dotted decimal notation. The value ranges from 224.0.0.0 to 239.255.255.255.
interface interface-type interface-number	Displays configurations and running information about the IGMP multicast groups that a specified interface joins. interface-type interface-number specifies the type and number of the interface on the router.	-
static	Displays configurations and running information about the IGMP multicast groups to which hosts are statically joined.	-
verbose	Displays detailed configurations and running information about the IGMP multicast groups that hosts dynamically join or the IGMP multicast groups to which hosts are statically joined.	-
entry-number	Displays statistics about IGMP multicast groups that hosts dynamically join.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If a host wants to receive multicast data for a multicast group, the host must join the multicast group. Either of the following modes can be used to enable a host to join a multicast group:

Dynamic mode: After you run the igmp enable command to enable IGMP on the interface connected to the network segment on which the host resides, the host can dynamically join the multicast group.
Static mode: After you run the igmp static-group command to enable IGMP on the interface connected to the network segment on which the host resides, the host can statically join the multicast group.

To monitor the status of or locate a fault in a dynamically joined multicast group, run the display igmp group command to view the information about the multicast group. The information helps you to analyze and locate the fault.

Precautions

When running the display igmp group command, note the following:

If neither vpn-instance nor all-instance is specified, only information about the multicast groups that hosts in the public network instance join is displayed.
If group-address is specified, information about the specified multicast group is displayed.
If interface is specified, the only information displayed pertains to the IGMP multicast groups joined by hosts connected to a specified interface.
If static is specified, the only information displayed pertains to the IGMP multicast groups to which hosts are statically joined.
If verbose is specified, details about IGMP multicast groups are displayed.
If both static and verbose are specified, details about the IGMP multicast groups to which hosts are statically joined are displayed.
If entry-number is specified, statistics about IGMP multicast groups that hosts dynamically join are displayed.

Example

# Display configurations and running information about the IGMP multicast groups that hosts in the public network instances dynamically join.

<sysname> display igmp group
Interface group report information of VPN-Instance: public net
 GigabitEthernet0/0/1(10.1.6.2):
  Total 1 IGMP Group reported
   Group Address   Last Reporter   Uptime      Expires
   225.1.1.2       10.1.6.10       00:02:04    00:01:17

# Display statistics about IGMP multicast groups that hosts dynamically join in the public network instance.

<sysname> display igmp group entry-number
Interface group report information of VPN-Instance: public net
  Total 4 IGMP Groups reported 
 Vlanif200(10.36.1.10):
  Total 2 IGMP Groups reported
 Vlanif100(10.0.0.4):
  Total 2 IGMP Groups reported

**Table 1** Description of the display igmp group command output
Item	Description
Interface group report information of VPN-Instance	Indicates the VPN instance to which IGMP group information on the interface belongs.
GigabitEthernet0/0/1(10.1.6.2)	Indicates the interface type and number (IP address).
Total 1 IGMP Group reported	Indicates the number of multicast groups that the interface dynamically joins.
Group Address	Indicates the multicast group address.
Last Reporter	Indicates the host that sends the last Report message. When a host joins a multicast group through a sub-interface for Dot1q VLAN tag termination, the Last Reporter field displays the address of the multicast proxy rather than the address host that actually sends the Report message. By default, the address of the multicast proxy is 192.168.0.1.
Uptime	Indicates the amount of time since the creation of a multicast group. The time format is as follows: If the time is less than or equal to 24 hours, the format is hours:minutes:seconds. If the time is longer than 24 hours but less than or equal to one week, the format is days:hours. If the time is longer than one week, the format is weeks:days.
Expires	The value can be: Time: indicates the scheduled time that a group will be deleted from the IGMP group table. The time format is as follows: If the time is less than or equal to 24 hours, the format is hours:minutes:seconds. If the time is longer than 24 hours but less than or equal to one week, the format is days:hours. If the time is longer than one week, the format is weeks:days. off: indicates that the multicast group timer does not exist. off (on-demand): indicates that the multicast group timer does not exist, (the interface is enabled with IGMP On-demand).

# Display detailed configurations and running information about the IGMP multicast groups in the public network instance.

<sysname> display igmp group verbose
Interface group report information of VPN-Instance: public net
 Limited entry of this VPN-Instance: -
 GigabitEthernet0/0/1(10.1.6.2):
  Total entries on this interface: 2
  Limited entries on this interface: 2
  Total 2 IGMP Groups reported
   Group: 224.0.1.60
     Uptime: 01:28:32
     Expires: 00:01:39
     Last reporter: 10.111.15.8
     Last-member-query-counter: 0
     Last-member-query-timer-expiry: off
     Version1-host-present-timer-expiry: 00:01:39
     Version2-host-present-timer-expiry: off
   Group: 239.255.255.250
     Uptime: 01:34:55
     Expires: 00:01:45
     Last reporter: 10.111.12.232
     Last-member-query-counter: 0
     Last-member-query-timer-expiry: off
     Version1-host-present-timer-expiry: off
     Version2-host-present-timer-expiry: off

**Table 2** Description of the display igmp group verbose command output
Item	Description
Limited entry of this VPN-Instance	Indicates the maximum number of IGMP entries of the current VPN instance set through the igmp limit command.
GigabitEthernet0/0/1(10.1.6.2)	Indicates the interface type and number (IP address).
Total entries on this interface	Indicates the number of total IGMP entries on the current interface.
Total 2 IGMP Groups reported	Indicates the number of IGMP multicast groups that the interface dynamically joins.
Group	Indicates the multicast group address.
Uptime	Indicates the time since a multicast group is created. If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds. If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours. If the time is longer than one week, the format is weeks:days.
Last-member-query-counter	LMQC, indicates the number of times last member query messages can be sent.
Last-member-query-timer-expiry	LMQT, indicates the timeout period for sending last member query messages. The value can be: time: The format is hours:minutes:seconds. off: indicates that the timer is not started.
Version1-host-present-timer-expiry	Indicates the timeout period of an IGMPv1 host. The value can be: time: The format is hours:minutes:seconds. off: indicates that the timer is not started.
Version2-host-present-timer-expiry	Indicates the timeout period of an IGMPv2 host. The value can be: time: The format is hours:minutes:seconds. off: indicates that the timer is not started.

# Display configurations and running information about the IGMP multicast groups to which GE 1/0/1 in the public network instance is statically joined.

<sysname> display igmp group interface GigabitEthernet0/0/1 static
Static join group information of VPN-Instance: public net
 Total 1 entry
 Specified interface state:UP
 Total 1 entry matched
  Group Address   Source Address   Expires
  225.1.1.1       10.1.1.1         never

**Table 3** Description of the display igmp group interface GigabitEthernet0/0/1static command output
Item	Description
Static join group information of VPN-Instance	Indicates the VPN instance to which information about the multicast group the interface is statically joined to belongs.
Total 1 entry	Indicates the total number of IGMP multicast groups configured on the interface.
Specified interface state	Indicates the status of the specified queried interface. UP: The interface starts normally. DOWN: An error occurs on the physical link of the interface.
Total 1 entry matched	Indicates the number of IGMP multicast groups that meet the query conditions.
Source Address	Indicates the multicast source address.