show ip pim neighbor

Displays information about PIM neighbors.
Syntax
show ip pim neighbor [ ethernet unit/slot/port | lag number | tunnel number | ve ve-number ]
Parameters
ethernet unit/slot/port
Specifies a physical interface. On standalone devices specify the interface ID in the format slot/port-id; on stacked devices you must also specify the stack ID, in the format stack-id/slot/port-id.
lag number
Specifies a LAG interface.
tunnel number
Specifies a GRE tunnel.
ve ve-number
Specifies a virtual interface.
Modes

User EXEC mode

The show ip pim neighbor command displays the following information:

Output Field

Description

Port

The interface through which the device is connected to the neighbor.

Phyport

When there is a virtual interface, this is the physical port to which the neighbor is connected.

Neighbor

The IP interface of the PIM neighbor.

Holdtime sec

Indicates how many seconds the neighbor wants this device to hold the entry for this neighbor in memory. The neighbor sends the Hold Time in Hello packets:

  • If the device receives a new Hello packet before the Hold Time received in the previous packet expires, the device updates its table entry for the neighbor.
  • If the device does not receive a new Hello packet from the neighbor before the Hold time expires, the device assumes the neighbor is no longer available and removes the entry for the neighbor.

Age sec

The number of seconds since the device received the last hello message from the neighbor.

UpTime sec

The number of seconds the PIM neighbor has been up. This timer starts when the device receives the first Hello messages from the neighbor.

VRF

The VRF in which the interface is configured. This can be a VRF that the port was assigned to or the default VRF of the device.

Priority

The DR priority that is used in the DR election process. This can be a configured value or the default value of 1.

Examples

The following example shows information about PIM neighbors. 

device> show ip pim neighbor

--------+--------+---------------+--------+---+---------+---------+-----+------------+-----------+----
Port    |PhyPort |Neighbor       |Holdtime|T  |PropDelay|Override |Age  |UpTime      |VRF        |Prio
        |        |               |sec     |Bit|msec     |msec     |sec  |            |           |    
--------+--------+---------------+--------+---+---------+---------+-----+------------+-----------+----
v2       e1/1/1     2.1.1.2         105      1   500       3000      0     00:44:10  default-vrf 1    
v4       e1/2/2     4.1.1.2         105      1   500       3000      10    00:42:50  default-vrf 1    
v5       e1/1/4     5.1.1.2         105      1   500       3000      0     00:44:00  default-vrf 1    
v22      e1/1/1     22.1.1.1        105      1   500       3000      0     00:44:10  default-vrf 1    
Total Number of Neighbors : 4
Parent topic: Show Commands