Page is loading ...
HPE Networking Comware
5120v3 Switch
Series
IP Routing Command Reference
Software
version: Release 6352P02 and later
Document version: 6W100-20230715
© Copyright 2023 Hewlett Packard Enterprise Development LP
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard
Enterprise products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett
Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s
standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard
Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise
website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
i
Contents
Basic IP routing commands ··········································································· 1
address-family ipv4 ···································································································································· 1
address-family ipv6 ···································································································································· 1
display ip routing-table ······························································································································· 2
display ip routing-table acl ·························································································································· 6
display ip routing-table ip-address ············································································································· 8
display ip routing-table prefix-list ·············································································································· 10
display ip routing-table protocol ··············································································································· 12
display ip routing-table statistics ·············································································································· 13
display ip routing-table summary ············································································································· 14
display ipv6 rib graceful-restart ················································································································ 14
display ipv6 rib nib ···································································································································· 15
display ipv6 route-direct nib ····················································································································· 17
display ipv6 routing-table ························································································································· 19
display ipv6 routing-table acl ···················································································································· 22
display ipv6 routing-table ipv6-address ···································································································· 26
display ipv6 routing-table prefix-list ·········································································································· 29
display ipv6 routing-table protocol ············································································································ 30
display ipv6 routing-table statistics ··········································································································· 31
display ipv6 routing-table summary ·········································································································· 32
display rib graceful-restart ························································································································ 33
display rib nib ··········································································································································· 34
display route-direct nib ····························································································································· 39
fib lifetime ················································································································································· 42
inter-protocol fast-reroute ························································································································· 42
ip route fast-switchover enable ················································································································ 43
ipv6 route fast-switchover enable············································································································· 44
maintenance-probe enable ······················································································································ 44
non-stop-routing ······································································································································· 45
protocol lifetime ········································································································································ 46
protocol nexthop recursive-lookup ··········································································································· 46
reset ip routing-table statistics protocol ···································································································· 47
reset ipv6 routing-table statistics protocol ································································································ 48
rib ····························································································································································· 48
routing-table limit ······································································································································ 49
Static routing commands ············································································· 50
delete static-routes all ······························································································································ 50
display route-static nib ····························································································································· 50
display route-static routing-table ·············································································································· 53
ip route-static ············································································································································ 55
ip route-static arp-request ························································································································ 57
ip route-static default-preference ············································································································· 58
ip route-static fast-reroute auto ················································································································ 59
ip route-static primary-path-detect bfd echo ····························································································· 59
ip route-static-group ································································································································· 60
prefix ························································································································································ 61
RIP commands ···························································································· 62
checkzero ················································································································································· 62
default cost ··············································································································································· 62
default-route ············································································································································· 63
display rip ················································································································································· 64
display rip database ································································································································· 66
display rip graceful-restart ························································································································ 66
display rip interface ·································································································································· 67
display rip neighbor ·································································································································· 69
ii
display rip non-stop-routing ······················································································································ 69
display rip route ········································································································································ 70
dscp ·························································································································································· 72
fast-reroute ··············································································································································· 73
filter-policy export ····································································································································· 73
filter-policy import ····································································································································· 75
graceful-restart ········································································································································· 77
graceful-restart interval ···························································································································· 77
host-route ················································································································································· 78
import-route ·············································································································································· 78
network ····················································································································································· 79
non-stop-routing ······································································································································· 80
output-delay ············································································································································· 81
peer ·························································································································································· 81
preference ················································································································································ 82
reset rip process ······································································································································· 83
reset rip statistics ····································································································································· 83
rip ····························································································································································· 84
rip authentication-mode ···························································································································· 84
rip bfd enable ··········································································································································· 85
rip bfd enable destination ························································································································· 86
rip default-route ········································································································································ 87
rip enable ················································································································································· 87
rip input ···················································································································································· 88
rip max-packet-length ······························································································································· 89
rip metricin ················································································································································ 89
rip metricout ············································································································································· 90
rip mib-binding ·········································································································································· 91
rip output ·················································································································································· 92
rip output-delay ········································································································································ 92
rip poison-reverse ···································································································································· 93
rip primary-path-detect bfd echo ·············································································································· 94
rip split-horizon ········································································································································· 94
rip summary-address ······························································································································· 95
rip version ················································································································································· 95
silent-interface ·········································································································································· 96
summary ·················································································································································· 97
timer triggered ·········································································································································· 98
timers ······················································································································································· 98
validate-source-address ··························································································································· 99
version ···················································································································································· 100
OSPF commands ······················································································ 102
abr-summary (OSPF area view) ············································································································ 102
area (OSPF view) ··································································································································· 102
asbr-summary (OSPF view) ··················································································································· 103
authentication-mode ······························································································································· 104
bandwidth-reference (OSPF view) ········································································································· 105
capability default-exclusion ···················································································································· 106
database-filter peer (OSPF view) ··········································································································· 107
default (OSPF view) ······························································································································· 108
default-cost (OSPF area view) ··············································································································· 109
default-route-advertise (OSPF view) ······································································································ 109
description (OSPF/OSPF area view) ····································································································· 110
discard-route ·········································································································································· 111
display ospf ············································································································································ 112
display ospf abr-asbr ······························································································································ 118
display ospf abr-summary ······················································································································ 119
display ospf asbr-summary ···················································································································· 121
display ospf event-log ···························································································································· 122
display ospf event-log hello ···················································································································· 126
display ospf fast-reroute lfa-candidate ··································································································· 131
iii
display ospf graceful-restart ··················································································································· 132
display ospf interface ····························································································································· 135
display ospf interface hello ····················································································································· 137
display ospf lsdb ····································································································································· 138
display ospf nexthop ······························································································································ 141
display ospf non-stop-routing status ······································································································ 142
display ospf peer ···································································································································· 143
display ospf peer statistics ····················································································································· 147
display ospf request-queue ···················································································································· 148
display ospf retrans-queue ····················································································································· 149
display ospf routing ································································································································ 150
display ospf spf-tree ······························································································································· 153
display ospf statistics ····························································································································· 156
display ospf troubleshooting··················································································································· 161
display ospf vlink ···································································································································· 164
display router id ······································································································································ 166
dscp ························································································································································ 166
enable link-local-signaling ······················································································································ 167
enable out-of-band-resynchronization···································································································· 167
event-log ················································································································································ 168
fast-reroute (OSPF view) ······················································································································· 168
filter (OSPF area view) ··························································································································· 169
filter-policy export (OSPF view)·············································································································· 170
filter-policy import (OSPF view) ·············································································································· 171
graceful-restart (OSPF view) ·················································································································· 172
graceful-restart helper enable ················································································································ 174
graceful-restart helper strict-lsa-checking ······························································································ 174
graceful-restart interval (OSPF view) ····································································································· 175
host-advertise ········································································································································· 175
import-route (OSPF view) ······················································································································ 176
ispf enable (OSPF view) ························································································································ 178
log-peer-change ····································································································································· 178
lsa-arrival-interval ··································································································································· 179
lsa-generation-interval ···························································································································· 179
lsdb-overflow-interval ····························································································································· 180
lsdb-overflow-limit ·································································································································· 181
network (OSPF area view) ····················································································································· 182
non-stop-routing ····································································································································· 182
nssa (OSPF area view) ·························································································································· 183
opaque-capability enable ······················································································································· 184
ospf ························································································································································ 185
ospf area ················································································································································ 186
ospf authentication-mode ······················································································································· 186
ospf bfd enable ······································································································································· 188
ospf cost (interface view) ······················································································································· 188
ospf database-filter ································································································································· 189
ospf dr-priority ········································································································································ 190
ospf fast-reroute lfa-backup ··················································································································· 191
ospf lsu-flood-control ······························································································································ 191
ospf mib-binding ····································································································································· 192
ospf mtu-enable ····································································································································· 193
ospf network-type ··································································································································· 193
ospf packet-size ····································································································································· 194
ospf prefix-suppression ·························································································································· 195
ospf primary-path-detect bfd ·················································································································· 196
ospf timer dead ······································································································································ 196
ospf timer hello ······································································································································· 197
ospf timer poll ········································································································································· 198
ospf timer retransmit ······························································································································ 198
ospf trans-delay ······································································································································ 199
ospf troubleshooting max-number ·········································································································· 200
ospf ttl-security ······································································································································· 200
iv
peer (OSPF view) ··································································································································· 201
pic (OSPF view) ····································································································································· 202
preference (OSPF view) ························································································································· 203
prefix-priority (OSPF view) ····················································································································· 204
prefix-suppression ·································································································································· 205
reset ospf event-log ································································································································ 205
reset ospf event-log hello ······················································································································· 206
reset ospf process ·································································································································· 207
reset ospf redistribution ·························································································································· 207
reset ospf statistics ································································································································· 208
reset ospf troubleshooting ······················································································································ 208
rfc1583 compatible ································································································································· 209
router id ·················································································································································· 209
silent-interface (OSPF view) ·················································································································· 210
snmp trap rate-limit ································································································································ 211
snmp-agent trap enable ospf ················································································································· 211
spf-schedule-interval (OSPF view) ········································································································· 213
stub (OSPF area view) ··························································································································· 214
stub-router (OSPF view) ························································································································ 214
transmit-pacing ······································································································································· 215
ttl-security ··············································································································································· 216
vlink-peer (OSPF area view) ·················································································································· 217
Policy-based routing commands ································································ 219
apply next-hop ········································································································································ 219
description ·············································································································································· 219
display ip policy-based-route ·················································································································· 220
display ip policy-based-route interface ··································································································· 221
display ip policy-based-route local ········································································································· 223
display ip policy-based-route setup ········································································································ 224
if-match acl ············································································································································· 225
ip local policy-based-route ····················································································································· 225
ip policy-based-route ······························································································································ 226
policy-based-route ·································································································································· 227
reset ip policy-based-route statistics ······································································································ 228
IPv6 static routing commands ···································································· 229
delete ipv6 static-routes all ····················································································································· 229
display ipv6 route-static nib ···················································································································· 229
display ipv6 route-static routing-table ····································································································· 232
ipv6 route-static ······································································································································ 234
ipv6 route-static default-preference ········································································································ 235
RIPng commands ······················································································ 237
checkzero ··············································································································································· 237
default cost ············································································································································· 237
display ripng ··········································································································································· 238
display ripng database ··························································································································· 239
display ripng graceful-restart ·················································································································· 240
display ripng interface ···························································································································· 241
display ripng neighbor ···························································································································· 242
display ripng non-stop-routing ················································································································ 243
display ripng route ·································································································································· 243
enable ipsec-profile ································································································································ 245
fast-reroute ············································································································································· 246
filter-policy export ··································································································································· 246
filter-policy import ··································································································································· 248
graceful-restart ······································································································································· 249
graceful-restart interval ·························································································································· 249
import-route ············································································································································ 250
non-stop-routing ····································································································································· 251
output-delay ··········································································································································· 251
v
preference ·············································································································································· 252
reset ripng process ································································································································· 253
reset ripng statistics ······························································································································· 253
ripng ······················································································································································· 254
ripng default-route ·································································································································· 254
ripng enable ··········································································································································· 255
ripng ipsec-profile ··································································································································· 256
ripng metricin ·········································································································································· 256
ripng metricout ······································································································································· 257
ripng output-delay ·································································································································· 257
ripng poison-reverse ······························································································································ 258
ripng primary-path-detect bfd echo ········································································································ 258
ripng split-horizon ··································································································································· 259
ripng summary-address ························································································································· 260
timer triggered ········································································································································ 260
timers ····················································································································································· 261
OSPFv3 commands ··················································································· 263
abr-summary (OSPFv3 area view) ········································································································· 263
area ························································································································································ 263
asbr-summary (OSPFv3 view) ··············································································································· 264
authentication-mode ······························································································································· 265
bandwidth-reference (OSPFv3 view) ····································································································· 266
default tag ·············································································································································· 267
default-cost (OSPFv3 area view) ··········································································································· 267
default-route-advertise (OSPFv3 view) ·································································································· 268
display ospfv3 ········································································································································ 269
display ospfv3 abr-asbr ·························································································································· 275
display ospfv3 abr-summary ·················································································································· 277
display ospfv3 asbr-summary ················································································································ 278
display ospfv3 event-log ························································································································· 280
display ospfv3 graceful-restart ··············································································································· 283
display ospfv3 interface ·························································································································· 287
display ospfv3 lsdb ································································································································· 290
display ospfv3 nexthop ··························································································································· 294
display ospfv3 non-stop-routing ············································································································· 295
display ospfv3 peer ································································································································ 295
display ospfv3 request-queue ················································································································ 299
display ospfv3 retrans-queue ················································································································· 300
display ospfv3 routing ···························································································································· 301
display ospfv3 spf-tree ··························································································································· 303
display ospfv3 statistics ·························································································································· 306
display ospfv3 vlink ································································································································ 310
enable ipsec-profile ································································································································ 311
event-log ················································································································································ 312
fast-reroute (OSPFv3 view) ···················································································································· 312
filter (OSPFv3 area view) ······················································································································· 313
filter-policy export (OSPFv3 view) ·········································································································· 314
filter-policy import (OSPFv3 view) ·········································································································· 315
graceful-restart enable ··························································································································· 316
graceful-restart helper enable ················································································································ 317
graceful-restart helper strict-lsa-checking ······························································································ 318
graceful-restart interval ·························································································································· 319
import-route (OSPFv3 view) ··················································································································· 319
log-peer-change ····································································································································· 321
lsa-generation-interval ···························································································································· 321
non-stop-routing ····································································································································· 322
nssa (OSPFv3 area view) ······················································································································ 323
ospfv3 ····················································································································································· 324
ospfv3 area ············································································································································ 325
ospfv3 authentication-mode ··················································································································· 325
ospfv3 bfd enable ··································································································································· 326
vi
ospfv3 cost ············································································································································· 327
ospfv3 dr-priority ···································································································································· 328
ospfv3 fast-reroute lfa-backup exclude ·································································································· 328
ospfv3 ipsec-profile ································································································································ 329
ospfv3 mib-binding ································································································································· 329
ospfv3 mtu-ignore ·································································································································· 330
ospfv3 network-type ······························································································································· 331
ospfv3 peer ············································································································································ 332
ospfv3 prefix-suppression ······················································································································ 332
ospfv3 primary-path-detect bfd ·············································································································· 333
ospfv3 timer dead ··································································································································· 334
ospfv3 timer hello ··································································································································· 334
ospfv3 timer poll ····································································································································· 335
ospfv3 timer retransmit ··························································································································· 336
ospfv3 trans-delay ·································································································································· 337
preference ·············································································································································· 337
prefix-suppression ·································································································································· 338
reset ospfv3 event-log ···························································································································· 339
reset ospfv3 process ······························································································································ 339
reset ospfv3 redistribution ······················································································································ 340
reset ospfv3 statistics ····························································································································· 340
router-id ·················································································································································· 341
silent-interface(OSPFv3 view) ················································································································ 341
snmp context-name ································································································································ 342
snmp trap rate-limit ································································································································ 343
snmp-agent trap enable ospfv3·············································································································· 343
spf-schedule-interval ······························································································································ 344
stub (OSPFv3 area view) ······················································································································· 345
stub-router ·············································································································································· 346
transmit-pacing ······································································································································· 347
vlink-peer (OSPFv3 area view) ·············································································································· 348
IPv6 policy-based routing commands ························································ 350
apply next-hop ········································································································································ 350
description ·············································································································································· 350
display ipv6 policy-based-route ·············································································································· 351
display ipv6 policy-based-route interface ······························································································· 352
display ipv6 policy-based-route local ····································································································· 354
display ipv6 policy-based-route setup ···································································································· 355
if-match acl ············································································································································· 356
ipv6 local policy-based-route ·················································································································· 356
ipv6 policy-based-route (interface view) ································································································· 357
ipv6 policy-based-route (system view) ··································································································· 358
reset ipv6 policy-based-route statistics ·································································································· 358
Routing policy commands ·········································································· 360
Common routing policy commands ················································································································ 360
apply cost ··············································································································································· 360
apply cost-type ······································································································································· 360
apply ip-precedence ······························································································································· 361
apply preference ···································································································································· 362
apply prefix-priority ································································································································· 362
apply tag ················································································································································· 363
continue ·················································································································································· 363
display route-policy ································································································································ 364
if-match cost ··········································································································································· 365
if-match interface ···································································································································· 365
if-match route-type ································································································································· 366
if-match tag ············································································································································ 367
route-policy ············································································································································· 367
route-policy-change delay-time ·············································································································· 368
IPv4 routing policy commands ······················································································································· 369
vii
apply fast-reroute ··································································································································· 369
apply ip-address next-hop ······················································································································ 370
display ip prefix-list ································································································································· 370
if-match ip ··············································································································································· 371
ip prefix-list ············································································································································· 372
reset ip prefix-list ···································································································································· 373
IPv6 routing policy commands ······················································································································· 374
apply ipv6 fast-reroute ···························································································································· 374
apply ipv6 next-hop ································································································································ 375
display ipv6 prefix-list ····························································································································· 375
if-match ipv6 ··········································································································································· 376
ipv6 prefix-list ········································································································································· 377
reset ipv6 prefix-list ································································································································ 378
Document conventions and icons ······························································ 380
Conventions ··················································································································································· 380
Network topology icons ·································································································································· 381
Support and other resources ····································································· 382
Accessing Hewlett Packard Enterprise Support····························································································· 382
Accessing updates ········································································································································· 382
Websites ················································································································································ 383
Customer self repair ······························································································································· 383
Remote support ······································································································································ 383
Documentation feedback ······················································································································· 383
Index ·········································································································· 385
1
Basic IP routing commands
address-family ipv4
Use address-family ipv4 to create the RIB IPv4 address family and enter its view, or enter the
view of the existing RIB IPv4 address family.
Use undo address-family ipv4 to delete the RIB IPv4 address family and all settings in the
view.
Syntax
address-family ipv4
undo address-family ipv4
Default
No RIB IPv4 address family exists.
Views
RIB view
Predefined user roles
network-admin
Examples
# Create the RIB IPv4 address family and enter its view.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4]
address-family ipv6
Use address-family ipv6 to create the RIB IPv6 address family and enter its view, or enter the
view of the existing RIB IPv6 address family.
Use undo address-family ipv6 to delete the RIB IPv6 address family and all settings in the
view.
Syntax
address-family ipv6
undo address-family ipv6
Default
No RIB IPv6 address family exists.
Views
RIB view
Predefined user roles
network-admin
Examples
# Create the RIB IPv6 address family and enter its view.
2
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv6
[Sysname-rib-ipv6]
display ip routing-table
Use display ip routing-table to display routing table information.
Syntax
display ip routing-table [ verbose ]
display ip routing-table [ all-routes ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all-routes: Displays routing table information for all active routes.
verbose: Displays detailed routing table information, including information about both active and
inactive routes. If you do not specify this keyword, the command displays only brief information about
active routes.
Usage guidelines
If you do not specify any parameters, the command displays only brief information about all active
routes in the IPv4 routing table.
Examples
# Display brief information about all active routes in the routing table.
<Sysname> display ip routing-table
Destinations : 12 Routes : 12
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/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.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.0/24 Direct 0 0 192.168.1.40 Vlan11
192.168.1.0/32 Direct 0 0 192.168.1.40 Vlan11
192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.255/32 Direct 0 0 192.168.1.40 Vlan11
224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0
224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
# Display brief information about all active routes in the routing table.
3
<Sysname> display ip routing-table all-routes
VPN instance: public instance
Destinations : 10 Routes : 10
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.1.0/24 Static 60 0 192.168.47.4 Vlan11
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0
224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0
224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
Table 1 Command output
Field
Description
VPN instance The routing table belongs to the public network. This field displays public
instance.
Destinations Number of destination addresses.
Routes Number of routes.
Destination/Mask Destination address/mask length.
Proto Protocol that installed the route.
Pre Preference of the route.
Cost Cost of the route.
NextHop Next hop address of the route.
Interface Output interface for packets to be forwarded along the route.
Summary count Number of routes.
# Display detailed information about all routes in the routing table.
<Sysname> display ip routing-table verbose
Destinations : 2 Routes : 2
Destination: 0.0.0.0/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 08h34m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000000 LastAs: 0
4
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1000c OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
Destination: 1.1.1.0/24
Protocol: Static
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 60
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.47.4
Label: NULL RealNextHop: 192.168.47.4
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
Table 2 Command output
Field
Description
Destinations Number of destination addresses.
Routes Number of routes.
Destination Destination address/mask length.
Protocol Protocol that installed the route.
SubProtID ID of the subprotocol for routing.
Age Time for which the route has been in the routing table.
Cost Cost of the route.
Preference Preference of the route.
IpPre IP precedence.
QosLocalID Local QoS ID.
Tag Route tag.
5
Field
Description
State
Route status:
• Active—Active unicast route.
• Adv—Route that can be advertised.
• Inactive—Inactive route.
• NoAdv—Route that the router must not advertise.
• Vrrp—Routes generated by VRRP.
• Nat—Routes generated by NAT.
• TunE—Tunnel. This state is not supported in the current software version.
OrigTblID Original routing table ID.
OrigVrf This field is not supported in the current software version.
Original VPN instance that the route belongs to. This field displays default-vrf if the
route is on the public network.
TableID ID of the routing table.
OrigAs Original AS number.
NibID ID of the next hop.
LastAs Last AS number.
AttrID Attribute ID.
Neighbor Address of the neighbor determined by the routing protocol.
Flags Flags of the route.
OrigNextHop Next hop address of the route.
RealNextHop Real next hop of the route.
BkLabel Backup label.
BkNexthop Backup next hop.
SRLabel Segment routing (SR) label.
BkSRLabel Backup segment routing (SR) label.
Tunnel ID This field is not supported in the current software version.
Tunnel ID.
Interface Output interface for packets to be forwarded along the route.
BkTunnel ID This field is not supported in the current software version.
Backup tunnel ID.
BkInterface Backup output interface.
FtnIndex Index of the FTN entry.
TrafficIndex Traffic index in the range of 1 to 64. This field displays N/A when the value is invalid.
Connector
This field is not supported in the current software version.
BGP connector attribute exchanged between BGP peers along with a VPN IPv4
route. The value of the attribute is the IP address of the remote PE device. The BGP
connector attribute is used for MD VPN. This field displays N/A if the BGP connector
attribute is not supported.
Summary count Number of routes.
PathID This field is not supported in the current software version.
Add-Path ID of the BGP route.
6
display ip routing-table acl
Use display ip routing-table acl to display information about routes permitted by a basic
ACL.
Syntax
display ip routing-table acl ipv4-acl-number [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv4-acl-number: Specifies a basic ACL by its number in the range of 2000 to 2999.
verbose: Displays detailed information about all routes permitted by the basic ACL. If you do not
specify this keyword, the command displays only brief information about active routes permitted by
the basic ACL.
Usage guidelines
If the specified ACL does not exist or has no rules configured, the command displays information
about all routes.
Examples
# Define basic ACL 2000 and set the route filtering rules.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 192.168.1.0 0.0.0.255
[Sysname-acl-ipv4-basic-2000] rule deny source any
# Display brief information about active routes permitted by basic ACL 2000.
[Sysname-acl-ipv4-basic-2000] display ip routing-table acl 2000
Summary count : 4
Destination/Mask Proto Pre Cost NextHop Interface
192.168.1.0/24 Direct 0 0 192.168.1.111 Vlan11
192.168.1.0/32 Direct 0 0 192.168.1.111 Vlan11
192.168.1.111/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.255/32 Direct 0 0 192.168.1.111 Vlan11
For command output, see Table 1.
# Display detailed information about all routes permitted by basic ACL 2000.
<Sysname> display ip routing-table acl 2000 verbose
Summary count : 4
Destination: 192.168.1.0/24
Protocol: Direct
Process ID: 0
7
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x10080 OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
Destination: 192.168.1.0/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
Destination: 192.168.1.111/32
Protocol: Direct
Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000000 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
8
Flags: 0x10004 OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
Destination: 192.168.1.255/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
For command output, see Table 2.
display ip routing-table ip-address
Use display ip routing-table ip-address to display information about routes to a specific
destination address.
Use display ip routing-table ip-address1 to ip-address2 to display information
about routes to a range of destination addresses.
Syntax
display ip routing-table ip-address [ mask-length | mask ] [ longer-match ]
[ verbose ]
display ip routing-table ip-address1 to ip-address2 [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
9
Parameters
ip-address: Specifies a destination IP address in dotted decimal notation.
mask-length: Specifies the mask length, an integer in the range of 0 to 32.
mask: Specifies the IP address mask in dotted decimal notation.
longer-match: Displays the route entry with the longest mask.
ip-address1 to ip-address2: Specifies a destination IP address range.
verbose: Displays detailed routing table information, including information about both active and
inactive routes. If you do not specify this keyword, the command displays brief information about
active routes.
Usage guidelines
Executing the command with different parameters yields different outputs.
•
display ip routing-table ip-address
ï‚¡ The system ANDs the entered destination IP address with the subnet mask in each active
route entry.
ï‚¡ The system ANDs the destination IP address in each active route entry with its own subnet
mask.
If the two operations yield the same result for an entry, the entry is displayed.
•
display ip routing-table ip-address mask
ï‚¡ The system ANDs the entered destination IP address with the entered subnet mask.
ï‚¡ The system ANDs the destination IP address in each active route entry with the entered
subnet mask.
If the two operations yield the same result for an entry with a subnet mask not greater than the
entered subnet mask, the entry is displayed.
•
display ip routing-table ip-address longer-match
ï‚¡ The system ANDs the entered destination IP address with the subnet mask in each active
route entry.
ï‚¡ The system ANDs the destination IP address in each active route entry with its own subnet
mask.
If the two operations yield the same result for multiple entries, the entry with the longest mask
length is displayed.
•
display ip routing-table ip-address mask longer-match
ï‚¡ The system ANDs the entered destination IP address with the entered subnet mask.
ï‚¡ The system ANDs the destination IP address in each active route entry with the entered
subnet mask.
If the two operations yield the same result for multiple entries with a mask not greater than the
entered subnet mask, the entry with the longest mask length is displayed.
•
display ip routing-table ip-address1 to ip-address2
The system displays active route entries with destinations in the range of ip-address1/32 to
ip-address2/32.
Examples
# Display brief information about the routes to the destination IP address 11.0.0.1.
<Sysname> display ip routing-table 11.0.0.1
Summary count : 3
10
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/8 Static 60 0 0.0.0.0 NULL0
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
11.0.0.0/24 Static 60 0 0.0.0.0 NULL0
# Display brief information about the routes to the destination IP address 11.0.0.1 and mask length
20.
<Sysname> display ip routing-table 11.0.0.1 20
Summary count : 2
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/8 Static 60 0 0.0.0.0 NULL0
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
# Display brief information about the most specific route to the destination address 11.0.0.1.
<Sysname> display ip routing-table 11.0.0.1 longer-match
Summary count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/24 Static 60 0 0.0.0.0 NULL0
# Display brief information about the most specific route to the destination IP address 11.0.0.1 and
mask length 20.
<Sysname> display ip routing-table 11.0.0.1 20 longer-match
Summary count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
# Display brief information about the routes to destination addresses in the range of 1.1.1.0 to
5.5.5.0.
<Sysname> display ip routing-table 1.1.1.0 to 5.5.5.0
Summary count : 4
Destination/Mask Proto Pre Cost NextHop Interface
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.1/32 Direct 0 0 127.0.0.1 InLoop0
4.4.4.1/32 Direct 0 0 127.0.0.1 InLoop0
display ip routing-table prefix-list
Use display ip routing-table prefix-list to display routes permitted by an IP prefix list.
Syntax
display ip routing-table prefix-list prefix-list-name [ verbose ]
Views
Any view
11
Predefined user roles
network-admin
network-operator
Parameters
prefix-list-name: Specifies an IP prefix list by its name, a case-sensitive string of 1 to 63
characters.
verbose: Displays detailed information about all routes permitted by the IP prefix list. If you do not
specify this keyword, the command displays brief information about active routes permitted by the IP
prefix list.
Usage guidelines
If the specified IP prefix list does not exist, the command displays information about all routes.
Examples
# Create an IP prefix list named test to permit the route 1.1.1.0/24.
<Sysname> system-view
[Sysname] ip prefix-list test permit 1.1.1.0 24
# Display brief information about the active route permitted by the IP prefix list.
[Sysname] display ip routing-table prefix-list test
Summary count : 1
Destination/Mask Proto Pre Cost NextHop Interface
1.1.1.0/24 Direct 0 0 1.1.1.2 Vlan11
For command output, see Table 1.
# Display detailed information about all routes permitted by the IP prefix list.
[Sysname] display ip routing-table prefix-list test verbose
Summary count : 1
Destination: 1.1.1.0/24
Protocol: Direct
Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 1.1.1.2
Label: NULL RealNextHop: 1.1.1.2
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL BkSRLabel: NULL
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
/