show ip bgp routes
-
- Last UpdatedJul 02, 2019
- 5 minutes read
show ip bgp routes
Displays statistics for the routes in the BGP4 route table of a device.
detail
| Displays detailed information.
|
num
| Table entry at which the display starts. For example, if you want to list entries beginning with table entry 100, specify 100.
|
ip-address/prefix
| Specifies an IP address and prefix.
|
age
num
| Displays BGP4 route information that is filtered by age.
|
as-path-access-list
name
| Displays BGP4 route information that is filtered by autonomous system (AS)-path access control list (ACL).
|
as-path-filter
number
| Displays BGP4 route information that is filtered using the specified AS-path filter.
|
best
| Displays BGP4 route information that the device selected as best routes.
|
cidr-only
| Displays BGP4 routes whose network masks do not match their class network length.
|
community-access-list
name
| Displays BGP4 route information for an AS-path community access list.
|
community-filter
number
| Displays BGP4 route information that matches a specific community filter.
|
community-reg-expression
expression
| Displays BGP4 route information for an ordered community list regular expression.
|
local
| Displays BGP4 route information about selected local routes.
|
neighbor
ip-addr
| Displays BGP4 route information about selected BGP neighbors.
|
nexthop
ip-addr
| Displays BGP4 route information about routes that are received from the specified next hop.
|
no-best
| Displays BGP4 route information that the device selected as not best routes.
|
not-installed-best
| Displays BGP4 route information about best routes that are not installed.
|
prefix-list
string
| Displays BGP4 route information that is filtered by a prefix list.
|
regular-expression
name
| Displays BGP4 route information about routes that are associated with the specified regular expression.
|
route-map
name
| Displays BGP4 route information about routes that use the specified route map.
|
summary
| Displays BGP4 summary route information.
|
unreachable
| Displays BGP4 route information about routes whose destinations are unreachable through any of the BGP4 paths in the BGP4 route table.
|
User EXEC mode
The show ip bgp routes command displays the following information:
Output field |
Description |
---|---|
Total number of BGP4 routes (NLRIs) Installed |
Number of BGP4 routes the device has installed in the BGP4 route table. |
Distinct BGP4 destination networks |
Number of destination networks the installed routes represent. The BGP4 route table can have multiple routes to the same network. |
Filtered BGP4 routes for soft reconfig |
Number of route updates received from soft-reconfigured neighbors or peer groups that have been filtered out but retained. |
Routes originated by this device |
Number of routes in the BGP4 route table that this device originated. |
Routes selected as BEST routes |
Number of routes in the BGP4 route table that this device has selected as the best routes to the destinations. |
BEST routes not installed in IP forwarding table |
Number of BGP4 routes that are the best BGP4 routes to their destinations but were not installed in the IP route table because the device received better routes from other sources (such as OSPF, RIP, or static IP routes). |
Unreachable routes (no IGP route for NEXTHOP) |
Number of routes in the BGP4 route table whose destinations are unreachable because the next-hop is unreachable. |
IBGP routes selected as best routes |
Number of "best" routes in the BGP4 route table that are IBGP routes. |
EBGP routes selected as best routes |
Number of "best" routes in the BGP4 route table that are EBGP routes. |
The following example shows sample output from the show ip bgp routes command.
device> show ip bgp routes
Total number of BGP Routes: 97371
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH
S:SUPPRESSED F:FILTERED s:STALE
Prefix Next Hop MED LocPrf Weight Status
1 10.3.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 701 80
2 10.4.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 1
3 10.60.212.0/22 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 701 1 189
4 10.6.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 3356 7170 1455
5 10.8.1.0/24 192.168.4.106 0 100 0 BE
AS_PATH: 65001
The following example shows sample output from the show ip bgp routes command when the best keyword is used.
device> show ip bgp routes best
Searching for matching routes, use ^C to quit...
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH
S:SUPPRESSED F:FILTERED s:STALE
Prefix Next Hop MED LocPrf Weight Status
1 10.3.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 701 80
2 10.4.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 1
3 10.60.212.0/22 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 701 1 189
4 10.6.0.0/8 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 3356 7170 1455
5 10.2.0.0/16 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 701
…
The following example shows sample output from the show ip bgp routes command when the detail keyword is used.
device> show ip bgp routes detail
Number of BGP Routes matching display condition : 1
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH
S:SUPPRESSED F:FILTERED s:STALE
1 Prefix: 10.5.5.5/32, Status: BE, Age: 0h2m10s
NEXT_HOP: 10.0.0.1, Metric: 0, Learned from Peer: 10.0.0.1 (3)
LOCAL_PREF: 100, MED: none, ORIGIN: igp, Weight: 0
AS_PATH: 3
Adj_RIB_out count: 2, Admin distance 20
Last update to IP routing table: 0h2m10s, 1 path(s) installed:
Route is advertised to 2 peers:
10.0.0.3(65002) 10.0.0.5(65002)
The following example shows sample output from the show ip bgp routes command when the summary keyword is used.
device> show ip bgp routes summary
Total number of BGP routes (NLRIs) Installed : 20
Distinct BGP destination networks : 20
Filtered BGP routes for soft reconfig : 100178
Routes originated by this router : 2
Routes selected as BEST routes : 19
BEST routes not installed in IP forwarding table : 1
Unreachable routes (no IGP route for NEXTHOP) : 1
IBGP routes selected as best routes : 0
EBGP routes selected as best routes : 17
The following example shows sample output from the show ip bgp routes command when the unreachable keyword is used.
device> show ip bgp routes unreachable
Searching for matching routes, use ^C to quit...
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH
S:SUPPRESSED F:FILTERED s:STALE
Prefix Next Hop Metric LocPrf Weight Status
1 10.8.8.0/24 192.168.5.1 0 101 0
AS_PATH: 65001 4355 1
The following example shows sample output from the show ip bgp routes command when an IP address is specified.
device> show ip bgp route 10.3.4.0
Number of BGP Routes matching display condition : 1
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH S:SUPPRESSED F:FILTERED s:STALE
Prefix Next Hop MED LocPrf Weight Status
1 10.3.4.0/24 192.168.4.106 100 0 BE
AS_PATH: 65001 4355 1 1221
Last update to IP routing table: 0h12m1s, 1 path(s) installed:
Gateway Port
192.168.2.1 1/2/1
Route is advertised to 1 peers:
10.20.20.2(65300)