show pim neighbors
List of Syntax
SyntaxSyntax (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
Required Privilege Level
view
List of Sample Output
show pim neighborsshow 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:
| 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.
| detail |
Sample Output
show pim neighbors
user@host> show pim neighbors
Instance: PIM.master 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 = Hello Option Join Attribute Instance: PIM.master Interface IP V Mode Option Uptime Neighbor addr ae0.0 4 2 HPLGTA 19:01:24 20.0.0.13 ae1.0 4 2 HPLGTA 19:01:24 20.0.0.149
show pim neighbors instance
user@host> show pim neighbors instance VPN-A
Instance: PIM.VPN-A B = Bidirectional Capable, G = Generation Identifier, H = Hello Option Holdtime, L = Hello Option LAN Prune Delay, P = Hello Option DR Priority, T = Tracking bit Interface IP V Mode Option Uptime Neighbor addr at-0/3/1.0 4 2 HPLG 00:07:54 10.111.30.2 mt-1/1/0.32768 4 2 HPLG 00:07:22 10.10.47.101 so-1/0/1.0 4 2 HPLG 00:07:50 10.111.20.2
show pim neighbors detail
user@host> show pim neighbors detail
Instance: PIM.master Interface: ae1.0 Address: 20.0.0.149, IPv4, PIM v2, sg Join Count: 0, tsg Join Count: 332 BFD: Disabled Hello Option Holdtime: 105 seconds 86 remaining Hello Option DR Priority: 1 Hello Option Generation ID: 853386212 Hello Option LAN Prune Delay: delay 500 ms override 2000 ms Join Suppression supported Hello Option Join Attribute supported Address: 20.0.0.150, IPv4, PIM v2, Mode: SparseDense, sg Join Count: 0, tsg Join Count: 0 Hello Option Holdtime: 65535 seconds Hello Option DR Priority: 1 Hello Option Generation ID: 358917871 Hello Option LAN Prune Delay: delay 500 ms override 2000 ms Join Suppression supported Hello Option Join Attribute supported Interface: lo0.0 Address: 10.255.179.246, IPv4, PIM v2, Mode: SparseDense, sg Join Count: 0, tsg Join Count: 0 Hello Option Holdtime: 65535 seconds Hello Option DR Priority: 1 Hello Option Generation ID: 1997462267 Hello Option Bi-Directional PIM supported Hello Option LAN Prune Delay: delay 500 ms override 2000 ms Join Suppression supported
show pim neighbors detail (With BFD)
user@host> show pim neighbors detail
Instance: PIM.master Interface: fe-1/0/0.0 Address: 192.168.11.1, IPv4, PIM v2, Mode: Sparse Hello Option Holdtime: 65535 seconds Hello Option DR Priority: 1 Hello Option Generation ID: 836607909 Hello Option LAN Prune Delay: delay 500 ms override 2000 ms Address: 192.168.11.2, IPv4, PIM v2 BFD: Enabled, Operational state is up Hello Default Holdtime: 105 seconds 104 remaining Hello Option DR Priority: 1 Hello Option Generation ID: 1907549685 Hello Option LAN Prune Delay: delay 500 ms override 2000 ms Interface: fe-1/0/1.0 Address: 192.168.12.1, IPv4, PIM v2 BFD: Disabled Hello Default Holdtime: 105 seconds 80 remaining Hello Option DR Priority: 1 Hello Option Generation ID: 1971554705 Hello Option LAN Prune Delay: delay 500 ms override 2000 ms