OcNOS-SP : Multicast Guide : Protocol Independent Multicasting Command Reference : PIMv4 Commands : show ip pim neighbor
show ip pim neighbor
Use this command to display PIM neighbor information.
Command Syntax
show ip pim neighbor (detail|)
show ip pim neighbor IFNAME (detail|)
show ip pim neighbor IFNAME A.B.C.D (detail|)
show ip pim (vrf NAME|) neighbor (detail|)
show ip pim (vrf NAME|) neighbor IFNAME (detail|)
show ip pim (vrf NAME|) neighbor IFNAME A.B.C.D (default|)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
IFNAME
Name of the interface
A.B.C.D
IPv4 address of the neighbor interface
detail
Display detailed information for a PIM neighbor
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show ip pim neighbor
Neighbor Interface Uptime/Expires Ver DR
Address Priority/Mode
10.10.14.11 eth3 00:14:30/00:01:45 v2 1 / DR
 
 
The validation command to view PIM ECMP Redirect is as below:
 
rtr6#show ip pim neighbor detail
Nbr 192.168.10.52 (eth1)
Expires in 83 seconds, uptime 00:21:52
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 1048865461,
Nbr 192.168.1.149 (eth2)
Expires in 99 seconds, uptime 00:22:06
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 2102076842,
Interface ID: Router-ID: 1.1.1.149 Local-ID: 4,
ECMP REDIRECT enabled
Nbr 192.168.1.150 (eth2)
Expires in 77 seconds, uptime 00:22:02
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 1306457151,
Interface ID: Router-ID: 1.1.1.153 Local-ID: 4,
ECMP REDIRECT enabled
Nbr 192.168.1.152 (eth2), DR
Expires in 86 seconds, uptime 00:22:06
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 170629600,
Interface ID: Router-ID: 1.1.1.152 Local-ID: 4,
ECMP REDIRECT enabled
Note: For show ip pim (vrf NAME|) neighbor detail command:
Output shall contain ‘Bidirectional Forwarding Detection is enabled’ in case PIMv4 BFD detection is enabled for this neighbor.
 
Table 1-22: Show ip pim neighbor output
Entry
Description
Neighbor
Neighbor IP address
Interface
Name of the interface (eth1, xe3, xe5/1 etc.).
Uptime/Expires
Neighbor’s uptime / time until uptime expires and starts sending hello messages.
Ver
PIM version (version1 =v1, version2 - v2, version3 = v3).
DR Priority/mode
Priority and Mode of neighbor as Designated Router.
Nbr
NEighbor IP address and interface name (eth1, xe3, xe5/1 etc.).
Expires in
Time before the Hello timer expires and must retransmit.
uptime
Neighbor uptime.
Holdtime:
Before an interface goes down or changes primary IP address, a Hello message with a zero HoldTime should be sent immediately (with the old IP address if the IP address changed). This will cause PIM neighbors to remove this neighbor (or its old IP address) immediately. After an interface has changed its IP address, it MUST send a Hello message with its new IP address. If an interface changes one of its secondary IP addresses, a Hello message with an updated Address_List option and a non-zero HoldTime should be sent immediately. This will cause PIM neighbors to update this neighbor's list of secondary addresses immediately.
T-bit:
RPT-bit is a 1-bit value. The RPT-bit is set to 1 for Assert(*,G) messages and 0 for Assert(S,G) messages.
Lan delay:
In addition to the information recorded for the DR Election, the following per neighbor information is obtained from the LAN Prune Delay Hello option:
In addition to the information recorded for the DR Election, the following per neighbor information is obtained from the LAN Prune Delay Hello option:
 
neighbor.lan_prune_delay_present
A flag indicating if the LAN Prune Delay option was present in
the Hello message.
 
neighbor.tracking_support
A flag storing the value of the T bit in the LAN Prune Delay
option if it is present in the Hello message. This indicates
the neighbor's capability to disable Join message suppression.
 
neighbor.propagation_delay
The Propagation Delay field of the LAN Prune Delay option (if
present) in the Hello message.
 
neighbor.override_interval
The Override_Interval field of the LAN Prune Delay option (if
present) in the Hello message.
 
The additional state described above is deleted along with the DR neighbor state when the neighbor timeout expires.
 
Override interval:
Hello Override Interval
DR priority:
The DR_Priority Option allows a network administrator to give preference to a particular router in the DR election process by giving it a numerically larger DR Priority.The DR_Priority Option SHOULD be included in every Hello message, even if no DR Priority is explicitly configured on that interface. This is necessary because priority-based DR election is only enabled when all neighbors on an interface advertise that they are capable of using the DR_Priority Option. The default priority is 1.
Gen ID:
Generation Identifier, used to detect reboots.
Interface ID:
As stated.
Router-ID:
As stated.
Local-ID:
As stated.
ECMP REDIRECT
Whether ECMP Redirect is enabled or disabled.
Last modified date: 10/20/2023