Use this command to display information about discovered PIM neighbors.
ifName | (Optional) Displays information about a specific PIM interface. This interface must be enabled with PIM as described in ip pim sparse-mode. |
brief | (Optional) Displays a summary level of information about all PIM neighbors or a specific PIM neighbor. |
detail | (Optional) Displays detailed information about all PIM interfaces or a specific PIM interface. |
statistics | (Optional) Displays PIM statistics information for all neighbors. |
If no options are specified, a standard level of information for all PIM neighbors displays.
All command modes.
This example shows how to display PIM neighbor information:
System(su)->show ip pim neighbor Neighbor Address Interface DR Priority Uptime Expires ------------------------------------------------------------------------------ 192.168.12.2 vlan.0.12 1 00:07:54 00:01:24 192.168.13.3 vlan.0.13 1 00:07:48 00:01:27
This example shows how to display PIM neighbor information for a specific PIM neighbor:
System(su)->show ip pim neighbor vlan.0.12 Neighbor Address Interface DR Priority Uptime Expires ------------------------------------------------------------------------------ 192.168.12.2 vlan.0.12 1 00:07:54 00:01:24
show ip pim neighbor Output Details provides an explanation of the command output.
Output... | What it displays... |
---|---|
PIM Neighbor Address | IP address of the PIM neighbor. |
Interface | Specifies the interface for the PIM neighbor. |
DR Priority | Specifies the value of the designated router priority from the last PIM Hello message received from this neighbor. This object is always zero if pimNeighborDRPriorityPresent is FALSE. |
Uptime | Specifies the length of time in hours, minutes, and seconds that this PIM neighbor has been in the PIM neighbor table. |
Expires | Specifies the length of time in hours, minutes, and seconds until this PIM neighbor will be removed from the IP multicast routing table. |
This example shows how to display detailed PIM neighbor information for a specific PIM neighbor:
System(su)->show ip pim neighbor vlan.0.12 detail Interface vlan.0.12 PIM Neighbor Address: 192.168.12.2 PIM Neighbor Uptime: 00:08:02 PIM Neighbor Expiry: 00:01:16 PIM Generation Id : 2682437344 (0x9fe2bee0) PIM DR Priority: 1 PIM Lan Prune Delay Present: true PIM Lan Prune Delay Tbit Present: false PIM Propagation Delay: 500 PIM Override Interval: 2500 PIM Generation Id Present: true PIM DR Priority Present: true
show ip pim neighbor detail Output Details provides an explanation of the command output.
Output... | What it displays... |
---|---|
PIM Neighbor Address | IP address of the PIM neighbor. |
PIM Neighbor Uptime | The time since this PIM neighbor last became a neighbor of the local router. |
PIM Neighbor Expiry | The minimum time remaining before this PIM neighbor will be aged out. The value zero indicates that this PIM neighbor will never be aged out. |
PIM Generation Id | The value of the Generation ID from the last PIM Hello message received from this neighbor. This object is always zero if pimNeighborGenerationIDPresent is FALSE. |
PIM DR Priority | The value of the Designated Router Priority from the last PIM Hello message received from this neighbor. This object is always zero if pimNeighborDRPriorityPresent is FALSE. |
PIM Lan Prune Delay Present | Evaluates to TRUE if this neighbor is using the LAN Prune Delay option. |
PIM Lan Prune Delay Tbit Present | Evaluates to TRUE if this neighbor is using the LAN Prune Delay Tbit option. Whether the T bit was set in the LAN Prune Delay option received from this neighbor. The T bit specifies the ability of the neighbor to disable join suppression. |
PIM Propagation Delay | The value of the Propagation_Delay field of the LAN Prune Delay option received from this neighbor. This object is always zero if pimNeighborLanPruneDelayPresent is FALSE. |
PIM Override Interval | The value of the Override_Interval field of the LAN Prune Delay option received from this neighbor. This object is always zero if pimNeighborLanPruneDelayPresent is FALSE. |
PIM Generation ID Present | Evaluates to TRUE if this neighbor is using the Generation ID option. |
PIM DR Priority Present | Evaluates to TRUE if this neighbor is using the DR Priority option. |
This example shows how to display a summary level of PIM neighbor information for a specific PIM neighbor:
System(su)->show ip pim neighbor vlan.0.12 brief Interface vlan.0.12 PIM Neighbor Address: 192.168.12.2 PIM Neighbor Uptime: 00:08:00 PIM Neighbor Expiry: 00:01:18 PIM Generation Id : 2682437344 (0x9fe2bee0) PIM DR Priority: 1
show ip pim neighbor brief Output Details provides an explanation of the command output.
Output... | What it displays... |
---|---|
Neighbor Address | Specifies the PIM neighbor IP address for this information. |
Interface | Specifies the PIM interface for this information. |
DR Priority | Specifies the priority value of the designated router. |
Uptime | Specifies the amount of time this neighbor has been up. |
Expires | The minimum time remaining before this PIM neighbor will be aged out. The value zero indicates that this PIM neighbor will never be aged out. |