display bgp vpnv4 routing-table

Function

The display bgp vpnv4 routing-table command displays BGP routes of VPNv4 address family and the private networks.

Format

display bgp vpnv4 { all | route-distinguisher route-distinguisher } routing-table [ as-path-filter { as-path-filter-number | as-path-filter-name } | cidr | different-origin-as ] (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table [ as-path-filter { as-path-filter-number | as-path-filter-name } | cidr | different-origin-as ]

display bgp vpnv4 { all | route-distinguisher route-distinguisher } routing-table regular-expression as-regular-expression (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table regular-expression as-regular-expression

display bgp vpnv4 route-distinguisher route-distinguisher routing-table [ verbose | ipv4-address [ mask | mask-length ] ] (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table [ verbose | ipv4-address [ mask [ longer-prefixes ] | mask-length [ longer-prefixes ] ] ]

display bgp vpnv4 all routing-table peer ipv4-address { advertised-routes [ network [ { mask | mask-length } [ longer-prefixes ] ] ] | received-routes [ active ] } (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table peer ipv4-address { advertised-routes [ network [ { mask | mask-length } [ longer-prefixes ] ] ] | received-routes [ active ] }

display bgp vpnv4 all routing-table peer ipv4-address received-routes network [ { mask | mask-length } [ longer-prefixes ] ] (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table peer ipv4-address received-routes network [ { mask | mask-length } [ longer-prefixes | original-attributes ] ]

display bgp vpnv4 { all | route-distinguisher route-distinguisher } routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number } (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp vpnv4 vpn-instance vpn-instance-name routing-table peer ipv4-address accepted-routes

display bgp vpnv4 { all | route-distinguisher route-distinguisher } routing-table community [ community-number | aa:nn ] &<1-29> [ internet | no-advertise | no-export | no-export-subconfed ] ^* [ whole-match ] (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table time-range start-time end-time (supported only by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H)

display bgp vpnv4 vpn-instance vpn-instance-name routing-table community [ community-number | aa:nn ] &<1-29> [ internet | no-advertise | no-export | no-export-subconfed ] ^* [ whole-match ]

display bgp vpnv4 vpn-instance vpn-instance-name routing-table time-range start-time end-time

Parameters

Parameter	Description	Value
all	Displays all BGP VPNv4 routes.	-
route-distinguisher route-distinguisher	Displays the BGP routes with the specified RD.	The RD formats are divided into the following types: 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0. Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0. 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0. IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.
vpn-instance vpn-instance-name	Displays the BGP routes of a specified VPN instance.	The value must be an existing VPN instance name.
as-path-filter	Displays the routes that match the specified filter.	-
as-path-filter-number	Specifies the number of the matching AS-Path filter.	The value is an integer that ranges from 1 to 256.
as-path-filter-name	Specifies the name of the matching AS-Path filter.	The name is a string of 1 to 51 case-sensitive characters without spaces. The string cannot be all numerals. When double quotation marks are used around the string, spaces are allowed in the string.
cidr	Displays CIDR information.	-
different-origin-as	Displays the routes that have the same destination address but different source AS numbers.	-
regular-expression as-regular-expression	Specifies the regular expression used to match the AS_Path information.	The value is a string of 1 to 80 characters.
verbose	Displays detailed information about BGP VPNv4 routes.	-
ipv4-address	Specifies the destination address.	-
mask	Specifies a mask in dotted decimal notation.	The value is in dotted decimal notation.
mask-length	Specifies the mask length.	The value is an integer that ranges from 0 to 32.
peer ipv4-address	Displays routes of a specified peer.	-
advertised-routes	Displays the routes advertised to a specified peer.	-
network	Specifies the IPv4 network address.	The value is in dotted decimal notation.
longer-prefixes	Matches any route whose prefix mask is longer than the specified length.	-
received-routes	Displays the routes received from a specified peer.	-
active	Displays the active routes received from a specified peer.	-
original-attributes	Displays the original attributes of a BGP route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run.	-
community-filter	Displays the routes that match a specified BGP community filter.	-
community-filter-name	Specifies the name of a community filter.	The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.
basic-community-filter-number	Specifies the number of a basic community filter.	The value is an integer that ranges from 1 to 99.
whole-match	Indicates exact matching.	-
advanced-community-filter-number	Specifies the number of an advanced community filter.	The value is an integer that ranges from 100 to 199.
community	Displays the routes carrying the specified BGP community attribute in the routing table.	-
community-number	Specifies the number of a community.	-
aa:nn	Specifies the community number. A maximum of 29 community numbers can be set.	Both aa and nn are integers ranging from 0 to 65535.
internet	Displays the matching routes that can be sent to any peer.	-
no-advertise	Displays the BGP routes carrying the No-Advertise community attribute.	-
no-export	Displays the BGP routes carrying the No-Export community attribute.	-
no-export-subconfed	Displays the BGP routes carrying the No-Export-Subconfed community attribute.	-
accepted-routes	Displays the routes that are received from a neighbor and accepted by a routing policy.	-
time-range start-time end-time	Displays information about BGP VPNv4 routes that have undergone status flapping during the specified period. For example, when start-time is set to 0d0h5m0s and end-time is set to 0d0h10m0s, information about all BGP VPNv4 routes whose lifetime ranges from 5 to 10 minutes is displayed.	In the values of start-time and end-time, d ranges from 0 to 10000, h ranges from 0 to 23, m ranges from 0 to 59, and s ranges from 0 to 59.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view the specific routing information.

When BGP routing table is displayed, if the length of the destination address mask of an IPv4 route is the same as that of its natural mask, the mask length is not displayed.

You can run the display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table time-range start-time end-time command to view BGP VPNv4 routes that flap within the specified time period. For example, if service traffic is abnormal or CPU usage of the device remains high within a certain time period, you can run this command to check whether route flapping occurs within the specified time period. The faulty route can be viewed in the command output, facilitating fault location.

Example

# Display all the BGP routing information of the VPN instance named vpn1.

<HUAWEI> display bgp vpnv4 vpn-instance vpn1 routing-table

 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete


 VPN-Instance vpn1, Router ID 10.1.1.9:

 Total Number of Routes: 4
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>   10.1.2.0/24        0.0.0.0         0                     0      ?
 *>   10.1.2.1/32        0.0.0.0         0                     0      ?
 *>   10.11.11.11/32     0.0.0.0         0                     0      ?
 *>i  10.22.22.22/32     10.3.3.9        0          100        0      ?

# Display all the BGP VPNv4 routing information.

<HUAWEI> display bgp vpnv4 all routing-table


 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete



 Total number of routes from all PE: 4
 Route Distinguisher: 100:1


      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>i  10.22.22.22/32     10.3.3.9        0          100        0      ?

 Route Distinguisher: 100:4


      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>   10.1.2.0/24        0.0.0.0         0                     0      ?
 *>   10.1.2.1/32        0.0.0.0         0                     0      ?
 *>   10.11.11.11/32     0.0.0.0         0                     0      ?

 VPN-Instance vpn1, Router ID 10.1.1.9:

 Total Number of Routes: 4
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>   10.1.2.0/24        0.0.0.0         0                     0      ?
 *>   10.1.2.1/32        0.0.0.0         0                     0      ?
 *>   10.11.11.11/32     0.0.0.0         0                     0      ?
 *>i  10.22.22.22/32     10.3.3.9        0          100        0      ?

# Display the VPNv4 routing information of the specified RD.

<HUAWEI> display bgp vpnv4 route-distinguisher 100:1 routing-table

 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete

 Route Distinguisher: 100:1


 Total Number of Routes: 3
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>   10.1.1.0/24        0.0.0.0         0                     0      ?
 *                       10.1.1.1        0                     0      65410?
 *>   10.1.1.2/32        0.0.0.0         0                     0      ?

 VPN-Instance vpna, Router ID 10.1.1.9:

 Total Number of Routes: 7
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn

 *>   10.1.1.0/24        0.0.0.0         0                     0      ?
                         10.1.1.1        0                     0      65410?
 *>   10.1.1.2/32        0.0.0.0         0                     0      ?
 *>   10.2.1.0/24        10.2.1.2        0                     0      ?
 * i                     10.3.3.9        0          100        0      ?
 *>   10.2.1.2/32        127.0.0.1       0                     0      ?
 *>i  10.4.1.0/24        10.4.4.9        0          100        0      ?

# Display all BGP VPNv4 routes of community 1000:100.

<HUAWEI> display bgp vpnv4 all routing-table community 1000:100

 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete


 Total number of routes from all PE: 1

 Route Distinguisher: 100:1


      Network            NextHop        MED        LocPrf    PrefVal Community

 *>i  10.22.22.22/32     10.3.3.9        0          100        0      <1000:100>

 VPN-Instance vpn1, Router ID 10.1.1.9:

 Total Number of Routes: 1
      Network            NextHop        MED        LocPrf    PrefVal Community

 *>i  10.22.22.22/32     10.3.3.9        0          100        0      <1000:100>

 VPN-Instance vpn2, Router ID 10.1.1.9:

 Total Number of Routes: 0

# Displays BGP VPNv4 routes that flap within the specified time period.

<HUAWEI> display bgp vpnv4 all routing-table time-range 0d5h0m0s 1d5h0m0s

 BGP Local router ID is 192.168.1.250
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete


 Route Distinguisher: 2:2

      Network            NextHop         Peer            Duration        Path/Ogn

 *>i  0.0.0.0            10.2.2.2        10.2.2.2        05h30m11s        i
 *>   10.2.3.4/32        0.0.0.0         0.0.0.0         05h30m42s        ?

 VPN-Instance 1, Router ID 192.168.1.250:
      Network            NextHop         Peer            Duration        Path/Ogn

 *>   10.2.3.4/32        0.0.0.0         0.0.0.0         05h30m42s        ?

 VPN-Instance 2, Router ID 192.168.1.250:
      Network            NextHop         Peer            Duration        Path/Ogn

 *>i  0.0.0.0            10.2.2.2        10.2.2.2        05h30m11s        i
 *>   10.2.3.4/32        0.0.0.0         0.0.0.0         05h30m42s        ?

**Table 1** Description of the display bgp vpnv4 routing-table command output
Item	Description
BGP Local router ID	ID of the local BGP device.
Network	Network address in the BGP routing table.
NextHop	Next Hop address through which the packet has to be sent
MED	MED of the route.
LocPrf	Local preference.
PrefVal	Preferred value.
Peer	Peer IP address
Duration	Route duration
Path/Ogn	AS_Path number and the origin attribute.
Community	Community attribute information.

# Display information about a specified VPNv4 route.

<HUAWEI> display bgp vpnv4 all routing-table 192.168.2.0
                                                                                
                                                                                
 BGP local router ID : 10.2.2.9                                                  
 Local AS number : 100                                                          
                                                                                
 Total routes of Route Distinguisher(100:10): 2                                 
 BGP routing table entry information of 192.168.2.0/24:                         
 Imported route.                                                                
 Label information (Received/Applied): NULL/1025                                
 From: 0.0.0.0 (0.0.0.0)                                                        
 Route Duration: 00h50m09s                                                      
 Direct Out-interface: Vlanif30   
 Original nexthop: 192.168.2.1                                                  
 Qos information : 0x0                                                          
 Ext-Community:RT <1 : 1>                                                       
 AS-path Nil, origin incomplete, MED 0, pref-val 0, valid, local, best, select, 
pre 255                                                                         
 Advertised to such 1 peers:                                                    
    10.3.3.3                                                                     
 BGP routing table entry information of 192.168.2.0/24:                         
 From: 192.168.2.2 (1.1.1.1)                                                    
 Route Duration: 00h48m50s                                                      
 Direct Out-interface: Vlanif30   
 Original nexthop: 192.168.2.2                                                  
 Qos information : 0x0                                                          
 Ext-Community:RT <1 : 1>                                                       
 AS-path 10, origin incomplete, MED 0, pref-val 0, valid, external, pre 255, not
 preferred for route type                                                       
 Not advertised to any peer yet                                                 
                                                                                
                                                                                
 VPN-Instance vpna, Router ID 10.2.2.9:                                          
                                                                                
 Total Number of Routes: 2                                                      
 BGP routing table entry information of 192.168.2.0/24:                         
 Imported route.                                                                
 From: 0.0.0.0 (0.0.0.0)                                                        
 Route Duration: 00h50m09s                                                      
 Direct Out-interface: Vlanif30   
 Original nexthop: 192.168.2.1                                                  
 Qos information : 0x0                                                          
 AS-path Nil, origin incomplete, MED 0, pref-val 0, valid, local, best, select, 
pre 0                                                                           
 Advertised to such 1 peers:                                                    
    192.168.2.2                                                                 
 BGP routing table entry information of 192.168.2.0/24:                         
 From: 192.168.2.2 (1.1.1.1)                                                    
 Route Duration: 00h48m51s                                                      
 Direct Out-interface: Vlanif30    
 Original nexthop: 192.168.2.2                                                  
 Qos information : 0x0                                                          
 AS-path 10, origin incomplete, MED 0, pref-val 0, external, pre 255            
 Not advertised to any peer yet

**Table 2** Description of the display bgp vpnv4 routing-table command output
Item	Description
Local AS number	Local AS number.
Total routes of Route Distinguisher	Total number of VPNv4 routes with a specified RD.
BGP routing table entry information of x.x.x.x/x	The following information is about a specified BGP routing entry.
Imported route	Routes imported to BGP using the import-route command.
Label information (Received/Applied)	Information about labels, including received and sent labels.
From	IP address of the route originator.
Route Duration	Route duration.
Direct Out-interface	Direct outbound interface.
Original nexthop	Original next hop.
Qos information	QoS information. 0x20000000: indicates that the apply behavior command has been run. 0x40000001–0x40000FFF: indicates that the apply qos-local-id qos-local-id command has been run and the qos-local-id varies from 1 to 4095. 0x80000001–0x80000007: indicates that the apply ip-precedence precedence command has been run and the precedence varies from 1 to 7. 0x0: indicates that the preceding QoS configurations are not performed.
Ext-Community	Extended community attribute of BGP.
AS-path	AS_Path attribute.
origin	Origin attribute of the BGP route. IGP: indicates that the origin attribute of a route added to the BGP routing table by using the network command is IGP. EGP: indicates that the origin attribute of a route obtained by using EGP is EGP. Incomplete: indicates that the origin attribute of a route whose source is unknown is Incomplete. For example, the origin attribute of the routes imported by using the import-route command is Incomplete.
pref-val	Preferred value.
valid	Valid BGP route.
external	The BGP route is learned from the EBGP peer.
best	The BGP route is the optimal route.
select	The BGP route is a preferred route.
pre 255	The preference of the BGP route is 255.
Advertised to such 1 peers	The BGP route has been advertised to one peer.
Not advertised to any peer yet	The BGP route has not been advertised to any peer.
VPN-Instance vpna, Router ID 10.2.2.9	The VPN instance is vpna, the Route ID is 10.2.2.9
Total Number of Routes	Number of routes in VPN instance vpna.

# Display detailed information about the specified invalid BGP VPNv4 routes.

<HUAWEI> display bgp vpnv4 all routing-table 192.168.4.4

 BGP local router ID : 10.1.1.1
 Local AS number : 100

 Total routes of Route Distinguisher(10:10): 1
 BGP routing table entry information of 192.168.4.4/32:
 Label information (Received/Applied): 1025/NULL
 From: 10.1.1.2 (10.1.1.2)
 Route Duration: 00h12m26s  
 Relay IP Nexthop: 0.0.0.0
 Relay IP Out-Interface: GigabitEthernet0/0/0
 Relay Tunnel Out-Interface: 
 Relay token: 0x0
 Original nexthop: 10.1.1.2
 Qos information : 0x0
 Ext-Community:RT <10 : 10>, RT <20 : 20>
 AS-path Nil, origin incomplete, MED 0, localpref 100, pref-val 0, valid, internal, best, select, pre 255
 Not advertised to any peer yet

 VPN-Instance vrf1, Router ID 10.1.1.1:

 Total Number of Routes: 1
 BGP routing table entry information of 192.168.4.4/32:
 Label information (Received/Applied): 1025/NULL
 From: 10.1.1.2 (10.1.1.2)
 Route Duration: 00h12m26s  
 Relay Tunnel Out-Interface: 
 Relay token: 0x0
 Original nexthop: 10.1.1.2
 Qos information : 0x0
 Ext-Community:RT <10 : 10>, RT <20 : 20>
 AS-path Nil, origin incomplete, MED 0, localpref 100, pref-val 0, internal, pre 255, invalid for tunnel unreachable
 Not advertised to any peer yet

**Table 3** Description of the display bgp vpnv4 routing-table command output
Item	Description
BGP local router ID	ID of the local BGP device. The format is the same as the IPv4 address.
Local AS number	Local AS number.
Total routes of Route Distinguisher(10:10)	Total number of BGP VPNv4 routes of the specified RD.
BGP routing table entry information of 192.168.4.4/32	The following information is about 192.168.4.4/32 routing entries.
Label information (Received/Applied)	Label information (received or sent).
From	IP address of the device that sends the route. 10.1.1.2 is the IP address of the source interface of the peer with which the BGP connection is established, and 10.1.1.2 is the Router ID of the peer.
Route Duration	Duration of routes.
Relay IP Nexthop	IP iterated next hop.
Relay IP Out-Interface	IP iterated outbound interface.
Relay Tunnel Out-Interface	Tunnel iterated outbound interface.
Relay token	Iterated token value used for MPLS forwarding that is a part of tunnel ID and is assigned by the system.
Original nexthop	Original next hop.
Qos information	QoS information. 0x20000000: indicates that the apply behavior command has been run. 0x40000001–0x40000FFF: indicates that the apply qos-local-id qos-local-id command has been run and the qos-local-id varies from 1 to 4095. 0x80000001–0x80000007: indicates that the apply ip-precedence precedence command has been run and the precedence varies from 1 to 7. 0x0: indicates that the preceding QoS configurations are not performed.
Ext-Community	Extended community attribute.
AS-path Nil	AS_Path attribute, with Nil indicating that the attribute value is null.
origin incomplete	Well-known mandatory property. This property defines the origin of a path and records how a route turns to a BGP route. The property has the following three values: IGP: The priority of this value is the highest. The origin property of the routes that are added to the BGP routing table by using the network (BGP) command is IGP. EGP: The priority of this value is second to that of IGP. The origin property of the routes imported from EGP is EGP. Incomplete: The priority of this value is the lowest. The value indicates the origin of a route is unknown. The origin property of the routes that are added to the BGP routing table by using the import-route (BGP) command is Incomplete.
MED	Multi-Exit discriminator of route.
localpref	Local priority.
pref-val	Value preferred by the protocol.
valid	The BGP route is a valid route.
internal	The BGP route is an internal route.
best	The BGP route is an optimal route.
select	The BGP route is a preferred route.
pre 255	The priority of the BGP route is 255.
invalid for tunnel unreachable	Reason why a route is invalid: invalid for route-policy not pass: The route does not match the route-policy. invalid for supernet route: The route is a supernet route. invalid for IP unreachable: The route fails to be iterated to another route. invalid for supernet route not advertise: No supernet routes are advertised. invalid for supernet label route not advertise: No supernet labeled routes are advertised. invalid for next-hop unreachable: The next-hop IP address is unreachable. invalid for tunnel unreachable: The route fails to be iterated to a tunnel.
Not advertised to any peer yet	The BGP route has not been advertised to any peer yet.
VPN-Instance vrf1, Router ID 10.1.1.1	The local VPN instance is vrf1, and its router ID is 10.1.1.1.
Total Number of Routes	Total number of BGP VPNv4 routes that match 192.168.4.4/32 in VPN instance vrf1.