This command displays PIM neighbors discovered by PIMv2 Hello messages. The argument unit/slot/port corresponds to a physical routing interface or VLAN routing interface. The keyword vlan is used to specify the VLAN ID of the routing VLAN directly instead of in a unit/slot/port format. If the interface number is not specified, the command displays the status parameters of all PIM-enabled interfaces.
| Format | show ip pim neighbor [{unit/slot/port|vlan 1-4093}] |
| Mode |
|
| Term | Definition |
|---|---|
| Neighbor Address | The IP address of the PIM neighbor on an interface. |
| Interface | unit/slot/port |
| Up Time | The time since this neighbor has become active on this interface. |
| Expiry Time | Time remaining for the neighbor to expire. |
| DR Priority | The DR Priority configured on this Interface (PIM-SM only).
Note: DR Priority is applicable only when sparse-mode configured routers are neighbors. Otherwise, NA is displayed
in this field.
Note:
DR indicates that the neighbor is the PIM Designated Router in that subnet. |
Example: The following shows example CLI display output for the command.
(Routing)#show ip pim neighbor 1/0/1
Neighbor Addr Interface Uptime Expiry Time DR
(hh:mm:ss) (hh:mm:ss) Priority
--------------- --------- ----------- ----------- --------
192.168.10.2 1/0/1 00:02:55 00:01:15 10 (DR)
(Routing)#show ip pim neighbor
Neighbor Addr Interface Uptime Expiry Time DR
(hh:mm:ss) (hh:mm:ss) Priority
--------------- --------- ----------- ----------- --------
192.168.10.2 1/0/1 00:02:55 00:01:15 10 (DR)
192.168.20.2 1/0/2 00:03:50 00:02:10 1
If no neighbors have been learned on any of the interfaces, the following message is displayed:
No neighbors exist on the router.
