Show, Clear, and Debug Command Reference

Anycast Address

Displays the candidate anycast address.

Anycast RP Peer

Displays the candidate anycast RP peer address.

RP Address

Displays the Candidate RP address.

Group Address

Displays the range of multicast group addresses for which the CRP is the Candidate RP.

Priority

Displays the Candidate RP's priority for becoming a rendezvous point (RP). This value is used to elect RP for a group range. A value of 0 is considered as the highest priority.

Holdtime

Displays the hold time of the candidate RP. It is used by the Bootstrap router to time out the RP entries if it does not listen to another CRP advertisement within the holdtime period.

Expiry

The minimum time remaining before the CRP will be declared down. If the local router is not the BSR, this value is 0.

Candidate RPs

Displays the number of CRP entries.

MD Grp Address

Displays the IP multicast group address for which this entry contains information.

MD Src Address

Displays the source address of the multicast sender.

It will be 0 if the type is configured as starg. It will be the address of the Rendezvous Point (RP) if the type is configured as starRP.

MT Index

Displays the index number.

Num VP SGs

Displays the VPN number.

Group Address

Displays the IP multicast group address for which this entry contains information.

Source Address

Displays the source address of the multicast sender.

It will be 0 if the type is configured as starg.

It will be the address of the Rendezvous Point (RP) if the type is configured as starRP.

RP Address

Displays the RP address.

Type

Specifies the type of entry, (*,*, rp)/(*,G) or (S,G).

Spt Bit

Specifies whether to forward on (*,*, rp)/(*,G) or on (S,G) state. It is updated when the (S,G) data comes on the RPF interface towards the source.

Incoming Intf

Displays the interface on which the traffic comes in. It can be the RPF interface to the RP (if starg) or the source (if sg).

Num Oifs

Displays the number of interfaces in the inherited outgoing interface list. An inherited list inherits the state from other types.

Flags

Displays the different lists that this interface belongs to.

Keepalive Timer Exp

The keepalive timer is applicable only for (S,G) entries.

The (S,G) keepalive timer is updated by data being forwarded using this (S,G) Forwarding state. It is used to keep (S,G) state alive in the absence of explicit (S,G) joins.

MRIB Next Hop

Displays the next hop address towards the RP.

MRIB Src Flags

Displays the MRIB information about the source. If the entry is of type starg or starstarrp, it will contain information about the RP for the group.

Up Time

Displays the time since this source group entry was created.

Resolved By

Displays the route table used for RPF check.

Up JP State

Displays the upstream join prune state for this entry on the interface. PIM join prune messages are sent by the downstream routers towards the RPF neighbor.

Up JP Expiry

Displays the minimum amount of time remaining before this entry will be aged out.

Up JP Rpt

Displays the join prune Rpt state for this entry on the interface. PIM join/prune messages are sent by the downstream routers towards the RPF neighbor. (S,G, rpt) state is a result of receiving (S,G, rpt) JP message from the downstream router on the RP tree.

Up JP Rpt Override

Displays the value used to delay triggered Join (S,G, rpt) messages to prevent implosions of triggered messages.

If this has a non-zero value, it means that the router was in 'notPruned' state and it saw a prune (S,G, rpt) message being sent to RPF (S,G, rpt). If the router sees a join (S,G, rpt) override message being sent by some other router on the LAN while the timer is still non-zero, it simply cancels the override timer. If it does not see a join (S,G, rpt) message, then on expiry of the override timer, it sends it's own join (S,G, rpt) message to RPF (S,G, rpt). A similar scenario exists when RPF (S,G, rpt) changes to become equal to RPF (*,G).

Register State

Specifies the register state. The register state is kept at the source DR. When the host starts sending multicast packets and if there are no entries programmed for that group, the source DR sends a register packet to the RP (g). Register state transition happen based on the register stop timer and the response received from the RP.

Register Stop Exp

Displays the time remaining before the register state might transition to a different state.

Register from Anycast RP

Displays if the register packet for that group has been received from one of the RP from the anycast-RP set.

RPF Neighbor

Displays the address of the RPF neighbor.

Outgoing Intf List

Displays a list of interfaces on which data is forwarded.

Curr Fwding Rate

Displays the current forwarding rate of the multicast data for this group and source. This forwarding rate is calculated before ingress QoS policing or shaping is applied.

Forwarded Packets

Displays the number of multicast packets that were forwarded to the interfaces in the outgoing interface list. This packet count is before ingress QoS policing or shaping is applied.

Discarded Packets

Displays the number of multicast packets that matched this source group entry but were discarded.

For (S,G) entries, if the traffic is getting forwarded on the SPT, the packets arriving from the RPT will be discarded.

Forwarded Octets

Displays the number of octets forwarded.

RPF Mismatches

Displays the number of multicast packets that matched this source group entry but they did not arrive on the interface.

Spt threshold

Displays the value of the SPT threshold configured for that group. 0 Kbps means that the switch to the SP tree will happen immediately.

Admin State

Displays the administrative state for PIM protocol on this interface.

Oper State

Displays the current operational state of PIM protocol on this interface.

DR

Displays the designated router on this PIM interface.

DR Priority

Displays the priority value sent in PIM Hello messages and that is used by routers to elect the designated router (DR).

Hello Intvl

Indicates the frequency at which PIM Hello messages are transmitted on this interface.

Interface

Displays the neighbor’s interface name. (W) indicates wildcard tunnels.

Nbr DR Priority

Displays the value of the neighbor's DR priority which is received in the hello message.

Nbr Address

Displays the neighbor’s address.

Up Time

Displays the time since this PIM neighbor (last) became a neighbor

of the local router.

Expiry Time

Displays the minimum time remaining before this PIM neighbor will be aged out.

0—Means that this neighbor will never be aged out. This happens when the PIM neighbor sends a Hello message with holdtime set to `0xffff'.

Hold Time

Displays the value of the hold time present in the hello message.

DR Priority

Displays the value of the neighbor's DR priority which is received in the hello message.

Tracking Support

Displays whether the T bit in the LAN prune delay option was present in the hello message. This indicates the neighbor's capability to disable join message suppression.

LAN Delay

Displays the value of the LAN delay field present in the hello message received from the neighbor.

Gen Id

Displays a randomly generated 32-bit value that is regenerated each time PIM forwarding is started or restarted on the interface, including when the router itself restarts. When a hello message with a new GenID is received from a neighbor, any old hello information about that neighbor is discarded and superseded by the information from the new hello message.

Override Intvl (ms)

Displays the value of the override interval present in the Hello message.

Group Address

Displays the multicast group address of the entry.

RP Address

Displays the address of the Rendezvous Point (RP).

Type

Specifies whether the entry was learned through the Bootstrap mechanism or if it was statically configured.

Priority

Displays the priority for the specified group address. The higher the value, the higher the priority.

Holdtime

Displays the value of the hold time present in the BSM message.

Group Address

Displays the multicast group address of the entry.

RP Address

Displays the address of the Rendezvous Point (RP).

Type

Specifies whether the entry was learned through the Bootstrap mechanism or if it was statically configured.

PIM Statistics

The section listing the PIM statistics for a particular interface.

Message Type

Displays the type of message.

Hello

Displays the number of PIM hello messages received or transmitted on this interface.

Join Prune

Displays the number of PIM join prune messages received or transmitted on this interface.

Asserts

Displays the number of PIM assert messages received or transmitted on this interface.

Register

Displays the number of register messages received or transmitted on this interface.

Null Register

Displays the number of PIM null register messages received or transmitted on this interface.

Register Stop

Displays the number of PIM register stop messages received or transmitted on this interface.

BSM

Displays the number of PIM Bootstrap messages (BSM) received or transmitted on this interface.

Candidate RP Adv

Displays the number of candidate RP advertisements.

Total Packets

Displays the total number of packets transmitted and received on this interface.

Received

Displays the number of messages received on this interface.

Transmitted

Displays the number of multicast data packets transmitted on this interface.

Rx Errors

Displays the total number of receive errors.

General Interface Statistics

The section listing the general PIM interface statistics.

Register TTL Drop

Displays the number of multicast data packets which could not be encapsulated in Register messages because the time to live (TTL) was zero.

Tx Register MTU Drop

Displays the number of Bootstrap messages received on this interface but were dropped.

Rx Invalid Register

Displays the number of invalid PIM register messages received on this interface.

Rx Neighbor Unknown

Displays the number of PIM messages (other than hello messages) which were received on this interface and were rejected because the adjacency with the neighbor router was not already established.

Rx Bad Checksum Discard

Displays the number of PIM messages received on this interface which were discarded because of bad checksum.

Rx Bad Encoding

Displays the number of PIM messages with bad encodings received on this interface.

Rx Bad Version Discard

Displays the number of PIM messages with bad versions received on this interface.

Rx CRP No Router Alert

Displays the number of candidate-rp advertisements (C-RP-Adv) received on this interface which had no router alert option set.

Rx Invalid Join Prune

Displays the number of invalid PIM join prune messages received on this interface.

Rx Unknown PDU Type

Displays the number of packets received with an unsupported PIM type.

Join Policy Drops

Displays the number of times the join policy match resulted in dropping PIM join-prune message or one of the source group contained in the message.

Register Policy Drops

Displays the number of times the register policy match resulted in dropping PIM register message.

Bootstrap Import Policy Drops

Displays the number of Bootstrap messages received on this interface but were dropped because of Bootstrap import policy.

Bootstrap Export Policy Drops

Displays the number of Bootstrap messages that were not transmitted on this interface because of Bootstrap export policy.

Source Group Statistics

The section listing the source group statistics.

(S,G)

Displays the number of entries in which the type is (S,G).

(*,G)

Displays the number of entries in which the type is (*,G).

(*,*,RP)

Displays the number of entries in which the type is (*, *, rp).

Admin State

Displays the administrative status of PIM.

Oper State

Displays the current operating state of this PIM protocol instance.

BSR State

Displays the state of the router with respect to the Bootstrap mechanism.

Address

Displays the address of the elected Bootstrap router.

Expiry Time

Displays the time remaining before the router sends the next Bootstrap message.

Priority

Displays the priority of the elected Bootstrap router. The higher the value, the higher the priority.

Hash Mask Length

Displays the hash mask length of the Bootstrap router.

Up Time

Displays the time since the current E-BSR became the Bootstrap router.

RPF Intf towards

Displays the RPF interface towards the elected BSR. The value is zero if there is no elected BSR in the network.

Address

Displays the address of the candidate BSR router.

Expiry Time

Displays the time remaining before the router sends the next Bootstrap message.

Priority

Displays the priority of the Bootstrap router. The higher the value, the higher the priority.

Hash Mask Length

Displays the hash mask length of the candidate Bootstrap router.

Up Time

Displays the time since becoming the Bootstrap router.

Admin State

Displays the administrative status of CRP.

Oper State

Displays the current operating state of the C-RP mechanism.

Address

Displays the local RP address.

Priority

Displays the CRP's priority for becoming a rendezvous point (RP). A 0 value is the highest priority.

Holdtime

Displays the hold time of the candidate RP. It is used by the Bootstrap router to timeout the RP entries if it does not listen to another CRP advertisement within the holdtime period.

Policy

Displays the PIM policies for a particular PIM instance.

Default Group

Displays the default core group address.

RPF Table

Displays the route table used for RPF check.

MC-ECMP-Hashing

Displays if hash-based multicast balancing of traffic over ECMP links is enabled or disabled.