Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show route damping

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show route damping (decayed | history | suppressed)
<brief | detail | extensive | terse>
<logical-system (all | logical-system-name)>

Syntax (EX Series Switch and QFX Series)

content_copy zoom_out_map
show route damping (decayed | history | suppressed)
<brief | detail | extensive | terse>

Description

Display the BGP routes for which updates might have been reduced because of route flap damping.

Options

brief | detail | extensive | terse

(Optional) Display the specified level of output. If you do not specify a level of output, the system defaults to brief.

decayed

Display route damping entries that might no longer be valid, but are not suppressed.

history

Display entries that have already been withdrawn, but have been logged.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

suppressed

Display entries that have been suppressed and are no longer being installed into the forwarding table or exported by routing protocols.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show route damping command. Output fields are listed in the approximate order in which they appear.

Table 1: show route damping Output Fields

Field Name

Field Description

Level of Output

routing-table-name

Name of the routing table—for example, inet.0.

All levels

destinations

Number of destinations for which there are routes in the routing table.

All levels

number routes

Number of routes in the routing table and total number of routes in the following states:

  • active

  • holddown (routes that are in a pending state before being declared inactive)

  • hidden (the routes are not used because of a routing policy)

All levels

destination-prefix (entry, announced)

Destination prefix. The entry value is the number of routes for this destination, and the announced value is the number of routes being announced for this destination.

detail extensive

[protocol, preference]

Protocol from which the route was learned and the preference value for the route.

  • +—A plus sign indicates the active route, which is the route installed from the routing table into the forwarding table.

  • - —A hyphen indicates the last active route.

  • *—An asterisk indicates that the route is both the active and the last active route. An asterisk before a to line indicates the best subpath to the route.

In every routing metric except for the BGP LocalPref attribute, a lesser value is preferred. In order to use common comparison routines, Junos OS stores the 1's complement of the LocalPref value in the Preference2 field. For example, if the LocalPref value for Route 1 is 100, the Preference2 value is -101. If the LocalPref value for Route 2 is 155, the Preference2 value is -156. Route 2 is preferred because it has a higher LocalPref value and a lower Preference2 value.

All levels

Next-hop reference count

Number of references made to the next hop.

detail extensive

Source

IP address of the route source.

detail extensive

Next hop

Network layer address of the directly reachable neighboring system.

detail extensive

via

Interface used to reach the next hop. If there is more than one interface available to the next hop, the interface that is actually used is followed by the word Selected.

detail extensive

Protocol next hop

Network layer address of the remote routing device that advertised the prefix. This address is used to derive a forwarding next hop.

detail extensive

Indirect next hop

Index designation used to specify the mapping between protocol next hops, tags, kernel export policy, and the forwarding next hops.

detail extensive

State

Flags for this route. For a description of possible values for this field, see the output field table for the show route detail command.

detail extensive

Local AS

AS number of the local routing device.

detail extensive

Peer AS

AS number of the peer routing device.

detail extensive

Age

How long the route has been known.

detail extensive

Metric

Metric for the route.

detail extensive

Task

Name of the protocol that has added the route.

detail extensive

Announcement bits

List of protocols that announce this route. n-Resolve inet indicates that the route is used for route resolution for next hops found in the routing table. n is an index used by Juniper Networks customer support only.

detail extensive

AS path

AS path through which the route was learned. The letters at the end of the AS path indicate the path origin, providing an indication of the state of the route at the point at which the AS path originated:

  • I—IGP.

  • E—EGP.

  • ?—Incomplete; typically, the AS path was aggregated.

When AS path numbers are included in the route, the format is as follows:

  • [ ]—Brackets enclose the local AS number associated with the AS path if more than one AS number is configured on the routing device or if AS path prepending is configured.

  • { }—Braces enclose AS sets, which are groups of AS numbers in which the order does not matter. A set commonly results from route aggregation. The numbers in each AS set are displayed in ascending order.

  • ( )—Parentheses enclose a confederation.

  • ( [ ] )—Parentheses and brackets enclose a confederation set.

Note:

In Junos OS Release 10.3 and later, the AS path field displays an unrecognized attribute and associated hexadecimal value if BGP receives attribute 128 (attribute set) and you have not configured an independent domain in any routing instance.

All levels

to

Next hop to the destination. An angle bracket (>) indicates that the route is the selected route.

brief none

via

Interface used to reach the next hop. If there is more than one interface available to the next hop, the interface that is actually used is followed by the word Selected.

brief none

Communities

Community path attribute for the route. See the output field table for the show route detail command.

detail extensive

Localpref

Local preference value included in the route.

All levels

Router ID

BGP router ID as advertised by the neighbor in the open message.

detail extensive

Merit (last update/now)

Last updated and current figure-of-merit value.

detail extensive

damping-parameters

Name that identifies the damping parameters used, which is defined in the damping statement at the [edit policy-options] hierarchy level.

detail extensive

Last update

Time of most recent change in path attributes.

detail extensive

First update

Time of first change in path attributes, which started the route damping process.

detail extensive

Flaps

Number of times the route has gone up or down or its path attributes have changed.

detail extensive

Suppressed

(suppressed keyword only) This route is currently suppressed. A suppressed route does not appear in the forwarding table and routing protocols do not export it.

All levels

Reusable in

(suppressed keyword only) Time when a suppressed route will again be available.

All levels

Preference will be

(suppressed keyword only) Preference value that will be applied to the route when it is again active.

All levels

Sample Output

show route damping decayed detail

content_copy zoom_out_map
user@host> show route damping decayed detail
inet.0: 173319 destinations, 1533668 routes (172625 active, 4 holddown, 108083 hidden)
10.0.111.0/24 (7 entries, 1 announced)
        *BGP    Preference: 170/-101
                Next-hop reference count: 151973
                Source: 172.23.2.129
                Next hop: via so-1/2/0.0
                Next hop: via so-5/1/0.0, selected
                Next hop: via so-6/0/0.0
                Protocol next hop: 172.23.2.129
                Indirect next hop: 89a1a00 264185
                State: <Active Ext>
                Local AS: 64500 Peer AS:   64490
                Age: 3:28       Metric2: 0
                Task: BGP_64490.172.23.2.129+179
                Announcement bits (6): 0-KRT 1-RT 4-KRT 5-BGP.0.0.0.0+179                 
         6-Resolve tree 2 7-Resolve tree 3
                AS path: 64499 64510 645511 645511 645511 645511 I ()
                Communities: 65551:390 65551:2000 65551:3000 65550:701
                Localpref: 100
                Router ID: 172.23.2.129
                Merit (last update/now): 1934/1790
                damping-parameters: damping-high
                Last update:       00:03:28 First update:       00:06:40
                Flaps: 2

show route damping history

content_copy zoom_out_map
user@host> show route damping history    
inet.0: 173320 destinations, 1533529 routes (172624 active, 6 holddown, 108122 hidden)
+ = Active Route, - = Last Active, * = Both

10.108.0.0/15       [BGP ] 2d 22:47:58, localpref 100
                      AS path: 64220 65541 65542 I
                    > to 192.168.60.85 via so-3/1/0.0

show route damping history detail

content_copy zoom_out_map
user@host> show route damping history detail   
inet.0: 173319 destinations, 1533435 routes (172627 active, 2 holddown, 108105 hidden)
10.108.0.0/15 (3 entries, 1 announced)
         BGP                 /-101
                Next-hop reference count: 69058
                Source: 192.168.60.85
                Next hop: 192.168.60.85 via so-3/1/0.0, selected
                State: <Hidden Ext>
                Inactive reason: Unusable path 
                Local AS: 64500 Peer AS:  64220
                Age: 2d 22:48:10
                Task: BGP_64220.192.168.60.85+179
                AS path: 64220 65541 65542 I ()
                Communities: 65541:390 65541:2000 65541:3000 65504:3561
                Localpref: 100
                Router ID: 192.168.80.25
                Merit (last update/now): 1000/932
                damping-parameters: set-normal
                Last update:       00:01:05 First update:       00:01:05
                Flaps: 1

Release Information

Command introduced before Junos OS Release 7.4.

external-footer-nav