display multicast (user-id)

Function

The display multicast command displays information about multicast programs that a specified user joins on a BAS interface.

Format

display multicast { user-id UserIdValue | user-ip UserIpV4 }

display multicast user-ip UserIpV4 vpn-instance vpn-instance-name

Parameters

Parameter	Description	Value
user-id UserIdValue	Displays information about multicast programs that a specified user joins on a BAS interface. user-id specifies a user ID.	The value is an integer ranging from 0 to 4294967295.
user-ip UserIpV4	Displays information about multicast programs that a specified user joins on a BAS interface.	-
vpn-instance vpn-instance-name	Displays information about multicast programs that a specified user in a specified VPN instance joins on a BAS interface. vpn-instance-name specifies a VPN instance name.	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.

Parameter

Description

Value

user-id UserIdValue

Displays information about multicast programs that a specified user joins on a BAS interface.

user-id specifies a user ID.

The value is an integer ranging from 0 to 4294967295.

user-ip UserIpV4

Displays information about multicast programs that a specified user joins on a BAS interface.

vpn-instance vpn-instance-name

Displays information about multicast programs that a specified user in a specified VPN instance joins on a BAS interface. vpn-instance-name specifies a VPN instance name.

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 information about multicast programs that a specified user joins on a BAS interface, run the display multicast command.

Example

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

# Display information about static multicast programs that the user with the ID 18 joins.

<HUAWEI> display multicast user-id 18
  User information:
  User ID             :18
  User IPv4 address   :1.0.0.5
  Gateway IPv4 address:1.0.0.1
  BRAS interface      :GigabitEthernet0/1/1
  User MAC-address    :00-e0-fc-12-34-56
  MAX program list    :4
 
  User order program:
  Group IP           Source IP
  225.0.0.1          0.0.0.0
  225.0.0.2          0.0.0.0
  225.0.0.3          0.0.0.0
  225.0.0.4          0.0.0.0
 
  Total:4

  User static program:
  Group IP           Source IP     Flag
  225.1.0.1          0.0.0.0       Inactive
  225.1.0.2          0.0.0.0       Active
  225.1.0.3          0.0.0.0       Active

  Total:3

# Display information about multicast programs that a user joins, with the user IP address being set to 10.0.0.250 and VPN instance name to red.

<HUAWEI> display multicast user-ip 10.0.0.250 vpn-instance red
  User information:
  User ID             :96
  User IPv4 address   :10.0.0.250
  Gateway IPv4 address:10.0.0.1
  BRAS interface      :GigabitEthernet0/1/1.1
  User MAC-address    :00-e0-fc-22-34-56
  MAX program list    :4

  User order program:
  Group IP           Source IP
  225.0.0.1          0.0.0.0

  Total:1

# Display information about multicast programs that a user with IPv4 address 10.0.0.152 joins.

<HUAWEI> display multicast user-ip 10.0.0.152
  User information:
  User ID             :1408
  User IPv4 address   :10.0.0.152
  Gateway IPv4 address:10.0.0.1
  BRAS interface      :GigabitEthernet0/1/0
  User MAC-address    :00-e0-fc-32-34-56
  MAX program list    :4


  User order program:
  Group IP           Source IP          
  225.0.0.1          0.0.0.0            
  225.0.0.2          0.0.0.0            
  225.0.0.3          0.0.0.0            


  Total:3

# Display information about multicast programs that an IPv4 user with ID 1408 joins.

<HUAWEI> display multicast user-id 1408
  User information:
  User ID             :1408
  User IPv4 address   :10.0.0.152
  Gateway IPv4 address:10.0.0.1
  BRAS interface      :GigabitEthernet0/1/0
  User MAC-address    :00-e0-fc-32-34-56
  MAX program list    :4


  User order program:
  Group IP           Source IP          
  225.0.0.1          0.0.0.0            
  225.0.0.2          0.0.0.0            
  225.0.0.3          0.0.0.0            


  Total:3

**Table 1** Description of the **display multicast (user-id)** command output
Item	Description
User information	User information.
User ID	User ID.
User IPv4 address	IPv4 address of a user.
User MAC-address	MAC address of a user.
User order program	Multicast programs that a user joins.
User static program	Multicast programs that a user joins.
Gateway IPv4 address	IPv4 gateway address.
BRAS interface	BAS inbound interface.
MAX program list	Maximum number of programs that a user can join.
Group IP	Multicast group address.
Source IP	Multicast source address.
Flag	Static multicast program status, which can be Active or Inactive.
Total	Total number of multicast programs that a user joins.