Cisco IOS XR Modular Quality of Service Debug Command Reference, Release 3.5
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 control plimqos

debug qos control rm

debug qos data

debug qos dll chkpt

debug snmp mib qosmib


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.

debug qos control {all | classify | fq | mark | police | qosmgr | txm | wred}

no debug qos control {all | classify | fq | mark | police | qosmgr | txm | wred}

Syntax Description

all

Displays all the QoS control-plane debug actions.

classify

Displays the Classify debug events.

fq

Displays the fair queueing events.

mark

Displays the mark events.

police

Displays the police events.

qosmgr

Displays the QoS manager events.

txm

Displays the transmit manager events.

wred

Displays the weighted random early detection (WRED) 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.


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 | mark | misc | police | stats]

no debug qos control hardware [classify | cong-avoid | cong-mgmt | error | mark | misc | police | 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.

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


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

To turn on the physical layer interface module (PLIM) for the quality-of-service (QoS) 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.

debug qos control plimqos [errors | trace]

no debug qos plimqos [errors | trace]

Syntax Description

errors

(Optional) Displays plimqos errors.

trace

(Optional) Displays plimqos API trace errors.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1 and 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

qos

read, write


Examples

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

RP/0/RP0/CPU0:router# debug qos control plimqos errors

debug qos control rm

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

debug qos control rm [options]

no debug qos rm [options]

Syntax Description

options

(Optional) Displays information related to the specified resource. Replace the options argument with one of the following resource keywords:

alloc—Displays allocation-related information.

block—Displays counter allocation-related information.

chkpt—Displays checkpointing-related information.

counter—Displays counter-related information.

drv—Displays driver-related information.

free—Displays free-related information.

init—Displays initilization-related information.

misc—Displays miscellaneous allocation-related information.

proc—Displays resource manger process-related information.

tls—Displays three level scheduling-related information.

uidb—Displays universal interface descriptor block (UIDB) update-related information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1 and 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

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 rm

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 {classify | mark | mdrr | police | qfifo | txm}

On the Cisco XR 12000 Series Router:

no debug qos data {classify| fifo | mark | police | txm}

Syntax Description

classify

Displays the classify debug events.

fifo

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

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

mark

Displays the mark events.

mdrr

Displays the modified deficit round robin (MDRR) events.

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

police

Displays the police events.

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.


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 classify 

debug qos dll chkpt

To turn on the qosmgr checkpoint dynamic link library (DLL) quality-of-service (QoS) debug functions, use the debug qos dll chkpt command in EXEC mode. To turn off the qosmgr checkpoint DLL QoS debug functions, use the no form of this command.

debug qos dll chkpt {all | data | errors | info}

no debug qos dll chkpt {all | data | errors | info}

Syntax Description

all

Displays all qosmgr checkpoint DLL-related debug information.

data

Displays all qosmgr checkpoint DLL data.

errors

Displays all qosmgr checkpoint DLL errors.

info

Displays qosmgr checkpoint DLL detailed information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

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

Release 3.5.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 qosmgr checkpoint DLL QoS debug function:

RP/0/RP0/CPU0:router# debug qos dll chkpt all 

debug snmp mib qosmib

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

debug snmp mib qosmib

no debug snmp mib qosmib

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

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

Release 3.4.0

No modification.

Release 3.5.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

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 qosmib