display igmp group

Function

The display igmp group command displays information about IGMP groups that hosts have dynamically joined by sending IGMP Report messages.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] group [ group-address | interface interface-type interface-number ]^* [ 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 information about IGMP groups in a VPN instance.	The value must be an existing VPN instance name.
all-instance	Displays information about IGMP groups in all instances.	-
group-address	Displays information about the IGMP group with a specified group address.	The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
interface interface-type interface-number	Displays information about the IGMP group on the specified interface.	-
verbose	Displays detailed information about IGMP groups. If the parameter is not specified, the command displays only the summary of IGMP groups.	-
entry-number	Displays statistics about IGMP multicast groups that hosts dynamically join.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If a host wants to receive multicast data for a multicast group, the host must join the multicast group in either of the following modes:

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 the multicast group or locate a fault in a dynamically joined multicast group, run the display igmp group command. This command displays information about the multicast group that hosts have dynamically joined.

Example

# Display information about dynamic IGMP groups.

<HUAWEI> display igmp group
Interface group report information of VPN-Instance: public net
 Vlanif100(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 detailed information about dynamic IGMP groups.

<HUAWEI> display igmp group verbose
Interface group report information of VPN-Instance: public net
 Limited entry of this VPN-Instance: -
 Vlanif100(10.1.6.2):
  Total entry on this interface: 1
  Limited entry on this interface: -
  Total 1 IGMP Group reported
   Group: 225.1.1.2
     Uptime: 00:03:59
     Expires: off
     Last reporter: 10.1.6.10
     Last-member-query-counter: 0
     Last-member-query-timer-expiry: off
     Group mode: include 
     Version1-host-present-timer-expiry: off
     Version2-host-present-timer-expiry: off   
     Source list:
       Source: 192.168.232.1
          Uptime: 00:51:07
          Expires: 00:02:05
          Last-member-query-counter: 0
          Last-member-query-timer-expiry: off

# Display statistics about IGMP multicast groups that hosts dynamically join.

<HUAWEI> 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

Choose Columns...

**Table 1** Description of the **display igmp group command** output
Item	Description
Interface group report information of VPN-Instance	VPN instance to which IGMP groups on an interface belong. public net indicates the public network instance.
Group Address	Address of a multicast group.
Last Reporter	Link-local address of the last host that sends a Multicast Listener Report message. NOTE: When a host joins a multicast group through a sub-interface for QinQ or Dot1q VLAN tag termination, the Last Reporter field displays the address of the multicast proxy. By default, the address of the multicast proxy is 192.168.0.1.
Limited entry of this VPN-Instance	Maximum number of IGMP entries that can be created for this instance.
Vlanif100(10.1.6.2)	Interface type and interface number (IP address).
Total entry on this interface	Total number of IGMP entries on the current interface.
Limited entry on this interface	Maximum number of IGMP entries that the current interface can create.
Total 1 IGMP Group reported	Number of IGMP groups that the current interface has dynamically joined.
Group	Address of a multicast group.
Uptime	Amount of time since a multicast group is created. The time format is as follows: 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.
Expires	Time left before a group will be deleted from the IGMP group table. The time format is as follows: 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. "off" indicates that the group will never be aged out.
Last-member-query-counter	Number of times the querier will send Group-Specific Query messages after receiving a Leave message. The counter value decreases by 1 every time the querier sends a Group-Specific Query message. This parameter is configured using the igmp robust-count command. The value 0 indicates that the querier does not send Group-Specific Query messages after receiving a Leave message.
Last-member-query-timer-expiry	Length of the last member query timer. The timer starts only when a Leave message is received from a group member. The timer value is configured using the igmp lastmember-queryinterval command. The value off indicates that the last member query timer has not started.
Group mode	Multicast group record type, which can be Include or Exclude. It is displayed only when the interface is running IGMPv3.
Version1-host-present-timer-expiry	Timeout interval of IGMPv1 hosts. IGMPv1 does not define the Leave message; therefore, memberships of IGMPv1 hosts are aged using a timer. The device starts the timer when receiving a Report message from an IGMPv1 host. The timer value is calculated using the following formula: IGMPv1 timeout interval = General group query interval x Robustness variable + Maximum response time for Query messages The general group query interval is configured using the igmp timer query command. The robustness variable is configured using the igmp robust-count command. The maximum response time for Query messages is configured using the igmp max-response-time command. The value off indicates that the device has not received any Report messages from IGMPv1 hosts.
Version2-host-present-timer-expiry	Timeout interval of IGMPv2 hosts. It is displayed only when the interface is running IGMPv3. The value off indicates that the device has not received any Report messages from IGMPv2 hosts.
Source list	List of multicast sources. It is displayed only when the interface has IGMPv3 receiver hosts attached.
Source	IP address of a multicast source.