- Table of Contents
-
- 04-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 policy-based routing commands
- 12-Routing policy commands
- 13-DCN commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Basic IP routing commands | 370.37 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
nexthop recursive-lookup restrain clear-interval
nexthop recursive-lookup restrain disable
protocol nexthop recursive-lookup
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
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
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 ecmp mode
Use display ecmp mode to display the ECMP mode.
Syntax
display ecmp mode
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the ECMP mode.
<Sysname> display ecmp mode
ECMP-Mode in use: Default
ECMP-Mode at the next reboot: Enhanced
Table 1 Command output
Field |
Description |
ECMP-Mode in use |
The current ECMP mode: · Default—Normal mode. · Enhanced—Enhanced mode. |
ECMP-Mode at the next reboot |
ECMP mode used at the next startup: · Default—Normal mode. · Enhanced—Enhanced mode. |
Related commands
ecmp mode enhanced
display ip routing-table
Use display ip routing-table to display routing table information.
Syntax
display ip routing-table [ verbose ]
display ip routing-table [ all-vpn-instance | vpn-instance vpn-instance-name ] [ verbose ]
display ip routing-table [ all-routes ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all-vpn-instance: Displays routing table information for all VPN instances.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
all-routes: Displays routing table information for the public network and all VPN instances.
verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.
Usage guidelines
If you do not specify any parameters, this command displays routing table information for the public network.
Examples
# Display brief information about active routes in the routing table.
<Sysname> display ip routing-table
Destinations : 10 Routes : 10
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.1.0/24 Static 60 0 192.168.47.4 Vlan12
192.168.47.4 Vlan13
1.1.2.0/24 UNR 65 0 0.0.0.0 NULL0
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
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
# Display brief information about active routes in the routing table for the public network and all VPN instances.
<Sysname> display ip routing-table all-routes
VPN instance: public instance
Destinations : 8 Routes : 8
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 Vlan12
192.168.47.4 Vlan13
1.1.1.0/24 Static 60 0 192.168.47.4 Vlan11
1.1.2.0/24 UNR 65 0 0.0.0.0 NULL0
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
VPN instance: vpn1
Destinations : 8 Routes : 8
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.2.0/24 Static 60 0 2.2.1.1 Vlan11
1.1.3.0/24 UNR 65 0 0.0.0.0 NULL0
3.3.1.0/24 BGP 255 0 55.1.1.2 Vlan12
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
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
# Display routing table information for all VPN instances.
<Sysname> display ip routing-table all-vpn-instance
VPN instance: vpn1
Destinations : 8 Routes : 8
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.2.0/24 Static 60 0 2.2.1.1 Vlan11
1.1.3.0/24 UNR 65 0 0.0.0.0 NULL0
3.3.1.0/24 BGP 255 0 55.1.1.2 Vlan12
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
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
VPN instance: vpn2
Destinations : 7 Routes : 7
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.3.0/24 Static 60 0 3.3.1.1 Vlan13
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
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
Field |
Description |
VPN instance |
Public network or VPN instance to which the routing table belongs. For the public network, this filed displays public instance. For a VPN instance, this field displays the name of the instance. |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination/Mask |
Destination address/mask length. |
Proto |
Route type or protocol that installed the route: · Direct—Direct route. · Static—Static route. · UNR—User network route. · RIP—RIP installed the route. · O_INTRA—OSPF intra-area route. · O_ASE2—OSPF Type-2 external route. · IS_L1—Level-1 IS-IS IPv4 route. · IS_L2—Level-2 IS-IS IPv4 route. · BGP—BGP installed the route. · LISP—LISP installed the route. This protocol is not supported in the current software version. |
Pre |
Preference of the route. |
Cost |
Cost of the route. |
NextHop |
Next hop address of the route. |
Interface |
Output interface for packets to be forwarded along the route. |
Summary count |
Number of routes. |
# Display detailed information about all routes in the routing table.
<Sysname> display ip routing-table verbose
Destinations : 2 Routes : 2
Destination: 0.0.0.0/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 08h34m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000000 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1000c OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
Destination: 1.1.1.0/24
Protocol: Static
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 60
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.47.4
Label: NULL RealNextHop: 192.168.47.4
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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 Derived
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: 125.2.1.1
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface12
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface12
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
# Display detailed routing table information for all VPN instances.
<Sysname> display ip routing-table all-vpn-instance verbose
VPN instance: vpn1
Destinations : 1 Routes : 1
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: vpn1
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
SRLabel: NULL IPInterface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
VPN instance: vpn2
Destinations : 1 Routes : 1
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: vpn2
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.47.4
Label: NULL RealNextHop: 192.168.47.4
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface1
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
Field |
Description |
VPN instance |
Public network or VPN instance to which the routing table belongs. For the public network, this filed displays public instance. For a VPN instance, this field displays the name of the instance. |
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 is not allowed to advertise. · Vrrp—Routes generated by VRRP. · TunE—Tunnel. · Derived—Derived route. If a route recurses to multiple related routes, all related routes except the first one are derived routes. The number of derived routes is not included in the total number of routes. · Backup—Backup route. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN instance to which the route belongs. This field displays default-vrf if the route is on the public network. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NibID |
ID of the next hop. |
LastAs |
Last AS number. |
AttrID |
Attribute ID. |
Neighbor |
Address of the neighbor determined by the routing protocol. |
Flags |
Flags of the route. |
OrigNextHop |
Next hop address of the route. |
RealNextHop |
Real next hop of the route. |
BkLabel |
Backup label. |
BkNexthop |
Backup next hop. |
SRLabel |
Segment routing (SR) label. |
Interface |
Output interface for packets to be forwarded along the route. |
BkSRLabel |
Backup segment routing (SR) label. |
BkInterface |
Backup output interface. |
Tunnel ID |
Tunnel ID. |
IPInterface |
IP output interface. |
BkTunnel ID |
Backup tunnel ID. |
BkIPInterface |
Backup IP output interface. |
InLabel |
Incoming label of the route. |
ColorInterface |
Output interface recursed by an SR policy. |
SIDIndex |
SID index value. |
BkColorInterface |
Backup output interface recursed by an SR policy. |
FtnIndex |
Index of the FTN entry. |
TunnelInterface |
Output tunnel interface. |
TrafficIndex |
Traffic index in the range of 1 to 64. This field displays N/A when the value is invalid. |
BkTunnelInterface |
Backup output tunnel interface. |
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. |
PathID |
Path ID. |
UserID |
Access user ID. |
SRTunnelID |
SR tunnel ID. |
SID Type |
This field is not supported in the current software version. SID type. If the route does not have an SID, this field displays N/A. |
NID |
Index of the Next Hop Label Forwarding Entry (NHLFE) flushed by the routing protocol. |
FlushNID |
Index of the NHLFE flushed to the FIB. |
BkNID |
Index of the backup NHLFE flushed by the routing protocol. |
BkFlushNID |
Index of the backup NHLFE flushed to the FIB. |
display ip routing-table acl
Use display ip routing-table acl to display information about routes permitted by a basic ACL.
Syntax
display ip routing-table acl ipv4-acl-number [ verbose ]
display ip routing-table [ vpn-instance vpn-instance-name ] acl ipv4-acl-number [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-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-ipv4-basic-2000] display ip routing-table acl 2000
Summary count : 4
Destination/Mask Proto Pre Cost NextHop Interface
192.168.1.0/24 Direct 0 0 192.168.1.111 Vlan11
192.168.1.0/32 Direct 0 0 192.168.1.111 Vlan11
192.168.1.111/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.255/32 Direct 0 0 192.168.1.111 Vlan11
For descriptions about the command output, see Table 2.
# 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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
Destination: 192.168.1.0/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
Destination: 192.168.1.255/32
Protocol: Direct
Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 3.
display ip routing-table ip-address
Use display ip routing-table ip-address to display information about routes to a specific destination address.
Use display ip routing-table ip-address1 to ip-address2 to display information about routes to a range of destination addresses.
Syntax
display ip routing-table ip-address [ mask-length | mask ] [ longer-match ] [ verbose ]
display ip routing-table [ vpn-instance vpn-instance-name ] ip-address [ mask-length | mask ] [ longer-match ] [ verbose ]
display ip routing-table ip-address1 to ip-address2 [ 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
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 entries that meet the matching rules as described in the usage guidelines.
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 the following way:
- If the entered IP address belongs to class A, B, or C, the system ANDs it with the default subnet mask of the corresponding class.
- If the entered IP address is 0.0.0.0, the system ANDs it with the subnet mask 0.0.0.0.
- Except the previous cases, for example, if the entered IP address is a multicast address or loopback address, the system ANDs it with the subnet mask 255.255.255.255.
¡ The system ANDs the destination IP address in each active route entry with the subnet mask of the entered IP address.
If the two operations yield the same result for multiple entries, all the entries are 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, all the entries are 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 with 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 routes to the destination IP address 11.0.0.1 with the default mask length for class A networks.
<Sysname> display ip routing-table 11.0.0.1 longer-match
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 with mask length 20.
<Sysname> display ip routing-table 11.0.0.1 20 longer-match
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 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
For descriptions about the command output, see Table 2.
# 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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 3.
display ip routing-table prefix-list
Use display ip routing-table prefix-list to display routes permitted by an IP prefix list.
Syntax
display ip routing-table prefix-list prefix-list-name [ verbose ]
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
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 descriptions about the command output, see Table 2.
# Display detailed information about all routes permitted by the IP prefix list.
[Sysname] display ip routing-table prefix-list test verbose
Summary count : 1
Destination: 1.1.1.0/24
Protocol: Direct
Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
IpPre: N/A QosLocalID: N/A
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 1.1.1.2
Label: NULL RealNextHop: 1.1.1.2
BkLabel: NULL BkNextHop: N/A
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 3.
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 protocol protocol [ inactive | verbose ]
display ip routing-table [ vpn-instance vpn-instance-name ] protocol protocol [ inactive | verbose ]
Views
Any view
Predefined user roles
network-admin
network-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
For descriptions about the command output, see Table 2.
# 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
For descriptions about the command output, see Table 2.
# 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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 3.
display ip routing-table statistics
Use display ip routing-table statistics to display IPv4 route or route prefix statistics.
Syntax
display ip routing-table [ prefix ] statistics
display ip routing-table [ all-routes | all-vpn-instance | vpn-instance vpn-instance-name ] [ prefix ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all-routes: Specifies the public network and all VPN instances.
all-vpn-instance: Specifies all VPN instances.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
prefix: Displays IPv4 route prefix statistics. If you do not specify this keyword, the command displays IPv4 route statistics.
Usage guidelines
If you do not specify any parameters, this 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 Routes Active Added Deleted
DIRECT 12 12 30 18
STATIC 3 3 5 2
UNR 0 0 0 0
RIP 0 0 0 0
OSPF 0 0 0 0
IS-IS 0 0 0 0
LISP 0 0 0 0
EIGRP 0 0 0 0
BGP 0 0 0 0
Total 15 15 35 20
# Display IPv4 route statistics for the public network and all VPN instances.
<Sysname> display ip routing-table all-routes statistics
Total prefixes: 11 Active prefixes: 11
Proto Routes Active Added Deleted
DIRECT 8 8 8 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIP 0 0 0 0
OSPF 0 0 0 0
IS-IS 0 0 0 0
LISP 0 0 0 0
EIGRP 0 0 0 0
BGP 0 0 0 0
Total 11 11 13 2
# Display IPv4 route statistics for VPN instance vpn1.
<Sysname> display ip routing-table vpn-instance vpn1 statistics
Total prefixes: 11 Active prefixes: 11
Proto Routes Active Added Deleted
DIRECT 8 8 8 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIP 0 0 0 0
OSPF 0 0 0 0
IS-IS 0 0 0 0
LISP 0 0 0 0
EIGRP 0 0 0 0
BGP 0 0 0 0
Total 11 11 13 2
# Display IPv4 route statistics for all VPN instances.
<Sysname> display ip routing-table all-vpn-instance statistics
Total prefixes: 11 Active prefixes: 11
Proto Routes Active Added Deleted
DIRECT 8 8 8 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIP 0 0 0 0
OSPF 0 0 0 0
IS-IS 0 0 0 0
LISP 0 0 0 0
EIGRP 0 0 0 0
BGP 0 0 0 0
Total 11 11 13 2
# Display IPv4 route prefix statistics for the public network.
<Sysname> display ip routing-table prefix statistics
Proto Prefixes Active Added Deleted
DIRECT 7 7 7 0
STATIC 0 0 0 0
UNR 0 0 0 0
RIP 1 0 1 0
OSPF 0 0 0 0
IS-IS 0 0 0 0
LISP 0 0 0 0
EIGRP 0 0 0 0
SRv6 0 0 0 0
BGP 0 0 0 0
Total 8 7 8 0
Table 4 Command output
Field |
Description |
Proto |
Protocol that installed the route or route prefix. |
Routes |
Number of routes installed by the protocol. |
Prefixes |
Number of route prefixes installed by the protocol. |
Active |
Number of active routes or route prefixes. |
Added |
Number of routes or route prefixes added to the routing table after the router started up or the routing table was cleared most recently. |
Deleted |
Number of routes or route prefixes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes or route prefixes. |
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 summary
display ip routing-table [ vpn-instance vpn-instance-name ] summary
Views
Any view
Predefined user roles
network-admin
network-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 percentage of max active routes: 100%
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 xxx |
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
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
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 DIRECT 900 29 End No/No
2 STATIC 900 32 End No/No
3 ISISV6 900 30 End No/No
4 BGP4+ instance default
900 31 End No/No
5 BGP4+ instance ebcdefg
900 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
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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
...
# 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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
...
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
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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
...
# 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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: Invalid ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 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 [ all-vpn-instance | vpn-instance vpn-instance-name ] [ verbose ]
display ipv6 routing-table [ all-routes ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all-vpn-instance: Displays IPv6 routing table information for all VPN instances.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
all-routes: Displays IPv6 routing table information for the public network and all VPN instances.
verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.
Usage guidelines
If you do not specify any parameters, this command displays IPv6 routing table information for the public network.
Examples
# Display brief information about active routes in the IPv6 routing table.
<Sysname> display ipv6 routing-table
Destinations : 2 Routes : 2
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
# Display brief information about active routes in the IPv6 routing table for the public network and all VPN instances.
<Sysname> display ipv6 routing-table all-routes
VPN instance: public instance
Destinations : 2 Routes : 2
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
VPN instance: vpn1
Destinations : 2 Routes : 2
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: 1:2::3:4/128 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
# Display brief IPv6 routing table information for all VPN instances.
<Sysname> display ipv6 routing-table all-vpn-instance
VPN instance: vpn1
Destinations : 2 Routes : 2
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: 1:2::3:4/128 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
VPN instance: vpn2
Destinations : 1 Routes : 1
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Field |
Description |
VPN instance |
Public network and VPN instance to which the IPv6 routing table belongs. For the public network, this filed displays public instance. For a VPN instance, this command displays the name of the instance. |
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 : 2 Routes : 2
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
# Display detailed IPv6 routing table information for all VPN instances.
<Sysname> display ipv6 routing-table all-vpn-instance verbose
VPN instance: vpn1
Destinations : 2 Routes : 2
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
Field |
Description |
VPN instance |
Public network and VPN instance to which the IPv6 routing table belongs. For the public network, this filed displays public instance. For a VPN instance, this command displays the name of the instance. |
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 is not allowed to advertise. · Vrrp—Routes generated by VRRP. · TunE—Tunnel. |
OrigTblID |
Original routing table ID. |
OrigVrf |
Original VPN instance to which the route belongs. This field displays default-vrf if the route is on the public network. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NibID |
ID of the next hop. |
LastAs |
Last AS number. |
AttrID |
Attribute ID. |
Neighbor |
Address of the neighbor determined by the routing protocol. |
Flags |
Flags of the route. |
OrigNextHop |
Next hop address of the route. |
RealNextHop |
Real next hop of the route. |
BkLabel |
Backup label. |
BkNexthop |
Backup next hop. |
SRLabel |
SR label. |
Interface |
Output interface for packets to be forwarded along the route. |
BkSRLabel |
Backup SR label. |
BkInterface |
Backup output interface. |
Tunnel ID |
Tunnel ID. |
IPInterface |
IP output interface for packets to be forwarded along the route. |
BkTunnel ID |
Backup tunnel ID. |
BkIPInterface |
Backup IP output interface. |
InLabel |
Incoming label of the route. |
ColorInterface |
Output interface recursed by an SR policy. |
SIDIndex |
SID index value. |
BkColorInterface |
Backup output interface recursed by an SR policy. |
FtnIndex |
Index of the FTN entry. |
TunnelInterface |
Output tunnel interface. |
TrafficIndex |
Traffic index in the range of 1 to 64. This field displays N/A when the value is invalid. |
BkTunnelInterface |
Backup output tunnel interface. |
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. |
PathID |
Path ID. |
Summary count |
Number of routes. |
UserID |
Access user ID. |
SRTunnelID |
This field is not supported in the current software version. SR tunnel ID. |
SID Type |
This field is not supported in the current software version. SID type. If the route does not have an SID, this field displays N/A. |
NID |
Index of the Next Hop Label Forwarding Entry (NHLFE) flushed by the routing protocol. |
FlushNID |
Index of the NHLFE flushed to the FIB. |
BkNID |
Index of the backup NHLFE flushed by the routing protocol. |
BkFlushNID |
Index of the backup NHLFE flushed to the FIB. |
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
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 : 5
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
For descriptions about the command output, see Table 6.
# Display detailed information about all routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000 verbose
Summary count : 5
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
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
SRLabel: NULL Interface: InLoopBack0
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: InLoopBack0
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 7.
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
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 entries that meet the matching rules as described in the usage guidelines.
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
If you do not specify the prefix-length argument, the command yields the same result as the display ipv6 routing-table command.
· 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, all the entries are 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 routes to the destination IPv6 address 10::1 with prefix length 127.
<Sysname> display ipv6 routing-table 10::1 127 longer-match
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 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 descriptions about the command output, see Table 6.
# 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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 7.
Related commands
display ipv6 routing-table
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
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 descriptions about the command output, see Table 6.
# 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
SRLabel: NULL BkSRLabel: NULL
SIDIndex: NULL InLabel: NULL
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
FtnIndex: 0x0 TrafficIndex: N/A
Connector: N/A PathID: 0x0
For descriptions about the command output, see Table 7.
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
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 : 2
Direct Routing table status : <Active>
Summary count : 2
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
Direct Routing table status : <Inactive>
Summary count : 0
For descriptions about the command output, see Table 6.
# 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
For descriptions about the command output, see Table 6.
# 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
SRLabel: NULL Interface: Vlan-interface11
BkSRLabel: NULL BkInterface: N/A
Tunnel ID: Invalid IPInterface: Vlan-interface11
BkTunnel ID: Invalid BkIPInterface: N/A
InLabel: NULL ColorInterface: N/A
SIDIndex: NULL BkColorInterface: N/A
FtnIndex: 0x0 TunnelInterface: N/A
TrafficIndex: N/A BkTunnelInterface: N/A
Connector: N/A PathID: 0x0
UserID: 0x0 SRTunnelID: Invalid
SID Type: N/A NID: Invalid
FlushNID: Invalid BkNID: Invalid
BkFlushNID: Invalid
For descriptions about the command output, see Table 7.
display ipv6 routing-table statistics
Use display ipv6 routing-table statistics to display IPv6 route or route prefix statistics.
Syntax
display ipv6 routing-table [ all-routes | all-vpn-instance | vpn-instance vpn-instance-name ] [ prefix ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all-routes: Specifies the public network and all VPN instances.
all-vpn-instance: Specifies all VPN instances.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
prefix: Displays IPv6 route prefix statistics. If you do not specify this keyword, the command displays IPv6 route statistics.
Usage guidelines
If you do not specify any parameters, this command displays IPv6 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 Routes Active Added Deleted
DIRECT 5 5 5 0
STATIC 3 3 3 0
UNR 0 0 0 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
LISP 0 0 0 0
SRv6 0 0 0 0
BGP4+ 0 0 0 0
Total 8 8 8 0
# Display IPv6 route statistics for the public network and all VPN instances.
<Sysname> display ipv6 routing-table all-routes statistics
Total prefixes: 6 Active prefixes: 6
Proto Routes Active Added Deleted
DIRECT 3 3 3 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
LISP 0 0 0 0
SRv6 0 0 0 0
BGP4+ 0 0 0 0
Total 6 6 8 2
# Display IPv6 route statistics for VPN instance vpn1.
<Sysname> display ipv6 routing-table vpn-instance vpn1 statistics
Total prefixes: 11 Active prefixes: 11
Proto Routes Active Added Deleted
DIRECT 8 8 8 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
LISP 0 0 0 0
SRv6 0 0 0 0
BGP4+ 0 0 0 0
Total 11 11 13 2
# Display IPv6 route statistics for all VPN instances.
<Sysname> display ipv6 routing-table all-vpn-instance statistics
Total prefixes: 11 Active prefixes: 11
Proto Routes Active Added Deleted
DIRECT 8 8 8 0
STATIC 3 3 5 2
UNR 0 0 0 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
LISP 0 0 0 0
SRv6 0 0 0 0
BGP4+ 0 0 0 0
Total 11 11 13 2
# Display IPv6 route prefix statistics for the public network.
<Sysname> display ipv6 routing-table prefix statistics
Proto Prefixes Active Added Deleted
DIRECT 5 5 5 0
STATIC 1 1 1 0
UNR 0 0 0 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
LISP 0 0 0 0
SRv6 0 0 0 0
BGP4+ 0 0 0 0
Total 6 6 6 0
Table 8 Command output
Field |
Description |
Proto |
Protocol that installed the route or route prefix. |
Routes |
Number of routes installed by the protocol. |
Prefixes |
Number of route prefixes installed by the protocol. |
Active |
Number of active routes or route prefixes. |
Added |
Number of routes or route prefixes added to the routing table after the router started up or the routing table was cleared most recently. |
Deleted |
Number of routes or route prefixes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes or route prefixes. |
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
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
For descriptions about the command output, see Table 5.
# 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 descriptions about the command output, see Table 5.
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
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
Act-RT reference count: 0
Flush flag: 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
SFlow AS-path length: 0
SFlow AS-path value: N/A
Detailed information of attribute 0x1:
Flag: 0x0
Protocol: BGP
Address family: IPv4
Reference count: 0
Act-RT reference count: 0
Flush flag: 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
SFlow AS-path value: N/A
Field |
Description |
Protocol |
Protocol that generates the attribute. |
Act-RT reference count |
Reference count of active routes. |
Flush flag |
Flag of flushing route attribute information to the FIB: · 0—The route attribute information is not flushed to the FIB. · 1—The route attribute information is flushed to the FIB. |
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. |
SFlow AS-path length |
Length of the sFlow AS-path attribute. |
SFlow AS-path value |
Value of the sFlow AS-path attribute. This field displays N/A if the length of the sFlow AS-path attribute is 0. This field can display a maximum of 80 characters. |
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
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 900 30 End No/No
2 STATIC 900 34 End No/No
3 OSPF 900 36 End No/No
4 ISIS 900 32 End No/No
5 BGP instance abc
900 22 End No/No
6 BGP instance default
900 25 End No/No
7 LDP 900 35 End No/No
8 SLSP 900 29 End No/No
9 UNR instance UCM
900 33 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
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.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all next hops in the RIB.
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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x10000002 Sequence: 2
Type: 0x5 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x16000000 Sequence: 3
Type: 0x21 Flushed: No
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 12.1.1.2
IFIndex: 0x0 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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. |
Age |
Elapsed time since the next hop information was last updated. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
VrfNthp |
Index of the VPN instance to which the next hop belongs. This field displays 0 if the next hop is on the public network. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
NewUK0 |
New reserved data 1. |
NewUK1 |
New reserved data 2. |
NewUK2 |
New reserved data 3. |
NewUK3 |
New reserved data 4. |
NewUK4 |
New reserved data 5. |
NewUK5 |
New reserved data 6. |
NewUK6 |
New reserved data 7. |
NewUK7 |
New reserved data 8. |
TopoNthp |
Index of the topology that contains the next hop. This field displays 0 if the next hop is on the IPv4 public network. This field displays Invalid if the next hop is on an IPv6 network, because the router does not support non-base topologies. |
ExtType |
Extension type of the next hop. |
Color |
Color extended community attribute. |
COFlag |
Flag of the color extended community attribute. |
SIDIndex |
SID index value. |
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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
NibID: 0x15000003 Sequence: 3
Type: 0x43 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x100010000 VrfNthp: 0
UserKey1: 0x0 Nexthop: 22.22.22.22
IFIndex: 0x0 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
...
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. |
Age |
Elapsed time since the next hop information was last updated. |
UserKey0 |
Reserved data 1. |
VrfNthp |
Index of the VPN instance that the next hop belongs to. This field displays 0 if the next hop is on the public network. |
UserKey1 |
Reserved data 2. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
NewUK0 |
New reserved data 1. |
NewUK1 |
New reserved data 2. |
NewUK2 |
New reserved data 3. |
NewUK3 |
New reserved data 4. |
NewUK4 |
New reserved data 5. |
NewUK5 |
New reserved data 6. |
NewUK6 |
New reserved data 7. |
NewUK7 |
New reserved data 8. |
TopoNthp |
Index of the topology that contains the next hop. This field displays 0 if the next hop is on the IPv4 public network. This field displays Invalid if the next hop is on an IPv6 network, because the router does not support non-base topologies. |
ExtType |
Extension type of the next hop. |
Color |
Color extended community attribute. |
COFlag |
Flag of the color extended community attribute. |
SIDIndex |
SID index value. |
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. |
Policy |
Tunnel policy name. |
x nexthop (s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
OrigNexthop |
Original next hop. |
RelyDepth |
Recursion depth. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
LocalAddr |
Local interface address. |
TunnelCnt |
Number of tunnels after route recursion. |
Vrf |
VPN instance name. For the public network, this field displays default-vrf. |
TunnelID |
ID of the tunnel after route recursion. |
Topology |
Topology name. The topology name for the IPv4 public network is base. This field is blank for IPv6, because IPv6 does not support non-base topologies. |
Weight |
ECMP route weight. This field displays 0 for non-ECMP routes. |
Flags |
Flags of the detailed next hop. |
SRPolicyNID |
NIB ID of the route obtained from an SR-TE policy through route recursion. |
SRInterface |
Output interface of the route obtained from the SR-TE policy through route recursion. |
ColorWeight |
Weight value of the color attribute in the SR-TE policy. |
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
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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
...
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. |
Age |
Elapsed time since the next hop information was last updated. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
VrfNthp |
Index of the VPN instance to which the next hop belongs. This field displays 0 if the next hop is on the public network. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface IP address. |
NewUK0 |
New reserved data 1. |
NewUK1 |
New reserved data 2. |
NewUK2 |
New reserved data 3. |
NewUK3 |
New reserved data 4. |
NewUK4 |
New reserved data 5. |
NewUK5 |
New reserved data 6. |
NewUK6 |
New reserved data 7. |
NewUK7 |
New reserved data 8. |
TopoNthp |
Index of the topology that contains the next hop. This field displays 0 if the next hop is on the IPv4 public network. This field displays Invalid if the next hop is on an IPv6 network, because the router does not support non-base topologies. |
ExtType |
Extension type of the next hop. |
Color |
Color extended community attribute. |
COFlag |
Flag of the color extended community attribute. |
SIDIndex |
SID index value. |
# 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
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
Age: 06h26m24s
UserKey0: 0x0 VrfNthp: 0
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NewUK0: 0x0 NewUK1: 0x0
NewUK2: 0x0 NewUK3: 0x0
NewUK4: 0x0 NewUK5: 0x0
NewUK6: 0x0 NewUK7: 0x0
TopoNthp: 0 ExtType: 0x0
Color: 0 COFlag: 0x0
SIDIndex: 0x0
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 Flags: 0x0
SRPolicyNID: 4294967295 SRInterface:
ColorWeight: 0
...
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. |
Age |
Elapsed time since the next hop information was last updated. |
UserKey0 |
Reserved data 1. |
VrfNthp |
Index of the VPN instance to which the next hop belongs. This field displays 0 if the next hop is on the public network. |
UserKey1 |
Reserved data 2. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
NewUK0 |
New reserved data 1. |
NewUK1 |
New reserved data 2. |
NewUK2 |
New reserved data 3. |
NewUK3 |
New reserved data 4. |
NewUK4 |
New reserved data 5. |
NewUK5 |
New reserved data 6. |
NewUK6 |
New reserved data 7. |
NewUK7 |
New reserved data 8. |
TopoNthp |
Index of the topology that contains the next hop. This field displays 0 if the next hop is on the IPv4 public network. This field displays Invalid if the next hop is on an IPv6 network, because the router does not support non-base topologies. |
ExtType |
Extension type of the next hop. |
Color |
Color extended community attribute. |
COFlag |
Flag of the color extended community attribute. |
SIDIndex |
SID index value. |
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. |
x nexthop(s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
OrigNexthop |
Original next hop. |
RelyDepth |
Recursion depth. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
LocalAddr |
Local interface address. |
TunnelCnt |
Number of tunnels after route recursion. |
Vrf |
VPN instance name. For the public network, this field displays default-vrf. |
TunnelID |
ID of the tunnel after route recursion. |
Topology |
Topology name. The topology name for the IPv4 public network is base. This field is blank for IPv6, because IPv6 does not support non-base topologies. |
Weight |
ECMP route weight. This field displays 0 for non-ECMP routes. |
Flags |
Flags of the detailed next hop. |
SRPolicyNID |
NIB ID of the route obtained from an SR-TE policy through route recursion. |
SRInterface |
Output interface of the route obtained from the SR-TE policy through route recursion. |
ColorWeight |
Weight value of the color attribute in the SR-TE policy. |
ecmp mode enhanced
Use ecmp mode enhanced to enable the enhanced ECMP mode.
Use undo ecmp mode to disable the enhanced ECMP mode.
Syntax
ecmp mode enhanced
undo ecmp mode
Default
The enhanced ECMP mode is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
When one or multiple ECMP routes fail, the default ECMP mode enables the device to reallocate all traffic to the remaining routes.
The enhanced ECMP mode enables the device to reallocate only the traffic of the failed routes to the remaining routes.
This command takes effect after a device reboot. Before you reboot the device, make sure you understand the potential impact on the network.
This command applies to both IPv4 and IPv6 ECMP routes.
Examples
# Enable enhanced ECMP mode.
<Sysname> system-view
[Sysname] ecmp mode enhanced
The configuration will take effect at the next reboot. Continue? [Y/N]:y
Reboot device to make the configuration take effect.
Related commands
display ecmp mode
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
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
flush route-attribute
Use flush route-attribute to enable the RIB to flush route attribute information to the FIB.
Use undo flush route-attribute remove the configuration.
Syntax
flush route-attribute protocol
undo flush route-attribute protocol
Default
The RIB does not flush route attribute information to the FIB.
Views
RIB IPv4 address family view
Predefined user roles
network-admin
Parameters
protocol: Specifies a routing protocol. In the current software version, only bgp is supported.
Examples
# Enable the RIB to flush BGP route attribute information to the FIB.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] flush route-attribute bgp
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
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
maintenance-probe enable
Use maintenance-probe enable to enable maintenance probe (MTP).
Use undo maintenance-probe enable to disable MTP.
Syntax
maintenance-probe enable
undo maintenance-probe enable
Default
MTP is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
MTP enables the device to automatically perform the following operations upon expiration of a neighbor's hold timer:
1. Ping the neighbor or trace the route to the neighbor.
2. Record the ping or tracert results.
To view fault information, use the display commands of routing protocols, for example, the display ospf troubleshooting command. To view detailed MTP information, use the display logbuffer command.
Examples
# Enable MTP.
<Sysname> system-view
[Sysname] maintenance-probe enable
Related commands
display bgp troubleshooting
display logbuffer (Network Management and Monitoring Command Reference)
display ospf troubleshooting
nexthop recursive-lookup restrain clear-interval
Use nexthop recursive-lookup restrain clear-interval to set the interval for clearing the recursion loop counter.
Use undo nexthop recursive-lookup restrain clear-interval to restore the default.
Syntax
nexthop recursive-lookup restrain clear-interval interval
undo nexthop recursive-lookup restrain clear-interval
Default
The interval for clearing the recursion loop counter is 600 seconds.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
clear-interval interval: Specifies the interval for clearing the recursion loop counter, in the range of 1 to 65535 seconds.
Usage guidelines
Recursion loop suppression enables the system to use a counter to record the number of route recursion failures. When the counter reaches 20, the system suppresses route recursion for a specified period of time. When the suppression time expires, the system resets the counter and disables route recursion suppression.
Examples
# Set the interval for clearing the recursion loop counter to 100 seconds.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] nexthop recursive-lookup restrain clear-interval 100
nexthop recursive-lookup restrain disable
Use nexthop recursive-lookup restrain disable to disable the suppression for next hop recursion loop.
Use undo nexthop recursive-lookup restrain disable to enable the suppression for next hop recursion loop.
Syntax
nexthop recursive-lookup restrain disable
undo nexthop recursive-lookup restrain disable
Default
Suppression for next hop recursion loop is enabled.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Usage guidelines
A recursion loop occurs when a route recurses to a related route that recurses back to the route. It causes a route recursion failure and further lookup for a related route. If recursion loop persists, continuous route flapping will cause high system resource consumption and CPU utilization.
This command enables the system to use a counter to record the number of route recursion failures. When the counter reaches 20, the system suppresses route recursion for a specified period of time to save system resources on the device.
Examples
# Disable the suppression for next hop recursion loop.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] nexthop recursive-lookup restrain disable
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
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
primary-path-detect bfd
Use primary-path-detect bfd to enable BFD for primary link availability detection.
Use undo primary-path-detect bfd to disable BFD for primary link availability detection.
Syntax
primary-path-detect bfd { ctrl | echo } [ inter-protocol-frr | protocol-ecmp protocol ]
undo primary-path-detect bfd [ inter-protocol-frr | protocol-ecmp protocol ]
Default
BFD is disabled for primary link availability detection.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
ctrl: Specifies the BFD control packet mode.
echo: Specifies the BFD echo packet mode.
inter-protocol-frr: Enables primary link availability detection for inter-protocol FRR.
protocol-ecmp protocol: Enables primary link availability detection for ECMP routes of a routing protocol. In RIB IPv4 address family view, the value for the protocol argument can be bgp, ospf, isis, or static. In RIB IPv6 address family view, the value for the protocol argument can be bgp4+, ospfv3, isisv6, or static.
Usage guidelines
This command enables the device to use a BFD session to detect the next hop availability of the primary link.
· For inter-protocol FRR, the primary link is the route with the highest preference among the routes to the same destination.
· For ECMP routes of a routing protocol, the primary link is each ECMP route. If you specify the ecmp-shared keyword when configuring FFR for a routing protocol, the device will use the LFA algorithm to calculate backup next hops for each ECMP route. The routes destined for the backup next hops are also added to the routing table as ECMP routes and the state of these routes is backup. BFD does not detect these backup ECMP routes.
You can execute this command multiple times to change the BFD mode (echo packet mode or control packet mode).
If you do not specify the inter-protocol-frr or protocol-ecmp keyword, the command applies to both inter-protocol FRR and ECMP routes. The command without the inter-protocol-frr and protocol-ecmp keywords takes precedence over that with the inter-protocol-frr or protocol-ecmp keyword.
Examples
# Enable control-mode BFD for primary link availability detection of OSPF ECMP routes.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] primary-path-detect bfd ctrl protocol-ecmp ospf
Related commands
display ip routing-table
fast-reroute
inter-protocol fast-reroute
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 900 seconds.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
protocol: Specifies a routing protocol.
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.
seconds: Specifies the maximum lifetime for routes and labels in the RIB, in the range of 1 to 6000 seconds.
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
protocol nexthop recursive-lookup
Use protocol nexthop recursive-lookup to configure routing policy-based recursive lookup.
Use undo protocol nexthop recursive-lookup to remove the configuration.
Syntax
protocol protocol nexthop recursive-lookup route-policy route-policy-name
undo protocol protocol nexthop recursive-lookup route-policy
Default
Routing policy-based recursive lookup is not configured.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
protocol: Specifies a routing protocol, which can be bgp or static in RIB IPv4 address family view or bgp4+ in RIB IPv6 address family view.
route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.
Usage guidelines
Configure routing policy-based recursive lookup to control route recursion results. For example, when a route changes, the routing protocol has to perform a route recursion if the next hop is indirectly connected. The routing protocol might select an incorrect path, which can cause traffic loss. To prevent this problem, you can use a routing policy to filter out incorrect routes. The routes that pass the filtering of the routing policy will be used for route recursion.
The apply clauses in the specified routing policy cannot take effect.
Make sure a minimum of one related route can match the routing policy for correct traffic forwarding.
The routing policy does not apply to routes received from directly connected BGP neighbors.
Examples
# Configure recursive lookup based on routing policy policy1 for BGP routes.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] protocol bgp nexthop recursive-lookup route-policy policy1
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 { protocol | all }
reset ip routing-table statistics protocol [ vpn-instance vpn-instance-name ] { protocol | all }
reset ip routing-table [ all-routes | all-vpn-instance ] statistics protocol { protocol | all }
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
all-routes: Clears route statistics for the public network and all VPN instances.
all-vpn-instance: Clears route statistics for all VPN instances.
protocol: Clears route statistics for a routing protocol.
all: Clears route statistics for all IPv4 routing protocols.
Usage guidelines
This command clears IPv4 route statistics for the public network if you do not specify the all-routes, vpn-instance, or all-vpn-instance keyword.
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 }
reset ipv6 routing-table [ all-routes | all-vpn-instance ] statistics protocol { protocol | all }
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
all-routes: Clears route statistics for the public network and all VPN instances.
all-vpn-instance: Clears route statistics for all VPN instances.
protocol: Clears route statistics for an IPv6 routing protocol.
all: Clears route statistics for all IPv6 routing protocols.
Usage guidelines
This command clears IPv6 route statistics for the public network if you do not specify the all-routes, vpn-instance, or all-vpn-instance keyword.
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
Examples
# Enter RIB view.
<Sysname> system-view
[Sysname] rib
[Sysname-rib]
route-direct track
Use route-direct track to associate a track entry with the direct route on an interface and apply a cost value to the direct route after the track entry changes to Negative state.
Use undo route-direct track to restore the default.
Syntax
route-direct track track-entry-number degrade-cost cost-value
undo route-direct track
Default
No track entry is associated with the direct route on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
track-entry-number: Specifies a track entry ID in the range of 1 to 1024.
degrade-cost cost-value: Specifies a cost value to apply to the direct route after the track entry changes to Negative state. The value range for the cost-value argument is 1 to 4294967295.
Usage guidelines
On a network where a VRRP group is used as the default gateway, upstream traffic is always forwarded through the master device in the VRRP group. The corresponding downstream traffic might take a different path because the route selection is determined by the configured dynamic routing protocol. The mismatching forwarding paths might cause the traffic to be blocked by firewalls (if configured), and increase the complexity and overhead for traffic monitoring and statistics collection operations.
You can resolve the issue by configuring direct route-Track-VRRP collaboration. The collaboration ensures that the upstream traffic and the corresponding downstream traffic are forwarded through matching paths (both through the master device in the VRRP group).
To configure direct route-Track-VRRP collaboration, perform the following tasks on each member device of the VRRP group:
1. Create a track entry associated with the VRRP group member device so the track entry state changes according to the status of the device in the VRRP group.
¡ If the device state is Backup or Initialize, the track entry state changes to Negative.
¡ If the device state is Master, the track entry state changes to Positive.
¡ If the device state is Inactive or the VRRP group does not exist, the track entry state changes to NotReady.
2. Associate the track entry with the direct route on the interface connected to the downstream device. The cost value of the direct route on the interface changes according to the status of the track entry.
¡ If the track entry does not exist or the track entry is in NotReady or Positive state, the cost of the direct route changes to 0.
¡ If the track entry is in Negative state, the cost of the direct route changes to the value configured by using the route-direct track command.
IMPORTANT: The direct route that has a lower cost value is preferentially used. |
3. Enable direct route redistribution on the VRRP group member device for the dynamic routing protocol.
The direct route on an interface can be associated only with one track entry. To change the track entry associated with the direct route on an interface, you must first execute the undo route-direct track command to remove the original association.
Examples
# Associate track entry 1 with the direct route on VLAN-interface 2 and apply cost 200 to the direct route after the track entry changes to Negative state.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] route-direct track 1 degrade-cost 200
Related commands
track vrrp (High Availability Command Reference)
routing-table limit
Use routing-table limit to set the maximum number of active IPv4/IPv6 routes supported by the device.
Use undo routing-table limit to restore the default.
Syntax
routing-table limit number simply-alert
undo routing-table limit
Default
The maximum number of active IPv4/IPv6 routes is not set for the device.
Views
RIB IPv4 address family view
RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
number: Specifies the maximum number of active IPv4/IPv6 routes supported by the device, in the range of 1 to 4294967295.
simply-alert: Enables the device to still accept active routes but generate a log message when the number of active IPv4/IPv6 routes exceeds the maximum number.
Usage guidelines
Configuration in RIB IPv4 address family view limits the number of active IPv4 routes for the public network and all VPN instances.
Configuration in RIB IPv6 address family view limits the number of active IPv6 routes for the public network and all VPN instances.
Examples
# In RIB IPv4 address family view, set the maximum number of active IPv4 routes to 1000 for the public network and all VPN instances. The device still accepts new active routes but generates a system log message when the maximum number of active routes is exceeded.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] routing-table limit 1000 simply-alert