Table Of Contents
show bgp nsap
show bgp nsap community
show bgp nsap community-list
show bgp nsap dampened-paths
show bgp nsap filter-list
show bgp nsap flap-statistics
show bgp nsap inconsistent-as
show bgp nsap neighbors
show bgp nsap paths
show bgp nsap quote-regexp
show bgp nsap regexp
show bgp nsap summary
show dampening interface
show interface dampening
show ip bgp
show ip bgp cidr-only
show ip bgp community
show ip bgp community-list
show ip bgp dampened-paths
show ip bgp filter-list
show ip bgp flap-statistics
show ip bgp inconsistent-as
show ip bgp injected-paths
show ip bgp ipv4
show ip bgp ipv4 multicast
show ip bgp ipv4 multicast summary
show ip bgp neighbors
show ip bgp paths
show ip bgp peer-group
show ip bgp quote-regexp
show ip bgp regexp
show ip bgp replication
show ip bgp rib-failure
show ip bgp summary
show ip bgp template peer-policy
show ip bgp template peer-session
show ip bgp update-group
show bgp nsap
To display entries in the Border Gateway Protocol (BGP) routing table for the network service access point (NSAP) address family, use the show bgp nsap command in EXEC mode.
show bgp nsap [nsap-prefix]
Syntax Description
nsap-prefix
|
(Optional) NSAP prefix number, entered to display a particular network in the BGP routing table for the NSAP address family.
This argument may be any length up to 20 octets.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap command provides output similar to the show ip bgp command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap command:
BGP table version is 6, local router ID is 10.1.57.11
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0101 49.0101.1111.1111.1111.1111.00
* i49.0202.2222 49.0202.3333.3333.3333.3333.00
*> 49.0202.2222.2222.2222.2222.00
* i49.0202.3333 49.0202.3333.3333.3333.3333.00
*> 49.0202.2222.2222.2222.2222.00
*> 49.0303 49.0303.4444.4444.4444.4444.00
* 49.0404 49.0303.4444.4444.4444.4444.00
*>i 49.0404.9999.9999.9999.9999.00
Table 5 describes the significant fields shown in the display.
Table 5 show bgp nsap Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
The following is sample output from the show bgp nsap command, showing information for NSAP prefix 49.6005.1234.4567:
Router# show bgp nsap 49.6005.1234.4567
BGP routing table entry for 49.6005.1234.4567, version 2
Paths: (1 available, best #1)
Not advertised to any peer
49.6005.1234.4567.5678.1111.2222.3333.00 from 0.0.0.0 (10.1.1.1)
Origin IGP, localpref 100, weight 32768, valid, sourced, local, best
Note 
If a prefix has not been advertised to any peer, the display shows "Not advertised to any peer."
show bgp nsap community
To display routes that belong to specified network service access point (NSAP) Border Gateway Protocol (BGP) communities, use the show bgp nsap community command in EXEC mode.
show bgp nsap community [community-number] [exact-match | local-as | no-advertise |
no-export]
Syntax Description
community-number
|
(Optional) Valid value is a community number in the range from 1 to 4294967295 or AA:NN (autonomous system-community number/2-byte number).
|
exact-match
|
(Optional) Displays only routes that have an exact match.
|
local-as
|
(Optional) Displays only routes that are not sent outside of the local autonomous system (well-known community).
|
no-advertise
|
(Optional) Displays only routes that are not advertised to any peer (well-known community).
|
no-export
|
(Optional) Displays only routes that are not exported outside of the local autonomous system (well-known community).
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap community command provides output similar to the show ip bgp community command, except that it is specific to the NSAP address family.
Communities are set with the route-map and set community commands. Communities are sent using the neighbor send-community and neighbor route-map out commands. You must enter the numerical communities before the well-known communities. For example, the following string does not work:
Router> show bgp nsap community local-as 111:12345
Use the following string instead:
Router> show bgp nsap community 111:12345 local-as
Examples
The following is sample output from the show bgp nsap community command:
router# show bgp nsap community no-export
BGP table version is 5, local router ID is 10.1.57.14
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0101.11 49.0101.2222.2222.2222.2222.00
Table 6 describes the significant fields shown in the display.
Table 6 show bgp nsap community Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another.
|
set community
|
Sets the BGP communities attribute.
|
show bgp nsap community-list
|
Displays BGP community list information for the NSAP address family.
|
show bgp nsap community-list
To display routes that are permitted by the Border Gateway Protocol (BGP) community list for network service access point (NSAP) prefixes, use the show bgp nsap community-list command in EXEC mode.
show bgp nsap community-list community-list-number [exact-match]
Syntax Description
community-list-number
|
Community list number in the range from 1 to 199.
|
exact-match
|
(Optional) Displays only routes that have an exact match.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap community-list command provides output similar to the show ip bgp community-list command, except that it is specific to the NSAP address family.
Examples
The following is sample output of the show bgp nsap community-list command:
Router# show bgp nsap community-list 1
BGP table version is 6, local router ID is 10.0.22.33
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0a0a.bb 49.0a0a.bbbb.bbbb.bbbb.bbbb.00
Table 7 describes the significant fields shown in the display.
Table 7 show bgp nsap community-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp nsap dampened-paths
To display network service access point (NSAP) address family Border Gateway Protocol (BGP) dampened routes in the BGP routing table, use the show bgp nsap dampened-paths command in EXEC mode.
show bgp nsap dampened-paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Examples
The following is sample output from the show bgp nsap dampened-paths command in privileged EXEC mode:
Router# show bgp nsap dampened-paths
BGP table version is 20, local router ID is 10.1.57.13
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
*d 49.0404 10.2.4.2 00:25:50 65202 65404 i
Table 8 describes the significant fields shown in the display.
Table 8 show bgp nsap dampened-paths Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number for the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router where route dampening is enabled.
|
*d
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
Autonomous system path of the route that is being dampened.
|
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
clear bgp nsap dampening
|
Clears BGP NSAP prefix route dampening information and unsuppresses the suppressed routes.
|
show bgp nsap filter-list
To display routes in the Border Gateway Protocol (BGP) routing table for the network service access point (NSAP) address family that conform to a specified filter list, use the show bgp nsap filter-list command in privileged EXEC mode.
show bgp nsap filter-list access-list-number
Syntax Description
access-list-number
|
Number of an autonomous system path access list. It can be a number from 1 to 199.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Examples
The following is sample output from the show bgp nsap filter-list command:
Router# show bgp nsap filter-list 1
BGP table version is 3, local router ID is 10.0.11.33
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0b0b 49.0b0b.bbbb.bbbb.bbbb.bbbb.00
Table 9 describes the significant fields shown in the display.
Table 9 show bgp nsap filter-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number for the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Set through the use of autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp nsap flap-statistics
To display Border Gateway Protocol (BGP) flap statistics for network service access point (NSAP) prefixes, use the show bgp nsap flap-statistics command in EXEC mode.
show bgp nsap flap-statistics [regexp regexp | quote-regexp regexp | filter-list access-list-number
| nsap-prefix]
Syntax Description
regexp regexp
|
(Optional) Displays flap statistics for all the paths that match the regular expression.
|
quote-regexp regexp
|
(Optional) Displays flap statistics for all the paths that match the regular expression as a quoted string of characters.
|
filter-list access-list-number
|
(Optional) Displays flap statistics for all the paths that pass the access list.
|
nsap-prefix
|
(Optional) Displays flap statistics for a single entry at this NSAP network number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap flap-statistics command provides output similar to the show ip bgp flap-statistics command, except that it is specific to the NSAP address family.
If no arguments or keywords are specified, the router displays flap statistics for all NSAP prefix routes.
Examples
The following is sample output from the show bgp nsap flap-statistics command without arguments or keywords:
Router# show bgp nsap flap-statistics
BGP table version is 20, local router ID is 10.1.57.13
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network From Flaps Duration Reuse Path
*d 49.0404 10.2.4.2 3 00:09:45 00:23:40 65202 65404
Table 10 describes the significant fields shown in the display.
Table 10 show bgp nsap flap-statistics Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Flaps
|
Number of times the route has flapped.
|
Duration
|
Time (in hours:minutes:seconds) since the router noticed the first flap.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
AS-path of the route that is being dampened.
|
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
clear bgp nsap flap-statistics
|
Clears BGP flap statistics for NSAP prefix routes.
|
show bgp nsap inconsistent-as
To display Border Gateway Protocol (BGP) network service access point (NSAP) prefix routes with inconsistent originating autonomous systems, use the show bgp nsap inconsistent-as command in EXEC mode.
show bgp nsap inconsistent-as
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap inconsistent-as command provides output similar to the show ip bgp inconsistent-as command, except that it is specific to the NSAP address family.
Use the show bgp nsap inconsistent-as command to discover any BGP routing table entries that contain inconsistent autonomous system path information. Inconsistent autonomous path information is useful for troubleshooting networks because it highlights a configuration error in the network.
Examples
The following is sample output from the show bgp nsap inconsistent-as command. In this example, the network prefix of 49.0a0a has two entries in the BGP routing table showing different originating paths. The originating path information should be the same in both entries.
Router# show bgp nsap inconsistent-as
BGP table version is 3, local router ID is 10.1.57.17
Status codes: s suppressed, d damped, h history, * valid, > best, i -internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 49.0a0a 49.0a0a.cccc.cccc.cccc.00
*> 49.0a0a.aaaa.aaaa.aaaa.00
Table 11 describes the significant fields shown in the display.
Table 11 show bgp nsap inconsistent-as Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp nsap neighbors
To display information about Border Gateway Protocol (BGP) network service access point (NSAP) prefix connections to neighbors, use the show bgp nsap neighbors command in EXEC mode.
show bgp nsap neighbors [ip-address [routes | flap-statistics | advertised-routes | paths regexp |
dampened-routes]]
Syntax Description
ip-address
|
(Optional) IP address of the BGP-speaking neighbor. If you omit this argument, all neighbors are displayed.
|
routes
|
(Optional) Displays all routes received and accepted.
|
flap-statistics
|
(Optional) Displays flap statistics for the routes learned from the neighbor.
|
advertised-routes
|
(Optional) Displays all the routes the networking device advertised to the neighbor.
|
paths regexp
|
(Optional) Regular expression used to match the paths received.
|
dampened-routes
|
(Optional) Displays the dampened routes to the neighbor at the NSAP prefix address specified.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap neighbors command provides output similar to the show ip bgp neighbors command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap neighbors command:
Router# show bgp nsap neighbors 10.0.2.3
BGP neighbor is 10.0.2.3, remote AS 64500, external link
BGP version 4, remote router ID 172.17.1.2
BGP state = Established, up for 00:12:50
Last read 00:00:50, hold time is 180, keepalive interval is 60 seconds
Route refresh: advertised and received(new)
Address family NSAP Unicast: advertised and received
Received 17 messages, 0 notifications, 0 in queue
Sent 17 messages, 0 notifications, 0 in queue
Route refresh request: received 0, sent 0
Default minimum time between advertisement runs is 30 seconds
For address family: NSAP Unicast
BGP table version 5, neighbor version 5
Index 2, Offset 0, Mask 0x4
2 accepted prefixes consume 114 bytes
Prefix advertised 2, suppressed 0, withdrawn 0
Number of NLRIs in the update sent: max 1, min 0
Connections established 1; dropped 0
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Local host: 10.0.2.2, Local port: 11000
Foreign host: 10.0.2.3, Foreign port: 179
Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)
Event Timers (current time is 0x115940):
Timer Starts Wakeups Next
iss: 2052706884 snduna: 2052707371 sndnxt: 2052707371 sndwnd: 15898
irs: 1625021348 rcvnxt: 1625021835 rcvwnd: 15898 delrcvwnd: 486
SRTT: 279 ms, RTTO: 446 ms, RTV: 167 ms, KRTT: 0 ms
minRTT: 0 ms, maxRTT: 300 ms, ACK hold: 200 ms
Flags: higher precedence, nagle
Datagrams (max data segment is 1460 bytes):
Rcvd: 30 (out of order: 0), with data: 19, total data bytes: 486
Sent: 29 (retransmit: 1, fastretransmit: 0), with data: 20, total data bytes: 46
Table 12 describes the significant fields shown in the display.
Table 12 show bgp nsap neighbors Field Descriptions
Field
|
Description
|
BGP neighbor
|
IP address of the BGP neighbor and its autonomous system number.
|
remote AS
|
Autonomous system of the neighbor.
|
link
|
If the neighbor is in the same autonomous system as the router, then the link between them is internal; otherwise, it is considered external.
|
BGP version
|
BGP version being used to communicate with the remote router; the router ID (an IP address) of the neighbor is also specified.
|
remote router ID
|
A 32-bit number written as 4 octets separated by periods (dotted decimal format).
|
BGP state
|
Internal state of this BGP connection.
|
up for
|
Amount of time (in hours:minutes:seconds) that the underlying TCP connection has been in existence.
|
Last read
|
Time (in hours:minutes:seconds) that BGP last read a message from this neighbor.
|
hold time
|
Maximum amount of time, in seconds, that can elapse between messages from the peer.
|
keepalive interval
|
Time period, in seconds, between sending keepalive packets, which help ensure that the TCP connection is up.
|
Neighbor capabilities
|
BGP capabilities advertised and received from this neighbor.
|
Route refresh
|
Indicates that the neighbor supports dynamic soft reset using the route refresh capability.
|
Address family NSAP Unicast
|
NSAP unicast-specific properties of this neighbor.
|
Received
|
Number of total BGP messages received from this peer, including keepalives.
|
notifications
|
Number of error messages received from the peer.
|
Sent
|
Total number of BGP messages that have been sent to this peer, including keepalives.
|
notifications
|
Number of error messages the router has sent to this peer.
|
Route refresh request
|
Number of route refresh requests sent and received from this neighbor.
|
advertisement runs
|
Value of minimum advertisement interval.
|
For address family
|
Address family to which the following fields refer.
|
BGP table version
|
Indicates that the neighbor has been updated with this version of the primary BGP routing table.
|
neighbor version
|
Number used by the software to track the prefixes that have been sent and those that must be sent to this neighbor.
|
Community attribute (not shown in sample output)
|
Appears if the neighbor send-community command is configured for this neighbor.
|
Inbound path policy (not shown in sample output)
|
Indicates that an inbound filter list or route map is configured.
|
Outbound path policy (not shown in sample output)
|
Indicates that an outbound filter list, route map, or unsuppress map is configured.
|
bgp-in (not shown in sample output)
|
Name of the inbound update prefix filter list for the NSAP unicast address family.
|
aggregate (not shown in sample output)
|
Name of the outbound update prefix filter list for the NSAP unicast address family.
|
uni-out (not shown in sample output)
|
Name of the outbound route map for the NSAP unicast address family.
|
accepted prefixes
|
Number of prefixes accepted.
|
Prefix advertised
|
Number of prefixes advertised.
|
suppressed
|
Number of prefixes suppressed.
|
withdrawn
|
Number of prefixes withdrawn.
|
history paths (not shown in sample output)
|
Number of path entries held to remember history.
|
Connections established
|
Number of times the router has established a TCP connection and the two peers have agreed to speak BGP with each other.
|
dropped
|
Number of times that a good connection has failed or been taken down.
|
Last reset
|
Elapsed time since this peering session was last reset.
|
Connection state
|
State of the BGP peer.
|
unread input bytes
|
Number of bytes of packets still to be processed.
|
Local host, Local port
|
Peering address of local router, plus port.
|
Foreign host, Foreign port
|
Peering address of the neighbor.
|
Event Timers
|
Table that displays the number of starts and wakeups for each timer.
|
iss
|
Initial send sequence number.
|
snduna
|
Last send sequence number the local host sent but for which it has not received an acknowledgment.
|
sndnxt
|
Sequence number the local host will send next.
|
sndwnd
|
TCP window size of the remote host.
|
irs
|
Initial receive sequence number.
|
rcvnxt
|
Last receive sequence number the local host has acknowledged.
|
rcvwnd
|
TCP window size of the local host.
|
delrcvwnd
|
Delayed receive window—data the local host has read from the connection but has not yet subtracted from the receive window the host has advertised to the remote host. The value in this field gradually increases until it is larger than a full-sized packet, at which point it is applied to the rcvwnd field.
|
SRTT
|
Calculated smoothed round-trip time (SRTT).
|
RTTO
|
Round-trip timeout.
|
RTV
|
Variance of the round-trip time.
|
KRTT
|
New round-trip timeout (using the Karn algorithm). This field separately tracks the round-trip time of packets that have been re-sent.
|
minRTT
|
Smallest recorded round-trip timeout (hard wire value used for calculation).
|
maxRTT
|
Largest recorded round-trip timeout.
|
ACK hold
|
Time (in milliseconds) the local host will delay an acknowledgment in order to "piggyback" data on it.
|
Flags
|
IP precedence of the BGP packets.
|
Datagrams: Rcvd
|
Number of update packets received from neighbor.
|
with data
|
Number of update packets received with data.
|
total data bytes
|
Total bytes of data.
|
Sent
|
Number of update packets sent.
|
with data
|
Number of update packets with data sent.
|
total data bytes
|
Total number of data bytes.
|
The following is sample output from the show bgp nsap neighbors command with the advertised-routes keyword:
Router# show bgp nsap neighbors 10.0.2.3 advertised-routes
BGP table version is 5, local router ID is 172.17.1.2
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0101 49.0101.1111.1111.1111.1111.00
*> 49.0202 49.0202.2222.2222.2222.2222.00
The following is sample output from the show bgp nsap neighbors command with the routes keyword:
Router# show bgp nsap neighbors 10.0.2.3 routes
BGP table version is 5, local router ID is 172.17.1.2
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 49.0303 49.0303.3333.3333.3333.3333.00
*> 49.0404 49.0303.3333.3333.3333.3333.00
Total number of prefixes 2
Table 13 describes the significant fields shown in the display.
Table 13 show bgp nsap neighbors Field Descriptions with advertised-routes and routes keywords
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
The following is sample output from the show bgp nsap neighbors command with the paths keyword:
Router# show bgp nsap neighbors 10.0.3.3 paths ^101
Address Refcount Metric Path
Note The caret (^) symbol in the example is a regular expression that is entered by simultaneously pressing the Shift and 6 keys on your keyboard. A caret (^) symbol at the beginning of a regular expression matches the start of a line.
Table 14 describes the significant fields shown in the display.
Table 14 show bgp nsap neighbors paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multiple Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The AS-path for that route, followed by the origin code for that route.
|
The following sample output from the show bgp nsap neighbors command shows the NSAP prefix dampened routes for the neighbor at 10.0.2.2:
Router# show bgp nsap neighbors 10.0.2.2 dampened-routes
BGP table version is 10, local router ID is 172.17.1.2
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
*d 49.0101 10.0.2.2 00:25:50 202 101 i
The following sample output from the show bgp nsap neighbors command shows the NSAP prefix flap statistics for the neighbor at 10.0.2.2:
Router# show bgp nsap neighbors 10.0.2.2 flap-statistics
BGP table version is 10, local router ID is 10.1.57.14
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network From Flaps Duration Reuse Path
*d 49.0101 10.0.2.2 3 00:07:00 00:24:50 202 101
Related Commands
Command
|
Description
|
neighbor activate
|
Enables the exchange of information with a neighboring router.
|
show bgp nsap paths
To display all the Border Gateway Protocol (BGP) network service access point (NSAP) prefix paths in the database, use the show bgp nsap paths command in EXEC mode.
show bgp nsap paths [AS-path-regexp]
Syntax Description
AS-path-regexp
|
(Optional) Regular expression that is used to match the received paths in the database.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap paths command provides output similar to the show ip bgp paths command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap paths command without a specified regular expression:
Router# show bgp nsap paths
Address Hash Refcount Metric Path
0x62280364 1197 1 0 202 101 i
0x62280448 1739 1 0 202 i
0x622803B0 1941 1 0 404 i
Table 15 describes the significant fields shown in the display.
Table 15 show bgp nsap paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Hash
|
Hash bucket where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multiple Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The AS-path for that route, followed by the origin code for that route.
|
show bgp nsap quote-regexp
To display Border Gateway Protocol (BGP) network service access point (NSAP) prefix routes matching the AS-path regular expression as a quoted string of characters, use the show bgp nsap quote-regexp command in privileged EXEC mode.
show bgp nsap quote-regexp as-path-regexp
Syntax Description
as-path-regexp
|
Regular expression to match the BGP autonomous system paths. The regular expression is contained within quotes.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap quote-regexp command provides output similar to the show ip bgp quote-regexp command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap quote-regexp command that shows paths equal to 202:
Router# show bgp nsap quote-regexp "202"
BGP table version is 10, local router ID is 10.1.57.14
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*d 49.0101 49.0202.2222.2222.2222.2222.00
*> 49.0202 49.0202.2222.2222.2222.2222.00
Table 16 describes the significant fields shown in the display.
Table 16 show bgp nsap quote-regexp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
show bgp nsap regexp
|
Displays NSAP prefix routes matching the AS-path regular expression.
|
show bgp nsap regexp
To display Border Gateway Protocol (BGP) network service access point (NSAP) prefix routes matching the AS-path regular expression, use the show bgp nsap regexp command in privileged EXEC mode.
show bgp nsap regexp AS-path-regexp
Syntax Description
AS-path-regexp
|
Regular expression to match the BGP autonomous system paths.
|
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap regexp command provides output similar to the show ip bgp regexp command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap regexp command that shows paths beginning with 202 or containing 101:
Router# show bgp nsap regexp ^202 101
BGP table version is 10, local router ID is 10.1.57.14
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*d 49.0101 49.0202.2222.2222.2222.2222.00
Note The caret (^) symbol in the example is a regular expression that is entered by simultaneously pressing the Shift and 6 keys on your keyboard. A caret (^) symbol at the beginning of a regular expression matches the start of a line.
Table 17 describes the significant fields shown in the display.
Table 17 show bgp nsap regexp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a route that is redistributed into BGP from an IGP.
|
Network
|
NSAP prefix address of a network entity.
|
Next Hop
|
CLNS network entity title (NET) consisting of area address and system ID of the next system that is used when forwarding a packet to the destination network. This entry may cause a line break with the values of the following fields being displayed on the next line under their respective titles.
|
Metric
|
If shown, the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
show bgp nsap quote-regexpp
|
Displays BGP NSAP prefix routes matching the AS-path regular expression.
|
show bgp nsap summary
To display the status of all Border Gateway Protocol (BGP) network service access point (NSAP) prefix connections, use the show bgp nsap summary command in EXEC mode.
show bgp nsap summary
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(8)T
|
This command was introduced.
|
Usage Guidelines
The show bgp nsap summary command provides output similar to the show ip bgp summary command, except that it is specific to the NSAP address family.
Examples
The following is sample output from the show bgp nsap summary command:
Router# show bgp nsap summary
BGP router identifier 10.2.4.2, local AS number 65202
BGP table version is 26, main routing table version 26
5 network entries and 8 paths using 1141 bytes of memory
6 BGP path attribute entries using 360 bytes of memory
4 BGP AS-PATH entries using 96 bytes of memory
0 BGP route-map cache entries using 0 bytes of memory
0 BGP filter-list cache entries using 0 bytes of memory
Dampening enabled. 0 history paths, 0 dampened paths
BGP activity 16/261 prefixes, 34/26 paths, scan interval 60 secs
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.1.2.1 4 65101 1162 1162 26 0 0 18:17:07 1
10.2.3.3 4 65202 1183 1188 26 0 0 18:23:28 3
10.2.4.4 4 65303 1163 1187 26 0 0 18:23:14 2
Table 18 describes the significant fields shown in the display.
.
Table 18 show bgp nsap summary Field Descriptions
Field
|
Description
|
BGP router identifier
|
IP address of the networking device.
|
local AS number
|
Number of the local autonomous system.
|
BGP table version
|
Internal version number of the BGP database.
|
main routing table version
|
Last version of the BGP database that was injected into the main routing table.
|
network entries
|
Number of network entries and paths in the main routing table including the associated memory usage.
|
BGP path attribute entries
|
Number of BGP path attribute entries in the main routing table including the associated memory usage.
|
BGP route-map cache entries
|
Number of BGP route map cache entries in the main routing table including the associated memory usage.
|
BGP filter-list cache entries
|
Number of BGP filter list cache entries in the main routing table including the associated memory usage.
|
Dampening
|
Indicates whether route dampening is enabled, the number of history paths, and number of dampened paths.
|
BGP activity
|
Displays the number of BGP prefixes and paths, followed by the BGP scan interval in seconds.
|
Neighbor
|
IP address of a neighbor.
|
V
|
BGP version number communicated to that neighbor.
|
AS
|
Autonomous system.
|
MsgRcvd
|
BGP messages received from that neighbor.
|
MsgSent
|
BGP messages sent to that neighbor.
|
TblVer
|
Last version of the BGP database that was sent to that neighbor.
|
InQ
|
Number of messages from that neighbor waiting to be processed.
|
OutQ
|
Number of messages waiting to be sent to that neighbor.
|
Up/Down
|
The length of time that the BGP session has been in state Established, or the current state if it is not Established.
|
State/PfxRcd
|
Current state of the BGP session/the number of prefixes the router has received from a neighbor or peer group. When the maximum number (as set by the neighbor maximum-prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is Idle.
An (Admin) entry with Idle status indicates that the connection has been shut down using the neighbor shutdown command.
|
Related Commands
Command
|
Description
|
clear bgp nsap
|
Resets an NSAP BGP TCP connection.
|
neighbor maximum-prefix
|
Controls how many prefixes can be received from a neighbor.
|
neighbor shutdown
|
Disables a neighbor or peer group.
|
show dampening interface
To display a summary of dampened interfaces, use the show damping interface command in EXEC mode.
show dampening interface
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
Examples
The following is sample output from the show damping interface command in EXEC mode:
Router# show dampening interface
3 interfaces are configured with dampening.
No interface is being suppressed.
Features that are using interface dampening:
Table 19 describes the significant fields shown in the sample output of the show dampening interface command.
Table 19 show dampening interface Field Descriptions
Field
|
Description
|
... interfaces are configured with dampening.
|
Displays the number of interfaces that are configured for event dampening.
|
No interface is being suppressed.
|
Displays the suppression status of the interfaces that are configured for event dampening.
|
Features that are using interface dampening:
|
Displays the routing protocols that are configured to perceived interface dampening.
|
Related Commands
Command
|
Description
|
clear counters
|
Clears the interface counters.
|
dampening
|
Enables IP event dampening at the interface level.
|
show interface dampening
|
Displays a summary of the dampening parameters and status.
|
show interface dampening
To display dampened interfaces on the local router, use the show interface dampening command in EXEC mode.
show ip interface dampening
Syntax Description
This command has no keywords or arguments.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
Examples
The following is sample output from the show interface dampening command:
Router# show interface dampening
Flaps Penalty Supp ReuseTm HalfL ReuseV SuppV MaxSTm MaxP Restart
0 0 FALSE 0 5 1000 2000 20 16000 0
Table 20 describes the significant fields shown in the display.
Table 20 show interface dampening Field Descriptions
Field
|
Description
|
Flaps
|
Displays the number of times that an interface has flapped.
|
Penalty
|
Displays the accumulated penalty.
|
Supp
|
Indicates if the interface is dampened.
|
ReuseTm
|
Displays the reuse timer.
|
HalfL
|
Displays the half-life counter.
|
ReuseV
|
Displays the reuse threshold timer.
|
SuppV
|
Displays the suppress threshold.
|
MaxSTm
|
Displays the maximum suppress.
|
MaxP
|
Displays the maximum penalty.
|
Restart
|
Displays the restart timer.
|
Related Commands
Command
|
Description
|
clear counters
|
Clears the interface counters.
|
dampening
|
Enables IP event dampening at the interface level.
|
show dampening interface
|
Displays a summary of interface dampening.
|
show ip bgp
To display entries in the Border Gateway Protocol (BGP) routing table, use the show ip bgp command in user EXEC or privileged EXEC mode.
show ip bgp [ip-address [mask [longer-prefixes [injected] | shorter-prefixes [length]]] | all |
oer-paths | prefix-list name | route-map name]
Syntax Description
ip-address
|
(Optional) IP address entered to filter the output to display only a particular host or network in the BGP routing table.
|
mask
|
(Optional) Mask to filter or match hosts that are part of the specified network.
|
longer-prefixes
|
(Optional) Displays the specified route and all more specific routes.
|
injected
|
(Optional) Displays more specific prefixes injected into the BGP routing table.
|
shorter-prefix
|
(Optional) Displays the specified route and all less specific routes.
|
length
|
(Optional) Specifies the prefix length. The value for this argument is a number from 0 to 32.
|
all
|
(Optional) Displays all address family information in the BGP routing table.
|
oer-paths
|
(Optional) Displays OER controlled prefixes in the BGP routing table.
|
prefix-list name
|
(Optional) Filters the output based on the specified prefix list.
|
route-map name
|
(Optional) Filters the output based on the specified route map.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The display of prefix advertisement statistics was added.
|
12.0(6)T
|
The display of a message indicating support for route refresh capability was added.
|
12.0(14)ST
|
The prefix-list, route-map, and shorter-prefixes keywords were added.
|
12.2(2)T
|
The output was modified to display multipaths and a best path to the specified network.
|
12.0(21)ST
|
The output was modified to show the number of MPLS labels that arrive at and depart from the prefix.
|
12.0(22)S
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
12.2(14)S
|
A message indicating support for BGP policy accounting was added and this command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(14)SX
|
This command was integrated into Cisco IOS Release 12.2(14)SX.
|
12.2(15)T
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
12.3(2)T
|
The all keyword was added.
|
12.2(17b)SXA
|
This command was integrated into Cisco IOS Release 12.2(17b)SXA.
|
12.3(8)T
|
The oer-paths keyword was added.
|
Usage Guidelines
The show ip bgp command is used to display the contents of the BGP routing table. The output can be filtered to display entries for a specific prefix, prefix length, and prefixes injected through a prefix list, route map, or conditional advertisement.
oer-paths keyword
BGP prefixes that are monitored and controlled by Optimized Edge Routing (OER) are displayed by entering the show ip bgp command with the oer-paths keyword.
Examples
show ip bgp example
The following example output shows the BGP routing table:
BGP table version is 5, local router ID is 10.0.33.34
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.1.0.0 0.0.0.0 0 32768 ?
* 10.2.0.0 10.0.33.35 10 0 35 ?
* 10.0.0.0 10.0.33.35 10 0 35 ?
*> 192.168.0.0/16 10.0.33.35 10 0 35 ?
Table 21 describes the significant fields shown in the display.
Table 21 show ip bgp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
(stale)
|
Indicates that the following path for the specified autonomous system is marked as "stale" during a graceful restart process.
|
show ip bgp ip-address example
The following example displays information about the 192.168.1.0 entry in the BGP routing table:
Router B# show ip bgp 192.168.1.0
BGP routing table entry for 192.168.1.0/24, version 48
Paths: (2 available, best #2, table Default-IP-Routing-Table)
Advertised to update-groups:
172.16.1.1 from 172.16.1.1 (10.1.1.1)
Origin incomplete, metric 0, localpref 100, valid, external, multipath, best
Extended Community: 0x0:0:0
172.16.2.2 from 172.16.2.2 (10.2.2.2)
Origin incomplete, metric 0, localpref 100, valid, external, multipath, best
Extended Community: 0x0:0:0
Table 22 describes the significant fields shown in the display.
Table 22 show ip bgp Field Descriptions
Field
|
Description
|
BGP routing table entry for...
|
IP address or network number of the routing table entry.
|
version...
|
Internal version number of the table. This number is incremented whenever the table changes.
|
Paths:
|
The number of available paths, and the number of installed best paths. This line dispays "Default-IP-Routing-Table" when the best path is installed in the IP routing table.
|
Multipath:
|
This field is displayed when multipath loadsharing is enabled. This field will indicate if the multipaths are iBGP or eBGP.
|
Advertised to update-groups:
|
The number of each update group for which advertisements are processed.
|
Origin
|
Origin of the entry. The origin can be IGP, EGP, or incomplete. This line displays the configured metric (0 if no metric is configured), the local preference value (100 is default), and the status and type of route (internal, external, multipath, best).
|
Extended Community
|
This field is displayed if the route carries an extended community attribute. The attribute code is displayed on this line. Information about the extended community is displayed on a subsequent line.
|
show ip bgp all example
The following example output from the show ip bgp command entered with the all keyword. Information about all configured address families is displayed.
For address family: IPv4 Unicast *****
BGP table version is 27, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.1.1.0/24 0.0.0.0 0 32768 ?
*> 10.13.13.0/24 0.0.0.0 0 32768 ?
*> 10.15.15.0/24 0.0.0.0 0 32768 ?
*>i10.18.18.0/24 172.16.14.105 1388 91351 0 100 e
*>i10.100.0.0/16 172.16.14.107 262 272 0 1 2 3 i
*>i10.100.0.0/16 172.16.14.105 1388 91351 0 100 e
*>i10.101.0.0/16 172.16.14.105 1388 91351 0 100 e
*>i10.103.0.0/16 172.16.14.101 1388 173 173 100 e
*>i10.104.0.0/16 172.16.14.101 1388 173 173 100 e
*>i10.100.0.0/16 172.16.14.106 2219 20889 0 53285 33299 51178 47751 e
*>i10.101.0.0/16 172.16.14.106 2219 20889 0 53285 33299 51178 47751 e
* 10.100.0.0/16 172.16.14.109 2309 0 200 300 e
*> 172.16.14.108 1388 0 100 e
* 10.101.0.0/16 172.16.14.109 2309 0 200 300 e
*> 172.16.14.108 1388 0 100 e
*> 10.102.0.0/16 172.16.14.108 1388 0 100 e
*> 172.16.14.0/24 0.0.0.0 0 32768 ?
*> 192.168.5.0 0.0.0.0 0 32768 ?
*> 10.80.0.0/16 172.16.14.108 1388 0 50 e
*> 10.80.0.0/16 172.16.14.108 1388 0 50 e
For address family: VPNv4 Unicast *****
BGP table version is 21, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
Route Distinguisher: 1:1 (default for vrf vpn1)
*> 10.1.1.0/24 192.168.4.3 1622 0 100 53285 {27016,16690} e
*> 10.1.2.0/24 192.168.4.3 1622 0 100 53285 {27016,16690} e
*> 10.1.3.0/24 192.168.4.3 1622 0 100 53285 {27016,16690} e
*> 10.1.4.0/24 192.168.4.3 1622 0 100 53285 {27016,16690} e
*> 10.1.5.0/24 192.168.4.3 1622 0 100 53285 {27016,16690} e
*>i172.14.1.0/24 10.3.3.3 10 30 0 53285 47751 ?
*>i172.14.2.0/24 10.3.3.3 10 30 0 53285 47751 ?
*>i172.14.3.0/24 10.3.3.3 10 30 0 53285 47751 ?
*>i172.14.4.0/24 10.3.3.3 10 30 0 53285 47751 ?
*>i172.14.5.0/24 10.3.3.3 10 30 0 53285 47751 ?
For address family: IPv4 Multicast *****
BGP table version is 11, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.40.40.0/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 1622 0 15 20 1 {2} e
*> 10.40.40.64/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 1622 0 15 20 1 {2} e
*> 10.40.40.128/26 172.16.14.110 2219 0 21 22 {51178,47751,27016} e
* 10.1.1.1 2563 0 15 20 1 {2} e
*> 10.40.40.192/26 10.1.1.1 2563 0 15 20 1 {2} e
*> 10.40.41.0/26 10.1.1.1 1209 0 15 20 1 {2} e
*>i10.102.0.0/16 10.1.1.1 300 500 0 5 4 {101,102} e
*>i10.103.0.0/16 10.1.1.1 300 500 0 5 4 {101,102} e
For address family: NSAP Unicast *****
BGP table version is 1, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* i45.0000.0002.0001.000c.00
* i46.0001.0000.0000.0000.0a00
* i47.0001.0000.0000.000b.00
* i47.0001.0000.0000.000e.00
49.0001.0000.0000.0a00
show ip bgp longer-prefixes example
The following is example output from the show ip bgp command entered with the longer-prefixes keyword:
Router# show ip bgp 10.92.0.0 255.255.0.0 longer-prefixes
BGP table version is 1738, local router ID is 192.168.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.92.0.0 10.92.72.30 8896 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.1.0 10.92.72.30 8796 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.11.0 10.92.72.30 42482 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.14.0 10.92.72.30 8796 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.15.0 10.92.72.30 8696 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.16.0 10.92.72.30 1400 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.17.0 10.92.72.30 1400 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.18.0 10.92.72.30 8876 32768 ?
* 10.92.72.30 0 109 108 ?
*> 10.92.19.0 10.92.72.30 8876 32768 ?
* 10.92.72.30 0 109 108 ?
show ip bgp shorter-prefixes example
The following is example output from the show ip bgp command entered with the shorter-prefixes keyword. An 8 bit prefix length is specified.
Router# show ip bgp 172.16.0.0/16 shorter-prefixes 8
*> 172.16.0.0 10.0.0.2 0 ?
show ip bgp prefix-list example
The following is example output from the show ip bgp command entered with the prefix-list keyword:
Router# show ip bgp prefix-list ROUTE
BGP table version is 39, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.1.0 10.0.0.2 0 ?
show ip bgp route-map example
The following is example output from the show ip bgp command entered with the route-map keyword:
Router# show ip bgp route-map LEARNED_PATH
BGP table version is 40, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.1.0 10.0.0.2 0 ?
show ip bgp cidr-only
To display routes with nonnatural network masks (that is, classless interdomain routing, or CIDR), use the show ip bgp cidr-only command in EXEC mode.
show ip bgp cidr-only
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp cidr-only command in privileged EXEC mode:
Router# show ip bgp cidr-only
BGP table version is 220, local router ID is 172.16.73.131
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.0.0/8 172.16.72.24 0 1878 ?
*> 172.16.0.0/16 172.16.72.30 0 108 ?
Table 23 describes the significant fields shown in the display.
Table 23 show ip bgp cidr-only Field Descriptions
Field
|
Description
|
BGP table version is 220
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
Internet address of the network the entry describes.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the access server has some non-BGP route to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path. At the end of the path is the origin code for the path:
i—The entry was originated with the IGP and advertised with a network router configuration command.
e—The route originated with EGP.
?—The origin of the path is not clear. Usually this is a path that is redistributed into BGP from an IGP.
|
show ip bgp community
To display routes that belong to specified BGP communities, use the show ip bgp community command in EXEC mode.
show ip bgp community community-number [exact]
Syntax Description
community-number
|
Valid value is a community number in the range from 1 to 4294967200, or AA:NN (autonomous system-community number/2-byte number), internet, no-export, local-as, or no-advertise.
|
exact
|
(Optional) Displays only routes that have the same specified communities.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0
|
The local-as community was added.
|
Examples
The following is sample output from the show ip bgp community command in privileged EXEC mode:
router# show ip bgp community 111:12345 local-as
BGP table version is 10, local router ID is 224.0.0.10
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 172.16.2.2/32 10.43.222.2 0 0 222 ?
*> 10.0.0.0 10.43.222.2 0 0 222 ?
*> 10.43.0.0 10.43.222.2 0 0 222 ?
*> 10.43.44.44/32 10.43.222.2 0 0 222 ?
* 10.43.222.0/24 10.43.222.2 0 0 222 i
*> 172.17.240.0/21 10.43.222.2 0 0 222 ?
*> 192.168.212.0 10.43.222.2 0 0 222 i
*> 172.31.1.0 10.43.222.2 0 0 222 ?
Table 24 describes the significant fields shown in the display.
Table 24 show ip bgp community Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show ip bgp community-list
To display routes that are permitted by the Border Gateway Protocol (BGP) community list, use the show ip bgp community-list command in EXEC mode.
show ip bgp community-list {standard-community-list-number |
expanded-community-list-number | community-list-name [exact-match]}
Syntax Description
standard-community-list-number
|
Community list number in the range from 1 to 99.
|
expanded-community-list-number
|
Community list number in the range from 100 to 199.
|
community-list-name
|
Community list name. The community list name can be standard or expanded.
|
exact-match
|
(Optional) Displays only routes that have an exact match.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0(10)S
|
Named community list support was added.
|
12.0(16)ST
|
Named community lists support was integrated into Cisco IOS Release 12.0(16)ST.
|
12.1(9)E
|
Named community lists support was integrated into Cisco IOS Release 12.1(9)E.
|
12.2(8)T
|
Named community lists support was integrated into Cisco IOS Release 12.2(8)T.
|
Usage Guidelines
This command requires the network operator to specify an argument when used. The exact-match keyword is optional.
Examples
The following is sample output of the show ip bgp community-list command in privileged EXEC mode:
Router# show ip bgp community-list 20
BGP table version is 716977, local router ID is 192.168.32.1
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* i10.3.0.0 10.0.22.1 0 100 0 1800 1239 ?
*>i 10.0.16.1 0 100 0 1800 1239 ?
* i10.6.0.0 10.0.22.1 0 100 0 1800 690 568 ?
*>i 10.0.16.1 0 100 0 1800 690 568 ?
* i10.7.0.0 10.0.22.1 0 100 0 1800 701 35 ?
*>i 10.0.16.1 0 100 0 1800 701 35 ?
* 10.92.72.24 0 1878 704 701 35 ?
* i10.8.0.0 10.0.22.1 0 100 0 1800 690 560 ?
*>i 10.0.16.1 0 100 0 1800 690 560 ?
* 10.92.72.24 0 1878 704 701 560 ?
* i10.13.0.0 10.0.22.1 0 100 0 1800 690 200 ?
*>i 10.0.16.1 0 100 0 1800 690 200 ?
* 10.92.72.24 0 1878 704 701 200 ?
* i10.15.0.0 10.0.22.1 0 100 0 1800 174 ?
*>i 10.0.16.1 0 100 0 1800 174 ?
* i10.16.0.0 10.0.22.1 0 100 0 1800 701 i
*>i 10.0.16.1 0 100 0 1800 701 i
* 10.92.72.24 0 1878 704 701 i
Table 25 describes the significant fields shown in the display.
Table 25 show ip bgp community-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show ip bgp dampened-paths
To display BGP dampened routes, use the show ip bgp dampened-paths command in EXEC mode.
show ip bgp dampened-paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp dampened-paths command in privileged EXEC mode:
Router# show ip bgp dampened-paths
BGP table version is 10, local router ID is 172.29.232.182
Status codes: s suppressed, d damped, h history, * valid, > best, i -
Origin codes: i - IGP, e - EGP, ? - incomplete
*d 10.0.0.0 172.16.232.177 00:18:4 100 ?
*d 10.2.0.0 172.16.232.177 00:28:5 100 ?
Table 26 describes the significant fields shown in the display.
Table 26 show ip bgp dampened-paths Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router
|
IP address of the router where route dampening is enabled.
|
*d
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
Autonomous system path of the route that is being dampened.
|
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
clear ip bgp dampening
|
Clears BGP route dampening information and unsuppresses the suppressed routes.
|
show ip bgp filter-list
To display routes that conform to a specified filter list, use the show ip bgp filter-list command in EXEC mode.
show ip bgp filter-list access-list-number
Syntax Description
access-list-number
|
Number of an autonomous system path access list. It can be a number from 1 to 199.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp filter-list command in privileged EXEC mode:
Router# show ip bgp filter-list 2
BGP table version is 1738, local router ID is 172.16.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 172.16.0.0 172.16.72.30 0 109 108 ?
* 172.16.1.0 172.16.72.30 0 109 108 ?
* 172.16.11.0 172.16.72.30 0 109 108 ?
* 172.16.14.0 172.16.72.30 0 109 108 ?
* 172.16.15.0 172.16.72.30 0 109 108 ?
* 172.16.16.0 172.16.72.30 0 109 108 ?
* 172.16.17.0 172.16.72.30 0 109 108 ?
* 172.16.18.0 172.16.72.30 0 109 108 ?
* 172.16.19.0 172.16.72.30 0 109 108 ?
* 172.16.24.0 172.16.72.30 0 109 108 ?
* 172.16.29.0 172.16.72.30 0 109 108 ?
* 172.16.30.0 172.16.72.30 0 109 108 ?
* 172.16.33.0 172.16.72.30 0 109 108 ?
* 172.16.35.0 172.16.72.30 0 109 108 ?
* 172.16.36.0 172.16.72.30 0 109 108 ?
* 172.16.37.0 172.16.72.30 0 109 108 ?
* 172.16.38.0 172.16.72.30 0 109 108 ?
* 172.16.39.0 172.16.72.30 0 109 108 ?
Table 27 describes the significant fields shown in the display.
Table 27 show ip bgp filter-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
Internet address of the network the entry describes.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP route to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path. At the end of the path is the origin code for the path:
i—The entry was originated with the IGP and advertised with a network router configuration command.
e—The route originated with EGP.
?—The origin of the path is not clear. Usually this is a path that is redistributed into BGP from an IGP.
|
show ip bgp flap-statistics
To display BGP flap statistics, use the show ip bgp flap-statistics command in EXEC mode.
show ip bgp flap-statistics [{regexp regexp} | {filter-list access-list} | {ip-address mask
[longer-prefix]}]
Syntax Description
regexp regexp
|
(Optional) Clears flap statistics for all the paths that match the regular expression.
|
filter-list access-list
|
(Optional) Clears flap statistics for all the paths that pass the access list.
|
ip-address
|
(Optional) Clears flap statistics for a single entry at this IP address.
|
mask
|
(Optional) Network mask applied to the value.
|
longer-prefix
|
(Optional) Displays flap statistics for more specific entries.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
If no arguments or keywords are specified, the router displays flap statistics for all routes.
Examples
The following is sample output from the show ip bgp flap-statistics command in privileged EXEC mode:
Router# show ip bgp flap-statistics
BGP table version is 10, local router ID is 172.29.232.182
Status codes: s suppressed, d damped, h history, * valid, > best, i -
Origin codes: i - IGP, e - EGP, ? - incomplete
Network From Flaps Duration Reuse Path
*d 10.0.0.0 172.29.232.177 4 00:13:31 00:18:10 100
*d 10.2.0.0 172.29.232.177 4 00:02:45 00:28:20 100
Table 28 describes the significant fields shown in the display.
Table 28 show ip bgp flap-statistics Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router where route dampening is enabled.
|
Network
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Flaps
|
Number of times the route has flapped.
|
Duration
|
Time (in hours:minutes:seconds) since the router noticed the first flap.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
Autonomous system path of the route that is being dampened.
|
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
clear ip bgp flap-statistics
|
Clears BGP flap statistics.
|
show ip bgp inconsistent-as
To display routes with inconsistent originating autonomous systems, use the show ip bgp inconsistent-as command in EXEC mode.
show ip bgp inconsistent-as
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp inconsistent-as command in privileged EXEC mode:
Router# show ip bgp inconsistent-as
BGP table version is 87, local router ID is 172.19.82.53
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 10.1.0.0 172.29.232.55 0 0 300 88 90 99 ?
*> 172.29.232.52 2222 0 400 ?
* 172.29.0.0 172.29.232.55 0 0 300 90 99 88 200 ?
*> 172.29.232.52 2222 0 400 ?
* 10.200.199.0 172.29.232.55 0 0 300 88 90 99 ?
*> 172.29.232.52 2222 0 400 ?
show ip bgp injected-paths
To display all the injected paths in the Border Gateway Protocol (BGP) routing table, use the show ip bgp injected-paths command in EXEC mode.
show ip bgp injected-paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(14)ST
|
This command was introduced.
|
12.2(4)T
|
This command was integrated into Cisco IOS Release 12.2(4)T.
|
Examples
The following is sample output from the show ip bgp injected-paths command in EXEC mode:
Router# show ip bgp injected-paths
BGP table version is 11, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 172.16.0.0 10.0.0.2 0 ?
*> 172.17.0.0/16 10.0.0.2 0 ?
Table 29 describes the significant fields shown in the display.
Table 29 show ip bgp injected-paths Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show ip bgp ipv4
To display entries in the IP version 4 (IPv4) Border Gateway Protocol (BGP) routing table, use the show ip bgp ipv4 command in EXEC mode.
show ip bgp ipv4 {multicast | unicast}
Syntax Description
multicast
|
Displays entries for multicast routes.
|
unicast
|
Displays entries for unicast routes.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp ipv4 unicast command:
Router# show ip bgp ipv4 unicast
BGP table version is 4, local router ID is 10.0.40.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.10.10.0/24 172.16.10.1 0 0 300 i
*> 10.10.20.0/24 172.16.10.1 0 0 300 i
* 10.20.10.0/24 172.16.10.1 0 0 300 i
The following is sample output from the show ip bgp ipv4 multicast command:
Router# show ip bgp ipv4 multicast
BGP table version is 4, local router ID is 10.0.40.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.10.10.0/24 172.16.10.1 0 0 300 i
*> 10.10.20.0/24 172.16.10.1 0 0 300 i
* 10.20.10.0/24 172.16.10.1 0 0 300 i
Table 30 describes the significant fields shown in the display.
Table 30 show ip bgp ipv4 unicast Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is damped.
h—The table entry history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is displayed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
show ip bgp
|
Displays entries in the BGP routing table.
|
show ip bgp ipv4 multicast
To display IP Version 4 multicast database-related information, use the show ip bgp ipv4 multicast command in EXEC mode.
show ip bgp ipv4 multicast [command]
Syntax Description
command
|
(Optional) Any multiprotocol BGP command supported by the show ip bgp ipv4 multicast command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(7)T
|
This command was introduced.
|
Usage Guidelines
Use this command in conjunction with the show ip rpf command to determine if IP multicast routing is using multiprotocol BGP routes.
To determine which multiprotocol BGP commands are supported by the show ip bgp ipv4 multicast command, enter the following command while in EXEC mode:
Router# show ip bgp ipv4 multicast ?
The show ip bgp ipv4 multicast command replaces the show ip mbgp command.
Examples
The following is sample output from the show ip bgp ipv4 multicast command:
Router# show ip bgp ipv4 multicast
MBGP table version is 6, local router ID is 192.168.200.66
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.0.20.16/28 0.0.0.0 0 0 32768 i
*> 10.0.35.16/28 0.0.0.0 0 0 32768 i
*> 10.0.36.0/28 0.0.0.0 0 0 32768 i
*> 10.0.48.16/28 0.0.0.0 0 0 32768 i
*> 10.2.0.0/16 0.0.0.0 0 0 32768 i
*> 10.2.1.0/24 0.0.0.0 0 0 32768 i
*> 10.2.2.0/24 0.0.0.0 0 0 32768 i
*> 10.2.3.0/24 0.0.0.0 0 0 32768 i
*> 10.2.7.0/24 0.0.0.0 0 0 32768 i
*> 10.2.8.0/24 0.0.0.0 0 0 32768 i
*> 10.2.10.0/24 0.0.0.0 0 0 32768 i
*> 10.2.11.0/24 0.0.0.0 0 0 32768 i
*> 10.2.12.0/24 0.0.0.0 0 0 32768 i
*> 10.2.13.0/24 0.0.0.0 0 0 32768 i
Table 31 describes the significant fields shown in the display.
Table 31 show ip bgp ipv4 multicast Field Descriptions
Field
|
Description
|
MBGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry is historical.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration or address family configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
show ip rpf
|
Displays how IP multicast routing does RPF.
|
show ip bgp ipv4 multicast summary
To display a summary of IP Version 4 multicast database-related information, use the show ip bgp ipv4 multicast summary command in EXEC mode.
show ip bgp ipv4 multicast summary
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(7)T
|
This command was introduced.
|
Usage Guidelines
The show ip bgp ipv4 multicast summary command replaces the show ip mbgp summary command.
Examples
The following is sample output from the show ip bgp ipv4 multicast summary command:
Router# show ip bgp ipv4 multicast summary
BGP router identifier 10.0.33.34, local AS number 34
BGP table version is 5, main routing table version 1
4 network entries and 6 paths using 604 bytes of memory
5 BGP path attribute entries using 260 bytes of memory
1 BGP AS-PATH entries using 24 bytes of memory
2 BGP community entries using 48 bytes of memory
2 BGP route-map cache entries using 32 bytes of memory
0 BGP filter-list cache entries using 0 bytes of memory
BGP activity 8/28 prefixes, 12/0 paths, scan interval 15 secs
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.0.33.35 4 35 624 624 5 0 0 10:13:46 3
Table 32 describes the significant fields shown in the display.
Table 32 show ip bgp ipv4 multicast summary Field Descriptions
Field
|
Description
|
Neighbor
|
IP address of configured neighbor in the multicast routing table.
|
V
|
Version of multiprotocol BGP used.
|
AS
|
Autonomous system to which the neighbor belongs.
|
MsgRcvd
|
Number of messages received from the neighbor.
|
MsgSent
|
Number of messages sent to the neighbor.
|
TblVer
|
Number of the table version, which is incremented each time the table changes.
|
InQ
|
Number of messages received in the input queue.
|
OutQ
|
Number of messages ready to go in the output queue.
|
Up/Down
|
Days and hours that the neighbor has been up or down (no information in the State column means the connection is up).
|
State/PfxRcd
|
State of the neighbor/number of routes received. If no state is indicated, the state is up.
|
Related Commands
Command
|
Description
|
show ip rpf
|
Displays how IP multicast routing does RPF.
|
show ip bgp neighbors
To display information about the TCP and Border Gateway Protocol (BGP) connections to neighbors, use the show ip bgp neighbors command in EXEC mode.
show ip bgp neighbors [all] [ip-address [advertised-routes | dampened-routes | paths [regexp] |
received prefix-filter | received-routes | routes]]
Syntax Description
all
|
(Optional) Displays neighbor information for all address families. Only IPv4 neighbor information is displayed if this keyword is not entered.
|
ip-address
|
(Optional) IP address of a neighbor. If this argument is omitted, all neighbors are displayed.
|
advertised-routes
|
(Optional) Displays all routes that have been advertised to neighbors.
|
received-routes
|
(Optional) Displays all received routes (both accepted and rejected) from the specified neighbor.
|
routes
|
(Optional) Displays all routes that are received and accepted. The output displayed when this keyword is entered is a subset of the output displayed by the received-routes keyword.
|
paths regexp
|
(Optional) Displays received paths. A regular expression can be used to filter the output.
|
dampened-routes
|
(Optional) Displays the dampened routes to the specified neighbor.
|
received prefix-filter
|
(Optional) Displays the prefix-list (outbound route filter [ORF]) sent from the specified neighbor.
|
Command Default
The output of this command displays information for only IPv4 address family sessions if the all keyword is not entered.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The received-routes keyword was added.
|
12.2(4)T
|
The received prefix-filter keyword was added.
|
12.0(21)ST
|
The output was enhanced to display MPLS label information.
|
12.0(22)S
|
•This command was integrated into Cisco IOS Release 12.0(22)S. Support for the Cisco 12000 series routers (Engine 0 and Engine 2) was added.
•The received prefix-filter keyword was added.
|
Usage Guidelines
The show ip bgp neighbors command is used to display BGP and TCP connection information for neighbor sessions. For BGP, this includes detailed neighbor attribute, capability, path, and prefix information. For TCP, this includes statistics related to BGP neighbor session establishment and maintenance. This command displays information only about IPv4 address-family sessions unless the all keyword is entered.
Prefix activity is displayed based on the number of prefixes that are advertised and withdrawn. Policy denials display the number of routes that were advertised but then ignored based the function or attribute that is displayed in the output.
Examples
show ip bgp neighbors example
The following example shows the 10.108.50.2 neighbor. This neighbor is an internal BGP (iBGP) peer. This neighbor supports the route refresh and graceful restart capabilities.
Router# show ip bgp neighbors 10.108.50.2
BGP neighbor is 10.108.50.2, remote AS 1, internal link
BGP version 4, remote router ID 192.168.252.252
BGP state = Established, up for 00:24:25
Last read 00:00:24, last write 00:00:24, hold time is 180, keepalive interval is 60
seconds
Route refresh: advertised and received(old & new)
Graceful Restart Capabilty:advertised and received
Address family IPv4 Unicast: advertised and received
Default minimum time between advertisement runs is 5 seconds
For address family: IPv4 Unicast
BGP table version 1, neighbor version 1/0
Index 1, Offset 0, Mask 0x2
Prefix activity: ---- ----
Local Policy Denied Prefixes: -------- -------
Number of NLRIs in the update sent: max 0, min 0
Connections established 3; dropped 2
Last reset 00:24:26, due to Peer closed the session
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Connection is ECN Disabled
Local host: 10.108.50.1, Local port: 179
Foreign host: 10.108.50.2, Foreign port: 42698
Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)
Event Timers (current time is 0x68B944):
Timer Starts Wakeups Next
iss: 3915509457 snduna: 3915510016 sndnxt: 3915510016 sndwnd: 15826
irs: 233567076 rcvnxt: 233567616 rcvwnd: 15845 delrcvwnd: 539
SRTT: 292 ms, RTTO: 359 ms, RTV: 67 ms, KRTT: 0 ms
minRTT: 12 ms, maxRTT: 300 ms, ACK hold: 200 ms
Flags: passive open, nagle, gen tcbs
Datagrams (max data segment is 1460 bytes):
Rcvd: 38 (out of order: 0), with data: 27, total data bytes: 539
Sent: 45 (retransmit: 0, fastretransmit: 0, partialack: 0, Second Congestion: 08
Table 33 describes the significant fields shown in the display. Fields that are preceded by the asterisk character are displayed only when the counter has a non-zero value.
Table 33 show ip bgp neighbors Field Descriptions
Field
|
Description
|
BGP neighbor
|
IP address of the BGP neighbor and its autonomous system number.
|
remote AS
|
Autonomous-system number of the neighbor.
|
internal link
|
"internal link" is displayed for iBGP neighbors. "external link" is displayed for external BGP (eBGP) neighbors.
|
BGP version
|
BGP version being used to communicate with the remote router.
|
remote router ID
|
IP address of the neighbor.
|
BGP state
|
Finite state machine (FSM) stage of session negotiation.
|
up for
|
Time, in seconds, that the underlying TCP connection has been in existence.
|
Last read
|
Time since BGP last received a message from this neighbor.
|
last write
|
Time since BGP last sent a message to this neighbor.
|
hold time
|
Time, in seconds, that BGP will maintain the session with this neighbor without receiving a messages.
|
keepalive interval
|
Time, interval in seconds, that keepalive messages are transmitted to this neighbor.
|
Neighbor capabilities
|
BGP capabilities advertised and received from this neighbor. "Advertised and received" is displayed when a capability is successfully exchanged between two routers.
|
Route Refresh
|
Status of the route refresh capability.
|
Graceful Restart Capability
|
Status of the graceful restart capability.
|
Address family IPv4 Unicast
|
IP Version 4 unicast-specific properties of this neighbor.
|
Message statistics
|
Statistics organized by message type.
|
InQ depth is
|
Number of messages in the input queue.
|
OutQ depth is
|
Number of messages in the output queue.
|
Sent
|
Total number of transmitted messages.
|
Received
|
Total number of received messages.
|
Opens
|
Number of open messages sent and received.
|
notifications
|
Number of notification (error) messages sent and received.
|
Updates
|
Number of update messages sent and received.
|
Keepalives
|
Number of keepalive messages sent and received.
|
Route Refresh
|
Number of route refresh request messages sent and received.
|
Total
|
Total number of messages sent and received.
|
Default minimum time between...
|
Time, in seconds, between advertisement transmissions.
|
For address family:
|
Address family for which the following fields refer.
|
BGP table version
|
Internal version number of the table. This is the primary routing table with which the neighbor has been updated. The number increments when the table changes.
|
neighbor version
|
Number used by Cisco IOS to track prefixes that have been sent and those that need to be sent.
|
...update-group
|
Number of update-group member for this address family.
|
Prefix activity
|
Prefix statistics for this address family.
|
Prefixes current
|
Number of prefixes accepted for this address family.
|
Prefixes total
|
Total number of received prefixes.
|
Implicit Withdraw
|
Number of times that a prefix has been withdrawn and readvertised.
|
Explicit Withdraw
|
Number of times that prefix is withdrawn because it is no longer feasible.
|
Used as bestpath
|
Number of received prefixes installed as a best paths.
|
Used as multipath
|
Number of received prefixes installed as multipaths.
|
* Saved (soft-reconfig)
|
Number of soft resets performed with a neighbor that supports soft reconfiguration. This field is displayed only if the counter has a non-zero value.
|
* History paths
|
This field is displayed only if the counter has a non-zero value.
|
* Invalid paths
|
Number of invalid paths. This field is displayed only if the counter has a non-zero value.
|
Local Policy Denied Prefixes
|
Prefixes denied due to local policy configuration. Counters are updated for inbound and outbound policy denials. The fields under this heading are displayed only if the counter has a non-zero value.
|
* route-map
|
Displays inbound and outbound route-map policy denials.
|
* filter-list
|
Displays inbound and outbound filter-list policy denials.
|
* prefix-list
|
Displays inbound and outbound prefix-list policy denials.
|
* Ext Community
|
Displays only outbound extended community policy denials.
|
* AS_PATH too long
|
Displays outbound AS-path length policy denials.
|
* AS_PATH loop
|
Displays outbound AS-path loop policy denials.
|
* AS_PATH confed info
|
Displays outbound confederation policy denials.
|
* AS_PATH contains AS 0
|
Displays outbound denials of AS 0.
|
* NEXT_HOP Martian
|
Displays outbound martian denials.
|
* NEXT_HOP non-local
|
Displays outbound non-local next-hop denials.
|
* NEXT_HOP is us
|
Displays outbound next-hop-self denials.
|
* CLUSTER_LIST loop
|
Displays outbound cluster-list loop denials.
|
* ORIGINATOR loop
|
Displays outbound denials of local originated routes.
|
* unsuppress-map
|
Displays inbound denials due to an unsuppress-map.
|
* advertise-map
|
Displays inbound denials due to an advertise-map.
|
* VPN Imported prefix
|
Displays inbound denials of VPN prefixes.
|
* Well-known Community
|
Displays inbound denials of well-known communities.
|
* SOO loop
|
Displays inbound denials due to site-of-origin.
|
* Bestpath from this peer
|
Displays inbound denials because the bestpath came from the local router.
|
* Suppressed due to dampening
|
Displays inbound denials because the neighbor or link is in a dampening state.
|
* Bestpath from iBGP peer
|
Deploys inbound denials because the bestpath came from an iBGP neighbor.
|
* Incorrect RIB for CE
|
Deploys inbound denials due to RIB errors for a CE router.
|
* BGP distribute-list
|
Displays inbound denials due to a distribute list.
|
Number of NLRIs...
|
Number of network layer reachability attributes in updates.
|
Connections established
|
Number of times a TCP and BGP connection have been successfully established.
|
dropped
|
Number of times that a valid session has failed or been taken down.
|
Last reset
|
Time since this peering session was last reset. The reason for the reset is displayed on this line.
|
Connection state
|
Connection status of the BGP peer.
|
Connection is ECN Disabled
|
Explicit congestion notification status (enabled or disabled).
|
Local host: 10.108.50.1, Local port: 179
|
IP address of the local BGP speaker. BGP port number 179.
|
Foreign host: 10.108.50.2, Foreign port: 42698
|
Neighbor address and BGP destination port number.
|
Enqueued packets for retransmit:
|
Packets queued for retransmission by TCP.
|
Event Timers
|
TCP event timers. Counters are provided for starts and wakeups (expired timers).
|
Retrans
|
Number of times a packet has been retransmitted.
|
TimeWait
|
Time waiting for the retransmission timers to expire.
|
AckHold
|
Acknowledgement hold timer.
|
SendWnd
|
Transmission (send) window.
|
KeepAlive
|
Number of keep alive packets.
|
GiveUp
|
Number times a packet is dropped due to no acknowledgement.
|
PmtuAger
|
Path MTU discovery timer.
|
DeadWait
|
Expiration timer for dead segments.
|
iss:
|
Initial packet transmission sequence number.
|
snduna:
|
Last transmission sequence number that has not been acknowledged.
|
sndnxt:
|
Next packet sequence number to be transmitted.
|
sndwnd:
|
TCP window size of the remote neighbor.
|
irs:
|
Initial packet receive sequence number.
|
rcvnxt:
|
Last receive sequence number that has been locally acknowledged.
|
rcvwnd:
|
TCP window size of the local host.
|
delrcvwnd:
|
Delayed receive window—data the local host has read from the connection, but has not yet subtracted from the receive window the host has advertised to the remote host. The value in this field gradually increases until it is larger than a full-sized packet, at which point it is applied to the rcvwnd field.
|
SRTT:
|
A calculated smoothed round-trip timeout.
|
RTTO:
|
Round-trip timeout.
|
RTV:
|
Variance of the round-trip time.
|
KRTT:
|
New round-trip timeout (using the Karn algorithm). This field separately tracks the round-trip time of packets that have been re-sent.
|
minRTT:
|
Smallest recorded round-trip timeout (hard-wire value used for calculation).
|
maxRTT:
|
Largest recorded round-trip timeout.
|
ACK hold:
|
Time the local host will delay an acknowledgment to carry (piggyback) additional data.
|
IP Precedence value:
|
IP precedence of the BGP packets.
|
Datagrams
|
Number of update packets received from a neighbor.
|
Rcvd:
|
Number of received packets.
|
with data
|
Number of update packets sent with data.
|
total data bytes
|
Total received in bytes.
|
Sent
|
Number of update packets sent.
|
Second Congestion
|
Number of update packets with data sent.
|
Datagrams: Rcvd
|
Number of update packets received from a neighbor.
|
out of order:
|
Number of packets received out of sequence.
|
with data
|
Number of update packets received with data.
|
Last reset
|
Elapsed time since this peering session was last reset.
|
unread input bytes
|
Number of bytes of packets still to be processed.
|
retransmit
|
Number of packets retransmitted.
|
fastretransmit
|
A duplicate acknowledgement is retransmitted for an out of order segment before the retransmission timer expires.
|
partialack
|
Number of retransmissions for partial acknowledgements (transmissions before or without subsequent acknowledgements).
|
Second Congestion
|
Second retransmission due to congestion.
|
show ip bgp neighbors advertised-routes example
The following example displays routes advertised for only the 172.16.232.178 neighbor:
Router# show ip bgp neighbors 172.16.232.178 advertised-routes
BGP table version is 27, local router ID is 172.16.232.181
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*>i110.0.0.0 172.16.232.179 0 100 0 ?
*> 200.2.2.0 0.0.0.0 0 32768 i
Table 34 describes the significant fields shown in the display.
Table 34 show ip bgp neighbors advertised-routes Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This is the primary routing table with which the neighbor has been updated. The number increments when the table changes.
|
local router ID
|
IP address of the local BGP speaker.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened and will not be advertised to BGP neighbors.
h—The table entry does not contain the best path based on historical information.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
|
Origin codes
|
Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system used to forward a packet to the destination network. An entry of 0.0.0.0 indicates that there are non-BGP routes in the path to the destination network.
|
Metric
|
If shown, this is the value of the inter-autonomous system metric. This field is not used frequently.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show ip bgp neighbors paths
The following is example output from the show ip bgp neighbors command entered with the paths keyword:
Router# show ip bgp neighbors 172.29.232.178 paths ^10
Address Refcount Metric Path
Table 35 describes the significant fields shown in the display.
Table 35 show ip bgp neighbors paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
Autonomous system path for that route, followed by the origin code for that route.
|
show ip bgp neighbors received prefix-filter
The following example shows that a prefix-list the filters all routes in the 10.0.0.0 network has be received from the 192.168.20.72 neighbor:
Router# show ip bgp neighbor 192.168.20.72 received prefix-filter
Address family:IPv4 Unicast
ip prefix-list 192.168.20.72:1 entries
seq 5 deny 10.0.0.0/8 le 32
Table 36 describes the significant fields shown in the display.
Table 36 show ip bgp neighbors received prefix-filter Field Descriptions
Field
|
Description
|
Address family:
|
Address family mode in which the prefix filter is received.
|
ip prefix-list
|
Prefix list sent from the specified neighbor.
|
show ip bgp paths
To display all the BGP paths in the database, use the show ip bgp paths command in EXEC mode.
show ip bgp paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp paths command in privileged EXEC mode:
Router# show ip bgp paths
Address Hash Refcount Metric Path
Table 38 describes the significant fields shown in the display.
Table 37 show ip bgp paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Hash
|
Hash bucket where path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The autonomous system path for that route, followed by the origin code for that route.
|
show ip bgp peer-group
To display information about BGP peer groups, use the show ip bgp peer-group command in EXEC mode.
show ip bgp peer-group [peer-group-name] [summary]
Syntax Description
peer-group-name
|
(Optional) Displays information about that specific peer group.
|
summary
|
(Optional) Displays a summary of the status of all the members of a peer group.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output from show ip bgp peer-group command for a peer group named internal in privileged EXEC mode:
Router# show ip bgp peer-group internal
BGP peer-group is internal, remote AS 100
Minimum time between advertisement runs is 5 seconds
For address family:IPv4 Unicast
BGP neighbor is internal, peer-group internal, members:
Index 3, Offset 0, Mask 0x8
Incoming update AS path filter list is 53
Outgoing update AS path filter list is 54
Route map for incoming advertisements is MAP193
Route map for outgoing advertisements is MAP194
Update messages formatted 0, replicated 0
show ip bgp quote-regexp
To display routes matching the autonomous system path "regular expression," use the show ip bgp quote-regexp command in EXEC mode.
show ip bgp quote-regexp regexp
Syntax Description
regexp
|
"Regular expression" to match the Border Gateway Protocol (BGP) autonomous system paths.
Note The regular expression has to be an exact match.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp quote-regexp command in EXEC mode:
Router# show ip bgp quote-regexp "^10_" | begin 24.40
*> 24.40.0.0/20 10.10.10.10 0 10 2548 1239 10643 i
*> 24.40.16.0/20 10.10.10.10 0 10 2548 6172 i
*> 24.40.32.0/19 10.10.10.10 0 10 2548 6172 i
*> 24.41.0.0/19 10.10.10.10 0 10 2548 3356 3703 ?
*> 24.42.0.0/17 10.10.10.10 0 10 2548 6172 i
Note Although the columns in the above display are not labeled, see Table 38 for detailed information.
Table 38 describes the significant fields shown in the display from left to right.
Table 38 show ip bgp quote-regexp Field Descriptions
Field
|
Description
|
Status codes
|
Status of the table entry; for example, * in the above display. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
d—The table entry is dampened.
h—The table entry history.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP (iBGP) session.
r—The table entry failed to install in the routing table.
S—The table entry is a stale route.
|
Network
|
IP address of a network entity; for example, 24.40.0.0/20 in the above display.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network; for example, 10.10.10.10. in the above displayAn entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.; for example, 0 in the above display.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command; for example, 10 in the above display. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters; for example, 2548 in the above display.
|
Path
|
Autonomous system paths to the destination network; for example, 1239 in the above display. There can be one entry in this field for each autonomous system in the path.
|
Origin codes
|
Origin of the entry; for example, ? in the above display. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Related Commands
Command
|
Description
|
show ip bgp regexp
|
Displays routes matching the autonomous system path regular expression.
|
show ip bgp regexp
To display routes matching the autonomous system path regular expression, use the show ip bgp regexp command in EXEC mode.
show ip bgp regexp regexp
Syntax Description
regexp
|
Regular expression to match the BGP autonomous system paths.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp regexp command in privileged EXEC mode:
Router# show ip bgp regexp 108$
BGP table version is 1738, local router ID is 172.16.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 172.16.0.0 172.16.72.30 0 109 108 ?
* 172.16.1.0 172.16.72.30 0 109 108 ?
* 172.16.11.0 172.16.72.30 0 109 108 ?
* 172.16.14.0 172.16.72.30 0 109 108 ?
* 172.16.15.0 172.16.72.30 0 109 108 ?
* 172.16.16.0 172.16.72.30 0 109 108 ?
* 172.16.17.0 172.16.72.30 0 109 108 ?
* 172.16.18.0 172.16.72.30 0 109 108 ?
* 172.16.19.0 172.16.72.30 0 109 108 ?
* 172.16.24.0 172.16.72.30 0 109 108 ?
* 172.16.29.0 172.16.72.30 0 109 108 ?
* 172.16.30.0 172.16.72.30 0 109 108 ?
* 172.16.33.0 172.16.72.30 0 109 108 ?
* 172.16.35.0 172.16.72.30 0 109 108 ?
* 172.16.36.0 172.16.72.30 0 109 108 ?
* 172.16.37.0 172.16.72.30 0 109 108 ?
* 172.16.38.0 172.16.72.30 0 109 108 ?
* 172.16.39.0 172.16.72.30 0 109 108 ?
show ip bgp replication
To display update replication statistics for Border Gateway Protocol (BGP) update groups, use the show ip bgp replication command in EXEC mode.
show ip bgp replication [index-group | ip-address]
Syntax Description
index-group
|
(Optional) Displays update replication statistics for the update group with corresponding index number will be displayed. The range of update-group index numbers is from 1 to 4294967295.
|
ip-address
|
(Optional) Displays the IP address of a single neighbor for which update-group statistics will be displayed.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(24)S
|
This command was introduced.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
Usage Guidelines
The output of this command displays BGP update-group replication statistics.
When a change to outbound policy occurs, the router automatically recalculates update-group memberships and applies the changes by triggering an outbound soft reset after a 3-minute timer expires. This behavior is designed to provide the network operator with time to change the configuration if a mistake is made. You can manually enable an outbound soft reset before the timer expires by entering the clear ip bgp ip-address soft out command.
Examples
The following sample output from the show ip bgp replication command shows update-group replication information for all neighbors:
Router# show ip bgp replication
BGP Total Messages Formatted/Enqueued : 0/0
Index Type Members Leader MsgFmt MsgRepl Csize Qsize
1 internal 1 10.4.9.21 0 0 0 0
2 internal 2 10.4.9.5 0 0 0 0
The following sample output from the show ip bgp replication command shows update-group statistics for the 10.4.9.5 neighbor:
Router# show ip bgp replication 10.4.9.5
Index Type Members Leader MsgFmt MsgRepl Csize Qsize
2 internal 2 10.4.9.5 0 0 0 0
Table 39 describes the significant fields shown in the display.
Table 39 show ip bgp replication Field Descriptions
Field
|
Description
|
Index
|
Index number of the update group.
|
Type
|
Type of peer (internal or external).
|
Members
|
Number of members in the dynamic update peer group.
|
Leader
|
First member of the dynamic update peer group.
|
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
clear ip bgp update-group
|
Clears BGP update-group member sessions.
|
debug ip bgp groups
|
Displays information related to the processing of BGP update groups.
|
show ip bgp peer-group
|
Displays information about BGP update groups.
|
show ip bgp rib-failure
To display Border Gateway Protocol (BGP) routes that failed to install in the Routing Information Base (RIB) table, use the show ip bgp rib-failure command in EXEC mode.
show ip bgp rib-failure
Syntax Description
This command has no keywords or arguments.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.3
|
This command was introduced.
|
12.0(26)S
|
This command was integrated into Cisco IOS Release 12.0(26)S.
|
Examples
The following is sample output from the show ip bgp rib-failure command:
Router# show ip bgp rib-failure
Network Next Hop RIB-failure RIB-NH Matches
100.1.15.0/24 100.1.35.5 Higher admin distance n/a
100.1.16.0/24 100.1.15.1 Higher admin distance n/a
Table 40 describes the significant fields shown in the display.
Table 40 show ip bgp rib-failure Field Descriptions
Field
|
Description
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
RIB-failure
|
Cause of RIB failure. Higher admin distance means that a route with a better (lower) administrative distance such as a static route already exists in the IP routing table.
|
RIB-NH Matches
|
Route status that applies only when Higher admin distance appears in the RIB-failure column and bgp suppress-inactive is configured for the address family being used. There are three choices:
•Yes—Means that the route in the RIB has the same nexthop as the BGP route or nexthop recurses down to the same adjacency as the BGP nexthop.
•No—Means that the nexthop in the RIB recurses down differently from the nexthop of the BGP route.
•n/a—Means that bgp suppress-inactive is not configured for the address family being used.
|
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
neighbor soft-reconfiguration
|
Configures the Cisco IOS software to start storing updates.
|
show ip bgp summary
To display the status of all Border Gateway Protocol (BGP) connections, use the show ip bgp summary command in EXEC mode.
show ip bgp summary
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
Support for the neighbor maximum-prefix command was added to the output.
|
12.2
|
•The number of networks and paths displayed in the output was split out to two separate lines.
•A field was added to display multipath entries in the routing table.
|
Usage Guidelines
The show ip bgp summary command is used to display BGP path, prefix, and attribute information for all connections to BGP neighbors.
A prefix is an IP address and network mask. It can represent an entire network, a subset of a network, or a single host route. A path is a route to a given destination. By default, BGP will install only a single path for each destination. If multipath routes are configured, BGP will install a path entry for each multipath route, and only one multipath route will be marked as the bestpath.
BGP attribute and cache entries are displayed in individually and in combinations that affect the bestpath selection process. The fields for this output are displayed when the related BGP feature is configured or attribute is received. Memory usage is displayed in bytes.
Examples
The following is sample output from the show ip bgp summary command in privileged EXEC mode:
Router# show ip bgp summary
BGP router identifier 172.16.1.1, local AS number 100
BGP table version is 199, main routing table version 199
37 network entries using 2850 bytes of memory
59 path entries using 5713 bytes of memory
18 BGP path attribute entries using 936 bytes of memory
2 multipath network entries and 4 multipath paths
10 BGP AS-PATH entries using 240 bytes of memory
7 BGP community entries using 168 bytes of memory
0 BGP route-map cache entries using 0 bytes of memory
0 BGP filter-list cache entries using 0 bytes of memory
36 received paths for inbound soft reconfiguration
BGP using 34249 total bytes of memory
Dampening enabled. 4 history paths, 0 dampened paths
BGP activity 37/2849 prefixes, 60/1 paths, scan interval 15 secs
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.100.1.1 4 200 26 22 199 0 0 00:14:23 23
10.200.1.1 4 300 21 51 199 0 0 00:13:40 0
Table 41 describes the significant fields shown in the display. Fields that are preceded by the asterisk character are not shown in the above output.
.
Table 41 show ip bgp summary Field Descriptions
Field
|
Description
|
BGP router identifier
|
In order of precedence and availability, the router identifier specified by the bgp router-id command, a loopback address, or the highest IP address.
|
BGP table version
|
Internal version number of BGP database.
|
main routing table version
|
Last version of BGP database that was injected into the main routing table.
|
...network entries
|
Number of unique prefix entries in the BGP database.
|
...using ... bytes of memory
|
Amount of memory, in bytes, that is consumed for the path, prefix, or attribute entry displayed on the same line.
|
...path entries using
|
Number of path entries in the BGP database. Only a single path entry will be installed for a given destination. If multipath routes are configured, a path entry will be installed for each multipath route.
|
...multipath network entries using
|
Number of multipath entries installed for a given destination.
|
* ...BGP path/bestpath attribute entries using
|
Number of unique BGP attribute combinations for which a path is selected as the bestpath.
|
* ...BGP rrinfo entries using
|
Number of unique ORIGINATOR and CLUSTER_LIST attribute combinations.
|
...BGP AS-PATH entries using
|
Number of unique AS_PATH entries.
|
...BGP community entries using
|
Number of unique BGP community attribute combinations.
|
*...BGP extended community entries using
|
Number of unique extended community attribute combinations.
|
BGP route-map cache entries using
|
Number of BGP route-map match and set clause combinations. A value of 0 indicates that the route cache is empty.
|
...BGP filter-list cache entries using
|
Number of filter-list entries that match an AS-path access list permit or deny statements. A value of 0 indicates that the filter-list cache is empty.
|
...received paths for inbound soft reconfiguration
|
Number paths received and stored for inbound soft reconfiguration.
|
BGP using...
|
Total amount of memory, in bytes, used by the BGP process.
|
Dampening enabled...
|
Indicates that BGP dampening is enabled. The number of paths that carry an accumulated penalty and the number of dampened paths are displayed on this line.
|
BGP activity...
|
Displays the number of times that memory has been allocated or released for a path or prefix.
|
Neighbor
|
IP address of the neighbor.
|
V
|
BGP version number spoken to the neighbor.
|
AS
|
Autonomous system number.
|
MsgRcvd
|
Number of messages received from the neighbor.
|
MsgSent
|
Number of messages sent to the neighbor.
|
TblVer
|
Last version of the BGP database that was sent to the neighbor.
|
InQ
|
Number of messages queued to be processed from the neighbor.
|
OutQ
|
Number of messages queued to be sent to the neighbor.
|
Up/Down
|
The length of time that the BGP session has been in the Established state, or the current status if not in the Established state.
|
State/PfxRcd
|
Current state of the BGP session, and the number of prefixes that have been received from a neighbor or peer group. When the maximum number (as set by the neighbor maximum-prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is set to Idle.
An (Admin) entry with Idle status indicates that the connection has been shut down using the neighbor shutdown command.
|
show ip bgp template peer-policy
To display locally configured peer policy templates, use the show ip bgp template peer-policy command in EXEC mode.
show ip bgp template peer-policy [policy-template-name]
Syntax Description
policy-template-name
|
(Optional) Name of a locally configured peer policy template.
|
Defaults
If a peer policy template is not specified with the policy-template-name argument, all peer policy templates will be displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(24)S
|
This command was introduced.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
Usage Guidelines
This command is used to display locally configured peer policy templates. The output can be filtered to display a single peer policy template with the policy-template-name argument. This command also supports all standard output modifiers.
Examples
The show ip bgp template peer-policy command is used to verify the configuration of local peer policy templates. The following sample output shows the peer policy templates named GLOBAL, PRIMARY-IN, and CUSTOMER-A. The output also shows that GLOBAL and PRIMARY-IN are inherited by CUSTOMER-A.
Router# show ip bgp template peer-policy
Template:GLOBAL, index:1.
Local policies:0x88840, Inherited polices:0x0
*Inherited by Template CUSTOMER-A, index:3
Locally configured policies:
prefix-list no-martian in
Template:PRIMARY-IN, index:2.
Local policies:0xC41, Inherited polices:0x0
*Inherited by Template CUSTOMER-A, index:3
Locally configured policies:
prefix-list ALLOW-PRIMARY-A in
default-originate route-map none
Template:CUSTOMER-A, index:3.
Local policies:0x5, Inherited polices:0x88C40
PRIMARY-IN, index:2, seq_no:20, flags:0x5
GLOBAL, index:1, seq_no:10, flags:0xC45
Locally configured policies:
route-map SET-COMMUNITY in
prefix-list ALLOW-PRIMARY-A in
default-originate route-map none
Table 42 describes the significant fields shown in the display.
Table 42 show ip bgp template peer-policy Field Descriptions
Field
|
Description
|
Template:
|
Name of the peer template.
|
index:
|
The sequence number in which the displayed template is processed.
|
Local policies:
|
Displays the hexadecimal value of locally configured policies.
|
Inherited polices:
|
Displays the hexadecimal value of inherited policies. The 0x0 value is displayed when no templates are inherited.
|
Locally configured policies:
|
Displays a list of commands that are locally configured in a peer policy template.
|
Inherited policies:
|
Displays a list of commands that are inherited from a peer template.
|
Related Commands
Command
|
Description
|
inherit peer-policy
|
Configures a peer policy template to inherit the configuration from another peer policy template.
|
template peer-policy
|
Creates a peer policy template and enters policy-template configuration mode.
|
show ip bgp template peer-session
To display peer policy template configurations, use the show ip bgp template peer-session command in EXEC mode.
show ip bgp template peer-session [session-template-name]
Syntax Description
session-template-name
|
(Optional) Name of a locally configured peer session template.
|
Defaults
If a peer session template is not specified with the session-template-name argument, all peer session templates will be displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(24)S
|
This command was introduced.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
Usage Guidelines
This command is used to display locally configured peer session templates. The output can be filtered to display a single peer session template with the peer-session-name argument. This command also supports all standard output modifiers.
Examples
The show ip bgp template peer-session command is used to verify the configuration of local peer session templates. The following example shows the peer session templates named INTERNAL-BGP and CORE1. The output also shows that INTERNAL-BGP is inherited by CORE1.
Router# show ip bgp template peer-session
Template:INTERNAL-BGP, index:1
Local policies:0x21, Inherited polices:0x0
*Inherited by Template CORE1, index= 2
Locally configured session commands:
Inherited session commands:
Local policies:0x180, Inherited polices:0x21
INTERNAL-BGP index:1 flags:0x0
Locally configured session commands:
Inherited session commands:
Table 43 describes the significant fields shown in the display.
Table 43 show ip bgp template peer-session Field Descriptions
Field
|
Description
|
Template:
|
Name of the peer template.
|
index:
|
The sequence number in which the displayed template is processed.
|
Local policies:
|
Displays the hexadecimal value of locally configured policies.
|
Inherited polices:
|
Displays the hexadecimal value of inherited policies. The 0x0 value is displayed when no templates are inherited.
|
Locally configured session commands:
|
Displays a list of commands that are locally configured in a peer template.
|
Inherited session commands:
|
Displays a list of commands that are inherited from a peer session template.
|
Related Commands
Command
|
Description
|
inherit peer-session
|
Configures a peer session template to inherit the configuration from another peer session template.
|
template peer-session
|
Creates a peer session template and enters session-template configuration mode.
|
show ip bgp update-group
To display information about BGP update groups, use the show ip bgp update-group command in EXEC mode.
show ip bgp update-group [index-group | ip-address] [summary]
Syntax Description
index-group
|
(Optional) Displays the update group with corresponding index number. The range of update-group index numbers is from 1 to 4294967295.
|
ip-address
|
(Optional) Displays the IP address of a single neighbor.
|
summary
|
(Optional) Displays a summary of update-group member information. The output can be filtered to show information for a single index group or peer with the index-group or ip-address argument.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(24)S
|
This command was introduced.
|
12.2(18)S
|
This command was integrated into Cisco IOS Release 12.2(18)S.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
Usage Guidelines
Displays information about BGP update groups.
When a change to outbound policy occurs, the router automatically recalculates update-group memberships and applies the changes by triggering an outbound soft reset after a 3-minute timer expires. This behavior is designed to provide the network operator with time to change the configuration if a mistake is made. You can manually enable an outbound soft reset before the timer expires by entering the clear ip bgp ip-address soft out command.
Examples
The following sample output from the show ip bgp update-group command shows update-group information for all neighbors:
Router# show ip bgp update-group
BGP version 4 update-group 1, internal, Address Family: IPv4 Unicast
BGP Update version : 0, messages 0/0
Route map for outgoing advertisements is COST1
Update messages formatted 0, replicated 0
Number of NLRIs in the update sent: max 0, min 0
Minimum time between advertisement runs is 5 seconds
BGP version 4 update-group 2, internal, Address Family: IPv4 Unicast
BGP Update version : 0, messages 0/0
Update messages formatted 0, replicated 0
Number of NLRIs in the update sent: max 0, min 0
Minimum time between advertisement runs is 5 seconds
Table 44 describes the significant fields shown in the display.
Table 44 show ip bgp update group Field Descriptions
Field
|
Description
|
BGP version
|
BGP version.
|
update-group
|
Update-group number and type (internal or external).
|
Update messages formatted..., replicated...
|
Number of update messages that have been formatted and replicated.
|
Number of NLRIs...
|
NLRI information sent in update.
|
Minimum time between...
|
Minimum time, in seconds, between update advertisements.
|
Has...
|
Number of member listed by IP address in the update group.
|
The following sample output from the show ip bgp update-group command shows a summary of update-group information for the 10.4.9.8 neighbor:
Router# show ip bgp update-group 10.4.9.8 summary
Summary for Update-group 2 :
------------------------------
BGP router identifier 10.4.9.4, local AS number 101
BGP table version is 1, main routing table version 1
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.4.9.5 4 101 35 35 1 0 0 00:26:22 0
10.4.9.8 4 101 39 39 1 0 0 00:26:21 0
Table 45 describes the significant fields shown in the display.
Table 45 show ip bgp-update group summary Field Descriptions
Field
|
Description
|
Summary for Update-group...
|
Update-group number.
|
BGP router identifier...
|
IP address and AS number for specified peer.
|
update messages formatted..., replicated...
|
Number of update messages that have been formatted and replicated.
|
BGP table version...
|
Displays incremental changes in the BGP routing table.
|
Neighbor...
|
Specific peer information and statistics, including IP address and AS number.
|
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
clear ip bgp update-group
|
Clears BGP update-group member sessions.
|
debug ip bgp groups
|
Displays information related to the processing of BGP update groups.
|
show ip bgp replication
|
Displays BGP update-group replication statistics.
|
