display igmp interface

Function

The display igmp interface command displays IGMP configurations and state information on interfaces.

Format

display igmp interface [ interface-type interface-number | interface-name ] [ verbose ]

display igmp { vpn-instance vpn-instance-name | all-instance } interface [ interface-type interface-number | interface-name ] [ verbose ]

Parameters

Parameter	Description	Value
interface-type interface-number	Displays IGMP configurations and state information on an interface that has the specified type and number. interface-type interface-number specifies the type and number of an interface.	-
interface-name	Specifies the name of an interface.	-
verbose	Displays detailed IGMP configurations and state information.	-
vpn-instance vpn-instance-name	Displays IGMP configurations and state information in a specified VPN instance. vpn-instance-name specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance	Displays IGMP configurations and state information in all instances.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
igmp	read

Usage Guidelines

Usage Scenario

To check IGMP interface's status or locate faults in IGMP interfaces, run the display igmp interface command to view IGMP configurations and state information on interfaces.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display IGMP configurations and state information on interfaces in the public network instance.

<HUAWEI> display igmp interface gigabitethernet 0/1/1
Interface information of VPN-Instance: public net
 Ethernet0/1/1(192.168.101.2):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Value of query interval for IGMP (negotiated): -
   Value of query interval for IGMP (configured): 60 s
   Value of other querier timeout for IGMP: 0 s
   Value of maximum query response time for IGMP: 10 s
   Querier for IGMP: 192.168.101.2 (this router)
   Total 1 IGMP Group reported

# Display IGMP configurations and state detail information on interfaces in the public network instance.

display igmp interface verbose
Interface information of VPN-Instance: public net
 Ethernet0/1/1(192.168.101.2):
   IGMP is enabled
   Current IGMP version is 3
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Value of query interval for IGMP (negotiated): 60 s
   Value of query interval for IGMP (configured): 60 s
   Value of other querier timeout for IGMP: 0 s
   Value of maximum query response time for IGMP: 10 s
   Value of last member query time: 5 s
   Value of last member query interval: 1 s
   Value of startup query interval: 15 s
   Value of startup query count: 5
   General query timer expiry (hours:minutes:seconds): 00:00:15
   Querier for IGMP: 192.168.101.2 (this router)
   IGMP activity: 1 joins, 0 leaves
   Robustness (negotiated): 5
   Robustness (configured): 5
   Require-router-alert: disabled
   Send-router-alert: enabled
   Ip-source-policy: disabled
   Query Ip-source-policy: disabled
   Prompt-leave: disabled
   SSM-Mapping: disabled
   Startup-query-timer-expiry: off
   Other-querier-present-timer-expiry: off
   IGMP ipsec: disabled
  Total 1 IGMP Group reported

**Table 1** Description of the **display igmp interface** command output
Item	Description
Interface information of VPN-Instance	Instance in which IGMP configurations and state information are displayed.
IGMP is enabled	Indicates that IGMP has been enabled on an interface using the igmp enable command.
IGMP state	IGMP state on an interface. up: IGMP is in the active state. down: IGMP is in the inactive state.
IGMP group policy	Number of an ACL used in an IGMP group policy to control the number of groups that an interface can join. The ACL is applied to the IGMP group policy using the igmp group-policy command. If the displayed value in the IGMP group policy field is not none, the groups that the hosts can join have been specified, and IGMP filters Report messages of hosts according to the ACL. If the multicast group G is not included in the groups specified in the ACL, modify or delete the ACL to ensure that members of G can be served.
IGMP limit	Maximum number of IGMP entries.
IGMP activity	Indicates the statistics of IGMP activity (join or leave)..
IGMP ipsec	Whether IP Security (IPSec) authentication is configured for MLD messages.
Current IGMP version	IGMP version configured using the igmp version command.
Value of query interval for IGMP (negotiated)	Interval negotiated by non-queriers for sending Query messages, in seconds. The negotiated value is supported by IGMPv3 only.
Value of query interval for IGMP (configured)	Configured interval at which an interface sends IGMP Query messages, in seconds. The value is specified using the igmp timer query command.
Value of other querier timeout for IGMP	Keepalive time of other IGMP queriers. The value decreases by one per second. The timeout period is specified using the igmp timer other-querier-present command. The value of this item is 0 on the interface that acts as a querier.
Value of maximum query response time for IGMP	Maximum response time carried by an IGMP Query message, in seconds. The value is specified using the igmp max-response-time command. After a host receives an IGMP Query message for a group, the host starts a timer for the group that it joins. The value of the timer ranges from 0 to the maximum response time. When the timer expires, the host sends Report messages.
Value of last member query time	Value of last member query time.
Value of last member query interval	Value of last member query interval.
Value of startup query interval	Value of startup query interval.
Value of startup query count	Value of startup query count.
Querier for IGMP	IGMP querier. In IGMPv1, a querier is selected based on the multicast routing protocol; in IGMPv2, the Device with the lowest IP address acts as the querier on a shared network segment.
Total 1 IGMP Group reported	Number of IGMP groups that an interface dynamically joins. When the interface dynamically joins a new multicast group, the value increases by 1. When the interface leaves a multicast group, the value decreases by 1.
Query ip-source-policy	ndicates the source address-based filtering policy for received IGMP Query messages. The policy can be configured using the igmp query ip-source-policy command.
General query timer expiry	Indicates the timeout period of a general query timer.
Robustness (negotiated)	Robustness variable negotiated by non-queriers.
Robustness (configured)	Robustness variable configured on an interface. The value is specified using the igmp robust-count command.
Ethernet0/1/1(192.168.101.2)	Type, number, and IP address of an interface.
Startup-query-timer-expiry	Indicates the status of the timer used to control the interval at which an interface starts as the querier sends Query messages: off: indicates that the interface sends Query messages immediately after startup. on: indicates that the interface does not send Query messages immediately after startup.
Other-querier-present-timer-expiry	Indicates the status of the timer identifying whether another querier is present: off: indicates that an interface considers itself as a querier and that no other queriers exist. on: indicates that an interface does function as a querier and other queriers exist.
Require-router-alert	Indicates whether to discard IGMP packets without the Router-Alert option: disabled: indicates that IGMP packets without the Router-Alert option can be accepted and processed. enabled: indicates that IGMP packets without the Router-Alert option are ignored.
Send-router-alert	Indicates whether IGMP packets to be sent carry the Router-Alert option.
Ip-source-policy	Indicates the source address-based filtering policy for received IGMP Report or Done messages. The policy can be configured using the igmp ip-source-policy command.
Prompt-leave	Indicates whether prompt leave is enabled.
SSM-Mapping	Indicates whether Source-Specific Multicast (SSM) mapping is enabled.