`show ip bgp routes`

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

Syntax

Parameters

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.

Modes

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.

Examples

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)

History

RUCKUS FastIron Command Reference Guide, 10.0.10 53-1005769-22

show ip bgp routes

`show ip bgp routes`