- 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
- 14-DCN commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Basic IP routing commands | 170.24 KB |
display ip routing-table ip-address
display ip routing-table prefix-list
display ip routing-table protocol
display ip routing-table statistics
display ip routing-table summary
display ipv6 rib graceful-restart
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
display ipv6 routing-table summary
reset ip routing-table statistics protocol
reset ipv6 routing-table statistics protocol
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 configurations 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
mdc-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 configurations 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
mdc-admin
Examples
# Create the RIB IPv6 address family and enter its view.
<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 [ 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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing table information for the public network.
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.
Examples
# Display brief information about 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
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: 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
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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
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
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: 1.2.3.4/32
Protocol: BGP instance default
Process ID: 0
SubProtID: 0x1 Age: 02h38m34s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 200
NibID: 0x16000000 LastAs: 200
AttrID: 0x2 Neighbor: 2.2.3.4
Flags: 0x10060 OrigNextHop: 2.2.3.4
Label: NULL RealNextHop: 2.2.3.4
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
...
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. |
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. · TunE—Tunnel. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN instance that the route belongs to. This field displays default-vrf if the route is on the IPv4 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. |
Interface |
Output interface for packets to be forwarded along the route. |
BkTunnel ID |
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 |
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. |
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 [ vpn-instance vpn-instance-name ] acl ipv4-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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
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-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
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
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
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
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
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
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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
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
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: 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-length | mask ] [ 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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
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
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 detailed information about the routes to the destination IP address 1.2.3.4.
<Sysname> display ip routing-table 1.2.3.4 verbose
Summary count : 1
Destination: 1.2.3.4/32
Protocol: BGP instance test
Process ID: 0
SubProtID: 0x1 Age: 00h00m37s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 200
NibID: 0x15000000 LastAs: 200
AttrID: 0x0 Neighbor: 192.168.47.2
Flags: 0x10060 OrigNextHop: 192.168.47.2
Label: NULL RealNextHop: 192.168.47.2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, 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. 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
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: 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 an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
protocol: Specifies a routing protocol.
inactive: Displays information about inactive routes. If you do not specify this keyword, the command displays information about both active and inactive routes.
verbose: Displays detailed routing table information. If you do not specify this keyword, the command displays brief routing information.
Examples
# Display brief information about direct routes.
<Sysname> display ip routing-table protocol direct
Summary count : 9
Direct Routing Table Status : <Active>
Summary count : 9
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
Direct Routing Table Status : <Inactive>
Summary count : 0
# Display brief information about static routes.
<Sysname> display ip routing-table protocol static
Summary count : 1
Static Routing Table Status : <Active>
Summary count : 0
Static Routing Table Status : <Inactive>
Summary count : 1
Destination/Mask Proto Pre Cost NextHop Interface
1.2.3.0/24 Static 60 0 1.2.4.5 Vlan10
# Display detailed information about BGP routes.
<Sysname> display ip routing-table protocol bgp verbose
Summary count : 1
Destination: 1.1.1.2/32
Protocol: BGP instance default
Process ID: 0
SubProtID: 0x6 Age: 00h03m54s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 200
NibID: 0x16000000 LastAs: 200
AttrID: 0x0 Neighbor: 192.168.47.2
Flags: 0x10060 OrigNextHop: 192.168.47.2
Label: NULL RealNextHop: 192.168.47.2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
For command output, see Table 1.
display ip routing-table statistics
Use display ip routing-table statistics to display IPv4 route statistics, including numbers of total routes, routes installed by the protocol, routes marked as deleted, and active routes.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IPv4 route statistics for the public network.
Examples
# Display IPv4 route statistics for the public network.
<Sysname> display ip routing-table statistics
Total prefixes: 15 Active prefixes: 15
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
IS-IS 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 cleared most recently. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
display ip routing-table summary
Use display ip routing-table summary to display brief routing table information, including maximum number of ECMP routes, maximum number of active routes, and number of remaining active routes.
Syntax
display ip routing-table [ vpn-instance vpn-instance-name ] summary
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays brief routing table information for the public network.
Examples
# Display brief routing table information for the public network.
<Sysname> display ip routing-table summary
Max ECMP: 32
Max Active Route: 262144
Remain Active Route: 262126
# Display brief routing table information for the MPLS L3VPN instance vpn1.
<Sysname> display ip routing-table vpn-instance vpn1 summary
Max ECMP: 32
Max Active Route: 262144
Remain Active Route: 262134
Threshold value of active routes alert: 65100
Field |
Description |
Max ECMP |
Maximum number of ECMP routes supported by the system. |
Max Active Route |
Maximum number of supported routes. |
Remain Active Route |
Number of the remaining inactive routes. |
Threshold value of active routes alert |
Alarm threshold of active routes specified by using the routing-table limit command in a VPN instance: · Threshold value of active routes alert—This field is displayed when the alarm threshold is specified by using the routing-table limit number simply-alert command. When the number of active routes exceeds the alarm threshold, the system logs the event and sends traps but still accepts active routes. · Threshold value percentage of max active routes—This field is displayed when the alarm threshold is specified by using the routing-table limit number warn-threshold command, in the range of 1 to 100 in percentage. When the percentage of active routes exceeds the alarm threshold, the system logs the event and sends traps but still accepts active routes. If the number of active routes reaches the maximum number, no more routes can be added. The percentage of active routes equals the number of active routes divided by the maximum number of active routes supported in a VPN instance, and multiplied by 100. |
display ipv6 rib attribute
Use display ipv6 rib attribute to display route attribute information in the IPv6 RIB.
Syntax
display ipv6 rib attribute [ attribute-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
attribute-id: Specifies a route attribute by its ID, a hexadecimal string in the range of 0 to ffffffff.
Examples
# Display route attribute information in the IPv6 RIB.
<Sysname> display ipv6 rib attribute
Total number of attribute(s): 1
Detailed information of attribute 0x9:
Flag: 0x0
Protocol: BGP4+ instance default
Address family: IPv6
Reference count: 0
Local preference: 0
Ext-communities number: 0
Ext-communities value: N/A
Communities number: 0
Communities value: N/A
AS-path number: 0
AS-path value: N/A
For command output, see Table 9.
display ipv6 rib graceful-restart
Use display ipv6 rib graceful-restart to display IPv6 RIB GR state information.
Syntax
display ipv6 rib graceful-restart
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display IPv6 RIB GR state information.
<Sysname> display ipv6 rib graceful-restart
RIB GR state : Phase2-calculation end
RCOM GR state : Flush end
Protocol GR state:
No. Protocol Lifetime FD State Start/End
--------------------------------------------------
1 DIRECT6 480 29 End No/No
2 STATIC6 480 32 End No/No
3 ISISV6 480 30 End No/No
4 BGP4+ instance default
480 31 End No/No
5 BGP4+ instance ebcdefg
480 32 End No/No
For command output, see Table 10.
display ipv6 rib nib
Use display ipv6 rib nib to display next hop information in the IPv6 RIB.
Syntax
display ipv6 rib nib [ self-originated ] [ nib-id ] [ verbose ]
display ipv6 rib nib protocol protocol [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
self-originated: Displays information about next hops of self-originated routes in the IPv6 RIB.
nib-id: Specifies a NIB by its ID, a hexadecimal string in the range of 0 to ffffffff.
verbose: Displays detailed next hop information in the IPv6 RIB. If you do not specify this keyword, the command displays brief next hop information in the IPv6 RIB.
protocol protocol: Specifies a protocol by its name.
Examples
# Display brief next hop information in the IPv6 RIB.
<Sysname> display ipv6 rib nib
Total number of nexthop(s): 151
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
TopoNthp: Invalid
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
TopoNthp: Invalid
...
# Display detailed next hop information in the IPv6 RIB.
<Sysname> display ipv6 rib nib verbose
Total number of nexthop(s): 151
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
TopoNthp: Invalid
RefCnt: 4 FlushRefCnt: 1
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::
RelyDepth: 0 RealNexthop: ::
Interface: NULL0 LocalAddr: ::
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology:
Weight: 0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
TopoNthp: Invalid
RefCnt: 4 FlushRefCnt: 1
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::1
RelyDepth: 0 RealNexthop: ::1
Interface: InLoop0 LocalAddr: ::1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology:
Weight: 0
NibID: 0x26000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 121::2
IFIndex: 0x112 LocalAddr: ::
TopoNthp: Invalid
Instance: default
NibID: 0x26000002 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 122::2
IFIndex: 0x112 LocalAddr: ::
TopoNthp: Invalid
Instance: abc
...
For command output, see Table 11 and Table 12.
display ipv6 route-direct nib
Use display ipv6 route-direct nib to display next hop information for IPv6 direct routes.
Syntax
display ipv6 route-direct nib [ nib-id ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
nib-id: Specifies a NIB by its ID, a hexadecimal string in the range of 0 to ffffffff.
verbose: Displays detailed next hop information for IPv6 direct routes. If you do not specify this keyword, the command displays brief next hop information for IPv6 direct routes.
Examples
# Display brief next hop information for IPv6 direct routes.
<Sysname> display ipv6 route-direct nib
Total number of nexthop(s): 115
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
TopoNthp: Invalid
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
TopoNthp: Invalid
...
# Display detailed next hop information for IPv6 direct routes.
<Sysname> display ipv6 route-direct nib verbose
Total number of nexthop(s): 115
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
RefCnt: 1 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::
RelyDepth: 0 RealNexthop: ::
Interface: NULL0 LocalAddr: ::
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology:
Weight: 0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
RefCnt: 1 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::1
RelyDepth: 0 RealNexthop: ::1
Interface: InLoop0 LocalAddr: ::1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology:
Weight: 0
...
For command output, see Table 13 and Table 14.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
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.
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 : InLoop0 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 : 6 Routes : 6
Destination: ::1/128
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h23m02s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: 12::/96
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 00h01m47s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000003 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10080 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: 12::1/128
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 00h01m45s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FF::11/128
Protocol: BGP4+ instance default
Process ID: 0
SubProtID: 0x6 Age: 00h00m33s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 200
NibID: 0x26000000 LastAs: 200
AttrID: 0x1 Neighbor: 12::2
Flags: 0x10060 OrigNextHop: 12::2
Label: NULL RealNextHop: 12::2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FE80::/10
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h23m02s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FF00::/8
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h23m02s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: 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. |
IpPre |
IP precedence. |
QosLocalID |
Local QoS ID. |
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. · TunE—Tunnel. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN instance that the route belongs to. This field displays default-vrf if the route is on an IPv6 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. |
Interface |
Output interface for packets to be forwarded along the route. |
BkTunnel ID |
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 |
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 BGP connector attribute is not supported. |
Summary count |
Number of routes. |
display ipv6 routing-table acl
Use display ipv6 routing-table acl to display routing information permitted by an IPv6 basic ACL.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] acl ipv6-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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
ipv6-acl-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. If you do not specify 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
Summary count : 6
Destination : ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: 12::/96 Protocol : Direct
NextHop : :: Preference: 0
Interface : Vlan11 Cost : 0
Destination: 12::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: FF::11/128 Protocol : BGP4+
NextHop : 12::2 Preference: 255
Interface : Vlan11 Cost : 0
Destination: FE80::/10 Protocol : Direct
NextHop : :: Preference: 0
Interface : InLoop0 Cost : 0
Destination: FF00::/8 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
For command output, see Table 5.
# Display detailed information about all routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000 verbose
Summary count : 6
Destination: ::1/128
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h29m12s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: 12::/96
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 00h07m57s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000003 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10080 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: 12::1/128
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 00h07m55s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FF::11/128
Protocol: BGP4+ instance default
Process ID: 0
SubProtID: 0x6 Age: 00h06m43s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 200
NibID: 0x26000000 LastAs: 200
AttrID: 0x1 Neighbor: 12::2
Flags: 0x10060 OrigNextHop: 12::2
Label: NULL RealNextHop: 12::2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FE80::/10
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h29m12s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
Destination: FF00::/8
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 19h29m12s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
For command output, see Table 6.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, 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. If you do not specify 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, the 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 with a prefix length not greater than 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 entry with 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 not greater than the entered prefix length, the entry 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
# Display detailed information about the routes to destination IPv6 addresses 1:2::3:4/128.
<Sysname> display ipv6 routing-table 1:2::3:4 128 verbose
Summary count : 1
Destination: 1:2::3:4/128
Protocol: BGP4+ instance abc
Process ID: 0
SubProtID: 0x1 Age: 00h01m14s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x1 OrigAs: 200
NibID: 0x26000000 LastAs: 200
AttrID: 0x0 Neighbor: 2:2::3:4
Flags: 0x10060 OrigNextHop: 2:2::3:4
Label: NULL RealNextHop: 2:2::3:4
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
For command output, see Table 5.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, 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 prefix list. If you do not specify 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
Summary count : 1
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
For command output, see Table 5.
# Display detailed information about all routes permitted by the IPv6 prefix list.
[Sysname] display ipv6 routing-table prefix-list test verbose
Summary count : 1
Destination: ::1/128
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 08h57m19s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 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
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
For command output, see Table 6.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays routing information for the public network.
protocol: Specifies a routing protocol.
inactive: Displays information about inactive routes. If you do not specify this keyword, the command displays information about both active and inactive routes.
verbose: Displays detailed routing table information. If you do not specify this keyword, the command displays brief routing information.
Examples
# Display brief information about IPv6 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 : InLoop0 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 IPv6 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 : Vlan12 Cost : 0
Destination: 2::2/128 Protocol : Static
NextHop : fe80::3 Preference: 60
Interface : Vlan12 Cost : 0
Destination: 3::3/128 Protocol : Static
NextHop : 2::2 Preference: 60
Interface : Vlan12 Cost : 0
Static Routing table Status : <Inactive>
Summary count : 0
# Display detailed information about IPv6 BGP routes.
<Sysname> display ipv6 routing-table protocol bgp4+ verbose
Summary count : 1
Destination: 22::22/128
Protocol: BGP4+ instance abc
Process ID: 0
SubProtID: 0x6 Age: 00h04m15s
Cost: 0 Preference: 255
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 200
NibID: 0x25000001 LastAs: 200
AttrID: 0x3 Neighbor: 121::2
Flags: 0x10060 OrigNextHop: 121::2
Label: NULL RealNextHop: 121::2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface11
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A
For command output, see Table 5.
display ipv6 routing-table statistics
Use display ipv6 routing-table statistics to display IPv6 route statistics, including numbers of total routes, routes installed by the protocol, and routes marked as deleted.
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 instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays route statistics for the public network.
Examples
# Display IPv6 route statistics for the public network.
<Sysname> display ipv6 routing-table statistics
Total prefixes: 8 Active prefixes: 8
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 7 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 cleared most recently. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
display ipv6 routing-table summary
Use display ipv6 routing-table summary to display brief IPv6 routing table information, including maximum number of ECMP routes, maximum number of active routes, and number of remaining active routes.
Syntax
display ipv6 routing-table [ vpn-instance vpn-instance-name ] summary
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays brief IPv6 routing table information for the public network.
Examples
# Display brief IPv6 routing table information for the public network.
<Sysname> display ipv6 routing-table summary
Max ECMP: 32
Max Active Route: 262144
Remain Active Route: 262126
# Display brief IPv6 routing table information for the MPLS L3VPN instance vpn1.
<Sysname> display ipv6 routing-table vpn-instance vpn1 summary
Max ECMP: 32
Max Active Route: 262144
Remain Active Route: 262134
Threshold value of active routes alert: 65100
For command output, see Table 4.
display max-ecmp-num
Use display max-ecmp-num to display the maximum number of ECMP routes.
Syntax
display max-ecmp-num
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the maximum number of ECMP routes.
<Sysname> display max-ecmp-num
Max-ECMP-Num in use: 6
Max-ECMP-Num at the next reboot: 10
Table 8 Command output
Field |
Description |
Max-ECMP-Num in use |
Maximum number of current ECMP routes in use. |
Max-ECMP-Num at the next reboot |
Maximum number of ECMP routes at the next reboot of the device. |
display rib attribute
Use display rib attribute to display route attribute information in the RIB.
Syntax
display rib attribute [ attribute-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
attribute-id: Specifies a route attribute by its ID, a hexadecimal string in the range of 0 to ffffffff.
Examples
# Display route attribute information in the RIB.
<Sysname> display rib attribute
Total number of attribute(s): 10
Detailed information of attribute 0x0:
Flag: 0x0
Protocol: BGP instance default
Address family: IPv4
Reference count: 0
Local preference: 0
Ext-communities number: 26
Ext-communities value: <RT: 1:1> <RT: 2:2> <RT: 3:3> <RT: 123.123.123.123:65535
> <RT: 1234567890:65535> <RT: 123.123.123.123:65534> <RT
: 4:4> <RT: 5:5> <RT: 6:6> <RT: 7:7> <RT: 8:8> <RT: 9:9>
<RT: 10:10> <RT: 10:1> <RT: 10:11> <RT: 10:12> <RT: 10:
13> <RT: 10:14> <RT: 10:15> <RT: 10:16> ...
Communities number: 0
Communities value: N/A
AS-path number: 0
AS-path value: N/A
Detailed information of attribute 0x1:
Flag: 0x0
Protocol: BGP
Address family: IPv4
Reference count: 0
Local preference: 0
Ext-communities number: 1
Ext-communities value: <RT: 1:2>
Communities number: 0
Communities value: N/A
AS-path number: 0
AS-path value: N/A
Field |
Description |
Protocol |
Protocol that generates the attribute. |
Ext-communities number |
Number of the extended community attribute values. |
Ext-communities value |
Values of the extended community attribute. This field displays N/A when no values exist, and it can display a maximum of 20 values. |
Communities number |
Number of the COMMUNITY attribute values. |
Communities value |
Values of the COMMUNITY attribute. This field displays N/A when no values exist, and it can display a maximum of 20 values. |
AS-path number |
Number of ASs in the AS_PATH attribute. |
AS-path value |
Values of the AS_PATH attribute, including AS_SET, AS_SEQUENCE, confederation AS_SET, and confederation AS_SEQUENCE. This field displays N/A when no values exist, and it can display a maximum of 20 values. |
display rib graceful-restart
Use display rib graceful-restart to display RIB GR state information.
Syntax
display rib graceful-restart
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display RIB GR state information.
<Sysname> display rib graceful-restart
RIB GR state : Phase2-calculation end
RCOM GR state : Flush end
Protocol GR state:
No. Protocol Lifetime FD State Start/End
--------------------------------------------------
1 DIRECT 100 30 End No/No
2 STATIC 480 34 End No/No
3 OSPF 480 36 End No/No
4 ISIS 480 32 End No/No
5 BGP instance abc
480 22 End No/No
6 BGP instance default
480 25 End No/No
7 LDP 480 35 End No/No
8 SLSP 480 29 End No/No
Field |
Description |
RIB GR state |
RIB GR status: · Start—GR starts. · IGP end—All IGP protocols complete GR. · VPN-triggering end—Optimal route selection triggered by VPN routes completes. · VPN-calculation end—Optimal VPN route selection completes. · Routing protocol end—All routing protocols complete GR. · NSR-calculation unfinished—NSR has not finished optimal route selection. · Triggering start—All triggered optimal route selection starts. · Triggering end—All triggered optimal route selection completes. · Phase1-calculation end—Optimal route selection phase 1 completes. · All end—All protocols complete GR. · Phase2-calculation end—Optimal route selection phase 2 completes. |
RCOM GR state |
RCOM GR status: · Start—GR starts. · VPN-calculation end—Optimal VPN route selection completes. · VPN-notification end—VPN routes have been delivered to the route management module. · Routing protocol end—All routing protocols complete GR. · NSR-calculation unfinished—NSR has not finished optimal route selection. · Phase1-calculation end—Optimal route selection phase 1 completes. · Notification end—All routes have been delivered to the route management module. · Phase2-calculation end—Optimal route selection phase 2 completes. · Flush start—Starts to flush routes to the FIB. · Flush end—Completes flushing routes to the FIB. |
No. |
Protocol number. |
Lifetime |
Lifetime (in seconds) of routes/labels in the RIB during GR. |
FD |
Handle between the protocol and the RIB. |
State |
Protocol GR state: · Init—Initialization state. · Listen—Listening state. · Idle. · Active. · Start—GR starts. · End—GR completes. |
Start/End |
Message sending state: · No—The message has not been sent. · Yes—The message has been sent. |
display rib nib
Use display rib nib to display next hop information in the RIB.
Syntax
display rib nib [ self-originated ] [ nib-id ] [ verbose ]
display rib nib protocol protocol [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
self-originated: Displays information about next hops of self-originated routes in the RIB.
nib-id: Specifies a NIB by its ID, a hexadecimal string in the range of 0 to ffffffff.
verbose: Displays detailed next hop information in the RIB. If you do not specify this keyword, the command displays brief next hop information in the RIB.
protocol protocol: Specifies a protocol by its name.
Examples
# Display brief next hop information in the RIB.
<Sysname> display rib nib
Total number of nexthop(s): 176
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
TopoNthp: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
TopoNthp: 0
NibID: 0x10000002 Sequence: 2
Type: 0x5 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
TopoNthp: 0
NibID: 0x16000000 Sequence: 3
Type: 0x21 Flushed: No
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 12.1.1.2
IFIndex: 0x0 LocalAddr: 0.0.0.0
TopoNthp: 0
Instance: abc
Field |
Description |
NibID |
ID of the next hop. |
Sequence |
Sequence number of the next hop. |
Type |
Type of the next hop. |
Flushed |
Indicates whether the route with the next hop has been flushed to the FIB. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
VrfNthp |
Index of the VPN instance that the next hop belongs to. This field displays 0 if the next hop is on the IPv4 public network or an IPv6 network. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
Instance |
BGP instance name. |
SubNibID |
ID of the sub-next hop. |
SubSeq |
Sequence number of the sub-next hop. |
NthpCnt |
Number of sub-next hops. |
Samed |
Number of the same sub-next hops. |
NthpType |
Type of the sub-next hop: · IP—IP forwarding. · MPLS—MPLS forwarding. |
# Display detailed next hop information in the RIB.
<Sysname> display rib nib verbose
Total number of nexthop(s): 176
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
TopoNthp: 0
RefCnt: 6 FlushRefCnt: 2
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 0.0.0.0
RelyDepth: 0 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology: base
Weight: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
TopoNthp: 0
RefCnt: 11 FlushRefCnt: 5
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 127.0.0.1
RelyDepth: 0 RealNexthop: 127.0.0.1
Interface: InLoop0 LocalAddr: 127.0.0.1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology: base
Weight: 0
NibID: 0x15000003 Sequence: 3
Type: 0x43 Flushed: Yes
UserKey0: 0x100010000 VrfNthp: 0
UserKey1: 0x0 Nexthop: 22.22.22.22
IFIndex: 0x0 LocalAddr: 0.0.0.0
TopoNthp: 0
Instance: default
RefCnt: 9 FlushRefCnt: 3
Flag: 0x84 Version: 1
Policy: tnl-policy1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 22.22.22.22
RelyDepth: 1 RealNexthop: 13.1.1.2
Interface: Vlan11 LocalAddr: 13.1.1.1
TunnelCnt: 1 Vrf: default-vrf
TunnelID: 1025 Topology: base
Weight: 0
...
Field |
Description |
Policy |
Tunnel policy name. |
x nexthop (s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
Vrf |
VPN instance name. For the IPv4 public network or an IPv6 network, this field displays default-vrf. |
OrigNexthop |
Original next hop. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
LocalAddr |
Local interface address. |
RelyDepth |
Recursion depth. |
TunnelCnt |
Number of tunnels after route recursion. |
TunnelID |
ID of the tunnel after route recursion. |
Weight |
ECMP route weight. This field displays 0 for non-ECMP routes. |
Instance |
BGP instance name. |
RefCnt |
Reference count of the next hop. |
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
Flag |
Flag of the next hop. |
Version |
Version of the next hop. |
display route-direct nib
Use display route-direct nib to display next hop information for direct routes.
Syntax
display route-direct nib [ nib-id ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
nib-id: Specifies a NIB by its ID, a hexadecimal string in the range of 0 to ffffffff.
verbose: Displays detailed next hop information for direct routes. If you do not specify this keyword, the command displays brief next hop information for direct routes.
Examples
# Display brief next hop information for direct routes.
<Sysname> display route-direct nib
Total number of nexthop(s): 116
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
TopoNthp: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
TopoNthp: 0
...
Field |
Description |
NibID |
ID of the NIB. |
Sequence |
Sequence number of the NIB. |
Type |
Type of the NIB. |
Flushed |
Indicates whether the route with the NIB has been flushed to the FIB. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
VrfNthp |
Index of the VPN instance that the next hop belongs to. This field displays 0 if the next hop is on the IPv4 public network or an IPv6 network. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface IP address. |
# Display detailed next hop information for direct routes.
<Sysname> display route-direct nib verbose
Total number of nexthop(s): 116
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
RefCnt: 2 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 0.0.0.0
RelyDepth: 0 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology: base
Weight: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
RefCnt: 5 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 127.0.0.1
RelyDepth: 0 RealNexthop: 127.0.0.1
Interface: InLoop0 LocalAddr: 127.0.0.1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A Topology: base
Weight: 0
...
Field |
Description |
x nexthop(s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
Vrf |
VPN instance name. For the IPv4 public network or an IPv6 network, this field displays default-vrf. |
OrigNexthop |
Original next hop. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
localAddr |
Local interface address. |
RelyDepth |
Recursion depth. |
TunnelCnt |
Number of tunnels after route recursion. |
TunnelID |
ID of the tunnel after route recursion. |
Weight |
ECMP route weight. This field displays 0 for non-ECMP routes. |
RefCnt |
Reference count of the next hop. |
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
Flag |
Flag of the next hop. |
Version |
Version of the next hop. |
fib lifetime
Use fib lifetime to set the maximum lifetime for IPv4 or IPv6 routes in the FIB.
Use undo fib lifetime to restore the default.
Syntax
fib lifetime seconds
undo fib lifetime
Default
The maximum lifetime for IPv4 or IPv6 routes in the FIB is 600 seconds.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
seconds: Specifies the maximum lifetime for routes in the FIB, in the range of 0 to 6000 seconds. When this argument is set to 0, FIB entries immediately age out after a protocol or RIB process switchover.
Usage guidelines
When a protocol or RIB process switchover occurs and GR or NSR is not configured, FIB entries age out after the time specified in this command.
Examples
# Set the maximum lifetime for IPv4 routes in the FIB to 60 seconds.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] fib lifetime 60
inter-protocol fast-reroute
Use inter-protocol fast-reroute to enable IPv4 or IPv6 RIB inter-protocol FRR.
Use undo inter-protocol fast-reroute to disable IPv4 or IPv6 RIB inter-protocol FRR.
Syntax
inter-protocol fast-reroute [ vpn-instance vpn-instance-name ]
undo inter-protocol fast-reroute [ vpn-instance vpn-instance-name ]
Default
Inter-protocol FRR is disabled.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command enables IPv4 or IPv6 RIB inter-protocol FRR for the public network.
Usage guidelines
This command allows a device to perform fast rerouting between routes of different protocols. A backup next hop is automatically selected to reduce the service interruption time caused by unreachable next hops. When the next hop of the primary link fails, the traffic is redirected to the backup next hop.
This command uses the next hop of a route from a different protocol as the backup next hop for the faulty route, which might cause loops.
Inter-protocol FRR cannot select a backup next hop from routes in the RIB that have the same next hop, output interface, and destination as those of the faulty route.
Examples
# Enable IPv4 RIB inter-protocol FRR for the public network.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] inter-protocol fast-reroute
max-ecmp-num
Use max-ecmp-num to set the maximum number of ECMP routes.
Syntax
max-ecmp-num number
Default
The maximum number of ECMP routes is not set.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Specifies the maximum number of ECMP routes. The value range for this argument is 1 to 32.
Examples
# Set the maximum number of ECMP routes to 10.
<Sysname> system-view
[Sysname] max-ecmp-num 10
The configuration will take effect at the next reboot. Continue? [Y/N]:y
Reboot device to make the configuration take effect.
After reboot, the maximum number of ECMP routes is 10.
non-stop-routing
Use non-stop-routing to enable RIB NSR.
Use undo non-stop-routing to disable RIB NSR.
Syntax
non-stop-routing
undo non-stop-routing
Default
RIB NSR is disabled.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
mdc-admin
Examples
# Enable NSR for the RIB IPv4 address family.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] non-stop-routing
protocol lifetime
Use protocol lifetime to set the maximum lifetime for IPv4 or IPv6 routes and labels in the RIB.
Use undo protocol lifetime to restore the default.
Syntax
protocol protocol [ instance instance-name ] lifetime seconds
undo protocol protocol [ instance instance-name ] lifetime
Default
The maximum lifetime for IPv4 or IPv6 routes and labels in the RIB is 480 seconds.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
protocol: Specifies a routing protocol.
seconds: Specifies the maximum lifetime for routes and labels in the RIB, in the range of 1 to 6000 seconds.
instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. This argument applies only to the BGP protocol. If you do not specify a BGP instance, this command sets the maximum lifetime for all BGP routes and labels in the RIB.
Usage guidelines
When GR is enabled, make sure the protocol can complete GR and install all route entries to the RIB within the lifetime configured in this command.
Examples
# Set the maximum lifetime for RIP routes and labels in the RIB to 60 seconds.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] protocol rip lifetime 60
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: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears IPv4 route statistics for the public network.
protocol: Clears route statistics for a routing protocol.
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: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears the IPv6 route statistics for the public network.
protocol: Clears route statistics for an IPv6 routing protocol.
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
rib
Use rib to enter RIB view.
Use undo rib to remove all configurations in RIB view.
Syntax
rib
undo rib
Views
System view
Predefined user roles
network-admin
mdc-admin
Examples
# Enter RIB view.
<Sysname> system-view
[Sysname] rib
[Sysname-rib]