show pim neighbors
Syntax
Syntax (EX Series Switch and the QFX Series)
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced in Junos OS Release 9.0 for EX Series switches.
inet6 and instance options introduced in Junos OS Release 10.0 for EX Series switches.
Command introduced in Junos OS Release 11.3 for the QFX Series.
Support for bidirectional PIM added in Junos OS Release 12.1.
Support for the instance all option added in Junos OS Release 12.1.
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 neighborsshow pim neighbors brief
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:
| brief none |
Uptime | Time the neighbor has been operational since the PIM process was last initialized, in the format 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 router. | 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 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 Interface IP V Mode Option Uptime Neighbor addr so-1/0/0.0 4 2 HPLG 00:07:10 10.111.10.2
show pim neighbors brief
The output for the show pim neighbors brief command is identical to that for the show pim neighbors command. For sample output, see show pim neighbors.
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 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: ge-0/0/1.0
Address: 10.10.1.1, IPv4, PIM v2, Mode: SparseDense, sg Join Count: 0, tsg Join Count: 2
Hello Option Holdtime: 65535 seconds
Hello Option DR Priority: 1
Hello Option Generation ID: 2053759302
Hello Option Bi-Directional PIM supported
Hello Option LAN Prune Delay: delay 500 ms override 2000 ms
Join Suppression supported
Address: 10.10.1.2, IPv4, PIM v2, sg Join Count: 0, tsg Join Count: 2
BFD: Disabled
Hello Option Holdtime: 105 seconds 93 remaining
Hello Option DR Priority: 1
Hello Option Generation ID: 1734018161
Hello Option Bi-Directional PIM supported
Hello Option LAN Prune Delay: delay 500 ms override 2000 ms
Join Suppression 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
