display igmp interface

Function

The display igmp interface command displays the configuration and running of IGMP on an interface.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] interface [ interface-type interface-number | up | down ] [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Indicates a VPN instance. vpn-instance-name specifies the name of the VPN instance.	The name is a string of 1 to 31 characters.
all-instance	Displays information about the IGMP multicast groups of all instances.	-
interface interface-type interface-number	Indicates an interface. interface-type interface-number specifies the type and number of the interface.	-
up	Indicates that the status of the IP protocol on an IGMP interface is Up, meaning that the IGMP protocol status is Active. If you specify this parameter in the command, the command displays only information about all interfaces on which the IGMP protocol status is Active.	-
down	Indicates that the status of the IP protocol on an IGMP interface is Down, meaning that the IGMP status is Inactive. If you specify this parameter in the command, the command displays only information about all interfaces on which the IGMP protocol status is Inactive.	-
verbose	Indicates the detailed information about IGMP.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When you need to check the status of an IGMP interface or find out the cause of a fault in an IGMP interface, run the display igmp interface command to view information about the IGMP interface.

When you run the display igmp interface command, note the following points:

If neither vpn-instance nor all-instance is specified, only configurations and running information about IGMP on the interfaces in the public network instance is displayed.
If interface-type interface-number is specified, only configurations and running information about IGMP on the specified interface is displayed. If interface-type interface-number is not specified, configurations and running information about IGMP on all interfaces is displayed.
If up is specified, only configurations and running information about IGMP on the interface with the IGMP protocol status being Active is displayed.
If down is specified, only configurations and running information about IGMP on the interface with the IGMP protocol status being Inactive is displayed.
If verbose is specified, information about various status parameters of IGMP on the interface is displayed.

Example

# Display configurations and running information about IGMP on the interfaces.

<sysname> display igmp interface GGigabitEthernet 0/0/0

Interface information of VPN-Instance: public net
 GigabitEthernet0/0/0(10.1.0.1):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: 40  except: 2000
   Value of query interval for IGMP (negotiated): -
   Value of query interval for IGMP (configured): 60 s
   Value of other querier timeout for IGMP: 105 s
   Value of maximum query response time for IGMP: 10 s
   Querier for IGMP: 10.1.0.1 (this router)
   Total 1 IGMP Group reported

# Display detailed configurations and running information about IGMP on the interfaces.

<sysname> display igmp interface verbose
Interface information of VPN-Instance: public net
 GigabitEthernet0/0/0(10.1.0.1):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: 40  except: 2000
   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
   Value of last member query time: 2 s
   Value of last member query interval: 1 s
   Value of startup query interval: 15 s
   Value of startup query count: 2
   General query timer expiry (hours:minutes:seconds): 00:00:31
   Querier for IGMP: 10.1.0.1 (this router)
   IGMP activity: 1 joins, 0 leaves
   Robustness (negotiated): -
   Robustness (configured): 2
   Require-router-alert: disabled
   Send-router-alert: enabled
   Ip-source-policy: ab
   Query ip-source-policy: 2000
   Prompt-leave: disabled
   SSM-Mapping: enabled
   Startup-query-timer-expiry: off
   Other-querier-present-timer-expiry: off
   TTL-check: disabled
  Total 1 IGMP Group reported

**Table 1** Description of the display igmp interface verbose command output
Item	Description
Interface information of VPN-Instance	Indicates the VPN instance to which interface information corresponds.
GigabitEthernet0/0/0(10.1.0.1)	Indicates the interface type and interface number (IP address).
IGMP is enabled	Indicates that IGMP is enabled. You can run the igmp enable command enable IGMP.
Current IGMP version	Indicates the version of IGMP that is enabled on the interface. You can run the igmp version command to configure an IGMP version.
IGMP state	Indicates the status of interface that enabled with IGMP. The value is up or down. up: indicates that the IGMP status is Active. down: indicates that the IGMP status is Inactive.
IGMP group policy	Indicates the ACL number of the IGMP group policy, which is used to control groups the interface can join. The ACL is configured using the igmp group-policy command. NOTE: 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	Indicates the maximum number of IGMP entries. NOTE: If the displayed value in the IGMP limit field is not -, the maximum number of IGMP group members has been configured on the interface. If the number of IGMP entries has reached the limit, new IGMP entries will not be created. To address this problem, run the igmp limit command on the interface to increase the limit or run the undo igmp limit command to delete the limit.
except	Indicates the multicast groups defined in the ACL, for which IGMP entries do not need to be limited.
Value of query interval for IGMP (negotiated)	Indicates the interval negotiated by non-queriers for sending Query messages, in seconds. This interval can be used to elect a querier. The negotiated value is supported only by IGMPv3.
Value of query interval for IGMP (configured)	Indicates the configured interval for the interface to send IGMP Query messages, in seconds. You can run the igmp timer query command to set the interval at which an interface sends IGMP Query messages.
Value of other querier timeout for IGMP	Indicates the timeout period of other IGMP queriers, in seconds. The timeout period is set by using the igmp timer other-querier-present command. The value is 0 on the interface that acts as the querier.
Value of maximum query response time for IGMP	Indicates the maximum response time carried in the IGMP Query message, in seconds. You can run the igmp max-response-time command to set the maximum response time of IGMP Query messages on an interface. 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	Indicates the last member query time, in seconds. The last member query time is calculated using the formula: interval for sending last member query messages x robustness variable. In IGMPv1, the last member query time is not defined.
Value of last member query interval	Indicates the interval for sending last member query messages, in seconds. In IGMPv1, the last member query interval is not defined.
Value of startup query interval	Indicates the interval for an interface to send Query messages when it functions as a querier after startup, in seconds. The startup query interval is used to quickly elect a querier. The value is 1/4 of the interval at which IGMP general query messages are sent. You can use the igmp timer query command to set the interval at which Query messages are sent. In IGMPv1, the startup query interval is not defined.
Value of startup query count	Indicates the number of times an interface can send Query messages when it functions as a querier after startup. You can run the igmp robust-count command to configure a robustness variable on an IGMP querier. In IGMPv1, the startup query count is not defined.
General query timer expiry (hours:minutes:seconds)	Indicates the timeout period of a general query timer. You can run the igmp timer query command to set a timeout period for a general query timer.
Querier for IGMP	Indicates an IGMP querier. In IGMPv1, the querier is selected according to the multicast routing protocol; in IGMPv2, the FW with the lowest IP address is selected as the querier on the shared segment.
IGMP activity: 1 joins, 0 leaves	Indicates the active group membership on the interface: joins: indicates the number of IGMP groups that the interface has joined. When the interface joins a new group, the value increases by one; when the interface leaves a group, the value remains unchanged. leaves: indicates the number of groups the interface leaves. When the interface leaves a group, the value increases by one.
Robustness (negotiated)	Indicates the robustness variable negotiated by non-queriers. The negotiated value is supported by IGMPv3 only.
Robustness (configured)	Indicates the robustness variable configured on the interface. You can run the igmp robust-count command to configure a robustness variable.
Require-router-alert	Indicates whether the received IGMP packets are required to carry the Alert option. You can run the igmp require-router-alert command to configure an interface to process only IGMP packets with Router-Alert options in the headers.
Send-router-alert	Indicates whether the sent IGMP packet carries the Router-Alert option. You can run the igmp send-router-alert command to configure an interface to send IGMP messages with Router-Alert options in the headers.
Ip-source-policy	Indicates the source address-based filtering policy for received IGMP Report or Leave messages. The policy can be configured using the igmp ip-source-policy command.
Query ip-source-policy	Indicates the source address-based filtering policy for received IGMP Query messages. The policy can be configured using the igmp query ip-source-policy command.
Prompt-leave	Indicates whether prompt leave is enabled. You can run the igmp prompt-leave command to enable prompt leave.
SSM-Mapping	Indicates whether Source-Specific Multicast (SSM) mapping is enabled. You can run the igmp ssm-mapping enable command to enable SSM mapping.
Startup-query-timer-expiry	Status of the timer used to control the interval at which an interface that 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	Status of the timer that controls when an existing querier expires and an interface participates in querier election off: indicates that an interface considers itself as a querier and no other queriers exist. on: indicates that an interface does function as a querier and other queriers exist.
TTL-check	Whether the function to check the TTL values in received IGMP Report, Leave, and Query messages is enabled: enabled disabled
Total 1 IGMP Group reported	Indicates the number of IGMP groups that the interface dynamically joins. When an interface dynamically joins a new multicast group, the value increases by one.