5.5. Show, Clear, and Debug Command Reference

5.5.1. Command Hierarchies

Show Commands
Clear Commands
Debug Commands

5.5.1.1. Show Commands

show

— router

— pim

— anycast [detail]

— crp [ip-address]

— s-pmsi [data-mt-interface-name] [detail]

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

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

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

— rp [ip-address]

— rp-hash grp-ip-address

— statistics [ip-int-name | mt-int-name | ip-address] [family]

— status [detail] [family]

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

5.5.1.2. Clear Commands

clear

— router

— pim

— database [interface ip-int-name | ip-address | mt-int-name] [group grp-ip-address [source ip-address]] [family]]

— neighbor [interface ip-int-name | ip-address] [family]

— s-pmsi [mdSrcAddr] [mdGrpAddr] [vprnSrcAddr vprnGrpAddr]

— statistics [{[interface ip-int-name | ip-address | mt-int-name]} {[group grp-ip-address [source ip-address]]}][family]]

5.5.1.3. Debug Commands

debug

— router

— pim

— [no] adjacency

— all [group grp-ip-address] [source ip-address] [detail]

— no all

— assert [group grp-ip-address] [source ip-address] [detail]

— no assert

— auto-rp [detail]

— no auto-rp

— bgp [source ip-address] [group group-ip-address] [peer peer-ip-address]

— no bgp

— bsr [detail]

— no bsr

— data [group grp-ip-address] [source ip-address] [detail]

— no data

— db [group grp-ip-address] [source ip-address] [detail]

— no db

— dynmldp [detail]

— no dynmldp

— extranet [detail]

— no extranet

— grafts [source ip-address] [group grp-ip-address] [detail]

— no grafts

— interface [ip-int-name | mt-int-name| ip-address] [detail]

— no interface

— jp [group grp-ip-address] [source ip-address] [detail]

— no jp

— [no] mofrr

— mrib [group grp-ip-address] [source ip-address] [detail]

— no mrib

— msg [detail]

— no msg

— mvpn-rtcache [group grp-ip-address] [peer ip-address]

— no mvpn-rtcache

— packet [hello | register | register-stop | jp | bsr | assert | crp | mdt-tlv | auto-rp-announcement | auto-rp-mapping | graft | graft-ack] [ip-int-name | mt-int-name | int-ip-address | mpls-if-name] [family {ipv4 | ipv6}] [send | receive]

— no packet

— red [detail]

— no red

— register [group grp-ip-address] [source ip-address] [detail]

— no register

— rpfv [detail]

— no rpfv

— rtm [detail]

— no rtm

— s-pmsi [{vpnSrcAddr [vpnGrpAddr]} [mdSrcAddr]] [detail]

— no s-pmsi

— tunnel-interface [ldp-p2mp p2mp-id] [sender ip-address] [detail]

— no tunnel-interface [ldp-p2mp p2mp-id] [sender ip-address]

— tunnel-interface [rsvp-p2mp lsp-name] [sender ip-address] [detail]

— no tunnel-interface [rsvp-p2mp lsp-name] [sender ip-address]

5.5.2. Command Descriptions

5.5.2.1. Show Commands

The command outputs in the following section are examples only; actual displays may differ depending on supported functionality and user configuration.

anycast

Syntax

anycast [detail]

Context

show>router>pim

Description

This command displays PIM anycast rp-set information.

Parameters

detail—

Displays detailed information.

Output

The following output displays an example of a PIM anycast configuration.

Sample Output

A:dut-d# 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

===================================================

The following table provides PIM anycast field descriptions

Table 17: PIM Anycast Fields

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

Description

Display PIM candidate RP (CRP) information received at the elected Bootstrap router (BSR).

Parameters

ip-address—

The candidate RP IP address.

Output

The following output is an example of a PIM CRP configuration.

Sample Output

A:WAS# 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:WAS#

A:WAS# show router pim crp 239.22.187.236

============================================================================

PIM Candidate RPs

============================================================================

RP Address Group Address Priority Holdtime Expiry Time

----------------------------------------------------------------------------

239.22.187.236 224.0.0.0/4 192 150 0d 00:01:43

----------------------------------------------------------------------------

Candidate RPs : 1

============================================================================

A:WAS#

The following table provides PIM CRP field descriptions.

Table 18: PIM CRP Fields

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'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.

s-pmsi

Syntax

s-pmsi [mdSrcAddr [mdGrpAddr]] [detail]

Context

show>router>pim

Description

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

Parameters

mdSrcAddr—

Specifies the source address of the multicast sender.

mdGrpAddr—

Specifies the group address of the multicast sender.

detail—

Displays detailed output.

Output

The following output is an example of a PIM data MDT configuration

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 detail

===============================================================================

PIM Selective provider tunnels

===============================================================================

Md Source Address : 239.200.200.7 Md Group Address : 239.0.89.72

Number of VPN SGs : 1 Uptime : 0d 00:00:18

MT IfIndex : 24603 Egress Fwding Rate : 163.2 kbps

VPN Group Address : 239.1.0.0 VPN Source Address : 10.2.102.1

State : RX Joined

Expiry Timer : 0d 00:02:41

===============================================================================

PIM Selective provider tunnels

===============================================================================

Md Source Address : 239.200.200.7 Md Group Address : 239.0.89.73

Number of VPN SGs : 1 Uptime : 0d 00:00:18

MT IfIndex : 24604 Egress Fwding Rate : 163.2 kbps

VPN Group Address : 239.1.0.1 VPN Source Address : 10.2.102.1

State : RX Joined

Expiry Timer : 0d 00:02:41

===============================================================================

PIM Selective provider tunnels

===============================================================================

Md Source Address : 239.200.200.7 Md Group Address : 239.0.89.74

Number of VPN SGs : 1 Uptime : 0d 00:00:20

MT IfIndex : 24605 Egress Fwding Rate : 165.7 kbps

VPN Group Address : 239.1.0.2 VPN Source Address : 10.2.102.1

State : RX Joined

Expiry Timer : 0d 00:02:39

===============================================================================

PIM Selective provider tunnels

===============================================================================

Md Source Address : 239.200.200.7 Md Group Address : 239.0.89.75

Number of VPN SGs : 1 Uptime : 0d 00:00:20

MT IfIndex : 24606 Egress Fwding Rate : 165.7 kbps

VPN Group Address : 239.1.0.3 VPN Source Address : 10.2.102.1

State : RX Joined

Expiry Timer : 0d 00:02:39

===============================================================================

*B:node-6#

Sample Output for Rosen MVPN S-PMSI Tunnel

B:Dut-E# show router 100 pim s-pmsi

===============================================================================

PIM Selective provider tunnels

===============================================================================

MD Src Address MT Index Num VPN SGs MD RP for ASM State

MD Grp Address Multistream ID

-------------------------------------------------------------------------------

10.20.1.5 5798467 1 N/A TX Joined

233.0.0.5 5

10.20.1.5 5798468 1 N/A TX Joined

233.0.0.6 6

10.20.1.5 5798469 1 N/A TX Joined

233.0.0.7 7

10.20.1.5 5798470 1021 N/A TX Joined

233.0.0.8 8

===============================================================================

PIM Selective provider tunnels Interfaces : 4

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

===============================================================================

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

====================================================================

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 19 provides PIM data MDT descriptions.

Table 19: PIM Data MDT

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

Syntax

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

Context

show>router>pim

Description

This command displays PIM source group database information.

Parameters

grp-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 be displayed.

type starg—

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

type sg—

specifies that only (S,G) entries be displayed.

detail—

Displays detailed group information.

family—

Displays either IPv4 or IPv6 information.

Output

PIM Group Output

The following table provides PIM Group field descriptions.

Table 20: PIM Group Fields

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	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 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	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 kb/s means that the switch to the SP tree will happen immediately.

Sample Output

A:Dut-A# show router pim group

===============================================================================

PIM Group ipv4

===============================================================================

Group Address Type Spt Bit Inc Intf no.Oifs

Source Address RP Inc Intf(S)

-------------------------------------------------------------------------------

239.1.1.1 (S,G) ip-10.10.2.1 1

10.1.1.2 10.20.1.4 ip-10.10.1*

===============================================================================

A:Dut-A#

*A:Dut-C# show router 100 pim group ipv6

===============================================================================

Legend: A = Active S = Standby

===============================================================================

PIM Groups ipv6

===============================================================================

Group Address Type Spt Bit Inc Intf No.Oifs

Source Address RP State Inc Intf(S)

-------------------------------------------------------------------------------

ff04:db8:224:100:0:0 (*,G) vprn_itf_C_11* 2

* 2001:db8:110:100:1*

ff04:db8:224:100:0:0 (S,G) spt mpls-if-74457* 3

2001:db8:100:114:1:2 2001:db8:110:100:1*

ff04:db8:224:100:0:1 (*,G) vprn_itf_C_11* 2

* 2001:db8:110:100:1*

ff04:db8:224:100:0:1 (S,G) spt mpls-if-74457* 3

2001:db8:100:114:1:2 2001:db8:110:100:1*

ff04:db8:224:100:0:2 (*,G) vprn_itf_C_11* 2

* 2001:db8:110:100:1*

ff04:db8:224:100:0:2 (S,G) spt mpls-if-74457* 3

2001:db8:100:114:1:2 2001:db8:110:100:1*

ff04:db8:224:100:0:3 (*,G) vprn_itf_C_11* 2

* 2001:db8:110:100:1*

ff04:db8:224:100:0:3 (S,G) spt mpls-if-74457* 3

2001:db8:100:114:1:2 2001:db8:110:100:1*

ff04:db8:224:100:0:4 (*,G) vprn_itf_C_11* 2

* 2001:db8:110:100:1*

ff04:db8:224:100:0:4 (S,G) spt mpls-if-74457* 3

2001:db8:100:114:1:2 2001:db8:110:100:1*

-------------------------------------------------------------------------------

Groups : 10

===============================================================================

* indicates that the corresponding row element may have been truncated.

*A:Dut-C#

A:NYC>show>router>pim# group 239.255.255.250

===============================================================================

PIM Groups

===============================================================================

Group Address Source Address RP Address Type Spt Incoming Num

Bit Intf Oifs

-------------------------------------------------------------------------------

239.255.255.250 * 10.22.187.240 <*,G> nyc-sjc 1

-------------------------------------------------------------------------------

Groups : 1

===============================================================================

A:NYC>show>router>pim#

A:NYC>show>router>pim# group 239.255.255.250 detail

===============================================================================

PIM Source Group

===============================================================================

Group Address : 239.255.255.250 Source Address : 10.1.1.2

RP Address : 10.100.100.1 Type : (S,G)

Flags : spt, rpt-prn-des Keepalive Timer Exp: 0d 00:03:07

MRIB Next Hop : 10.1.1.2 MRIB Src Flags : direct

Up Time : 0d 00:00:50 Resolved By : rtable-u

Up JP State : Joined Up JP Expiry : 0d 00:00:00

Up JP Rpt : Pruned Up JP Rpt Override : 0d 00:00:00

Reg From Anycast RP: No

RPF Neighbor : 10.1.1.2

Incoming Intf : SOURCE-3

Outgoing Intf List : To-Dut-A

Curr Fwding Rate : 482.9 kbps

Forwarded Packets : 1262 Discarded Packets : 0

Forwarded Octets : 1269572 RPF Mismatches : 0

Spt threshold : 0 kbps

===============================================================================

A:NYC>show>router>pim#

B:Dut-C# show router pim group 239.0.0.1 type sg detail

===============================================================================

PIM Source Group ipv4

===============================================================================

Group Address : 239.0.0.1

Source Address : 10.11.0.1

RP Address : 10.20.1.3

Flags : rpt-prn-des Type : (S,G)

MRIB Next Hop : 10.11.0.1

MRIB Src Flags : direct Keepalive Timer : Not Running

Up Time : 0d 00:04:17 Resolved By : rtable-u

Up JP State : Joined Up JP Expiry : 0d 00:00:00

Up JP Rpt : Pruned Up JP Rpt Override : 0d 00:00:00

Reg From Anycast RP: No

Rpf Neighbor : 10.11.0.1

Incoming Intf : svc_itf

Outgoing Host List : 239.112.1.1

Curr Fwding Rate : 0.0 kbps

Forwarded Packets : 0 Discarded Packets : 0

Forwarded Octets : 0 RPF Mismatches : 0

Spt threshold : 0 kbps ECMP opt threshold : 7

Admin bandwidth : 1 kbps Preference : 0

===============================================================================

PIM Source Group ipv4

===============================================================================

Group Address : 239.0.0.1

Source Address : 10.11.0.2

RP Address : 10.20.1.3

Flags : Type : (S,G)

MRIB Next Hop : 10.11.0.2

MRIB Src Flags : direct Keepalive Timer : Not Running

Up Time : 0d 00:04:18 Resolved By : rtable-u

Up JP State : Joined Up JP Expiry : 0d 00:00:00

Up JP Rpt : Not Pruned Up JP Rpt Override : 0d 00:00:00

Reg From Anycast RP: No

Rpf Neighbor : 10.11.0.2

Incoming Intf : svc_itf

Outgoing Host List : 10.112.1.1, 10.112.1.2

Curr Fwding Rate : 0.0 kbps

Forwarded Packets : 0 Discarded Packets : 0

Forwarded Octets : 0 RPF Mismatches : 0

Spt threshold : 0 kbps ECMP opt threshold : 7

Admin bandwidth : 1 kbps Preference : 0

-------------------------------------------------------------------------------

Groups : 2

===============================================================================

*B:Dut-C#

A:Dut-A# show router pim group detail

===============================================================================

PIM Source Group ipv4

===============================================================================

Group Address : 239.1.1.1

Source Address : 10.1.1.21

RP Address : 10.20.1.4

Advt Router : 10.20.1.3

Flags : Type : (S,G)

MRIB Next Hop : 10.10.2.3

MRIB Src Flags : remote Standby Src Flags : remote

keepalive Timer : Not Running

Up Time : 0d 00:01:22 Resolved By : rtable-u

Up JP State : Joined Up JP Expiry : 0d 00:00:00

Up JP Rpt : Pruned Up JP Rpt Override : 0d 00:00:00

Up Stdby JP State : Joined Up Stdby JP Expiry : 0d 00:00:12

Reg From Anycast RP: No

Rpf Neighbor : 10.10.2.3 Stdby Rpf Neighbor : 10.10.1.2

Incoming Intf : ip-10.10.2.1 Stdby Intf : ip-10.10.1.1

Outgoing Host List : ix

Curr Fwding Rate : 0.0 kbps

Forwarded Packets : 0 Discarded Packets : 0

Forwarded Octets : 0 RPF Mismatches : 0

Spt threshold : 0 kbps ECMP opt threshold : 7

Admin bandwidth : 1 kbps

===============================================================================

PIM Source Group ipv4

interface

Syntax

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

Context

show>router>pim

Description

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

Parameters

ip-int-name—

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

mt-int-name—

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

Values—

<vprn-id>-mt-<grp-ip-address>

ip-address—

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

group grp-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 will be zero.

If the type is starstarrp, the value of this object will be 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 a PIM interface configuration.

Sample Output

ALA-1# show router pim interface

===============================================================================

PIM Interfaces

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

system Up Up N/A 1 30

ip-10.1.7.1 Up Up 10.1.7.7 5 30

ip-10.1.2.1 Up Up 10.1.2.2 5 30

ip-10.111.1.1 Up Up 10.111.1.1 5 30

-------------------------------------------------------------------------------

Interfaces : 4

===============================================================================

ALA-1#

ALA-1# show router pim interface ip-10.1.2.1 detail

===============================================================================

PIM Interface ip-10.1.2.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.1.2.1 Up Up 10.1.2.2 5 30

-------------------------------------------------------------------------------

PIM Group Source

-------------------------------------------------------------------------------

Group Address : 239.101.0.5 Src Address : 10.111.1.2

Interface : ip-10.1.2.1 Type : <S,G>

RP Address : 239.200.200.4

Join Prune State : Join Expires : 0d 00:03:00

Prune Pend Expires : N/A

Assert State : No Info

-------------------------------------------------------------------------------

Interfaces : 1

===============================================================================

ALA-1#

ALA-1# show router pim interface group

===============================================================================

PIM Interface ip-10.1.7.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.1.7.1 Up Up 10.1.7.7 5 30

-------------------------------------------------------------------------------

Group Address Source Address RP Address Type JP Assert

-------------------------------------------------------------------------------

239.101.0.0 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.1 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.2 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.3 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.4 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.6 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.7 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.8 10.111.1.2 239.200.200.4 <S,G> Join No Info

239.101.0.9 10.111.1.2 239.200.200.4 <S,G> Join No Info

===============================================================================

PIM Interface ip-10.1.2.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.1.2.1 Up Up 10.1.2.2 5 30

-------------------------------------------------------------------------------

Group Address Source Address RP Address Type JP Assert

-------------------------------------------------------------------------------

239.101.0.5 10.111.1.2 239.200.200.4 <S,G> Join No Info

===============================================================================

PIM Interface ip-10.111.1.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.111.1.1 Up Up 10.111.1.1 5 30

-------------------------------------------------------------------------------

Group Address Source Address RP Address Type JP Assert

-------------------------------------------------------------------------------

239.102.0.0 * 239.200.200.4 <*,G> Join No Info

239.102.0.1 * 239.200.200.4 <*,G> Join No Info

239.102.0.2 * 239.200.200.4 <*,G> Join No Info

239.102.0.3 * 239.200.200.4 <*,G> Join No Info

239.102.0.4 * 239.200.200.4 <*,G> Join No Info

239.102.0.5 * 239.200.200.4 <*,G> Join No Info

239.102.0.6 * 239.200.200.4 <*,G> Join No Info

239.102.0.7 * 239.200.200.4 <*,G> Join No Info

239.102.0.8 * 239.200.200.4 <*,G> Join No Info

239.102.0.9 * 239.200.200.4 <*,G> Join No Info

-------------------------------------------------------------------------------

Interfaces : 3

===============================================================================

ALA-1#

ALA-1# show router pim interface group 239.102.0.0 detail

===============================================================================

PIM Interface ip-10.111.1.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.111.1.1 Up Up 10.111.1.1 5 30

-------------------------------------------------------------------------------

PIM Group Source

-------------------------------------------------------------------------------

Group Address : 239.102.0.0 Src Address : *

Interface : ip-10.111.1.1 Type : <*,G>

RP Address : 239.200.200.4

Join Prune State : Join Expires : 0d 00:02:05

Prune Pend Expires : N/A

Assert State : No Info

-------------------------------------------------------------------------------

Interfaces : 1

===============================================================================

ALA-1#

ALA-1# show router pim interface type starg

===============================================================================

PIM Interface ip-10.111.1.1

===============================================================================

Interface Admin Oper DR DR Hello

State State Priority Intvl

-------------------------------------------------------------------------------

ip-10.111.1.1 Up Up 10.111.1.1 5 30

-------------------------------------------------------------------------------

Group Address Source Address RP Address Type JP Assert

-------------------------------------------------------------------------------

239.102.0.0 * 239.200.200.4 <*,G> Join No Info

239.102.0.1 * 239.200.200.4 <*,G> Join No Info

239.102.0.2 * 239.200.200.4 <*,G> Join No Info

239.102.0.3 * 239.200.200.4 <*,G> Join No Info

239.102.0.4 * 239.200.200.4 <*,G> Join No Info

239.102.0.5 * 239.200.200.4 <*,G> Join No Info

239.102.0.6 * 239.200.200.4 <*,G> Join No Info

239.102.0.7 * 239.200.200.4 <*,G> Join No Info

239.102.0.8 * 239.200.200.4 <*,G> Join No Info

239.102.0.9 * 239.200.200.4 <*,G> Join No Info

-------------------------------------------------------------------------------

Interfaces : 1

===============================================================================

ALA-1#

A:SetupCLI# show router pim interface detail

===============================================================================

PIM Interface ipv4 toRemoteSite_1001

===============================================================================

Admin Status : Up Oper Status : Up

IPv4 Admin Status : Up IPv4 Oper Status : Up

DR : 10.1.1.5

Oper DR Priority : 5

OperGroup : vrrp1_1 OprGrp Active oper : set

Cfg OprGrp Priority: 255

BSM RA Check : Disabled Cfg DR Priority : 1

Hello Interval : 30 Time for next hello: 0d 00:00:03

Multicast Senders : auto Hello Multiplier : 35

J/P Tracking Admin : Disabled J/P Tracking Oper : Disabled

Auto-created : No Improved Assert : Enabled

Sticky-DR : Disabled Sticky-DR Priority : N/A

Max Groups Allowed : 0 Max Groups Till Now: 0

Num Groups : 0 Bfd enabled : No

Three-way Hello : 0 Assert-Period : No

Instant Prune Echo : Disabled P2MP LDP Tree Join : Disabled

MCAC Policy Name : 0 MCAC Const Adm St : Enable

MCAC Max Unconst BW:no limit MCAC Max Mand BW : no limit

MCAC In use Mand BW: 0 MCAC Avail Mand BW : unlimited

MCAC In use Opnl BW: 0 MCAC Avail Opnl BW : unlimited

Use LAG port weight: no

MCAC If-Policy Name:

-------------------------------------------------------------------------------

Interfaces : 1 Tunnel-Interfaces : 0

===============================================================================

The following table provides PIM interface field descriptions.

Table 21: PIM Interface Fields

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.
OperGroup	Displays the OperGroup name associated with the PIM interface.
OprGrp Active oper	Displays the OperGroup operation (add, set, subtract) to the DR priority.
Cfg OprGrp Priority	Displays the configured OperGroup DR priority.

neighbor

Syntax

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

Context

show>router>pim

Description

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 ip-address parameter is not defined in this example, then the show command output would display two adjacencies.

Parameters

neighbor ip-int-name—

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

neighbor ip-address—

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

address ip-address—

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 a PIM neighbor configuration.

Sample Output

ALA-1# show router pim neighbor

===============================================================================

PIM Neighbors

===============================================================================

Interface Nbr DR Nbr Address Up Time Expiry Time Hold

Priority Time

-------------------------------------------------------------------------------

ip-10.1.7.1 5 10.1.7.7 0d 00:10:39 0d 00:01:36 105

ip-10.1.2.1 5 10.1.2.2 0d 00:10:39 0d 00:01:35 105

ip-10.111.1.1 3 10.111.1.2 0d 00:09:31 0d 00:01:15 105

-------------------------------------------------------------------------------

Neighbors : 3

===============================================================================

ALA-1#

*A:Dut-C# show router 100 pim neighbor ipv6

===============================================================================

PIM Neighbor ipv6

===============================================================================

Interface Nbr DR Prty Up Time Expiry Time Hold Time

Nbr Address

-------------------------------------------------------------------------------

vprn_itf_C_1100 1 0d 00:02:54 0d 00:01:43 105

ff00:db8:4403:1ff:fe01:2

mpls-if-74456(W) 1 0d 00:02:10 never 65535

ff00:db8:a14:104

mpls-if-74457(W) 1 0d 00:02:10 never 65535

ff00:db8:a14:105

mpls-virt-if-1030145 1 0d 00:02:44 never 65535

ff00:db8:a14:102

-------------------------------------------------------------------------------

Neighbors : 4

===============================================================================

ALA-1# show router pim neighbor detail

===============================================================================

PIM Neighbor

===============================================================================

Interface : ip-10.1.7.1

Neighbor Addr : 10.1.7.7 DR Priority : 5

Tracking Support : No LAN Delay(ms) : 500

Gen Id : 26470 Override Intvl(ms) : 2500

Up Time : 0d 00:10:41 Expiry Time : 0d 00:01:34

Hold Time(sec) : 105

===============================================================================

PIM Neighbor

===============================================================================

Interface : ip-10.1.2.1

Neighbor Addr : 10.1.2.2 DR Priority : 5

Tracking Support : No LAN Delay(ms) : 500

Gen Id : 37928 Override Intvl(ms) : 2500

Up Time : 0d 00:10:42 Expiry Time : 0d 00:01:33

Hold Time(sec) : 105

===============================================================================

PIM Neighbor

===============================================================================

Interface : ip-10.111.1.1

Neighbor Addr : 10.111.1.2 DR Priority : 3

Tracking Support : No LAN Delay(ms) : 500

Gen Id : 742098371 Override Intvl(ms) : 2500

Up Time : 0d 00:09:33 Expiry Time : 0d 00:01:43

Hold Time(sec) : 105

-------------------------------------------------------------------------------

Neighbors : 3

===============================================================================

ALA-1#

Table 22 provides PIM neighbor field descriptions.

Table 22: PIM Neighbor Fields

Label	Description
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.

rp

Syntax

rp ip-address

Context

show>router>pim

Description

This command displays the rendezvous point (RP) set information built by the router.

Parameters

ip-address —

Specifies the IP address of the RP.

Output

The following output is an example of a PIM RP configuration.

Sample Output

A:ALA-1# show router pim rp

==================================================================

PIM RP Set

==================================================================

Group Address RP Address Type Priority Holdtime

------------------------------------------------------------------

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#

A:ALA-1# show router pim rp 10.1.7.1

==================================================================

PIM RP Set

==================================================================

Group Address RP Address Type Priority Holdtime

------------------------------------------------------------------

224.0.0.0/4 10.1.7.1 Static 1 N/A

------------------------------------------------------------------

Group Prefixes : 1

==================================================================

A:ALA-1#

The following table provides PIM RP field descriptions.

Table 23: PIM RP Fields

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

Syntax

rp-hash grp-ip-address

Context

show>router>pim

Description

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

Parameters

grp-ip-address—

Displays specific multicast group addresses.

Output

The following output is an example of a PIM RP-Hash configuration.

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

The following table provides RP-Hash output field descriptions.

Table 24: RP-Hash Fields

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

Syntax

statistics [ip-int-name | mt-int-name | ip-address] [family]

Context

show>router>pim

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.

ip-address—

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

family—

Displays either IPv4 or IPv6 information.

Output

PIM Statistics Output

Sample output

A:ALA-1# show router pim statistics

=================================================================

PIM Statistics ipv4

=================================================================

Message Type Received Transmitted Rx Errors

-----------------------------------------------------------------

Hello 18009 12834 0

Join Prune 9135 1129 10

Core RPFV JP 0 0 0

MVPN RPFV JP 0 0 0

Asserts 0 0 0

Null Register 0 0 0

BSM 0 0 0

Candidate RP Adv 0 0 0

Auto-RP Announce 2049 0 0

Auto-RP Mapping 2066 0 0

PIM DM Grafts 0 0 0

PIM DM Graft Acks 0 0 0

Total Packets 31231 13963

-----------------------------------------------------------------

Intra-AS AD 0 0 0

Inter-AS AD 0 0 0

Mdt-Safi 1323 10 0

S-PMSI AD 0 0 0

Leaf AD 0 0 0

Source-Active AD 0 0 0

Shared Tree Join 0 0 0

Source Tree Join 0 0 0

Total BGP Packets 1323 10

-------------------------------------------------------------------------------

General Statistics

-------------------------------------------------------------------------------

Rx Invalid Register : 0

Rx Neighbor Unknown : 10

Rx Bad Checksum Discard : 0

Rx Bad Encoding : 0

Rx Bad Version Discard : 0

Rx CRP No Router Alert : 0

Rx BSM Router Alert Drops : 0

Rx BSM Wrong If Drops : 0

Rx Invalid Join Prune : 0

Rx Invalid Auto-RP PDU : 0

RPF Mismatch Auto-RP Mapping PDU : 65

RPF Mismatch Auto-RP Announce PDU : 80

Rx Unknown PDU Type : 0

Join Policy Drops : 0

Bootstrap Import Policy Drops : 0

Bootstrap Export Policy Drops : 0

Mcac Policy Drops : 0

Fwd Candidate RP Adv : 0

Fwd Candidate RP Adv Drops : 0

S-pmsi Join TLV PDUs txd. : 0

S-pmsi Join TLV PDUs rcd. : 0

S-pmsi Join TLV PDUs txd. Drops : 0

S-pmsi Join TLV PDUs rcd. Drops : 0

S-pmsi Maximum-P2mp-Spmsi Hits : 0

P2mp Pmsi Create Failures : 0

P2mp Pmsi Request Failures : 0

PDU Drops on Non-PIM/Down Intf : 0

Active Tx S-pmsis : 0

Active Tx MS-pmsis : 0

Active Rx S-pmsis : 0

Active Rx Pseudo S-pmsis : 0

Total Tx S-pmsis : 0

Total Rx S-pmsis : 0

-------------------------------------------------------------------------------

Source Group Statistics

-------------------------------------------------------------------------------

(S,G) : 2

(*,G) : 2

(*,*,RP) : 0

================================================================

Table 25: PIM Statistics Output Fields

Label	Description
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. Join Prune — Displays the number of PIM join prune messages received or transmitted. Asserts — Displays the number of PIM assert messages received or transmitted. Register — Displays the number of register messages received or transmitted. Null Register — Displays the number of PIM null register messages received or transmitted. Register Stop — Displays the number of PIM register stop messages received or transmitted. BSM — Displays the number of PIM Bootstrap messages (BSM) received or transmitted. Candidate RP Adv — Displays the number of candidate RP advertisements. Auto-RP Announce — Displays the number of auto-RP announce (224.0.1.39) messages received or transmitted. Auto-RP Mapping — Displays the number of auto-RP mapping (224.0.1.40) messages received or transmitted.
Message Type	PIM DM Grafts — Displays the number of PIM graft messages received or transmitted. PIM DM Graft Acks — Displays the number of PIM graft acknowledgment messages received or transmitted. Total Packets — Displays the total number of packets transmitted and received.
Received	Displays the number of messages received.
Transmitted	Displays the number of multicast data packets transmitted.
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.
Rx Neighbor Unknown	Displays the number of PIM messages (other than hello messages) which were received 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, and which were discarded because of bad checksum.
Rx Bad Encoding	Displays the number of PIM messages with bad encodings received.
Rx Bad Version Discard	Displays the number of PIM messages with bad versions received.
Rx CRP No Router Alert	Displays the number of candidate-rp advertisements (C-RP-Adv) received, and which had no router alert option set.
Rx Invalid Join Prune	Displays the number of invalid PIM join prune messages received.
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 that were dropped because of Bootstrap import policy.
Bootstrap Export Policy Drops	Displays the number of Bootstrap messages that were not transmitted 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).

The following table provides PIM statistics output field descriptions.

status

Syntax

status [detail] [family]

Context

show>router>pim

Description

This command displays PIM status. The Oper Status reflects the combined operational status of IPv4/IPv6 PIM protocol status. If both are down, then Oper Status will be reflected as down. If IPv4 or IPv6 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#

Parameters

detail—

Displays detailed status information.

family—

Displays either IPv4 or IPv6 information.

Output

The following output displays an example of a PIM status configuration.

Sample Output

A:dut-d# 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

Candidate RP

Admin State : Down

Oper State : Down

Address : 0.0.0.0

Priority : 192

Holdtime : 150

Auto-RP : Disabled

Multicast-Fast-Failover : Disabled

SSM-Default-Range : Enabled

SSM-Assert-Comp-Mode : Disabled

SSM-Group-Range

None

MC-ECMP-Hashing : Disabled

MC-ECMP-Hashing-Rebalance : Disabled

Enable-MDT-SPT : Disabled

Policy : None

RPF Table : rtable-u

Non-DR-Attract-Traffic : Disabled

Rpf-Vector : None

ESM : Disabled

===============================================================================

A:dut-d#

The following table provides PIM status output field descriptions.

Table 26: PIM Status Output Fields

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 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 OS.
Expiry Time	Displays the time remaining before the router sends the next Bootstrap message.
Auto-RP	Displays if auto-RP functionality is enabled or disabled.
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.

tunnel-interface

Syntax

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

Context

show>router>pim

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.

Values—

vprn-id-mt-grp-ip-address

int-ip-address—

Specifies the interface IPv4 or IPv6 address.

grp-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-list

Syntax

mvpn-list [type type] [auto-discovery auto-discovery] [signalling

signalling] [group group]

Context

show>router

Description

This command displays the list of multicast VPNs.

Parameters

type—

Specifies the MVPN type.

Values—

pim, rsvp, ldp

auto-discovery—

Specifies the auto-discovery mode.

Values—

none, default, mdt-s

signalling—

Specifies the signalling type.

Values—

bgp, pim

group—

Specifies the group address.

Output

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

Sample Output

*A:Dut-D# show router mvpn-list

Legend: Sig = Signal Pim-a = pim-asm Pim-s = pim-ssm A-D = Auto-Discovery

SR = Sender-Receiver SO = Sender-Only RO = Receiver-Only

===============================================================================

MVPN List

===============================================================================

VprnID A-D iPmsi/sPmsi GroupAddr/Lsp-Template IPv4(S,G)/(*,G)

Sig Mdt-Type IPv6(S,G)/(*,G)

-------------------------------------------------------------------------------

100 None Pim-a/None 239.100.201.101 0/0

Pim N/A 0/0

-------------------------------------------------------------------------------

Total Mvpns : 1

===============================================================================

Total PIM RSVP MLDP

-------------------------------------------------------------------------------

I-PMSI tunnels 1 0 0

TX S-PMSI tunnels 0 0 0

RX S-PMSI tunnels 0 0 0

RX PSEUDO S-PMSI tunnels 0 0 0

-------------------------------------------------------------------------------

Total IPv4 (S,G)/(*,G) : 0/0

Total IPv6 (S,G)/(*,G) : 0/0

===============================================================================

*A:Dut-D#

5.5.2.2. Clear Commands

database

Syntax

database [interface ip-int-name | mt-int-name | int-ip-address] [group grp-ip-address [source ip-address]] [family]

Context

clear>router>pim

Description

This command clears IGMP or PIM database statistics on a specified interface or IP address.

Parameters

ip-int-name—

Clears the IGMP or PIM database on the specified interface.

mt-int-name —

Clears the default core group address of the Multicast Distribution Tree (MDT) for the VPRN instance. The Multicast Tunnel (MT) interface for a VPRN is created when this object is set to a valid group address.

Syntax: vprn-id-mt-grp-ip-address

int-ip-address—

Clears the IGMP or PIM database on the specified IP address.

group-ip-address—

Clears the multicast group address (ipv4/ipv6) or zero in the specified address group.

ip-address—

Clears the IGMP or PIM database from the specified source IP address.

family—

Clears either IPv4 or IPv6 information.

mpls-if-name —

Clears the MPLS interface name.

Syntax: mpls-if-index

s-pmsi

Syntax

s-pmsi [mdSrcAddr] [mdGrpAddr] [vprnSrcAddr vprnGrpAddr]

Context

clear>router>pim

Description

This command clears PIM selective provider multicast service interface cache.

Parameters

mdSrcAddr—

Clears the specified source address used for Multicast Distribution Tree (MDT).

mdGrpAddr—

Clears the specified group address used for Multicast Distribution Tree (MDT).

vprnSrcAddr—

Clears the specified source address of the multicast sender.

vprnGrpAddr—

Clears the specified multicast group address.

statistics

Syntax

statistics [{[interface ip-int-name | ip-address | mt-int-name]} {[group grp-ip-address [source ip-address]]}] [family]]

Context

clear>router>pim

Description

This command clears PIM statistics on a specified interface or IP address.

Note:

An interface and group or source cannot be specified at the same time.

Parameters

ip-int-name—

Clears PIM statistics on the specified interface.

ip-address—

Clears PIM statistics on the specified IP address.

mt-int-name —

syntax: vprn-id-mt-grp-ip-address

grp-ip-address—

When only the group address is specified and no source is specified, (*,G) statistics are cleared. When the group address is specified along with the source address, then the (S,G) statistics are reset to zero.

ip-address—

When the source address is specified along with the group address, then the (S,G) statistics are reset to zero.

family—

Clears either IPv4 or IPv6 information.

neighbor

Syntax

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

Context

clear>router>pim

Description

This command clears PIM neighbor data on a specified interface or IP address.

Parameters

ip-int-name—

Clears PIM neighbor on the specified interface.

ip-address—

Clears PIM neighbor on the specified IP address.

family—

Clears either IPv4 or IPv6 information.

5.5.2.3. Debug Commands

adjacency

Syntax

[no] adjacency

Context

debug>router>pim

Description

This command enables/disables debugging for PIM adjacencies.

all

Syntax

all [group grp-ip-address] [source ip-address] [detail]

no all

Context

debug>router>pim

Description

This command enables/disables debugging for all the PIM modules.

Parameters

grp-ip-address—

Debugs information associated with all PIM modules.

Values—

IPv4 or IPv6 address

ip-address—

Debugs information associated with all PIM modules.

Values—

IPv4 or IPv6 address

detail—

Debugs detailed information on all PIM modules.

assert

Syntax

assert [group grp-ip-address] [source ip-address] [detail]

no assert

Context

debug>router>pim

Description

This command enables/disables debugging for PIM assert mechanism.

Parameters

grp-ip-address—

Debugs information associated with the PIM assert mechanism.

Values—

multicast group address (ipv4/ipv6)

ip-address—

Debugs information associated with the PIM assert mechanism.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed information on the PIM assert mechanism.

auto-rp

Syntax

auto-rp [detail]

no auto-rp

Context

debug>router>pim

Description

This command enables/disables debugging for PIM auto-RP.

Parameters

detail—

Debugs detailed information on the PIM auto-RP mechanism.

bgp

Syntax

bgp [source ip-address] [group group-ip-address] [peer peer-ip-address]

no bgp

Context

debug>router>pim

Description

This command enables/disables debugging for PIM/BGP specific interoperation.

Parameters

ip-address—

Debugs BGP information associated with the specified source.

Values—

source address (ipv4/ipv6)

group-ip-address—

Debugs BGP information associated with the specified group.

Values—

group address (ipv4/ipv6)

peer-ip-address—

Debugs BGP information associated with the specified peer.

Values—

peer address (ipv4/ipv6)

bsr

Syntax

bsr [detail]

no bsr

Context

debug>router>pim

Description

This command enables/disables debugging for the PIM bootstrap mechanism.

The no form of the command disables debugging.

Parameters

detail—

Debugs detailed information on the PIM bootstrap mechanism.

data

Syntax

data [group grp-ip-address] [source ip-address] [detail]

no data

Context

debug>router>pim

Description

This command enables/disables debugging for PIM data exception.

Parameters

grp-ip-address—

Debugs information associated with the specified data exception.

Values—

multicast group address (ipv4/ipv6)

ip-address—

Debugs information associated with the specified data exception.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed IP data exception information.

db

Syntax

db [group grp-ip-address] [source ip-address] [detail]

no db

Context

debug>router>pim

Description

This command enables/disables debugging for PIM database.

Parameters

grp-ip-address—

Debugs information associated with the specified database.

Values—

multicast group address (ipv4/ipv6) or zero

ip-address—

Debugs information associated with the specified database.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed IP database information.

dynmldp

Syntax

dynmldp [detail]

no dynmldp

Context

debug>router>pim

Description

This command enables/disables debugging for dynamic MLDP.

Parameters

detail—

Debugs detailed dynamic MLDP information.

extranet

Syntax

extranet [detail]

no extranet

Context

debug>router>pim

Description

This command enables/disables debugging for extranet PIM.

Parameters

detail—

Debugs detailed extranet PIM information.

grafts

Syntax

grafts [source ip-address] [group grp-ip-address] [detail]

no grafts

Context

debug>router>pim

Description

This command enables/disables debugging for PIM grafts.

Parameters

ip-address—

Debugs graft information associated with the specified source.

Values—

source address (ipv4/ipv6)

grp-ip-address—

Debugs graft information associated with the specified group.

Values—

multicast group address (ipv4/ipv6)

detail—

Debugs detailed graft information.

interface

Syntax

interface [ip-int-name | mt-int-name | ip-address] [detail]

no interface

Context

debug>router>pim

Description

This command enables/disables debugging for PIM interface information.

Parameters

ip-int-name—

Debugs the information associated with the specified IP interface name.

Values—

IPv4 or IPv6 interface address

mt-int-address—

Debugs the information associated with the specified VPRN ID and group address.

ip-address—

Debugs the information associated with the specified IP address.

detail—

Debugs detailed IP interface information.

jp

Syntax

jp [group grp-ip-address] [source ip-address] [detail]

no jp

Context

debug>router>pim

Description

This command enables/disables debugging for PIM join and prune mechanisms.

Parameters

grp-ip-address—

Debugs information associated with the specified Join-Prune mechanism.

Values—

multicast group address (ipv4/ipv6) or zero

ip-address—

Debugs information associated with the specified Join-Prune mechanism.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed Join-Prune mechanism information.

mofrr

Syntax

[no] mofrr

Context

debug>router>pim

Description

This command enables/disables debugging for PIM multicast fast failover.

mrib

Syntax

mrib [group grp-ip-address] [source ip-address] [detail]

no mrib

Context

debug>router>pim

Description

This command enables/disables debugging for PIM MRIB.

Parameters

grp-ip-address—

Debugs information associated with the specified PIM MRIB.

Values—

multicast group address (ipv4/ipv6)

ip-address—

Debugs information associated with the specified PIM MRIB.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed MRIB information.

msg

Syntax

msg [detail]

no msg

Context

debug>router>pim

Description

This command enables/disables debugging for PIM messaging.

Parameters

detail—

Debugs detailed messaging information.

mvpn-rtcache

Syntax

mvpn-rtcache [group grp-ip-address] [peer ip-address]

no mvpn-rtcache

Context

debug>router>pim

Description

This command enables/disables debugging for the PIM MVPN route cache.

Parameters

grp-ip-address—

Debugs information associated with the specified group.

Values—

multicast group address (ipv4/ipv6) or zero

peer-ip-address—

Debugs information associated with the specified peer.

Values—

peer address (ipv4/ipv6)

packet

Syntax

packet [hello | register | register-stop | jp | bsr | assert | crp | mdt-tlv | auto-rp-announcement | auto-rp-mapping | graft | graft-ack] [ip-int-name | mt-int-name | int-ip-address | mpls-if-name] [family {ipv4 | ipv6}] [send | receive]

no packet

Context

debug>router>pim

Description

This command enables/disables debugging for PIM packets.

Parameters

Specifies PIM packet types.

ip-int-name—

Debugs the information associated with the specified IP interface name, up to 32 characters.

mt-int-name—

Debugs the information associated with the specified VPRN ID and group address.

Values—

vprn-id-mt-grp-ip-address

int-ip-address—

Debugs the information associated with the specified IP address.

ipv4—

Specifies to display IPv4 packets.

ipv6—

Specifies to display IPv6 packets.

mpls-if-name—

Debugs the information associated with the specified MPLS interface.

Values—

mpls-if-index

receive—

Specifies to display received packets.

send—

Specifies to display sent packets.

red

Syntax

red [detail]

no red

Context

debug>router>pim

Description

This command enables/disables debugging for PIM redundancy messages to the standby CPM.

Parameters

detail—

Displays detailed redundancy information.

register

Syntax

no register

Context

debug>router>pim

Description

This command enables/disables debugging for PIM register mechanism.

Parameters

grp-ip-address—

Debugs information associated with the specified PIM register.

Values—

multicast group address (ipv4/ipv6)

ip-address—

Debugs information associated with the specified PIM register.

Values—

source address (ipv4/ipv6)

detail—

Debugs detailed register information.

rpfv

Syntax

rpfv [detail]

no rpfv

Context

debug>router>pim

Description

This command enables/disables debugging for PIM RPF vector.

Parameters

detail—

Debugs detailed RPF vector information.

rtm

Syntax

rtm [detail]

no rtm

Context

debug>router>pim

Description

This command enables/disables debugging for PIM RTM.

Parameters

detail—

Displays detailed RTM information.

s-pmsi

Syntax

s-pmsi [{vpnSrcAddr [vpnGrpAddr]} [mdSrcAddr]] [detail]

no s-pmsi

Context

debug>router>pim

Description

This command enables debugging for PIM selective provider multicast service interface.

The no form of the command disables the debugging.

Parameters

vpnSrcAddr—

Specifies the VPN source address.

vpnGrpAddr—

Specifies the VPN group address

mdSrcAddr—

Specifies the source address of the multicast domain.

detail—

Displays detailed information for selective PMSI.

tunnel-interface

Syntax

tunnel-interface [rsvp-p2mp lsp-name] [sender ip-address] [detail]

tunnel-interface [ldp-p2mp p2mp-id] [sender ip-address] [detail]

no tunnel-interface [rsvp-p2mp lsp-name] [sender ip-address]

no tunnel-interface [ldp-p2mp p2mp-id] [sender ip-address]

Context

debug>router>pim

Description

This command enables/disables debugging for PIM tunnel interfaces.

Parameters

lsp-name—

Specifies the LSP for RSVP P2MP.

ip-address—

Specifies the IP address of the sender.

p2mp-id—

Specifies the P2MP ID for LDP P2MP.

detail—

Displays detailed information for PIM tunnel interfaces.