anycast [detail] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays PIM anycast RP-set information.
Displays detailed information.
Displays IPv4 information.
The following output displays an example of a PIM anycast information, and Table: Output fields: PIM anycast describes the output fields.
Sample outputA:7210SAS# show router pim anycast
===================================================
PIM Anycast RP Entries
===================================================
Anycast RP Anycast RP Peer
---------------------------------------------------
100.100.100.1 10.102.1.1
10.103.1.1
10.104.1.1
---------------------------------------------------
PIM Anycast RP Entries : 3
===================================================
Label |
Description |
|---|---|
Anycast Address |
Displays the candidate anycast address |
Anycast RP Peer |
Displays the candidate anycast RP peer address |
crp [family|ip-address]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays PIM candidate RP (CRP) information received at the elected bootstrap router (BSR).
Specifies the candidate RP IP address.
Displays IPv4 information.
The following output is an example of a PIM CRP configuration, and Table: Output fields: PIM CRP describes the output fields.
Sample outputA:7210SAS# show router pim crp
============================================================================
PIM Candidate RPs
============================================================================
RP Address Group Address Priority Holdtime Expiry Time
----------------------------------------------------------------------------
239.22.187.236 239.0.0.0/4 192 150 0d 00:02:19
239.22.187.239 239.0.0.0/4 192 150 0d 00:02:19
239.22.187.240 239.0.0.0/4 192 150 0d 00:02:09
----------------------------------------------------------------------------
Candidate RPs : 3
============================================================================
A:7210SAS#
Label |
Description |
|---|---|
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 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 hold time period. |
Expiry |
Displays 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 |
group [group-ip-address] [source ip-address] [type {starstarrp|starg|sg}] [detail] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays PIM source group database information.
Specifies the IP multicast group address for which this entry contains information.
Specifies the source address for which this entry contains information.
Specifies that only (*, *, rp) entries be displayed.
Specifies that only (*,G) entries be displayed.
Specifies that only (S,G) entries be displayed.
Displays detailed group information.
Displays IPv4 information.
The following output is an example of PIM group information, and Table: Output fields: PIM group describes the output fields.
Sample output*A:Dut-C# show router pim group
===============================================================================
Legend: A = Active S = Standby
===============================================================================
PIM Groups ipv4
===============================================================================
Group Address Type Spt Bit Inc Intf No.Oifs
Source Address RP State Inc Intf(S)
-------------------------------------------------------------------------------
239.225.1.1 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.2 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.3 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.4 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.5 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.6 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
239.225.1.7 (S,G) spt C_A 4
10.1.1.2 10.4.4.4
-------------------------------------------------------------------------------
Groups : 7
===============================================================================
*A:Dut-C# show router pim group detail
===============================================================================
PIM Source Group ipv4
===============================================================================
Group Address : 239.225.1.1
Source Address : 10.1.1.2
RP Address : 10.4.4.4
Advt Router : 10.1.1.1
Flags : spt Type : (S,G)
MRIB Next Hop : 13.1.1.1
MRIB Src Flags : remote
Keepalive Timer Exp: 0d 00:03:16
Up Time : 0d 00:21:44 Resolved By : rtable-u
Up JP State : Joined Up JP Expiry : 0d 00:00:43
Up JP Rpt : Not Joined StarG Up JP Rpt Override : 0d 00:00:00
Register State : No Info
Reg From Anycast RP: No
Rpf Neighbor : 13.1.1.1
Incoming Intf : C_A
Outgoing Intf List : C_Rx_net1, C_Rx_acc1, C_Rx_acc2, C_Rx_net2
Spt threshold : 0 kbps ECMP opt threshold : 7
===============================================================================
Label |
Description |
|---|---|
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 |
Displays 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 toward 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 toward 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 toward 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 toward 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 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 |
interface [ip-int-name | int-ip-address] [group [group-ip-address] source ip-address] [type {starstarrp | starg | sg}] [detail] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays PIM interface information and the (S,G)/(*,G)/(*, *, rp) state of the interface.
Displays the interface information associated with the specified IP interface name.
Displays the interface information associated with the specified IP address.
Specifies the IP multicast group address for which this entry contains information.
Specifies the source address for which this entry contains information.
If the type is starg, the value of this object will be zero.
If the type is starstarrp, the value of this object will be address of the RP.
Specifies the type of this entry.
Displays detailed interface information.
Displays IPv4 information for the interface.
The following output is an example of PIM interface information, and Table: Output fields: PIM interface describes the output fields.
Sample output*7210 SAS>show>router>pim# interface
===============================================================================
PIM Interfaces ipv4
===============================================================================
Interface Adm Opr DR Prty Hello Intvl Mcast Send
DR
-------------------------------------------------------------------------------
system Up Up 1 30 auto
10.5.5.5
loopback1 Up Up 1 30 auto
10.1.1.5
toG_1 Up Down 1 30 auto
toIxia_Ntw_1 Up Up 1 30 auto
10.2.1.5
toIxia_Ntw_2 Up Up 1 30 auto
10.2.2.5
toR_1 Up Down 1 30 auto
N/A
toIxia_1 Up Down 1 30 auto
N/A
toLAN_1 Up Up 1 30 auto
10.1.1.5
-------------------------------------------------------------------------------
Interfaces : 124
===============================================================================
*7210 SAS>show>router>pim#
Label |
Description |
|---|---|
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 |
mc-ecmp-balance
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays multicast balance information.
neighbor [ip-address | ip-int-name [address neighbor-ip-address]] [detail] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays PIM neighbor information.
This can be important if an interface has more than one adjacency. For example, a LAN-interface configuration with three routers connected and all are running PIM on their LAN interfaces. These routers then have two adjacencies on their LAN interface, each with different neighbors. If the address address parameter is not defined in this example, then the show command output would display two adjacencies.
Displays the interface information associated with the specified IP interface name.
Displays the interface information associated with the specified IP address.
Specifies the IP address of the neighbor, on the other side of the interface.
Displays detailed neighbor information.
Displays IPv4 information for the specified neighbor.
The following output is an example of PIM neighbor information, and Table: Output fields: PIM neighbor describes the output fields.
Sample outputALA-1>show>router>pim# neighbor
===============================================================================
PIM Neighbor ipv4
===============================================================================
Interface Nbr DR Prty Up Time Expiry Time Hold Time
Nbr Address
-------------------------------------------------------------------------------
toB_1 1 0d 00:31:36 0d 00:01:40 105
10.1.1.2
toE_1 1 0d 00:32:04 0d 00:01:42 105
10.1.1.5
toE_10 1 0d 00:32:04 0d 00:01:42 105
10.1.10.5
toE_11 1 0d 00:32:04 0d 00:01:42 105
10.1.11.5
toE_12 1 0d 00:32:04 0d 00:01:42 105
10.1.12.5
toE_13 1 0d 00:32:04 0d 00:01:42 105
10.1.13.5
toE_14 1 0d 00:32:04 0d 00:01:42 105
10.1.14.5
toE_15 1 0d 00:32:05 0d 00:01:41 105
10.1.15.5
ALA-1#
Label |
Description |
|---|---|
Interface |
Displays the neighbor interface name |
Nbr DR Priority |
Displays the value of the neighbor DR priority which is received in the hello message |
Nbr Address |
Displays the neighbor address |
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 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 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 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 |
rp [family | ip-address]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays the rendezvous point (RP) set information built by the router.
Displays IPv4 information.
Specifies the IP address of the RP.
The following output is an example of PIM RP information, and Table: Output fields: PIM RP describes the output fields.
Sample outputA:ALA-1# show router pim rp
==================================================================
PIM RP Set ipv4
==================================================================
Group Address RP Address Type Priority Holdtime Expirytime
------------------------------------------------------------------
224.0.0.0/4 239.200.200.4 Dynamic 192 150
10.1.7.1 Static 1 N/A
------------------------------------------------------------------
Group Prefixes : 1
==================================================================
A:ALA-1#
Label |
Description |
|---|---|
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 |
rp-hash ip-address
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command hashes the RP for the specified group from the RP set.
Displays specific multicast group addresses.
The following output is an example of RP hash information, and Table: Output fields: PIM RP hash describes the output fields.
Sample outputA:ALA-1# show router pim rp-hash 239.101.0.0
==============================================
PIM Group-To-RP mapping
==============================================
Group Address RP Address Type
----------------------------------------------
239.101.0.0 239.200.200.4 Bootstrap
==============================================
A:ALA-1#
A:ALA-1# show router pim rp-hash 239.101.0.6
==============================================
PIM Group-To-RP mapping
==============================================
Group Address RP Address Type
----------------------------------------------
239.101.0.6 239.200.200.4 Bootstrap
==============================================
A:ALA-1#
Label |
Description |
|---|---|
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 |
statistics [ip-int-name | int-ip-address | mpls-ip-name] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays statistics for a particular PIM instance.
Displays the interface information associated with the specified IP interface name.
Displays the interface information associated with the specified IP address.
Identifies the system created IP-MPLS tunnel interfaces, when using NG-MVPN with BGP based signaling and using P2MP LSPs setup using RSVP or mLDP.
Displays IPv4 information.
The following output is an example of PIM statistics information, and Table: Output fields: PIM statistics describes the output fields.
Sample outputA:dut-g>show>router>pim# statistics
=================================================================
PIM Statistics ipv4
=================================================================
Message Type Received Transmitted Rx Errors
-----------------------------------------------------------------
Hello 9690 9735 0
Join Prune 2441 6855 0
Asserts 589 0 0
Register 0 0 0
Null Register 0 0 0
Register Stop 0 0 0
BSM 0 0 0
Total Packets 12720 16590
-------------------------------------------------------------------------------
General Statistics
-------------------------------------------------------------------------------
Rx Invalid Register : 0
Rx Neighbor Unknown : 0
Rx Bad Checksum Discard : 0
Rx Bad Encoding : 0
Rx Bad Version Discard : 0
Rx BSM Router Alert Drops : 0
Rx BSM Wrong If Drops : 0
Rx Invalid Join Prune : 0
Rx Unknown PDU Type : 0
Join Policy Drops : 0
Register Policy Drops : 0
Bootstrap Import Policy Drops : 0
Bootstrap Export Policy Drops : 0
PDU Drops on Non-PIM/Down Intf : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G) : 435
(*,G) : 251
(*,*,RP) : 0
=================================================================
A:dut-g>show>router>pim#
Label |
Description |
|---|---|
PIM Statistics |
Displays 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 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 |
Displays the general PIM interface statistics |
Register TTL Drop |
Displays the number of multicast data packets that 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) that 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 groups contained in the message |
Register Policy Drops |
Displays the number of times the register policy match resulted in dropping PIM Register messages |
Bootstrap Import Policy Drops |
Displays the number of Bootstrap messages received on this interface that were dropped because of the bootstrap import policy |
Bootstrap Export Policy Drops |
Displays the number of Bootstrap messages that were not transmitted on this interface because of the bootstrap export policy |
Source Group Statistics |
Displays 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) |
status [detail] [family]
show>router>pim
Supported on all 7210 SAS platforms as described in this document
This command displays the PIM status. The oper status reflects the combined operational status of the IPv4 PIM protocol status. If both are down, the oper status will be reflected as down. If IPv4 reflects up, the oper status will reflect up.
If PIM is not enabled, the following message appears:
A:NYC# show router pim status
MINOR: CLI PIM is not configured.
A:NYC#
Displays detailed status information.
Displays IPv4 information.
The following output is an example of PIM status information, and Table: Output fields: PIM status describes the output fields.
Sample outputA:dut-g>show>router>pim# status
===============================================================================
PIM Status ipv4
===============================================================================
Admin State : Up
Oper State : Up
IPv4 Admin State : Up
IPv4 Oper State : Up
BSR State : Accept Any
Elected BSR
Address : None
Expiry Time : N/A
Priority : N/A
Hash Mask Length : 30
Up Time : N/A
RPF Intf toward E-BSR : N/A
Candidate BSR
Admin State : Down
Oper State : Down
Address : None
Priority : 0
Hash Mask Length : 30
SSM-Default-Range : Enabled
SSM-Assert-Comp-Mode : Disabled
SSM-Group-Range
None
MC-ECMP-Hashing : Disabled
Policy : None
RPF Table : rtable-u
Non-DR-Attract-Traffic : Disabled
===============================================================================
A:dut-g>show>router>pim#
Label |
Description |
|---|---|
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 toward |
Displays the RPF interface toward 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 CRP 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 hold time 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 |