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 rib-failure
show ip bgp summary
show ip cache policy
show ip community-list
show ip eigrp interfaces
show ip eigrp neighbors
show ip eigrp topology
show ip eigrp traffic
show ip eigrp vrf interfaces
show ip eigrp vrf neighbors
show ip eigrp vrf topology
show ip eigrp vrf traffic
show ip extcommunity-list
show ip local policy
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-regexp
|
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 command in EXEC mode.
show ip bgp [ip-address [mask [longer-prefixes [injected] | shorter-prefixes [length]]] | 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.
|
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
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 and route-map keywords were added.
|
12.0(14)ST
|
The shorter-prefixes keyword was added. This keyword is available
|
12.2(2)T
|
The output of the show ip bgp network command was enhanced to display multipaths and a best path to the specified network.
|
12.0(22)S
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
12.2(15)T
|
A new status code indicating stale routes was added to support BGP graceful restart.
|
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 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 39 for detailed information.
Table 39 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 display, 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.; 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 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 39 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 40 describes the significant fields shown in the display. Fields that are preceded by the asterisk character are not shown in the above output.
.
Table 40 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 cache policy
To display the cache entries in the policy route cache, use the show ip cache policy command in EXEC mode.
show ip cache policy
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3
|
This command was introduced.
|
Examples
The following is sample output from the show ip cache policy command:
Router# show ip cache policy
Total adds 10, total deletes 10
Type Routemap/sequence Age Interface Next Hop
NH george/10 00:04:31 Ethernet0 192.168.1.2
Int george/30 00:01:23 Serial4 192.168.5.129
Table 42 describes the significant fields shown in the display.
Table 41 show ip cache policy Field Descriptions
Field
|
Description
|
Total adds
|
Number of times a cache entry was created.
|
total deletes
|
Number of times a cache entry or the entire cache was deleted.
|
Type
|
"NH" indicates the set ip next-hop command.
"Int" indicates the set interface command.
|
Routemap
|
Name of the route map that created the entry; in this example, george.
|
sequence
|
Route map sequence number.
|
Age
|
Age of the cache entry.
|
Interface
|
Output interface type and number.
|
Next Hop
|
IP address of the next hop.
|
Related Commands
Command
|
Description
|
ip route-cache
|
Configures the router to export the flow cache entry to a workstation when a flow expires.
|
show ip community-list
To display configured community lists, use the show ip community-list command in EXEC mode.
show ip community-list [standard-community-list-number | extended-community-list-number |
community-list-name] [exact-match]
Syntax Description
standard-community-list-number
|
(Optional) Community list number in the range from 1 to 99.
|
expanded-community-list-number
|
(Optional) Community list number in the range from 100 to 199.
|
community-list-name
|
(Optional) 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
|
11.0
|
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 can be used without any arguments or keywords. If no arguments are specified, this command will display all community lists. However, the community list name or number can be specified when entering the show ip community-list command. This option can be useful for filtering the output of this command and verifying a single named or numbered community list.
Examples
The following sample output is similar to the output that will be displayed when the show ip community-list command is entered in privileged EXEC mode:
Router# show ip community-list
Community standard list 1
Community (expanded) access list 101
Named Community standard list COMMUNITY_LIST_NAME
Named Community expanded list COMMUNITY_LIST_NAME_TWO
Table 43 describes the significant fields shown in the display.
Table 42 show ip bgp community-list Field Descriptions
Field
|
Description
|
Community standard list
|
If shown, this value will display a standard community list number (1 to 99). The standard community list number will immediately follow this value.
|
Community (expanded) access list
|
If shown, this value will display an expanded community list number (100 to 199). The expanded community list number will immediately follow this value.
|
Named community standard list
|
If shown, this value will display a standard community list name. The standard community list name will immediately follow this value.
|
Named community expanded list
|
If shown, this value will display an expanded community list name. The expanded community list name will immediately follow this value.
|
show ip eigrp interfaces
To display information about interfaces configured for Enhanced Interior Gateway Routing Protocol (EIGRP), use the show ip eigrp interfaces command in EXEC mode.
show ip eigrp interfaces [interface-type interface-number] [as-number]
Syntax Description
interface-type
|
(Optional) Interface type.
|
interface-number
|
(Optional) Interface number.
|
as-number
|
(Optional) Autonomous system number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Use the show ip eigrp interfaces command to determine on which interfaces EIGRP is active, and to learn information about EIGRP relating to those interfaces.
If an interface is specified, only that interface is displayed. Otherwise, all interfaces on which EIGRP is running are displayed.
If an autonomous system is specified, only the routing process for the specified autonomous system is displayed. Otherwise, all EIGRP processes are displayed.
Examples
The following is sample output from the show ip eigrp interfaces command:
Router# show ip eigrp interfaces
IP EIGRP interfaces for process 109
Xmit Queue Mean Pacing Time Multicast Pending
Interface Peers Un/Reliable SRTT Un/Reliable Flow Timer Routes
SE0:1.16 1 0/0 10 1/63 103 0
Table 44 describes the significant fields shown in the display.
Table 43 show ip eigrp interfaces Field Descriptions
Field
|
Description
|
Interface
|
Interface over which EIGRP is configured.
|
Peers
|
Number of directly connected EIGRP neighbors.
|
Xmit Queue Un/Reliable
|
Number of packets remaining in the Unreliable and Reliable transmit queues.
|
Mean SRTT
|
Mean smoothed round-trip time (SRTT) interval (in milliseconds).
|
Pacing Time Un/Reliable
|
Pacing time used to determine when EIGRP packets should be sent out the interface (unreliable and reliable packets).
|
Multicast Flow Timer
|
Maximum number of seconds in which the router will send multicast EIGRP packets.
|
Pending Routes
|
Number of routes in the packets in the transmit queue waiting to be sent.
|
Related Commands
Command
|
Description
|
show ip eigrp vrf neighbors
|
Displays the neighbors discovered by EIGRP.
|
show ip eigrp neighbors
To display the neighbors discovered by Enhanced Interior Gateway Routing Protocol (EIGRP), use the show ip eigrp neighbors command in EXEC mode.
show ip eigrp neighbors [interface-type | as-number | static | detail]
Syntax Description
interface-type
|
(Optional) Filters that output by interface.
|
as-number
|
(Optional) Filters that output by autonomous system number.
|
static
|
(Optional) Displays static routes.
|
detail
|
(Optional) Displays detailed neighbor information.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0(7)T
|
The static keyword was added.
|
12.2(15)T
|
Support for NSF restart operations was integrated into the output.
|
Usage Guidelines
Use the show ip eigrp neighbors command to determine when neighbors become active and inactive. It is also useful for debugging certain types of transport problems.
Examples
show ip eigrp neighbors Example
The following is sample output from the show ip eigrp neighbors command:
Router# show ip eigrp neighbors
IP-EIGRP Neighbors for process 77
Address Interface Holdtime Uptime Q Seq SRTT RTO
(secs) (h:m:s) Count Num (ms) (ms)
172.16.81.28 Ethernet1 13 0:00:41 0 11 4 20
172.16.80.28 Ethernet0 14 0:02:01 0 10 12 24
172.16.80.31 Ethernet0 12 0:02:02 0 4 5 20
Table 45 describes the significant fields shown in the display.
Table 44 show ip eigrp neighbors Field Descriptions
Field
|
Description
|
process 77
|
Autonomous system number specified in the router configuration command.
|
Address
|
IP address of the EIGRP peer.
|
Interface
|
Interface on which the router is receiving hello packets from the peer.
|
Holdtime
|
Length of time (in seconds) that the Cisco IOS software will wait to hear from the peer before declaring it down. If the peer is using the default hold time, this number will be less than 15. If the peer configures a nondefault hold time, the nondefault hold time will be displayed.
|
Uptime
|
Elapsed time (in hours:minutes: seconds) since the local router first heard from this neighbor.
|
Q Count
|
Number of EIGRP packets (update, query, and reply) that the software is waiting to send.
|
Seq Num
|
Sequence number of the last update, query, or reply packet that was received from this neighbor.
|
SRTT
|
Smoothed round-trip time. This is the number of milliseconds required for an EIGRP packet to be sent to this neighbor and for the local router to receive an acknowledgment of that packet.
|
RTO
|
Retransmission timeout (in milliseconds). This is the amount of time the software waits before resending a packet from the retransmission queue to a neighbor.
|
show ip eigrp neighbors detail Example
The following is sample output from the show ip eigrp neighbors command when issued with the detail keyword:
Router# show ip eigrp neighbors detail
IP-EIGRP neighbors for process 101
H Address Interface Hold Uptime SRTT RTO Q Seq Tye
3 1.1.1.3 Et0/0 12 00:04:48 1832 5000 0 14
Version 12.2/1.2, Retrans:0, Retries:0
0 10.4.9.5 Fa0/0 11 00:04:07 768 4608 0 4 S
Version 12.2/1.2, Retrans: 0, Retries: 0
2 10.4.9.10 Fa0/0 13 1w0d 1 3000 0 6 S
Version 12.2/1.2, Retrans: 1, Retries: 0
1 10.4.9.6 Fa0/0 12 1w0d 1 3000 0 4 S
Version 12.2/1.2, Retrans: 1, Retries: 0
Table 46 describes the significant fields shown in the display.
Table 45 show ip eigrp neighbors Field Descriptions
Field
|
Description
|
process 77
|
Autonomous system number specified in the router configuration command.
|
H
|
This column lists the order in which a peering session was established with the specified neighbor. The order is specified with sequential numbering starting with 0.
|
Address
|
IP address of the EIGRP peer.
|
Interface
|
Interface on which the router is receiving hello packets from the peer.
|
Holdtime
|
Length of time (in seconds) that the Cisco IOS software will wait to hear from the peer before declaring it down. If the peer is using the default hold time, this number will be less than 15. If the peer configures a nondefault hold time, the nondefault hold time will be displayed.
|
Uptime
|
Elapsed time (in hours:minutes: seconds) since the local router first heard from this neighbor.
|
Q Count
|
Number of EIGRP packets (update, query, and reply) that the software is waiting to send.
|
Seq Num
|
Sequence number of the last update, query, or reply packet that was received from this neighbor.
|
SRTT
|
Smoothed round-trip time. This is the number of milliseconds required for an EIGRP packet to be sent to this neighbor and for the local router to receive an acknowledgment of that packet.
|
RTO
|
Retransmission timeout (in milliseconds). This is the amount of time the software waits before resending a packet from the retransmission queue to a neighbor.
|
Version
|
The software version that the specified peer is running.
|
Retrans
|
The number of times that a packet has been retransmitted.
|
Retries
|
The number of times an attempt was made to retransmit a packet.
|
Restart time
|
Elapsed time (in hours:minutes: seconds) since the specified neighbor has restarted.
|
show ip eigrp topology
To display entries in the Enhanced Interior Gateway Routing Protocol (EIGRP) topology table, use the show ip eigrp topology command in EXEC mode.
show ip eigrp topology [as-number | [[ip-address] mask]] [active | all-links | pending | summary
| zero-successors]
Syntax Description
as-number
|
(Optional) Autonomous system number.
|
ip-address
|
(Optional) IP address. When specified with a mask, a detailed description of the entry is provided.
|
mask
|
(Optional) Subnet mask.
|
active
|
(Optional) Displays only active entries in the EIGRP topology table.
|
all-links
|
(Optional) Displays all entries in the EIGRP topology table.
|
pending
|
(Optional) Displays all entries in the EIGRP topology table that are waiting for an update from a neighbor or are waiting to reply to a neighbor.
|
summary
|
(Optional) Displays a summary of the EIGRP topology table.
|
zero-successors
|
(Optional) Displays available routes in the EIGRP topology table.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The show ip eigrp topology command can be used without any keywords or arguments. If this command is used without any keywords or arguments, then only routes that are feasible successors are displayed. The show ip eigrp topology command can be used to determine Diffusing Update Algorithm (DUAL) states and to debug possible DUAL problems.
Examples
The following is sample output from the show ip eigrp topology command:
Router# show ip eigrp topology
IP-EIGRP Topology Table for process 77
Codes: P - Passive, A - Active, U - Update, Q - Query, R - Reply,
P 172.16.90.0 255.255.255.0, 2 successors, FD is 0
via 172.16.80.28 (46251776/46226176), Ethernet0
via 172.16.81.28 (46251776/46226176), Ethernet1
via 172.16.80.31 (46277376/46251776), Serial0
P 172.16.81.0 255.255.255.0, 1 successors, FD is 307200
via 172.16.81.28 (307200/281600), Ethernet1
via 172.16.80.28 (307200/281600), Ethernet0
via 172.16.80.31 (332800/307200), Serial0
Table 47 describes the significant fields shown in the display.
Table 46 show ip eigrp topology Field Descriptions
Field
|
Description
|
Codes
|
State of this topology table entry. Passive and Active refer to the EIGRP state with respect to this destination; Update, Query, and Reply refer to the type of packet that is being sent.
|
P - Passive
|
No EIGRP computations are being performed for this destination.
|
A - Active
|
EIGRP computations are being performed for this destination.
|
U - Update
|
Indicates that an update packet was sent to this destination.
|
Q - Query
|
Indicates that a query packet was sent to this destination.
|
R - Reply
|
Indicates that a reply packet was sent to this destination.
|
r - Reply status
|
Flag that is set after the software has sent a query and is waiting for a reply.
|
172.16.90.0
|
Destination IP network number.
|
255.255.255.0
|
Destination subnet mask.
|
successors
|
Number of successors. This number corresponds to the number of next hops in the IP routing table. If "successors" is capitalized, then the route or next hop is in a transition state.
|
FD
|
Feasible distance. The feasible distance is the best metric to reach the destination or the best metric that was known when the route went active. This value is used in the feasibility condition check. If the reported distance of the router (the metric after the slash) is less than the feasible distance, the feasibility condition is met and that path is a feasible successor. Once the software determines it has a feasible successor, it need not send a query for that destination.
|
replies
|
Number of replies that are still outstanding (have not been received) with respect to this destination. This information appears only when the destination is in Active state.
|
state
|
Exact EIGRP state that this destination is in. It can be the number 0, 1, 2, or 3. This information appears only when the destination is in the active state.
|
via
|
IP address of the peer that told the software about this destination. The first n of these entries, where N is the number of successors, are the current successors. The remaining entries on the list are feasible successors.
|
(46251776/46226176)
|
The first number is the EIGRP metric that represents the cost to the destination. The second number is the EIGRP metric that this peer advertised.
|
Ethernet0
|
Interface from which this information was learned.
|
Serial0
|
Interface from which this information was learned.
|
show ip eigrp traffic
To display the number of Enhanced Interior Gateway Routing Protocol (EIGRP) packets sent and received, use the show ip eigrp traffic command in EXEC mode.
show ip eigrp traffic [as-number]
Syntax Description
as-number
|
(Optional) Autonomous system number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip eigrp traffic command:
Router# show ip eigrp traffic
IP-EIGRP Traffic Statistics for process 77
Hellos sent/received: 218/205
Updates sent/received: 7/23
Queries sent/received: 2/0
Replies sent/received: 0/2
Acks sent/received: 21/14
Table 48 describes the significant fields shown in the display.
Table 47 show ip eigrp traffic Field Descriptions
Field
|
Description
|
process 77
|
Autonomous system number specified in the ip router command.
|
Hellos sent/received
|
Number of hello packets sent and received.
|
Updates sent/received
|
Number of update packets sent and received.
|
Queries sent/received
|
Number of query packets sent and received.
|
Replies sent/received
|
Number of reply packets sent and received.
|
Acks sent/received
|
Number of acknowledgment packets sent and received.
|
show ip eigrp vrf interfaces
To display information about interfaces that carry virtual routing and forwarding instance (VRF) information and are configured for Enhanced Interior Gateway Routing Protocol (EIGRP), use the show ip eigrp vrf interfaces command in privileged EXEC mode.
show ip eigrp vrf {vrf-name | *} interfaces [as-number] [interface-type] [detail interface-type]
[static interface-type]
Syntax Description
vrf-name
|
Specifies the VRF name. The * keyword can be used as a wild card to display all VRFs, instead of specifying a single VRF with the vrf-name argument.
|
as-number
|
(Optional) Specifies the autonomous system number.
|
interface-type
|
(Optional) Specifies the VRF interface for which to display EIGRP information.
|
detail interface-type
|
(Optional) Displays detailed VRF peer information. The interface can be specified after this keyword is entered.
|
static interface-type
|
(Optional) Displays VRF information for static neighbors. The interface can be specified after this keyword is entered. The interface-type argument allows you to display information about static neighbors for VRFs that are configured on specific interfaces.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(15)T
|
This command was integrated into 12.2(15)T.
|
Usage Guidelines
Use the show ip eigrp vrf interfaces command to display EIGRP interfaces that are defined under the specified VRF. If an interface is specified with the interface-type argument, only the specified interface is displayed. Otherwise, all interfaces on which EIGRP is running as part of the specified VRF are displayed.
Examples
The following is sample output from the show ip eigrp vrf interfaces command:
Router# show ip eigrp vrf VRF-PINK interfaces
IP-EIGRP interfaces for process 1
Xmit Queue Mean Pacing Time Multicast Pending
Interface Peers Un/Reliable SRTT Un/Reliable Flow Timer Routes
Et3/0 1 0/0 131 0/10 528 0
Table 49 describes the significant fields shown in the display.
Table 48 show ip eigrp vrf interfaces Field Descriptions
Field
|
Description
|
IP-EIGRP interfaces for process...
|
Displays the autonomous-system number for the specified VRF.
|
Interface
|
Interface over which EIGRP is configured.
|
Peers
|
Number of directly connected EIGRP neighbors.
|
Xmit Queue Un/Reliable
|
Number of packets remaining in the Unreliable and Reliable transmit queues.
|
Mean SRTT
|
Mean smoothed round-trip time (SRTT) interval (in milliseconds).
|
Pacing Time Un/Reliable
|
Pacing time used to determine when EIGRP packets should be sent out the interface (unreliable and reliable packets).
|
Multicast Flow Timer
|
Maximum number of seconds in which the router will send multicast EIGRP packets.
|
Pending Routes
|
Number of routes in the packets in the transmit queue waiting to be sent.
|
Related Commands
Command
|
Description
|
clear ip eigrp vrf neighbor
|
Clears neighbor entries of the specified VRF from the RIB.
|
show ip eigrp vrf neighbors
|
Displays neighbors discovered by EIGRP that carry VRF information.
|
show ip eigrp vrf topology
|
Displays VRF entries in the EIGRP topology table.
|
show ip eigrp vrf traffic
|
Displays EIGRP VRF traffic statistics.
|
show ip eigrp vrf neighbors
To display Enhanced Interior Gateway Routing Protocol (EIGRP) neighbors that are on interfaces that are part of the specified virtual routing and forwarding instance (VRF), use the show ip eigrp vrf neighbors command privileged EXEC mode.
show ip eigrp vrf {vrf-name| *} neighbors [as-number] [interface-type] [detail interface-type]
[static interface-type]
Syntax Description
vrf-name
|
Specifies the VRF name. The * keyword can be used as a wild card to display all VRFs, instead of specifying a single VRF with the vrf-name argument.
|
as-number
|
(optional) Specifies the autonomous system number.
|
interface-type
|
(optional) Specifies the interface to display neighbor information under the specified VRF.
|
detail interface-type
|
(optional) Displays detailed VRF peer information. The interface can be specified after this keyword is entered.
|
static interface-type
|
(optional) Displays VRF information for static neighbors. The interface can be specified after this keyword is entered. The interface-type argument allows you to display information about static neighbors for VRFs that are configured on specific interfaces.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(15)T
|
This command was integrated into 12.2(15)T.
|
Usage Guidelines
Use the show ip eigrp vrf neighbors command to determine when VRF neighbors become active and inactive. This command is also useful for debugging certain types of transport problems.
Examples
The following is sample output from the show ip eigrp vrf neighbors command:
Router# show ip eigrp vrf VRF-GREEN neighbors
IP-EIGRP neighbors for process 1
H Address Interface Hold Uptime SRTT RTO Q
0 10.10.10.2 Et3/0 10 1d16h 131 786 0 3
Table 50 describes the significant fields shown in the display.
Table 49 show ip eigrp vrf neighbors Field Descriptions
Field
|
Description
|
IP-EIGRP neighbors for process...
|
Displays the autonomous-system number for the specified EIGRP VRF.
|
Address
|
IP address of the EIGRP peer.
|
Interface
|
Interface on which the router is receiving hello packets from the peer.
|
Hold Uptime
|
Length of time (in seconds) that the Cisco IOS software will wait to hear from the peer before declaring it down, and the length in time (in seconds) since the local router first heard from this neighbor.
|
SRTT
|
Smoothed round-trip time. This is the number of milliseconds required for an EIGRP packet to be sent to this neighbor and for the local router to receive an acknowledgment of that packet.
|
RTO
|
Retransmission timeout (in milliseconds). This is the amount of time the software waits before resending a packet from the retransmission queue to a neighbor.
|
Q
|
Number of EIGRP packets (update, query, and reply) that the software is waiting to send.
|
show ip eigrp vrf topology
To display virtual routing and forwarding instance (VRF) entries in the Enhanced Interior Gateway Routing Protocol (EIGRP) topology table, use the show ip eigrp topology command in EXEC mode.
show ip eigrp vrf {vrf-name | *} topology [as-number] [ip-address [mask]] [active | all-links |
pending | summary | zero-successors]
Syntax Description
vrf-name
|
Specifies the VRF name. The * keyword can be used as a wild card to display all VRFs, instead of specifying a single VRF with the vrf-name argument.
|
as-number
|
(Optional) Autonomous system number.
|
ip-address
|
(Optional) IP address. When specified with a mask, a detailed description of the entry is provided.
|
mask
|
(Optional) Subnet mask.
|
active
|
(Optional) Displays only active entries in the EIGRP topology table.
|
all-links
|
(Optional) Displays all entries in the EIGRP topology table.
|
pending
|
(Optional) Displays all entries in the EIGRP topology table that are waiting for an update from a neighbor or are waiting to reply to a neighbor.
|
summary
|
(Optional) Displays a summary of the EIGRP topology table.
|
zero-successors
|
(Optional) Displays available routes in the EIGRP topology table.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(15)T
|
This command was integrated into 12.2(15)T.
|
Usage Guidelines
The show ip eigrp vrf topology command can be used without any keywords or arguments, but you must specify either a VRF name or use * character as a wild card. If this command is this way, only routes that are feasible successors are displayed. The show ip eigrp vrf topology command can be used to determine Diffusing Update Algorithm (DUAL) states and to debug possible DUAL problems.
Examples
The following is sample output from the show ip eigrp vrf topology command:
Router# show ip eigrp vrf VRF-PINK topology
IP-EIGRP Topology Table for AS(1)/ID(192.168.10.1) Routing Table:VRF-PINK
Codes:P - Passive, A - Active, U - Update, Q - Query, R - Reply,
r - reply Status, s - sia Status
P 10.17.17.0/24, 1 successors, FD is 409600
via 10.10.10.2 (409600/128256), Ethernet3/0
P 172.16.19.0/24, 1 successors, FD is 409600
via 10.10.10.2 (409600/128256), Ethernet3/0
P 192.168.10.0/24, 1 successors, FD is 281600
via Connected, Ethernet3/0
P 10.10.10.0/24, 1 successors, FD is 281600
via Redistributed (281600/0)
Table 51 describes the significant fields shown in the display.
Table 50 show ip vrf eigrp topology Field Descriptions
Field
|
Description
|
Codes
|
State of this topology table entry. Passive and Active refer to the EIGRP state with respect to this destination; Update, Query, and Reply refer to the type of packet that is being sent.
|
P - Passive
|
No EIGRP computations are being performed for this destination.
|
A - Active
|
EIGRP computations are being performed for this destination.
|
U - Update
|
Indicates that an update packet was sent to this destination.
|
Q - Query
|
Indicates that a query packet was sent to this destination.
|
R - Reply
|
Indicates that a reply packet was sent to this destination.
|
r - reply Status
|
Flag that is set after the software has sent a query and is waiting for a reply.
|
s - sia Status
|
Flag that is set if a route is in a stuck in active state.
|
successors
|
Number of successors. This number corresponds to the number of next hops in the IP routing table. If "successors" is capitalized, then the route or next hop is in a transition state.
|
FD
|
Feasible distance. The feasible distance is the best metric to reach the destination or the best metric that was known when the route went active. This value is used in the feasibility condition check. If the reported distance of the router (the metric after the slash) is less than the feasible distance, the feasibility condition is met and that path is a feasible successor. Once the software determines it has a feasible successor, it need not send a query for that destination.
|
replies
|
(Not shown in the output) Number of replies that are still outstanding (have not been received) with respect to this destination. This information appears only when the destination is in Active state.
|
state
|
(Not shown in the output) Exact EIGRP state that this destination is in. It can be the number 0, 1, 2, or 3. This information appears only when the destination is in the active state.
|
via
|
IP address of the peer that told the software about this destination. The first N of these entries, where N is the number of successors, is the current successors. The remaining entries on the list are feasible successors.
|
(409600/128256)
|
The first number is the EIGRP metric that represents the cost to the destination. The second number is the EIGRP metric that this peer advertised.
|
Ethernet 3/0
|
Interface from which this information was learned.
|
show ip eigrp vrf traffic
To display sent and received statistics for Enhanced Interior Gateway Routing Protocol (EIGRP) virtual routing and forwarding instance (VRF) packets, use the show ip eigrp vrf traffic command in privileged EXEC mode.
show ip eigrp vrf {vrf-name| *} traffic [as-number]
Syntax Description
vrf-name
|
Specifies the VRF name. The * keyword can be used as a wild card to display all VRFs, instead of specifying a single VRF with the vrf-name argument.
|
as-number
|
(Optional) Specifies the autonomous system number.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(15)T
|
This command was integrated into 12.2(15)T.
|
Examples
The following is sample output from the show ip eigrp vrf traffic command:
Router# show ip eigrp vrf VRF-RED traffic
IP-EIGRP Traffic Statistics for AS 101
Hellos sent/received: 600/585
Updates sent/received: 23/22
Queries sent/received: 7/0
Replies sent/received: 0/6
Acks sent/received: 55/42
Input queue high water mark 0, 0 drops
Table 52 describes the significant fields shown in the display.
Table 51 show ip eigrp vrf traffic Field Descriptions
Field
|
Description
|
IP-EIGRP Traffic Statistics for AS...
|
Displays the autonomous system number for the specified EIGRP VRF.
|
Hellos sent/received
|
Number of hello packets sent and received.
|
Updates sent/received
|
Number of update packets sent and received.
|
Queries sent/received
|
Number of query packets sent and received.
|
Replies sent/received
|
Number of reply packets sent and received.
|
Acks sent/received
|
Number of acknowledgment packets sent and received.
|
Input queue high water mark..., ... drops
|
Number of received packets that are approaching the maximum receive threshold and number of dropped packets.
|
show ip extcommunity-list
To display routes that are permitted by an extended community list, use the show ip extcommunity-list command in EXEC mode.
show ip extcommunity-list [community-list-number]
Syntax Description
community-list-number
|
(Optional) Community list number in the range from 1 to 199. A standard extended list is from 1 to 99. An expanded extended list is from 100 to 199.
|
Defaults
If a specific extended community list number is not specified when the show ip extcommunity-list command is entered, all locally configured extended community lists will be displayed by default.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Examples
The following is sample output from the show ip extcommunity-list command in EXEC mode:
Router# show ip extcommunity-list
Extended community standard list 1
deny RT:703:30 SoO:604:40
Extended community standard list 99
permit RT:604:40 SoO:505:50
deny RT:406:60 SoO:307:70
Related Commands
Command
|
Description
|
show route-map
|
Displays configured route maps.
|
show ip local policy
To display the route map used for local policy routing, if any, use the show ip local policy command in EXEC mode.
show ip local policy
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Examples
The following is sample output from the show ip local policy command:
Router# show ip local policy
Local policy routing is enabled, using route map equal
route-map equal, permit, sequence 10
Policy routing matches: 0 packets, 0 bytes
route-map equal, permit, sequence 20
ip address (access-lists): 101
Policy routing matches: 2 packets, 172 bytes
Table 53 describes the significant fields shown in the display.
Table 52 show ip local policy Field Descriptions
Field
|
Description
|
route-map equal
|
The name of the route map is equal.
|
permit
|
The route map contains permi |
