show ip mroute hw-resource-usage

View multicast hardware resource usage. The range of values depends on the hardware platform.

Syntax

show ip mroute hw-resource-usage
show ip mroute hw-resource-usage vrf WORD<1-16>
show ip mroute hw-resource-usage vrf WORD<1-32>
show ip mroute hw-resource-usage vrfids WORD<0-255>
show ip mroute hw-resource-usage vrfids WORD<0-512>

Command Parameters

vrf WORD<1-32> | vrf WORD<1-16>: Specifies a VRF by name. Range depends on hardware platform.
vrfids WORD <0-255> | vrfids WORD <0-512>: Specifies a VRF by ID. Range depends on hardware platform.

Default

None

Command Mode

User EXEC

Usage Guidelines

This command is not supported on a node configured as the DvR Leaf within a DvR domain.

Command Output

The show ip mroute hw-resource-usage command displays the following information:


Output field	Description
EGRESS REC IN-USE	Displays the number of egress records traversing the switch.
INGRESS REC IN-USE	Displays the number of ingress records (source or group) traversing the switch.
EGRESS THRESHOLD	Displays the configured egress threshold level. A notification message is sent if this value is exceeded. The default is 0.
INGRESS THRESHOLD	Displays the configured ingress threshold level. A notification message is sent if this value is exceeded. The default is 0.
LOG MSG ONLY	Displays whether only log notification messages are sent after the threshold level is exceeded. The default is false (disabled).
SEND TRAP ONLY	Displays whether only trap notification messages are sent after the threshold level is exceeded. The default is false (disabled).
SENT TRAP AND LOG	Displays whether both trap and log notification messages are sent after the threshold level is exceeded. The default is false (disabled).

Example

The following example displays the hardware resource usage.

Switch:1>show ip mroute hw-resource-usage
================================================================================
                       Multicast Hardware Resource Usage
================================================================================
EGRESS      INGRESS     EGRESS      INGRESS     LOG MSG   SEND TRAP  SEND TRAP

REC IN-USE  REC IN-USE  THRESHOLD   THRESHOLD   ONLY      ONLY       AND LOG

--------------------------------------------------------------------------------
0           0           0           0           false     false      false