show ipv6 bgp routes

Displays statistics for the routes in the device’s BGP4+ route table.
Syntax
show ipv6 bgp routes [ num | ipv6-address/prefix | age num | as-path-access-list name | best | cidr-only | community-access-list name | community-reg-expression expression | detail | local | neighbor ipv6-addr | nexthop ipv6-addr | no-best | not-installed-best | prefix-list string | regular-expression name | route-map name | summary | unreachable ]
Parameters
num
Table entry at which the display starts. For example, if you want to list entries beginning with table entry 100, specify 100.
ipv6-address/prefix
Specifies an IPv6 address and prefix.
age num
Displays BGP4+ route information that is filtered by age.
as-path-access-list name
Displays BGP4+ route information that is filtered by autonomous system (AS)-path access control list (ACL).
best
Displays BGP4+ route information that the device selected as best routes.
cidr-only
Displays BGP4+ routes whose network masks do not match their class network length.
community-access-list name
Displays BGP4+ route information for an AS-path community access list.
community-reg-expression expression
Displays BGP4+ route information for an ordered community list regular expression.
detail
Displays BGP4+ detailed route information.
local
Displays BGP4+ route information about selected local routes.
neighbor ipv6-addr
Displays BGP4+ route information about selected BGP neighbors.
nexthop ipv6-addr
Displays BGP4+ route information about routes that are received from the specified next hop.
no-best
Displays BGP4+ route information that the device selected as not best routes.
not-installed-best
Displays BGP4+ route information about best routes that are not installed.
prefix-list string
Displays BGP4+ route information that is filtered by a prefix list.
regular-expression name
Displays BGP4+ route information about routes that are associated with the specified regular expression.
route-map name
Displays BGP4+ route information about routes that use the specified route map.
summary
Displays BGP4+ summary route information.
unreachable
Displays BGP4+ route information about routes whose destinations are unreachable through any of the BGP4+ paths in the BGP route table.
Modes

User EXEC mode

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

Output field Description

Number of BGP4+ Routes

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

For normal IPv6 routes, next hop is the next hop IPv6 router to reach the destination. For the 6PE routes, next hop is the IPv4-mapped IPv6 address of the peer 6PE router.

Metric

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 AS. 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.
  • 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).
  • C - CONFED_EBGP. The route was learned from a neighbor in the same confederation and AS, 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 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 AS.
  • L - LOCAL. The route originated on this.
  • 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.

AS-PATH

The AS-path information for the route.

Examples

The following example shows sample output from the show ipv6 bgp routes command.

device> show ipv6 bgp routes

Total number of BGP Routes: 4
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:10:10::/64 ::         1	 			 		100      32768  BL
         AS_PATH:
2      2001:db8:113:113::/64  ::
                                      1	 					 100      32768  BL
         AS_PATH:
3      2001::db8:400::/64  ::
                                      0        100      32768  BL
         AS_PATH:
4      2001:db8:400:400::/64  2001:db8:400:400::2
                                      0         400      0      I
         AS_PATH: 65005 65010

The following example shows sample output from the show ipv6 bgp routes command when the detail keyword is used.

device> show ipv6 bgp route detail

Total number of BGP Routes: 4
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
1 Prefix: 2001:db8:10:10::/64,  Status: BL,  Age: 8h31m39s
       NEXT_HOP: ::, Learned from Peer: Local Router
       LOCAL_PREF: 100,  MED: 0,  ORIGIN: incomplete,  Weight: 32768
       AS_PATH:
       Adj_RIB_out count: 3,  Admin distance 1
2 Prefix: 2001:db8:113:113::/64,  Status: BL,  Age: 6h58m35s
       NEXT_HOP: ::, Learned from Peer: Local Router
       LOCAL_PREF: 100,  MED: 0,  ORIGIN: igp,  Weight: 32768
       AS_PATH:
       Adj_RIB_out count: 3,  Admin distance 1
3 Prefix: 2001:db8:202:202::/64,  Status: BI,  Age: 5h42m36s
       NEXT_HOP: 2001:db8:400:400::2, Metric: 0,  Learned from Peer: 2001:db8:400:400::2 (65020)
       LOCAL_PREF: 400,  MED: 0,  ORIGIN: incomplete,  Weight: 0
       AS_PATH: 65005 65010
       Adj_RIB_out count: 1,  Admin distance 200
4 Prefix: 2001:db8:400:400::/64,  Status: BL,  Age: 5h43m14s
       NEXT_HOP: ::, Learned from Peer: Local Router
       LOCAL_PREF: 100,  MED: 0,  ORIGIN: igp,  Weight: 32768
       AS_PATH:
       Adj_RIB_out count: 3,  Admin distance 1