show ip pim neighbor

Use this command to display information about discovered PIM neighbors.

Syntax

show ip pim neighbor [ifName] [brief] [detail] [statistics]

Parameters

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.

Defaults

If no options are specified, a standard level of information for all PIM neighbors displays.

Mode

All command modes.

Examples

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.

Click to expand in new window

show ip pim neighbor Output Details

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.

Click to expand in new window

show ip pim neighbor detail Output Details

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.

Click to expand in new window

show ip pim neighbor brief Output Details

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.