01-IP Routing Table Display Commands
Chapters Download (77.93 KB)
display ip routing-table ip-address
display ip routing-table ip-prefix
display ip routing-table protocol
display ip routing-table statistics
reset ip routing-table statistics protocol
The term “router” in this document refers to a router in a generic sense or a Layer 3 switch.
Syntax
display ip routing-table [ verbose | | { begin | exclude | include } regular-expression ]
View
Any view
Default Level
1: Monitor level
Parameters
verbose: Displays detailed routing table information, including that for inactive routes. With this keyword absent, the command displays only brief information about active routes.
|: Uses a regular expression to filter output information. For details about regular expressions, refer to the section CLI Display in Basic System Configuration in the System Volume.
begin: Displays route entries starting from the one specified by the regular expression.
exclude: Displays route entries not matching the regular expression.
include: Displays route entries matching the regular expression.
regular-expression: Regular expression, a string of 1 to 256 case-sensitive characters used for specifying routing entries.
Description
Use the display ip routing-table command to display brief information about active routes in the routing table.
This command displays brief information about a routing table, with a routing entry contained in one line. The information displayed includes destination IP address/mask length, protocol, priority, cost, next hop and outbound interface. This command only displays the routes currently in use, that is, the optimal routes.
Use the display ip routing-table verbose command to display detailed information about all routes in the routing table.
This command displays detailed information about all active and inactive routes, including the statistics of the entire routing table and information for each route.
Examples
# Display brief information about active routes in the routing table.
<Sysname> display ip routing-table
Routing Tables: Public
Destinations : 6 Routes : 6
Destination/Mask Proto Pre Cost NextHop Interface
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan1
2.2.2.1/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
192.168.80.0/24 Direct 0 0 192.168.80.10 Vlan11
192.168.80.10/32 Direct 0 0 127.0.0.1 InLoop0
Table 1-1 display ip routing-table command output description
|
Field |
Description |
|
Destinations |
Number of destination addresses |
|
Routes |
Number of routes |
|
Destination/Mask |
Destination address/mask length |
|
Proto |
Protocol that presents the route |
|
Pre |
Priority of the route |
|
Cost |
Cost of the route |
|
Nexthop |
Address of the next hop on the route |
|
Interface |
Outbound interface for packets to be forwarded along the route |
# Display detailed information about all routes in the routing table.
<Sysname> display ip routing-table verbose
Routing Table : Public
Destinations : 6 Routes : 6
Destination: 1.1.1.1/24
Protocol: OSPF Process ID: 1
Preference: 10 Cost: 10
NextHop: 10.1.1.2 Interface: Vlan-interface20
BkNexthop: 20.1.1.2 BkInterface: Vlan-interface21
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h00m30s
Tag: 0
Destination: 10.1.1.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 10.1.1.1 Interface: Vlan-interface20
BkNexthop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h00m30s
Tag: 0
Destination: 10.1.1.1/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoopBack0
BkNexthop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 2d00h00m30s
Tag: 0
Destination: 10.1.1.2/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 10.1.1.2 Interface: Vlan-interface20
BkNexthop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h00m30s
Tag: 0
Destination: 127.0.0.0/8
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoopBack0
BkNexthop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 4d00h00m36s
Tag: 0
Destination: 127.0.0.1/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoopBack0
BkNexthop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 1d00h00m36s
Tag: 0
Displayed first are statistics for the whole routing table, followed by detailed description of each route (in sequence).
Table 1-2 display ip routing-table verbose command output description
|
Field |
Description |
|
|
Destination |
Destination address/mask length |
|
|
Protocol |
Protocol that presents the route |
|
|
Process ID |
Process ID |
|
|
Preference |
Priority of the route |
|
|
Cost |
Cost of the route |
|
|
NextHop |
Address of the next hop on the route |
|
|
Interface |
Outbound interface for packets to be forwarded along the route |
|
|
BkNexthop |
Backup next hop |
|
|
BkInterface |
Backup outbound interface |
|
|
RelyNextHop |
The next hop address obtained through routing recursion |
|
|
Neighbour |
Neighboring address determined by Routing Protocol |
|
|
Tunnel ID |
Tunnel ID |
|
|
Label |
Label |
|
|
State |
Route status: |
|
|
Active |
This is an active unicast route. |
|
|
Adv |
This route can be advertised. |
|
|
Delete |
This route is deleted. |
|
|
Gateway |
This is an indirect route. |
|
|
Holddown |
Number of holddown routes. Holddown is a route advertisement policy used in some distance vector (D-V) routing protocols, such as RIP, to avoid the propagation of some incorrect routes. It distributes a Holddown route during a period regardless of whether a new route to the same destination is found. For details, refer to corresponding routing protocols. |
|
|
Int |
The route was discovered by an Interior Gateway Protocol (IGP). |
|
|
NoAdv |
The route is not advertised when the router advertises routes based on policies. |
|
|
NotInstall |
Normally, among routes to a destination, the route with the highest priority is installed into the core routing table and advertised, while a NotInstall route cannot be installed into the core routing table but may be advertised. |
|
|
Reject |
The packets matching a Reject route will be dropped. Besides, the router sends ICMP unreachable messages to the sources of the dropped packets. The Reject routes are usually used for network testing. |
|
|
Static |
A static route is not lost when you perform the save operation and then restart the router. Routes configured manually are marked as static. |
|
|
Unicast |
Unicast routes |
|
|
Inactive |
Inactive routes |
|
|
Invalid |
Invalid routes |
|
|
WaitQ |
The route is the WaitQ during route recursion. |
|
|
TunE |
Tunnel |
|
|
GotQ |
The route is in the GotQ during route recursion. |
|
|
Age |
Time for which the route has been in the routing table, in the sequence of hour, minute, and second from left to right. |
|
|
Tag |
Route tag |
|
Syntax
display ip routing-table acl acl-number [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
acl-number: Basic ACL number, in the range of 2000 to 2999.
verbose: Displays detailed routing table information, including that for inactive routes. With this argument absent, the command displays only brief information about active routes.
Description
Use the display ip routing-table acl command to display information about routes permitted by a specified basic ACL.
This command is intended for the follow-up display of routing policies.
For more information about routing policy, refer to Routing Policy Configuration in the IP Routing Volume.
If the specified ACL does not exist or it has no rules configured, the entire routing table is displayed.
Examples
# Define basic ACL 2000 and set the route filtering rules.
<Sysname> system-view
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 10.1.0.0 0.0.255.255
[Sysname-acl-basic-2000] rule deny source any
# Display brief information about active routes permitted by basic ACL 2000.
[Sysname-acl-basic-2000] display ip routing-table acl 2000
Routes Matched by Access list : 2000
Summary Count : 6
Destination/Mask Proto Pre Cost NextHop Interface
10.1.1.0/24 Direct 0 0 10.1.1.2 Vlan1
10.1.1.2/32 Direct 0 0 127.0.0.1 InLoop0
10.1.2.0/24 Direct 0 0 10.1.2.1 Vlan12
10.1.2.1/32 Direct 0 0 127.0.0.1 InLoop0
10.1.3.0/24 Direct 0 0 10.1.3.1 Vlan11
10.1.3.1/32 Direct 0 0 127.0.0.1 InLoop0
For detailed description of the above output, see Table 1-1.
# Display detailed information about both active and inactive routes permitted by basic ACL 2000.
<Sysname> display ip routing-table acl 2000 verbose
Routes Matched by Access list : 2000
Summary Count: 6
Destination: 10.1.1.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 10.1.1.2 Interface: Vlan-interface1
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h25m32s
Tag: 0
Destination: 10.1.1.2/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoop0
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 1d00h41m34s
Tag: 0
Destination: 10.1.2.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 10.1.2.1 Interface: Vlan-interface12
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h05m42s
Tag: 0
Destination: 10.1.2.1/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoop0
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 1d00h05m42s
Tag: 0
Destination: 10.1.3.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 10.1.3.1 Interface: Vlan-interface11
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h05m31s
Tag: 0
Destination: 10.1.3.1/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoop0
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 1d00h05m32s
Tag: 0
For the description of the command output above, see Table 1-2.
Syntax
display ip routing-table ip-address [ mask-length | mask ] [ longer-match ] [ verbose ]
display ip routing-table ip-address1 { mask-length | mask } ip-address2 { mask-length | mask } [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
ip-address: Destination IP address, in dotted decimal format.
mask-length: IP address mask length in the range 0 to 32.
mask: IP address mask in dotted decimal format.
longer-match: Displays the route with the longest mask.
verbose: Displays detailed routing table information, including both active and inactive routes. With this argument absent, the command displays only brief information about active routes.
Description
Use the display ip routing-table ip-address command to display information about routes to a specified destination address.
Executing the command with different parameters yields different output:
l display ip routing-table ip-address
The system ANDs the input destination IP address with the subnet mask in each route entry; and ANDs the destination IP address in each route entry with its corresponding subnet mask.
If the two operations yield the same result for an entry and this entry is active, it is displayed.
l display ip routing-table ip-address mask
The system ANDs the input destination IP address with the input subnet mask; and ANDs the destination IP address in each route entry with the input subnet mask.
If the two operations yield the same result for an entry and the entry is active with a subnet mask less than or equal to the input subnet mask, the entry is displayed.
Only route entries that exactly match the input destination address and mask are displayed.
l display ip routing-table ip-address longer-match
The system ANDs the input destination IP address with the subnet mask in each route entry; and ANDs the destination IP address in each route entry with its corresponding subnet mask.
If the two operations yield the same result for multiple entries that are active, the one with longest mask length is displayed.
l display ip routing-table ip-address mask longer-match
The system ANDs the input destination IP address with the input subnet mask; and ANDs the destination IP address in each route entry with the input subnet mask.
If the two operations yield the same result for multiple entries with a mask less than or equal to the input subnet mask, the one that is active with longest mask length is displayed.
Use the display ip routing-table ip-address1 { mask-length | mask } ip-address2 { mask-length | mask } command to display route entries with destination addresses within a specified range.
Examples
# Display route entries for the destination IP address 11.1.1.1.
[Sysname] display ip routing-table 11.1.1.1
Routing Table : Public
Summary Count : 4
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/0 Static 60 0 0.0.0.0 NULL0
11.0.0.0/8 Static 60 0 0.0.0.0 NULL0
11.1.0.0/16 Static 60 0 0.0.0.0 NULL0
11.1.1.0/24 Static 60 0 0.0.0.0 NULL0
For detailed description about the output, see Table 1-1.
# Display route entries by specifying a destination IP address and the longer-match keyword.
[Sysname] display ip routing-table 11.1.1.1 longer-match
Routing Table : Public
Summary Count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.1.1.0/24 Static 60 0 0.0.0.0 NULL0
# Display route entries by specifying a destination IP address and mask.
[Sysname] display ip routing-table 11.1.1.1 24
Routing Table : Public
Summary Count : 3
Destination/Mask Proto Pre Cost NextHop Interface
11.1.1.0/24 Static 60 0 0.0.0.0 NULL0
# Display route entries by specifying a destination IP address and mask and the longer-match keyword.
[Sysname] display ip routing-table 11.1.1.1 24 longer-match
Routing Table : Public
Summary Count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.1.1.0/24 Static 60 0 0.0.0.0 NULL0
For detailed description of the above output, see Table 1-1.
# Display route entries for destination addresses in the range 1.1.1.0 to 5.5.5.0.
<Sysname> display ip routing-table 1.1.1.0 24 5.5.5.0 24
Routing Table : Public
Destination/Mask Proto Pre Cost NextHop Interface
1.1.1.0/24 Direct 0 0 1.1.1.1 Vlan1
1.1.1.1/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
3.3.3.0/24 Direct 0 0 3.3.3.1 Vlan12
3.3.3.1/32 Direct 0 0 127.0.0.1 InLoop0
4.4.4.0/24 Direct 0 0 4.4.4.1 Vlan11
4.4.4.1/32 Direct 0 0 127.0.0.1 InLoop0
Syntax
display ip routing-table ip-prefix ip-prefix-name [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
ip-prefix-name: IP prefix list name, a string of 1 to 19 characters.
verbose: Displays detailed routing table information, including that for inactive routes. With this argument absent, the command displays only brief information about active routes.
Description
Use the display ip routing-table ip-prefix command to display information about routes permitted by a specified prefix list.
This command is intended for the follow-up display of routing policies. If the specified prefix list is not configured, detailed information about all routes (with the verbose keyword) or brief information about all active routes (without the verbose keyword) is displayed.
Examples
# Configure a prefix list named test, permitting routes with a prefix of 2.2.2.0 and a mask length between 24 and 32.
<Sysname> system-view
[Sysname] ip ip-prefix test permit 2.2.2.0 24 less-equal 32
# Display brief information about active routes permitted by the prefix list test.
[Sysname] display ip routing-table ip-prefix test
Routes Matched by Prefix list : test
Summary Count : 2
Destination/Mask Proto Pre Cost NextHop Interface
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
2.2.2.1/32 Direct 0 0 127.0.0.1 InLoop0
For detailed description of the above output, see Table 1-1.
# Display detailed information about both active and inactive routes permitted by IP prefix list test.
[Sysname] display ip routing-table ip-prefix test verbose
Routes Matched by Prefix list test :
Summary Count : 2
Destination: 2.2.2.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 2.2.2.1 Interface: Vlan-interface2
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 1d00h20m52s
Tag: 0
Destination: 2.2.2.1/32
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 127.0.0.1 Interface: InLoop0
RelyNextHop: 0.0.0.0 Neighbour: 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 1d00h20m52s
Tag: 0
For detailed description of the above output, see Table 1-2.
Syntax
display ip routing-table protocol protocol [ inactive | verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
protocol: Routing protocol. It can be direct or static.
inactive: Displays information about only inactive routes. With this argument absent, the command displays information about both active and inactive routes.
verbose: Displays detailed routing table information. With this argument absent, the command displays brief routing table information.
Description
Use the display ip routing-table protocol command to display routing information of a specified routing protocol.
Examples
# Display brief information about direct routes.
<Sysname> display ip routing-table protocol direct
Public Routing Table : Direct
Summary Count : 6
Direct Routing table Status : < Active>
Summary Count : 6
Destination/Mask Proto Pre Cost NextHop Interface
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
2.2.2.2/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
192.168.80.0/24 Direct 0 0 192.168.80.10 Vlan11
192.168.80.10/32 Direct 0 0 127.0.0.1 InLoop0
Direct Routing table Status : < Inactive>
Summary Count : 0
# Display brief information about static routes.
<Sysname> display ip routing-table protocol static
Public Routing Table : Static
Summary Count : 2
Static Routing table Status : < Active>
Summary Count : 0
Static Routing table Status : < Inactive>
Summary Count : 2
Destination/Mask Proto Pre Cost NextHop Interface
1.2.3.0/24 Static 60 0 1.2.4.5 Vlan10
3.0.0.0/8 Static 60 0 2.2.2.2 Vlan11
For detailed description of the above output, see Table 1-1.
Syntax
display ip routing-table statistics
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display ip routing-table statistics command to display the route statistics of the routing table.
Examples
# Display route statistics in the routing table.
<Sysname> display ip routing-table statistics
Proto route active added deleted freed
DIRECT 24 4 25 1 0
STATIC 4 1 4 0 0
Total 28 5 29 1 0
Table 1-3 display ip routing-table statistics command output description
|
Field |
Description |
|
Proto |
Origin of the routes. |
|
route |
Number of routes from the origin |
|
active |
Number of active routes from the origin |
|
added |
Number of routes added into the routing table since the router started up or the routing table was last cleared |
|
deleted |
Number of routes marked as deleted, which will be freed after a period. |
|
freed |
Number of routes that got freed, that is, got removed permanently. |
|
Total |
Total number |
Syntax
reset ip routing-table statistics protocol { protocol | all }
View
User view
Default Level
2: System level
Parameters
protocol: Clears statistics for the IPv4 routing protocol, which can be direct or static.
all: Clears statistics for all IPv4 routing protocols.
Description
Use the reset ip routing-table statistics protocol command to clear routing statistics for the routing table.
Examples
# Clear all the routing statistics information.
<Sysname> reset ip routing-table statistics protocol all
