Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show pim rps

 

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.

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.

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

Description

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

Options

noneDisplay 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 instance-name(Optional) Display information about RPs for 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

List of Sample Output

show pim rps

show pim rps brief

show pim rps <group-address>

show pim rps <group-address>

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

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

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

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

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

show pim rps instance

show pim rps extensive (PIM Sparse Mode)

show pim rps extensive (Bidirectional PIM)

show pim rps extensive (PIM Anycast RP in Use)

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

user@host> show pim rps

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>

user@host> show pim rps 233.252.0.0

show pim rps <group-address>

user@host> show pim rps 233.252.0.0

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

user@host> show pim rps 233.252.0.1

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

user@host> show pim rps 233.252.0.1

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

user@host> show pim rps 233.252.0.1

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

user@host> show pim rps 233.252.0.1

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

user@host> show pim rps 233.252.0.1

show pim rps instance

user@host> show pim rps instance VPN-A

show pim rps extensive (PIM Sparse Mode)

user@host> show pim rps extensive

show pim rps extensive (Bidirectional PIM)

user@host> show pim rps extensive

show pim rps extensive (PIM Anycast RP in Use)

user@host> show pim rps extensive