show bgp routes

For IPv4 and IPv6 address families:

show bgp routes {address-family [ipv4-unicast | ipv4-multicast |ipv6-unicast | ipv6-multicast | ipv4-vxlan | {l2vpn-evpn [inclusive-multicast | mac-ip | auto-discovery | esi | ip-prefix]}]} {detail} [ipv4-vxlan | all | as-path path-expression | community [no-advertise | no-export | no-export-subconfed | number community_number | autonomous-system-idbgp-community] | network [any/netMaskLen | networkPrefixFilter] {exact}] {vr vr_name}

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-idbgp-community] |rd rd network [any/netMaskLen |networkPrefixFilter] {exact}] {vr vr_name}

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.

ipv4-vxlan Specifies an IPv4 VXLAN address family.
l2vpn-evpn Specifies an L2VPN EVPN address family.
inclusive-multicast Displays EVPN inclusive-multicast (type 3) routes
mac-ip Displays EVPN MAC/IP (type 2) routes.
auto-discovery Displays EVPN auto-discovery (type 1) routes.
esi Displays EVPN Ethernet segment (type 4) routes.
ip-prefix Displays EVPN ip-prefix (type 5) routes.

vpnv4

Specifies the VPNv4 address family for Layer 3 VPN support.

all

Specifies all routes.

path-expression

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

vr Specifies viewing routes associated with a specified virtual router.
vr_name Specifes the VR name. If not specified, the VR of current command context is used.

Default

If no address family is specified, IPv4 unicast is the default.

If not specified, the VR of current command context is used.

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     

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

# show bgp routes ipv4-vxlan all 

Routes: 
     LTEP                VNI       Peer         Next-Hop      LPref Weight MED        AS-Path 
--------------------------------------------------------------------------- 
* i  1.0.0.15/32         777       192.168.68.1 192.168.68.1    100   1      0          15  
Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History 
       (s) Stale, (m) Multipath, (u) Unfeasible 

The following example displays L2VPN EVPN MAC/IP routes:

 # show bgp routes l2vpn-evpn mac-ip all
 
     EVPN MAC/IP Routes:
 
     MAC                  IP                      VNI         Peer              Next-Hop                AS-Path
     ------------------------------------------------------------------------------------
*>?  RD: 65535:4294967295      ESI: 00:01:02:03:04:05:06:07:08:09  
     00:04:96:98:87:62    192.168.110.109         16777215    192.168.120.119   192.168.120.119    50 40 30 20 10
 
*>i  RD: 192.168.101.100:65535 ESI: 00:00:00:00:00:00:00:00:00:00                       
     00:04:96:98:87:63    0.0.0.0                 16777215    192.168.0.3       192.168.0.3        50
 
*>i  RD: 4294967295:65535      ESI: 00:01:02:03:04:05:06:07:08:09  
     00:04:96:98:87:64    192.168.110.110         777         192.168.120.119    192.168.120.119   50 40 30 20 10
 
 
Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History
       (s) Stale, (m) Multipath, (u) Unfeasible
 
Origin: (?) Incomplete, (e) EGP, (i) IGP

The following example displays L2VPN EVPN inclusive multicast routes:

# show bgp routes l2vpn-evpn inclusive-multicast all

     EVPN Inclusive Multicast Routes:

     Originating IP                  Tunnel ID               VNI         Peer              Next-Hop                AS-Path
     -------------------------------------------------------------------------------------------
*>?  RD: 65535:4294967295   Ethernet Tag: 0   Tunnel Type: 6 (Ingress Replication)
     192.168.110.109                 192.168.110.109         16777215    192.168.120.119   192.168.120.119    50 40 30 20 10
 
 
Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History
       (s) Stale, (m) Multipath, (u) Unfeasible

Origin: (?) Incomplete, (e) EGP, (i) IGP
The following example shows all Type 5 routes:
# show bgp routes l2vpn-evpn ip-prefix all
 
Routes:
EVPN IP-Prefix Routes:
     IP Prefix/Length                           VNI          Peer                                  Next-Hop           AS-Path   
--------------------------------------------------------------------------------------------------------------------------------
  ?  RD: 1.0.0.25:48        ESI: 00:00:00:00:00:00:00:00:00:00  
     125.126.127.128/32                         777          192.168.99.2                          1.0.0.25           38 25 
  ?  RD: 1.0.0.25:49        ESI: 00:00:00:00:00:00:00:00:00:00  
     1.0.0.0/8                                  778          192.168.99.2                          1.0.0.25           38 25 
 
Flags: (*) Preferred BGP route, (>) Active, (d) Suppressed, (h) History
       (s) Stale, (m) Multipath, (u) Unfeasible
 
Origin: (?) Incomplete, (e) EGP, (i) IGP
 
BGP Route Statistics EVPN route type 5
  Total Rxed Routes : 2
  Feasible Routes   : 2
  Active Routes     : 0
  Rejected Routes   : 0
  Unfeasible Routes : 0
Route Statistics on Session Type 
  Routes from Int Peer: 0 
  Routes from Ext Peer: 2

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 IPv4 VXLAN was added in ExtremeXOS 22.3.

Support for L2VPN EVPN was added in ExtremeXOS 30.2.

Support for user-specified VRs was added in ExtremeXOS 30.3.

Support for EVPN auto-discovery and EVPN Ethernet Segment routes was added in ExtremeXOS 30.4.

Support for Type 5 routes (ip-prefix) was added in ExtremeXOS 30.6.

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 ExtremeXOS and Switch Engine 31.7 Feature License Requirements document.