show ip pim mcache

Displays the PIM multicast cache.
Syntax
show ip pim mcache [ source-address [ group-address ] | group-address | counts | dense | dit-idx dit-idx | g_entries | receiver { ethernet unit/slot/port | lag number | vlan vlan-id } | sg_entries | sparse | ssm ]
show ip pim mcache counts [ source-address [ group-address ] | group-address | dense | dit-idx dit-idx | g_entries | receiver { ethernet unit/slot/port | lag number | vlan vlan-id } | sg_entries | sparse | ssm ]
Parameters
source-address
Specifies the multicast cache source address.
group-address
Specifies the multicast cache group address.
counts
Specifies the number of entries.
dense
Specifies displaying only the PIM Dense Mode entries.
dit-idx dit-idx
Specifies displaying all entries that match a specified downstream interface (DIT).
g_entries
Specifies displaying only the (*, G) entries.
receiver
Specifies displaying all entries that egress a specified interface.
ethernet unit/slot/port
Specifies a physical interface. On standalone devices specify the interface ID in the format slot/port-id; on stacked devices you must also specify the stack ID, in the format stack-id/slot/port-id.
lag number
Specifies a LAG interface.
vlan vlan-id
Specifies a VLAN.
sg_entries
Specifies displaying only the (S, G) entries.
sparse
Specifies displaying only the PIM Sparse Mode entries.
ssm
Specifies displaying only the SSM entries.
Modes

Privileged EXEC mode

The show ip pim mcache command displays the following information:

Output Field

Description

Total entries in mcache

The total number of PIM mcache entries

MJ

Membership Join

MI

Membership Include

ME

Membership Exclude - Legend for the mcache entry printed once per page, it gives the explanation of each of the flags used in the entry.

BR

Blocked RPT

BA

Blocked Assert

BF

Blocked Filter

BI

Blocked IIF

Uptime

Shows the entry uptime

upstream neighbor

Shows the upstream neighbor for the Source/RP based on the type of entry. For (*,G) it shows the upstream neighbor towards the RP. For (S,G) entries it shows the upstream neighbor towards the source.

Flags

Flags Represent Entry flags in hex format in the braces. And indicates the meaning of the flags set in the abbreviated strings with the following explanations. Only shows the flags which are set.

SM - Shows If the entry is created by PIM Sparse Mode

DM - Shows If DM mode entry is enabled

SSM - Shows If the SSM mode entry is enabled

RPT - Shows If the entry is on the rendezvous point (RP)

SPT - Shows If the entry is on the source tree

LSRC - Shows If the source is in a directly-connected interface

LRcv - Shows If the receiver is directly connected to the router

REG - if the data registration is in progress

L2REG - if the source is directly connected to the router

REGSUPP - if the register suppression timer is running

RegProbe

HW - Shows If the candidate for hardware forwarding is enabled

FAST - Shows If the resources are allocated for hardware forwarding

TAG - Shows If there is a need for allocating entries from the replication table

MSDPADV - Shows If RP is responsible for the source and must be advertised to its peers.

NEEDRTE - Shows If there is no route to the source and RP is available

PRUNE - Shows If PIM DM Prune to upstream is required

RP

Shows the IP address of the RP.

fast ports

Shows forwarding port mask.

AgeSltMsk

Shows a value of 1 if the entry is programmed in hardware, and a value of 0 if it is not programmed in hardware.

L2 FID

Shows the hardware resource allocated for the traffic switched to receivers in the ingress VLAN.

DIT

Shows the hardware resource allocated for routed receivers.

RegPkt

Shows Count of Packets forwarded due to the Register decapsulation.

Number of matching entries

Shows the total number of mcache entries matching a particular multicast filter specified.

Outgoing interfaces Section

This section consists of three parts. L3 OIFs, L2OIFs and Blocked OIFs. And each section has Format of L3/L2/Blocked followed by (HW/SW) followed by count of the number of OIF in each section.

Additionally, each section displays the OIFs one per line. And shows the OIF in the format eth/Tr(Vlan) followed by uptime/expiry time, followed by the Flags associated with each OIF.

L3

Shows whether the traffic is routed out of the interface.

L2

Shows whether the traffic is switched out of the interface.

HW

Shows whether the entry is hardware forwarded.

SW

Shows whether the entry is software forwarded

Eth/Tr(VL1)

Shows the outgoing interface on the specified VLAN.

Flags (explanation of flags in the OIF section)

Shows the flags set in each of the Outgoing interface in the abbreviated strings with the following explanations. Legend of this shown at the top of each entry

IM - Immediate

IH - Inherited

MJ - Membership Join

MI - Membership Include

ME - Membership Exclude

BR - Blocked due to SG RPT

BA - Blocked due to Assert

BF - Blocked due to Filter

BI - Blocked IIF (Incoming interface) matches OIF

Src-Vlan

Shows the VLAN associated with the ingress interface.

MCTPEERF - Traffic Forw By Cluster Peer CCEP

Applies only to Layer 3 multicast routing over MCT. This means multicast traffic for this stream is forwarded by cluster peer [remote] CCEP port because of flow load balancing

Examples

The following example shows all PIM multicast cache entries. 

device> show ip pim mcache

IP Multicast Mcache Table
Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode
       RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver
       HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For 
        Replication Entry
       REGPROB - Register In Progress, REGSUPP - Register Suppression Timer
       MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM 
        Prune Upstream
Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert
       MJ - Membership Join, MI - Membership Include, ME - Membership Exclude
       BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF
Total entries in mcache: 20
1  (140.140.140.3, 225.0.0.1) in v340 (tag e1/8/1), Uptime 00:00:02 
  Source is directly connected
  Flags (0x200004e1) DM HW FAST TAG
  fast ports: ethe 1/4/6 ethe 1/8/26
  AgeSltMsk: 1, L2 FID: 8188, DIT: 3 
  Forwarding_oif: 2
  L3 (HW) 2:
    TR(e1/4/6,e1/4/6)(VL330), 00:00:02/0, Flags: IM
    e1/8/26(VL310), 00:00:02/0, Flags: IM 
  Src-Vlan: 340

The following example shows the PIM multicast cache for the specified address. 

device> show ip pim mcache 10.140.140.14 230.1.1.9

IP Multicast Mcache Table
Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode
     RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver
     HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry
     REGPROB - Register In Progress, REGSUPP - Register Suppression Timer
     MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM Prune Upstream
Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert
     MJ - Membership Join, MI - Membership Include, ME - Membership Exclude
     BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF
Total entries in mcache: 20
1 (10.140.140.14, 230.1.1.9) in v1001 (tag e1/4/29), Uptime 00:03:12
  upstream neighbor 10.11.11.13
  Flags (0x600680e1) SM SPT LRCV HW FAST TAG
  fast ports: ethe 1/4/29 ethe 1/5/2
  AgeSltMsk: 1, L2 FID: 8188, DIT: 8 
  Forwarding_oif: 3, Immediate_oif: 0, Blocked_oif: 0
  L3 (HW) 2:
  e1/4/29(VL13), 00:03:12/0, Flags: MJ
  e1/5/2(VL1004), 00:03:12/0, Flags: MJ
  L2 (HW) 1:
  e1/5/2, 00:00:07/0, Flags: MJ
  L2 MASK: ethe 1/5/2
  Src-Vlan: 1001

The following example shows the PIM multicast cache for the specified DIT. 

device> show ip pim mcache dit-idx 2

IP Multicast Mcache Table 
Entry Flags    : SM  - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode 
                 RPT    - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver 
                 HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry 
                 REGPROB - Register In Progress, REGSUPP - Register Suppression Timer 
                 MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP,  PRUN - DM Prune Upstream 
Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert 
                 MJ - Membership Join, MI - Membership Include, ME - Membership Exclude 
                 BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF 
Total entries in mcache: 30
1     (20.20.20.100, 225.1.1.1) in v220 (tag e1/1/13), Uptime 07:12:07
      upstream neighbor 220.220.220.1
      Flags (0x200680e1) SM SPT LRCV HW FAST TAG
      fast ports: ethe 1/1/11 
      AgeSltMsk: 1,  IPMC:   414 , RegPkt: 0 
      Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 
      L3 (HW) 1: 
          e1/1/11(VL40), 07:12:07/0, Flags: MJ
      Src-Vlan: 220
2     (20.20.20.100, 225.1.1.2) in v220 (tag e1/1/13), Uptime 00:01:00
      upstream neighbor 220.220.220.1                             
      Flags (0x200680e1) SM SPT LRCV HW FAST TAG
      fast ports: ethe 1/1/11 
      AgeSltMsk: 1, IPMC:   414 , RegPkt: 0
      Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 
      L3 (HW) 1: 
          e1/1/11(VL40), 00:01:00/0, Flags: MJ
      Src-Vlan: 220
3     (20.20.20.100, 225.1.1.3) in v220 (tag e1/1/13), Uptime 00:01:00
      upstream neighbor 220.220.220.1
      Flags (0x200680e1) SM SPT LRCV HW FAST TAG
      fast ports: ethe 1/1/11 
      AgeSltMsk: 1, IPMC:   414 , RegPkt: 0
      Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 
      L3 (HW) 1: 
          e1/1/11(VL40), 00:01:00/0, Flags: MJ
      Src-Vlan: 220

The following example shows the PIM multicast cache with Layer 3 multicast routing over MCT, showing that multicast traffic for a stream is forwarded by a cluster peer CCEP port because of flow load balancing. 

device> show ip pim mcache

IP Multicast Mcache Table
Entry Flags    : SM  - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode
                 RPT    - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver
                 HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry
                 REGPROB - Register In Progress, REGSUPP - Register Suppression Timer
                 MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP,  PRUN - DM Prune Upstream
Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert, MCTPEERF - Traffic Forw By Cluster Peer CCEP
                 MJ - Membership Join, MI - Membership Include, ME - Membership Exclude
                 BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF
Total entries in mcache: 2

1     (39.39.39.1, 229.1.1.10) in v40 (tag e2/1/12), Uptime 00:21:31
      upstream neighbor 40.40.40.175
      Flags (0x200284e1) SM SPT HW FAST TAG
      fast ports: ethe 2/1/11
      AgeSltMsk: 1, IPMC:     4 
      Forwarding_oif: 1, Immediate_oif: 1, Blocked_oif: 0
      L3 (HW) 1:
          TR(e2/1/11,e2/1/11)(VL10), 00:21:31/178, Flags: IM  MCTPEERF
      Src-Vlan:   40
History
Release version Command history
08.0.30 This command was modified to show output for Layer 3 multicast routing over MCT.
08.0.30h The output of the command was modified to remove the rate counter.
08.0.50 The output of the command was modified to remove the AvgRate and Profile entries.
Parent topic: Show Commands