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