show ipv6 bgp neighbors routes-summary

Lists all route information received in UPDATE messages from BGP4+ neighbors.

Syntax

show ipv6 bgp neighbors ipv6-addr routes-summary [ vrf vrf-name ]

Parameters

ipv6-addr
IPv6 address of a specified route in dotted-decimal notation.
vrf vrf-name
Specifies a VRF instance.

Modes

Privileged EXEC mode

Output

The show ipv6 bgp neighbors routes-summary command displays the following information.

Output field

Description

IP Address

The IPv6 address of the neighbor

Routes Received

How many routes the device has received from the neighbor during the current BGP4+ session:

  • Accepted or Installed - Indicates how many of the received routes the device accepted and installed in the BGP4+ route table.
  • Filtered or Kept - Indicates how many routes were filtered out, but were nonetheless retained in memory for use by the soft reconfiguration feature.
  • Filtered - Indicates how many of the received routes were filtered out.

Routes Selected as BEST Routes

The number of routes that the device selected as the best routes to their destinations.

BEST Routes not Installed in IPv6 Forwarding Table

The number of routes received from the neighbor that are the best BGP4+ routes to their destinations, but were nonetheless not installed in the IPv6 route table because the device received better routes from other sources (such as OSPFv3, or static IPv6 routes).

Unreachable Routes

The number of routes received from the neighbor that are unreachable because the device does not have a valid OSPFv3, or static IPv6 route to the next hop.

History Routes

The number of routes that are down but are being retained for route flap dampening purposes.

NLRIs Received in Update Message

The number of routes received in Network Layer Reachability (NLRI) format in UPDATE messages:

  • Withdraws - The number of withdrawn routes the device has received.
  • Replacements - The number of replacement routes the device has received.

NLRIs Discarded due to

Indicates the number of times the device discarded an NLRI for the neighbor due to the following reasons:

  • Maximum Prefix Limit - The device‘s configured maximum prefix amount had been reached.
  • AS Loop - An AS loop occurred. An AS loop occurs when the BGP4+ AS-path attribute contains the local AS number.
  • Invalid Nexthop Address - The next hop value was not acceptable.
  • Duplicated Originator_ID - The originator ID was the same as the local router ID.
  • Cluster_ID - The cluster list contained the local cluster ID, or contained the local router ID (see above) if the cluster ID is not configured.

Routes Advertised

The number of routes the device has advertised to this neighbor:

  • To be Sent - The number of routes the device has queued to send to this neighbor.
  • To be Withdrawn - The number of NLRIs for withdrawing routes the device has queued up to send to this neighbor in UPDATE messages.

NLRIs Sent in Update Message

The number of NLRIs for new routes the device has sent to this neighbor in UPDATE messages:

  • Withdraws - The number of routes the device has sent to the neighbor to withdraw.
  • Replacements - The number of routes the device has sent to the neighbor to replace routes the neighbor already has.

Peer Out of Memory Count for

Statistics for the times the device has run out of BGP4+ memory for the neighbor during the current BGP4+ session:

  • Receiving Update Messages - The number of times UPDATE messages were discarded because there was no memory for attribute entries.
  • Accepting Routes(NLRI) - The number of NLRIs discarded because there was no memory for NLRI entries. This count is not included in the Receiving Update Messages count.
  • Attributes - The number of times there was no memory for BGP4+ attribute entries.
  • Outbound Routes (RIB-out) - The number of times there was no memory to place a "best" route into the neighbor's route information base (Adj-RIB-Out) for routes to be advertised.
  • Outbound Routes Holder - For debugging purposes only.

Examples

This example shows sample output from the show ipv6 bgp neighbors routes-summary command.

device# show ipv6 bgp neighbors routes-summary