Field	Description
ECMP-Mode in use	The current ECMP mode: · Default—Normal mode. · Compressed—Compressed mode. · Eligible—Eligibility mode. The flowset inactive time is also displayed. If no inactive time is configured, this field displays the default flowset inactive time. If an inactive time has been configured, this field displays the configured flowset inactive time. · Enhanced—Enhanced mode. · FIR—FIR mode. ¡ Default flowset inactive time xx—Default flowset inactive time, in milliseconds. ¡ Flowset inactive time xx—Configured flowset inactive time, in milliseconds. ¡ Default flowset size xx—Default flowset size of the FIR ECMP group. ¡ Flowset size xx—Configured flowset size of the FIR ECMP group. ¡ Default flowset hash mode xx—Default flowset hash mode. ¡ Flowset hash mode xx—Configured flowset hash mode. · Fixed—Fixed mode. · Spray—Spray mode.
ECMP-Mode at the next reboot	ECMP mode used at the next startup: · Default—Normal mode. · Compressed—Compressed mode. · Eligible—Eligibility mode. The flowset inactive time is also displayed. If no inactive time is configured, this field displays the default flowset inactive time. If an inactive time has been configured, this field displays the configured flowset inactive time. · Enhanced—Enhanced mode. · FIR—FIR mode. ¡ Default flowset inactive time xx—Default flowset inactive time, in milliseconds. ¡ Flowset inactive time xx—Configured flowset inactive time, in milliseconds. ¡ Default flowset size xx—Default flowset size of the FIR ECMP group. ¡ Flowset size xx—Configured flowset size of the FIR ECMP group. ¡ Default flowset hash mode xx—Default flowset hash mode. ¡ Flowset hash mode xx—Configured flowset hash mode. · Fixed—Fixed mode. · Spray—Spray mode.

Field

Description

ECMP-Mode in use

The current ECMP mode:

· Default—Normal mode.

· Compressed—Compressed mode.

· Eligible—Eligibility mode. The flowset inactive time is also displayed. If no inactive time is configured, this field displays the default flowset inactive time. If an inactive time has been configured, this field displays the configured flowset inactive time.

· Enhanced—Enhanced mode.

· FIR—FIR mode.

¡ Default flowset inactive time xx—Default flowset inactive time, in milliseconds.

¡ Flowset inactive time xx—Configured flowset inactive time, in milliseconds.

¡ Default flowset size xx—Default flowset size of the FIR ECMP group.

¡ Flowset size xx—Configured flowset size of the FIR ECMP group.

¡ Default flowset hash mode xx—Default flowset hash mode.

¡ Flowset hash mode xx—Configured flowset hash mode.

· Fixed—Fixed mode.

· Spray—Spray mode.

ECMP-Mode at the next reboot

ECMP mode used at the next startup:

· Default—Normal mode.

· Compressed—Compressed mode.

· Enhanced—Enhanced mode.

· FIR—FIR mode.

¡ Default flowset inactive time xx—Default flowset inactive time, in milliseconds.

¡ Flowset inactive time xx—Configured flowset inactive time, in milliseconds.

¡ Default flowset size xx—Default flowset size of the FIR ECMP group.

¡ Flowset size xx—Configured flowset size of the FIR ECMP group.

¡ Default flowset hash mode xx—Default flowset hash mode.

¡ Flowset hash mode xx—Configured flowset hash mode.

· Fixed—Fixed mode.

· Spray—Spray mode.

‌

Related commands

ecmp mode

display hardware-resource routing-mode

Use display hardware-resource routing-mode to display routing-mode hardware resource modes.

Syntax

display hardware-resource routing-mode

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display routing-mode hardware resource modes.

<Sysname> display hardware-resource routing-mode

Routing-mode resource(routing-mode), all supported modes:

ipv6-64 IPv6-64 supported

ipv6-128 IPv6-128 supported

-----------------------------------------------

Default Current Next

ipv6-128 ipv6-128 ipv6-128

Table 2 Command output

Field	Description
Routing-mode resource(routing-mode)	Routing-mode hardware resource modes: · ipv6-64—Supports only IPv6 routes with prefixes equal to or shorter than 64 bits. · ipv6-128—Supports IPv6 routes with prefixes longer than 64 bits.
Default	Default hardware resource mode.
Current	Current hardware resource mode.
Next	Newly configured hardware resource mode.

‌

Related commands

hardware-resource routing-mode

display ip routing-table

Use display ip routing-table to display routing table information.

Syntax

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: 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.

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, the 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 : 14 Routes : 14

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

127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0

127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0

127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0

127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

192.168.1.0/24 Direct 0 0 192.168.1.40 Vlan11

192.168.1.0/32 Direct 0 0 192.168.1.40 Vlan11

192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0

192.168.1.255/32 Direct 0 0 192.168.1.40 Vlan11

224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0

224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0

255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

# Display brief information about 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 : 11 Routes : 11

Destination/Mask Proto Pre Cost NextHop Interface

0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0

1.1.1.0/24 Static 60 0 192.168.47.4 Vlan11

192.168.47.4 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

192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0

224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0

224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0

255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

VPN instance: vpn1

Destinations : 9 Routes : 9

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

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

224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0

224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0

255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

# Display information about IPv4 routes for all VPN instances.

<Sysname> display ip routing-table all-vpn-instance

VPN instance: vpn1

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.2.0/24 Static 60 0 2.2.1.1 Vlan11

2.2.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

224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0

224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0

255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

VPN instance: vpn2

Destinations : 9 Routes : 9

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

224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0

224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0

255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

Table 3 Command output

Field	Description
VPN instance	Public network or VPN instance that the routing table belongs to. For the public network, this field displays public instance. For a VPN instance, this field displays the VPN instance name.
Destinations	Number of destination addresses.
Routes	Number of routes.
Destination/Mask	Destination address/mask length.
Proto	Protocol that installed the route.
Pre	Preference of the route.
Cost	Cost of the route.
NextHop	Next hop address of the route.
Interface	Output interface for packets to be forwarded along the route.
Summary count	Number of routes.

# Display detailed information about all routes in the routing table.

<Sysname> display ip routing-table verbose

Destinations : 2 Routes : 2

Destination: 0.0.0.0/32

Protocol: Direct

Process ID: 0

SubProtID: 0x0 Age: 08h34m37s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active NoAdv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0x2 OrigAs: 0

NibID: 0x10000000 LastAs: 0

AttrID: 0xffffffff Neighbor: 0.0.0.0

Flags: 0x1000c OrigNextHop: 127.0.0.1

Label: NULL RealNextHop: 127.0.0.1

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Destination: 1.1.1.0/24

Protocol: Static

Process ID: 0

SubProtID: 0x0 Age: 04h20m37s

Cost: 0 Preference: 60

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active Adv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0x2 OrigAs: 0

NibID: 0x10000003 LastAs: 0

AttrID: 0xffffffff Neighbor: 0.0.0.0

Flags: 0x1008c OrigNextHop: 192.168.47.4

Label: NULL RealNextHop: 192.168.47.4

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

# Display detailed information about all routes in the routing table 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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Table 4 Command output

Field	Description
VPN instance	Public network or VPN instance that the routing table belongs to. For the public network, this field displays public instance. For a VPN instance, this field displays the VPN instance name.
Destinations	Number of destination addresses.
Routes	Number of routes.
Destination	Destination address/mask length.
Protocol	Protocol that installed the route.
SubProtID	ID of the subprotocol for routing.
Age	Time for which the route has been in the routing table.
Cost	Cost of the route.
Preference	Preference of the route.
IpPre	IP precedence.
QosLocalID	Local QoS ID.
Tag	Route tag.
State	Route status: · Active—Active unicast route. · Adv—Route that can be advertised. · Inactive—Inactive route. · NoAdv—Route that the router must not advertise. · Vrrp—Routes generated by VRRP. · Nat—Routes generated by NAT. · TunE—Tunnel. · Backup—Backup route. · IPSGT—Route generated by IP address-Security Group Tag (IP-SGT) policy.
OrigTblID	Original routing table ID.
OrigVrf	Original VPN instance that the route belongs to. This field displays default-vrf if the route is on the 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.
Label	Label.
RealNextHop	Real next hop of the route.
BkLabel	Backup label.
BkNexthop	Backup next hop.
SRLabel	Segment routing (SR) label.
BkSRLabel	Backup segment routing (SR) label.
SIDIndex	SID index value.
InLabel	Input label.
Tunnel ID	Tunnel ID.
Interface	Output interface for packets to be forwarded along the route.
BkTunnel ID	Backup tunnel ID.
BkInterface	Backup output interface.
FtnIndex	Index of the FTN entry.
TrafficIndex	Traffic index in the range of 1 to 64. This field displays N/A when the value is invalid.
Connector	BGP connector attribute exchanged between BGP peers along with a VPN IPv4 route. The value of the attribute is the IP address of the remote PE device. The BGP connector attribute is used for MD VPN. This field displays N/A if the BGP connector attribute is not supported.
Summary count	Number of routes.
PathID	Add-Path ID of the BGP route.
LinkCost	IGP physical link cost.
MicroSegID	Microsegment ID of the route.
RealFIRType	Type of the link for the real next hop in FIR ECMP mode: · Normal. · Primary. · Secondary. The real next hop is the direct next hop found after route recursion.
RealThres	Upper threshold (in percentage) for the bandwidth usage of the primary link to which the real next hop is attached in FIR ECMP mode.

‌

display ip routing-table acl

Use display ip routing-table acl to display information about routes permitted by a basic ACL.

Syntax

display ip routing-table [ vpn-instance vpn-instance-name ] acl ipv4-acl-number [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

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.

If a rule in the specified ACL has the vpn-instance keyword configured, the rule will not take effect.

Examples

# Define basic ACL 2000 and set the route filtering rules.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 192.168.1.0 0.0.0.255

[Sysname-acl-ipv4-basic-2000] rule deny source any

# Display brief information about active routes permitted by basic ACL 2000.

[Sysname-acl-ipv4-basic-2000] display ip routing-table acl 2000

Summary count : 4

Destination/Mask Proto Pre Cost NextHop Interface

192.168.1.0/24 Direct 0 0 192.168.1.111 Vlan11

192.168.1.0/32 Direct 0 0 192.168.1.111 Vlan11

192.168.1.111/32 Direct 0 0 127.0.0.1 InLoop0

192.168.1.255/32 Direct 0 0 192.168.1.111 Vlan11

For command output, see Table 3.

# 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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Destination: 192.168.1.0/32

Protocol: Direct

Process ID: 0

SubProtID: 0x0 Age: 04h20m37s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active NoAdv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0x2 OrigAs: 0

NibID: 0x10000003 LastAs: 0

AttrID: 0xffffffff Neighbor: 0.0.0.0

Flags: 0x1008c OrigNextHop: 192.168.1.111

Label: NULL RealNextHop: 192.168.1.111

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Destination: 192.168.1.255/32

Protocol: Direct

Process ID: 0

SubProtID: 0x0 Age: 04h20m37s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active NoAdv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0x2 OrigAs: 0

NibID: 0x10000003 LastAs: 0

AttrID: 0xffffffff Neighbor: 0.0.0.0

Flags: 0x1008c OrigNextHop: 192.168.1.111

Label: NULL RealNextHop: 192.168.1.111

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 4.

display ip routing-table ip-address

Use display ip routing-table ip-address to display information about routes to a specific destination address.

Use display ip routing-table ip-address1 to ip-address2 to display information about routes to a range of destination addresses.

Syntax

display ip routing-table [ vpn-instance vpn-instance-name ] ip-address [ mask-length | mask ] [ longer-match ] [ verbose ]

display ip routing-table [ vpn-instance vpn-instance-name ] ip-address1 to ip-address2 [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ip-address: Specifies a destination IP address in dotted decimal notation.

mask-length: Specifies the mask length, an integer in the range of 0 to 32.

mask: Specifies the IP address mask in dotted decimal notation.

longer-match: Displays the route 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 and mask length 20.

<Sysname> display ip routing-table 11.0.0.1 20

Summary count : 2

Destination/Mask Proto Pre Cost NextHop Interface

11.0.0.0/8 Static 60 0 0.0.0.0 NULL0

11.0.0.0/16 Static 60 0 0.0.0.0 NULL0

# Display brief information about the 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

# 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: Direct

Process ID: 0

SubProtID: 0x1 Age: 00h00m37s

Cost: 0 Preference: 0

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For 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 [ vpn-instance vpn-instance-name ] prefix-list prefix-list-name [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

prefix-list-name: Specifies an IP prefix list by its name, a case-sensitive string of 1 to 63 characters.

verbose: Displays detailed information about all routes permitted by the IP prefix list. If you do not specify this keyword, the command displays brief information about active routes permitted by the IP prefix list.

Usage guidelines

If the specified IP prefix list does not exist, the command displays information about all routes.

Examples

# Create an IP prefix list named test to permit the route 1.1.1.0/24.

<Sysname> system-view

[Sysname] ip prefix-list test permit 1.1.1.0 24

# Display brief information about the active route permitted by the IP prefix list.

[Sysname] display ip routing-table prefix-list test

Summary count : 1

Destination/Mask Proto Pre Cost NextHop Interface

1.1.1.0/24 Direct 0 0 1.1.1.2 Vlan11

For command output, see Table 3.

# Display detailed information about all routes permitted by the IP prefix list.

[Sysname] display ip routing-table prefix-list test verbose

Summary count : 1

Destination: 1.1.1.0/24

Protocol: Direct

Process ID: 0

SubProtID: 0x1 Age: 04h20m37s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active Adv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0x2 OrigAs: 0

NibID: 0x10000003 LastAs: 0

AttrID: 0xffffffff Neighbor: 0.0.0.0

Flags: 0x1008c OrigNextHop: 1.1.1.2

Label: NULL RealNextHop: 1.1.1.2

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 4.

display ip routing-table protocol

Use display ip routing-table protocol to display information about routes installed by a protocol.

Syntax

display ip routing-table [ vpn-instance vpn-instance-name ] protocol protocol [ inactive | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

protocol: Specifies a routing protocol.

inactive: Displays information about inactive routes. If you do not specify this keyword, the command displays information about both active and inactive routes.

verbose: Displays detailed routing table information. If you do not specify this keyword, the command displays brief routing information.

Examples

# Display brief information about direct routes.

<Sysname> display ip routing-table protocol direct

Summary count : 9

Direct Routing table status : <Active>

Summary count : 9

Destination/Mask Proto Pre Cost NextHop Interface

0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0

2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2

2.2.2.0/32 Direct 0 0 2.2.2.1 Vlan2

2.2.2.2/32 Direct 0 0 127.0.0.1 InLoop0

2.2.2.255/32 Direct 0 0 2.2.2.1 Vlan2

127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0

127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0

127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0

127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0

Direct Routing table status : <Inactive>

Summary count : 0

# Display brief information about static routes.

<Sysname> display ip routing-table protocol static

Summary count : 1

Static Routing table status : <Active>

Summary count : 0

Static Routing table status : <Inactive>

Summary count : 1

Destination/Mask Proto Pre Cost NextHop Interface

1.2.3.0/24 Static 60 0 1.2.4.5 Vlan10

# Display detailed information about OSPF routes.

<Sysname> display ip routing-table protocol ospf verbose

Summary count : 1

Destination: 1.1.1.2/32

Protocol: O_INTRA

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 3.

display ip routing-table statistics

Use display ip routing-table statistics to display IPv4 route statistics, including numbers of total routes, routes installed by the protocol, routes marked as deleted, and active routes.

Syntax

display ip routing-table [ all-routes | all-vpn-instance | vpn-instance vpn-instance-name ] statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all-routes: Displays IPv4 route statistics for 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.

Usage guidelines

If you do not specify any parameters, the command displays IPv4 route statistics for the public network.

Examples

# Display IPv4 route statistics for the public network.

<Sysname> display ip routing-table statistics

Total prefixes: 15 Active prefixes: 15

Proto Routes Active Added Deleted

DIRECT 12 12 30 18

STATIC 3 3 5 2

RIP 0 0 0 0

OSPF 0 0 0 0

IS-IS 0 0 0 0

LISP 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

RIP 0 0 0 0

OSPF 0 0 0 0

IS-IS 0 0 0 0

LISP 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

RIP 0 0 0 0

OSPF 0 0 0 0

IS-IS 0 0 0 0

LISP 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

RIP 0 0 0 0

OSPF 0 0 0 0

IS-IS 0 0 0 0

LISP 0 0 0 0

BGP 0 0 0 0

Total 11 11 13 2

Table 5 Command output

Field	Description
Proto	Protocol that installed the route.
Routes	Number of routes installed by the protocol.
Active	Number of active routes.
Added	Number of routes added to the routing table after the router started up or the routing table was cleared most recently.
Deleted	Number of routes marked as deleted, which will be cleared after a period.
Total	Total number of routes.

display ip routing-table summary

Use display ip routing-table summary to display brief routing table information, including maximum number of ECMP routes, maximum number of active routes, and number of remaining active routes.

Syntax

display ip routing-table [ vpn-instance vpn-instance-name ] summary

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display brief routing table information for the public network.

<Sysname> display ip routing-table summary

Max ECMP: 128

Max Active Route: 163840

Remain Active Route: 163825

# Display brief routing table information for the MPLS L3VPN instance vpn1.

<Sysname> display ip routing-table vpn-instance vpn1 summary

Max ECMP: 128

Max Active Route: 163840

Remain Active Route: 163832

Threshold value percentage of max active routes: 100%

Table 6 Command output

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 routing-table limit number simply-alert command is not configured or when the alarm threshold is specified by using the routing-table limit number warn-threshold command. The value range for the alarm threshold is 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 10.

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

For command output, see Table 12.

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 1 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: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

NibID: 0x20000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

...

# 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: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

RefCnt: 4 FlushRefCnt: 1

Flag: 0x84 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

Bandwidth: 0

NibID: 0x20000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 10 20

EcmpGroup: 0

RefCnt: 4 FlushRefCnt: 1

Flag: 0x84 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

Bandwidth: 0

...

For command output, see Table 13 and Table 14.

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 1 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: 00h01m50s

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

FIRType: Normal Threshold: 0

NibID: 0x20000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

...

# 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: 00h01m50s

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

FIRType: Normal Threshold: 0

RefCnt: 1 FlushRefCnt: 0

Flag: 0x2 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

NibID: 0x20000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

RefCnt: 1 FlushRefCnt: 0

Flag: 0x2 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

...

For command output, see Table 15 and Table 16.

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: 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.

all-routes: Displays IPv6 routing table information for the ‌public network and all VPN instances.

Usage guidelines

If you do not specify any parameters, the 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

# 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 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

Table 7 Command output

Field	Description
VPN instance	Public network or VPN instance that the IPv6 routing table belongs to. For the public network, this field displays public instance. For a VPN instance, this field displays the VPN instance name.
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 IPv6 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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

# Display detailed information about all routes in the IPv6 routing table 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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Table 8 Command output

Field	Description
VPN instance	Public network or VPN instance that the routing table belongs to. For the public network, this field displays public instance. For a VPN instance, this field displays the VPN instance name.
Destination	IPv6 address and prefix of the destination network or host.
Protocol	Protocol that installed the route.
SubProtID	ID of the subprotocol for routing.
Age	Time for which the route has been in the routing table.
Cost	Cost of the route.
Preference	Preference of the route.
IpPre	IP precedence.
QosLocalID	Local QoS ID.
Tag	Tag of the route.
State	Route status: · Active—Active unicast route. · Adv—Route that can be advertised. · Inactive—Inactive route. · NoAdv—Route that the router must not advertise. · Vrrp—Routes generated by VRRP. · Nat—Routes generated by NAT. · TunE—Tunnel. · IPSGT—Route generated by IP-SGT policy.
OrigTblID	Original routing table ID.
OrigVrf	Original VPN instance that the route belongs to. This field displays default-vrf if the route is on the 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.
Label	Label.
RealNextHop	Real next hop of the route.
BkLabel	Backup label.
BkNexthop	Backup next hop.
SRLabel	SR label.
BkSRLabel	Backup SR label.
Tunnel ID	Tunnel ID.
Interface	Output interface for packets to be forwarded along the route.
BkTunnel ID	Backup tunnel ID.
BkInterface	Backup output interface.
FtnIndex	Index of the FTN entry.
TrafficIndex	Traffic index in the range of 1 to 64. This field displays N/A when the value is invalid.
Connector	BGP connector attribute exchanged between BGP peers along with a VPN IPv4 route. The value of the attribute is the IP address of the remote PE device. The BGP connector attribute is used for MD VPN. This field displays N/A if BGP connector attribute is not supported.
Summary count	Number of routes.
PathID	Add-Path ID of the BGP route.
LinkCost	IGP physical link cost.
MicroSegID	Microsegment ID of the route.
RealFIRType	Type of the link for the real next hop in FIR ECMP mode: · Normal. · Primary. · Secondary. The real next hop is the direct next hop found after route recursion.
RealThres	Upper threshold (in percentage) for the bandwidth usage of the primary link to which the real next hop is attached in FIR ECMP mode.

‌

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

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.

If a rule in the specified IPv6 ACL has the vpn-instance keyword configured, the rule will not take effect.

Examples

# Display brief information about active routes permitted by IPv6 ACL 2000.

<Sysname> display ipv6 routing-table acl 2000

Summary count : 6

Destination : ::1/128 Protocol : Direct

NextHop : ::1 Preference: 0

Interface : InLoop0 Cost : 0

Destination: 12::/96 Protocol : Direct

NextHop : :: Preference: 0

Interface : Vlan11 Cost : 0

Destination: 12::1/128 Protocol : Direct

NextHop : ::1 Preference: 0

Interface : InLoop0 Cost : 0

Destination: 11::1/128 Protocol : O_INTER

NextHop : FE80::A1F:3FFF:FE45:206 Preference: 10

Interface : Vlan11 Cost : 2

Destination: FE80::/10 Protocol : Direct

NextHop : :: Preference: 0

Interface : InLoop0 Cost : 0

Destination: FF00::/8 Protocol : Direct

NextHop : :: Preference: 0

Interface : NULL0 Cost : 0

For command output, see Table 7.

# Display detailed information about all routes permitted by IPv6 ACL 2000.

<Sysname> display ipv6 routing-table acl 2000 verbose

Summary count : 6

Destination: ::1/128

Protocol: Direct

Process ID: 0

SubProtID: 0x0 Age: 19h29m12s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active NoAdv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0xa OrigAs: 0

NibID: 0x20000000 LastAs: 0

AttrID: 0xffffffff Neighbor: ::

Flags: 0x10004 OrigNextHop: ::1

Label: NULL RealNextHop: ::1

BkLabel: NULL BkNextHop: N/A

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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Destination: 11::1/128

Protocol: O_INTER

Process ID: 1

SubProtID: 0x2 Age: 00h06m43s

Cost: 2 Preference: 10

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active Adv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0xa OrigAs: 0

NibID: 0x23000003 LastAs: 0

AttrID: 0x ffffffff Neighbor: ::

Flags: 0x10041 OrigNextHop: FE80::A1F:3FFF:FE45:206

Label: NULL RealNextHop: FE80::A1F:3FFF:FE45:206

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

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 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

Destination: FF00::/8

Protocol: Direct

Process ID: 0

SubProtID: 0x0 Age: 19h29m12s

Cost: 0 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active NoAdv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0xa OrigAs: 0

NibID: 0x20000001 LastAs: 0

AttrID: 0xffffffff Neighbor: ::

Flags: 0x10014 OrigNextHop: ::

Label: NULL RealNextHop: ::

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: NULL0

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 8.

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

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.

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

# 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: Direct

Process ID: 1

SubProtID: 0x1 Age: 00h01m14s

Cost: 1 Preference: 0

IpPre: N/A QosLocalID: N/A

Tag: 0 State: Active Adv

OrigTblID: 0x0 OrigVrf: default-vrf

TableID: 0xa OrigAs: 0

NibID: 0x23000002 LastAs: 0

AttrID: 0xffffffff Neighbor: ::

Flags: 0x10041 OrigNextHop: FE80::A1F:3FFF:FE45:206

Label: NULL RealNextHop: FE80::A1F:3FFF:FE45:206

BkLabel: NULL BkNextHop: N/A

SRLabel: NULL BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For 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

prefix-list-name: Specifies an IPv6 prefix list by its name, a case-sensitive string of 1 to 63 characters.

verbose: Displays detailed information about all IPv6 routes permitted by the IPv6 prefix list. If you do not specify this keyword, the command displays brief information about active IPv6 routes permitted by the IPv6 prefix list.

Usage guidelines

If the specified IPv6 prefix list does not exist, the command displays information about all routes.

Examples

# Create an IPv6 prefix list named test to permit the prefix ::1/128.

<Sysname> system-view

[Sysname] ipv6 prefix-list test permit ::1 128

# Display brief information about the active IPv6 route permitted by the IPv6 prefix list.

[Sysname] display ipv6 routing-table prefix-list test

Summary count : 1

Destination: ::1/128 Protocol : Direct

NextHop : ::1 Preference: 0

Interface : InLoop0 Cost : 0

For command output, see Table 7.

# 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

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 8.

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

protocol: Specifies a routing protocol.

inactive: Displays information about inactive routes. If you do not specify this keyword, the command displays information about both active and inactive routes.

verbose: Displays detailed routing table information. If you do not specify this keyword, the command displays brief routing information.

Examples

# Display brief information about IPv6 direct routes.

<Sysname> display ipv6 routing-table protocol direct

Summary count : 3

Direct Routing table status : <Active>

Summary count : 3

Destination: ::1/128 Protocol : Direct

NextHop : ::1 Preference: 0

Interface : InLoop0 Cost : 0

Destination: FE80::/10 Protocol : Direct

NextHop : :: Preference: 0

Interface : InLoop0 Cost : 0

Destination: FF00::/8 Protocol : Direct

NextHop : :: Preference: 0

Interface : NULL0 Cost : 0

Direct Routing table status : <Inactive>

Summary count : 0

# Display brief information about IPv6 static routes.

<Sysname> display ipv6 routing-table protocol static

Summary count : 3

Static Routing table status : <Active>

Summary count : 3

Destination: 2::2/128 Protocol : Static

NextHop : fe80::2 Preference: 60

Interface : Vlan12 Cost : 0

Destination: 2::2/128 Protocol : Static

NextHop : fe80::3 Preference: 60

Interface : Vlan12 Cost : 0

Destination: 3::3/128 Protocol : Static

NextHop : 2::2 Preference: 60

Interface : Vlan12 Cost : 0

Static Routing table status : <Inactive>

Summary count : 0

# Display detailed information about OSPFv3 routes.

<Sysname> display ipv6 routing-table protocol ospfv3 verbose

Summary count : 1

Destination: 22::22/128

Protocol: O_INTER

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 BkSRLabel: NULL

SIDIndex: NULL InLabel: NULL

Tunnel ID: Invalid Interface: Vlan-interface11

BkTunnel ID: Invalid BkInterface: N/A

FtnIndex: 0x0 TrafficIndex: N/A

Connector: N/A PathID: 0x0

LinkCost: 0 MicroSegID: 0

RealFIRType: Normal RealThres: 0

For command output, see Table 7.

display ipv6 routing-table statistics

Use display ipv6 routing-table statistics to display IPv6 route statistics, including numbers of total routes, routes installed and deleted by the protocol, and active routes.

Syntax

display ipv6 routing-table [ all-routes | all-vpn-instance | vpn-instance vpn-instance-name ] statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all-routes: Displays IPv6 route statistics for 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.

Usage guidelines

If you do not specify any parameters, the 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

RIPng 0 0 0 0

OSPFv3 0 0 0 0

IS-ISv6 0 0 0 0

LISP 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

RIPng 0 0 0 0

OSPFv3 0 0 0 0

IS-ISv6 0 0 0 0

LISP 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

RIPng 0 0 0 0

OSPFv3 0 0 0 0

IS-ISv6 0 0 0 0

LISP 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

RIPng 0 0 0 0

OSPFv3 0 0 0 0

IS-ISv6 0 0 0 0

LISP 0 0 0 0

BGP4+ 0 0 0 0

Total 11 11 13 2

Table 9 Command output

Field	Description
Proto	Protocol that installed the route.
Routes	Number of routes installed by the protocol.
Active	Number of active routes.
Added	Number of routes added to the routing table after the router started up or the routing table was cleared most recently.
Deleted	Number of routes marked as deleted, which will be cleared after a period.
Total	Total number of routes.

display ipv6 routing-table summary

Use display ipv6 routing-table summary to display brief IPv6 routing table information, including maximum number of ECMP routes, maximum number of active routes, and number of remaining active routes.

Syntax

display ipv6 routing-table [ vpn-instance vpn-instance-name ] summary

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display brief IPv6 routing table information for the public network.

<Sysname> display ipv6 routing-table summary

Max ECMP: 32

Max Active Route: 262144

Remain Active Route: 262126

# Display brief IPv6 routing table information for the MPLS L3VPN instance vpn1.

<Sysname> display ipv6 routing-table vpn-instance vpn1 summary

Max ECMP: 32

Max Active Route: 1024

Remain Active Route: 1021

Threshold value percentage of max active routes: 100%

For command output, see Table 6.

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

Table 10 Command output

Field	Description
Protocol	Protocol that generates the attribute.
Act-RT reference count	Reference count of the attribute by active routes.
Flush flag	Indicates whether the route attribute has been flushed to the FIB. · 0—The route attribute has not been flushed to the FIB. · 1—The route attribute has been 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	Values of the SFlow AS-path attribute. This field displays N/A when no values exist, and it can display a maximum of 80 values.

display rib ecmp-group

Use display rib ecmp-group to display ECMP group information.

Syntax

display rib ecmp-group [ group-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group-id: Specifies an ECMP group by its ID. If you do not specify this argument, the command displays information about all ECMP groups.

Examples

# Display information about all ECMP groups.

<Sysname> display rib ecmp-group

Ecmp-group: 1

Interface NextHop

HundredGigE1/0/1 10.0.0.1

HundredGigE1/0/2 20.0.0.1

HundredGigE1/0/3 30.0.0.1

Path-id Dscp Mask

1 10 3

2 3 3

Ecmp-group: 2

Interface NextHop

HundredGigE1/0/4 40.0.0.1

HundredGigE1/0/5 50.0.0.1

HundredGigE1/0/6 60.0.1.1

Path-id Dscp Mask

2 3 3

Table 11 Command output

Field	Description
ECMP group	ECMP group ID.
Interface	Output interface.
Next hop	Next hop address of the route.
Path ID	ECMP path ID.
DSCP	DSCP value.
Mask	DSCP mask value.

‌

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

Table 12 Command output

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 or 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 1 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: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

NibID: 0x10000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

NibID: 0x10000002 Sequence: 2

Type: 0x5 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

NibID: 0x16000000 Sequence: 3

Type: 0x21 Flushed: No

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

Instance: abc

...

Table 13 Command output

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 that the next hop belongs to. 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	This field is not supported in the current software version. 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.
FIRType	Type of the link for the next hop in FIR ECMP mode: · Normal. · Primary. · Secondary.
Threshold	Upper threshold (in percentage) for the bandwidth usage of primary links in FIR ECMP mode.
ExtBandwidth	Link bandwidth attribute value from BGP.
AS-path	AS-path subattribute in the next hop attribute. The value contains two AS numbers: · The first AS number represents the next to the last AS number in the AS_PATH attribute of the BGP route before the route reaches the local AS. · The second AS number represents the last AS number in the AS_PATH attribute of the BGP route before the route reaches the local AS. The AS numbers are separated by a space. If any of the AS numbers do not exist, the field displays 0 for that AS number.
EcmpGroup	ECMP group ID.
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: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

RefCnt: 6 FlushRefCnt: 2

Flag: 0x84 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

Bandwidth: 0

NibID: 0x10000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 0 0

EcmpGroup: 0

RefCnt: 11 FlushRefCnt: 5

Flag: 0x84 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

Bandwidth: 0

NibID: 0x15000003 Sequence: 3

Type: 0x43 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

ExtBandwidth:0x0 AS-path: 10 20

EcmpGroup: 0

Instance: default

RefCnt: 9 FlushRefCnt: 3

Flag: 0x84 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

Bandwidth: 0

...

Table 14 Command output

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	This field is not supported in the current software version. 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.
FIRType	Type of the link for the next hop in FIR ECMP mode: · Normal. · Primary. · Secondary.
Threshold	Upper threshold (in percentage) for the bandwidth usage of primary links in FIR ECMP mode.
ExtBandwidth	Link bandwidth attribute value in the next hop.
AS-path	AS-path subattribute in the next hop attribute. The value contains two AS numbers: · The first AS number represents the next to the last AS number in the AS_PATH attribute of the BGP route before the route reaches the local AS. · The second AS number represents the last AS number in the AS_PATH attribute of the BGP route before the route reaches the local AS. The AS numbers are separated by a space. If any of the AS numbers do not exist, the field displays 0 for that AS number.
EcmpGroup	ECMP group ID.
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.
ExtFlag	Extended flag 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	This field is not supported in the current software version. 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 next hop.
RealFIRType	Type of the link for the real next hop in FIR ECMP mode: · Normal. · Primary. · Secondary. The real next hop is the direct next hop found after route recursion.
RealThres	Upper threshold (in percentage) for the bandwidth usage of the primary link to which the real next hop is attached in FIR ECMP mode.
Bandwidth	Link bandwidth attribute value from an IGP protocol or the interface configuration.

‌

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 1 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: 00h01m50s

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

FIRType: Normal Threshold: 0

NibID: 0x10000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

...

Table 15 Command output

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 that the next hop belongs to. 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	This field is not supported in the current software version. 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.
FIRType	Type of the link for the next hop in FIR ECMP mode: · Normal. · Primary. · Secondary.
Threshold	Upper threshold (in percentage) for the bandwidth usage of primary links in FIR ECMP mode.

‌

# 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: 00h01m50s

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

FIRType: Normal Threshold: 0

RefCnt: 2 FlushRefCnt: 0

Flag: 0x2 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

NibID: 0x10000001 Sequence: 1

Type: 0x1 Flushed: Yes

Age: 00h01m50s

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

FIRType: Normal Threshold: 0

RefCnt: 5 FlushRefCnt: 0

Flag: 0x2 Version: 1

ExtFlag: 0x0

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

RealFIRType: Normal RealThres: 0

...

Table 16 Command output

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	This field is not supported in the current software version. 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.
FIRType	Type of the link for the next hop in FIR ECMP mode: · Normal. · Primary. · Secondary.
Threshold	Upper threshold (in percentage) for the bandwidth usage of primary links in FIR ECMP mode.
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.
ExtFlag	Extended flag 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	This field is not supported in the current software version. 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 next hop.
RealFIRType	Type of the link for the real next hop in FIR ECMP mode: · Normal. · Primary. · Secondary. The real next hop is the direct next hop found after route recursion.
RealThres	Upper threshold (in percentage) for the bandwidth usage of the primary link to which the real next hop is attached in FIR ECMP mode.

‌

ecmp-group

Use ecmp-group to create an ECMP group and enter its view.

Use undo ecmp-group to delete an ECMP group.

Syntax

ecmp-group group-id

undo ecmp-group group-id

Default

No ECMP groups exist.

Views

RIB IPv4 address family view

Predefined user roles

network-admin

Parameters

group-id: Specifies an ECMP ID. The value range for this argument is 1 to 64.

Usage guidelines

You can execute this command multiple times to create multiple ECMP groups.

Packets can match an ECMP group on a device that contains the same next hop and output interface of multiple ECMP routes with the same destination IP address. Through ECMP group configuration, you can adjust the next hop and output interface selected by the load sharing algorithm for packets based on their DSCP value.

Examples

# Create ECMP group 1 in RIB IPv4 address family view.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] ecmp-group 1

[Sysname-rib-ipv4-ecmp-group-1]

Related commands

display rib ecmp-group

interface nexthop

path-id

ecmp mode

Use ecmp mode to configure the ECMP mode.

Use undo ecmp mode to restore the default.

‌

NOTE:

To use the FIR ECMP mode, you must first install a valid license. For more information about licenses, see license management in Fundamentals Configuration Guide.

‌

Syntax

ecmp mode { compressed | eligible [ flowset-inactive-time flowset-inactive-time ] | enhanced | fixed | spray }

ecmp mode fir [ flowset-inactive-time flowset-inactive-time ] [ flowset-size flowset-size ] [ hash-mode { eligible | fixed | spray } ]

undo ecmp mode

Default

The normal ECMP mode is used.

Views

System view

Predefined user roles

network-admin

Parameters

compressed: Specifies the compressed ECMP mode.

eligible: Specifies the eligibility ECMP mode or the eligibility FIR ECMP hash mode.

fir: Specifies the Flexible Intelligent Routing (FIR) ECMP mode.

flowset-inactive-time flowset-inactive-time: Specifies a flowset inactive time in microseconds, in the range of 16 to 32000. This option applies to only the eligibility ECMP mode or the eligibility FIR ECMP hash mode.

flowset-size flowset-size: Specifies the flowset size for an FIR ECMP group, in the range of 1 to 8. Value 1 represents 256 flows. The number of flows doubles each time the value of the flowset size increments by 1. As a best practice to avoid resource overuse by an FIR ECMP group, set the flowset size to a value in the range of 1 to 4.

enhanced: Specifies the enhanced ECMP mode.

fixed: Specifies the fixed ECMP mode or the fixed FIR ECMP hash mode.

spray: Specifies the spray ECMP mode or the spray FIR ECMP hash mode.

hash-mode: Specifies FIR ECMP hash mode. The default value is eligible.

Usage guidelines

An ECMP route group contains ECMP routes to the same destination. The following ECMP modes are supported:

· Normal mode—When one or multiple ECMP routes in an ECMP group fail, this mode enables the device to reallocate all traffic to the remaining routes in the ECMP group.

· Enhanced mode—When one or multiple ECMP routes in an ECMP group fail, this mode enables the device to reallocate only the traffic of the failed routes to the remaining routes.

· Eligibility mode—The device calculates the load of each route in an ECMP group at intervals configured by using the flowset-inactive-time argument. In this mode, the device redistributes the packets in one flowset from heavy-load routes to the route with lightest load for load sharing. One flowset refers to the packets to be forwarded in a flow within one flowset inactive time interval. The eligibility mode enables the device to forward all packets in one flowset through the same path.

· Compressed mode—This mode enables the device to compress the hardware resources of all ECMP route groups to save storage space for more ECMP route groups.

· Fixed mode—This mode enables the device to forward all packets in one flow through the same path. When the device forwards the first packet of a flow, it uses normal mode to select a path.

· Spray mode—This mode enables the device to forward a packet through the path with lightest load. In this mode, the device selects a path on a per-packet basis.

· FIR mode—The mechanisms vary depending on the ECMP route type.

¡ For static ECMP routes—You can specify the preferred links as primary links and the links that are less used as secondary links. The device preferentially distributes matching traffic to the primary links and uses an algorithm to distribute matching traffic among primary and secondary links for load sharing.

Use the ip route-static command to configure a static route as a primary or secondary link. The device preferentially distributes matching traffic to the primary links in FIR hash mode for load sharing. If the bandwidth usage of a primary link approaches the overall bandwidth usage upper threshold of all primary links, the device distributes new service traffic on the link to the secondary links in FIR hash mode for load sharing. The original traffic is still forwarded through the primary link. For more information about the primary threshold option, the secondary keyword, and the primary and secondary links for static routing, see static routing and IPv6 static routing in Layer 3—IP Routing Configuration Guide.

For static ECMP routes not configured with the primary threshold option or the secondary keyword, the device distributes matching service traffic to links (without distinguishing primary and secondary links) in FIR hash mode for load sharing.

¡ For ECMP routes generated by dynamic routing protocols—The device distributes matching service traffic to links (without distinguishing primary and secondary links) in FIR hash mode for load sharing. The distribution mechanism is the same as that in eligibility, fixed, or spray mode.

This command takes effect after a device reboot. Before you reboot the device, make sure you understand the potential impact on the network.

If you execute the command multiple times, the most recent configuration takes effect.

This command applies to both IPv4 and IPv6 ECMP routes.

In an IRF fabric, packets of the same data flow might be forwarded through different output interfaces if the following conditions exist:

· The ecmp mode enhanced command is configured in the IRF fabric.

· The packets of the same data flow are received on the interfaces of different IRF member devices.

Follow these guidelines when you configure the FIR ECMP mode:

· Traffic cannot be evenly hashed among the primary interfaces if the following conditions exist:

¡ The sum of limited rates on all primary interfaces is greater than the traffic rate.

¡ The average traffic assigned to the primary interfaces is less than 70%.

· Traffic cannot be evenly hashed among the secondary interfaces if the following conditions exist:

¡ The sum of limited rates on all primary interfaces is less than the traffic rate.

¡ The average traffic assigned to the secondary interfaces is less than 70%.

The FIR ECMP mode is supported only on traffic that is equal to or greater than 1024 bytes.

If you uninstall the FIR license when the FIR ECMP mode is configured, the device cannot distribute matching traffic in FIR ECMP mode for load sharing. Instead, the device distributes the traffic in FIR hash mode specified with the hash-mode keyword for load sharing. If the hash-mode keyword is not specified, the device distributes the traffic in eligibility ECMP mode by default.

When the ECMP mode is eligibility, fixed, or spray, the ECMP routes in the ECMP group cannot use interfaces of 1G rate.

Examples

# Enable the 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

ecmp mode fir primary threshold

Use ecmp mode fir primary threshold to set the upper and lower thresholds for the primary link bandwidth usage of the FIR ECMP mode.

Use undo ecmp mode fir primary threshold to restore the default.

Syntax

ecmp mode fir primary threshold lower lower-threshold upper upper-threshold

undo ecmp mode fir primary threshold

Default

The upper and lower thresholds are not set for the primary link bandwidth usage of the FIR ECMP mode.

Views

System view

Predefined user roles

network-admin

Parameters

lower lower-threshold: Specifies the lower threshold for the primary link bandwidth usage of the FIR ECMP mode in per ten thousand. The value range for the lower-threshold argument is 1 to 10000.

upper upper-threshold: Specifies the upper threshold for the primary link bandwidth usage of the FIR ECMP mode in per ten thousand. The value range for this option depends on the lower threshold setting, which is lower-threshold to 10000.

Usage guidelines

This command takes effect only when the following conditions are met:

· The device is configured with the FIR ECMP mode.

· The device has multiple ECMP static routes to the same destination, and the static routes are specified as primary and secondary links through the primary threshold-level option or secondary keyword.

Use this command together with the primary threshold-level option in the static route configuration command.

· Use the ecmp mode fir primary threshold command to set the upper and lower thresholds for the primary link bandwidth usage of the FIR ECMP mode.

· Use the primary threshold-level option in the static route configuration command to specify the upper threshold for the primary link bandwidth usage that actually takes effect.

For more information about static routes, see static routing and IPv6 static routing in Layer 3—IP Routing Configuration Guide.

Examples

# Set the lower and upper thresholds for the primary link bandwidth usage of the FIR ECMP mode to 80% and 90%.

<Sysname> system-view

[Sysname] ecmp mode fir primary threshold lower 8000 upper 9000

Related commands

ip route-static

ipv6 route-static

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 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 to restore the default.

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. Only BGP is supported in the current software version.

Examples

# Enable the RIB to flush route attribute information to the FIB.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] flush route-attribute bgp

hardware-resource routing-mode

Use hardware-resource routing-mode to configure the routing-mode hardware resource mode.

Use undo hardware-resource routing-mode to restore the default.

Syntax

hardware-resource routing-mode { ipv6-64 | ipv6-128 }

undo hardware-resource routing-mode

Default

The routing-mode hardware resource mode is IPv6-128.

Views

System view

Predefined user roles

network-admin

Parameters

ipv6-64: Specifies the IPv6-64 mode.

ipv6-128: Specifies the IPv6-128 mode.

Usage guidelines

This configuration requires a reboot to take effect. Before rebooting the device, make sure you fully understand the impact on your network.

The device supports the following routing-mode hardware resource modes:

· IPv6-64—Supports only IPv6 routes with prefixes equal to or shorter than 64 bits.

· IPv6-128—Supports IPv6 routes with prefixes longer than 64 bits.

If you disable support for IPv6 routes with prefixes longer than 64 bits, IPv6 host routes with 128-bit prefix length do not support ECMP.

Examples

# Configure the routing-mode hardware resource mode as IPv6-64.

<Sysname> system-view

[Sysname] hardware-resource routing-mode ipv6-64

Related commands

display hardware-resource routing-mode

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

interface nexthop

Use interface nexthop to specify an output interface and a next hop for an ECMP group.

Use undo interface nexthop to remove an output interface and a next hop from an ECMP group.

Syntax

interface interface-type interface-number nexthop nexthop-address

undo interface interface-type interface-number nexthop nexthop-address

Default

No output interface or next hop exists in an ECMP group.

Views

ECMP group view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies an output interface by its type and number.

nexthop-address: Specifies a next hop by its IPv4 address.

Usage guidelines

For an ECMP group to take effect, execute this command multiple times to add all next hops and output interfaces of ECMP routes to the ECMP group. The maximum number of supported next hops and output interfaces is 16.

For two ECMP routes with the same pair of next hop and interface, the ECMP group with smaller ID takes effect.

Examples

# Specify an output interface and a next hop for ECMP group 1.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] ecmp-group 1

[Sysname-rib-ipv4-ecmp-group-1] interface hundredgige 1/0/1 nexthop 10.1.1.2

[Sysname-rib-ipv4-ecmp-group-1] interface hundredgige 1/0/2 nexthop 11.1.1.2

Related commands

display rib ecmp-group

ecmp-group

ip route fast-switchover enable

Use ip route fast-switchover enable to enable IPv4 route fast switchover.

Use undo ip route fast-switchover enable to disable IPv4 route fast switchover.

Syntax

ip route fast-switchover enable

undo ip route fast-switchover enable

Default

IPv4 route fast switchover is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Use this command if a physical interface is the output interface for a large number of routes, including ECMP routes and primary/secondary routes. When a link failure occurs on an interface, the device typically performs the following operations before switching the traffic to a valid route:

1. Deletes all ARP entries for the link.

2. Instructs the FIB to delete the associated FIB entries.

This process is time-consuming and interruptive if a large number of routes traverse the interface. Route fast switchover minimizes traffic interruption by instructing the FIB to delete the affected FIB entries immediately without having to wait for the ARP entries to be deleted.

Examples

# Enable IPv4 route fast switchover.

<Sysname> system-view

[Sysname] ip route fast-switchover enable

ipv6 route fast-switchover enable

Use ipv6 route fast-switchover enable to enable IPv6 route fast switchover.

Use undo ipv6 route fast-switchover enable to disable IPv6 route fast switchover.

Syntax

ipv6 route fast-switchover enable

undo ipv6 route fast-switchover enable

Default

IPv6 route fast switchover is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

1. Deletes all ND entries for the link.

2. Instructs the FIB to delete the associated FIB entries.

Examples

# Enable IPv6 route fast switchover.

<Sysname> system-view

[Sysname] ipv6 route fast-switchover enable

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 ping and tracert a neighbor upon expiration of the neighbor hold timer and record the ping and tracert results. To view detailed fault information, use the display commands of routing protocols, for example, the display bgp 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)

path-id

Use path-id to create an ECMP path.

Use undo path-id to delete an ECMP path.

Syntax

path-id path-id dscp dscp-value mask mask-value

undo path-id path-id

Default

No ECMP paths exist.

Views

ECMP group view

Predefined user roles

network-admin

Parameters

path-id: Specifies a path ID. The value range for this argument is 1 to 7.

dscp dscp-value: Specifies a DSCP value in the range of 0 to 63.

mask mask-value: Specifies a DSCP mask value in the range of 0 to 63. The device performs a Logical AND operation with the specified mask value and the DSCP value of packets. A packet matches the ECMP path only when the operation result is the same as the value specified for the dscp-value argument.

Usage guidelines

If you execute this command multiple times to specify different path IDs, you can create multiple ECMP paths. If you execute this command multiple times to specify the same path ID, the most recent configuration takes effect.

A DSCP value must be unique for all paths in an ECMP group.

After creating an ECMP group, execute the interface nexthop command multiple times to add all next hops and output interfaces of ECMP routes to the ECMP group. Then execute the path-id command to create an ECMP path. The ECMP path automatically copies all next hops and output interfaces in the ECMP group and arranges them in a specific order. If a packet matches routes whose next hops and output interfaces belong to the same ECMP group, the packet matches the ECMP group. The device performs a Logical AND operation with the mask value specified in this command and the DSCP value of the packet. The packet matches the ECMP path when the operation result is the same as the value specified for the dscp-value argument.

The next hops and output interfaces in ECMP paths can be arranged in different orders. For packets of the same data flow, the load sharing algorithm can select different next hops and output interfaces if the packets match multiple ECMP paths. Suppose packets of a data flow have next hop and output interface options 1.1.1.1 (output interface 1), 2.2.2.2 (output interface 2), and 3.3.3.3 (output interface 3). Without an ECMP group configured, the load sharing algorithm selects the third option 3.3.3.3 (output interface 3) for the packets, but the link attached to the next hop cannot meet user demands because of high latency. With an ECMP group configured, the next hops and output interfaces might be arranged in the order of 2.2.2.2 (output interface 2), 3.3.3.3 (output interface 3), and 1.1.1.1 (output interface 1) for a ECMP path. In this case, the load sharing algorithm still selects the third option 1.1.1.1 (output interface 1) that can meet user demands. You can edit the DSCP value for packets to match different ECMP paths, and can change the next hop and output interface for packets accordingly.

Examples

# Create ECMP paths for ECMP group 1 and ECMP group 2.

<Sysname>system-view

[Sysname]rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] ecmp-group 1

[Sysname-rib-ipv4-ecmp-group-1] path-id 1 dscp 20 mask 30

[Sysname-rib-ipv4-ecmp-group-1] path-id 2 dscp 24 mask 30

[Sysname-rib-ipv4-ecmp-group-1] quit

[Sysname-rib-ipv4] ecmp-group 2

[Sysname-rib-ipv4-ecmp-group-2] path-id 1 dscp 20 mask 30

[Sysname-rib-ipv4-ecmp-group-2] path-id 2 dscp 24 mask 30

Related commands

display rib ecmp-group

ecmp-group

ip load-sharing mode (Layer 3—IP Services Command Reference)

primary-path-detect bfd

Use primary-path-detect bfd to enable BFD for primary route next hop detection of inter-protocol FRR or ECMP routes.

Use undo primary-path-detect bfd to disable BFD for primary route next hop detection of inter-protocol FRR or ECMP routes.

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 route next hop detection of inter-protocol FRR or ECMP routes.

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 route next hop detection for inter-protocol FRR.

protocol-ecmp protocol: Enables primary route next hop detection for ECMP routes of a routing protocol.

· In RIB IPv4 address family view, the value for the protocol argument can be bgp, isis, ospf, or static.

· In RIB IPv6 address family view, the value for the protocol argument depends on the BFD mode.

¡ In BFD control packet mode, the value can be bgp4+, isisv6, ospfv3, or static.

¡ In BFD echo packet mode, the value can be bgp4+ or static.

Usage guidelines

After you configure this command, the device automatically creates an IP FRR BFD session to detect the next hop availability of the primary route. Upon primary route next hop failure, traffic can be immediately switched to the backup route next hop for fast convergence.

· For inter-protocol FRR, the primary route is the route with the highest preference among the routes to the same destination.

· For ECMP routes of a routing protocol, the primary route is each ECMP route. If you specify the ecmp-shared keyword when configuring FRR 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. For example, if you have used the primary-path-detect bfd ctrl command, you can use only the following commands to modify or cancel the command configuration:

· primary-path-detect bfd echo.

· undo primary-path-detect bfd.

A control-packet-mode BFD session can be successfully established through negotiation between the two ends. To use a control-packet-mode BFD session to detect the primary route next hop availability, you must create a static BFD session that meets the following requirements on the next hop device:

· Create a single-hop BFD session in control packet mode.

· The source IP address of the BFD session is the destination IP address of the BFD session automatically created by the local end.

· The destination IP address of the BFD session is the source IP address of the BFD session automatically created by the local end.

· The remote discriminator of the BFD session is the local discriminator of the BFD session automatically created by the local end.

The local device can use a control-packet-mode BFD session to detect the primary route next hop only after you create the static BFD session on the primary route next hop device. For more information about creating static BFD sessions, see BFD configuration in High Availability Configuration Guide.

When another protocol (for example, BGP, OSPF, and IS-IS) uses BFD to detect the primary route next hop, it also automatically create a BFD session. If the next hop to be detected is the same as the next hop of the RIB primary route, the device does not repeatedly create the same type of BFD sessions. Instead, the device reuses the BFD session of other protocols.

Examples

# Enable control-mode BFD for primary route next hop detection of IS-IS ECMP routes.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] primary-path-detect bfd ctrl protocol-ecmp isis

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 instances.

seconds: Specifies the maximum lifetime, 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+ or static 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.

Examples

# Configure recursive lookup based on routing policy policy1 for static routes.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] protocol static 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 [ 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]

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 { warn-threshold | 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.

warn-threshold: Specifies an alarm threshold in the range of 1 to 100, in percentage. When the percentage of active routes exceeds the alarm threshold, the system generates a system log message but still accepts active routes. You can take relevant actions based on the message to save system resources. If the number of active routes reaches the maximum number, no more routes can be added and new routes are discarded.

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.

If the configured maximum number of active routes is smaller than the number of existing active routes on the device, the active routes that exceed the maximum number will not become invalid. If route flapping occurs, the routes that exceed the maximum number cannot be activated.

If you execute this command multiple times in the same view, the most recent configuration takes effect.

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

snmp-agent trap enable ipv6 rib

Use snmp-agent trap enable ipv6 rib to enable IPv6 RIB SNMP notifications.

Use undo snmp-agent trap enable ipv6 rib to disable IPv6 RIB SNMP notifications.

Syntax

Default

IPv6 RIB SNMP notifications are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

prefix-exceed: Specifies notifications when the total number of IPv6 route prefixes reaches the maximum value.

prefix-exceed-clear: Specifies notifications when the total number of IPv6 route prefixes drops below the maximum value.

prefix-threshold-exceed: Specifies notifications when the total number of IPv6 route prefixes reaches the alarm threshold.

prefix-thresholdexceed-clear: Specifies notifications when the total number of IPv6 route prefixes drops below the alarm threshold.

public-prefix-exceed: Specifies notifications when the number of IPv6 route prefixes in the public network instance reaches the maximum value.

public-prefixexceed-clear: Specifies notifications when the number of IPv6 route prefixes in the public network instance drops below the maximum value.

public-prefixthreshold-exceed: Specifies notifications when the number of IPv6 route prefixes in the public network instance reaches the alarm threshold.

public-prefixthresholdexceed-clear: Specifies notifications when the number of IPv6 route prefixes in the public network instance drops below the alarm threshold.

vrf-prefix-exceed: Specifies notifications when the number of IPv6 route prefixes in a single VPN instance reaches the maximum value.

vrf-prefixexceed-clear: Specifies notifications when the number of IPv6 route prefixes in a single VPN instance drops below the maximum value.

vrf-prefixthreshold-exceed: Specifies notifications when the number of IPv6 route prefixes in a single VPN instance reaches the alarm threshold.

vrf-prefixthresholdexceed-clear: Specifies notifications when the number of IPv6 route prefixes in a single VPN instance drops below the alarm threshold.

Usage guidelines

After you enable this feature, IPv6 RIB can generate notifications and send them to the SNMP module. For the IPv6 RIB notifications to be sent correctly, you must also configure SNMP on the device. For more information about configuring SNMP, see the network management and monitoring configuration guide for the device.

If you do not specify any parameters, the command enables or disables all IPv6 RIB SNMP notifications.

Examples

# Disable all IPv6 RIB SNMP notifications.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable ipv6 rib

s nmp-agent trap enable rib

Use snmp-agent trap enable rib to enable RIB SNMP notifications.

Use undo snmp-agent trap enable rib to disable RIB SNMP notifications.

Syntax

Default

RIB SNMP notifications are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

prefix-exceed: Specifies notifications when the total number of IPv4 route prefixes reaches the maximum value.

prefix-exceed-clear: Specifies notifications when the total number of IPv4 route prefixes drops below the maximum value.

prefix-threshold-exceed: Specifies notifications when the total number of IPv4 route prefixes reaches the alarm threshold.

prefix-thresholdexceed-clear: Specifies notifications when the total number of IPv4 route prefixes drops below the alarm threshold.

public-prefix-exceed: Specifies notifications when the number of IPv4 route prefixes in the public network instance reaches the maximum value.

public-prefixexceed-clear: Specifies notifications when the number of IPv4 route prefixes in the public network instance drops below the maximum value.

public-prefixthreshold-exceed: Specifies notifications when the number of IPv4 route prefixes in the public network instance reaches the alarm threshold.

public-prefixthresholdexceed-clear: Specifies notifications when the number of IPv4 route prefixes in the public network instance drops below the alarm threshold.

vrf-prefix-exceed: Specifies notifications when the number of IPv4 route prefixes in a single VPN instance reaches the maximum value.

vrf-prefixexceed-clear: Specifies notifications when the number of IPv4 route prefixes in a single VPN instance drops below the maximum value.

vrf-prefixthreshold-exceed: Specifies notifications when the number of IPv4 route prefixes in a single VPN instance reaches the alarm threshold.

vrf-prefixthresholdexceed-clear: Specifies notifications when the number of IPv4 route prefixes in a single VPN instance drops below the alarm threshold.

Usage guidelines

After you enable this feature, RIB can generate notifications and send them to the SNMP module. For the RIB notifications to be sent correctly, you must also configure SNMP on the device. For more information about configuring SNMP, see the network management and monitoring configuration guide for the device.

If you do not specify any parameters, the command enables or disables all RIB SNMP notifications.

Examples

# Disable all RIB SNMP notifications.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable rib

05-Layer 3—IP Routing Command Reference

display ip routing-table acl

display ip routing-table ip-address

display ip routing-table prefix-list

display ip routing-table summary

display ipv6 routing-table acl

display ipv6 routing-table ipv6-address

reset ipv6 routing-table statistics protocol

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us