show ip bgp neighbors

show ip bgp neighbors

Displays information about a peer and the number of routes received/advertised to/from that peer.

Syntax: show ip bgp neighbors [ip-address] {advertised routes | dampened routes | flap-statistics | routes | paths | received-routes | accepted-routes}

ip-address

IP address of the neighbor to be displayed.

advertised routes

Show routes the router has advertised to the specified neighbor or all neighbors.

dampened routes

Show dampened routes to the specified neighbor or all neighbors.

flap-statistics

Show flap-statistics for the specified neighbor or all neighbors.

routes

Show routes received from specified neighbor.

paths

Show paths received from specified neighbor.

received-routes

Show all routes sent by neighbor.

accepted-routes

Show the policy-unmodified version of routes sent by the neighbor that were accepted by policy.

Description: Use the show ip bgp neighbors command to display information about a peer and all the routes received from that peer.

Use the optional ip-address argument to display information about the specified neighbor. Use no ip-address argument to display information about all neighbors.

Use the advertised routes keyword to display information about routes the router has advertised to the specified neighbor or all neighbors.

Use the dampened routes keyword to display information about dampened routes to the neighbor specified or all neighbors.

Use the flap-statistics keyword to display information about flap-statistics of the neighbor specified or all neighbors.

Use the routes keyword to display information about routes received from the specified neighbor or from all neighbors.

NOTE When soft reconfiguration is enabled, the show ip bgp neighbor n.n.n.n routes command displays all routes received by a neighbor not just the routes that were installed in the BGP table.

Use the paths keyword to display information about paths received from the specified neighbor or from all neighbors.

Factory Default: None.

Command Mode: Executive and privileged.

Example 1: The following is sample output from the show ip bgp neighbors command:

router#show ip bgp neighbors

BGP neighbor 1.1.1.1 using remote AS 100

router ID: 1.1.1.1 version: 4

state: Active time: 23:37:29

def orignat: False ebgp multihop: False

n hop self: False route ref client: False

send comm: False soft reconfig: False

update src: loopback 0

hold time: 0 sec keepalive time: 0 sec

configured hold time/keepalive time: 180/60 sec

advertisement interval: 5 sec

# notf rcvd: 0 # msg rcvd: 0 # updates rcvd: 0

# notf sent: 1 # msg sent: 0 # updates sent: 0

number of prefixes received: 0

Address Family IPv4 Unicast: activated advertised

Route refresh capability: advertised received (new)

Route Refresh for address family IPv4 unicast: #msg rcvd: 0 #msg sent 0

Routes Dropped : 0

Time Since First Dropped : 0:00:00

Reason for dropping first Route : No Routes Dropped

Last Reset 23:37:29 , due to BGP Hold Timer Expired Error sent to peer

BGP neighbor 3.3.3.3 using remote AS 100

router ID: 3.3.3.3 version: 4

state: Active time: 23:37:27

.

.

.

BGP neighbor 6.6.6.6 using remote AS 100

router ID: 6.6.6.6 version: 4

state: Estab time: 611:57:24

def orignat: False ebgp multihop: False

n hop self: False route ref client: False

send comm: False soft reconfig: False

update src: loopback 0

hold time: 180 sec keepalive time: 60 sec

configured hold time/keepalive time: 180/60 sec

advertisement interval: 5 sec

# notf rcvd: 1 # msg rcvd: 36716 # updates rcvd: 0

# notf sent: 1 # msg sent: 36715 # updates sent: 0

number of prefixes received: 0

Address Family IPv4 Unicast: activated advertised received in-use

Routes Dropped : 0

Time Since First Dropped : 0:00:00

Reason for dropping first Route : No Routes Dropped

Last Reset 611:57:24 , due to BGP Cease sent to peer

router#

The following table describes the fields in the display:

Table 4-8. Fields Displayed by show ip bgp neighbors
Field Description

BGP Neighbor

IP address of the BGP neighbor and it's autonomous system number.

Router ID

Router ID of the BGP neighbor.

BGP version

Version of BGP used to communicate with neighbor. This value is always 4.

State

The current state of the session:

idle - Idle state - ignore everything.

Connect - Connect state - trying to connect.

Active - Waiting for a connection.

OpenSent - Open packet has been sent.

OpenConfirm - Waiting for keepalive or notify

Estab - Connection has been established.

Time

Elapsed time in the current state. Peers that have never reached the Established state have a time of 0:00:00.

def originate:

Indicates if default-originate has been configured for this neighbor.

ebgp multihop:

Indicates if ebgp-multihop has been configured for this neighbor.

n hop self:

Indicates if next-hop-self has been configured for this neighbor.

route ref client

Indicates if this neighbor has been configured as a route reflector client.

send comm:

Indicates if send-community has been enabled to this neighbor.

soft reconfig:

Indicates if soft-reconfiguration-inbound has been configured for this neighbor.

hold time

The number of seconds this BGP speaker waits for a keepalive, update, or notification message from this neighbor before deciding that the connection is down.

keepalive time

The number of seconds this BGP speaker waits for a keepalive message from this neighbor before deciding that the connection is down.

# notf rcvd

Number of accumulated notifications (error messages and other alerts) received since this neighbor was configured.

# msg rcvd

Number of messages received from this neighbor since current session was established.

# updates rcvd:

Number of routing updates received from this neighbor.

# notf sent

Number of accumulated notifications (error messages and other alerts) sent since this neighbor was configured.

# msg sent

Number of packets sent to this neighbor since current session was established.

# updates sent

Number of routing updates sent to this neighbor.

advertisement interval:

Minimum interval for sending BGP route updates to this neighbor.

Number of prefixes received

Number of network advertisements for different prefixes received from this neighbor.

inbound AS-path filter

Name of as-path access list applied to inbound updates from this neighbor. Displayed only if as-path access list is applied.

outbound AS-path filter

Name of as-path access list applied to outbound updates to this neighbor. Displayed only if as-path access list is applied.

inbound network filter

Name of access list or ip access list applied to inbound updates from this neighbor. Displayed only if access list is applied.

outbound network filter

Name of access list or ip access list applied to outbound updates to this neighbor. Displayed only if access list is applied.

inbound route-map

Name of route map applied to route updates from this neighbor. Displayed only if route map is applied.

outbound route-map

Name of route map applied to route updates to this neighbor. Displayed only if route map is applied.

Address Family

Indicates if IPv4 unicast or multicast services are enabled.

Route refresh Capability

Indicates the status of Route Refresh for this peer

Route refresh request for IPv4 address family

Specifies the number of sent and received route refresh requests.

Routes Dropped

Number of routes dropped.

Time Since First Dropped:

Elapsed time since first route was dropped.

Reason for dropping first route

Max. Bgp Unique Route Exceeded: The number of unique routes received from this peer exceeded the threshold configured using the max-unique-
prefixes command.

Max. Bgp Route Instances Exceeded: The number of route instances received from this peer exceeded the threshold configured using the max-route-
instances command.

Min. System Mem Threshold Exceeded: The amount of memory required to process the routes received from this peer exceeded the threshold configured using the min-memory-threshold command.

Last Reset

Specifies the elapsed time in hours:minutes:
seconds since the last peer session reset and the reason for the reset. The information is available regardless of whether the peer has come back up or not.

Example 2: The following sample output of the show ip bgp neighbors n.n.n.n paths command displays information about paths received from the specified neighbor. See show ip bgp paths for a description of the fields.
router#show ip bgp neighbors 3.3.3.3 paths

Hash Refcount Path

231675 2 7737 7734 7735 2386 7018 80 i

231686 104 7737 7734 7735 2386 7018 3356 i

231689 20 7737 7734 7735 7046 701 11853 6496 6496 6496 6496 i

231696 2 7737 7734 7735 7046 701 6389 8063 19198 i

231698 4 7737 7734 7735 7046 701 3561 6128 30576 i

.

.

.
The following is sample output from the show ip bgp neighbors n.n.n.n paths with an identifier to specify a single autonomous system path. See show ip bgp paths for a description of the fields.

router#show ip bgp neighbors 3.3.3.3 paths _46_

Hash Refcount Path

|245765 12 7737 7734 7735 2386 7018 1239 46 i

router#

Example 3: The following is sample output from the show ip bgp neighbors command using the routes keyword:

router#show ip bgp neighbors 10.200.91.58 routes

Status codes: * - valid Origin codes: i - IGP

d - damped e - EGP

h - history ? - incomplete

s - suppressed > - best

a - aggregate

i - internal

Network Next Hop Metric LocPrf Weight Path

*> 10.2.21.72/32 10.200.0.1 100 0 8 200 ?

*> 10.10.11.0/24 10.200.0.1 100 0 8 200 ?

*> 10.10.12.0/24 10.200.0.1 100 0 8 200 ?

*> 10.10.13.0/24 10.200.0.1 100 0 8 200 ?

*> 14.1.1.0/24 10.200.0.1 100 0 8 200 ?

*> 22.22.22.0/24 10.200.0.1 100 0 8 200 ?

*> 33.33.33.0/24 10.200.0.1 100 0 8 200 ?

*> 100.0.0.0/8 10.200.0.1 100 0 8 200 ?

router#

Example 4: The following is sample output from the show ip bgp neighbors command using the advertised-routes keyword:

router#show ip bgp neighbors 18.1.1.1 advertised-routes

Status codes: * - valid Origin codes: i - IGP

d - damped e - EGP

h - history ? - incomplete

s - suppressed > - best

a - aggregate

i - internal

Total Number of Prefixes : 3

Network Next Hop Metric LocPrf Weight Path

*> 6.6.6.6/32 6.6.6.6 0 0 0 ?

*> 18.1.1.0/24 18.1.1.1 0 0 0 ?

*> 19.1.1.0/24 19.1.1.1 0 0 0 ?

router#

Example 5: The following is sample output from the show ip bgp neighbors command using the accepted-routes keyword:

router#show ip bgp neighbors 10.200.91.58 accepted-routes

Status codes: * - valid Origin codes: i - IGP

d - damped e - EGP

h - history ? - incomplete

s - suppressed > - best

a - aggregate

i - internal

Network Next Hop Metric LocPrf Weight Path

*> 10.2.21.72/32 10.200.0.1 100 0 8 200 ?

*> 10.10.11.0/24 10.200.0.1 100 0 8 200 ?

*> 14.1.1.0/24 10.200.0.1 100 0 8 200 ?

*> 33.33.33.0/24 10.200.0.1 100 0 8 200 ?

*> 100.0.0.0/8 10.200.0.1 100 0 8 200 ?

router#

Example 6: The following is sample output from the show ip bgp neighbors command using the received-routes keyword:

router#show ip bgp neighbors 10.200.91.58 received-routes

Status codes: * - valid Origin codes: i - IGP

d - damped e - EGP

h - history ? - incomplete

s - suppressed > - best

a - aggregate

i - internal

Network Next Hop Metric LocPrf Weight Path

*> 10.2.21.72/32 10.200.0.1 100 0 8 200 ?

*> 10.10.11.0/24 10.200.0.1 100 0 8 200 ?

10.10.12.0/24 10.200.0.1 100 0 8 200 ?

10.10.13.0/24 10.200.0.1 100 0 8 200 ?

*> 14.1.1.0/24 10.200.0.1 100 0 8 200 ?

22.22.22.0/24 10.200.0.1 100 0 8 200 ?

*> 33.33.33.0/24 10.200.0.1 100 0 8 200 ?

*> 100.0.0.0/8 10.200.0.1 100 0 8 200 ?

111.0.0.0/8 10.200.91.58 100 0 8 10 ?

router#

The following table describes the fields in the display:

Table 4-9. Fields Displayed by show ip bgp neighbors routes
Field Description

Total Number of Prefixes

Specifies the total number of prefixes displayed.

Network

IP address of a network. Optionally includes the network mask.

> =The best route for that network.

Next Hop

IP address of the next system used when forwarding packets to the destination network. 0.0.0.0 in this field indicates the router has non-BGP routes to the network.

Metric

Inter-autonomous system metric.

LocPrf

Local preference value. See the set local-preference command. Default value is 100.

Weight

Weight of the route as defined by set weight and router bgp route map configuration commands.

Path

Autonomous system path to the destination network.

Origin codes

Identifies the origin of the entry. Valid values are listed below.

i - Entry originated in IGP. Entry was advertised by the network route configuration command.

e - Entry originated in EGP.

? - Entry origin is not clear. Reachability information learned from some other source (usually indicates route is redistributed from IGP into BGP).

Related Commands: show ip bgp
show ip bgp peer-group
show ip bgp routes-dropped-sessions
show ip bgp summary

ip-address	IP address of the neighbor to be displayed.
advertised routes	Show routes the router has advertised to the specified neighbor or all neighbors.
dampened routes	Show dampened routes to the specified neighbor or all neighbors.
flap-statistics	Show flap-statistics for the specified neighbor or all neighbors.
routes	Show routes received from specified neighbor.
paths	Show paths received from specified neighbor.
received-routes	Show all routes sent by neighbor.
accepted-routes	Show the policy-unmodified version of routes sent by the neighbor that were accepted by policy.

router#show ip bgp neighbors BGP neighbor 1.1.1.1 using remote AS 100 router ID: 1.1.1.1 version: 4 state: Active time: 23:37:29 def orignat: False ebgp multihop: False n hop self: False route ref client: False send comm: False soft reconfig: False update src: loopback 0 hold time: 0 sec keepalive time: 0 sec configured hold time/keepalive time: 180/60 sec advertisement interval: 5 sec # notf rcvd: 0 # msg rcvd: 0 # updates rcvd: 0 # notf sent: 1 # msg sent: 0 # updates sent: 0 number of prefixes received: 0 Address Family IPv4 Unicast: activated advertised Route refresh capability: advertised received (new) Route Refresh for address family IPv4 unicast: #msg rcvd: 0 #msg sent 0 Routes Dropped : 0 Time Since First Dropped : 0:00:00 Reason for dropping first Route : No Routes Dropped Last Reset 23:37:29 , due to BGP Hold Timer Expired Error sent to peer BGP neighbor 3.3.3.3 using remote AS 100 router ID: 3.3.3.3 version: 4 state: Active time: 23:37:27 . . . BGP neighbor 6.6.6.6 using remote AS 100 router ID: 6.6.6.6 version: 4 state: Estab time: 611:57:24 def orignat: False ebgp multihop: False n hop self: False route ref client: False send comm: False soft reconfig: False update src: loopback 0 hold time: 180 sec keepalive time: 60 sec configured hold time/keepalive time: 180/60 sec advertisement interval: 5 sec # notf rcvd: 1 # msg rcvd: 36716 # updates rcvd: 0 # notf sent: 1 # msg sent: 36715 # updates sent: 0 number of prefixes received: 0 Address Family IPv4 Unicast: activated advertised received in-use Routes Dropped : 0 Time Since First Dropped : 0:00:00 Reason for dropping first Route : No Routes Dropped Last Reset 611:57:24 , due to BGP Cease sent to peer router#

**Table 4-8.** Fields Displayed by show ip bgp neighbors
Field	Description
BGP Neighbor	IP address of the BGP neighbor and it's autonomous system number.
Router ID	Router ID of the BGP neighbor.
BGP version	Version of BGP used to communicate with neighbor. This value is always 4.
State	The current state of the session: idle - Idle state - ignore everything. Connect - Connect state - trying to connect. Active - Waiting for a connection. OpenSent - Open packet has been sent. OpenConfirm - Waiting for keepalive or notify Estab - Connection has been established.
Time	Elapsed time in the current state. Peers that have never reached the Established state have a time of 0:00:00.
def originate:	Indicates if default-originate has been configured for this neighbor.
ebgp multihop:	Indicates if ebgp-multihop has been configured for this neighbor.
n hop self:	Indicates if next-hop-self has been configured for this neighbor.
route ref client	Indicates if this neighbor has been configured as a route reflector client.
send comm:	Indicates if send-community has been enabled to this neighbor.
soft reconfig:	Indicates if soft-reconfiguration-inbound has been configured for this neighbor.
hold time	The number of seconds this BGP speaker waits for a keepalive, update, or notification message from this neighbor before deciding that the connection is down.
keepalive time	The number of seconds this BGP speaker waits for a keepalive message from this neighbor before deciding that the connection is down.
# notf rcvd	Number of accumulated notifications (error messages and other alerts) received since this neighbor was configured.
# msg rcvd	Number of messages received from this neighbor since current session was established.
# updates rcvd:	Number of routing updates received from this neighbor.
# notf sent	Number of accumulated notifications (error messages and other alerts) sent since this neighbor was configured.
# msg sent	Number of packets sent to this neighbor since current session was established.
# updates sent	Number of routing updates sent to this neighbor.
advertisement interval:	Minimum interval for sending BGP route updates to this neighbor.
Number of prefixes received	Number of network advertisements for different prefixes received from this neighbor.
inbound AS-path filter	Name of as-path access list applied to inbound updates from this neighbor. Displayed only if as-path access list is applied.
outbound AS-path filter	Name of as-path access list applied to outbound updates to this neighbor. Displayed only if as-path access list is applied.
inbound network filter	Name of access list or ip access list applied to inbound updates from this neighbor. Displayed only if access list is applied.
outbound network filter	Name of access list or ip access list applied to outbound updates to this neighbor. Displayed only if access list is applied.
inbound route-map	Name of route map applied to route updates from this neighbor. Displayed only if route map is applied.
outbound route-map	Name of route map applied to route updates to this neighbor. Displayed only if route map is applied.
Address Family	Indicates if IPv4 unicast or multicast services are enabled.
Route refresh Capability	Indicates the status of Route Refresh for this peer
Route refresh request for IPv4 address family	Specifies the number of sent and received route refresh requests.
Routes Dropped	Number of routes dropped.
Time Since First Dropped:	Elapsed time since first route was dropped.
Reason for dropping first route	Max. Bgp Unique Route Exceeded: The number of unique routes received from this peer exceeded the threshold configured using the max-unique- prefixes command. Max. Bgp Route Instances Exceeded: The number of route instances received from this peer exceeded the threshold configured using the max-route- instances command. Min. System Mem Threshold Exceeded: The amount of memory required to process the routes received from this peer exceeded the threshold configured using the min-memory-threshold command.
Last Reset	Specifies the elapsed time in hours:minutes: seconds since the last peer session reset and the reason for the reset. The information is available regardless of whether the peer has come back up or not.

router#show ip bgp neighbors 3.3.3.3 paths Hash Refcount Path 231675 2 7737 7734 7735 2386 7018 80 i 231686 104 7737 7734 7735 2386 7018 3356 i 231689 20 7737 7734 7735 7046 701 11853 6496 6496 6496 6496 i 231696 2 7737 7734 7735 7046 701 6389 8063 19198 i 231698 4 7737 7734 7735 7046 701 3561 6128 30576 i . . .

router#show ip bgp neighbors 3.3.3.3 paths _46_ Hash Refcount Path \|245765 12 7737 7734 7735 2386 7018 1239 46 i router#

router#show ip bgp neighbors 10.200.91.58 routes Status codes: * - valid Origin codes: i - IGP d - damped e - EGP h - history ? - incomplete s - suppressed > - best a - aggregate i - internal Network Next Hop Metric LocPrf Weight Path > 10.2.21.72/32 10.200.0.1 100 0 8 200 ? > 10.10.11.0/24 10.200.0.1 100 0 8 200 ? > 10.10.12.0/24 10.200.0.1 100 0 8 200 ? > 10.10.13.0/24 10.200.0.1 100 0 8 200 ? > 14.1.1.0/24 10.200.0.1 100 0 8 200 ? > 22.22.22.0/24 10.200.0.1 100 0 8 200 ? > 33.33.33.0/24 10.200.0.1 100 0 8 200 ? > 100.0.0.0/8 10.200.0.1 100 0 8 200 ? router#

router#show ip bgp neighbors 18.1.1.1 advertised-routes Status codes: * - valid Origin codes: i - IGP d - damped e - EGP h - history ? - incomplete s - suppressed > - best a - aggregate i - internal Total Number of Prefixes : 3 Network Next Hop Metric LocPrf Weight Path > 6.6.6.6/32 6.6.6.6 0 0 0 ? > 18.1.1.0/24 18.1.1.1 0 0 0 ? *> 19.1.1.0/24 19.1.1.1 0 0 0 ? router#

router#show ip bgp neighbors 10.200.91.58 accepted-routes Status codes: * - valid Origin codes: i - IGP d - damped e - EGP h - history ? - incomplete s - suppressed > - best a - aggregate i - internal Network Next Hop Metric LocPrf Weight Path > 10.2.21.72/32 10.200.0.1 100 0 8 200 ? > 10.10.11.0/24 10.200.0.1 100 0 8 200 ? > 14.1.1.0/24 10.200.0.1 100 0 8 200 ? > 33.33.33.0/24 10.200.0.1 100 0 8 200 ? *> 100.0.0.0/8 10.200.0.1 100 0 8 200 ? router#

router#show ip bgp neighbors 10.200.91.58 received-routes Status codes: * - valid Origin codes: i - IGP d - damped e - EGP h - history ? - incomplete s - suppressed > - best a - aggregate i - internal Network Next Hop Metric LocPrf Weight Path > 10.2.21.72/32 10.200.0.1 100 0 8 200 ? > 10.10.11.0/24 10.200.0.1 100 0 8 200 ? 10.10.12.0/24 10.200.0.1 100 0 8 200 ? 10.10.13.0/24 10.200.0.1 100 0 8 200 ? > 14.1.1.0/24 10.200.0.1 100 0 8 200 ? 22.22.22.0/24 10.200.0.1 100 0 8 200 ? > 33.33.33.0/24 10.200.0.1 100 0 8 200 ? *> 100.0.0.0/8 10.200.0.1 100 0 8 200 ? 111.0.0.0/8 10.200.91.58 100 0 8 10 ? router#

**Table 4-9.** Fields Displayed by show ip bgp neighbors routes
Field	Description
Total Number of Prefixes	Specifies the total number of prefixes displayed.
Network	IP address of a network. Optionally includes the network mask. > =The best route for that network.
Next Hop	IP address of the next system used when forwarding packets to the destination network. 0.0.0.0 in this field indicates the router has non-BGP routes to the network.
Metric	Inter-autonomous system metric.
LocPrf	Local preference value. See the set local-preference command. Default value is 100.
Weight	Weight of the route as defined by set weight and router bgp route map configuration commands.
Path	Autonomous system path to the destination network.
Origin codes	Identifies the origin of the entry. Valid values are listed below. i - Entry originated in IGP. Entry was advertised by the network route configuration command. e - Entry originated in EGP. ? - Entry origin is not clear. Reachability information learned from some other source (usually indicates route is redistributed from IGP into BGP).

   Source File Name: BGP_Nd.fm
    HTML File Name: BGP_Nd55.html
    Last Updated: 05/10/04 at 16:36:55

show ip bgp neighbors

Please email suggestions and comments to: doc@avici.com