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

BGP Debug Commands on Cisco IOS XR Software

Table Of Contents

BGP Debug Commands on Cisco IOS XR Software

debug bgp

debug bgp address-family

debug bgp brib-update

debug bgp dampening

debug bgp event

debug bgp io

debug bgp keepalive

debug bgp policy

debug bgp policy-execution

debug bgp rib

debug bgp update


BGP Debug Commands on Cisco IOS XR Software


This chapter describes the commands used to debug Border Gateway Protocol (BGP) for IP Version 4 and IP Version 6 on Cisco IOS XR software.

debug bgp

To display debugging information related to the acquisition of the Border Gateway Protocol (BGP) router ID and the sending and receiving of BGP messages, use the debug bgp command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp [ip-address] [vrf [vrf-name | all]] [in | out] [bpm | brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose}]

no debug bgp [ip-address] [vrf [vrf-name | all]] [in | out] [bpm | brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose}]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

in

(Optional) Displays debugging information for BGP updates in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates in the outbound direction only.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

bpm

(Optional) Displays output to a BGP process manager (BPM) process.

brib

(Optional) Displays output to a BGP Routing Information Base (bRIB) process.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.


Defaults

Inbound and outbound information is displayed.
All processes are displayed.
The severity is summary.

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

Support was added for the vrf keyword.


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.

BGP messages referred to here include open messages and the BGP capability advertisements contained in them, notification messages, and route-refresh messages.


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

bgp

read


Examples

The following example shows how to enable debugging information for BGP router ID and sending and receiving of BGP messages:

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

Related Commands

Command
Description

undebug

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


debug bgp address-family

To display debugging information related to the acquisition of Border Gateway Protocol (BGP) router ID Management Information Base (MIB) traps, deletion of routes received from a neighbor, change of state of a neighbor, and sending notification to a neighbor, use the debug ip bgp address-family command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp address-family [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [ip-address] [route-policy-name] [bpm | brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp address-family [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [ip-address] [route-policy-name] [bpm | brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) For address family, specifies that both IP v4 and IPv6 prefixes be displayed.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) For sub-address family, specifies that both unicast and multicast address prefixes be displayed.

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

route-policy-name

(Optional) Name of the route policy.

bpm

(Optional) Displays output to a BGP process manager (BPM) process.

brib

(Optional) Displays output to a BGP Routing Information Base (bRIB) process.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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.

Use the debug bgp address-family command for analyzing messages traveling between BGP neighbors.


Caution The debug bgp address-family 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

bgp

read


Examples

The following example shows how to enable debugging information related to the acquisition of BGP router ID MIB traps, deletion of routes received from a neighbor, change of state of a neighbor, and sending notification to a neighbor:

RP/0/RP0/CPU0:router# debug bgp address-family

Related Commands

Command
Description

undebug

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


debug bgp brib-update

To display debugging information about the formatting of messages sent between the Border Gateway Protocol (BGP) speakers and the BGP Routing Information Base (bRIB) when BGP is running in distributed mode, use the debug bgp brib-update command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp brib-update [ip-address] [vrf [vrf-name | all]] [{ipv6 | all}]{unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] {in | out} [route-policy-name] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp brib-update [ip-address] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] {in | out} [route-policy-name] [brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose} [vpnv4 unicast]]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IP Version 4 and IP Version 6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

in

(Optional) Displays debugging information for BGP updates in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates in the outbound direction only.

route-policy-name

(Optional) Name of the route policy.

brib

(Optional) Displays output to the bRIB process.

{1 | 2}

Displays debugging information for a specific bRIB process.

speaker

(Optional) Displays output to the BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
Inbound and outbound information is displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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 debugging information resulting from this command includes the formatting of messages in both the speakers and the bRIB, the transmission of messages sent by the speaker and received by the bRIB and the transmission of messages sent by the bRIB and received by the speakers.

Use the debug bgp brib-update command to analyze messages traveling between BGP speakers and the bRIB process or from the bRIB to the BGP speakers.


Caution The debug bgp brib-update 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

bgp

read


Examples

The following example shows how to enable debugging information about formatting messages sent between BGP speakers and the bRIB when BGP is running in distributed mode:

RP/0/RP0/CPU0:router# debug bgp brib-update

Related Commands

Command
Description

undebug

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


debug bgp dampening

To display debugging information about the creation of dampening structures, the penalization of routes, the decay of that penalty, and the suppression and the unsuppression of routes, use the debug bgp dampening command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp dampening [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [route-policy-name] [speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp dampening [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [route-policy-name] [speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IPv4 and IPv6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

route-policy-name

(Optional) Name of the route policy.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All speaker processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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.

Use the debug bgp dampening command to analyze the dampening of a flapping route.


Caution The debug bgp dampening 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

bgp

read


Examples

The following example shows how to enable debugging information about the creation of dampening structures, the penalization of routes, the decay of that penalty, and the suppression and the unsuppression of routes:

RP/0/RP0/CPU0:router# debug bgp dampening

Related Commands

Command
Description

undebug

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


debug bgp event

To display debugging information about significant Border Gateway Protocol (BGP) events, use the debug bgp event command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp event [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [bpm | brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp event [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [bpm | brib | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IPv4 and IPv6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

bpm

(Optional) Displays output to a BGP process manager (BPM) process.

brib

(Optional) Displays output to a BGP Routing Information Base (bRIB) process.

{1 | 2}

Displays debugging information for a specific bRIB process.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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.

Use the debug bgp event command to analyze various BGP external and internal events. Events include BGP neighbor creation, deletion, and reset; BGP scanner runs; Routing Information Base (RIB) connect and disconnect events; and BGP internal state transitions.


Caution The debug bgp event 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

bgp

read


Examples

The following example shows how to enable debugging information about significant BGP events:

RP/0/RP0/CPU0:router# debug bgp event

Related Commands

Command
Description

undebug

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


debug bgp io

To display debugging information about the handling of Border Gateway Protocol (BGP) TCP connections, use the debug bgp io command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp io [ip-address] [vrf [vrf-name | all]] [in | out] [speaker speaker-id] [level {errors | warning | summary | detail | verbose}]

no debug bgp io [ip-address] [vrf [vrf-name | all]] [in | out] speaker-id] [level {errors | warning | summary | detail | verbose}]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

in

(Optional) Displays debugging information for BGP updates coming in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates coming in the outbound direction only.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

Inbound and outbound information is displayed.

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

Support was added for the vrf keyword.


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.

Use the debug bgp io command to display set TCP parameters, opened and closed TCP connections, read from and written to TCP connections, and notifications of passive and active open attempts.


Caution The debug bgp io 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

bgp

read


Examples

The following example shows how to enable debugging information about the handling of BGP TCP connections:

RP/0/RP0/CPU0:router# debug bgp io

Related Commands

Command
Description

undebug

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


debug bgp keepalive

To display debugging information about sending and receiving Border Gateway Protocol (BGP) keepalive messages, use the debug bgp keepalive command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp keepalive [ip-address] [vrf [vrf-name | all]] [in | out] [speaker speaker-id] [level {errors | warning | summary | detail | verbose}]

no debug bgp keepalive [ip-address] [vrf [vrf-name | all]] [in | out] [speaker speaker-id] [level {errors | warning | summary | detail | verbose}]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

in

(Optional) Displays debugging information for BGP updates coming in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates coming in the outbound direction only.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

Inbound and outbound information is displayed.
All speaker processes are displayed.
The severity is summary.

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

Support was added for the vrf keyword.


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 bgp keepalive 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

bgp

read


Examples

The following example shows how to enable debugging information about sending and receiving BGP keepalive messages:

RP/0/RP0/CPU0:router# debug bgp keepalive

Related Commands

Command
Description

undebug

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


debug bgp policy

To display debugging information about the routing policy language (RPL) function and the application of configured RPL policies within Border Gateway Protocol (BGP), use the debug bgp policy command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp policy [ip-address] [vrf [vrf-name | all] [in | out] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp policy [ip-address] [vrf [vrf-name | all] [in | out] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

in

(Optional) Displays debugging information for BGP updates coming in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates coming in the outbound direction only.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IPv4 and IPv6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

bpm

(Optional) Displays output to a BGP process manager (BPM) process.

brib

(Optional) Displays output to a BGP Routing Information Base (bRIB) process.

{1 | 2}

Displays debugging information for a specific bRIB process.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All brib and speaker processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword


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 bgp policy 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

bgp

read


Examples

The following example shows how to enable debugging information about the RPL function and the application of configured RPL policies within BGP:

RP/0/RP0/CPU0:router# debug bgp policy

Related Commands

Command
Description

undebug

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


debug bgp policy-execution

To display debugging information about the routing policy language (RPL) function and the application of configured RPL policies within Border Gateway Protocol (BGP), use the debug bgp policy command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp policy [ip-address] [vrf [vrf-name | all] [in | out] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp policy [ip-address] [vrf [vrf-name | all] [in | out] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

in

(Optional) Displays debugging information for BGP updates coming in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates coming in the outbound direction only.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IPv4 and IPv6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

bpm

(Optional) Displays output to a BGP process manager (BPM) process.

brib

(Optional) Displays output to a BGP Routing Information Base (bRIB) process.

{1 | 2}

Displays debugging information for a specific bRIB process.

speaker

(Optional) Displays output to a BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All brib and speaker processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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 bgp policy 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

bgp

read


Examples

The following example shows how to enable debugging information about the RPL function and the application of configured RPL policies within BGP:

RP/0/RP0/CPU0:router# debug bgp policy

Related Commands

Command
Description

undebug

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


debug bgp rib

To display debugging information about Border Gateway Protocol (BGP) route installation into the Routing Information Base (RIB) and the redistribution of routes from the RIB, use the debug bgp rib command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp rib [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [route-policy-name] [brib {1 | 2}] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp rib [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] [route-policy-name] [brib {1 | 2}] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IPv4 and IPv6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

route-policy-name

(Optional)

brib

(Optional) Displays output to BGP Routing Information Base (bRIB) process.

{1 | 2}

Displays debugging information for a specific bRIB process.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All brib and speaker processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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.

Use the debug bgp rib command to analyze updates to RIB.


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

bgp

read


Examples

The following example shows how to enable debugging information about BGP route installation into the RIB and the redistribution of routes from the RIB:

RP/0/RP0/CPU0:router# debug bgp rib

Related Commands

Command
Description

undebug

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


debug bgp update

To display debugging information related to inbound and outbound Border Gateway Protocol (BGP) update messages, BGP Outbound Route Filtering (ORF) messages, and BGP soft-reconfiguration events, use the debug bgp update command in EXEC mode. To disable debugging output, use the no form of this command.

debug bgp update [ip-address] [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] {in | out} [route-policy-name] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

no debug bgp update [ip-address] [vrf [vrf-name | all] [{ipv6 | all}] {unicast | multicast | all}] [ipv4 {unicast | multicast | labeled-unicast | all}] {in | out} [route-policy-name] [brib {1 | 2} | speaker speaker-id] [level {errors | warning | summary | detail | verbose}] [vpnv4 unicast]

Syntax Description

ip-address

(Optional) IP address of the neighbor for which you want to limit the output.

vrf

(Optional) A BGP VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name of the BGP VRF instance to be reset.

all

(Optional) Resets all BGP VRF instances.

ipv4

(Optional) Specifies IP Version 4 (IPv4) address prefixes.

ipv6

(Optional) Specifies IP Version 6 (IPv6) address prefixes.

all

(Optional) Displays both IP Version 4 and IP Version 6 address prefixes.

unicast

(Optional) Specifies unicast address prefixes.

multicast

(Optional) Specifies multicast address prefixes.

labeled-unicast

(Optional) Specifies labeled unicast address prefixes.

all

(Optional) Displays both unicast and multicast sub-address prefixes.

in

(Optional) Displays debugging information for BGP updates in the inbound direction only.

out

(Optional) Displays debugging information for BGP updates in the outbound direction only.

route-policy-name

(Optional) Name of the route policy.

brib

(Optional) Displays output to the bRIB process.

{1 | 2}

Displays debugging information for a specific bRIB process.

speaker

(Optional) Displays output to the BGP speaker process.

speaker-id

(Optional) ID of the speaker process. Specify a value in the range from 1 to 5.

level

(Optional) Displays debug messages based on severity. Debug messages are filtered by the severity of the event the debug message is describing.

errors

Displays the highest level of debugging messages. This level of debug filtering displays error conditions.

warning

Displays the second-highest level of debugging messages. This level of debug filtering displays warning conditions.

summary

Displays the third-highest level of debugging messages. This level of debug filtering displays debug summaries.

detail

Displays the fourth-highest level of debugging messages. This level of debug filtering displays debug details.

verbose

Displays the lowest level of debugging messages. This level of debug filtering displays a hex dump of messages sent and received.

vpnv4 unicast

(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.


Defaults

The address family indicator (AFI) is IPv4.
The subaddress family indicator (SAFI) is unicast.
All brib and speaker processes are displayed.
The severity is summary.

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

Support was added for the vpn keyword.

The labeled-unicast keyword was added to the ipv4 option.

The command was rearranged to account for differences in the options for the ipv4 and ipv6 keywords.

Support was added for the vpnv4 unicast keyword.


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 bgp update command is useful for sending updates to peers.


Caution Because the debug bgp update command generates a substantial amount of output, use it only when traffic on the IP network is low, so other activity on the system is not adversely affected.

Task ID

Task ID
Operations

bgp

read


Examples

The following example shows how to enable debugging information related to BGP update messages, BGP ORF messages, and BGP soft-reconfiguration events:

RP/0/RP0/CPU0:router# debug bgp update

Related Commands

Command
Description

undebug

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