display pim ipv6 control-message counters

Function

The display pim ipv6 control-message counters command displays the number of sent and received IPv6 PIM control messages.

Format

display pim ipv6 control-message counters [ message-type { crp | probe | register | register-stop } ]

display pim ipv6 { vpn-instance instance-name | all-instance } control-message counters [ message-type { crp | probe | register | register-stop } ]

display pim ipv6 { vpn-instance instance-name | all-instance } control-message counters interface { interface-type interface-number | interface-name } [ message-type { assert | bsr | hello | join-prune } ]

display pim ipv6 { vpn-instance instance-name | all-instance } control-message counters message-type { assert | bsr | hello | join-prune } [ interface { interface-type interface-number | interface-name } ]

Parameters

Parameter	Description	Value
message-type	Indicates the type of a PIM message.	-
crp	Indicates the number of Candidate-Rendezvous Point (C-RP) messages.	-
probe	Indicates the number of Probe messages.	-
register	Indicates the number of Register messages.	-
register-stop	Indicates the number of Register-Stop messages.	-
vpn-instance instance-name	Specify the name of a VPN instance.	The value is a string of 1 to 31 characters.
all-instance	Specifies all VPN instance.	-
interface interface-type interface-number	Specifies the type and number of an interface.	-
assert	Indicates the number of Assert messages.	-
bsr	Indicates the number of BootStrap router (BSR) messages.	-
hello	Indicates the number of Hello messages.	-
join-prune	Indicates the number of Join/Prune messages.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
pim	read

Usage Guidelines

Usage Scenario

The display pim ipv6 control-message counters command is used to display the number received, sent, invalid, or filtered out IPv6 PIM control messages. This command is usually used to locate faults in IPv6 PIM, for example:

If a PIM neighbor relationship cannot be set up, run this command on two ends to check whether they can normally send or receive Hello messages.
If (*, G) or (S, G) entries cannot be generated, run this command on an upstream or downstream device to check whether the device can normally send or receive Join/Prune messages.
On live networks, check the number of PIM messages of a specific type based on fault symptoms.

Precautions

If no interface is specified, the number of sent and received IPv6 PIM control messages on all interfaces is displayed.

Example

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

# Display the number of sent, received, invalid, filtered IPv6 PIM control messages on GE 0/1/0 in the public network instance.

<HUAWEI> display pim ipv6 control-message counters
VPN-Instance: public net
 Register* - Register Anycast-RP, Probe* - Probe Anycast-RP
- ---------------------------------------------------------------------------
 PIM global control-message counters:
 MessageType      Received         Sent             Invalid          Filtered
 Register         0                0                0                0
 Register-Stop    0                0                0                0
 Probe            0                0                0                0
 C-RP             0                0                0                0
 Register*        0                0                0                0
 Probe*           0                0                0                0
 PIM control-message counters for interface: GigabitEthernet0/1/0
 MessageType      Received         Sent             Invalid          Filtered
 Assert           0                0                0                0
 Hello            0                3                0                0
 Join-prune       0                0                0                0
 BSR              0                0                0                0

**Table 1** Description of the **display pim ipv6 control-message counters** command output
Item	Description
Register*	Statistics about Register messages in the Anycast-RP scenario.
Register	Statistics about Register messages.
Probe*	Statistics about Probe messages in the Anycast-RP scenario.
Probe	Statistics about Null-Register messages.
PIM global control-message counters	Global statistics about PIM control messages.
PIM control-message counters for interface	Interface that collects statistics of PIM control messages.
MessageType	Type of a PIM control message.
Received	Number of PIM control messages received by the current interface.
Sent	Number of PIM control messages sent by the current interface.
Invalid	Number of invalid PIM control messages.
Filtered	Number of PIM control messages filtered out by the current interface.
Register-Stop	Statistics about Register-Stop messages.
C-RP	Statistics about Advertisement messages of a C-RP.
Assert	Assert messages.
Hello	Hello messages.
Join-prune	Join/Prune messages.
BSR	Bootstrap messages.
VPN-Instance	VPN instance to which PIM control message statistics belong.