Cisco ASR 9000 Series Aggregation Services Router Advanced System Command Reference, Release 4.3.x
ASIC Driver Commands
Downloads: This chapterpdf (PDF - 1.27MB) The complete bookPDF (PDF - 3.73MB) | 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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

controller pse tcam location

To configure the compression ipv6 anchor prefix for ternary content addressable memory (TCAM) manager module for a packet switching engine (PSE) on a specific controller or node, use the controller pse tcam location command in the global configuration mode. To deconfigure the compression ipv6 anchor prefix, use the no form of this command.

controller pse tcam location node-ID compression ipv6 anchor-prefix

no controller pse tcam location node-ID compression ipv6 anchor-prefix

Syntax Description

location node-ID

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

compression

Specifies configuration for prefix compression.

ipv6

Specifies the IPv6 command output.

anchor-prefix

Specifies the compression anchor prefix length. Original values are 16, 32, 48, 64, and 96. 128 is a placeholder and is not used as an anchor.

Command Default

None

Command Modes

Global configuration

Command History

Release Modification
Release 3.8.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
sonet-sdh

read, write

dwdm

read, write

interface

read, write

Examples

This example shows how to configure the compression ipv6 anchor prefix for ternary content addressable memory (TCAM) manager module for a packet switching engine (PSE) on a specific controller or node:


RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# controller pse tcam location 0/2/CPU0 compression ipv6 anchor-prefix 32

 

Related Commands

Command

Description

show controllers pse qfp statistics

Displays packet switching engine (PSE) quad flat package (QFP) statistics for a specific node

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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 classification

To display ACL class group ID, which is used to view Ternary Content Addressable Memory(TCAM) entry, use the show controllers pse qfp classification command in EXEC mode.

show controllers pse qfp classification class-group-manager class-group all location node-ID

Syntax Description

class-group-manager

Displays the class group manager.

class-group

Displays the class group.

all

Displays the ACL class group ID for all class groups.

location node-ID

Displays the ACL class group ID for a specific location. The node-ID argument is entered in the rack/slot/module notation.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
sonet sdh or dwdm

read

interface

read

root-system

read

Examples

This command shows how to display ACL class group ID, which is used to view TCAM entry:


RP/0/RSP0/CPU0:router# show controllers pse qfp classification class-group-manager class-group all location 0/2/cpu0

QFP classification class client all group
  class-group [acl:1]
  class-group [acl:2]
  class-group [acl:3]
  class-group [acl:4]
  class-group [lpts:2]
  class-group [lpts:3]
  class-group [lpts:4]
  class-group [li:1]
  class-group [li:2]

Related Commands

Command

Description

show controllers pse qfp classification feature-manager

Displays TCAM entries.

show controllers pse qfp classification feature-manager

To display Ternary Content Addressable Memory(TCAM) entries, use the show controllers pse qfp classification feature-manager command in EXEC mode.

show controllers pse qfp classification feature-manager class-group ce-data client class-group-ID interface-path-id location node-ID

Syntax Description

class-group

Displays the class group.

ce-data

Displays the ce-data.

client

Specifies type of client. The available options are:

  • acl - ACL client
  • cce - CCE client, includes QoS, Firewall, and FPM
  • dbg - Conditional debug client
  • ess - ESS client
  • fw-pam - Firewall PAM(Port-Application-Mapping) client
  • ipsec - IPSec client
  • lpts - LPTS client
  • nat - NAT client
  • pbr - PBR client
  • tc - ESS TC client
  • v6comp - V6 Compression client
  • wccp - WCCP client
class-group-ID

Displays the class group ID for all class groups.

interface-path-id

Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port; a slash between values is required as part of the notation.
    • rack: Chassis number of the rack.
    • slot: Physical slot number of the modular services card or line card.
    • module: Module number. A physical layer interface module (PLIM) is always 0.
    • port: Physical port number of the interface.
    Note   

    In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RSP0) and the module is CPU0. Example: interface MgmtEth0/RSP0/CPU0/0.

  • Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

location node-id

Displays the ACL class group ID for a specific location. The node-id argument is entered in the rack/slot/module notation.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
sonet sdh or dwdm

read

interface

read

root-system

read

Examples

This command shows how to display TCAM entries:


RP/0/RSP0/CPU0:router# show controllers pse qfp classification feature-manager class-group ce-data acl 2 interface pos0/2/1/2.1 detail location 0/2/cPU0


QFP TCAM information for qfp_num 0

CPP classification class group TCAM
class-group [acl-cg:2] (classes: 2, total number of vmrs: 2)
key name: 160_01  value size: 160 result size: 4
  region id: 1  vmr id: 2 number of vmrs: 2
  Value : : 33000001 06000000 00500050 29000001 00020001
   Mask : : ffffffff ff000000 ffffffff ffffffff ffff0009
Result : : 01000002 89c54800 00000000 00000000

  Value : : 00000000 00000000 00000000 00000000 00020001
   Mask : : 00000000 00000000 00000000 00000000 ffff0009
Result : : 02000002 89c54810 00000000 00000000


QFP TCAM information for qfp_num 1

CPP classification class group TCAM
class-group [acl-cg:2] (classes: 2, total number of vmrs: 2)
key name: 160_01  value size: 160 result size: 4
  region id: 1  vmr id: 1 number of vmrs: 2
  Value : : 33000001 06000000 00500050 29000001 00010001
   Mask : : ffffffff ff000000 ffffffff ffffffff ffff0009
Result : : 01000002 8986d800 00000000 00000000

  Value : : 00000000 00000000 00000000 00000000 00010001
   Mask : : 00000000 00000000 00000000 00000000 ffff0009
Result : : 02000002 8986d810 00000000 00000000



Related Commands

Command

Description

show controllers pse qfp classification

Display ACL class group ID which is used to dump TCAM entries.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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.

fsv

(Optional) Displays feature-specific variable information.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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.