show ip bgp routes

Displays statistics for the routes in the BGP4 route table of a device.

show ip bgp routes [ detail ] [ num | ip-address/prefix | age num | as-path-access-list name | as-path-filter number | best | cidr-only | community-access-list name | community-filter number | community-reg-expression expression | local | neighbor ip-addr | nexthop ip-addr | no-best | not-installed-best | prefix-list string | regular-expression name | route-map name | summary | unreachable ]
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)