show pim rps
Syntax
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)
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.
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:
|
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:
|
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:
|
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
- 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)
show pim rps
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>
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>
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)
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)
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)
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)
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)
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
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)
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)
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)
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.