Title | Size | Downloads |
---|---|---|
H3C S5120-SI Series Ethernet Switches Command Reference-Release 1101-6W105-IP Routing Basics Commands.pdf | 72.1 KB |
- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
16-IP Routing Basics Commands | 72.1 KB |
1 IP Routing Basics Configuration Commands
IP Routing Basics Configuration Commands
display ip routing-table ip-address
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.
IP Routing Basics Configuration Commands
display ip routing-table
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.
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
Destinations : 5 Routes : 5
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Static 60 0 1.1.1.1 Vlan1
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.0.0/24 Direct 0 0 192.168.0.53 Vlan1
192.168.0.53/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
Destinations : 5 Routes : 5
Destination: 0.0.0.0/32
Protocol: Static Process ID: 0
Preference: 60 Cost: 0
NextHop: 1.1.1.1 Interface: Vlan-interface1
BkNextHop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbor : 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 00h00m14s
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 Neighbor : 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 04h20m03s
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 Neighbor : 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 04h20m03s
Tag: 0
Destination: 192.168.0.0/24
Protocol: Direct Process ID: 0
Preference: 0 Cost: 0
NextHop: 192.168.0.53 Interface: Vlan-interface1
BkNextHop: 0.0.0.0 BkInterface:
RelyNextHop: 0.0.0.0 Neighbor : 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active Adv Age: 04h12m07s
Tag: 0
Destination: 192.168.0.53/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 Neighbor : 0.0.0.0
Tunnel ID: 0x0 Label: NULL
State: Active NoAdv Age: 04h12m07s
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. |
|
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 |
display ip routing-table acl
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.
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 Vlan2
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 Vlan1
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: InLoopBack0
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-interface2
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: InLoopBack0
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-interface1
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: InLoopBack0
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.
display ip routing-table ip-address
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.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
# 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 Vlan2
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 Vlan1
4.4.4.1/32 Direct 0 0 127.0.0.1 InLoop0
display ip routing-table protocol
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 Vlan1
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 Vlan1
For detailed description of the above output, see Table 1-1.
display ip routing-table statistics
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 network 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 |
reset ip routing-table statistics protocol
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 routing statistics information.
<Sysname> reset ip routing-table statistics protocol all