- Table of Contents
-
- 06-Layer 3 - IP Routing Command Reference
- 00-Preface
- 01-Basic IP routing commands
- 02-Static routing commands
- 03-RIP commands
- 04-OSPF commands
- 05-IS-IS commands
- 06-BGP commands
- 07-Policy-based routing commands
- 08-IPv6 static routing commands
- 09-RIPng commands
- 10-OSPFv3 commands
- 11-IPv6 IS-IS commands
- 12-IPv6 policy-based routing commands
- 13-Routing policy commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Basic IP routing commands | 132.23 KB |
display ip routing-table ip-address
display ip routing-table prefix-list
display ip routing-table protocol
display ip routing-table statistics
display ipv6 routing-table acl
display ipv6 routing-table ipv6-address
display ipv6 routing-table prefix-list
display ipv6 routing-table protocol
display ipv6 routing-table statistics
reset ip routing-table statistics protocol
reset ipv6 routing-table statistics protocol
display ip routing-table
Use display ip routing-table to display routing table information.
Syntax
display ip routing-table [ vpn-instance vpn-instance-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays the routing table information for the public network.
verbose: Displays detailed routing table information, including information about both active and inactive routes. Without this keyword, the command displays only brief information about active routes.
Examples
# Display brief information about active routes in the routing table.
<Sysname> display ip routing-table
Destinations : 13 Routes : 13
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 GE3/0/1
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
Field |
Description |
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 : 13 Routes : 13
Destination: 0.0.0.0/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h34m37s
Cost: 0 Preference: 60
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 0x10000000 LastAs: 0
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
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 1.1.1.0/24
Protocol: Static Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 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
Tunnel ID: Invalid Interface: GigabitEthernet3/0/1
BkTunnel ID: Invalid BkInterface: N/A
...
Field |
Description |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination |
Destination address/mask length. |
Protocol |
Protocol that installed the route. |
Process ID |
ID of the process. |
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. |
Tag |
Route tag. |
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. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN that the route belongs to. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NBRID |
Neighbor ID of the route. |
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. |
Interface |
Output interface for packets to be forwarded along the route. |
BkTunnel ID |
Backup tunnel ID. |
BkInterface |
Backup output interface. |
display ip routing-table acl
Use display ip routing-table acl to display information about routes permitted by a specific basic ACL.
Syntax
display ip routing-table [ vpn-instance vpn-instance-name ] acl acl-number [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
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. Without 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 number 2000
[Sysname-acl-basic-2000] rule permit source 192.168.1.0 0.0.0.255
[Sysname-acl-basic-2000] rule deny source any
# Display brief information about active routes permitted by basic ACL 2000.
[Sysname-acl-basic-2000] display ip routing-table acl 2000
Routes Matched by Access control list : 2000
Summary Count : 4
Destination/Mask Proto Pre Cost NextHop Interface
192.168.1.0/24 Direct 0 0 192.168.1.111 GE3/0/1
192.168.1.0/32 Direct 0 0 192.168.1.111 GE3/0/11
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 GE3/0/1
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
Routes Matched by Access control list : 2000
Summary Count : 4
Destination: 192.168.1.0/24
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 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
Tunnel ID: Invalid Interface: GigabitEthernet3/0/1
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.0/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 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
Tunnel ID: Invalid Interface: GigabitEthernet3/0/1
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.111/32
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 0x10000000 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x10004 OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.255/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 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
Tunnel ID: Invalid Interface: GigabitEthernet3/0/1
BkTunnel ID: Invalid BkInterface: N/A
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 [ vpn-instance vpn-instance-name ] ip-address [ mask | mask-length ] [ longer-match ] [ verbose ]
display ip routing-table [ vpn-instance vpn-instance-name ] ip-address1 to ip-address2 [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
ip-address: Specifies a destination IP address in dotted decimal notation.
mask: Specifies the IP address mask in dotted decimal notation.
mask-length: Specifies the mask length, an integer in the range of 0 to 32.
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. Without 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 and the entry has a subnet mask less than or equal to 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 one with 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 and the entries have a mask less than or equal to the entered subnet mask, the one 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
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 : 6
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.0/24 Direct 0 0 3.3.3.1 GE3/0/2
3.3.3.1/32 Direct 0 0 127.0.0.1 InLoop0
4.4.4.0/24 Direct 0 0 4.4.4.1 GE3/0/1
4.4.4.1/32 Direct 0 0 127.0.0.1 InLoop0
For command output, see Table 1.
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 [ vpn-instance vpn-instance-name ] prefix-list prefix-list-name [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
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. Without 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
Routes Matched by 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 GE3/1/2
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
Routes Matched by Prefix list : test
Summary Count : 1
Destination: 1.1.1.0/24
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NBRID: 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
Tunnel ID: Invalid Interface: GigabitEthernet3/0/2
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 2.
display ip routing-table protocol
Use display ip routing-table protocol to display information about routes installed by a protocol.
Syntax
display ip routing-table [ vpn-instance vpn-instance-name ] protocol protocol [ inactive | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
protocol: Specifies a routing protocol. It can be bgp, direct, guard, isis, ospf, rip, or static.
inactive: Displays information about inactive routes. Without this keyword, the command displays information about both active and inactive routes.
verbose: Displays detailed routing table information. Without this keyword, the command displays brief routing information.
Examples
# Display brief information about direct routes.
<Sysname> display ip routing-table protocol direct
Summary Count : 13
Direct Routing Table Status : <Active>
Summary Count : 13
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
2.2.2.0/32 Direct 0 0 2.2.2.1 Vlan2
2.2.2.2/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.255/32 Direct 0 0 2.2.2.1 Vlan2
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.80.0/24 Direct 0 0 192.168.80.10 GE3/0/1
192.168.80.0/32 Direct 0 0 192.168.80.10 GE3/0/1
192.168.80.10/32 Direct 0 0 127.0.0.1 InLoop0
192.168.80.255/32 Direct 0 0 192.168.80.10 GE3/0/1
Direct Routing Table Status : <Inactive>
Summary Count : 0
# Display brief information about static routes.
<Sysname> display ip routing-table protocol static
Summary Count : 2
Static Routing Table Status : <Active>
Summary Count : 0
Static Routing Table Status : <Inactive>
Summary Count : 2
Destination/Mask Proto Pre Cost NextHop Interface
1.2.3.0/24 Static 60 0 1.2.4.5 Vlan10
3.0.0.0/8 Static 60 0 2.2.2.2 GE3/0/1
For command output, see Table 1.
display ip routing-table statistics
Use display ip routing-table statistics to display IPv4 route statistics.
Syntax
display ip routing-table [ vpn-instance vpn-instance-name ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays route statistics for the public network.
Examples
# Display IPv4 route statistics for the public network.
<Sysname> display ip routing-table statistics
Proto route active added deleted
DIRECT 12 12 30 18
STATIC 3 3 5 2
RIP 0 0 0 0
OSPF 0 0 0 0
ISIS 0 0 0 0
BGP 0 0 0 0
Total 15 15 35 20
Table 3 Command output
Field |
Description |
Proto |
Protocol that installed the route. |
route |
Number of routes installed by the protocol. |
active |
Number of active routes. |
added |
Number of routes added to the routing table after the router started up or the routing table was last cleared. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
display ipv6 routing-table
Use display ipv6 routing-table to display IPv6 routing table information.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
verbose: Displays detailed routing table information, including information about both active and inactive routes. With this keyword absent, the command displays only brief information about active routes.
Examples
# Display brief information about active routes in the IPv6 routing table.
<Sysname> display ipv6 routing-table
Destinations : 3 Routes : 3
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: FE80::/10 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Destination: FF00::/8 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Field |
Description |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination |
IPv6 address and prefix of the destination network or host. |
NextHop |
Next hop address of the route. |
Preference |
Preference of the route. |
Interface |
Output interface for packets to be forwarded along the route. |
Protocol |
Protocol that installed the route. |
Cost |
Cost of the route. |
Summary Count |
Number of routes. |
# Display detailed information about all routes in the routing table.
<Sysname> display ipv6 routing-table verbose
Destinations : 3 Routes : 3
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: FE80::/10
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
Destination: FF00::/8
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000001 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10014 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
Field |
Description |
Destination |
IPv6 address and prefix of the destination network or host. |
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. |
Tag |
Tag of the route. |
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. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN that the route belongs to. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NBRID |
Neighbor ID of the route. |
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. |
Interface |
Output interface for packets to be forwarded along the route. |
BkTunnel ID |
Backup tunnel ID. |
BkInterface |
Backup output interface. |
display ipv6 routing-table acl
Use display ipv6 routing-table acl to display routing information permitted by a specific IPv6 basic ACL.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] acl acl6-number [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
acl6-number: Specifies a basic IPv6 ACL by its number in the range of 2000 to 2999.
verbose: Displays detailed information about all routes permitted by the basic IPv6 ACL. Without this keyword, the command displays only brief information about active routes permitted by the basic IPv6 ACL.
Usage guidelines
If the specified IPv6 ACL does not exist or has no rules configured, the command displays information about all IPv6 routes.
Examples
# Display brief information about active routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000
Routes Matched by Access control list : 2000
Summary Count : 3
Destination : ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination : 1:1::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
For command output, see Table 4.
# Display detailed information about all routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000 verbose
Routes Matched by Access control list : 2000
Summary Count : 3
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h57m19s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 1:1::/64
Protocol: Static Process ID: 0
SubProtID: 0x2 Age: 08h57m19s
Cost: 0 Preference: 60
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 5.
display ipv6 routing-table ipv6-address
Use display ipv6 routing-table ipv6-address to display information about routes to an IPv6 destination address.
Use display ipv6 routing-table ipv6-address1 to ipv6-address2 to display information about routes to a range of IPv6 destination addresses.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] ipv6-address [ prefix-length ] [ longer-match ] [ verbose ]
display ipv6 routing-table [ vpn-instance vpn-instance-name ] ipv6-address1 to ipv6-address2 [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
ipv6-address: Specifies a destination IPv6 address.
prefix-length: Specifies the prefix length in the range of 0 to 128.
longer-match: Displays the route entry with the longest prefix.
ipv6-address1 to ipv6-address2: Specifies a destination IPv6 address range.
verbose: Displays detailed routing table information, including information about both active and inactive routes. Without this keyword, the command displays only brief information about active routes.
Usage guidelines
Executing the command with different parameters yields different output:
· display ipv6 routing-table ipv6-address:
¡ The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.
¡ The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.
If the two operations yield the same result for an entry, this entry is displayed.
· display ipv6 routing-table ipv6-address prefix-length:
¡ The system ANDs the entered destination IPv6 address with the entered prefix length.
¡ The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.
If the two operations yield the same result for an entry and the entry has a prefix length less than or equal to the entered prefix length, the entry is displayed.
· display ipv6 routing-table ipv6-address longer-match:
¡ The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.
¡ The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.
If the two operations yield the same result for multiple entries, the one that has the longest prefix length is displayed.
· display ipv6 routing-table ipv6-address prefix-length longer-match:
¡ The system ANDs the entered destination IPv6 address with the entered prefix length.
¡ The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.
If the two operations yield the same result for multiple entries with a prefix length less than or equal to the entered prefix length, the one with the longest prefix length is displayed.
· display ipv6 routing-table ipv6-address1 to ipv6-address2:
The system displays route entries with destinations in the range of ipv6-address1/128 to ipv6-address2/128.
Examples
# Display brief information about the routes to the destination IPv6 address 10::1 127.
<Sysname> display ipv6 routing-table 10::1 127
Summary Count: 3
Destination: 10::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 10::/68 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 10::/120 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
# Display brief information about the most specific route to the destination IPv6 address 10::1 and prefix length 127.
<Sysname> display ipv6 routing-table 10::1 127 longer-match
Summary Count : 1
Destination: 10::/120 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
# Display brief information about the routes to destination addresses in the range of 100:: to 300::.
<Sysname> display ipv6 routing-table 100:: to 300::
Summary Count : 3
Destination: 100::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 200::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 300::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
For command output, see Table 4.
display ipv6 routing-table prefix-list
Use display ipv6 routing-table prefix-list to display information about IPv6 routes permitted by an IPv6 prefix list.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] prefix-list prefix-list-name [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
prefix-list-name: Specifies an IPv6 prefix list by its name, a case-sensitive string of 1 to 63 characters.
verbose: Displays detailed information about all IPv6 routes permitted by the IPv6 prefixt list. Without this keyword, the command displays brief information about active IPv6 routes permitted by the IPv6 prefix list.
Usage guidelines
If the specified IPv6 prefix list does not exist, the command displays information about all routes.
Examples
# Create an IPv6 prefix list named test to permit the prefix ::1/128.
<Sysname> system-view
[Sysname] ipv6 prefix-list test permit ::1 128
# Display brief information about the active IPv6 route permitted by the IPv6 prefix list.
[Sysname] display ipv6 routing-table prefix-list test
Routes Matched by Prefix list : test
Summary Count : 1
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
For command output, see Table 4.
# Display detailed information about all routes permitted by the IPv6 prefix list.
[Sysname] display ipv6 routing-table prefix-list test verbose
Routes Matched by Prefix list : test
Summary Count : 1
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h57m19s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NBRID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 5.
display ipv6 routing-table protocol
Use display ipv6 routing-table protocol to display information about IPv6 routes installed by a protocol.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] protocol protocol [ inactive | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays routing information for the public network.
protocol: Specifies a routing protocol. It can be bgp4+, direct, isisv6, ospfv3, ripng, or static.
inactive: Displays information about inactive routes. Without this keyword, the command displays information about both active and inactive routes.
verbose: Displays detailed routing table information. Without this keyword, the command displays brief routing information.
Examples
# Display brief information about direct routes.
<Sysname> display ipv6 routing-table protocol direct
Summary Count : 3
Direct Routing Table Status : <Active>
Summary Count : 3
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: FE80::/10 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Destination: FF00::/8 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Direct Routing Table Status : <Inactive>
Summary Count : 0
# Display brief information about static routes.
<Sysname> display ipv6 routing-table protocol static
Summary Count : 3
Static Routing table Status : <Active>
Summary Count : 3
Destination: 2::2/128 Protocol : Static
NextHop : fe80::2 Preference: 60
Interface : GE3/0/2 Cost : 0
Destination: 2::2/128 Protocol : Static
NextHop : fe80::3 Preference: 60
Interface : GE3/0/2 Cost : 0
Destination: 3::3/128 Protocol : Static
NextHop : 2::2 Preference: 60
Interface : GE3/0/2 Cost : 0
Static Routing table Status : <Inactive>
Summary Count : 0
For command output, see Table 4.
display ipv6 routing-table statistics
Use display ipv6 routing-table statistics to display IPv6 route statistics.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays route statistics for the public network.
Examples
# Display IPv6 route statistics for the public network.
<Sysname> display ipv6 routing-table statistics
Proto route active added deleted
DIRECT 5 5 5 0
STATIC 3 3 3 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
BGP4+ 0 0 0 0
Total 8 8 8 0
Table 6 Command output
Field |
Description |
Proto |
Protocol that installed the route. |
route |
Number of routes installed by the protocol. |
active |
Number of active routes. |
added |
Number of routes added to the routing table after the router started up or the routing table was last cleared. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
reset ip routing-table statistics protocol
Use reset ip routing-table statistics protocol to clear IPv4 route statistics.
Syntax
reset ip routing-table statistics protocol [ vpn-instance vpn-instance-name ] { protocol | all }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Clears the IPv4 route statistics for an MPLS L3VPN specified by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command clears route statistics for the public network.
protocol: Clears route statistics for a routing protocol. It can be bgp, direct, isis, ospf, rip, or static.
all: Clears route statistics for all IPv4 routing protocols.
Examples
# Clear all IPv4 route statistics for the public network.
<Sysname> reset ip routing-table statistics protocol all
reset ipv6 routing-table statistics protocol
Use reset ipv6 routing-table statistics protocol to clear IPv6 route statistics.
Syntax
reset ipv6 routing-table statistics protocol [ vpn-instance vpn-instance-name ] { protocol | all }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Clears route statistics for an MPLS L3VPN specified by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command clears the route statistics for the public network.
protocol: Clears route statistics for an IPv6 routing protocol. It can be bgp4+, direct, isisv6, ospfv3, ripng, or static.
all: Clears route statistics for all IPv6 routing protocols.
Examples
# Clear all IPv6 route statistics for the public network.
<Sysname> reset ipv6 routing-table statistics protocol all