display l2-multicast vsi listened-user-number slot group source

Function

The display l2-multicast vsi listened-user-number slot group source command displays statistics about listened users in a specified multicast group on a specified board in a VSI.

Format

display l2-multicast vsi vsi-name listened-user-number slot slot-id group group-address source source-address

display l2-multicast vsi vsi-name listened-user-number slot slot-id group group-address source wildcard

Parameters

Parameter	Description	Value
vsi-name	Specifies a VSI name.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. A VSI name must be unique on a device. The character string can contain spaces if it is enclosed in double quotation marks (").
slot-id	Specifies a slot ID.	-
group-address	Specifies a multicast group IP address.	The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
source-address	Specifies a multicast source IP address.	The value is a unicast address in dotted decimal notation.
wildcard	Indicates that no multicast source IP address is specified.	A multicast source IP address is all 0s.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
l2mc	read

Usage Guidelines

Usage Scenario

To check statistics about listened users in a specified multicast group on a specified board in a VSI, run the display l2-multicast vsi listened-user-number slot command. If you run this command to view a IGMPv2 group or an IGMPv3 group in Exclude mode, you must specify a group address and source address. wildcard is specified for the source address.

Precautions

The command has a delay in displaying data because of sampling. The maximum delay is 10 seconds for statistics in the last 5 minutes, 5 minutes for statistics in the last 15 minutes, and 1 hour for statistics in the last 24 hours. After a master/slave board switchover, the data changes on the master and slave boards are different. As a result, the displayed content is different.
The command counts only the number of users who are in the valid join state. The statistics include users who sent IGMPv2 Join messages and IGMPv3 Exclude Join messages, users who sent IGMPv3 Include (S, G) Join messages, and users for whom the collision domain source information is generated in an IGMPv3 group in Include mode instead of the block source user information in an IGMPv3 group in Exclude mode or the user information in an IGMPv3 group in Include mode.

Example

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

# Display statistics about listened users in the group (0.0.0.0, 255.0.0.2) on the board in slot 1 in a VSI named iptv.

<HUAWEI> display l2-multicast vsi iptv listened-user-number slot 1 group 225.0.0.2 source wildcard
 User statistics on the listened interface for each group:
    Statistic start time: 00:03:08
    Limit number: 32000
    Slot-Id: 1
     (0.0.0.0, 225.0.0.2)
       Current number: 2
       Sample once every 10 seconds:
         Maximum number in last 5 minutes: 2
         Minimum number in last 5 minutes: 2
         Average number in last 5 minutes: 2
         Maximum number in last 15 minutes: 2
         Minimum number in last 15 minutes: 2
         Average number in last 15 minutes: 2
         Maximum number in last 24 hours: 2
         Minimum number in last 24 hours: 2
         Average number in last 24 hours: 2

**Table 1** Description of the **display l2-multicast vsi listened-user-number slot group source** command output
Item	Description
Statistic start time	Duration of the statistics.
Limit number	Maximum value allowed.
Current number	Total number of all Layer 2 multicast users on the listened interface.
Sample once every 10 seconds	Data sampled every 10 seconds.
Maximum number in last 5 minutes	Maximum value of all sampled data in the last 5 minutes.
Maximum number in last 15 minutes	Maximum value of all sampled data in the last 15 minutes.
Maximum number in last 24 hours	Maximum value of all sampled data in the last 24 hours.
Minimum number in last 5 minutes	Minimum value of all sampled data in the last 5 minutes.
Minimum number in last 15 minutes	Minimum value of all sampled data in the last 15 minutes.
Minimum number in last 24 hours	Minimum value of all sampled data in the last 24 hours.
Average number in last 5 minutes	Average value of all sampled data in the last 5 minutes.
Average number in last 15 minutes	Average value of all sampled data in the last 15 minutes.
Average number in last 24 hours	Average value of all sampled data in the last 24 hours.
Slot-Id	Slot ID.