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

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

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
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   
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.

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.