Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show pim neighbors

 

List of Syntax

Syntax

Syntax (EX Series Switch and the QFX Series)

Syntax

Syntax (EX Series Switch and the QFX Series)

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.

Description

Display information about Protocol Independent Multicast (PIM) neighbors.

Options

none(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

view

List of Sample Output

show pim neighbors

show pim neighbors instance

show pim neighbors detail

show pim neighbors detail (With BFD)

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

Instance

Name of the routing instance.

All levels

Interface

Interface through which the neighbor is reachable.

All levels

Neighbor addr

Address of the neighboring PIM routing device.

All levels

IP

IP version: 4 or 6.

All levels

V

PIM version running on the neighbor: 1 or 2.

All levels

Mode

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

Option

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

Uptime

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

Address of the neighboring PIM routing device.

detail

BFD

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

detail

Hello Option Holdtime

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

detail

Hello Default Holdtime

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

detail

Hello Option DR Priority

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

detail

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.

detail

Hello Option Generation ID

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

detail

Hello Option Bi-Directional PIM supported

Neighbor can process bidirectional PIM messages.

detail

Hello Option LAN Prune Delay

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

detail

Join Suppression supported

Neighbor is capable of join suppression.

detail

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.

detail

Sample Output

show pim neighbors

user@host> show pim neighbors

show pim neighbors instance

user@host> show pim neighbors instance VPN-A

show pim neighbors detail

user@host> show pim neighbors detail

show pim neighbors detail (With BFD)

user@host> show pim neighbors detail
Release History Table
Release
Description
Starting in Junos OS release 17.3R1, uptime is not reset during ISSU.