display multicast group-ip

Function

The display multicast group-ip command displays user information of a specified multicast group.

Format

display multicast group-ip { group-ipv4-address | group-ipv6-address } [ static ] out-interface { interface-type interface-number | interface-name }

display multicast group-ip { group-ipv4-address } [ static ] out-interface { interface-type interface-number | interface-name } vpn-instance vpn-instance-name

display multicast group-ip { group-ipv4-address | group-ipv6-address } [ static ]

display multicast group-ip { group-ipv4-address } [ static ] vpn-instance vpn-instance-name

Parameters

Parameter	Description	Value
group-ipv4-address	Displays user information of a specified IPv4 multicast group.	-
group-ipv6-address	Displays user information of a specified IPv6 multicast group.	-
static	Displays information about users in a specified static multicast program.	-
out-interface interface-type	Specifies an outbound interface type.	-
interface-number	Specifies an outbound interface number.	-
interface-name	Specifies the name of an interface.	-
vpn-instance vpn-instance-name	Displays user information of a specified 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.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
igmp	read

Usage Guidelines

To check user information of a specified multicast group, run the display multicast group-ip command. The command output helps you learn audience rating and user preferences.

Example

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

# Display information about users of group 225.0.0.1, on the outbound interface GE 0/1/1.1, and in the VPN instance named red.

<HUAWEI> display multicast group-ip 225.0.0.1 out-interface GigabitEthernet 0/1/1.1 vpn-instance red
  User ID    User IP                     User type    Interface

  96         10.0.0.250                  Local        GigabitEthernet0/1/1.1
  97         10.0.0.249                  Local        GigabitEthernet0/1/1.1

  Local user number :2
  Remote user number:0
  Total user number :2

# Display information about users of group 225.0.0.1, on the interface board in slot 1, and in the VPN instance named red.

<HUAWEI> display multicast group-ip 225.0.0.1 slot 1 vpn-instance red
  User ID    User IP                     User type    Interface                                                       
  0          10.0.0.160                  Local        GigabitEthernet0/1/0

  Local user number :1
  Remote user number:0
  Total user number :1

# Display information about users of group FF17::1 on the outbound interface Eth-Trunk1.

<HUAWEI> display multicast group-ip FF17::1 out-interface Eth-Trunk 1
  User ID    User IP                     User type    Interface

  65         2001:DB8:11::1     Local        Eth-Trunk1

  Local user number :1
  Remote user number:0
  Total user number :1

# Display information about users of group 225.0.0.1 on the outbound interface GE 0/1/0.

<HUAWEI> display multicast group-ip 225.0.0.1 out-interface GigabitEthernet 0/1/0
  User ID    User IP                     User type    Interface                                                       
  1408       10.0.0.152                  Local        GigabitEthernet0/1/0
  1410       10.0.0.150                  Local        GigabitEthernet0/1/0


  Local user number :2
  Remote user number:0
  Total user number :2

# Display information about users of the static multicast group 225.0.0.1 on the interface board in slot 1.

<HUAWEI> display multicast group-ip 225.0.0.1 static slot 1
  User ID    User IP                     User type    Interface                                                       
  1408       10.0.0.152                  Local        GigabitEthernet0/1/0
  1410       10.0.0.150                  Local        GigabitEthernet0/1/0
  1411       10.0.0.149                  Local        GigabitEthernet0/1/1
  1413       10.0.0.147                  Local        GigabitEthernet0/1/1

  Local user number :4
  Remote user number:0
  Total user number :4

# Display information about users of multicast group FF17::1 on the interface board in slot 1.

<HUAWEI> display multicast group-ip FF17::1 slot 1
  User ID    User IP                     User type    Interface

  65         2001:DB8:11::1     Local        Eth-Trunk1

  Local user number :1
  Remote user number:0
  Total user number :1

# Display information about users of multicast group 225.0.0.1 on the interface board in slot 1.

<HUAWEI> display multicast group-ip 225.0.0.1 slot 1
  User ID    User IP                     User type    Interface                                                       
  1408       10.0.0.152                  Local        GigabitEthernet0/1/0
  1410       10.0.0.150                  Local        GigabitEthernet0/1/0
  1411       10.0.0.149                  Local        GigabitEthernet0/1/1
  1413       10.0.0.147                  Local        GigabitEthernet0/1/1

  Local user number :4
  Remote user number:0
  Total user number :4

**Table 1** Description of the **display multicast group-ip** command output
Item	Description
User ID	User ID.
User IP	User IP address.
User type	User Type. Local: local user. Remote: remote user. In a CU separation scenario, the user type displayed in the command output is the user type displayed on the forwarder but not the user type displayed on the controller.
Interface	Outbound interface for the multicast traffic.
Local user number	Number of local users.
Remote user number	Number of remote users.
Total user number	Total number of local users and remote users.