close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

show pim neighbors

date_range 19-Nov-23

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
show pim neighbors
<brief | detail>
<inet | inet6>
<instance (instance-name | all)>
<logical-system (all | logical-system-name)>

Syntax (EX Series Switch and the QFX Series)

content_copy zoom_out_map
show pim neighbors
<brief | detail>
<inet | inet6>
<instance (instance-name | all)>

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

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`

show pim neighbors

content_copy zoom_out_map
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

content_copy zoom_out_map
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

content_copy zoom_out_map
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)

content_copy zoom_out_map
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 

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.

Release

Description

17.3R1

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

arrow_backward PREVIOUS show pim mvpn

NEXT arrow_forward show pim rps

Junos CLI Reference

ON THIS PAGE

show pim neighbors

Syntax

Syntax (EX Series Switch and the QFX Series)

Description

Options

Required Privilege Level

Output Fields

Sample Output

show pim neighbors

show pim neighbors instance

show pim neighbors detail

show pim neighbors detail (With BFD)

Release Information

Change History Table

Stay in touch

Helped me install or use the product
Accelerated my deployment

Discuss the product with a co-worker
Make a purchase inquiry