show bgp neighbor
For IPv4 and IPv6 address families:
show bgp {neighbor} remoteaddr {address-family [ipv4-unicast | ipv4-multicast |ipv6-unicast | ipv6-multicast]} [accepted-routes | received-routes | rejected-routes | transmitted-routes] {detail} [all | as-path path-expression | community [no-advertise | no-export | no-export-subconfed | number community_number | autonomous-system-id : bgp-community] | network [any / netMaskLen | networkPrefixFilter] {exact}]For the VPNv4 address family:
show bgp {neighbor} remoteaddr address-family vpnv4 [accepted-routes | received-routes | rejected-routes | transmitted-routes] {detail} [all | as-path path-expression | community [no-advertise | no-export | no-export-subconfed | number community_number | autonomous-system-id :bgp-community] | rd rd_value network [any / netMaskLen | networkPrefixFilter] {exact}]Description
Displays information about routes to a specified neighbor.
Syntax Description
remoteaddr | Specifies an IPv4 or IPv6 address that identifies a BGP neighbor. |
ipv4-unicast | Specifies IPv4 unicast routes. |
ipv4-multicast | Specifies IPv4 multicast routes. |
ipv6-unicast | Specifies IPv6 unicast routes. |
ipv6-multicast | Specifies IPv6 multicast routes. |
vpnv4 | Specifies VPNv4 routes. |
accepted-routes | Specifies that only accepted routes are displayed. |
received-routes | Specifies that only received routes are displayed. |
rejected-routes | Specifies that only rejected routes are displayed. |
transmitted-routes | Specifies that only transmitted routes are displayed. |
detail | Specifies to display the information in detailed format. |
all | Specifies all routes. |
path-expression | Display routes that match the specified AA path expression. |
no-advertise | Specifies the no-advertise community attribute. |
no-export | Specifies the no-export community attribute. |
no-export-subconfed | Specifies the no-export-subconfed community attribute. |
community_number | Specifies a community number. |
autonomous-system-id | Specifies an autonomous system ID (0-65535). |
bgp-community | Specifies the BGP community number. |
rd | Specifies the Route Distinquisher (RD) value for the Layer 3 VPN routes for which you want to clear flap statistics. |
any | Specifies all routes with a given or larger mask length. |
netMaskLen | Specifies a IPv4 or IPv6 subnet mask length (number of bits). |
networkPrefixFilter | Specifies an IPv4 or IPv6 address and netmask. |
exact | Specifies an exact match with the IP address and subnet mask. |
Default
If no address family is specified, IPv4 unicast is the default.
Usage Guidelines
show bgp neighbor now supports v6 unicast and multicast and vpnv4 address families. This command applies to the current VR or VRF context.
![Note](../../images/Note_Note.png)
Note
If this command displays Bad Source Address, the BGP neighbor IP address is unavailable. Possible causes for this condition include a deleted or unconfigured VLAN or IP address.
The option network any / netMaskLen displays all BGP routes whose mask length is equal to or greater than maskLength, irrespective of their network address.
The option network any / netMaskLen exact displays all BGP routes whose mask length is exactly equal to maskLength, irrespective of their network address.
If you do not specify an address family, this command applies to the IPv4 unicast address family. To apply this command to an address family other than the IPv4 unicast address family, you must specify the address family.
![Note](../../images/Note_Note.png)
Note
For an IPv6 peer, an IPv6 address family must be specified, because an IPv6 peer does not support IPv4 address families. If no address family is specified for an IPv6 peer, the default address-family, i.e. IPv4 unicast is assumed and hence no address-family information appears. Similarly an IPv4 peer only supports IPv4 address families and no address-family information appears if an IPv6 address family is specified.
To display Layer 3 VPN information, you must enter this command in the context of on the MPLS-enabled VR; it is not supported for BGP neighbors on the CE (VRF) side of the PE router.
Example
The following command displays sample output for show bgp neighbor summary:
Switch.18 # show bgp nei ? <cr> Execute the command detail display all information available about BGP neighbor <remoteaddr> BGP neighbor IP address "11.0.0.2" “3001::1” BD-12802.1 # show bgp neighbor Peer AS Weight State InMsgs OutMsgs(InQ) Up/Down ------------------------------------------------------------------------------- Ie-- 11.0.0.2 100 0 OPENSENT 0 9 (0 ) 0:8:27:21 Ie-- 3001::1 100 0 ESTABLISEHD 4 3 (0 ) 0:8:27:21 Flags: (d) disabled, (e) enabled, (E) external peer, (I) internal peer (m) EBGP multihop, (r) route reflector client BGP Peer Statistics Total Peers : 2 EBGP Peers : 0 IBGP Peers : 2 RR Client : 0 EBGP Multihop : 0 Enabled : 2 Disabled : 0
The following example displays show output for an IPv4 peer:
switch 19 # sh bgp neighbor 11.0.0.5 det Peer Description : IBGP Peer : 1.0.0.3 AS : 1000 Enabled : Yes OperStatus : Up Weight : 1 Shutdown-Priority : 1024 ConnectRetry : 120 MinAsOrig : 5 HoldTimeCfg : 180 KeepaliveCfg : 60 Source Interface : 1.0.0.2 RRClient : No EBGP-Multihop : No Remove Private AS : No BFD : Off BFD Status : Inactive Capabilities Config : ipv4-unicast,ipv4-multicast,4-Byte-As,vpnv4,route-refresh (old & new) Policy for NLRI Type ipv4-unicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No Policy for NLRI Type ipv4-multicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No Policy for NLRI Type vpnv4 In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : Standard, Extended Soft Input Recfg : Disabled Allow Looped AS-Path: No Policy for NLRI Type ipv6-unicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No Policy for NLRI Type ipv6-multicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No State : ESTABLISHED FSM Up since : Thu Aug 8 12:09:15 2013 (Duration:0:0:03:28) Remote Addr : 1.0.0.3 Local Addr : 1.0.0.2 Remote Port : 36879 Local Port : 179 Remote RouterId : 1.0.0.3 Local RouterId : 1.0.0.2 HoldTimeNegotiated : 180 KeepAliveNegotiated : 60 FsmTransitions : 1 InUpdateElapsedTime : 00:00:00:05 InMsgElapsedTime : 0:0:00:05 InUpdates : 5 OutUpdates (in TxQ) : 5 (0) InTotalMsgs : 11 OutTotalMsgs : 10 InRouteRefreshes : 0 OutRouteRefreshes : 0 Route Statistics for NLRI Type ipv4-unicast Received : 0 Accepted : 0 Rejected : 0 Active : 0 Suppressed : 0 Route Statistics for NLRI Type ipv4-multicast Received : 0 Accepted : 0 Rejected : 0 Active : 0 Suppressed : 0 Route Statistics for NLRI Type vpnv4 Received : 4 Accepted : 4 Rejected : 0 Active : 0 Suppressed : 0 Capabilities Tx : ipv4-unicast,ipv4-multicast,4-Byte-As,vpnv4,route-refresh (old & new),graceful-restart Capabilities Rx : ipv4-unicast,ipv4-multicast,4-Byte-As,vpnv4,route-refresh (old & new),graceful-restart NLRI for the session: ipv4-unicast,ipv4-multicast,vpnv4 Last State : ESTABLISHED Last Event : RX_KEEP LastError : 'None' Restart Capability : Aware-Only Restart Bit Set : No Restart Time : 120 Restart Status : OFF BGP Peer Statistics Total Peers : 1 EBGP Peers : 0 IBGP Peers : 1 RR Client : 0 EBGP Multihop : 0 Enabled : 1 Disabled : 0
The following example displays output for an IPv6 peer:
switch 19 # show bgp neighbor 3001::1 det EBGP Peer : 3001::1 AS : 5 Enabled : Yes OperStatus : Up Weight : 1 Shutdown-Priority : 1024 ConnectRetry : 120 MinAsOrig : 15 HoldTimeCfg : 180 KeepaliveCfg : 60 Source Interface : Not configured RRClient : No EBGP-Multihop : No Remove Private AS : No BFD : Off BFD Status : Inactive Capabilities Config : ipv6-unicast, ipv6-multicast, 4-Byte-As, route-refresh Policy for NLRI Type ipv6-unicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No RFD HalfLife : 0m RFD Reuse : 0 RFD Suppress : 0 RFD Max-Suppress : 0m Policy for NLRI Type ipv6-multicast In Policy : None Out Policy : None NextHopSelf : Disabled Send Communities : No Soft Input Recfg : Disabled Allow Looped AS-Path: No RFD HalfLife : 0m RFD Reuse : 0 RFD Suppress : 0 RFD Max-Suppress : 0m State : ESTABLISHED FSM Up since : Mon Apr 19 21:20:02 2010 (Duration: 0:0:00:23) Remote Addr : 3001::1 Local Addr : 3001::6 Remote Port : 56539 Local Port : 179 Remote RouterId : 1.0.0.5 Local RouterId : 1.0.0.6 HoldTimeNegotiated : 180 KeepAliveNegotiated : 60 FsmTransitions : 5 InUpdateElapsedTime : 00:00:00:23 InMsgElapsedTime : 0:0:00:23 InUpdates : 1 OutUpdates (in TxQ) : 4 (0) InTotalMsgs : 1 OutTotalMsgs : 4 InRouteRefreshes : 0 OutRouteRefreshes : 0 Route Statistics for NLRI Type ipv6-unicast Received : 6 Accepted : 6 Rejected : 0 Active : 6 Suppressed : 0 Route Statistics for NLRI Type ipv6-multicast Received : 0 Accepted : 0 Rejected : 0 Active : 0 Suppressed : 0 Capabilities Tx : ipv6-unicast, ipv6-multicast, 4-Byte-AS, route-refresh (old & new), vpnv4 Capabilities Rx : ipv6-unicast, ipv6-multicast NLRI for the session: ipv6-unicast, ipv6-multicast Error : 'Hold Timer Expired' Tx: 3 Rx: 0 Last State : ESTABLISHED Last Event : RX_UPDATE LastError : 'Hold Timer Expired' (TX) on: Mon Apr 19 20:50:26 2010 BGP Peer Statistics Total Peers : 1 EBGP Peers : 1 IBGP Peers : 0 RR Client : 0 EBGP Multihop : 0 Enabled : 1 Disabled : 0
The following example displays show output for transmitted routes:
switch.19 #show bgp 11.0.0.2 transmitted-routes all Advertised Routes: Destination LPref Weight MED Peer Next-Hop AS-Path ------------------------------------------------------------------------------------ >? 1.1.1.1/32 100 11.0.0.1 100 >? 11.0.0.0/24 100 11.0.0.1 100 >? 101.0.0.0/24 100 11.0.0.1 100 >? 103.0.0.0/24 100 11.0.0.1 100 >? 103.0.0.1/32 100 11.0.0.1 100 Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History (s) Stale, (m) Multipath, (u) Unfeasible Origin: (?) Incomplete, (e) EGP, (i) IGP BGP Route Statistics Advertised Routes : 5
The following example displays show output for rejected routes:
switch.19 # show bgp 11.0.0.2 rejected-routes all Rejected Routes: Destination LPref Weight MED Peer Next-Hop AS-Path ------------------------------------------------------------------------------------ u ? 1.1.1.1/32 100 11.0.0.1 100 Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History (s) Stale, (m) Multipath, (u) Unfeasible Origin: (?) Incomplete, (e) EGP, (i) IGP BGP Route Statistics Total Rxed Routes : 5 Rejected Routes : 1 Unfeasible Routes : 1
The following example displays show output for accepted routes:
switch.21 # show bgp 11.0.0.2 accepted-routes all Rejected Routes: Destination LPref Weight MED Peer Next-Hop AS-Path ------------------------------------------------------------------------------------ >? 11.0.0.0/24 100 11.0.0.1 100 >? 101.0.0.0/24 100 11.0.0.1 100 >? 103.0.0.0/24 100 11.0.0.1 100 >? 103.0.0.1/32 100 11.0.0.1 100 Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History (s) Stale, (m) Multipath, (u) Unfeasible Origin: (?) Incomplete, (e) EGP, (i) IGP BGP Route Statistics Total Rxed Routes : 5 Feasible Routes : 4 Active Routes : 4
History
This command was first available in ExtremeXOS 10.1.
The any / netMaskLen options were added in ExtremeXOS 11.0.
This command required a specific license in ExtremeXOS 11.1.
Support for IPv6 was added in ExtremeXOS 12.6 BGP.
Support for Layer 3 VPNs was added in ExtremeXOS 15.3.
Support for BFD on neighbors was added in ExtremeXOS 21.1
Platform Availability
This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the BGP feature, see the Feature License Requirements document.