display multicast statistics

Function

The display multicast statistics command displays global PIM entry statistics.

Format

display multicast global { pim sm | pim dm } statistics

display multicast { all-instance | vpn-instance vpn-instance-name } pim sm statistics

Parameters

Parameter	Description	Value
pim	Indicates the PIM entry.	-
sm	Indicates the PIM-SM mode.	-
dm	Indicates the PIM-DM mode.	-
global	Specifies the global configuration.	-
all-instance	Indicates all VPN instances.	-
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The VPN instance name "_public_" cannot be used. The string can contain spaces if it is enclosed with double quotation marks (").

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
mcast-base	read

Usage Guidelines

Usage Scenario

To check limits and statistics on PIM-SM entries in the IPv4 address family of a specified VPN instance or all VPN instances, run the display multicast pim sm statistics command.

To check PIM entry restriction and statistics in PIM-SM mode, run the display multicast global pim sm statistics command.

To check PIM entry restriction and statistics in PIM-DM mode, run the display multicast global pim dm statistics command.

Prerequisites

Before running the display multicast statistics command to view the limit and statistics on PIM entries, run the multicast global limit command in the system view or the multicast limit command in the VPN view.

Example

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

# Display PIM entry restriction and statistics in the PIM-SM mode.

<HUAWEI> display multicast global pim sm statistics
------------------------------------------------------------------
PIM-SM        Number        Limit         Threshold(Upper%/Lower%)
------------------------------------------------------------------
(*, G)        0             2000          80/70                   
(S, G)        0             1000          80/70                   
------------------------------------------------------------------

# Display limits and statistics on PIM-SM entries in the IPv4 address family of a VPN instance named vpn1.

<HUAWEI> display multicast vpn-instance vpn1 pim sm statistics

VPN-Instance: vpn1
------------------------------------------------------------------
PIM-SM        Number        Limit         Threshold(Upper%/Lower%)
------------------------------------------------------------------
(*, G)        3             2000          80/71                   
(S, G)        0             1000          80/71   
-----------------------------------------------------------------

**Table 1** Description of the **display multicast statistics** command output
Item	Description
PIM-SM	Type of PIM-SM entry for which a limit takes effect. The value can be (*, G) or (S, G).
Number	Number of created PIM entries.
Limit	Limit on the number of PIM entries. If no limit is set, -- is displayed.
Threshold(Upper%/Lower%)	Alarm trigger and clear thresholds. If they are not set, -- is displayed.
VPN-Instance	Name of a VPN instance.