show ipv6 bgp neighbors routes

Lists a variety of route information received in UPDATE messages from BGP4+ neighbors.
Syntax
show ipv6 bgp neighbors ipv6-addr routes
show ipv6 bgp neighbors ipv6-addr routes { best | not-installed-best | unreachable }
show ipv6 bgp neighbors ipv6-addr routes detail { best | not-installed-best | unreachable }
Parameters
ipv6-addr
IPv6 address of a neighbor in dotted-decimal notation.
best
Displays routes received from the neighbor that are the best BGP4+ routes to their destination.
not-installed-best
Displays routes received from the neighbor that are the best BGP4+ routes to their destination but were not installed in the route table because the device received better routes from other sources.
unreachable
Displays routes that are unreachable because the device does not have a valid RIP, OSPF, or static route to the next hop.
Modes

User EXEC mode

The show ipv6 bgp neighbors routes command displays the following information:

Output field Description

Number of accepted routes from a specified 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 route’s prefix.

Next Hop

The next-hop router for reaching the route from the device.

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 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 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.
  • C - CONFED_EBGP. The route was learned from a neighbor in the same confederation and autonomous system, but in a different sub-AS within the confederation.
  • 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 autonomous system.
  • 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.

AS-PATH

The AS-path information for the route.

Examples

The following example shows sample output for the show ip bgp neighbors routes command when the best keyword is used. 

device> show ipv6 bgp neighbor 2001:db8::106 routes best

       There are 2 accepted routes from neighbor 2001:db8::106
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
       Prefix             Next Hop           MED 	LocPrf     Weight Status
1      2001:db8::/16 		 			 2001:db8::106 			1 		 100        0      BE
         AS_PATH: 65001
2      2001:db8::/32 							2001:db8::106 			1 		 100        0      BE
         AS_PATH: 65001

The following example shows detailed sample output for the show ip bgp neighbors routes command when the best keyword is used. 

device> show ipv6 bgp neighbor 2001:db8::106 routes detail best

       There are 2 accepted routes from neighbor 2001:db8::106
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::/16,  Status: BE,  Age: 18h48m56s
         NEXT_HOP: 2001:db8::106,  Learned from Peer: 2001:db8::106 (65001)
          LOCAL_PREF: 100,  MED: 1,  ORIGIN: incomplete,  Weight: 0
           AS_PATH: 65001
2       Prefix: 2001:db8::/32,  Status: BE,  Age: 18h48m56s
         NEXT_HOP: 2001:db8::106,  Learned from Peer: 2001:db8::106 (65001)
          LOCAL_PREF: 100,  MED: 1,  ORIGIN: incomplete,  Weight: 0
           AS_PATH: 65001
History
Parent topic: Show Commands