show bgp routes

For IPv4 and IPv6 address families:

show bgp routes {address-family [ipv4-unicast | ipv4-multicast |ipv6-unicast | ipv6-multicast]} {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 routes address-family vpnv4 {detail} [all | as-path path-expression | community [no-advertise | no-export | no-export-subconfed | number community-number | autonomous-system-id : bgp-community] | rd rd network [any / netMaskLen | networkPrefixFilter] {exact}]

Description

Displays the BGP route information base (RIB).

Syntax Description

ipv4-unicast

Specifies the IPv4 unicast address family.

ipv4-multicast

Specifies an IPv4 multicast address family.

ipv6-unicast

Specifies the IPv6 unicast address family.

ipv6-multicast

Specifies an IPv6 multicast address family.

vpnv4

Specifies the VPNv4 address family for Layer 3 VPN support.

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

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.

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.

You can only execute the show for vpnv4 address family in a VR context. If you execute this command in a VRF context, the “Cannot execute command in VRF context” error is displayed.

This command applies to the current VR or VRF context.

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.

Example

The following command displays detailed information about all BGP routes:

* Switch.5 #  show bgp routes all       
Received Routes:       
Destination         LPref Weight MED     Peer            Next-Hop        AS-Path   
------------------------------------------------------------------------------------   
*>? 1.1.1.1/32      100   0              11.0.0.1        11.0.0.1        100   
* ? 11.0.0.0/24     100   0              11.0.0.1        11.0.0.1        100   
*>? 101.0.0.0/24    100   0              11.0.0.1        11.0.0.1        100   
u ? 103.0.0.0/24    100   0              11.0.0.1        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 : 4     
  Feasible Routes   : 3     
  Active Routes     : 2     
  Rejected Routes   : 0     
  Unfeasible Routes : 1   
Route Statistics on Session Type     
  Routes from Int Peer: 4         
     Routes from Ext Peer: 0  

The following example displays a detailed show output:

Route:  11.0.0.0/24,  Peer 11.0.0.1, Unfeasible   
Origin Incomplete, Next-Hop 11.0.0.1, LPref 100, MED 0   
Weight 0, RR Orig ID 0.0.0.0   
AS-Path: 100   
DampInfo: Penalty 0 Flapped 0 times in 00:10:47       
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 : 1     
  Feasible Routes   : 0     
  Active Routes     : 0     
  Rejected Routes   : 5     
  Unfeasible Routes : 1   
Route Statistics on Session Type     
  Routes from Int Peer   : 5    
  Routes from Ext Peer   : 0  

The following command displays BGP information for the IPv6 address family:

Switch.21 #   show bgp routes address-family ipv6-unicast all       
Received Routes:       
    Destination                           LPref Weight MED               
    Peer                                  Next-Hop                 AS-Path   
------------------------------------------------------------------------------------   
*>? 2001::/64                             100           0          120                 
    3000::1                               3001::1       100,       200       

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 : 1     
    Feasible Routes   : 1     
    Active Routes     : 1     
    Rejected Routes   : 0     
    Unfeasible Routes : 0   

Route Statistics on Session Type     
    Routes from Int Peer: 1            
        Routes from Ext Peer: 0    
 

The following example displays detailed show output for the IPv6 address family:

switch.21 # show bgp routes address-family ipv6-unicast all       
Route: 2001::/64, Peer 3000::1,    
Unfeasible, Origin Incomplete,    
Next-Hop 3001::1,
LPref 100, MED 0,   
Weight 0, RR Orig ID 0.0.0.0   
AS-Path: 100   
DampInfo: Penalty 0 Flapped 0 times in 00:10:47       

Route: 2002::/64, Peer 3000::1,    
Active, Origin Incomplete,    
Next-Hop 3001::1,
LPref 100, MED 0,   
Weight 0, RR Orig ID 0.0.0.0   
AS-Path: 100   
DampInfo: Penalty 0 Flapped 0 times in 00:10:47           

BGP Route Statistics     
    Total Rxed Routes : 2     
    Feasible Routes   : 1     
    Active Routes     : 1     
    Rejected Routes   : 0     
    Unfeasible Routes : 1   
Route Statistics on Session Type     
    Routes from Int Peer: 2         
          Routes from Ext Peer: 0  

The following examples display detailed show output for the IPv4 address family:

switch.21  # show bgp routes address-family vpnv4 all       
Received Routes:       
Destination                                          LPref Weight  MED               
Peer                      Next-Hop                   AS-Path   
------------------------------------------------------------------------------------   
*>? 100:1:10.0.0.0/8                                 100    0      120                 
    11.0.0.2                                         11.0.0.2         
    100, 200       
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 : 1     
    Feasible Routes   : 1     
    Active Routes     : 1     
    Rejected Routes   : 0     
    Unfeasible Routes : 0   
Route Statistics on Session Type     
    Routes from Int Peer: 1            
        Routes from Ext Peer: 0   
-------------------------------------------------------------------------------------------------------------------------------------    

switch.21 # show bgp routes address-family ipv6-unicast all       
Route: 100:1:10.0.0.0/8, Peer 11.0.0.2,    
Unfeasible, Origin Incomplete,    
Next-Hop 11.0.0.2,    
LPref 100, MED 0,   
Weight 0, RR Orig ID 0.0.0.0   
AS-Path:  100   
DampInfo: Penalty 0 Flapped 0 times in 00:10:47       

BGP Route Statistics     
    Total Rxed Routes : 1     
    Feasible Routes   : 0     
    Active Routes     : 0     
    Rejected Routes   : 0     
    Unfeasible Routes : 1   
Route Statistics on Session Type     
    Routes from Int Peer: 1            
        Routes from Ext Peer: 0     

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.