show pim statistics
Syntax
Syntax (EX Series Switch)
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.
Description
Display Protocol Independent Multicast (PIM) statistics.
Options
- none
Display PIM statistics.
- inet | inet6
(Optional) Display IPv4 or IPv6 PIM statistics.
- instance instance-name
(Optional) Display statistics for a specific routing instance enabled by Protocol Independent Multicast (PIM).
- interface interface-name
(Optional) Display statistics about the specified interface.
- logical-system (all | logical-system-name)
(Optional) Perform this operation on all logical systems or on a particular logical system.
Required Privilege Level
view
Related Topics
List of Sample Output
show pim statisticsOutput Fields
Table 1 describes the output fields for the show pim statistics command. Output fields are listed in the approximate order in which they appear.
Table 1: show pim statistics Output Fields
Field Name | Field Description |
|---|---|
PIM statistics | PIM statistics for all interfaces or for the specified interface. |
PIM message type | Message type for which statistics are displayed. |
Received | Number of received statistics. |
Sent | Number of messages sent of a certain type. |
Rx errors | Number of received packets that contained errors. |
V2 Hello | PIM version 2 hello packets. |
V2 Register | PIM version 2 register packets. |
V2 Register Stop | PIM version 2 register stop packets. |
V2 Join Prune | PIM version 2 join and prune packets. |
V2 Bootstrap | PIM version 2 bootstrap packets. |
V2 Assert | PIM version 2 assert packets. |
V2 Graft | PIM version 2 graft packets. |
V2 Graft Ack | PIM version 2 graft acknowledgement packets. |
V2 Candidate RP | PIM version 2 candidate RP packets. |
V1 Query | PIM version 1 query packets. |
V1 Register | PIM version 1 register packets. |
V1 Register Stop | PIM version 1 register stop packets. |
V1 Join Prune | PIM version 1 join and prune packets. |
V1 RP Reachability | PIM version 1 RP reachability packets. |
V1 Assert | PIM version 1 assert packets. |
V1 Graft | PIM version 1 graft packets. |
V1 Graft Ack | PIM version 1 graft acknowledgement packets. |
AutoRP Announce | Auto-RP announce packets. |
AutoRP Mapping | Auto-RP mapping packets. |
AutoRP Unknown type | Auto-RP packets with an unknown type. |
Anycast Register | Auto-RP announce packets. |
Anycast Register Stop | Auto-RP announce packets. |
Global Statistics | Summary of PIM statistics for all interfaces. |
Hello dropped on neighbor policy | Number of hello packets dropped because of a configured neighbor policy. |
Unknown type | Number of PIM control packets received with an unknown type. |
V1 Unknown type | Number of PIM version 1 control packets received with an unknown type. |
Unknown Version | Number of PIM control packets received with an unknown version. The version is not version 1 or version 2. |
Neighbor unknown | Number of PIM control packets received (excluding PIM hello) without first receiving the hello packet. |
Bad Length | Number of PIM control packets received for which the packet size does not match the PIM length field in the packet. |
Bad Checksum | Number of PIM control packets received for which the calculated checksum does not match the checksum field in the packet. |
Bad Receive If | Number of PIM control packets received on an interface that does not have PIM configured. |
Rx Bad Data | Number of PIM control packets received that contain data for TCP. Bad register packets. |
Rx Intf disabled | Number of PIM control packets received on an interface that has PIM disabled. |
Rx V1 Require V2 | Number of PIM version 1 control packets received on an interface configured for PIM version 2. |
Rx V2 Require V1 | Number of PIM version 2 control packets received on an interface configured for PIM version 1. |
Rx Register not RP | Number of PIM register packets received when the router is not the RP for the group. |
Rx Register no route | Number of PIM register packets received when the RP does not have a unicast route back to source. |
Rx Register no decap if | Number of PIM register packets received when the RP does not have a de-encapsulation interface. |
Null Register Timeout | Number of NULL register timeout packets. |
RP Filtered Source | Number of PIM packets received when the router has a source address filter configured for the RP. |
Rx Unknown Reg Stop | Number of register stop messages with an unknown type. |
Rx Join/Prune no state | Number of join and prune messages received for which the router has no state. |
Rx Join/Prune on upstream if | Number of join and prune messages received on the interface used to reach the upstream router, toward the RP. |
Rx Join/Prune messages dropped | Number of join and prune messages received and dropped. |
Rx sparse join for dense group | Number of PIM sparse mode join messages received for a group that is configured for dense mode. |
Rx Graft/Graft Ack no state | Number of graft and graft acknowledgement messages received for which the router has no state. |
Rx Graft on upstream if | Number of graft messages received on the interface used to reach the upstream router, toward the RP. |
Rx CRP not BSR | Number of BSR messages received in which the PIM message type is Candidate-RP-Advertisement, not Bootstrap. |
Rx BSR when BSR | Number of BSR messages received in which the PIM message type is Bootstrap. |
Rx BSR not RPF if | Number of BSR messages received on an interface that is not the RPF interface. |
Rx unknown hello opt | Number of PIM hello packets received with options that Junos does not support. |
Rx data no state | Number of PIM control packets received for which the router has no state for the data type. |
Rx RP no state | Number of PIM control packets received for which the router has no state for the RP. |
Rx aggregate | Number of PIM aggregate MDT packets received. |
Rx malformed packet | Number of PIM control packets received with a malformed IP unicast or multicast address family. |
No RP | Number of PIM control packets received with no RP address. |
No register encap if | Number of PIM register packets received when the first-hop router does not have an encapsulation interface. |
No route upstream | Number of PIM control packets received when the router does not have a unicast route to the the interface used to reach the upstream router, toward the RP. |
Nexthop Unusable | Number of PIM control packets with an unusable nexthop. A path can be unusable if the route is hidden or the link is down. |
RP mismatch | Number of PIM control packets received for which the router has an RP mismatch. |
RPF neighbor unknown | Number of PIM control packets received for which the router has an unknown RPF neighbor for the source. |
Rx Joins/Prunes filtered | The number of join and prune messages filtered because of configured route filters and source address filters. |
Tx Joins/Prunes filtered | The number of join and prune messages filtered because of configured route filters and source address filters. |
Embedded-RP invalid addr | Number of packets received with an invalid embedded RP address in PIM join messages and other types of messages sent between routing domains. |
Embedded-RP limit exceed | Number of times the limit configure with the maximum-rps statement is exceeded. The maximum-rps statement limits the number of embedded RPs created in a specific routing instance. The range is from 1 through 500. The default is 100. |
Embedded-RP added | Number of packets in which the embedded RP for IPv6 is added. The following receive events trigger extraction of an IPv6 embedded RP address on the router:
An embedded RP node discovered through these receive events is added if it does not already exist on the routing platform. |
Embedded-RP removed | Number of packets in which the embedded RP for IPv6 is removed. The embedded RP is removed whenever all PIM join states using this RP are removed or the configuration changes to remove the embedded RP feature. |
Rx Register msgs filtering drop | Number of register messages dropped because of a filter configured for PIM register messages. |
Tx Register msgs filtering drop | Number of register messages dropped because of a filter configured for PIM register messages. |
Sample Output
show pim statistics
user@host> show pim statistics PIM Message type Received Sent Rx errors V2 Hello 15 32 0 V2 Register 0 362 0 V2 Register Stop 483 0 0 V2 Join Prune 18 518 0 V2 Bootstrap 0 0 0 V2 Assert 0 0 0 V2 Graft 0 0 0 V2 Graft Ack 0 0 0 V2 Candidate RP 0 0 0 V1 Query 0 0 0 V1 Register 0 0 0 V1 Register Stop 0 0 0 V1 Join Prune 0 0 0 V1 RP Reachability 0 0 0 V1 Assert 0 0 0 V1 Graft 0 0 0 V1 Graft Ack 0 0 0 AutoRP Announce 0 0 0 AutoRP Mapping 0 0 0 AutoRP Unknown type 0 Anycast Register 0 0 0 Anycast Register Stop 0 0 0 Global Statistics Hello dropped on neighbor policy 0 Unknown type 0 V1 Unknown type 0 Unknown Version 0 Neighbor unknown 5 Bad Length 0 Bad Checksum 0 Bad Receive If 0 Rx Bad Data 0 Rx Intf disabled 0 Rx V1 Require V2 0 Rx V2 Require V1 0 Rx Register not RP 0 Rx Register no route 0 Rx Register no decap if 0 Null Register Timeout 0 RP Filtered Source 0 Rx Unknown Reg Stop 0 Rx Join/Prune no state 0 Rx Join/Prune on upstream if 0 Rx Join/Prune messages dropped 0 Rx sparse join for dense group 0 Rx Graft/Graft Ack no state 0 Rx Graft on upstream if 0 Rx CRP not BSR 0 Rx BSR when BSR 0 Rx BSR not RPF if 0 Rx unknown hello opt 0 Rx data no state 0 Rx RP no state 0 Rx aggregate 0 Rx malformed packet 0 No RP 0 No register encap if 0 No route upstream 0 Nexthop Unusable 0 RP mismatch 0 RPF neighbor unknown 0 Rx Joins/Prunes filtered 0 Embedded-RP invalid addr 0 Embedded-RP limit exceed 0 Embedded-RP added 0 Embedded-RP removed 0 Rx Register msgs filtering drop 0 Tx Register msgs filtering drop 0
