display igmp group
Function
The display igmp group command displays information about IGMP groups, including groups that hosts have dynamically joined by sending Report messages and groups that are statically configured on an interface.
Format
display igmp group [ group-address | interface interface-type interface-number ] * [ static ] [ verbose ]
Parameters
| Parameter | Description | Value |
|---|---|---|
| group-address | Specifies a multicast group address. If this parameter is not specified, the command displays information about all IGMP groups that have established group memberships. | The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation. |
| interface interface-type interface-number | Specifies the type and number of an interface. If this parameter is not specified, the command displays information about IGMP groups on all interfaces. | - |
| static | Displays information about IGMP groups statically configured on an interface. If this parameter is not specified, the command displays information about IGMP groups that interfaces dynamically joined. The igmp static-group command is used to statically bind a multicast group to an interface. | - |
| verbose | Displays detailed information about IGMP groups. If the parameter is not specified, the command displays only the summary of IGMP groups. | - |
Usage Guidelines
You can use this command to check information about multicast groups that have established memberships.
Example
# Display information about dynamic IGMP groups.
<AC6605> 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 IGMP groups.
<AC6605> 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
Item |
Description |
|---|---|
Interface group report information of VPN-Instance |
IGMP group information on an interface. |
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:
|
Expires |
Time left before a group will be deleted from the IGMP group
table. The time format is as follows:
"off" indicates that the group will never be aged out. |
Last Reporter |
Last host that sends a Report message. |
| 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, in seconds. 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. 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 is running IGMPv3 and has IGMPv3 receiver hosts attached. |
Source |
IP address of a multicast source. |
# Display information about IGMP groups statically configured on VLANIF100.
<AC6605> display igmp group interface vlanif 100 static Static join group information of VPN-Instance: public net Total 2 entries Specified interface state:UP Total 2 entries matched Group Address Source Address Expires 226.0.0.1 10.0.5.120 never 226.0.0.2 0.0.0.0 never
Item |
Description |
|---|---|
Static join group information of VPN-Instance |
Information about static IGMP groups. |
Total 2 entries |
Number of multicast groups configured on an interface. |
Specified interface state |
Status of the specified interface. |
Total 2 entries matched |
Number of IGMP groups that meet the query conditions. |
Group Address |
Multicast group address. |
Source Address |
Multicast source address. |
Expires |
Expiration time of static IGMP groups. These groups will never time out. |
