display pim neighbor

Function

The display pim neighbor command displays information about PIM neighbors.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] neighbor [ neighbor-address | interface interface-type interface-number | verbose ] ^*

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value must be an existing VPN instance name.
all-instance	Specifies all the instances.	-
interface interface-type interface-number	Specifies the type and number of an interface.	-
neighbor-address	Specifies the IP address of a PIM neighbor.	The address is in dotted decimal notation.
verbose	Displays detailed information about PIM neighbors.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim neighbor command displays information about PIM neighbors, including the number of neighbors, DR priority, and BFD session status. You can adjust PIM neighbor relationships based on the command output.

When you run the display pim neighbor command:

If you specify interface interface-type interface-number, the command displays information about PIM neighbors connected to the specified interface.
If you do not specify interface interface-type interface-number, the command displays information about all PIM neighbors attached to the switch.

Example

# Display information about all PIM neighbors.

<HUAWEI> display pim neighbor
 VPN-Instance: public net
 Total Number of Neighbors = 2

 Neighbor        Interface     Uptime       Expires      Dr-Priority  BFD-Session 
 10.1.1.2        Vlanif10      02:50:49     00:01:31     1            Y
 10.1.2.2        Vlanif20      02:49:39     00:01:42     1            Y

**Table 1** Description of the **display pim neighbor** command output
Item	Description
Total Number of Neighbors	Total number of PIM neighbors on an interface.
Neighbor	IP Address of a PIM neighbor.
Interface	Interface connected to a PIM neighbor.
Uptime	Time elapsed since a PIM neighbor relationship is set up.
Expires	Amount of time left before a PIM relationship times out.
Dr-Priority	DR priority of a PIM neighbor.
BFD-Session	Whether the BFD session has been set up with a neighbor. Y: The BFD session has been set up. N: The BFD session has not been set up.

# Display detailed information about the PIM neighbor with IP address 10.1.1.2 in the public network instance.

<HUAWEI> display pim neighbor 10.1.1.2 verbose
 VPN-Instance: public net
 Neighbor: 10.1.1.2
     Interface: Vlanif 10
     Uptime: 02:53:50
     Expiry time: 00:01:30
     DR Priority: 1
     Generation ID: 0X90B0360B
     Holdtime: 105 s
     LAN delay: 500 ms
     Override interval: 2500 ms
     Neighbor tracking: Disabled
     PIM BFD-Session: Y
     PIM BFD-Session min-tx-interval: 1000 ms
     PIM BFD-Session min-rx-interval: 1000 ms
     PIM BFD-Session detect-multiplier: 3

**Table 2** Description of the **display pim neighbor verbose** command output
Item	Description
Expiry time	Amount of time left before a PIM relationship times out.
Generation ID	PIM neighbor status random value.
Holdtime	Keepalive period of the PIM neighbor.
LAN delay	Delay in transmitting Prune messages.
Override interval	Override interval for a prune action.
State refresh interval	Interval at which State-Refresh messages are sent.
Neighbor tracking	Whether the neighbor tracking function is enabled. enabled: Neighbor tracking is enabled. disabled: Neighbor tracking is disabled.
PIM BFD-Session	Whether the BFD session is set up. Y: The BFD session has been set up. N: The BFD session has not been set up.
PIM BFD-Session min-tx-interval	Minimum interval at which PIM BFD packets are sent.
PIM BFD-Session min-rx-interval	Minimum interval at which PIM BFD packets are received.
PIM BFD-Session detect-multiplier	PIM BFD detection multiplier.