API Guide

Supported
Releases
10.3.0E or later
show ip bgp neighbors
Displays information that BGP neighbors exchange.
Syntax
show ip bgp [vrf vrf-name] neighbors [ip-address] [advertised-routes |
dampened-routes | flap-statistics | denied-routes | routes]
Parameters
● vrf vrf-name — Enter vrf and then the name of the VRF to view information that is exchanged
between BGP neighbors corresponding to that VRF
● ip-address — Enter the IPv4 of IPv6 address of a specific neighbor
● denied-routes — Displays the list of routes that are denied by policy
● advertised-routes—Displays the routes that are advertised to a neighbor
● dampened-routes—Displays the suppressed routes that are received from a neighbor
● flap-statistics—Displays the flap statistics of routes that are received from a neighbor
● received-routes—Displays the routes that are received from a neighbor.
● routes—Displays routes learned from a neighbor
Default Not configured
Command Mode EXEC
Usage
Information
● BGP neighbor — Displays the BGP neighbor address and its AS number. The last phrase in the line
indicates whether the link between the BGP router and its neighbor is an external or internal one. If
they are located in the same AS, the link is internal; otherwise the link is external.
● BGP version — Displays the BGP version, always version 4, and the remote router ID.
● BGP state — Displays the BGP state of the neighbor and the amount of time in hours:minutes:
seconds it has been in that state.
● Last read — Displays the information in the last read:
○ Last read is the time in hours:minutes:seconds that the router read a message from its neighbor.
○ Hold time is the number of seconds configured between messages from its neighbor.
○ Keepalive interval is the number of seconds between keepalive messages to help ensure that the
TCP session is still alive.
● Received messages — Displays the number of BGP messages received, the number of
notifications or error messages, and the number of messages waiting in a queue for processing.
● Sent messages — Displays the number of BGP messages sent, the number of notifications or error
messages, and the number of messages waiting in a queue for processing.
● Description — Displays the descriptive name that is configured for the BGP neighbor. This field is
displayed only when the description is configured.
● Local host — Displays the peering address of the local router and the TCP port number.
● Foreign host — Displays the peering address of the neighbor and the TCP port number.
Although the status codes for routes that are received from a BGP neighbor may not display in the show
ip bgp neighbors ip-address received-routes output, they display correctly in the show
ip bgp output.
Example
OS10# show ip bgp neighbors
BGP neighbor is 2.2.2.2, remote AS 200, local AS 100 external link
Member of peer-group ebgppg for session parameters
BGP version 4, remote router ID 2.2.2.2
BGP state ESTABLISHED, in this state for 00:00:39
Last read 00:14:47 seconds
Hold time is 180, keepalive interval is 60 seconds
Configured hold time is 180, keepalive interval is 60 seconds
Fall-over disabled
Received 4 messages
1 opens, 0 notifications, 0 updates
644 Layer 3