display bgp instance vpnv4 routing-table extcommunity

Function

The display bgp instance vpnv4 routing-table extcommunity command displays information about IPv4 routes with a specified extended community attribute in the BGP multi-instance VPNv4 address family view.

Format

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

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

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

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

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

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

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

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

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

Parameters

Parameter	Description	Value
route-distinguisher strRd	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. 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. 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.
rt	Displays information about IPv4 routes with the route target (RT) extended community attribute.	-
soo	Displays information about IPv4 routes with the source of origin (SoO) extended community attribute.	-
strExtCommunity	Specifies the excommunity value. IP<X.X.X.X>:NN<0-65535> or AS<0-65535>:NN<0-4294967295> or AS<65536-4294967295>:NN<0-65535> or AS<0-65535>.<0-65535>:NN<0-65535>.	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.
instance bgpName	Specifies 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.
match-any	Displays information about IPv6 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 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.
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.
statistics	Displays statistics about routes advertised to or received from a specified peer.	-
best	Best,add-path and best-external routes number.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bgp	read

Usage Guidelines

Usage Scenario

When a large number of IPv4 routes are available and you want to check information about only the routes with a specified extended community attribute, run the display bgp routing-table extcommunity command.

Example

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

# Display extended community information contained in VPNv4 routes.

<HUAWEI> display bgp instance a vpnv4 route-distinguisher 11:11 routing-table extcommunity
 
 BGP Local router ID is 1.1.1.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Route Distinguisher: 200:1

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

 *>i    0.0.0.0/0          2.2.2.2                        0          100        0      RT <11 : 11>
    
 VPN-Instance vpna, Router ID 1.1.1.1:

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

 *>i    0.0.0.0/0          2.2.2.2                        0          100        0      RT <11 : 11>

**Table 1** Description of the **display bgp instance vpnv4 routing-table extcommunity** command output
Item	Description
BGP Local router ID is	ID of the local BGP device. The ID is in the same format as an IPv4 address.
Route Distinguisher	Route distinguisher (RD) value of a route.
Total Number of Routes	Route statistics.
Network	Network address in the BGP routing table.
NextHop	Next-hop address for sending packets.
MED	MED of routes.
LocPrf	Local preference.
PrefVal	PrefVal of a protocol.
ExtCommunity	Extended community attribute of BGP.