Table Of Contents
Cisco Express Forwarding Debug Commands on Cisco IOS XR Software
debug cef bgp
debug cef configuration
debug cef download
debug cef drops
debug cef errors
debug cef events
debug cef external
debug cef forus api
debug cef packet
debug cef preroute
debug cef receive
debug cef stats
debug cef table
debug cef timing
Cisco Express Forwarding Debug Commands on Cisco IOS XR Software
This chapter describes the commands used to debug the Cisco Express Forwarding software on Cisco IOS XR software.
debug cef bgp
To debug the Cisco Express Forwarding (CEF) Border Gateway Protocol (BGP) attribute downloading or policy accounting, use the debug cef bgp command in EXEC mode. To disable BGP attribute download and policy accounting debugging, use the no form of this command.
debug cef bgp {attribute | policy-accounting} [access-list] [location node-id]
no debug cef bgp {attribute | policy-accounting} [access-list] [location node-id]
Syntax Description
attribute
|
Specifies BGP attribute download.
|
policy-accounting
|
Specifies BGP policy accounting download.
|
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF BGP debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to CEF BGP attribute debugging:
RP/0/RP0/CPU0:router# debug cef bgp attribute
debug cef configuration
To enable Cisco Express Forwarding (CEF) configuration debugging, use the debug cef configuration command in EXEC mode. To disable CEF configuration debugging, use the no form of this command.
debug cef configuration [location node-id]
no debug cef configuration [location node-id]
Syntax Description
location node-id
|
(Optional) Displays CEF configuration debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF configuration debugging:
RP/0/RP0/CPU0:router# debug cef configuration location 0/2/0/0
debug cef download
To enable the Cisco Express Forwarding (CEF) packet download debugging, use the debug cef download command in EXEC mode. To disable CEF packet download debugging, use the no form of this command.
debug cef download [location node-id]
no debug cef download [location node-id]
Syntax Description
location node-id
|
(Optional) Displays CEF packet downloading debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF packet downloading debugging:
RP/0/RP0/CPU0:router# debug cef download location 0/2/cp0
debug cef drops
To enable Cisco Express Forwarding (CEF) dropped packet debugging, use the debug cef drops command in EXEC mode. To disable CEF dropped packet debugging, use the no form of this command.
debug cef drops [rpf] [access-list] [location node-id]
no debug cef drops [rpf] [access-list] [location node-id]
Syntax Description
rpf
|
(Optional) Displays packets dropped by CEF Unicast Reverse Path Forwarding (RPF).
|
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays dropped CEF packet debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF dropped packets debugging:
RP/0/RP0/CPU0:router# debug cef drops
debug cef errors
To enable Cisco Express Forwarding (CEF) error debugging, use the debug cef errors command in EXEC mode. To disable CEF error debugging, use the no form of this command.
debug cef errors [location node-id]
no debug cef errors [location node-id]
Syntax Description
location node-id
|
(Optional) Displays CEF error debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF error debugging:
RP/0/RP0/CPU0:router# debug cef errors
debug cef events
To enable Cisco Express Forwarding (CEF) event debugging, use the debug cef events command in EXEC mode. To disable CEF event debugging, use the no form of this command.
debug cef events [access-list] [location node-id]
no debug cef events [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF event debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF event debugging:
RP/0/RP0/CPU0:router# debug cef events location 0/2/cp0
debug cef external
To enable Cisco Express Forwarding (CEF) external switch or adjacency debugging, use the debug cef external command in EXEC mode. To disable CEF external switch or adjacency debugging, use the no form of this command.
debug cef external [access-list] [location node-id]
no debug cef external [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF external switch or adjacency debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF external switches or adjacency debugging:
RP/0/RP0/CPU0:router# debug cef external location 0/2/cp0
debug cef forus api
To enable Cisco Express Forwarding (CEF) IPv4 Forwarding Information Base (FIB) local packet handling application program interface (API) event debugging, use the debug cef forus api command in EXEC mode. To disable forus client handling API event debugging, use the no form of this command.
debug cef forus api {errors | info} [job job-id | process process-id] [location node-id]
no debug cef forus api {errors | info} [job job-id | process process-id] [location node-id]
Syntax Description
errors
|
Local packet handling API errors.
|
info
|
Local packet handling API information.
|
job job-id
|
(Optional) Displays IPARM debug information for a specific job.
|
process process-id
|
(Optional) Displays IPARM debug information for a specific process.
|
location node-id
|
(Optional) Displays CEF local packet handling API debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF local packet handling API debugging:
RP/0/RP0/CPU0:router# debug cef forus api job 234 location 0/2/cp0
debug cef packet
To enable Cisco Express Forwarding (CEF) packet handling debugging, use the debug cef packet command in EXEC mode. To disable CEF packet handling debugging, use the no form of this command.
debug cef packet [access-list] [location node-id]
no debug cef packet [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF packet handling debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF packet handling debugging:
RP/0/RP0/CPU0:router# debug cef packet location 0/2/cp0
debug cef preroute
To enable Cisco Express Forwarding (CEF) preroute packet handling debugging, use the debug cef preroute command in EXEC mode. To disable CEF preroute packet handling debugging, use the no form of this command.
debug cef preroute [access-list] [location node-id]
no debug cef preroute [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF preroute packet handling debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF preroute packet handling debugging:
RP/0/RP0/CPU0:router# debug cef preroute location 0/2/cp0
debug cef receive
To enable Cisco Express Forwarding (CEF) received packet debugging, use the debug cef receive command in EXEC mode. To disable CEF received packet debugging, use the no form of this command.
debug cef receive [access-list] [location node-id]
no debug cef receive [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF packet received debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF packets received debugging:
RP/0/RP0/CPU0:router# debug cef receive location 0/2/cp0
debug cef stats
To enable Cisco Express Forwarding (CEF) statistics debugging, use the debug cef stats command in EXEC mode. To disable CEF statistics debugging, use the no form of this command.
debug cef stats [location node-id]
no debug cef stats [location node-id]
Syntax Description
location node-id
|
(Optional) Displays CEF statistics debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF statistics debugging:
RP/0/RP0/CPU0:router# debug cef stats location 0/2/cp0
debug cef table
To enable Cisco Express Forwarding (CEF) table debugging, use the debug cef table command in EXEC mode. To disable CEF table debugging, use the no form of this command.
debug cef table [access-list] [location node-id]
no debug cef table [access-list] [location node-id]
Syntax Description
access-list
|
(Optional) Name of a particular access list. The name cannot contain a space or quotation mark; it may contain numbers.
|
location node-id
|
(Optional) Displays CEF table debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF tables debugging:
RP/0/RP0/CPU0:router# debug cef table location 0/2/cp0
debug cef timing
To enable Cisco Express Forwarding (CEF) timing debugging, use the debug cef timing command in EXEC mode. To disable CEF timing debugging, use the no form of this command.
debug cef timing [location node-id]
no debug cef timing [location node-id]
Syntax Description
location node-id
|
(Optional) Displays CEF timing issue debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.
|
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.
|
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
|
cef
|
read
|
Examples
The following example shows how to enable CEF timing issue debugging:
RP/0/RP0/CPU0:router# debug cef timing location 0/2/cp0