Displaying PIM resources

To display the hardware resource information, such as hardware allocation, availability, and limit for software data structure, enter the show ip pim resource command.

device# show ip pim resource
Global PIM Parameters :- 
GLOBAL Ipv4 MULTICAST CLASS Size:16811 bytes
GLOBAL Ipv4 PIM CLASS Size:1065 bytes
MULTICAST IPV4 CLASS Num alloc:5, System max:129, Size:1228 bytes
PIM IPV4 CLASS  Num alloc:5, System max:129, Size:50440 
 Vrf Instance : default-vrf 
--------------------------------------
                      alloc in-use  avail get-fail    limit  get-mem  size init
NBR list                256      3    253        0      512        4    90  256
RP set list             256      4    252        0     1536     5032    43  256
Static RP                64      0     64        0       64        0    36   64
LIF Entry               512      0    512        0      512        0    41  512
Anycast RP               64      0     64        0       64        0   190   64
timer                   256      0    256        0    59392        4    64  256
prune                   128      0    128        0    29696        0    34  128
pimsm J/P elem         1024      0   1024        0    48960     1258    29 1024
Timer Data              256      1    255        0    59392        2    28  256
mcache SLIB Sync        280      0    280        0    64960       20    28  280
mcache                   56      2     54        0    12992        2   796   56
graft if no mcache      197      0    197        0    45704        0    64  197
HW replic vlan         2000      3   1997        0   464000        4    66 2000
HW replic port         1024      3   1021        0   237568        4    78 1024
pim/dvm intf. group     256      0    256        0    59392        0    24  256
pim/dvm global group    256      2    254        0    59392        2    46  256
repl entry(Global)     1024      0   1024        0   237568        4    43 1024
IGMP Resources(All Vrfs):
  groups                256      2    254        0     4096        2   210  256
  group-memberships     256      2    254        0     4096        2   142  256
  sources                56      1     55        0    12992      606    59   56
  client sources         56      0     56        0    12992        0    81   56
  ssm-map               256      0    256        0      256        0    18  256
  ssm-map-sources       256      0    256        0    59392        0  1024  256
Hardware-related Resources:
Total (S,G) entries 1
Total SW FWD entries 0
  Total sw w/Tag MVID entries 0
  Total sw w/Tag invalid MVID entries 0
Total HW FWD entries 1
  Total hw w/Tag MVID entries 0
  Total hw w/Tag invalid MVID entries 0

Syntax: show ip pim [all-vrf | [ vrf vrf-name ] ] resource

The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable.

The following table displays the output from the show ip pim resource command.

Table 3 Output from the show ip pim resource command

Field

Description

Num alloc

Number of VRF instances allocated.

System max

Maximum number of VRFs allowed in the system.

Size

Size of one instance of the resource in bytes.

alloc

Number of nodes of that data that are currently allocated in memory.

in-use

Number of allocated nodes in use.

avail

Number of allocated nodes are not in use.

get-fail

Number of allocation failures for this node.

limit

Maximum number of nodes that can be allocated for a data structure. This may or may not be configurable, depending on the data structure

get-mem

Number of successful allocations for this node.

size

Size of the node in bytes.

init

Number of nodes that are allocated during initialization time.

To display usage and fail-count information for SG entries on each VRF, use the show ip pim all-vrf hw-resource command.

device# show ip pim all-vrf hw-resource
              VRF  Usage     Fail
       default-vrf   3072        8
              blue   3072        0
   -------------------------------
       Total usage   6144
 
   System-max limit for SG entries: 6144

Syntax: show ip pim [all-vrf | [ vrf vrf-name ] ] hw-resource

The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable.

The following table displays the output from the show ip pim all-vrf hw-resource command.

Table 4 Output from the show ip pim all-vrf hw-resource command

Field

Description

VRF

Name of the VRF.

Usage

Number of allocated SG entries in this VRF.

Fail

Number of failures while allocating SG entries in this VRF (due to the system-max limit.

Total usage

Total number of SG entries in the system (all VRFs).

System-max limit for SG entries

Configured system limit for pim-hw-mcache.