Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show pim rps

date_range 27-Sep-24

Syntax

content_copy zoom_out_map
show pim rps
<brief | detail | extensive>
<group-address>
<inet | inet6>
<instance (all | instance-name)>
<logical-system (all | logical-system-name)>

Syntax (EX Series Switch and the QFX Series)

content_copy zoom_out_map
show pim rps
<brief | detail | extensive>
<group-address>
<inet | inet6>
<instance (all | instance-name)>

Description

Display information about Protocol Independent Multicast (PIM) rendezvous points (RPs).

Options

none

Display standard information about PIM RPs for all groups and family addresses for all routing instances.

brief | detail | extensive

(Optional) Display the specified level of output.

group-address

(Optional) Display the RPs for a particular group. If you specify a group address, the output lists the routing device that is the RP for that group.

inet | inet6

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

instance (all | instance-name)

(Optional) Display information about RPs for all PIM-enabled routing instances or a specific PIM-enabled routing instance.

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 rps command. Output fields are listed in the approximate order in which they appear.

Table 1: show pim rps Output Fields

Field Name

Field Description

Level of Output

Instance

Name of the routing instance.

All levels

Family or Address family

Name of the address family: inet (IPv4) or inet6 (IPv6).

All levels

RP address

Address of the rendezvous point.

All levels

Type

Type of RP:

  • auto-rp—Address of the RP known through the Auto-RP protocol.

  • bootstrap—Address of the RP known through the bootstrap router protocol (BSR).

  • embedded—Address of the RP known through an embedded RP (IPv6).

  • static—Address of RP known through static configuration.

brief none

Holdtime

How long to keep the RP active, with time remaining, in seconds.

All levels

Timeout

How long until the local routing device determines the RP to be unreachable, in seconds.

All levels

Groups

Number of groups currently using this RP.

All levels

Group prefixes

Addresses of groups that this RP can span.

brief none

Learned via

Address and method by which the RP was learned.

detail extensive

Mode

The PIM mode of the RP: bidirectional or sparse.

If a sparse and bidirectional RPs are configured with the same RP address, they appear as separate entries in both formats.

All levels

Time Active

How long the RP has been active, in the format hh:mm:ss.

detail extensive

Device Index

Index value of the order in which Junos OS finds and initializes the interface.

For bidirectional RPs, the Device Index output field is omitted because bidirectional RPs do not require encapsulation and de-encapsulation interfaces.

detail extensive

Subunit

Logical unit number of the interface.

For bidirectional RPs, the Subunit output field is omitted because bidirectional RPs do not require encapsulation and de-encapsulation interfaces.

detail extensive

Interface

Either the encapsulation or the de-encapsulation logical interface, depending on whether this routing device is a designated router (DR) facing an RP router, or is the local RP, respectively.

For bidirectional RPs, the Interface output field is omitted because bidirectional RPs do not require encapsulation and de-encapsulation interfaces.

detail extensive

Group Ranges

Addresses of groups that this RP spans.

detail extensive

group-address

Active groups using RP

Number of groups currently using this RP.

detail extensive

total

Total number of active groups for this RP.

detail extensive

Register State for RP

Current register state for each group:

  • Group—Multicast group address.

  • Source—Multicast source address for which the PIM register is sent or received, depending on whether this router is a designated router facing an RP router, or is the local RP, respectively:

  • First Hop—PIM-designated routing device that sent the Register message (the source address in the IP header).

  • RP Address—RP to which the Register message was sent (the destination address in the IP header).

  • State:

    On the designated router:

    • Send—Sending Register messages.

    • Probe—Sent a null register. If a Register-Stop message does not arrive in 5 seconds, the designated router resumes sending Register messages.

    • Suppress—Received a Register-Stop message. The designated router is waiting for the timer to resume before changing to Probe state.

  • On the RP:

    • Receive—Receiving Register messages.

extensive

Anycast-PIM rpset

If anycast RP is configured, the addresses of the RPs in the set.

extensive

Anycast-PIM local address used

If anycast RP is configured, the local address used by the RP.

extensive

Anycast-PIM Register State

If anycast RP is configured, the current register state for each group:

  • Group—Multicast group address.

  • Source—Multicast source address for which the PIM register is sent or received, depending on whether this routing device is a designated router facing an RP router, or is the local RP, respectively.

  • Origin—How the information was obtained:

    • DIRECT—From a local attachment

    • MSDP—From the Multicast Source Discovery Protocol (MSDP)

    • DR—From the designated router

extensive

RP selected

For sparse mode and bidirectional mode, the identity of the RP for the specified group address.

group-address

Sample Output

show pim rps

content_copy zoom_out_map
user@host> show pim rps    
Instance: PIM.master

Address-family INET
RP address      Type        Mode   Holdtime Timeout Groups Group prefixes
10.100.100.100 auto-rp     sparse      150     146      0 233.252.0.0/8
                                                          233.252.0.1/24
10.200.200.200 auto-rp     sparse      150     146      0 233.252.0.2/4

address-family INET6

show pim rps brief

The output for the show pim rps brief command is identical to that for the show pim rps command. For sample output, see show pim rps.

show pim rps <group-address>

content_copy zoom_out_map
user@host> show pim rps 233.252.0.0    
Instance: PIM.master
Instance: PIM.master

RP selected: 10.100.100.100

show pim rps <group-address>

content_copy zoom_out_map
user@host> show pim rps 233.252.0.0    
Instance: PIM.master
Instance: PIM.master

RP selected: 10.100.100.100

show pim rps <group-address> (Bidirectional PIM)

content_copy zoom_out_map
user@host> show pim rps 233.252.0.1    
Instance: PIM.master

233.252.0.0/16
        10.4.12.75 (Bidirectional)

RP selected: 10.4.12.75

show pim rps <group-address> (PIM Dense Mode)

content_copy zoom_out_map
user@host> show pim rps 233.252.0.1    
Instance: PIM.master

Dense Mode active for group 233.252.0.1

show pim rps <group-address> (SSM Range Without asm-override-ssm Configured)

content_copy zoom_out_map
user@host> show pim rps 233.252.0.1    
Instance: PIM.master

Source-specific Mode (SSM) active for group 233.252.0.1

show pim rps <group-address> (SSM Range With asm-override-ssm Configured and a Sparse-Mode RP)

content_copy zoom_out_map
user@host> show pim rps 233.252.0.1    
Instance: PIM.master

Source-specific Mode (SSM) active with Sparse Mode ASM override for group 233.252.0.1

233.252.0.0/16
        10.4.12.75

RP selected: 10.4.12.75

show pim rps <group-address> (SSM Range With asm-override-ssm Configured and a Bidirectional RP)

content_copy zoom_out_map
user@host> show pim rps 233.252.0.1    
Instance: PIM.master

Source-specific Mode (SSM) active with Sparse Mode ASM override for group 233.252.0.1

233.252.0.0/16
        10.4.12.75 (Bidirectional)

RP selected: (null)

show pim rps instance

content_copy zoom_out_map
user@host> show pim rps instance VPN-A     
Instance: PIM.VPN-A
Address family INET
RP address               Type        Holdtime Timeout Groups Group prefixes
10.10.47.100             static             0    None      1 233.252.0.0/4

Address family INET6

show pim rps extensive (PIM Sparse Mode)

content_copy zoom_out_map
user@host> show pim rps extensive     
Instance: PIM.master

Family: INET
RP: 10.255.245.91
Learned via: static configuration
Time Active: 00:05:48
Holdtime: 45 with 36 remaining
Device Index: 122
Subunit: 32768
Interface: pd-6/0/0.32768
Group Ranges:
    233.252.0.0/4, 36s remaining
Active groups using RP:
    233.252.0.1

    total 1 groups active

Register State for RP:
Group           Source          FirstHop        RP Address      State    Timeout
233.252.0.1       192.168.195.78  10.255.14.132   10.255.245.91   Receive        0

show pim rps extensive (Bidirectional PIM)

content_copy zoom_out_map
user@host> show pim rps extensive     
Instance: PIM.master
Address family INET

RP: 10.10.1.3
Learned via: static configuration
Mode: Bidirectional
Time Active: 01:58:07
Holdtime: 150
Group Ranges:
        233.252.0.0/24
        233.252.0.01/24

RP: 10.10.13.2
Learned via: static configuration
Mode: Bidirectional
Time Active: 01:58:07
Holdtime: 150
Group Ranges:
       233.252.0.3/24
       233.252.0.4/24

show pim rps extensive (PIM Anycast RP in Use)

content_copy zoom_out_map
user@host> show pim rps extensive     
Instance: PIM.master

Family: INET
RP: 10.10.10.2
Learned via: static configuration
Time Active: 00:54:52
Holdtime: 0
Device Index: 130
Subunit: 32769
Interface: pimd.32769
Group Ranges:
    233.252.0.0/4
Active groups using RP:
    233.252.0.10

    total 1 groups active

Anycast-PIM rpset:
           10.100.111.34
           10.100.111.17
           10.100.111.55

Anycast-PIM local address used: 10.100.111.1
Anycast-PIM Register State:
Group                      Source                               Origin
233.252.0.1                10.10.95.2                           DIRECT
233.252.0.2                10.10.95.2                           DIRECT
233.252.0.3                10.10.70.1                           MSDP
233.252.0.4                10.10.70.1                           MSDP
233.252.0.5                10.10.71.1                           DR

Address family INET6

Anycast-PIM rpset:
           ab::1
           ab::2
Anycast-PIM local address used: cd::1

Anycast-PIM Register State:
Group                    Source                               Origin
::224.1.1.1              ::10.10.95.2                         DIRECT
::224.1.1.2              ::10.10.95.2                         DIRECT
::224.20.20.1            ::10.10.71.1                         DR

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.

footer-navigation