show ipv6 bgp neighbors received-routes

Lists all route information received in route updates from BGP4+ neighbors of the device since the soft-reconfiguration feature was enabled.
Syntax
show ipv6 bgp neighbors iipv6-addr received-routes [ detail ]
Parameters
ipv6-addr
IPv6 address of a neighbor in dotted-decimal notation.
detail
Displays detailed route information.
Modes

User EXEC mode

The show ipv6 bgp neighbor received-routes command displays the following information:

Output field Description

Number of BGP4+ Routes received from a neighbor

The number of routes displayed by the command.

Status codes

A list of the characters the display uses to indicate the route’s status. The status code appears in the Status column of the display. The status codes are described in the command’s output.

Prefix

The received route’s prefix.

Next Hop

The IPv6 address of the next device that is used when forwarding a packet to the received route.

MED

The value of the route’s MED attribute. If the route does not have a metric, this field is blank.

LocPrf

The degree of preference for the advertised route relative to other routes in the local autonomous system. When the BGP4+ algorithm compares routes on the basis of local preferences, the route with the higher local preference is chosen. The preference can have a value from 0 - 4294967295.

Weight

The value that this device associates with routes from a specific neighbor. For example, if the receives routes to the same destination from two BGP4+ neighbors, the prefers the route from the neighbor with the larger weight.

Status

The advertised route’s status, which can be one or more of the following:

A - AGGREGATE. The route is an aggregate route for multiple networks.

B - BEST. BGP4+ has determined that this is the optimal route to the destination.

b - NOT-INSTALLED-BEST - BGP4+ has determined that this is the optimal route to the destination but did not install it in the IPv6 route table because the device received better routes from other sources (such as OSPFv3, RIPng, or static IPv6 routes).

D - DAMPED. This route has been dampened (by the route dampening feature), and is currently unusable.

E - EBGP. The route was learned through a in another AS.

H - HISTORY. Route dampening is configured for this route, and the route has a history of flapping and is unreachable now.

I - IBGP. The route was learned through a in the same autonomous system.

L - LOCAL. The route originated on this device.

M - MULTIPATH. BGP4+ load sharing is enabled and this route was selected as one of the best ones to the destination. The best route among the multiple paths also is marked with "B".

Note: If the "m" is shown in lowercase, the software was not able to install the route in the IPv6 route table.

S - SUPPRESSED. This route was suppressed during aggregation and thus is not advertised to neighbors.

F - FILTERED. This route was filtered out by BGP4+ route policies on the device, but the saved updates containing the filtered routes.

Examples

The following example displays a summary of the route information received in route updates from neighbor 2001:db8::10. 

device> show ipv6 bgp neighbor 2001:db8:400:400::2 received-route
       There are 4 received routes from neighbor 2001:db8:400:400::2
Searching for matching routes, use ^C to quit...
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
       E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH m:NOT-INSTALLED-MULTIPATH
       S:SUPPRESSED F:FILTERED s:STALE
       Prefix                 Next Hop             MED LocPrf Weight  Status
1      2001:db8:202:202::/64  2001:db8:400:400::2  0   400    0       BI
                                                                     
         AS_PATH: 65005 65010
2      2001:db8:400:400::/64  2001:db8:400:400::2  0   400    0       I
                                                              
         AS_PATH: 65005 65010

The following example displays output for the show ipv6 bgp neighbor received-routes when the details keyword is used. 

device> show ipv6 bgp neighbor 2001:db8:1::1 received-routes detail

There are 4 received routes from neighbor 2001:db8:1::1
Searching for matching routes, use ^C to quit...
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH S:SUPPRESSED F:FILTERED
1 Prefix: 2001:db8:1000:1::/64, Status: BI, Age: 0h17m25s
NEXT_HOP: 2001:db8:1::1, Learned from Peer: 2001:db8:1::1 (100)
LOCAL_PREF: 100, MED: 0, ORIGIN: incomplete, Weight: 0
AS_PATH:
Adj_RIB_out count: 1, Admin distance 200
2 Prefix: 2001:db8:1::/64, Status: I, Age: 0h17m25s
NEXT_HOP: 2001:db8:1::1, Learned from Peer: 2001:db8:1::1 (100)
LOCAL_PREF: 100, MED: 0, ORIGIN: incomplete, Weight: 0
AS_PATH:
3 Prefix: 2001:db8:11::1/128, Status: BI, Age: 0h17m25s
NEXT_HOP: 2001:db8:1::1, Learned from Peer: 2001:db8:1::1 (100)
LOCAL_PREF: 100, MED: 0, ORIGIN: igp, Weight: 0
AS_PATH:
Adj_RIB_out count: 1, Admin distance 200
4 Prefix: 2001:db8:17::/64, Status: BI, Age: 0h17m25s
NEXT_HOP: 2001:db8:1::1, Learned from Peer: 2001:db8:1::1 (100)
LOCAL_PREF: 100, MED: 0, ORIGIN: incomplete, Weight: 0
AS_PATH:
Adj_RIB_out count: 1, Admin distance 200
History
Parent topic: Show Commands