show ipv6 bgp filtered-routes

Displays BGP4+ filtered routes that are received from a neighbor or peer group.
Syntax
show ipv6 bgp filtered-routes [ detail ] [ ipv6-addr { / mask } [ longer-prefixes ] | as-path-access-list name | prefix-list name ]
Parameters
detail
Displays detailed route information.
ipv6-addr
Specifies the IPv6 address of the destination network in dotted-decimal notation.
mask
Specifies the IPv6 mask of the destination network in CIDR notation.
longer-prefixes
Specifies all statistics for routes that match the specified route, or that have a longer prefix than the specified route.
as-path-access-list name
Specifies an AS-path ACL. The name must be between 1 and 32 ASCII characters in length.
prefix-list name
Specifies an IPv6 prefix list. The name must be between 1 and 32 ASCII characters in length.
name
Specifies the name of an AS-path ACL or prefix list.
Modes

User EXEC mode

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

Output field Description

Number of BGP4+ Routes matching display condition

The number of routes that matched the display parameters you entered. This is 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 left column of the display, to the left of each route. The status codes are described in the command’s output. The status column displays an "IF" for each filtered route.

Prefix

The network address and prefix.

Next Hop

The next-hop router for reaching the network 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 this 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 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 device saved updates containing the filtered routes.
Examples

The following example displays BGP4+ filtered routes. 

device> show ipv6 bgp filtered-routes

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:2:2::/64    2001:db8:400:400::3	 	0	 			 100	 		0		IF
             AS_PATH:                            
      
2      2001:db8:10:10::/64 	2001:db8:400:400::3	 	0 	 		 100		 	0		IF
             AS_PATH:                                 	
                                            
         AS_PATH:

The following example displays detailed information for BGP4+ filtered routes. 

device> show ipv6 bgp filtered-routes detail

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:1::/64, Status: EF, Age: 0h0m10s
	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: 100
2 	Prefix: 2001:db8:18::/64, Status: EF, Age: 0h0m10s
	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: 100
3 	Prefix: 2001:db8:1::/64, Status: EF, Age: 0h0m10s
	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: 100
4 	Prefix: 2001:db8:1::/64, Status: EF, Age: 0h0m10s
	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: 100
5 	Prefix: 2001:db8:11::1/128, Status: EF, Age: 0h0m10s
	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: 100
6 	Prefix: 2001:db8:17::/64, Status: EF, Age: 0h0m10s
	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: 100
Parent topic: Show Commands