display bgp vpnv4 routing-table

Function

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes.

The display bgp labeled routing-table command displays information about BGP routes in a BGP labeled address family.

The display bgp routing-table extcommunity command displays information about routes with a specified extended community attribute.

Format

display bgp vpnv4 route-distinguisher route-distinguisher routing-table

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table ipv4-address [ mask-length | mask ]

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics

display bgp vpnv4 route-distinguisher route-distinguisher routing-table cidr

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics cidr

display bgp vpnv4 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp instance instance-name vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

display bgp vpnv4 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics regular-expression as-regular-expression

display bgp vpnv4 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter basic-community-filter-number whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics label

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics best

display bgp vpnv4 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp vpnv4 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp vpnv4 route-distinguisher route-distinguisher routing-table extcommunity-filter { basic-extcomm-filter-number | advanced-extcomm-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics extcommunity-filter { basic-extcomm-filter-number | advanced-extcomm-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table extcommunity-filter extcomm-filter-name

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics extcommunity-filter extcomm-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table cidr

display bgp instance instance-name vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics cidr

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics regular-expression as-regular-expression

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter basic-community-filter-number whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

display bgp instance instance-name vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics label

display bgp vpnv4 vpnv4-vpn-instance vpnv4-vpn-instance-name routing-table ipv4-address [ mask-length | mask ]

display bgp labeled vpn-instance vpn-instance-name routing-table ipv4-address { mask-length | mask } longer-prefixes

display bgp labeled vpn-instance vpn-instance-name routing-table statistics best

display bgp labeled vpn-instance vpn-instance-name routing-table ipv4-address [ mask-length | mask ]

display bgp labeled vpn-instance vpn-instance-name routing-table statistics active

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics active

display bgp instance instance-name vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics active

Parameters

Parameter	Description	Value
route-distinguisher route-distinguisher	Displays the BGP routes with the specified RD.	The value is a string of 3 to 21 case-sensitive characters, spaces not supported.
all	Displays all BGP VPNv4 routes.	-
vpn-instance vpn-instance-name	Displays the BGP routes of a specified VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
ipv4-address	Specifies the address of the IPv4 peer to be displayed.	The value is in dotted decimal notation.
mask-length	Specifies the mask length.	The value is an integer ranging from 0 to 32.
mask	Specifies a mask.	The value is in dotted decimal notation.
statistics	Displays statistics about routes advertised to or received from a specified peer.	-
cidr	Displays CIDR information.	-
different-origin-as	Displays the routes with the same destination address but different source AS numbers.	-
instance instance-name	Specifies the name of a BGP multi-instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
as-path-filter as-path-filter-num	Displays the routes that match the AS_Path filter of a specified number.	The value is an integer ranging from 1 to 256.
as-path-filter-name	Specifies the name of an AS_Path filter.	The value is a string of 1 to 51 case-sensitive characters, spaces not supported.
community-filter basic-community-filter-number	Specifies the number of a basic community filter.	The value is an integer ranging from 1 to 99.
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.
community-filter advanced-community-filter-number	Specifies the number of an advanced community filter.	The value is an integer ranging from 100 to 199.
community community-number	Specifies a community number.	The value is an integer ranging from 0 to 4294967295.
community aa:nn	Specifies a community name.	The value is a string of 1 to 11 case-sensitive characters, spaces not supported.
internet	Displays the routes that can be sent to all peers.	-
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.	-
whole-match	Indicates exact matching.	-
regular-expression as-regular-expression	Displays the routes that match the regular expression.	The value is a string of 1 to 80 characters.
longer-prefixes	Matches any route whose prefix mask is longer than the specified length.	-
best	Specifies the number of Best, Add-Path, and Best-External routes.	-
rt	Displays information about routes with a specified RT.	-
soo	Displays information about routes with a specified source of origin (SoO).	-
strExtCommunity	Specifies the excommunity value.	The attribute is a BGP extended community attribute and can be expressed in any of the following formats: 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number ranges from 0 to 65535, and the user-defined number ranges from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. Specifically, the value of the SoO attribute cannot be 0:0. IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number ranges from 0 to 65535. Integral 4-byte AS number:2-byte user-defined number, for example, 0:3 or 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. Specifically, the value of the SoO attribute 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 ranging from 0 to 65535. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. Specifically, the value of the SoO attribute cannot be 0.0:0.
match-any	Displays information about routes with any of the specified extended community attributes.	-
extcommunity-filter extcomm-filter-name	Specifies the name of an extcommunity filter.	The value is a string of 1 to 51 characters.
extcommunity-filter basic-extcomm-filter-number	Specifies the number of an basic extcommunity filter.	The value is an integer ranging from 1 to 199.
extcommunity-filter advanced-extcomm-filter-number	Specifies the number of an advanced extcommunity filter.	The value is an integer ranging from 200 to 399.
vpnv4-vpn-instance vpnv4-vpn-instance-name	Specifies the name of a VPN instance whose VPN IP routes and locally generated VPNv4 routes are to be displayed.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
active	Displays the active routes learned from a specified peer.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bgp	read

Usage Guidelines

Usage Scenario

You can specify different parameters in this command to view information about routes as required.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about active VPNv4 routes.

<HUAWEI> display bgp vpnv4 all routing-table statistics active
 Total number of routes from all PE: 2
 VPN-Instance vrf1, router ID 1.1.1.1:
 Total Number of Prefix Advertised to RM : 2
 Total Number of Active Route : 2

# Display statistics about the VPNv4 routes with the specified RD.

<HUAWEI> display bgp vpnv4 route-distinguisher 100:1 routing-table statistics
 Route Distinguisher: 100:1
 Total Number of Routes: 1
 Total number of routes of IPv4-family for vpn-instance vrf1: 3

# Display statistics about the VPNv4 routes with a specified RD in a BGP multi-instance.

<HUAWEI> display bgp instance aaa vpnv4 route-distinguisher 1:1 routing-table statistics best
 Route Distinguisher: 1:1
Total Number of Best Routes from All PE: 1
Total Number of Add-path Routes from All PE: 0
Total Number of Best-external Routes from All PE: 1
 VPN-Instance vrf1, Router ID 11.11.11.11:
Total Number of Best Routes: 1

# Display statistics about dampened VPNv4 routes.

<HUAWEI> display bgp vpnv4 all routing-table statistics dampened
 Total Number of Routes: 2

# Display information about optimal VPNv4 routes.

<HUAWEI> display bgp vpnv4 all routing-table statistics best
 Total Number of Best Routes from All PE: 1
 Total Number of Add-path Routes from All PE: 0 
 Total Number of Best-external Routes from All PE: 1
 VPN-Instance vrf1, Router ID 11.11.11.11:
Total Number of Best Routes: 1
 VPN-Instance vrf2, Router ID 11.11.11.11:
Total Number of Best Routes: 1

# Display detailed information about VPNv4 routes.

<HUAWEI> display bgp vpnv4 route-distinguisher 278:834 routing-table 10.2.1.1
 
 BGP local router ID : 10.1.1.1
 Local AS number : 100
 BGP routing table entry information of 10.2.1.1/32:
 Label information (Received/Applied): 13025/297795
 From: 172.16.1.1 (10.1.1.1)  
 Route Duration: 0d00h47m22s
 Relay IP Nexthop: 10.18.7.1
 Relay IP Out-Interface: GigabitEthernet0/1/1
 Relay Tunnel Out-Interface: GigabitEthernet0/1/1
 Original nexthop: 172.16.1.1
 Qos information : 0x0
 Ext-Community: RT <278 : 834>
 Prefix-sid: 2001:db8:3::1
 AS-path Nil, origin incomplete, MED 0, localpref 100, pref-val 0, valid, internal, best, select, pre 255, IGP cost 10400
 Originator: 10.3.1.1
 Cluster list: 0.0.0.100
 Advertised to such 1 peers:
    10.5.1.1

**Table 1** Description of the **display bgp vpnv4 routing-table** command output
Item	Description
Total number of routes from all PE	Total number of VPNv4 routes.
Total number of routes of IPv4-family for vpn-instance vrf1	Number of routes in the BGP-VPN instance IPv4 address family.
Total Number of Routes	Total number of VPNv4 routes with a specified RD.
Total Number of Best Routes from All PE	Number of optimal routes that are selected among the routes received from all PEs.
Total Number of Best-external Routes from All PE	Number of Best-External routes from all PEs.
Total Number of Add-path Routes from All PE	Number of Add-Path routes from all PEs.
Total Number of Best Routes	Number of optimal routes.
Total Number of Prefix Advertised to RM	Number of routes delivered to the RM module.
Total Number of Active Route	Number of active routes.
Prefix	Prefix of a BGP route.
Route Distinguisher	Route distinguisher (RD) value of a route.
MED	MED value of a route. This attribute is supported by the routes received from EBGP peers, but not supported by the routes received from IBGP peers.
Prefix-sid	Prefix SID carried in a route.
Originator	Router ID of the route initiator.
Origin	Route origin.
From	IP address of the route advertiser (Router-ID of the route advertiser).