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 ha
debug bgp import
debug bgp io
debug bgp keepalive
debug bgp label
debug bgp nexthop
debug bgp policy-execution
debug bgp progress
debug bgp rib
debug bgp test-policy
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 (IPv4), IP Version 6 (IPv6), Virtual Private Network Version 4 (VPNv4), Virtual Private Network Version 6 (VPNv6) 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 brib-id | speaker speaker-id |
test-policy] [level {errors | warning | summary | detail | verbose}]
no debug bgp [ip-address] [vrf [vrf-name | all]] [in | out] [bpm | brib brib-id | speaker speaker-id
| test-policy] [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.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
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.
|
bpm
|
(Optional) Displays output of a BGP process manager (BPM) process.
|
brib
|
(Optional) Displays output of a BGP Routing Information Base (BRIB) process.
|
brib-id
|
(Optional) ID of the BRIB process. Range is 1 to 3.
|
speaker
|
(Optional) Displays output of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
test-policy
|
(Optional) Displays route-policy process-testing output.
|
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.
|
Release 3.4.0
|
The brib-id argument was added.
The speaker-id range was changed to 1 to 15.
|
Release 3.5.0
|
The test-policy keyword was added.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
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 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]] [ipv4 {unicast | multicast | labeled-unicast | all}
| ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6 unicast]
[route-policy route-policy-name] [bpm | brib brib-id | speaker speaker-id] [level {errors |
warning | summary | detail | verbose}] [location [location-address]]
no debug bgp address-family [vrf [vrf-name | all]] [ipv4 {unicast | multicast | labeled-unicast |
all} | ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6
unicast] [route-policy route-policy-name] [bpm | brib brib-id | speaker speaker-id] [level
{errors | warning | summary | detail | verbose}] [location [location-address]]
Syntax Description
vrf
|
(Optional) A BGP VPN routing and forwarding (VRF) instance.
|
vrf-name
|
(Optional) Name of the BGP VRF instance.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
ipv4
|
(Optional) Specifies IP Version 4 (IPv4) address prefixes.
|
unicast
|
(Optional) Specifies unicast address prefixes.
|
multicast
|
(Optional) Specifies multicast address prefixes.
|
labeled-unicast
|
(Optional) Specifies labeled unicast address prefixes.
|
all
|
(Optional) For IPv4, displays unicast, labeled-unicast, and multicast subaddress prefixes. For IPv6, displays unicast and multicast subaddress prefixes.
|
ipv6
|
(Optional) Specifies IP Version 6 (IPv6) address prefixes.
|
all
|
(Optional) Displays both IPv4 and IPv6 address prefixes.
|
vpnv4 unicast
|
(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.
|
vpnv6 unicast
|
(Optional) Specifies VPN Version 6 (VPNv6) address prefixes.
|
route-policy
|
(Optional) Specifies a route policy.
|
route-policy-name
|
(Optional) Name of the route policy.
|
bpm
|
(Optional) Displays output of a BGP process manager (BPM) process.
|
brib
|
(Optional) Displays output of a BGP Routing Information Base (BRIB) process.
|
brib-id
|
(Optional) ID of the BRIB process. Range is 1 to 3.
|
speaker
|
(Optional) Displays output of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
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.
|
location
|
(Optional) Specifies a location.
|
location-address
|
(Optional) Address of a specific location.
|
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.
|
Release 3.4.0
|
The brib-id argument was added.
The ip-address argument was removed.
The speaker-id range was changed to 1 to 15.
|
Release 3.5.0
|
The vpnv6 unicast and route-policy keywords were added.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
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]] [ipv4 {unicast | multicast |
labeled-unicast | all} | ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4
unicast | vpnv6 unicast] [in | out] [route-policy route-policy-name] [brib brib-id | speaker
speaker-id] [level {errors | warning | summary | detail | verbose}] [location
[location-address]]
no debug bgp brib-update [ip-address] [vrf [vrf-name | all]] [ipv4 {unicast | multicast |
labeled-unicast | all} | ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4
unicast | vpnv6 unicast] [in | out] [route-policy route-policy-name] [brib brib-id | speaker
speaker-id] [level {errors | warning | summary | detail | verbose}] [location
[location-address]]
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.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
ipv4
|
(Optional) Specifies IP Version 4 (IPv4) address prefixes.
|
unicast
|
(Optional) Specifies unicast address prefixes.
|
multicast
|
(Optional) Specifies multicast address prefixes.
|
labeled-unicast
|
(Optional) Specifies labeled unicast address prefixes.
|
all
|
(Optional) For IPv4, displays unicast, labeled-unicast, and multicast subaddress prefixes. For IPv6, displays unicast and multicast subaddress prefixes.
|
ipv6
|
(Optional) Specifies IP Version 6 (IPv6) address prefixes.
|
all
|
(Optional) Displays both IPv4 and IPv6 address prefixes.
|
vpnv4 unicast
|
(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.
|
vpnv6 unicast
|
(Optional) Specifies VPN Version 6 (VPNv6) 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
|
(Optional) Specifies a route policy.
|
route-policy-name
|
(Optional) Name of the route policy.
|
brib
|
(Optional) Displays output to the BRIB process.
|
brib-id
|
(Optional) ID of the BRIB process. Range is 1 to 3.
|
speaker
|
(Optional) Displays output to the BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
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.
|
location
|
(Optional) Specifies a location.
|
location-address
|
(Optional) Address of a specific location.
|
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.
|
Release 3.4.0
|
The brib {1 | 2} keywords were changed to brib brib-id.
The speaker-id range was changed to 1 to 15.
|
Release 3.5.0
|
The vpnv6 unicast and route-policy keywords were added.
|
Release 3.6.0
|
No modification
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
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]] [ipv4 {unicast | multicast | labeled-unicast | all} |
ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6 unicast]
[route-policy route-policy-name] [speaker speaker-id] [level {errors | warning | summary |
detail | verbose}]
no debug bgp dampening [vrf [vrf-name | all]] [ipv4 {unicast | multicast | labeled-unicast | all}
| ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6 unicast]
[route-policy route-policy-name] [speaker speaker-id] [level {errors | warning | summary |
detail | verbose}]
Syntax Description
vrf
|
(Optional) A BGP VPN routing and forwarding (VRF) instance.
|
vrf-name
|
(Optional) Name of the BGP VRF instance.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
ipv4
|
(Optional) Specifies IP Version 4 (IPv4) address prefixes.
|
unicast
|
(Optional) Specifies unicast address prefixes.
|
multicast
|
(Optional) Specifies multicast address prefixes.
|
labeled-unicast
|
(Optional) Specifies labeled unicast address prefixes.
|
all
|
(Optional) For IPv4, displays unicast, labeled-unicast, and multicast subaddress prefixes. For IPv6, displays unicast and multicast subaddress prefixes.
|
ipv6
|
(Optional) Specifies IP Version 6 (IPv6) address prefixes.
|
all
|
(Optional) Displays both IPv4 and IPv6 address prefixes.
|
vpnv4 unicast
|
(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.
|
vpnv6 unicast
|
(Optional) Specifies VPN Version 6 (VPNv6) address prefixes.
|
route-policy
|
(Optional) Specifies a route policy.
|
route-policy-name
|
(Optional) Name of the route policy.
|
speaker
|
(Optional) Displays output of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
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
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.
|
Release 3.4.0
|
The speaker-id range was changed to 1 to 15.
|
Release 3.5.0
|
The vpnv6 unicast and route-policy keywords were added.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
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]] [ipv4 {unicast | multicast | labeled-unicast | all} | ipv6
{unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6 unicast] [bpm
| brib brib-id | speaker speaker-id | test-policy] [level {errors | warning | summary | detail |
verbose}] [location [location-address]]
no debug bgp event [vrf [vrf-name | all]] [ipv4 {unicast | multicast | labeled-unicast | all} | ipv6
{unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6 unicast] [bpm
| brib brib-id | speaker speaker-id | test-policy] [level {errors | warning | summary | detail |
verbose}] [location [location-address]]
Syntax Description
vrf
|
(Optional) A BGP VPN routing and forwarding (VRF) instance.
|
vrf-name
|
(Optional) Name of the BGP VRF instance.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
ipv4
|
(Optional) Specifies IP Version 4 (IPv4) address prefixes.
|
unicast
|
(Optional) Specifies unicast address prefixes.
|
multicast
|
(Optional) Specifies multicast address prefixes.
|
labeled-unicast
|
(Optional) Specifies labeled unicast address prefixes.
|
all
|
(Optional) For IPv4, displays unicast, labeled-unicast, and multicast subaddress prefixes. For IPv6, displays unicast and multicast subaddress prefixes.
|
ipv6
|
(Optional) Specifies IP Version 6 (IPv6) address prefixes.
|
all
|
(Optional) Displays both IPv4 and IPv6 address prefixes.
|
vpnv4 unicast
|
(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.
|
vpnv6 unicast
|
(Optional) Specifies VPN Version 6 (VPNv6) address prefixes.
|
bpm
|
(Optional) Displays output of a BGP process manager (BPM) process.
|
brib
|
(Optional) Displays output of a BGP Routing Information Base (BRIB) process.
|
brib-id
|
(Optional) Displays debugging information for a specific BRIB process. Range is 1 to 3.
|
speaker
|
(Optional) Displays output of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
test-policy
|
(Optional) Displays output of a test route policy 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.
|
location
|
(Optional) Specifies a location.
|
location-address
|
(Optional) Address of a specific location.
|
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.
|
Release 3.4.0
|
The brib {1 | 2} keywords were changed to brib brib-id.
The speaker-id range was changed to 1 to 15.
|
Release 3.5.0
|
The vpnv6 unicast and test-policy keywords were added.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
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 ha
To display debugging information about Border Gateway Protocol (BGP) high availability (HA), use the debug bgp ha command in EXEC mode. To disable debugging output, use the no form of this command.
debug bgp ha [level {errors | warning | summary | detail | verbose}] [location
[location-address]]
no debug bgp ha [level {errors | warning | summary | detail | verbose}] [location
[location-address]]
Syntax Description
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.
|
location
|
(Optional) Specifies a location.
|
location-address
|
(Optional) Address of a specific location.
|
Defaults
The severity is summary.
Command Modes
EXEC
Command History
Release
|
Modification
|
Release 3.4.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.5.0
|
No modification.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
Caution The
debug bgp ha 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 HA:
RP/0/RP0/CPU0:router# debug bgp ha
Related Commands
Command
|
Description
|
undebug
|
Enters debug mode to disable or reset multiple active debug command sessions.
|
debug bgp import
To display debugging information about Border Gateway Protocol (BGP) import processing, use the debug bgp import command in EXEC mode. To disable debugging output, use the no form of this command.
debug bgp import [ip-address] [vrf [vrf-name | all]] [ipv4 {unicast | multicast | labeled-unicast |
all} | ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4 unicast | vpnv6
unicast] [route-policy route-policy-name] [brib brib-id | speaker speaker-id] [level {errors |
warning | summary | detail | verbose}] [location [location-address]]
no debug bgp import [ip-address] [vrf [vrf-name | all]] [ipv4 {unicast | multicast |
labeled-unicast | all} | ipv6 {unicast | multicast | all} | all {unicast | multicast | all} | vpnv4
unicast | vpnv6 unicast] [route-policy route-policy-name] [brib brib-id | speaker speaker-id]
[level {errors | warning | summary | detail | verbose}] [location [location-address]]
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.
|
all
|
(Optional) Specifies all BGP VRF instances.
|
ipv4
|
(Optional) Specifies IP Version 4 (IPv4) address prefixes.
|
unicast
|
(Optional) Specifies unicast address prefixes.
|
multicast
|
(Optional) Specifies multicast address prefixes.
|
labeled-unicast
|
(Optional) Specifies labeled unicast address prefixes.
|
all
|
(Optional) For IPv4, displays unicast, labeled-unicast, and multicast subaddress prefixes. For IPv6, displays unicast and multicast subaddress prefixes.
|
ipv6
|
(Optional) Specifies IP Version 6 (IPv6) address prefixes.
|
all
|
(Optional) Displays both IPv4 and IPv6 address prefixes.
|
vpnv4 unicast
|
(Optional) Specifies VPN Version 4 (VPNv4) address prefixes.
|
vpnv6 unicast
|
(Optional) Specifies VPN Version 6 (VPNv6) address prefixes.
|
route-policy
|
(Optional) Specifies a route policy.
|
route-policy-name
|
(Optional) Name of the route policy.
|
brib
|
(Optional) Displays output of a BGP Routing Information Base (BRIB) process.
|
brib-id
|
(Optional) Displays debugging information for a specific BRIB process. Range is 1 to 3.
|
speaker
|
(Optional) Displays output of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Specify a value in the range from 1 to 15.
|
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.
|
location
|
(Optional) Specifies a location.
|
location-address
|
(Optional) Address of a specific location.
|
Defaults
The severity is summary.
Command Modes
EXEC
Command History
Release
|
Modification
|
Release 3.4.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.5.0
|
The vpnv6 unicast and route-policy route-policy-name keywords and argument were added.
|
Release 3.6.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.
Caution The
debug bgp import 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 import processing:
RP/0/RP0/CPU0:router# debug bgp import
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}] [location [location-address]]
no debug bgp io [ip-address] [vrf [vrf-name | all]] [in | out] [speaker speaker-id] [level {errors |
warning | summary | detail | verbose}] [location [location-address]]
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.
|
all
|
(Optional) Specifies 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 of a BGP speaker process.
|
speaker-id
|
(Optional) ID of the speaker process. Range is 1 to 15.
|
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.
|
|
