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 a VPN instance. vpn-instance-name specifies the name of the VPN instance.	The name is a string of 1 to 31 characters.
all-instance	Specifies all the instances.	-
neighbor	Specifies the neighbor.	-
neighbor-address	Indicates the IP address of a PIM neighbor.	The address is in dotted decimal notation.
interface interface-type interface-number	Specifies the type and number of an interface.	-
verbose	Indicates the details of PIM neighbors.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If a PIM neighbor relationship fails to be established or you need to learn information about PIM neighbor relationship establishment, you can run the display pim neighbor command to view information about PIM neighbor relationships.

Precautions

When the display pim neighbor command is used, the following situations occur:

If vpn-instance or all-instance is not specified, only information about the public network instance is displayed.
If interface interface-type interface-number is specified, only information about PIM neighbors connected to the interface is displayed. If this parameter is not specified, information about all PIM neighbors on the FW is displayed.
If neighbor-address is specified, information only about PIM neighbor specified by this parameter is displayed. If this parameter is not specified, information about all PIM neighbors on the FW is displayed.

Example

# Display information about all PIM neighbors in the public network instance.

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

 Neighbor        Interface     Uptime       Expires      DR-Priority  BFD-Session 
 10.1.1.2        GE0/0/1       02:50:49     00:01:31     1            Y
 10.2.1.2        GE0/0/2       02:49:39     00:01:42     1            Y

**Table 1** Description of the **display pim neighbor** command output
Item	Description
VPN-Instance	Indicates the VPN instance to which the PIM neighbor belongs.
Total Number of Neighbors	Indicates the total number of PIM neighbors on the interface.
Neighbor	Indicates the address of the PIM neighbor.
Interface	Indicates the interface of the PIM neighbor.
Uptime	Indicates the period during which the PIM neighbor exists.
Expires	Indicates the period before the PIM neighbor times out.
Dr-Priority	Indicates the priority of the Designated router (DR).
BFD-Session	Indicates whether the BFD session is set up.

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

<sysname> display pim neighbor 10.1.1.2 verbose
 VPN-Instance: public net
 Neighbor: 10.1.1.2
     Interface: GigabitEthernet0/0/1
     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: N
     PIM BFD-Session min-tx-interval: 1000 ms
     PIM BFD-Session min-rx-interval: 1000 ms
     PIM BFD-Session detect-multiplier: 3
     PIM join attribute: disabled

**Table 2** Description of the **display pim neighbor verbose** command output
Item	Description
Expiry time	Indicates the period before the PIM neighbor times out.
Generation ID	Indicates the random number of the PIM neighbor status.
Holdtime	Indicates the Keepalive period of the PIM neighbor, in seconds.
LAN delay	Indicates the delay for transmitting Prune messages.
Override interval	Indicates the interval at which the prune action is overridden.
State refresh interval	Indicates the interval at which the state is refreshed.
Neighbor tracking	Indicates whether the neighbor tracking function is enabled.
PIM BFD-session	Indicates whether the BFD session is set up.
PIM BFD-Session min-tx-interval	Indicates the minimum interval at which PIM BFD packets are sent.
PIM BFD-session min-rx-interval	Indicates the minimum interval at which PIM BFD packets are received.
PIM BFD-session detect-multipler	Indicates the PIM BFD detection multiple.
PIM join attribute	Indicates whether the join attribute function is enabled on a PIM neighbor.