Cisco IOS XR Modular Quality of Service Debug Command Reference, Release 3.6
Quality of Service Debug Commands on Cisco IOS XR Software

Table Of Contents

Quality of Service Debug Commands on Cisco IOS XR Software

debug qos control

debug qos control hardware

debug qos data

debug snmp mib cbqosmib


Quality of Service Debug Commands on Cisco IOS XR Software


This chapter describes the commands used to debug the quality-of-service (QoS) software system.

debug qos control

To turn on the various quality-of-service (QoS) control-plane debug functions, use the debug qos control command in EXEC mode. To turn off the QoS control-plane debug functions, use the no form of this command.

On the Cisco CRS-1 Router:

debug qos control {hardware}

no debug qos control {hardware}

On the Cisco XR 12000 Series Router:

debug qos control {hardware | plimqos | rm}

no debug qos control {hardware | plimqos | rm}

Syntax Description

hardware

Displays the hardware (EA) events.

plimqos

Displays QoS PLIM events.

rm

Displays the resource manager events.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

The hardware, rm and plimqos keywords were added to this command.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

qos

read, write


Examples

The following example shows how to enable QoS control-plane classify debug events:

RP/0/RP0/CPU0:router# debug qos control all 

debug qos control hardware

To turn on the various quality-of-service (QoS) control hardware debug functions, use the debug qos control hardware command in EXEC mode. To turn off the QoS control hardware debug functions, use the no form of this command.

On the Cisco CRS-1 Router:

debug qos control hardware [classify | cong-avoid | cong-mgmt | error | ha | job | location | mark | misc | police | process | stats]

no debug qos control hardware [classify | cong-avoid | cong-mgmt | error | ha | job | location | mark | misc | police | process | stats]

On the Cisco XR 12000 Series Router:

debug qos control hardware [bwchg | bwchgerr | classify | cong-avoid | cong-mgmt | error | mark | mcast | misc | police | stats] [interface type instance| location node-id]

no debug qos control hardware [bwchg | bwchgerr | classify | cong-avoid | cong-mgmt | error | mark | mcast | misc | police | stats] [interface type instance | location node-id]

Syntax Description

bwchg

(Optional) Displays dynamic bandwidth change-related information.

Note The bwchg keyword is available on the Cisco XR 12000 Series Router only.

bwchgerr

(Optional) Displays dynamic bandwidth change errors.

Note The bwchgerr keyword is available on the Cisco XR 12000 Series Router only.

classify

(Optional) Displays classification-related information.

cong-avoid

(Optional) Displays WRED-related information.

cong-mgmt

(Optional) Displays queuing-related information.

error

(Optional) Displays errors while applying policies.

ha

(Optional) Displays high availability related information.

job

(Optional) Displays debug information for the specified job ID.

mark

(Optional) Displays marking-related information.

mcast

(Optional) Displays multicast-related information.

Note The mcast keyword is available on the Cisco XR 12000 Series Router only.

misc

(Optional) Displays miscellaneous information.

police

(Optional) Displays policing-related information.

stats

(Optional) Displays QoS statistics-related information.

interface type instance

(Optional) Specifies an interface on which to turn on QoS control hardware debug functions. Replace type with the type of interface you are configuring. Replace instance with a physical interface or a virtual interface identifier.

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

Note For more information, use the question mark (?) online help function.

Note The interface type instance keyword argument is available on the Cisco XR 12000 Series Router only.

location node-id

(Optional) Enables QoS control hardware debug functions for a specified location (for example, 0/2/CPU0). The node-id argument is entered in the rack/slot/module notation.

Note For more information, use the question mark (?) online help function.

Note The location node-id keyword argument is available on the Cisco XR 12000 Series Router only.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

The checkpoint keyword was removed.

Release 3.5.0

The following keywords and arguments were added on the Cisco XR 12000 Series Router:

bwchg

bwchgerr

mcast

interface type instance

location node-id

Release 3.6.0

The following keywords were added on the Cisco CRS-1 Router:

ha

job


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

qos

read, write


Examples

The following example shows how to enable the QoS control hardware debug function:

RP/0/RP0/CPU0:router# debug qos control hardware

debug qos data

To turn on the various quality-of-service (QoS) data plane debug functions, use the debug qos data command in EXEC mode. To turn off the QoS data plane debug functions, use the no form of this command.

On the Cisco CRS-1 Router:

debug qos data {qfifo | txm}

no debug qos data {qfifo | txm}

On the Cisco XR 12000 Series Router:

debug qos data {fifo | txm}

no debug qos data {fifo | txm}

Syntax Description

fifo

Displays the first in, first out (FIFO) events.

Note The fifo keyword is available on the Cisco XR 12000 Series Router only.

qfifo

Displays the queue first in, first out (QFIFO) events.

Note The qfifo keyword is available on the Cisco CRS-1 only.

txm

Displays the transmit manager events.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

qos

read, write


Examples

The following example shows how to enable the QoS data plane debug function:

RP/0/RP0/CPU0:router# debug qos data txm 

debug snmp mib cbqosmib

To turn on the various quality-of-service (QoS) cbqosmib debug functions, use the debug snmp mib cbqosmib command in EXEC mode. To turn off the QoS qosmib debug functions, use the no form of this command.

debug snmp mib cbqosmib

no debug snmp mib cbqosmib

Syntax Description

There are no keywords or arguments for this command.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

snmp

read, write

sysmgr

read


Examples

The following example shows how to enable the QoS data plane debug function:

RP/0/RP0/CPU0:router# debug snmp mib cbqosmib