show ip bgp neighbors routes-summary

Lists all route information received in UPDATE messages from BGP4 neighbors.
Syntax
show ip bgp neighbors ip-addr routes-summary
Parameters
ip-addr
IPv4 address of a neighbor in dotted-decimal notation.
Modes

User EXEC mode

The show ip bgp neighbors routes-summary command displays the following information:

Output field

Description

IP Address

The IP address of the neighbor.

Routes Received

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

  • Accepted or Installed - Number of received routes the device accepted and installed in the BGP4 route table.
  • Filtered or Kept - Number of routes that were filtered out, but were retained in memory for use by the soft reconfiguration feature.
  • Filtered - Number of received routes 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 IP Forwarding Table

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

Unreachable Routes

The number of routes received from the neighbor that are unreachable because the device does not have a valid RIP, OSPF, or static 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 - Number of withdrawn routes the device has received.
  • Replacements - 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 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.
  • maxas-limit aspath - The number of route entries discarded because the AS path exceeded the configured maximum length or exceeded the internal memory limits.
  • Invalid Nexthop - The next-hop value was not acceptable.
  • Duplicated Originator_ID - The originator ID was the same as the local device ID.
  • Cluster_ID - The cluster list contained the local cluster ID, or the local device ID 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 queued to send to this neighbor.
  • To be Withdrawn - The number of NLRIs for withdrawing routes the device has queued 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 - Number of routes the device has sent to the neighbor to withdraw.
  • Replacements - 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 route information base (Adj-RIB-Out) for routes to be advertised.
Examples

The following example displays route summary information received in UPDATE messages.

device> show ip bgp neighbor 10.168.4.211 routes-summary 

1   IP Address: 10.168.4.211 
Routes Accepted/Installed:1,  Filtered/Kept:11,  Filtered:11 
   Routes Selected as BEST Routes:1 
      BEST Routes not Installed in IP Forwarding Table:0 
   Unreachable Routes (no IGP Route for NEXTHOP):0 
   History Routes:0 

NLRIs Received in Update Message:24,  Withdraws:0 (0),  Replacements:1 
   NLRIs Discarded due to 
      Maximum Prefix Limit:0, AS Loop:0 
      Invalid Nexthop:0, Invalid Nexthop Address:0.0.0.0 
      Duplicated Originator_ID:0, Cluster_ID:0 

Routes Advertised:0,  To be Sent:0,  To be Withdrawn:0 
NLRIs Sent in Update Message:0,  Withdraws:0,  Replacements:0 

Peer Out of Memory Count for: 
   Receiving Update Messages:0, Accepting Routes(NLRI):0 
   Attributes:0, Outbound Routes(RIB-out):0 
History