display igmp interface

Function

The display igmp interface command displays information about IGMP interfaces.

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	Displays information about IGMP interfaces in a VPN instance.	The value must be an existing VPN instance name.
all-instance	Displays information about IGMP interfaces in all instances.	-
interface-type interface-number	Displays information about a specified IGMP interface. If this parameter is not specified, the command displays information about all IGMP interfaces.	-
up	Displays information about the IGMP interfaces with the IP protocol in Up state and the IGMP protocol in Active state.	-
down	Displays information about the IGMP interfaces with the IP protocol in Down state and the IGMP protocol in Inactive state.	-
verbose	Displays detailed information about IGMP interfaces.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check the IGMP configuration and running information on an interface, run the display igmp interface command. This command displays IGMP information only when IGMP is enabled on the interface.

Example

# Display the IGMP configuration and running information on VLANIF100.

<HUAWEI> display igmp interface vlanif 100
Interface information of VPN-Instance: public net
 Vlanif100(192.168.1.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.1.2 (this router)
  Total 1 IGMP Group reported

# Display IGMP parameters on all interfaces.

<HUAWEI> display igmp interface verbose
Interface information of VPN-Instance: public net
 Vlanif100(192.168.1.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
   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:44
   Querier for IGMP: 192.168.1.2 (this router)
   IGMP activity: 1 joins, 0 leaves
   Robustness (negotiated): -
   Robustness (configured): 2
   Require-router-alert: disabled
   Send-router-alert: enabled
   Ip-source-policy: disabled
   Query Ip-source-policy: disabled
   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

Choose Columns...

**Table 1** Description of the **display igmp interface** command output
Item	Description
Interface information of VPN-Instance	VPN instance to which IGMP interface information belongs. public net indicates the public network instance.
Vlanif100(192.168.1.2)	Interface type and interface number (IP address).
IGMP is enabled	IGMP has been enabled on an interface. IGMP can be enabled on an interface using the igmp enable command.
Current IGMP version is 2	IGMP version running on an interface. IGMP has three versions: IGMPv1, IGMPv2, and IGMPv3. This parameter is configured using the igmp version command.
IGMP state	Status of an IGMP interface, which can be up or down.
IGMP group policy	Number of the ACL used in an IGMP group policy, which is used to control the number of groups that an interface can join. The ACL is specified by using the igmp group-policy command. The value none indicates that no ACL is applied to the interface.
IGMP limit	Maximum number of IGMP group memberships that the current interface can maintain. This parameter is configured using the igmp limit command.
Value of query interval for IGMP (negotiated)	Interval negotiated by non-queriers for sending Query messages. The negotiated value is only supported by IGMPv3.
Value of query interval for IGMP (configured)	Configured interval for sending IGMP Query messages. This parameter is configured using the igmp timer query command.
Value of other querier timeout for IGMP	Length of the other querier present timer. This parameter is configured using the igmp timer other-querier-present command. The value is 0 on the interface that functions as the querier.
Value of maximum query response time for IGMP	Maximum response time carried by an IGMP Query message. This parameter is configured using the igmp max-response-time command.
Value of last member query time	Last member query time, calculated using the following formula: Last member query time = Last member query interval x Robustness variable The last member query time is not defined in IGMPv1.
Value of last member query interval	Interval for sending Group-Specific Query messages. The value is configured using the igmp lastmember-queryinterval command. This interval is not defined in IGMPv1.
Value of startup query interval	Startup query interval of the querier. The interface sends Query messages at this interval when it starts to function as a querier. The value is 1/4 of the query interval configured using the igmp timer query command. The startup query interval is not defined in IGMPv1.
Value of startup query count	Number of query messages the querier interface sends at startup. The value is configured using the igmp robust-count command. The startup query count is not defined in IGMPv1.
General query timer expiry (hours:minutes:seconds)	Timeout interval of a general query timer.
Querier for IGMP	Link-local address of the IGMP querier. In IGMPv1, the querier is selected based on the multicast routing protocol. In IGMPv2, the multicast switch with the smallest IP address functions as the querier on the shared network segment.
IGMP activity: 1 joins, 0 leaves	Active group memberships on an interface. joins: indicates the number of IGMP groups that the interface has joined. When the interface joins a new group, the value increases by 1. When the interface leaves a group, the value remains unchanged. leaves: indicates the number of groups that the interface has left. When the interface leaves a group, the value increases by 1.
Robustness (negotiated)	Robustness variable negotiated by non-queriers. The negotiated value is only supported by IGMPv3.
Robustness (configured)	Robustness variable configured on an interface. This parameter is configured using the igmp robust-count command.
Require-router-alert	Whether the switch discards IGMP packets that do not contain the Router-Alert option in IP packet headers. enable: The switch discards IGMP packets that do not contain the Router-Alert option in IP packet headers. disable: The switch does not discard IGMP packets that do not contain the Router-Alert option in IP packet headers. This function is configured using the igmp require-router-alert command.
Send-router-alert	Whether the switch sends IGMP packets with the Router-Alert option. enabled: The switch sends IGMP packets with the Router-Alert option. disabled: The switch sends IGMP packets without the Router-Alert option. This function is configured using the igmp send-router-alert command.
Ip-source-policy	Whether to filter IGMP Report/Leave messages based on host addresses. enabled: The switch filters IGMP Report/Leave messages based on host addresses. disabled The switch does not filter IGMP Report/Leave messages based on host addresses. This function is configured using the igmp ip-source-policy command.
Query Ip-source-policy	Whether to filter IGMP Query messages based on source addresses. enabled: The switch filters IGMP Query messages based on source addresses. disabled: The switch does not filter IGMP Query messages based on source addresses. This function is configured using the igmp query ip-source-policy command.
Prompt-leave	Whether fast leave is enabled. enabled: Fast leave is enabled. disabled: Fast leave is disabled. This function is configured using the igmp prompt-leave command.
SSM-Mapping	Whether SSM mapping is enabled. enabled: SSM mapping is enabled. disabled: SSM mapping is disabled. This function is enabled using the igmp ssm-mapping enable command.
Startup-query-timer-expiry	Interval at which the interface sends Query messages when it starts to function as a querier. The value is 1/4 of Timer query. The value off indicates that the interface has not started to send Query messages. The startup query timer is enabled only when the interface starts as a querier.
Other-querier-present-timer-expiry	Status of the other querier present timer: off: The interface considers itself a querier and no other queriers exist. on: The interface no longer considers itself a querier and another querier exists.
TTL-check	Whether the function to check the TTL values in received IGMP Report, Leave, and Query messages is enabled: enabled disabled This function is configured using the igmp ttl-check command.
Total 1 IGMP Group reported	Indicates the number of IGMP groups that the interface dynamically joins.