Router PIM commands

anycast

Syntax

anycast [family] [detail]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM anycast rp-set information.

Parameters

family

Indicates an IPv4 address.

detail

Displays detailed information.

Output

The following output is an example of a PIM anycast configuration information, and Table: Output fields: PIM anycast describes the output fields.

Sample output
A: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
===================================================
Table: Output fields: PIM anycast

Label

Description

Anycast Address

Displays the candidate anycast address

Anycast RP Peer

Displays the candidate anycast RP peer address

crp

Syntax

crp [ip-address]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM candidate RP (CRP) information received at the elected Bootstrap router (BSR).

Parameters

ip-address

Specifies the candidate RP IP address.

Output

The following output is an example of PIM CRP information, and Table: Output fields: PIM CRP describes the output fields.

Sample output
A:7210SAS# show router pim crp
============================================================================
PIM Candidate RPs
============================================================================
RP Address      Group Address      Priority    Holdtime  Expiry Time
----------------------------------------------------------------------------
239.22.187.236    224.0.0.0/4        192         150       0d 00:02:19
239.22.187.239    224.0.0.0/4        192         150       0d 00:02:19
239.22.187.240    224.0.0.0/4        192         150       0d 00:02:09
----------------------------------------------------------------------------
Candidate RPs : 3
============================================================================
A:7210SAS#
Table: Output fields: PIM CRP

Label

Description

RP Address

Displays the CRP address

Group Address

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

Priority

Displays the CRP priority for becoming an RP. This value is used to elect RP for a group range. A value of 0 is considered the highest priority.

Holdtime

Displays the hold time of the CRP. 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 is declared down. If the local router is not the BSR, this value is 0.

Candidate RPs

Displays the number of CRP entries

group

Syntax

group [group-ip-address] [source ip-address] [type {starstarrp | starg | sg}] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM source group database information.

Parameters

group-ip-address

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

source ip-address

Specifies the source address for which this entry contains information.

type starstarrp

Specifies that only (*, *, rp) entries are displayed.

type starg

Specifies that only (*,G) entries are displayed.

type sg

Specifies that only (S,G) entries are displayed.

detail

Displays detailed group information.

family

Displays either IPv4 or IPv6 information.

Output

The following output is an example of PIM source group database information, and Table: Output fields: PIM group describes the output fields.

Sample output
*A:7210SAS# show router 1 pim group 

===============================================================================
PIM Groups ipv4
===============================================================================
Group Address                           Type     Spt Bit Inc Intf       No.Oifs
   Source Address                          RP                           
-------------------------------------------------------------------------------
239.1.1.1                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.2                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.3                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.4                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.5                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.6                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.7                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.8                               (S,G)            mpls-if-74734  1
   10.1.1.2                                
239.1.1.9                               (S,G)            mpls-if-74734  1
   10.1.1.2                                

*A:7210SAS# 


*A:7210SAS#show router 1 pim group detail 

===============================================================================
PIM Source Group ipv4
===============================================================================
Group Address      : 239.1.1.1
Source Address     : 10.1.1.2
RP Address         : 0
Advt Router        : 10.17.17.17
Flags              :                    Type               : (S,G)
MRIB Next Hop      : 10.17.17.17
MRIB Src Flags     : remote             Keepalive Timer    : Not Running
Up Time            : 5d 21:12:47        Resolved By        : rtable-u

Up JP State        : Joined             Up JP Expiry       : 0d 00:00:52
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       : 10.17.17.17
Incoming Intf      : mpls-if-74734
Outgoing Intf List : vprn1_1
                                      
ECMP opt threshold : 7
Table: Output fields: PIM group

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

The source address is 0 if the type is configured as starg.

The source address is the address of the RP if the type is configured as starstarrp.

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. This 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 contains 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 is 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 a ‟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 the router does not see a join (S,G, rpt) message, on expiry of the override timer, it sends its 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

Displays 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 occurs based on the register stop timer and the response received from the RP.

Register Stop Exp

Displays the time remaining before the register state may transition to a different state

Register from Anycast RP

Displays whether 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

Syntax

interface [ip-int-name | int-ip-address] [group [group-ip-address] source ip-address] [type {starstarrp | starg | sg}] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM interface information and the (S,G)/(*,G)/(*, *, rp) state of the interface.

Parameters

ip-int-name

Displays the interface information associated only with the specified IP interface name.

ip-address

Displays the interface information associated with only the specified IP address.

group group-ip-address

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

source ip-address

Specifies the source address for which this entry contains information.

If the type is starg, the value of this object is zero.

If the type is starstarrp, the value of this object is the address of the RP.

type

Specifies the type of this entry.

Values

starstarrp, starg, sg

detail

Displays detailed interface information.

family

Displays IPv4 or IPv6 information for the interface.

Output

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#
Table: Output fields: PIM interface

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

Syntax

mc-ecmp-balance

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays multicast balance information.

neighbor

Syntax

neighbor [ip-address | ip-int-name [address neighbor-ip-address]] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM neighbor information.

This can be important if an interface has more than one adjacency. For example, consider 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 parameter is not defined in this example, the show command output would display two adjacencies.

Parameters

neighbor ip-int-name

Displays the interface information associated only with the specified IP interface name.

neighbor ip-address

Displays the interface information associated only with the specified IP address.

address ip-address

Specifies the IP address of the neighbor on the other side of the interface.

detail

Displays detailed neighbor information.

family

Displays either IPv4 or IPv6 information for the specified neighbor.

Output

The following output is an example of PIM neighbor information, and Table: Output fields: PIM neighbor describes the output fields.

Sample output
ALA-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# 
Table: Output fields: PIM neighbor

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 neighbors 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 is aged out

0 — Means that this neighbor is never be aged out. This happens when the PIM neighbor sends a Hello message with a hold-time 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 is 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, old Hello information about that neighbor is discarded and replaced by the information from the new hello message.

Override Intvl (ms)

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

rp

Syntax

rp [family | ip-address]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays the RP set information built by the router.

Parameters

family

Displays either IPv4 or IPv6 information.

ip-address

Specifies the IP address of the RP.

Output

The following output is an example of PIM RP information, and Table: Output fields: PIM RP describes the output fields.

Sample output
A: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# 
Table: Output fields: PIM RP

Label

Description

Group Address

Displays the multicast group address of the entry

RP Address

Displays the address of the 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

Syntax

rp-hash ip-address

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command hashes the RP for the specified group from the RP set.

Parameters

ip-address

Displays specific multicast group addresses.

Output

The following output is an example of PIM RP hashing information, and Table: Output fields: PIM RP-hash describes the output fields.

Sample output
A: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        229.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#
Table: Output fields: PIM RP-hash

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

s-pmsi

Syntax

s-pmsi [group-ip group-ip] [source-ip source-ip] [detail]

s-pmsi [mdSrcAddr [mdGrpAddr]] [group-ip group-ip] [source-ip source-ip] [detail]

s-pmsi ext-tunnel-id ext-tunnel-id [tunnel-id tunnel-id] [group-ip group-ip] [source-ip source-ip] [detail]

s-pmsi root-addr root-addr [lsp-id lsp-id] [group-ip group-ip] [source-ip source-ip] [detail]

Context

show>router>pim

Platforms

7210 SAS-T (network mode only), 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Mxp, and 7210 SAS-Sx/S 1/10GE (in standalone mode)

Description

Displays the list of selective provider multicast service interfaces that are currently active.

Parameters

group-ip

Specifies the group IP address.

source-ip

Specifies the source IP address.

mdSrcAddr

Displays PIM S-PMSI information associated with the specified source address of the multicast sender.

mdGrpAddr

Displays PIM S-PMSI information associated with the specified group address of the multicast sender.

ext-tunnel-id

Displays PIM S-PMSI information associated with the specified external tunnel ID.

tunnel-id

Displays PIM S-PMSI information associated with the specified tunnel ID.

root-addr

Displays PIM S-PMSI information associated with the specified root address.

lsp-id

Displays PIM S-PMSI information associated with the specified LSP.

detail

Displays detailed output.

Output

The following outputs are examples of S-PMSI information, and Table: Output fields: S-PMSI describes the output fields.

Sample output PIM selective provider tunnel
*B:node-6# show router 100 pim s-pmsi
===============================================================================
PIM Selective provider tunnels
===============================================================================
MD Src Address        MD Grp Address        MT Index      Num VPN SGs         
-------------------------------------------------------------------------------
239.200.200.7         239.0.89.72           24603         1                   
239.200.200.7         239.0.89.73           24604         1                   
239.200.200.7         239.0.89.74           24605         1                   
239.200.200.7         239.0.89.75           24606         1                   
239.200.200.7         239.0.89.76           24607         1                   
239.200.200.7         239.0.89.77           24608         1                   
239.200.200.7         239.0.89.78           24609         1                   
239.200.200.7         239.0.89.79           24610         1                   
239.200.200.7         239.0.89.80           24611         1                   
239.200.200.7         239.0.89.81           24612         1                   
239.200.200.7         239.0.89.82           24613         1                   
239.200.200.7         239.0.89.83           24614         1                   
239.200.200.7         239.0.89.84           24615         1                   
239.200.200.7         239.0.89.85           24616         1                   
239.200.200.7         239.0.89.86           24617         1                   
239.200.200.7         239.0.89.87           24618         1
...
===============================================================================
*B:node-6# 
Sample output PIM selective provider tunnel detail
*B:node-6# show router 100 pim s-pmsi
===============================================================================
PIM Selective provider tunnels
===============================================================================
MD Src Address        MD Grp Address        MT Index      Num VPN SGs         
-------------------------------------------------------------------------------
239.200.200.7         239.0.89.72           24603         1                   
239.200.200.7         239.0.89.73           24604         1                   
239.200.200.7         239.0.89.74           24605         1                   
239.200.200.7         239.0.89.75           24606         1                   
239.200.200.7         239.0.89.76           24607         1                   
239.200.200.7         239.0.89.77           24608         1                   
239.200.200.7         239.0.89.78           24609         1                   
239.200.200.7         239.0.89.79           24610         1                   
239.200.200.7         239.0.89.80           24611         1                   
239.200.200.7         239.0.89.81           24612         1                   
239.200.200.7         239.0.89.82           24613         1                   
239.200.200.7         239.0.89.83           24614         1                   
239.200.200.7         239.0.89.84           24615         1                   
239.200.200.7         239.0.89.85           24616         1                   
239.200.200.7         239.0.89.86           24617         1                   
239.200.200.7         239.0.89.87           24618         1
...
===============================================================================
*B:node-6# 
Sample output RX tracking for RSVP S-PMSI tunnel
*A:Dut-C# show router 1 pim s-pmsi
===============================================================================
PIM RSVP Spmsi tunnels
===============================================================================
P2mp ID   Tunnel ID   Ext Tunnel Adrs       SPMSI Index   Num VPN   State
                                                          SGs
-------------------------------------------------------------------------------
0         0           10.20.1.4             1030144       1         RX Tracking
0         0           10.20.1.4             1030144       1         RX Tracking
===============================================================================
PIM RSVP Spmsi Interfaces : 2
===============================================================================
*A:Dut-C# show router 21 pim s-pmsi
====================================================================
PIM LDP Spmsi tunnels
====================================================================
Lsp ID    Root Addr             SPMSI Index   Num VPN   State
                                              SGs
--------------------------------------------------------------------
0         10.20.1.4             1030144       1         RX Tracking
0         10.20.1.4             1030144       1         RX Tracking
====================================================================
PIM LDP Spmsi Interfaces : 2
====================================================================
*A:Dut-C#
Sample output RX tracking for RSVP S-PMSI tunnel detail
*A:Dut-C# show router 1 pim s-pmsi detail
===============================================================================
PIM RSVP Spmsi tunnels
===============================================================================
P2MP ID            : 0                  Tunnel ID          : 0
Ext Tunnnel Addrs  : 10.20.1.4          Spmsi IfIndex      : 1030144
Number of VPN SGs  : 1                  Uptime             : 0d 00:02:48
VPN Group Address  : 239.100.0.0
VPN Source Address : 10.1.101.2
State              : RX Tracking        Mdt Threshold      : 0
===============================================================================
PIM RSVP Spmsi tunnels
===============================================================================
P2MP ID            : 0                  Tunnel ID          : 0
Ext Tunnnel Addrs  : 10.20.1.4          Spmsi IfIndex      : 1030144
Number of VPN SGs  : 1                  Uptime             : 0d 00:02:47
VPN Group Address  : ff0e:db8:225:100::
VPN Source Address : 2001:db8:1:101::2
State              : RX Tracking        Mdt Threshold      : 0
===============================================================================
PIM RSVP Spmsi Interfaces : 2
===============================================================================
*A:Dut-C#
*A:Dut-C# show router 21 pim s-pmsi detail
===============================================================================
PIM LDP Spmsi tunnels
===============================================================================
LSP ID             : 0
Root Addr          : 10.20.1.4          Spmsi IfIndex      : 1030144
Number of VPN SGs  : 1                  Uptime             : 0d 00:03:35
VPN Group Address  : 239.100.0.0
VPN Source Address : 10.1.101.2
State              : RX Tracking        Mdt Threshold      : 0
===============================================================================
PIM LDP Spmsi tunnels
===============================================================================
LSP ID             : 0
Root Addr          : 10.20.1.4          Spmsi IfIndex      : 1030144
Number of VPN SGs  : 1                  Uptime             : 0d 00:03:34
VPN Group Address  : ff0e:db8:225:100::
VPN Source Address : 2001:db8:1:101::2
State              : RX Tracking        Mdt Threshold      : 0
===============================================================================
PIM LDP Spmsi Interfaces : 2
===============================================================================
*A:Dut-C#
Sample output TX tracking for RSVP S-PMSI tunnel detail
*A:Dut-C# show router 1 pim s-pmsi detail
===============================================================================
PIM RSVP Spmsi tunnels
===============================================================================
P2MP ID            : 1                  Tunnel ID          : 61442
Ext Tunnnel Addrs  : 10.20.1.4          Spmsi IfIndex      : 74230
Number of VPN SGs  : 1                  Uptime             : 0d 00:05:11
VPN Group Address  : 239.100.0.0
VPN Source Address : 10.1.101.2
State              : TX Join Pending    Mdt Threshold      : 1
Join Timer         : N/A                Holddown Timer     : 0d 00:00:47
Receiver Count     : 4
===============================================================================
PIM RSVP Spmsi tunnels
===============================================================================
P2MP ID            : 1                  Tunnel ID          : 61443
Ext Tunnnel Addrs  : 10.20.1.4          Spmsi IfIndex      : 74231
Number of VPN SGs  : 1                  Uptime             : 0d 00:05:10
VPN Group Address  : ff0e:225:100::
VPN Source Address : 2001:db8:1:101::2
State              : TX Join Pending    Mdt Threshold      : 1
Join Timer         : N/A                Holddown Timer     : 0d 00:00:50
Receiver Count     : 4
===============================================================================
PIM RSVP Spmsi Interfaces : 2
===============================================================================
*A:Dut-C#
*A:Dut-D# show router 21 pim s-pmsi detail
===============================================================================
PIM LDP Spmsi tunnels
===============================================================================
LSP ID             : 8194
Root Addr          : 10.20.1.4          Spmsi IfIndex      : 74228
Number of VPN SGs  : 1                  Uptime             : 0d 00:05:56
VPN Group Address  : 239.100.0.0
VPN Source Address : 10.1.101.2
State              : TX Join Pending    Mdt Threshold      : 1
Join Timer         : N/A                Holddown Timer     : 0d 00:00:02
Receiver Count     : 4
===============================================================================
PIM LDP Spmsi tunnels
===============================================================================
LSP ID             : 8195
Root Addr          : 10.20.1.4          Spmsi IfIndex      : 74229
Number of VPN SGs  : 1                  Uptime             : 0d 00:05:55
VPN Group Address  : ff0e:db8:225:100::
VPN Source Address : 2001:db8:1:101::2
State              : TX Join Pending    Mdt Threshold      : 1
Join Timer         : N/A                Holddown Timer     : 0d 00:00:05
Receiver Count     : 4
===============================================================================
PIM LDP Spmsi Interfaces : 2
===============================================================================
*A:Dut-D#
Table: Output fields: S-PMSI

Label

Description

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

A value of 0 (zero) indicates the type is configured as starg.

MT Index

MT IfIndex

Displays the index number

Num VP SGs

Displays the number of VPN (S,G)s

Uptime

Displays the length of time that the S-PMSI has been up

Egress Fwding Rate

Displays the egress forwarding rate for the S-PMSI

VPN Group Address

Displays the VPN group address for the S-PMSI

VPN Source Address

Displays the VPN source address for the S-PMSI

Expiry Timer

Displays the minimum time remaining before this S_PMSI is aged out

A value of 0 (zero) means that this S-PMSI is never aged out, which occurs when the PIM neighbor sends a Hello message with hold time set to 0xffff.

statistics

Syntax

statistics [ip-int-name | int-ip-address | mpls-if-name] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays statistics for a particular PIM instance.

Parameters

ip-int-name

Only displays the interface information associated with the specified IP interface name.

int-ip-address

Only displays the interface information associated with the specified IP address.

mpls-if-name

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.

family

Displays either IPv4 or IPv6 information.

Output

The following output is an example of PIM statistics information, and Table: Output fields: PIM statistics describes the output fields.

Sample output
A: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#
Table: Output fields: PIM statistics

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

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

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 that 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 that 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

Displays 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)

status

Syntax

status [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays PIM status. The Oper Status reflects the combined operational status of IPv4 or IPv6 PIM protocol status. If both are down, Oper Status is reflected as down. If IPv4 or IPv6 reflects up, the Oper Status reflects up.

If PIM is not enabled, the following message appears:

A:NYC# show router pim status
MINOR: CLI PIM is not configured.
A:NYC#

Parameters

detail

Displays detailed status information.

family

Displays either IPv4 or IPv6 information.

Output

The following output is an example of PIM status information, and Table: Output fields: PIM status describes the output fields.

Sample output
A: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 towards 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# 
Table: Output fields: PIM status

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 towards

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 C-RP mechanism

Address

Displays the local RP address

Priority

Displays the CRP priority for becoming an RP. A value of 0 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 whether hash-based multicast balancing of traffic over ECMP links is enabled

tunnel-interface

Syntax

tunnel-interface [ip-int-name | mt-int-name | int-ip-address] [group [group-ip-address] source ip-address] [type {starstarrp | starg | sg}] [detail] [family]

Context

show>router>pim

Platforms

7210 SAS-T (network mode only), 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Mxp.

Description

This command displays PIM tunnel interface information.

Parameters

ip-int-name

Specifies the IP interface name. A string up to 32 characters.

mt-int-name

Specifies the Multicast Tunnel (MT) interface for a VPRN.

int-ip-address

Specifies the interface IPv4 or IPv6 address.

group-ip-address

Specifies the IP multicast group address, or 0.

ip-address

Specifies the source or RP IPv4 or IPv6 address.

type

Specifies the type of entry.

Values

starstarrp, starg, sg

detail

Displays detailed interface information.

family

Specifies the IPv4 or IPv6 address family.

Output

The following output is an example of PIM tunnel interface information.

Sample output
*A:Dut-C# show router pim tunnel-interface 
==================================================================================
PIM Interfaces ipv4
===============================================================================
Interface                        Originator Address   Adm  Opr  Transport Type
-------------------------------------------------------------------------------
mpls-if-73728                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73729                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73730                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73731                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73732                    N/A                  Up   Up   Tx-IPMSI
-------------------------------------------------------------------------------
Interfaces : 5
===============================================================================

mvpn

Syntax

mvpn

Context

show>router

Platforms

7210 SAS-T (network mode only), 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Mxp, and 7210 SAS-Sx/S 1/10GE (in standalone mode)

Description

This command displays multicast VPN information for the specified router instance.

Output

The following output is an example of PIM MVPN information.

Sample output
*A:7210SAS# show router 10 mvpn 

===============================================================================
MVPN 10 configuration data
===============================================================================
signaling : Bgp auto-discovery : Default
UMH Selection : Highest-Ip intersite-shared : Enabled
vrf-import : N/A
vrf-export : N/A
vrf-target : unicast
C-Mcast Import RT : target:10.16.16.16:3
 
ipmsi : ldp
i-pmsi P2MP AdmSt : Up 
 
spmsi : ldp
s-pmsi P2MP AdmSt : Up 
max-p2mp-spmsi : 251 
data-delay-interval: 3 seconds 
enable-asm-mdt : N/A 
data-threshold : 224.0.0.0/4 --> 1 kbps
 
===============================================================================
*A:7210SAS# 

mvpn-list

Syntax

mvpn-list

Context

show>router

Platforms

7210 SAS-T (network mode only), 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Mxp, and 7210 SAS-Sx/S 1/10GE (in standalone mode)

Description

This command displays multicast VPN list information for the specified router instance.

Output

The following output is an example of PIM MVPN list information.

Sample output
A:7210SAS# show router mvpn-list 

===============================================================================
MVPN List
===============================================================================
VprnID Sig A-D iPmsi/sPmsi GroupAddr/Lsp-Template (S,G)/(*,G)
-------------------------------------------------------------------------------
10 Bgp Default Mldp/Mldp N/A 512/0
20 Bgp Default Mldp/Mldp N/A 512/0
30 Bgp Default None/None N/A 0/0
-------------------------------------------------------------------------------
Total PIM I-PMSI tunnels : 0
Total RSVP I-PMSI tunnels : 0
Total MLDP I-PMSI tunnels : 2
Total PIM TX S-PMSI tunnels : 0
Total RSVP TX S-PMSI tunnels : 0
Total MLDP TX S-PMSI tunnels : 502
Total PIM RX S-PMSI tunnels : 0
Total RSVP RX S-PMSI tunnels : 0
Total MLDP RX S-PMSI tunnels : 0
Total (S,G) : 1024
Total (*,G) : 0
Total Mvpns : 3
Sig = Signal Pim-a = pim-asm Pim-s = pim-ssm A-D = Auto-Discovery
===============================================================================
*A:7210SAS# 

tunnel-table

Syntax

tunnel-table [ip-address [/mask]] [protocol | sdp sdp-id]

tunnel-table [summary]

Context

show>router

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays tunnel table information.

Parameters

protocol

Specifies the protocol.

Values

bgp, ldp, rsvp, sdp

sdp-id

Specifies the SDP ID.

Values

1 to 17407

Output

The following output is an example of PIM tunnel table information.

Sample output
*A:Dut-C# show router pim tunnel-interface 
==================================================================================
PIM Interfaces ipv4
===============================================================================
Interface                        Originator Address   Adm  Opr  Transport Type
-------------------------------------------------------------------------------
mpls-if-73728                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73729                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73730                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73731                    N/A                  Up   Up   Tx-IPMSI
mpls-if-73732                    N/A                  Up   Up   Tx-IPMSI
-------------------------------------------------------------------------------
Interfaces : 5
===============================================================================