Cisco IOS XR IP Addresses and Services Debug Command Reference, Release 3.3
Cisco Express Forwarding Debug Commands on Cisco IOS XR Software

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