display bgp routing-table(Attribute)

Function

The display bgp routing-table command displays information about BGP public network routes based on specified multiple attribute values.

Format

display bgp routing-table [ community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ] | extcommunity [ { rt | soo } strExtCommunity ] &<1-33> [ match-any ] | large-community [ largeCommuStr ] &<1-33> [ whole-match ] ] ^* [ regular-expression strRegular ]

Parameters

Parameter	Description	Value
community communityNum	Specify community number.	The value is an integer ranging from 0 to 4294967295.
community strCommunityNum	Specify aa<0-65535>:nn <0-65535>.	The value is a string of 1 to 11 case-sensitive characters, spaces not supported.
internet	Displays the BGP routes carrying the internet community attribute.	-
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 match with specified communities.	-
whole-match	Indicates exact match with specified large communities.	-
extcommunity	Displays information about BGP routes with a specified extended community attribute.	-
rt	Displays information about BGP routes with the route target (RT) extended community attribute.	-
soo	Displays information about BGP 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 1 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. Specifically, the value of the SoO attribute cannot be 0.0:0.
match-any	Displays information about BGP routes with any of the specified extended community attributes.	-
large-community largeCommuStr	Specifies a value of the Large-Community attribute.	The value is a string of 5 to 32 case-sensitive characters, spaces not supported.
regular-expression strRegular	Specifies the regular expression used to match the AS_Path information.	The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bgp	read

Usage Guidelines

Usage Scenario

To query information about BGP public network routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

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

# Display all BGP public network routes information.

<HUAWEI> display bgp routing-table
 
 BGP Local router ID is 10.1.123.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


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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i

# Display BGP public network routes with the community attribute.

<HUAWEI> display bgp routing-table community
 
 BGP Local router ID is 10.1.123.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


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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1>, <2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>

# Display BGP public network routes with extended community attribute 2:2.

<HUAWEI> display bgp routing-table extcommunity rt 2:2
 
 BGP Local router ID is 10.1.123.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


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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      RT <2 : 2>, SoO <200 : 200>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      RT <2 : 2>, SoO <300 : 300>

# Display BGP public network routes with the large community attribute.

<HUAWEI> display bgp routing-table large-community
 
 BGP Local router ID is 10.1.123.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


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>

# Display BGP public network routes that match the AS_Path regular expression ^20.

<HUAWEI> display bgp routing-table regular-expression ^20
 
 BGP Local router ID is 10.1.123.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


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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i

# Display BGP public network routes whose community attribute is 3:3 and match the AS_Path regular expression ^20.

<HUAWEI> display bgp routing-table community 3:3 regular-expression ^20
 
 BGP Local router ID is 10.1.123.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


 Total Number of Routes: 1
        Network            NextHop                       MED        LocPrf    PrefVal

 *>     10.1.2.0/24        10.1.123.2                     0                     0

**Table 1** Description of the **display bgp routing-table(Attribute)** command output
Item	Description
BGP Local router ID is	Router ID of the local BGP device.
Total Number of Routes	Total number of routes.
Network	Network address in the BGP public network routing table.
NextHop	Next hop IP address used to forward packets.
MED	MED of a BGP route.
LocPrf	Local_Pref of a BGP route.
PrefVal	PrefVal of a BGP route.
Path/Ogn	AS_Path number and the origin attribute.
Community	Community attribute of a route.
ExtCommunity	Extended community attribute of a route.
LargeCommunity	LargeCommunity attribute of a route.