display igmp group
Use display igmp group to display information about IGMP multicast groups (multicast groups that hosts have joined through IGMP).
Syntax
display igmp [ vpn-instance vpn-instance-name ] group [ group-address | interface interface-type interface-number ] [ static | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about IGMP multicast groups on the public network.
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays information about all IGMP multicast groups.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about IGMP multicast groups for all interfaces.
static: Specifies IGMP multicast groups that hosts have joined statically. If you do not specify this keyword, the command displays information about IGMP multicast groups that hosts have joined dynamically.
verbose: Displays detailed information.
Examples
# Display information about IGMP multicast groups that hosts have dynamically joined on the public network.
<Sysname> display igmp group IGMP groups in total: 3 Vlan-interface1(10.10.1.20): IGMP groups reported in total: 3 Group address Last reporter Uptime Expires 225.1.1.1 10.10.1.10 00:02:04 00:01:15 225.1.1.2 10.10.1.10 00:02:04 00:01:15 225.1.1.3 10.10.1.10 00:02:04 00:01:15
Table 32: Command output
Field | Description |
|---|---|
IGMP groups in total | Total number of IGMP multicast groups. |
IGMP groups reported in total | Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically. |
Group address | Multicast group address. |
Last reporter | Address of the last host that reported its membership to the multicast group. |
Uptime | Length of time since the multicast group was reported. |
Expire | Remaining lifetime for the multicast group. This field displays Off if the timer is disabled. |
# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically joined on the public network. In this example, the switch is configured with IGMP SSM mappings.
<Sysname> display igmp group 232.1.1.1 verbose
Vlan-interface1(10.10.1.20):
IGMP groups reported in total: 3
Group: 232.1.1.1
Uptime: 00:00:34
Exclude expires: 00:04:16
Mapping expires: 00:02:16
Last reporter: 10.10.1.10
Last-member-query-counter: 0
Last-member-query-timer-expiry: Off
Mapping last-member-query-counter: 0
Mapping last-member-query-timer-expiry: Off
Group mode: Exclude
Version1-host-present-timer-expiry: Off
Version2-host-present-timer-expiry: 00:02:11
Mapping version1-host-present-timer-expiry: Off
Source list (sources in total: 1):
Source: 10.1.1.1
Uptime: 00:00:03
V3 expires: 00:04:16
Mapping expires: 00:02:16
Last-member-query-counter: 0
Last-member-query-timer-expiry: Off
Table 33: Command output
Field | Description |
|---|---|
IGMP groups reported in total | Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically. |
Group | Multicast group address. |
Uptime | Length of time since the multicast group was reported. |
Exclude expires | Remaining lifetime for the multicast group in Exclude mode. This field displays Off if the timer is disabled. |
Mapping expires | Remaining time for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings. |
Last reporter | Address of the last host that reported its membership to this multicast group. |
Last-member-query-counter | Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group. |
Last-member-query-timer-expiry | Remaining time for the last member query timer for the multicast group. This field displays Off if the timer is disabled. |
Mapping last-member-query-counter | Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings. |
Mapping last-member-query-timer-expiry | Remaining time for the last member query timer of the multicast group specified in IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings. |
Group mode | Multicast source filtering mode:
For a device that runs IGMPv1 or IGMPv2:
|
Version1-host-present-timer-expiry | Remaining time for the IGMPv1 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv2 or IGMPv3. |
Version2-host-present-timer-expiry | Remaining time for the IGMPv2 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv3. |
Mapping version1-host-present-timer-expiry | Remaining time for the IGMPv1 host present timer when the device is configured with IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings. |
Source list (sources in total) | List of multicast sources and total number of multicast sources. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings. |
Source | Multicast source address. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings. |
Uptime | Length of time since the multicast source was reported. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings. |
V3 expires | Remaining time for the multicast source when the device runs IGMPv3. This field displays Off if the timer is disabled and displays three hyphens (---) if the multicast source is specified in IGMP SSM mappings. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings. |
Mapping expires | Remaining time for the multicast source specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings. |
Last-member-query-counter | Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast source and group. This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings. |
Last-member-query-timer-expiry | Remaining time for the last member query timer for the multicast source and group. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings. |
# Display information about IGMP multicast groups that hosts have statically joined on the public network.
<Sysname> display igmp group static Entries in total: 2 Group address Source address Interface Expires 225.1.1.1 0.0.0.0 Vlan1 Never 225.2.2.2 1.1.1.1 Vlan1 Never
Table 34: Command output
Field | Description |
|---|---|
Entries in total | Total number of the multicast groups that hosts have joined statically. |
Group address | Multicast group address. |
Source address | Multicast source address. |
Interface | Interface name. |
Expires | Remaining lifetime for the multicast group. This field always displays Never because the multicast group never expires. |
Related commands
reset igmp group