show ip bgp

This command displays information about BGP routes installed in the BGP routing information base (RIB).

Syntax

show ip bgp [ip-address] [ip-prefix/mask] [longer-prefixes] [detail] [peer ip-addr {all-received-routes | received-routes | advertised-routes}]

Parameters

ip-address (Optional) Specifies an IPv4 address for BGP route display.
ip-prefix/mask (Optional) Specifies an IP prefix and mask for BGP route display
longer-prefixes (Optional) Specifies that only routes matching the specified IP address or IP prefix/length will display.
detail (Optional) Displays a detailed level of information including:
  • Route community attributes
  • Route Extended Community attributes
  • Route Target
  • Route Flap Dampening table name
  • Flap related counters
peer ip-addr (Optional) Specifies the peer to display route information for.
all-received-routes Show all received routes for the specified peer.
received-routes Show received routes from the peer after import policies are applied matching prefix and mask (local-rib)
advertised-routes Show all routes advertised to the peer after export policies have been applied that match a prefix and mask (rib-out).

Defaults

  • If a peer IP address, route, or the longer prefix option is not specified, information is displayed for all peers and routes.
  • If detail is not specified, a standard level of route information displays.

Mode

All command modes.

Usage

To display BGP VPN routes see clear ip bgp flap-all-stats.

Example

The following example returns BGP information for all BGP routes installed in the BGP RIB.

System(rw)->show ip bgp
show ip bgp
Route status codes: > - active
    Network                  Next Hop              Rib MED Local-Pref Origin AS Path
>   7.1.1.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.2.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.3.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.4.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.5.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.6.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.7.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.8.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.9.0/24               192.168.7.112         U   0      100    IGP     7
>   7.1.10.0/24              192.168.7.112         U   0      100    IGP     7
>   7.1.11.0/24              192.168.7.112         U   0      100    IGP     7
>   7.1.12.0/24              192.168.7.112         U   0      100    IGP     7
>   7.1.13.0/24              192.168.7.112         U   0      100    IGP     7
...
System(rw)->

show ip bgp Output Details table describes the fields that appear in the show ip bgp query.

.

Click to expand in new window

show ip bgp Output Details

Output... What it displays...
Network Specifies the network this route is on.
Next Hop Specifies the IP address of the nearest gateway used to reach the EBGP peer
Rib Specifies whether the route is installed in the unicast or multicast RIB
MED Specifies the MED value for the route.
Local-Pref Specifies the Local Preference value for the route.
Origin Specifies whether the origin of the route is an internal or external protocol.
AS Path Specifies the route‘s AS Path.

The following example display advertised routes for peer 192.168.7.112:

System(rw)->show ip bgp peer 192.168.7.112 advertised-routes
Route status codes: adv - advertised, sup - suppressed, pw - pending w/drawal, wd - w/drawn
Route aggregation codes:
1 - Route is not aggregating or aggregated
2 - Route is aggregating
3 - Route is unsuppressed aggregated
4 - Route is suppressed aggregated
Stat Aggr    Network                  Next Hop        Rib MED Local-Pref Origin AS Path
adv  1       8.1.1.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.2.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.3.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.4.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.5.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.6.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.7.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.8.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.9.0                  192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.10.0                 192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.11.0                 192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.12.0                 192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.13.0                 192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.14.0                 192.168.7.111    U   0      0      IGP     10 8
adv  1       8.1.15.0                 192.168.7.111    U   0      0      IGP     10 8
...
System(rw)->

show ip bgp peer Output Details describes the fields that appear in the show ip bgp peer query.

.

Click to expand in new window

show ip bgp peer Output Details

Output... What it displays...
Stat Specifies the status of the route as follows:
  • adv - advertised
  • sup - suppressed
  • pw - route pending withdrawal
  • wd - route withdrawn
Aggr Specifies a route aggregation code as follows:
  • 1 - This route is neither aggregating nor aggregated
  • 2 - This route is aggregating
  • 3 - This route is an unsuppressed aggregate
  • 4 - This route is a suppressed aggregate
Network Specifies the network this route is on.
Next Hop Specifies the IP address of the nearest gateway used to reach the EBGP peer
Rib Specifies whether the route is installed in the unicast or multicast RIB
MED Specifies the MED value for the route.
Local-Pref Specifies the Local Preference value for the route.
Origin Specifies whether the origin of the route is an internal or external protocol.
AS Path Specifies the route‘s AS Path.

The following example provides a detailed level of information for routes matching 7.1.1.0/24:

System(rw)->show ip bgp 7.1.1.0/24 longer-prefixes detail
Route status codes: > - active
    Network                  Next Hop              Rib MED Local-Pref Origin AS Path
>   7.1.1.0/24               192.168.7.112         U   0      100    IGP     7
Community attributes in route:
10:700
Extended Community attributes in route:
Route Target: 0:117506304 (0x0002000007010100)
Route Flap Dampening configuration file name: flap1
Is route suppressed? No
Flap penalty: 0, Flap Count 0, Flap time remaining 0 seconds
System(rw)->