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
Parameter
verbose: Displays
detailed routing table information, including that for inactive routes. With
this argument absent, the command displays only summary information about active
routes.
|: Uses a regular expression to filter output information.
begin:
Displays routing table entries starting from the one specified by the regular
expression.
include:
Displays routing table entries specified by the regular expression.
exclude:
Displays routing table entries other than those specified by the regular
expression.
regular-expression: Regular expression, a string of 1 to 256 characters.
Table 1-1
Special characters for regular expressions
|
Character
|
Meaning
|
Remarks
|
|
_
|
Underscore, functions similarly as a
wildcard and matches one of the following:
(^|$|[,(){}])
or a space, the beginning of a string,
the end of a string.
|
If it is not the first character in a
regular expression, it can appear as many times as the command line length
permits.
If it is the first character in a regular
expression, it can be followed with up to four underscores.
If it appears intermittently in a regular
expression, only the first group takes effect.
|
|
(
|
Left parenthesis, represents a stack push
operation in a program.
|
It is not recommended to use this
character in a regular expression.
|
|
.
|
Full stop, a wildcard that matches any
character, including a space.
|
—
|
|
*
|
Asterisk, indicates that the character(s)
to its left can appear 0 or more times.
|
zo* matches z and zoo.
|
|
+
|
Plus, indicates that the character(s) to
its left can appear one or more times.
|
zo+ matches zo and zoo, but not z.
|
Description
Use the display ip routing-table command
to display brief information about active routes in the routing table.
Use the display ip routing-table verbose
command to display detailed information about all routes in the routing table.
Example
# Display brief information about active
routes in the routing table.
<Sysname> display ip
routing-table
Routing Tables: Public
Destinations : 4
Routes : 4
Destination/Mask Proto Pre
Cost NextHop Interface
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/16 Direct 0 0
192.168.0.52 Vlan1
192.168.0.52/32 Direct 0 0
127.0.0.1 InLoop0
Table 1-2 Description on the fields of
the display ip routing-table command
|
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 : 4 Routes :
4
Destination:
127.0.0.0/8
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: 02h02m57s
Tag: 0
Destination: 127.0.0.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: 02h02m57s
Tag: 0
Destination: 192.168.0.0/16
Protocol: Direct
Process ID: 0
Preference: 0
Cost: 0
NextHop: 192.168.0.52
Interface: Vlan-interface1
RelyNextHop: 0.0.0.0 Neighbour:
0.0.0.0
Tunnel ID: 0x0
Label: NULL
State: Active Adv
Age: 02h02m49s
Tag: 0
Destination: 192.168.0.52/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: 02h02m50s
Tag: 0
Displayed first are statistics for the whole
routing table, followed by detailed description of each route (in sequence).
Table 1-3 Description on the fields of the display ip routing-table verbose
command
|
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
|
|
RelyNextHop
|
The next hop address obtained through
routing stack.
|
|
Neighbour
|
Neighboring address determined by Routing
Protocol
|
|
Tunnel ID
|
Tunnel ID
|
|
Label
|
Label
|
|
State
|
Status of the route, which could be
Active, Inactive, Adv, or NoAdv.
|
|
Age
|
Time that 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
Parameter
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 exit or it has no rules configured, the entire routing table is
displayed.
Example
# 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
# 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 : 3
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.1/32 Direct 0 0
127.0.0.1 InLoop0
For detailed
description of the above output, see Table 1-2.
# 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 : 3
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: 02h13m21s
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: 02h13m21s
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 Adv
Age: 00h03m13s
Tag: 0
For detailed description of the above output, see Table 1-3.
Syntax
display ip routing-table ip-address [ mask-length | mask ] [ longer-match
] [ verbose ]
View
Any view
Parameter
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 longer mask.
verbose: Displays
detailed routing table information, including that for inactive routes. With
this argument absent, the command displays only summary 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.
Example
# Display brief information about active
routes in the routing table..
<Sysname> display ip
routing-table
Routing Tables: Public
Destinations : 13
Routes : 13
Destination/Mask Proto Pre
Cost NextHop Interface
10.1.2.0/24 Static 60
0 0.0.0.0 NULL0
10.1.2.16/28 Static 60
0 0.0.0.0 NULL0
10.1.2.32/28 Static 60
0 0.0.0.0 NULL0
10.1.3.0/24 Static 60
0 0.0.0.0 NULL0
10.1.4.0/24 Static 60
0 0.0.0.0 NULL0
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.52 Vlan1
192.168.0.52/32 Direct 0 0
127.0.0.1 InLoop0
192.168.100.1/32 Direct 0 0
127.0.0.1 InLoop0
192.168.200.0/24 Static 60
0 192.168.0.36 Vlan1
192.168.220.0/24 Static 60
0 192.168.0.236 Vlan1
192.168.220.0/28 Static 60
0 192.168.0.25 Vlan1
# Display route entries for the destination
IP address 192.168.0.220.
<Sysname> display ip
routing-table 192.168.220.0
Routing Table : Public
Summary Count : 2
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.220.0/24 Static 60
0 192.168.0.236 Vlan1
192.168.220.0/28 Static 60
0 192.168.0.25 Vlan1
For detailed description about the output, see
Table 1-2.
# Display route entries by specifying a
destination IP address and the longer-match keyword.
<Sysname> display ip
routing-table 192.168.220.0 longer-match
Routing Table : Public
Summary Count : 1
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.220.0/28 Static 60
0 192.168.0.25 Vlan1
# Display route entries by specifying a
destination IP address and mask.
<Sysname> display ip
routing-table 192.168.220.0 32
Routing Table : Public
Summary Count : 2
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.220.0/24 Static 60
0 192.168.0.236 Vlan1
192.168.220.0/28 Static 60
0 192.168.0.25 Vlan1
# Display route entries by specifying a
destination IP address and mask and the longer-match keyword.
<Sysname> display ip routing-table
192.168.220.0 32 longer-match
Routing Table : Public
Summary Count : 1
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.220.0/28 Static 60
0 192.168.0.25 Vlan1
For detailed description of the above output,
see Table 1-3.
1.1.4 display ip routing-table ip-address1 ip-address2
Syntax
display ip routing-table ip-address1 mask1 ip-address2 mask2 [ verbose
]
View
Any view
Parameter
ip-address1,
ip-address2: Destination IP address, in dotted decimal notation. ip-address1/mask1
and ip-address2/mask2 combine to determine an address range. The
system ANDs ip-address1 with mask1 for the starting address of
the address range and ANDs ip-address2 with mask2 for the ending
address of the address range.
mask1, mask2:
IP address mask, address length in dotted decimal notation or expressed as an
integer. When expressed as an integer, a mask takes a value ranging from
0 to 32.
verbose:
Displays detailed routing table information, including that for both active and
inactive routes. With this argument absent, the command displays summary
information about active routes only.
Description
Use the display ip routing-table ip-address1
ip-address2 command to display information about the routes to the
specified range of destination addresses.
Example
# Display information about the routes to
the destination addresses ranging from 10.1.4.0 to 200.0.0.0.
<Sysname> display ip
routing-table 10.1.4.0 28 200.0.0.0 24
Routing Table : Public
Destination/Mask Proto Pre
Cost NextHop Interface
10.1.4.0/24 Static 60
0 0.0.0.0 NULL0
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.52 Vlan1
192.168.0.52/32 Direct 0
0 127.0.0.1 InLoop0
192.168.100.1/32 Direct 0
0 127.0.0.1 InLoop0
192.168.200.0/24 Static 60 0 192.168.0.36
Vlan1
For detailed description of the above output,
see Table 1-2.
Syntax
display ip routing-table ip-prefix ip-prefix-name [ verbose ]
View
Any view
Parameter
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.
Example
# Configure a prefix list named abc, permitting
routes with a prefix of 192.168.0.0 and a mask length between 16 and 32.
<Sysname> system-view
[Sysname] ip ip-prefix abc permit 192.168.0.0
16 less-equal 32
# Display brief information about active
routes permitted by the prefix list abc.
<Sysname> display ip
routing-table ip-prefix abc
Routes Matched by Prefix list : abc
Summary Count : 3
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.0.0/16 Direct 0 0
192.168.0.52 Vlan1
192.168.0.52/32 Direct 0 0
127.0.0.1 InLoop0
192.168.100.1/32 Direct 0 0
127.0.0.1 InLoop0
For detailed description of the above output,
see Table 1-2.
# Display detailed information about both
active and inactive routes permitted by IP prefix list abc.
<Sysname> display ip
routing-table ip-prefix abc verbose
Routes Matched by Prefix list abc :
Summary Count : 3
Destination: 192.168.0.0/16
Protocol: Direct
Process ID: 0
Preference: 0
Cost: 0
NextHop: 192.168.0.52
Interface: Vlan-interface1
RelyNextHop: 0.0.0.0 Neighbour:
0.0.0.0
Tunnel ID: 0x0
Label: NULL
State: Active Adv
Age: 02h24m34s
Tag: 0
Destination: 192.168.0.52/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: 02h24m34s
Tag: 0
Destination: 192.168.100.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 Adv
Age: 00h14m26s
Tag: 0
For detailed description of the above output, see Table 1-3.
Syntax
display ip routing-table protocol protocol [ inactive | verbose ]
View
Any view
Parameter
protocol: Routing
protocol. It can be DIRECT, RIP, 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.
Example
# Display brief information about direct
routes.
<Sysname> display ip
routing-table protocol direct
Public Routing Table : Direct
Summary Count : 5
Direct Routing table Status : <
Active>
Summary
Count : 5
Destination/Mask Proto Pre
Cost NextHop Interface
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.52 Vlan1
192.168.0.52/32 Direct 0 0
127.0.0.1 InLoop0
192.168.100.1/32 Direct 0 0
127.0.0.1 InLoop0
Direct Routing table Status : <
Inactive>
Summary Count : 0
# Display summary 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 : 1
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.200.0/24 Static 60
0 192.168.0.36 Vlan1
Static Routing table Status : <
Inactive>
Summary Count : 1
Destination/Mask Proto Pre
Cost NextHop Interface
192.168.120.0/24 Static 60
0 192.168.2.1
For detailed
description of the above output, see Table 1-2.
Syntax
display ip routing-table statistics
View
Any view
Parameter
None
Description
Use the display ip routing-table
statistics command to display statistics about the public network routing
table.
Example
# Display statistics about the routes in
the routing table.
<Sysname> display ip
routing-table statistics
Proto route active
added deleted freed
DIRECT 5 5
8 3 3
STATIC 2 1
2 0 0
RIP 0 0 0
0 0
Total 7 6
10 3 3
Table 1-4 Description
on the fields of display ip routing-table statistics
|
Field
|
Description
|
|
Proto
|
Origin of the routes. Possible values
include O_ASE for OSPF_ASE routes, O_NSSA for OSPF NSSA, and AGGRE for aggregated
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 starts up or the last routing table reset operation
|
|
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
|
Sums for the numerical items above
|
Syntax
display ipv6 routing-table
View
Any view
Parameter
None
Description
Use the display ipv6 routing-table
command to display brief routing table information, including destination IP
address and prefix, protocol type, priority, metric, next hop and outbound
interface.
The command displays only active routes,
namely, the brief information about the current optimal routes.
Example
# Display brief routing table information
<Sysname> display ipv6
routing-table
Routing Table :
Destinations : 1
Routes : 1
Destination : ::1/128
Protocol : Direct
NextHop :
::1 Preference : 0
Interface :
InLoop0 Cost : 0
Table 1-5 Description on the fields of
the display ipv6 routing-table command
|
Field
|
Description
|
|
Destination
|
Destination IPv6 address
|
|
NextHop
|
Next hop
|
|
Preference
|
Routing preference
|
|
Interface
|
Outbound interface
|
|
Protocol
|
Routing protocol of the route
|
|
Cost
|
Routing cost
|
Syntax
display ipv6 routing-table acl acl6-number [ verbose ]
View
Any view
Parameter
acl6-number:
Basic IPv6 ACL number, in the range 2000 to 2999.
Verbose:
Displays both active and inactive verbose routing information permitted by the
ACL. Without this keyword, only brief active routing information is displayed.
Description
Use the display ipv6 routing-table acl
command to display routing information permitted by the IPv6 ACL.
If the specified IPv6 ACL is not available,
all routing information is displayed.
Example
# Display brief routing information
permitted by ACL 2000.
<Sysname> display ipv6
routing-table acl 2000
Routes Matched by Access list 2000
:
Summary Count : 4
Destination:
::1/128 Protocol : Direct
NextHop :
::1 Preference: 0
Interface :
InLoop0 Cost : 0
Destination:
3009::/64 Protocol : Direct
NextHop :
3009::1235 Preference: 0
Interface :
Vlan1 Cost : 0
Destination:
3009::1235/128 Protocol : Direct
NextHop :
::1 Preference: 0
Interface :
InLoop0 Cost : 0
Destination:
FE80::/10 Protocol : Direct
NextHop :
:: Preference: 0
Interface : NULL0
Cost : 0
Refer to Table 1-5 for description about the above output.
Syntax
display ipv6 routing-table ipv6-address prefix-length [ longer-match ] [ verbose
]
View
Any view
Parameter
ipv6-address:
Destination IPv6 address.
prefix-length: Prefix length, in the range 0 to 128.
longer-match:
Displays routes matching the specified prefix.
verbose:
Displays both active and inactive verbose routing information. Without this
keyword, only brief active routing information is displayed.
Description
Use the display ipv6 routing-table ipv6-address
command to display routing information about the specified destination IPv6
address.
Example
# Display brief information about the route
matching the specified destination IPv6 address.
<Sysname> display ipv6
routing-table 1:1::1:1 64
Routing Table:
Summary Count: 1
Destination : 1:1::/64
Protocol : Static
NextHop : :: Preference
: 60
Interface : NULL0 Cost
: 0
# Display brief information about routes
with destinations falling into the specified destination.
<Sysname> display ipv6
routing-table 1:: 16 longer-match
Routing Tables:
Summary Count : 1
Destination:
1:1::/64 Protocol : Static
NextHop :
:: Preference: 60
Interface :
NULL0 Cost : 0
# Display brief information about the route
matching the specified destination IPv6 address.
<Sysname> display ipv6
routing-table 100::1 64
Routing Table :
Summary Count : 1
Destination:
100::/64 Protocol : Static
NextHop :
:: Preference: 60
Interface :
NULL0 Cost : 0
Refer to Table 1-5 for description about the above output.
Syntax
display ipv6 routing-table ipv6-address1 prefix-length1 ipv6-address2 prefix-length2
[ verbose ]
View
Any view
Parameter
ipv6-address1/ipv6-address2: An IPv6 address range from IPv6 address1 to
IPv6 address2.
prefix-length1/prefix-length2: Prefix length, in the range 0 to 128.
verbose: Displays
both active and inactive verbose routing information. Without this keyword,
only brief active routing information is displayed.
Description
Use the display ipv6 routing-table ipv6-address1
ipv6-address2 command to display routes with destinations falling into the
specified IPv6 address range.
Example
# Display routes with destinations falling
into the IPv6 address range.
<Sysname> display ipv6
routing-table 3:: 32 4:4:: 64
Routing Table :
Summary Count : 3
Destination:
3::/32 Protocol : Static
NextHop :
:: Preference: 60
Interface :
NULL0 Cost : 0
Destination: 4::/64
Protocol : Static
NextHop :
:: Preference: 60
Interface :
NULL0 Cost : 0
Destination:
4:4::/64 Protocol : Static
NextHop :
:: Preference: 60
Interface :
NULL0 Cost : 0
Refer to Table 1-5 for description about the above output.
Syntax
display ipv6 routing-table ipv6-prefix ipv6-prefix-name [ verbose ]
View
Any view
Parameter
ipv6-prefix-name: Name of the IPv6 prefix list, in the range 1 to 19 characters.
verbose: Displays
both active and inactive verbose routing information. Without this keyword,
only brief active routing information is displayed.
Description
Use the display ipv6 routing-table
ipv6-prefix command to display routes permitted by the IPv6 prefix list.
