Cisco ASR 9000 Series Aggregation Services Router Advanced System Command Reference, Release 4.2.x
ASIC Driver Commands
Downloads: This chapterpdf (PDF - 1.36MB) The complete bookPDF (PDF - 3.4MB) | Feedback

ASIC Driver Commands

ASIC Driver Commands

This module describes the commands used to configure and monitor the application-specific integrated circuit (ASIC) driver on a router running Cisco IOS XR software.

clear controller fabric

To clear the fabric ASIC statistics for the specified fabric plane or all planes, use the clear controller fabric command in EXEC or administration EXEC mode.

clear controller fabric { fia | crossbar-counters } location node-id

Syntax Description

fia

clears fabric counter details.

crossbar-counters

clears crossbar counters for a slot.

location node-id

Node ID.The node-id argument is expressed in the rack/slot/module notation.

Note   

Use the show platform command to see the location of all nodes installed in the router.

Command Default

No default behavior or values.

Command Modes

EXEC, Administrator EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

Task ID

Task ID

Operations

drivers

read, write

Examples

The following example shows how to use the clear controller fabric command:

RP/0/RSP0/CPU0:router# clear controllers fabric fia location cpu/1/0

RP/0/RSP0/CPU0:router# clear controller fabric crossbar-counters spine 0

show controllers egressq queue

To display information about a specific egress queue, or a range of egress queues, use the show controllers egressq queue command in EXEC mode.

show controllers egressq queue { queue1 [queue2] | from-group { group-id | all } | from-interface { type instance | all } | from-port { port-id | all } | limits { max | min } | all } location node-id

Syntax Description

queue1

Identifies the first port whose egress queue information you want to display. Replace the queue1 argument with a queue identifier. Range is from 1 through 8191.

queue2

(Optional) Identifies the last port whose egress queue information you want to display. Replace the queue2 argument with a queue identifier. Range is from 1 through 8191.

from-group group-id

Displays egress queue information for a specific port group. Replace the group-id argument with the number that identifies the port group whose information is to be displayed. Range is from 1 through 2047.

from-group all

Displays egress queue information for all port groups on the specified location.

from-interface type instance

Displays egress queue information for a specific interface. Replace the type instance argument with a physical interface ID or a virtual interface ID.

Note   

Use the show interfaces command to see a list of all possible interfaces currently configured on the router.

from-interface all

Displays egress queue information for all interfaces on the specified location.

from-port port-id

Displays egress queue information for a specific port. Replace the port-id argument with a port ID. Range is from 0 to 1023.

from-port all

Displays egress queue information for all ports on the specified location.

limits max

Displays the maximum limits table.

limits min

Displays the minimum limits table.

all

Displays detailed information about all egress queues on the specified location.

location node-id

Identifies the location of the node whose egress queue information you want to display. The node-id argument is expressed in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.5.0

The context keyword and max_elements argument were removed from the show controllers egressq queue command.

The following keywords and arguments were added to the show controllers egressq queue command:

  • from-group { group-id | all }
  • from-interface { type instance | all }
  • from-port { port-id | all}

Usage Guidelines

Task ID

Task ID

Operations

drivers

read

interface

read

Examples

The following example shows how to display information about egress queues 1 and 2 on the CPU node in slot 2:

RP/0/RSP0/CPU0:router# show controllers egressq queue 1 2 location 0/2/CPU0
----------------------------------
          Queue 1
----------------------------------
 Group                 : 1
 Priority              : Low
 Max LB Tokens         : 7812
 Max LB Limit Index    : 38
 Min LB Tokens         : 0
 Min LB Limit Index    : 0
 Quantum               : 27
 Instantaneous length  : 0
 Length high watermark : 0
----------------------------------
----------------------------------
          Queue 2
----------------------------------
 Group                 : 2
 Priority              : Low
 Max LB Tokens         : 7812
 Max LB Limit Index    : 38
 Min LB Tokens         : 0
 Min LB Limit Index    : 0
 Quantum               : 27
 Instantaneous length  : 0
 Length high watermark : 0
  

This table describes the significant fields shown in the display.



Table 1  show controllers egressq queue Field Descriptions

Field

Description

Group

Group identifier.

Priority

Group priority.

Max LB Tokens

Maximum number of port LB tokens.

Max LB Limit Index

Maximum LB limit.

Min LB Tokens

Minimum number of port LB tokens.

Min LB Limit Index

Minimum LB limit.

Quantum

Quantum value for this queue.

Instantaneous length

Egress queue instantaneous length.

Length high watermark

Length high watermark register.

show controller fabric

To display the fabric ASIC statistics for the specified fabric plane or for all planes, use the show controller fabric command in EXEC or administration EXEC mode.

show controller fabric { arbiter | crossbar } { readreg asic-offset instance module-instance | serdes location node-id instance module-instance | configstatus location node-id instance module-instance }

Syntax Description

arbiter

Displays arbitration ASIC show screens.

crossbar

Displays crossbar ASIC show screens.

readreg

Displays read fabric ASIC register.

configstatus

Displays fabric ASIC configuration status.

serdes

Displays fabric serializer-deserializer interface status.

asic-offset

Asic offset ; range is 0 to 4294967295.

instance module-instance

Module instance; range is from 0 to 4.

location node-i

Node ID. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values.

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

Task ID

Task ID

Operations

drivers

read

Examples

The following example shows how to display the internal trace information of Egressq for a specific controller instance:

RP/0/RSP0/CPU0:router# show controllers fabric crossbar serdes instance 1 location 0/1/cpu0

  Location: 0/RSP0/CPU0 (physical slot 4)
  Asic Instance: 1
  Asic slot: 1

inst_num       12
usr_data_p     0x50064ce8
state          unused
encoding       EFCP
mode           normal

GLOBAL_CONTROL_0                0006
  ENABLE_NE_ENCODING            enabled
LOOPBACK_CONTROL                0000
  NEAR_LOOPBACK                 disabled
RX_CHAN_CONTROL_0               0850
  SERDES_RATE                   20Gbps
  SERDES_ENABLE                 enabled
  PARALLEL_BUS_ENABLE           enabled
  SW_RX_RESET                   disabled
RX_CHAN_FEATURE_CONTROL         0528
  ENABLE_SHORT_QUEUE            disabled
  ENABLE_START_TO_RATE          enabled
RX_SOFT_SYNC_CNTL               0600
  RX_SOFT_SYNC_CODE_BYPASS_EN   disabled

CHAN_STATUS                     0003
  RX_SERIAL_CHANNEL_OK          1
  SERIAL_CHANNEL_OK             1
  NE_SYNC_STATUS                00

SERIAL LINK                     0  1  2  3  4  5  6  7
                               -- -- -- -- -- -- -- --
SERDES_RX_PLL_LOCKED            1  1  1  1  1  1  1  1 
PRBS_FAIL                       0  0  0  0  0  0  0  0 

CHAN_INT_STATUS_0               0000
CHAN_INT_MASK_0                 01ff
RX_CHANNEL_REALIGN_STATUS       0
RX_CHANNEL_REALIGN_MASK         1

SERIAL LINK                     0  1  2  3  4  5  6  7
                               -- -- -- -- -- -- -- --
LINK_INTR_STATUS                0  0  0  0  0  0  0  0 
LINK_INTR_MASK                  1  1  1  1  1  1  1  1 
SOURCE_INTR_MASK               00 00 00 00 00 00 00 00 
          
inst_num     12
usr_data_p   0x50064ce8
state        unused
stats_p      0x500729c8
intr_stats_p 0x50072a90

inst_num     12
usr_data_p   0x50064cfc
state        unused

auto_sync        supported
reg_read_fn      0x40012174
reg_write_fn     0x40011c60
process_intr_fn  0x40043910
dev_id           70
ser_drv_cntl_a   0x9bffd670

RP/0/RSP0/CPU0:router#  show controllers fabric crossbar link-status instance 0 spine 0

PORT    Remote Slot  Remote Inst    Logical ID  Status
======================================================
05        04               00             1        Up
10        04               00             0        Up
15        11               00             0        Up
17        11               00             1        Up
18        01               00             0        Up
19        00               00             0        Up
20        06               00             1        Up
24        06               00             0        Up


show controllers np counters

To display a network processor's counter statistics, use the show controllers np counters command in EXEC mode.

show controllers np counters { all | npn } [ location node-id ] [ file send-to ]

Syntax Description

all

Specifies all network processor (NP) instances.

npn

Specifies NP counter instance. Replace the argument n with the NP instance number.

location node-id

(Optional) Specifies a fully-qualified line card location. The node-id argument is entered in the rack/slot/module notation.

file send-to

(Optional) Specifies that the command output is saved in a specified file.

These are the valid options for the send-to argument :
  • filename
  • bootflash:
  • disk0:
  • disk0a:
  • disk1:
  • disk1a:
  • ftp:
  • harddisk:
  • harddiska:
  • harddiskb:
  • lcdisk0:
  • lcdisk0a:
  • nvram:
  • rcp:
  • tftp:

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

Use the show controller np ports all location node-id command to check NP-to-interface mapping.

The output of the show controllers np counters command displays the names of internal NP counters. These names appear in the format <stage>_<direction>_<action>_CNT. For example, PARSE_INGRESS_DROP_CNT, PARSE_EGRESS_PUNT_CNT and RESOLVE_EGRESS_DROP_CNT.

To view a complete list of NP counters, use the show controllers np description command in EXEC mode.

Task ID

Task ID Operation

interface

read

drivers

read

Examples

This example shows statistics for the NP counter instance 1 (np1) at the specified location:

RP/0/RSP0/CPU0:router# show controllers np counters np1 location 0/7/cpu0

                               Node: 0/7/CPU0:
----------------------------------------------------------------

Show global stats counters for NP1, revision v3

Read 30 non-zero NP counters:
Offset  Counter                                         FrameValue   Rate (pps)
-------------------------------------------------------------------------------
  22  PARSE_ENET_RECEIVE_CNT                                 51047           1
  23  PARSE_FABRIC_RECEIVE_CNT                               35826           0
  30  MODIFY_ENET_TRANSMIT_CNT                               36677           0
  31  PARSE_INGRESS_DROP_CNT                                     1           0
  34  RESOLVE_EGRESS_DROP_CNT                                  628           0
  40  PARSE_INGRESS_PUNT_CNT                                  3015           0
  41  PARSE_EGRESS_PUNT_CNT                                    222           0
  

show controllers plim asic SPAQFPBridgeCtrl

To display physical layer interface module (PLIM) asic Shared Port Adapter Quantum Flow Processor bridge control (SPAQFPBridgeCtrl) driver information, use the show controllers plim asic SPAQFPBridgeCtrl command in EXEC mode.

show controllers plim asic SPAQFPBridgeCtrl { counters | ingress-channel | egress-channel | spa }

Syntax Description

counters

Displays information regarding the counters.

ingress-channel

Displays information regarding the receiving SPI4.2 channel.

egress-channel

Displays information regarding the transmitting SPI4.2 channel.

spa

Displays SPA (Shared Port Adapters) information.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 4.0.0

This command was introduced.

Usage Guidelines

Task ID

Task ID

Operations

interface

read

root-system

read

Examples

The following example shows how to display summarized PLIM ASIC SPAQFPBridgeCtrl driver information:

RP/0/RP00/CPU0router# show controllers plim asic SPAQFPBridgeCtr
l

show controllers pse qfp statistics

To display packet switching engine (PSE) quad flat package (QFP) statistics for a specific node, use the show controllers pse qfp statistics command in EXEC mode.

show controllers pse qfp statistics [ drop | summary ] [ location node-id ]

Syntax Description

drop

(Optional) Displays the global drop statistics for the PSE QFP device.

Note   

Follow the drop keyword with the location node-id keyword and argument to restrict the command to a specific node.

summary

(Optional) Displays the global statistics summary for the PSE QFP device.

Note   

Follow the summary keyword with the location node-id keyword and argument to restrict the command to a specific node.

location node-id

(Optional) Identifies the location of the node whose PSE device information you want to display. The node-id argument is expressed in the rack/slot/module notation.

Note   

Use the show platform command to see the location of all nodes installed in the router.

Command Default

None.

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

Task ID

Task ID

Operations

interface

read

cisco-support

read

Examples

The following command shows how to display PSE QFP statistics:

RP/0/RSP0/CPU0:router# show controllers pse qfp statistics summary location 0/1/cpu0

Summary of Statistics for QFP 0
    Dropped packets: 0
    Incoming packets: 0
    Outgoing packets: 0
    Incoming IPC packets: 0
    Outgoing IPC packets: 0
    Punted packets: 0
    Injected packets: 0

Summary of Statistics for QFP 1
    Dropped packets: 0
    Incoming packets: 0
    Outgoing packets: 0
    Incoming IPC packets: 0
    Outgoing IPC packets: 0
    Punted packets: 0
    Injected packets: 0

show controllers pse qfp system state

To display packet switching engine (PSE) QFP HA state information for a specific node, use the show controllers pse qfp system state command in EXEC mode.

show controllers pse qfp system state [ location node-id ]

Syntax Description

location node-id

(Optional) Identifies the location of the node whose PSE device information you want to display. The node-id argument is expressed in the rack/slot/module notation.

Note   

Use the show platform command to see the location of all nodes installed in the router.

Command Default

None.

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

Task ID

Task ID

Operations

interface

read

cisco-support

read

Examples

The following command shows how to run the show controllers pse qfp system state command:

RP/0/RSP0/CPU0:router# show controllers pse qfp system state location 0/1/cpu0
  

show packet-memory

To display information for packet memory, use the show packet-memory command in EXEC mode.

show packet-memory [ clients | corrupt | failures | hssd | ifinput | ifoutput | internal | inuse | job | mutex | old | reserved | summary | trace | watch ] [ location node-id ]

Syntax Description

clients

(Optional) Displays the packet manager clients.

corrupt

(Optional) Displays the information about corrupted packets.

failures

(Optional) Displays the packet buffer, header, hardware buffer allocation failures.

hssd

(Optional) Displays High Speed Small Data (HSSD).

ifinput

(Optional) Displays packets from a specific interface.

ifoutput

(Optional) Displays packets to a specific interface.

internal

(Optional) Displays the packet memory along with actual number of particles in free list.

inuse

(Optional) Displays the total number of packets in use

job

(Optional) Displays the number of packets owned by a specific process.

mutex

(Optional) Displays the pakman mutex monitoring configuration.

old

(Optional) Displays the total number of packets older than one minute.

reserved

(Optional) Displays the reserved memory information.

summary

(Optional) Displays the packet memory usage summary information.

trace

(Optional) Displays the packet-memory traces.

watch

(Optional) Displays the pakman watch configuration.

location node-id

(Optional) Displays detailed packet memory information for the designated node. The node-id argument is entered in the rack/slot/module notation.

Command Default

Displays information about all packet memory.

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

Included the following keywords:

  • clients
  • corrupt
  • failures
  • fsv
  • hssd
  • ifinput
  • ifoutput
  • internal
  • inuse
  • job
  • mutex
  • old
  • reserved
  • summary
  • trace
  • watch

Usage Guidelines

The show packet-memory command can be used to display the total number of packet and particle headers, along with the packet memory that is currently allocated in the system.

Task ID

Task ID

Operations

basic-services

read

Examples

The following example shows how to display packet memory information:

RP/0/RSP0/CPU0:router# show packet-memory 

Packet memory statistics : 
==========================
Packet headers 
total: 32000, free: 32000, size: 448
Particle Pools(8) 
Pool(0):total: 8000, free: 8000, size: 256 
fallback: 0, region: 0 
Pool(1):total: 4000, free: 3968, size: 512 
fallback: 1, region: 0 
Pool(2):total: 16, free: 16, size: 512 
fallback: 2, region: 0 
Pool(3):total: 8000, free: 7936, size: 768 
fallback: 3, region: 0 
Pool(4):total: 12800, free: 9172, size: 1648 
fallback: 4, region: 0 
Pool(5):total: 320, free: 320, size: 2560 
fallback: 5, region: 0 
Pool(6):total: 1600, free: 1088, size: 4608 
fallback: 6, region: 0 
Pool(7):total: 640, free: 640, size: 6240 
fallback: 7, region: 0
Particle clone 
total: 8000, free: 8000, size: 256
Packet Feature Specific Variable (FSV) 
total: 16000, free: 16000, size: 88
Packet trace 
total: 16384, free: 16384, size: 40
  

This table describes the significant fields shown in the display.



Table 2 show packet memory Field Descriptions

Field

Description

Packet headers

Data structure that defines and controls an aggregation of data structures, collectively known as a packet. Includes information about every packet in the system.

Particle Pools

Data structure that describes a particle and may be chained to other particles in a linked list. Includes information about the actual data of the packet and other particle headers in this packet if present in this packet.

Particle clone

Duplicate particle header that points to a previously allocated particle. Differs from a particle header in that a particle clone shares the particle with another particle header.

Packet Feature Specific Variable (FSV)

Scratch pad shared among the features in the packet path, listing hangs of the packet header.

Packet trace

Data associated with the packet header to help tracing a packet in the system.