Cisco IOS XR Routing Debug Command Reference, Release 3.3
RIB Debug Commands on Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 175.0KB) The complete bookPDF (PDF - 1.53MB) | Feedback

RIB Debug Commands on Cisco IOS XR Software

Table Of Contents

RIB Debug Commands on Cisco IOS XR Software

debug rib

debug routing


RIB Debug Commands on Cisco IOS XR Software


This chapter describes the commands used to debug the Routing Information Base (RIB) on
Cisco IOS XR software.

debug rib

To display debugging information for the Routing Information Base (RIB), use the debug rib command in EXEC mode. To disable debugging output, use the no form of this command.

debug rib {ipv4 | ipv6 | afi-all} {clear | counts | data | extcomms | firsthop | gc | locking | lookup | rcc | redist | routing [access-list-name] | rump | sync | tables | timers}

no debug rib {ipv4 | ipv6 | afi-all} {clear | counts | data | extcomms | firsthop | gc | locking | lookup | rcc | redist | routing [access-list-name] | rump | sync | tables | timers}

Syntax Description

ipv4

Specifies IP Version 4 (IPv4) RIB debug events.

ipv6

Specifies IP Version 6 (IPv6) RIB debug events.

afi-all

Specifies RIB debug events for IPv4 and IPv6.

clear

Displays RIB clear events.

counts

Displays RIB data structure reference counts events.

data

Displays RIB client data events.

extcomms

Displays extended communities events.

firsthop

Displays RIB firsthop registrations and notifications.

gc

Displays RIB garbage collection events.

locking

Displays RIB locking events.

lookup

Displays RIB route lookup events.

rcc

Displays RIB route consistency checker table events.

redist

Displays redistribution-related events.

routing

Displays RIB routing table events.

access-list-name

Name of an access list.

rump

Displays RUMP events.

sync

Displays RIB table sync events.

tables

Displays table-related events.

timers

Displays RIB timer events.


Defaults

Debugging is disabled.

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.


Caution The debug rib 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

rib

debug


Examples

The following is sample output from the debug rib command:

RP/0/RP0/CPU0:router# debug rib ipv4 data
 
   
RP/0/RP0/CPU0:Jun 21 07:30:51.821 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.6, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.822 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.5, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.824 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.4, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.825 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.3, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.825 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.2, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.826 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.0/30 via 10.0.101.1, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.826 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.6, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.826 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.5, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.827 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.4, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.827 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.3, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.827 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.2, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp 
RP/0/RP0/CPU0:Jun 21 07:30:51.827 : ipv4_rib[199]: RIB Routing: Tbl: "default" IPv4 
Unicast, Add active route 2.2.1.4/30 via 10.0.101.1, metric [20/8] (fl: 0x0/0x0) with bgp 
attribute ID 0x41 by client bgp

Related Commands

Command
Description

undebug

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


debug routing

To display debugging information for routing table events, use the debug routing command in EXEC mode. To disable debugging output, use the no form of this command.

debug routing [access-list-name | afi-all [access-list-name] |ipv4 | ipv6]

no debug routing [access-list-name | afi-all [access-list-name] |ipv4 | ipv6]

Syntax Description

access-list-name

Name of an access list.

afi-all

Specifies routing table debug events for IPv4 and IPv6.

ipv4

Specifies IP Version 4 (IPv4) routing table debug events.

ipv6

Specifies IP Version 6 (IPv6) routing tabledebug 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.


Caution The debug routing 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

rib

debug


Examples

The following example shows how to enable debugging information for routing table events:

RP/0/RP0/CPU0:router# debug routing

Related Commands

Command
Description

undebug

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