Table Of Contents

Static and Utility Debug Commands on Cisco IOS XR Software

debug connected

debug local

debug static

Static and Utility Debug Commands on Cisco IOS XR Software

---

This chapter describes the commands used to debug the static and utility features on Cisco IOS XR software.

debug connected

To display debugging information about routing connections, use the debug connected command in EXEC mode. To disable debugging output, use the no form of this command.

debug connected [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

no debug connected [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

Syntax Description

afi-all	Specifies debug events for IP Version 4 (IPv4) and IP Version 6 (IPv6) commands.
ipv4	Specifies debug events for IPv4 commands.
ipv6	Specifies debug events for IPv6 commands.
configuration	Displays static configuration events.
(configuration) batches	Displays configuration batch events.
(configuration ) connection	Displays configuration connection and registration events.
items	Displays configuration item events.
maximum	Displays configuration maxima events.
edm	Displays static Enterprise Data Management (EDM) events.
ifdb	Displays static interface database events.
ital	Displays static ITAL events.
(ital) events	Displays ITAL events.
init	Displays ITAL connection and registration events.
main	Displays static main module events.
nhdb	Displays static next-hop database events.
rib	Routing Information Base.
(rib) batches	Displays route update batch events.
clear	Displays RIB clear events.
(rib) connection	Displays RIB connection events.
converge	Displays RIB convergence events.
(rib) events	Displays RIB event notification pulses.
nexthops	Displays next-hop notification events.
registrations	Displays next-hop registration events.
routes	Displays route install and withdraw events.
(rib) tables	Displays RIB table events.
tables	Displays static table events.
topology	Displays static topology events.

Defaults

Debugging is disabled.

Command Modes

EXEC

Command History

Release	Modification
Release 3.3.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.

---

Caution The debug connected command generates a substantial amount of output. Use the command only when traffic on the IP network is low so that other activity on the system is not adversely affected.

---

Task ID

Task ID	Operations
cisco-support	read

Examples

The following example shows how to obtain debugging information for routing next-hop notification events for IPv4 and IPV6 commands:

RP/0/RP0/CPU0:router# debug connected afi-all rib nexthops

Related Commands

Command	Description
undebug	Enters debug mode to disable or reset multiple active debug command sessions.

debug local

To display debugging informationabout local connections, use the debug local command in EXEC mode. To disable debugging output, use the no form of this command.

debug local [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

no debug local [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

Syntax Description

afi-all	Specifies debug events for IP Version 4 (IPv4) and IP Version 6 (IPv6) commands.
ipv4	Specifies debug events for IPv4 commands.
ipv6	Specifies debug events for IPv6 commands.
configuration	Displays static configuration events.
(configuration) batches	Displays configuration batch events.
(configuration ) connection	Displays configuration connection and registration events.
items	Displays configuration item events.
maximum	Displays configuration maxima events.
edm	Displays static Enterprise Data Management (EDM) events.
ifdb	Displays static interface database events.
ital	Displays static ITAL events.
(ital) events	Displays ITAL events.
init	Displays ITAL connection and registration events.
main	Displays static main module events.
nhdb	Displays static next-hop database events.
rib	Routing Information Base.
(rib) batches	Displays route update batch events.
clear	Displays RIB clear events.
(rib) connection	Displays RIB connection events.
converge	Displays RIB convergence events.
(rib) events	Displays RIB event notification pulses.
nexthops	Displays next-hop notification events.
registrations	Displays next-hop registration events.
routes	Displays route install and withdraw events.
(rib) tables	Displays RIB table events.
tables	Displays static table events.
topology	Displays static topology events.

Defaults

Debugging is disabled.

Command Modes

EXEC

Command History

Release	Modification
Release 3.3.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.

---

Caution The debug local command generates a substantial amount of output. Use the command only when traffic on the IP network is low so that other activity on the system is not adversely affected.

---

Task ID

Task ID	Operations
cisco-support	read

Examples

The following example shows how to obtain debugging information for local next-hop notification events for IPv4 and IPV6 commands:

RP/0/RP0/CPU0:router# debug local afi-all rib nexthops

Related Commands

Command	Description
undebug	Enters debug mode to disable or reset multiple active debug command sessions.

debug static

To display debugging information about static connections, use the debug static command in EXEC mode. To disable debugging output, use the no form of this command.

debug static [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

no debug static [afi-all | ipv4 | ipv6] {configuration {batches | connection | items | maximum} | edm | ifdb | ital{events | init}| main | nhdb | rib {batches | clear | connection | converge | events | nexthops | registrations | routes | tables}| tables | topology}

Syntax Description

afi-all	Specifies debug events for IP Version 4 (IPv4) and IP Version 6 (IPv6) commands.
ipv4	Specifies debug events for IPv4 commands.
ipv6	Specifies debug events for IPv6 commands.
configuration	Displays static configuration events.
(configuration) batches	Displays configuration batch events.
(configuration ) connection	Displays configuration connection and registration events.
items	Displays configuration item events.
maximum	Displays configuration maxima events.
edm	Displays static Enterprise Data Management (EDM) events.
ifdb	Displays static interface database events.
ital	Displays static ITAL events.
(ital) events	Displays ITAL events.
init	Displays ITAL connection and registration events.
main	Displays static main module events.
nhdb	Displays static next-hop database events.
rib	Routing Information Base.
(rib) batches	Displays route update batch events.
clear	Displays RIB clear events.
(rib) connection	Displays RIB connection events.
converge	Displays RIB convergence events.
(rib) events	Displays RIB event notification pulses.
nexthops	Displays next-hop notification events.
registrations	Displays next-hop registration events.
routes	Displays route install and withdraw events.
(rib) tables	Displays RIB table events.
tables	Displays static table events.
topology	Displays static topology events.

Defaults

Debugging is disabled.

Command Modes

EXEC

Command History

Release	Modification
Release 3.3.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.

The debug static command generates a substantial amount of output. Use the command only when traffic on the IP network is low so that other activity on the system is not adversely affected

Task ID

Task ID	Operations
cisco-support	read

Examples

The following example shows how to obtain debugging information for static next-hop notification events for IPv4 and IPV6 commands:

RP/0/RP0/CPU0:router# debug static afi-all rib nexthops

Related Commands

Command	Description
undebug	Enters debug mode to disable or reset multiple active debug command sessions.