display ip routing-table time-range

Function

The display ip routing-table time-range command displays information about routes generated in a specified time range in an IP routing table.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] time-range min-age max-age [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Displays information about routes generated in a specified time range in the IP routing table of the specified VPN instance. If you do not specify this parameter, the display ip routing-table time-range command displays information about routes generated in a specified time range in the public IP routing table.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
min-age	Specifies the end time of the period when routes are generated.	The format is xxdxxhxxmxxs. The d indicates days. The value is an integer ranging from 0 to 10000. The h indicates hours. The value is an integer ranging from 0 to 23. The m indicates minutes. The value is an integer ranging from 0 to 59. The s indicates seconds. The value is an integer ranging from 0 to 59. For example, you can enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds. NOTE: If the value of the d is 10000, the values of the h, m, and s can be only 0.
max-age	Specifies the start time of the period when routes are generated.	The format is xxdxxhxxmxxs. The d indicates days. The value is an integer ranging from 0 to 10000. The h indicates hours. The value is an integer ranging from 0 to 23. The m indicates minutes. The value is an integer ranging from 0 to 59. The s indicates seconds. The value is an integer ranging from 0 to 59. For example, you can enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds. NOTE: If the value of the d is 10000, the values of the h, m, and s can be only 0.
verbose	Displays detailed information about active and inactive routes. If you do not specify this parameter, the display ip routing-table time-range command displays only summary information about active routes.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If route flapping occurs on a network, you can run the display ip routing-table time-range command and specify a small time range for the command. By doing so, you can find the flapping route in a timely manner and accelerate fault locating.

Precautions

You must make sure that max-age is greater that min-age. Otherwise, the display ip routing-table time-range command does not display any information.

If the specified max-age is greater than min-age and no route was generated within this time range, the display ip routing-table time-range command displays only the table heading.

Example

# Display information about public network routes generated in the last 20 minutes.

<sysname> display ip routing-table time-range 0 20m

Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 6        Routes : 6

Destination/Mask    Proto   Pre  Cost      Flags NextHop         Interface

        3.3.3.3/32  Direct  0    0           D   127.0.0.1       LoopBack1
        4.4.4.0/24  Static  60   0           D   0.0.0.0         NULL0

**Table 1** Description of the display ip routing-table time-range command output
Item	Description
Route Flags	Route flags: R: The route is an iterated route. D: The route is sent to the Forwarding Information Base (FIB) table.
Routing Tables: Public	Indicates the routing table is a public routing table
Destinations	Number of destination networks and hosts
Routes	Number of routes
Destination/Mask	Address and mask length of the destination network and host
Proto	Protocol used to learn routes
Pre	Route preference
Cost	Route cost
Flags	Route flags in the heading of the routing table
NextHop	Next hop
Interface	Outbound interface in a route with a reachable next hop

# Display detailed information about public network routes generated in the last 20 minutes.

<sysname> display ip routing-table time-range 0 20m verbose

Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 7        Routes : 7


Destination: 3.3.3.3/32
     Protocol: Direct           Process ID: 0
   Preference: 0                      Cost: 0
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h14m06s
          Tag: 0                  Priority: high
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: LoopBack1
     TunnelID: 0x0                   Flags:  D

Destination: 4.4.4.0/24
     Protocol: Static           Process ID: 0
   Preference: 60                     Cost: 0
      NextHop: 0.0.0.0           Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h01m38s
          Tag: 0                  Priority: medium
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: NULL0
     TunnelID: 0x0                   Flags:  D

Destination: 4.4.4.4/32
     Protocol: Static           Process ID: 0
   Preference: 60                     Cost: 0
      NextHop: 4.4.4.0           Neighbour: 0.0.0.0
        State: Invalid Adv Relied      Age: 00h01m38s
          Tag: 0                  Priority: medium
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x80000002
 RelayNextHop: 0.0.0.0           Interface: NULL0
     TunnelID: 0x0                   Flags: R

**Table 2** Description of the display ip routing-table time-range verbose command output
Item	Description
Process ID	Process ID of the routing protocol
Preference	Route preference
Cost	Route cost
NextHop	Next hop
Neighbour	IP address of a neighbor. 0.0.0.0 indicates that the route is generated by a local device.
State	Route status: Active: an active route Invalid: an invalid route Inactive: an inactive route NoAdv: a route that cannot be advertised Adv: a route that can be advertised Del: a route to be deleted Relied: a route that is iterated to the next hop and outbound interface or a tunnel Stale: a route with the stale flag and is used in GR
Age	Time after the route is generated
Tag	Administrative tag of the route The value is an integer ranging from 0 to 4294967295.
Priority	Convergence priority of the route: low: The convergence priority of a route is low. medium: The convergence priority of a route is medium. high: The convergence priority of a route is high. critical: The convergence priority of a route is critical.
Label	Label allocated by MPLS
QoSInfo	QoS information. 0x0 indicates QoS information is null. 32-bit octal number. The right-most three octal digits from right to left represent the value of QoS local ID. You can run the apply qos-local-id command to configure this value. The fourth and seventh octal digits are reserved and their values are 0. The fifth and sixth octal digits represent the value of BGP traffic index. You can run the apply traffic-index command to configure this value. The eighth octal digit is the flag.
IndirectID	Indicates the keyword of indirect next hop, which is generated by the system and cannot be configured by users. If the route is not iterated, the value is 0x0. If the route is iterated, the value is not 0x0.
RelayNextHop	Iterated next hop
Interface	Iterated outbound interface
Tunnel ID	Tunnel ID: 0x0 indicates that the route does not use a tunnel or the tunnel fails to be set up. If the value is not 0x0, the route is iterated to a tunnel.
Flags	Route flags in the heading of the routing table