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