Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


show pim neighbors


Syntax (EX Series Switch and the QFX Series)


Display information about Protocol Independent Multicast (PIM) neighbors.



(Same as brief) Display standard information about PIM neighbors for all supported family addresses for the main instance.

brief | detail

(Optional) Display the specified level of output.

inet | inet6

(Optional) Display information about PIM neighbors for IPv4 or IPv6 family addresses, respectively.

instance (instance-name | all)

(Optional) Display information about neighbors for the specified PIM-enabled routing instance or for all routing instances.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

Required Privilege Level


Output Fields

Table 1 describes the output fields for the show pim neighbors command. Output fields are listed in the approximate order in which they appear.

Table 1: show pim neighbors Output Fields

Field Name

Field Description

Level of Output


Name of the routing instance.

All levels


Interface through which the neighbor is reachable.

All levels

Neighbor addr

Address of the neighboring PIM routing device.

All levels


IP version: 4 or 6.

All levels


PIM version running on the neighbor: 1 or 2.

All levels


PIM mode of the neighbor: Sparse, Dense, SparseDense, or Unknown. When the neighbor is running PIM version 2, this mode is always Unknown.

All levels


Can be one or more of the following:

  • B—Bidirectional Capable.

  • G—Generation Identifier.

  • H—Hello Option Holdtime.

  • L—Hello Option LAN Prune Delay.

  • P—Hello Option DR Priority.

  • T—Tracking bit.

  • A—Join attribute; used in conjunction with pim rpf-vector.

brief none


Time the neighbor has been operational since the PIM process was last initialized. Starting in Junos OS release 17.3R1, uptime is not reset during ISSU.The time format is as follows: dd:hh:mm:ss ago for less than a week and nwnd:hh:mm:ss ago for more than a week.

All levels


Address of the neighboring PIM routing device.



Status and operational state of the Bidirectional Forwarding Detection (BFD) protocol on the interface: Enabled, Operational state is up, or Disabled.


Hello Option Holdtime

Time for which the neighbor is available, in seconds. The range of values is 0 through 65,535.


Hello Default Holdtime

Default holdtime and the time remaining if the holdtime option is not in the received hello message.


Hello Option DR Priority

Designated router election priority. The range of values is 0 through 255.


Hello Option Join Attribute

Appears in conjunction with the rpf-vector command. The Join attribute is included in the PIM join messages of PIM routers that can receive type 1 Encoded-Source Address.


Hello Option Generation ID

9-digit or 10-digit number used to tag hello messages.


Hello Option Bi-Directional PIM supported

Neighbor can process bidirectional PIM messages.


Hello Option LAN Prune Delay

Time to wait before the neighbor receives prune messages, in the format delay nnn ms override nnnn ms.


Join Suppression supported

Neighbor is capable of join suppression.


Rx Join

Information about joins received from the neighbor.

  • Group—Group addresses in the join message.

  • Source—Address of the source in the join message.

  • Timeout—Time for which the join is valid.


Sample Output

show pim neighbors

show pim neighbors instance

show pim neighbors detail

show pim neighbors detail (With BFD)

Release Information

Command introduced before Junos OS Release 7.4.

inet6 and instance options introduced in Junos OS Release 10.0 for EX Series switches.

Support for bidirectional PIM added in Junos OS Release 12.1.

Support for the instance all option added in Junos OS Release 12.1.

Support for RFC 5496 (via rpf-vector) added in Junos OS Release 17.3R1.

Change History Table

Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.

Starting in Junos OS release 17.3R1, uptime is not reset during ISSU.