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.
|
Feedback
