- Table of Contents
-
- 05-Layer 3-IP Routing Command Reference
- 00-Preface
- 01-Basic IP routing commands
- 02-Static routing commands
- 03-RIP commands
- 04-OSPF commands
- 05-IS-IS commands
- 06-BGP commands
- 07-Policy-based routing commands
- 08-IPv6 static routing commands
- 09-RIPng commands
- 10-OSPFv3 commands
- 11-IPv6 IS-IS commands
- 12-IPv6 policy-based routing commands
- 13-Routing policy commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Basic IP routing commands | 158.25 KB |
display ip routing-table ip-address
display ip routing-table prefix-list
display ip routing-table protocol
display ip routing-table statistics
display ipv6 rib graceful-restart
display ipv6 routing-table acl
display ipv6 routing-table ipv6-address
display ipv6 routing-table prefix-list
display ipv6 routing-table protocol
display ipv6 routing-table statistics
display switch-routing-mode status
reset ip routing-table statistics protocol
reset ipv6 routing-table statistics protocol
Basic IP routing commands
address-family ipv4
Use address-family ipv4 to create a RIB IPv4 address family and enter RIB IPv4 address family view.
Use undo address-family ipv4 to remove a RIB IPv4 address family and all configurations in the view.
Syntax
address-family ipv4
undo address-family ipv4
Default
No RIB IPv4 address family is created.
Views
RIB view
Predefined user roles
network-admin
Examples
# Create a RIB IPv4 address family and enter RIB IPv4 address family view.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4]
address-family ipv6
Use address-family ipv6 to create a RIB IPv6 address family and enter RIB IPv6 address family view.
Use undo address-family ipv6 to remove a RIB IPv6 address family and all configurations in the view.
Syntax
address-family ipv6
undo address-family ipv6
Default
No RIB IPv6 address family is created.
Views
RIB view
Predefined user roles
network-admin
Examples
# Create a RIB IPv6 address family and enter RIB IPv6 address family view.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv6
[Sysname-rib-ipv6]
display ecmp mode
Use display ecmp mode to display the ECMP mode.
Syntax
display ecmp mode
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the ECMP mode.
<Sysname> display ecmp mode
ECMP-Mode in use: Default
ECMP-Mode at the next reboot: Enhanced
display ip routing-table
Use display ip routing-table to display routing table information.
Syntax
display ip routing-table [ verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
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.
standby slot slot-number: Displays backup routing table information for an IRF member device. If you do not specify this option, the command displays routing table information.
Examples
# Display brief information about active routes in the routing table.
<Sysname> display ip routing-table
Destinations : 13 Routes : 13
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
1.1.1.0/24 Static 60 0 192.168.47.4 Vlan1
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.0/24 Direct 0 0 192.168.1.40 Vlan11
192.168.1.0/32 Direct 0 0 192.168.1.40 Vlan11
192.168.1.40/32 Direct 0 0 127.0.0.1 InLoop0
192.168.1.255/32 Direct 0 0 192.168.1.40 Vlan11
224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0
224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
Field |
Description |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination/Mask |
Destination address/mask length. |
Proto |
Protocol that installed the route. |
Pre |
Preference of the route. |
Cost |
Cost of the route. |
NextHop |
Next hop address of the route. |
Interface |
Output interface for packets to be forwarded along the route. |
Summary Count |
Number of routes. |
# Display detailed information about all routes in the routing table.
<Sysname> display ip routing-table verbose
Destinations : 13 Routes : 13
Destination: 0.0.0.0/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h34m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000000 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1000c OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 1.1.1.0/24
Protocol: Static Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 60
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.47.4
Label: NULL RealNextHop: 192.168.47.4
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface1
BkTunnel ID: Invalid BkInterface: N/A
...
Field |
Description |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination |
Destination address/mask length. |
Protocol |
Protocol that installed the route. |
SubProtID |
ID of the subprotocol for routing. |
Age |
Time for which the route has been in the routing table. |
Cost |
Cost of the route. |
Preference |
Preference of the route. |
Tag |
Route tag. |
State |
Route status: · Active—Active unicast route. · Adv—Route that can be advertised. · Inactive—Inactive route. · NoAdv—Route that the router must not advertise. · Vrrp—Routes generated by VRRP. · Nat—Routes generated by NAT. |
OrigTblID |
Original routing table ID. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NibID |
ID of the next hop. |
LastAs |
Last AS number. |
AttrID |
Attribute ID. |
Neighbor |
Address of the neighbor determined by the routing protocol. |
Flags |
Flags of the route. |
OrigNextHop |
Next hop address of the route. |
RealNextHop |
Real next hop of the route. |
BkNexthop |
Backup next hop. |
Interface |
Output interface for packets to be forwarded along the route. |
BkInterface |
Backup output interface. |
Index of the FTN entry. |
|
Number of routes. |
display ip routing-table acl
Use display ip routing-table acl to display information about routes permitted by a specific basic ACL.
Syntax
display ip routing-table acl acl-number [ verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
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.
standby slot slot-number: Displays backup information about routes permitted by the basic ACL for an IRF member device. If you do not specify this option, the command displays information about routes permitted by the basic ACL.
Usage guidelines
If the specified ACL does not exist or has no rules configured, the command displays information about all routes.
Examples
# Define basic ACL 2000 and set the route filtering rules.
<Sysname> system-view
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 192.168.1.0 0.0.0.255
[Sysname-acl-basic-2000] rule deny source any
# Display brief information about active routes permitted by basic ACL 2000.
[Sysname-acl-basic-2000] display ip routing-table acl 2000
Routes Matched by Access control list : 2000
Summary Count : 4
Destination/Mask Proto Pre Cost NextHop Interface
192.168.1.0/24 Direct 0 0 192.168.1.111 Vlan1
192.168.1.0/32 Direct 0 0 192.168.1.111 Vlan1
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 Vlan1
For command output, see Table 1.
# Display detailed information about all routes permitted by basic ACL 2000.
<Sysname> display ip routing-table acl 2000 verbose
Routes Matched by Access control list : 2000
Summary Count : 4
Destination: 192.168.1.0/24
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x10080 OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface1
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.0/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface1
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.111/32
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000000 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x10004 OrigNextHop: 127.0.0.1
Label: NULL RealNextHop: 127.0.0.1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 192.168.1.255/32
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 192.168.1.111
Label: NULL RealNextHop: 192.168.1.111
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface1
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 2.
display ip routing-table ip-address
Use display ip routing-table ip-address to display information about routes to a specific destination address.
Use display ip routing-table ip-address1 to ip-address2 to display information about routes to a range of destination addresses.
Syntax
display ip routing-table ip-address [ mask | mask-length ] [ longer-match ] [ verbose ] [ standby slot slot-number ]
display ip routing-table ip-address1 to ip-address2 [ verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ip-address: Specifies a destination IP address in dotted decimal notation.
mask: Specifies the IP address mask in dotted decimal notation.
mask-length: Specifies the mask length, an integer in the range of 0 to 32.
longer-match: Displays the route entry with the longest mask.
ip-address1 to ip-address2: Specifies a destination IP address range.
verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays brief information about active routes.
standby slot slot-number: Displays backup information about routes to the specified destination addresses for an IRF member device. If you do not specify this option, the command displays information about routes to the specified destination addresses.
Usage guidelines
Executing the command with different parameters yields different outputs.
· display ip routing-table ip-address
¡ The system ANDs the entered destination IP address with the subnet mask in each active route entry.
¡ The system ANDs the destination IP address in each active route entry with its own subnet mask.
If the two operations yield the same result for an entry, the entry is displayed.
· display ip routing-table ip-address mask
¡ The system ANDs the entered destination IP address with the entered subnet mask.
¡ The system ANDs the destination IP address in each active route entry with the entered subnet mask.
If the two operations yield the same result for an entry and the entry has a subnet mask less than or equal to the entered subnet mask, the entry is displayed.
· display ip routing-table ip-address longer-match
¡ The system ANDs the entered destination IP address with the subnet mask in each active route entry.
¡ The system ANDs the destination IP address in each active route entry with its own subnet mask.
If the two operations yield the same result for multiple entries, the one with longest mask length is displayed.
· display ip routing-table ip-address mask longer-match
¡ The system ANDs the entered destination IP address with the entered subnet mask.
¡ The system ANDs the destination IP address in each active route entry with the entered subnet mask.
If the two operations yield the same result for multiple entries and the entries have a mask less than or equal to the entered subnet mask, the one with the longest mask length is displayed.
· display ip routing-table ip-address1 to ip-address2
The system displays active route entries with destinations in the range of ip-address1/32 to ip-address2/32.
Examples
# Display brief information about the routes to the destination IP address 11.0.0.1.
<Sysname> display ip routing-table 11.0.0.1
Summary Count : 3
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/8 Static 60 0 0.0.0.0 NULL0
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
11.0.0.0/24 Static 60 0 0.0.0.0 NULL0
# Display brief information about the routes to the destination IP address 11.0.0.1 and mask length 20.
<Sysname> display ip routing-table 11.0.0.1 20
Summary Count : 2
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/8 Static 60 0 0.0.0.0 NULL0
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
# Display brief information about the most specific route to the destination address 11.0.0.1.
<Sysname> display ip routing-table 11.0.0.1 longer-match
Summary Count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/24 Static 60 0 0.0.0.0 NULL0
# Display brief information about the most specific route to the destination IP address 11.0.0.1 and mask length 20.
<Sysname> display ip routing-table 11.0.0.1 20 longer-match
Summary Count : 1
Destination/Mask Proto Pre Cost NextHop Interface
11.0.0.0/16 Static 60 0 0.0.0.0 NULL0
# Display brief information about the routes to destination addresses in the range of 1.1.1.0 to 5.5.5.0.
<Sysname> display ip routing-table 1.1.1.0 to 5.5.5.0
Summary Count : 6
Destination/Mask Proto Pre Cost NextHop Interface
1.1.1.1/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
3.3.3.0/24 Direct 0 0 3.3.3.1 Vlan2
3.3.3.1/32 Direct 0 0 127.0.0.1 InLoop0
4.4.4.0/24 Direct 0 0 4.4.4.1 Vlan1
4.4.4.1/32 Direct 0 0 127.0.0.1 InLoop0
For command output, see Table 1.
display ip routing-table prefix-list
Use display ip routing-table prefix-list to display routes permitted by an IP prefix list.
Syntax
display ip routing-table prefix-list prefix-list-name [ verbose ] [ standby slot slot-number ]
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.
standby slot slot-number: Displays backup routes permitted by the IP prefix list for an IRF member device. If you do not specify this option, the command displays routes permitted by the IP prefix list.
Usage guidelines
If the specified IP prefix list does not exist, the command displays information about all routes.
Examples
# Create an IP prefix list named test to permit the route 1.1.1.0/24.
<Sysname> system-view
[Sysname] ip prefix-list test permit 1.1.1.0 24
# Display brief information about the active route permitted by the IP prefix list.
[Sysname] display ip routing-table prefix-list test
Routes Matched by Prefix list : test
Summary Count : 1
Destination/Mask Proto Pre Cost NextHop Interface
1.1.1.0/24 Direct 0 0 1.1.1.2 Vlan2
For command output, see Table 1.
# Display detailed information about all routes permitted by the IP prefix list.
[Sysname] display ip routing-table prefix-list test verbose
Routes Matched by Prefix list : test
Summary Count : 1
Destination: 1.1.1.0/24
Protocol: Direct Process ID: 0
SubProtID: 0x1 Age: 04h20m37s
Cost: 0 Preference: 0
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0x2 OrigAs: 0
NibID: 0x10000003 LastAs: 0
AttrID: 0xffffffff Neighbor: 0.0.0.0
Flags: 0x1008c OrigNextHop: 1.1.1.2
Label: NULL RealNextHop: 1.1.1.2
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: Vlan-interface2
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 2.
display ip routing-table protocol
Use display ip routing-table protocol to display information about routes installed by a protocol.
Syntax
display ip routing-table protocol protocol [ inactive | verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
protocol: Specifies a routing protocol. It can be bgp, direct, isis, ospf, rip, or static.
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.
standby slot slot-number: Displays backup information about routes installed by the protocol for an IRF member device. If you do not specify this option, the command displays information about routes installed by the protocol.
Examples
# Display brief information about direct routes.
<Sysname> display ip routing-table protocol direct
Summary Count : 13
Direct Routing Table Status : <Active>
Summary Count : 13
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.0/24 Direct 0 0 2.2.2.1 Vlan2
2.2.2.0/32 Direct 0 0 2.2.2.1 Vlan2
2.2.2.2/32 Direct 0 0 127.0.0.1 InLoop0
2.2.2.255/32 Direct 0 0 2.2.2.1 Vlan2
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
192.168.80.0/24 Direct 0 0 192.168.80.10 Vlan1
192.168.80.0/32 Direct 0 0 192.168.80.10 Vlan1
192.168.80.10/32 Direct 0 0 127.0.0.1 InLoop0
192.168.80.255/32 Direct 0 0 192.168.80.10 Vlan1
Direct Routing Table Status : <Inactive>
Summary Count : 0
# Display brief information about static routes.
<Sysname> display ip routing-table protocol static
Summary Count : 2
Static Routing Table Status : <Active>
Summary Count : 0
Static Routing Table Status : <Inactive>
Summary Count : 2
Destination/Mask Proto Pre Cost NextHop Interface
1.2.3.0/24 Static 60 0 1.2.4.5 Vlan10
3.0.0.0/8 Static 60 0 2.2.2.2 Vlan1
For command output, see Table 1.
display ip routing-table statistics
Use display ip routing-table statistics to display IPv4 route statistics.
Syntax
display ip routing-table statistics [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
standby slot slot-number: Displays backup IPv4 route statistics for an IRF member device. If you do not specify this option, the command displays IPv4 route statistics.
Examples
# Display IPv4 route statistics for the public network.
<Sysname> display ip routing-table statistics
Total prefixes: 15 Active prefixes: 15
Proto route active added deleted
DIRECT 12 12 30 18
STATIC 3 3 5 2
RIP 0 0 0 0
OSPF 0 0 0 0
ISIS 0 0 0 0
BGP 0 0 0 0
Total 15 15 35 20
Table 3 Command output
Field |
Description |
Total prefixes |
Total number of prefixes. |
Active prefixes |
Number of active prefixes. |
Proto |
Protocol that installed the route. |
route |
Number of routes installed by the protocol. |
active |
Number of active routes. |
added |
Number of routes added to the routing table after the router started up or the routing table was cleared most recently. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
display ipv6 rib attribute
Use display ipv6 rib attribute to display route attribute information in the IPv6 RIB.
Syntax
display ipv6 rib attribute [ attribute-id ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
attribute-id: Specifies a route attribute by its ID in the range of 0 to FFFFFFFF.
standby slot slot-number: Displays backup route attribute information in the IPv6 RIB for an IRF member device. If you do not specify this option, the command displays route attribute information in the IPv6 RIB.
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+
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 DIRECT6 480 29 End No/No
2 STATIC6 480 32 End No/No
3 ISISV6 480 30 End No/No
4 BGP4+ 480 31 End No/No
For command output, see Table 11.
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 ] [ standby slot slot-number ]
display ipv6 rib nib protocol protocol-name [ verbose ] [ standby slot slot-number ]
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 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-name: Specifies a protocol by its name, which can be bgp+, direct6, isisv6, ospfv3, ripng, or static6.
standby slot slot-number: Displays backup next hop information in the IPv6 RIB for an IRF member device. If you do not specify this option, the command displays next hop information in the IPv6 RIB.
Examples
# Display brief next hop information in the IPv6 RIB.
<Sysname> display ipv6 rib nib
Total number of nexthop(s): 151
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
...
# Display detailed next hop information in the IPv6 RIB.
<Sysname> display ipv6 rib nib verbose
Total number of nexthop(s): 151
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
RefCnt: 4 FlushRefCnt: 1
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::
RelyDepth: 0 RealNexthop: ::
Interface: NULL0 LocalAddr: ::
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
RefCnt: 4 FlushRefCnt: 1
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::1
RelyDepth: 0 RealNexthop: ::1
Interface: InLoop0 LocalAddr: ::1
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
...
For command output, see Table 12 and Table 13.
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 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
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
...
Table 4 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. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
# Display detailed next hop information for IPv6 direct routes.
<Sysname> display ipv6 route-direct nib verbose
Total number of nexthop(s): 115
NibID: 0x20000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::
IFIndex: 0x111 LocalAddr: ::
RefCnt: 1 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::
RelyDepth: 0 RealNexthop: ::
Interface: NULL0 LocalAddr: ::
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
NibID: 0x20000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: ::1
IFIndex: 0x112 LocalAddr: ::1
RefCnt: 1 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: ::1
RelyDepth: 0 RealNexthop: ::1
Interface: InLoop0 LocalAddr: ::1
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
...
Table 5 Command output
Field |
Description |
x nexthop(s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
OrigNexthop |
Original next hop. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
localAddr |
Local interface address. |
RelyDepth |
Recursion depth. |
RefCnt |
Reference count of the next hop. |
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
Flag |
Flag of the next hop. |
Version |
Version of the next hop. |
display ipv6 routing-table
Use display ipv6 routing-table to display IPv6 routing table information.
Syntax
display ipv6 routing-table [ verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
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.
standby slot slot-number: Displays backup IPv6 routing table information for an IRF member device. If you do not specify this option, the command displays IPv6 routing table information.
Examples
# Display brief information about active routes in the IPv6 routing table.
<Sysname> display ipv6 routing-table
Destinations : 3 Routes : 3
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: FE80::/10 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Destination: FF00::/8 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Field |
Description |
Destinations |
Number of destination addresses. |
Routes |
Number of routes. |
Destination |
IPv6 address and prefix of the destination network or host. |
NextHop |
Next hop address of the route. |
Preference |
Preference of the route. |
Interface |
Output interface for packets to be forwarded along the route. |
Protocol |
Protocol that installed the route. Route types include: · O_INTRA—OSPF intra area route. · O_INTER—OSPF inter area route. · O_ASE1—OSPF external type 1 route. · O_ASE2—OSPF external type 2 route. · O_NSSA1—OSPF NSSA external type 1 route. · O_NSSA2—OSPF NSSA external type 2 route. · O_SUM—OSPF summary route. · IS_L1—IS-IS level-1 route. · IS_L2—IS-IS level-2 route. · IS_SUM—IS-IS summary route. |
Cost |
Cost of the route. |
Summary Count |
Number of routes. |
# Display detailed information about all routes in the routing table.
<Sysname> display ipv6 routing-table verbose
Destinations : 3 Routes : 3
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: FE80::/10
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
Destination: FF00::/8
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 00h53m50s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000001 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10014 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
Field |
Description |
Destination |
IPv6 address and prefix of the destination network or host. |
Protocol |
Protocol that installed the route. |
SubProtID |
ID of the subprotocol for routing. |
Age |
Time for which the route has been in the routing table. |
Cost |
Cost of the route. |
Preference |
Preference of the route. |
IP precedence. |
|
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. |
OrigTblID |
Original routing table ID. |
TableID |
ID of the routing table. |
OrigAs |
Original AS number. |
NibID |
ID of the next hop. |
LastAs |
Last AS number. |
AttrID |
Attribute ID. |
Neighbor |
Address of the neighbor determined by the routing protocol. |
Flags |
Flags of the route. |
OrigNextHop |
Next hop address of the route. |
RealNextHop |
Real next hop of the route. |
BkNexthop |
Backup next hop. |
Interface |
Output interface for packets to be forwarded along the route. |
BkInterface |
Backup output interface. |
Number of routes. |
display ipv6 routing-table acl
Use display ipv6 routing-table acl to display routing information permitted by a specific IPv6 basic ACL.
Syntax
display ipv6 routing-table acl acl-number [ verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
acl6-number: Specifies a basic IPv6 ACL by its number in the range of 2000 to 2999.
verbose: Displays detailed information about all routes permitted by the basic IPv6 ACL. If you do not specify this keyword, the command displays only brief information about active routes permitted by the basic IPv6 ACL.
standby slot slot-number: Displays backup information permitted by the IPv6 basic ACL for an IRF member device. If you do not specify this option, the command displays information permitted by the IPv6 basic ACL.
Usage guidelines
If the specified IPv6 ACL does not exist or has no rules configured, the command displays information about all IPv6 routes.
Examples
# Display brief information about active routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000
Routes Matched by Access control list : 2000
Summary Count : 3
Destination : ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination : 1:1::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
For command output, see Table 6.
# Display detailed information about all routes permitted by IPv6 ACL 2000.
<Sysname> display ipv6 routing-table acl 2000 verbose
Routes Matched by Access control list : 2000
Summary Count : 3
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h57m19s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
Destination: 1:1::/64
Protocol: Static Process ID: 0
SubProtID: 0x2 Age: 08h57m19s
Cost: 0 Preference: 60
Tag: 0 State: Active Adv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000002 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10084 OrigNextHop: ::
Label: NULL RealNextHop: ::
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: NULL0
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 7.
display ipv6 routing-table ipv6-address
Use display ipv6 routing-table ipv6-address to display information about routes to an IPv6 destination address.
Use display ipv6 routing-table ipv6-address1 to ipv6-address2 to display information about routes to a range of IPv6 destination addresses.
Syntax
display ipv6 routing-table ipv6-address [ prefix-length ] [ longer-match ] [ verbose ] [ standby slot slot-number ]
display ipv6 routing-table ipv6-address1 to ipv6-address2 [ verbose ] [ standby slot slot-number ]
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 entry with the longest prefix.
ipv6-address1 to ipv6-address2: Specifies a destination IPv6 address range.
verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.
standby slot slot-number: Displays backup information about IPv6 routes for an IRF member device. If you do not specify this option, the command displays information about IPv6 routes.
Usage guidelines
Executing the command with different parameters yields different output.
· display ipv6 routing-table ipv6-address
¡ The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.
¡ The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.
If the two operations yield the same result for an entry, this entry is displayed.
· display ipv6 routing-table ipv6-address prefix-length
¡ The system ANDs the entered destination IPv6 address with the entered prefix length.
¡ The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.
If the two operations yield the same result for an entry and the entry has a prefix length less than or equal to the entered prefix length, the entry is displayed.
· display ipv6 routing-table ipv6-address longer-match
¡ The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.
¡ The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.
If the two operations yield the same result for multiple entries, the one that has the longest prefix length is displayed.
· display ipv6 routing-table ipv6-address prefix-length longer-match
¡ The system ANDs the entered destination IPv6 address with the entered prefix length.
¡ The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.
If the two operations yield the same result for multiple entries with a prefix length less than or equal to the entered prefix length, the one with the longest prefix length is displayed.
· display ipv6 routing-table ipv6-address1 to ipv6-address2
The system displays route entries with destinations in the range of ipv6-address1/128 to ipv6-address2/128.
Examples
# Display brief information about the routes to the destination IPv6 address 10::1 127.
<Sysname> display ipv6 routing-table 10::1 127
Summary Count: 3
Destination: 10::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 10::/68 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 10::/120 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
# Display brief information about the most specific route to the destination IPv6 address 10::1 and prefix length 127.
<Sysname> display ipv6 routing-table 10::1 127 longer-match
Summary Count : 1
Destination: 10::/120 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
# Display brief information about the routes to destination addresses in the range of 100:: to 300::.
<Sysname> display ipv6 routing-table 100:: to 300::
Summary Count : 3
Destination: 100::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 200::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
Destination: 300::/64 Protocol : Static
NextHop : :: Preference: 60
Interface : NULL0 Cost : 0
For command output, see Table 6.
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 prefix-list prefix-list-name [ verbose ] [ standby slot slot-number ]
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.
standby slot slot-number: Displays backup information about IPv6 routes permitted by the IPv6 prefix list for an IRF member device. If you do not specify this option, the command displays information about IPv6 routes permitted by the IPv6 prefix list.
Usage guidelines
If the specified IPv6 prefix list does not exist, the command displays information about all routes.
Examples
# Create an IPv6 prefix list named test to permit the prefix ::1/128.
<Sysname> system-view
[Sysname] ipv6 prefix-list test permit ::1 128
# Display brief information about the active IPv6 route permitted by the IPv6 prefix list.
[Sysname] display ipv6 routing-table prefix-list test
Routes Matched by Prefix list : test
Summary Count : 1
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
For command output, see Table 6.
# Display detailed information about all routes permitted by the IPv6 prefix list.
[Sysname] display ipv6 routing-table prefix-list test verbose
Routes Matched by Prefix list : test
Summary Count : 1
Destination: ::1/128
Protocol: Direct Process ID: 0
SubProtID: 0x0 Age: 08h57m19s
Cost: 0 Preference: 0
Tag: 0 State: Active NoAdv
OrigTblID: 0x0 OrigVrf: default-vrf
TableID: 0xa OrigAs: 0
NibID: 0x20000000 LastAs: 0
AttrID: 0xffffffff Neighbor: ::
Flags: 0x10004 OrigNextHop: ::1
Label: NULL RealNextHop: ::1
BkLabel: NULL BkNextHop: N/A
Tunnel ID: Invalid Interface: InLoopBack0
BkTunnel ID: Invalid BkInterface: N/A
For command output, see Table 7.
display ipv6 routing-table protocol
Use display ipv6 routing-table protocol to display information about IPv6 routes installed by a protocol.
Syntax
display ipv6 routing-table protocol protocol [ inactive | verbose ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
protocol: Specifies a routing protocol. It can be bgp4+, direct, isisv6, ospfv3, ripng, or static.
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.
standby slot slot-number: Displays backup information about IPv6 routes installed by the protocol for an IRF member device. If you do not specify this option, the command displays information about IPv6 routes installed by the protocol.
Examples
# Display brief information about direct routes.
<Sysname> display ipv6 routing-table protocol direct
Summary Count : 3
Direct Routing Table Status : <Active>
Summary Count : 3
Destination: ::1/128 Protocol : Direct
NextHop : ::1 Preference: 0
Interface : InLoop0 Cost : 0
Destination: FE80::/10 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Destination: FF00::/8 Protocol : Direct
NextHop : :: Preference: 0
Interface : NULL0 Cost : 0
Direct Routing Table Status : <Inactive>
Summary Count : 0
# Display brief information about static routes.
<Sysname> display ipv6 routing-table protocol static
Summary Count : 3
Static Routing table Status : <Active>
Summary Count : 3
Destination: 2::2/128 Protocol : Static
NextHop : fe80::2 Preference: 60
Interface : Vlan2 Cost : 0
Destination: 2::2/128 Protocol : Static
NextHop : fe80::3 Preference: 60
Interface : Vlan2 Cost : 0
Destination: 3::3/128 Protocol : Static
NextHop : 2::2 Preference: 60
Interface : Vlan2 Cost : 0
Static Routing table Status : <Inactive>
Summary Count : 0
For command output, see Table 6.
display ipv6 routing-table statistics
Use display ipv6 routing-table statistics to display IPv6 route statistics.
Syntax
display ipv6 routing-table statistics [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
standby slot slot-number: Displays backup IPv6 route statistics for an IRF member device. If you do not specify this option, the command displays IPv6 route statistics.
Examples
# Display IPv6 route statistics for the public network.
<Sysname> display ipv6 routing-table statistics
Total prefixes: 8 Active prefixes: 8
Proto route active added deleted
DIRECT 5 5 5 0
STATIC 3 3 3 0
RIPng 0 0 0 0
OSPFv3 0 0 0 0
IS-ISv6 0 0 0 0
BGP4+ 0 0 0 0
Total 8 8 8 0
Table 8 Command output
Field |
Description |
Total prefixes |
Total number of prefixes. |
Active prefixes |
Number of active prefixes. |
Proto |
Protocol that installed the route. |
route |
Number of routes installed by the protocol. |
active |
Number of active routes. |
added |
Number of routes added to the routing table after the router started up or the routing table was cleared most recently. |
deleted |
Number of routes marked as deleted, which will be cleared after a period. |
Total |
Total number of routes. |
display max-ecmp-num
Use display max-ecmp-num to display the maximum number of ECMP routes.
Syntax
display max-ecmp-num
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the maximum number of ECMP routes.
<Sysname> display max-ecmp-num
Max-ECMP-Num in use: 6
Max-ECMP-Num at the next reboot: 10
Table 9 Command output
Field |
Description |
Max-ECMP-Num in use |
Maximum number of current ECMP routes in use. |
Max-ECMP-Num at the next reboot |
Maximum number of ECMP routes at the next reboot of the device. |
display rib attribute
Use display rib attribute to display route attribute information in the RIB.
Syntax
display rib attribute [ attribute-id ] [ standby slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
attribute-id: Specifies a route attribute by its ID in the range of 0 to FFFFFFFF.
standby slot slot-number: Displays backup route attribute information in the RIB for an IRF member device. If you do not specify this option, the command displays route attribute information in the RIB.
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
Address family: IPv4
Reference count: 0
Local preference: 0
Ext-communities number: 26
Ext-communities value: <RT: 1:1> <RT: 2:2> <RT: 3:3> <RT: 123.123.123.123:65535
> <RT: 1234567890:65535> <RT: 123.123.123.123:65534> <RT
: 4:4> <RT: 5:5> <RT: 6:6> <RT: 7:7> <RT: 8:8> <RT: 9:9>
<RT: 10:10> <RT: 10:1> <RT: 10:11> <RT: 10:12> <RT: 10:
13> <RT: 10:14> <RT: 10:15> <RT: 10:16> ...
Communities number: 0
Communities value: N/A
AS-path number: 0
AS-path value: N/A
Detailed information of attribute 0x1:
Flag: 0x0
Protocol: BGP
Address family: IPv4
Reference count: 0
Local preference: 0
Ext-communities number: 1
Ext-communities value: <RT: 1:2>
Communities number: 0
Communities value: N/A
AS-path number: 0
AS-path value: N/A
Field |
Description |
Protocol |
Protocol that generates the attribute. |
Ext-communities number |
Number of the extended community attribute values. |
Ext-communities value |
Values of the extended community attribute. This field displays N/A when no value exists, 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 value exists, 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 value exists, and it can display a maximum of 20 values. |
display rib graceful-restart
Use display rib graceful-restart to display RIB GR state information.
Syntax
display rib graceful-restart
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display RIB GR state information.
<Sysname> display rib graceful-restart
RIB GR state : Phase2-calculation end
RCOM GR State : Flush end
Protocol GR state:
No. Protocol Lifetime FD State Start/End
--------------------------------------------------
1 DIRECT 100 30 End No/No
2 STATIC 480 34 End No/No
3 OSPF 480 36 End No/No
4 ISIS 480 32 End No/No
5 BGP 480 31 End No/No
6 LDP 480 35 End No/No
7 SLSP 480 29 End No/No
Field |
Description |
RIB GR state |
RIB GR status: · Start—GR starts. · IGP end—All IGP protocols complete GR. · 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 1 completes. |
RCOM GR state |
RCOM GR status: · Start—GR starts. · 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 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 ] [ standby slot slot-number ]
display rib nib protocol protocol-name [ verbose ] [ standby slot slot-number ]
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 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-name: Specifies a protocol by its name, which can be bgp, direct, isis, ospf, rip, or static.
standby slot slot-number: Displays backup next hop information in the RIB for an IRF member device. If you do not specify this option, the command displays next hop information 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
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NibID: 0x10000002 Sequence: 2
Type: 0x5 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
NibID: 0x26000000 Sequence: 42
Type: 0x2000 Flushed: Yes
SubNibID: 0x21000023 SubSeq: 35
NthpCnt: 1 Samed: 0
NthpType: IP
SubNibID: 0x21000003 SubSeq: 36
NthpCnt: 1 Samed: 0
NthpType: IP
SubNibID: 0x21000004 SubSeq: 37
NthpCnt: 1 Samed: 0
NthpType: IP
SubNibID: 0x21000005 SubSeq: 38
NthpCnt: 1 Samed: 0
NthpType: IP
Field |
Description |
NibID |
ID of the next hop. |
Sequence |
Sequence number of the next hop. |
Type |
Type of the next hop. |
Flushed |
Indicates whether the route with the next hop has been flushed to the FIB. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
LocalAddr |
Local interface address. |
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 represents IP forwarding. |
# Display detailed next hop information in the RIB.
<Sysname> display rib nib verbose
Total number of nexthop(s): 176
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
RefCnt: 6 FlushRefCnt: 2
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 0.0.0.0
RelyDepth: 0 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
RefCnt: 13 FlushRefCnt: 5
Flag: 0x84 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 127.0.0.1
RelyDepth: 0 RealNexthop: 127.0.0.1
Interface: InLoop0 LocalAddr: 127.0.0.1
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
NibID: 0x15000003 Sequence: 3
Type: 0x43 Flushed: Yes
UserKey0: 0x100010000 VrfNthp: 0
UserKey1: 0x0 Nexthop: 22.22.22.22
IFIndex: 0x0 LocalAddr: 0.0.0.0
RefCnt: 9 FlushRefCnt: 3
Flag: 0x84 Version: 1
Policy: tnl-policy1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 22.22.22.22
RelyDepth: 1 RealNexthop: 13.1.1.2
Interface: GE0/1/3 LocalAddr: 13.1.1.1
TunnelCnt: 1 Vrf: default-vrf
TunnelID: 1025
NibID: 0x16000000 Sequence: 0
Type: 0x2000 Flushed: Yes
SubNibID: 0x11000009 SubSeq: 13
NthpCnt: 1 Samed: 0
NthpType: IP
SubNibID: 0x1100000d SubSeq: 14
NthpCnt: 1 Samed: 0
NthpType: IP
2 nexthop(s):
PrefixIndex: 0 OrigNexthop: 10.1.1.2
RelyDepth: 0 RealNexthop: 10.1.1.2
Interface: Vlan10 LocalAddr: 10.1.1.1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A
PrefixIndex: 1 OrigNexthop: 11.1.1.2
RelyDepth: 0 RealNexthop: 11.1.1.2
Interface: Vlan11 LocalAddr: 11.1.1.1
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A
Field |
Description |
x nexthop (s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
OrigNexthop |
Original next hop. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
LocalAddr |
Local interface address. |
RelyDepth |
Recursion depth. |
RefCnt |
Reference count of the next hop. |
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
Flag |
Flag of the next hop. |
Version |
Version of the next hop. |
display route-direct nib
Use display route-direct nib to display next hop information for direct routes.
Syntax
display route-direct nib [ nib-id ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
nib-id: Specifies a NIB by its ID 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
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
...
Table 14 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. |
UserKey0 |
Reserved data 1. |
UserKey1 |
Reserved data 2. |
Nexthop |
Next hop address. |
IFIndex |
Interface index. |
# Display detailed next hop information for direct routes.
<Sysname> display route-direct nib verbose
Total number of nexthop(s): 116
NibID: 0x10000000 Sequence: 0
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
RefCnt: 2 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 0.0.0.0
RelyDepth: 0 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
NibID: 0x10000001 Sequence: 1
Type: 0x1 Flushed: Yes
UserKey0: 0x0 VrfNthp: 1
UserKey1: 0x0 Nexthop: 127.0.0.1
IFIndex: 0x112 LocalAddr: 127.0.0.1
RefCnt: 5 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 127.0.0.1
RelyDepth: 0 RealNexthop: 127.0.0.1
Interface: InLoop0 LocalAddr: 127.0.0.1
TunnelCnt: 0 Vrf: vpn1
TunnelID: N/A
...
Table 15 Command output
Field |
Description |
x nexthop(s) |
Number of next hops. |
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
OrigNexthop |
Original next hop. |
RealNexthop |
Real next hop. |
Interface |
Output interface. |
localAddr |
Local interface address. |
RelyDepth |
Recursion depth. |
RefCnt |
Reference count of the next hop. |
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
Flag |
Flag of the next hop. |
Version |
Version of the next hop. |
display switch-routing-mode status
Use display switch-routing-mode status to display the status of IPv6 routes with prefixes longer than 64 bits.
Syntax
display switch-routing-mode status
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the status of IPv6 routes with prefixes longer than 64 bits.
<Sysname> display switch-routing-mode status
Switch-routing-mode in use: ipv6-128 supported.
Switch-routing-mode at the next reboot: ipv6-128 supported.
ecmp mode enhanced
Use ecmp mode enhanced to enable the enhanced ECMP mode.
Use undo ecmp mode to restore the default.
Syntax
ecmp mode enhanced
undo ecmp mode
Default
The enhanced ECMP mode is disabled.
Views
System view
Predefined user roles
network-admin
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.
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: Sets the maximum lifetime for routes in the FIB, in the range of 0 to 900 seconds. When this argument is set to 0, FIB entries immediately age out after a protocol or RIB process switchover.
Usage guidelines
When a protocol or RIB process switchover occurs and GR or NSR is not configured, FIB entries age out after the time specified in this command.
Examples
# Set the maximum lifetime for IPv4 routes in the FIB to 60 seconds.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] fib lifetime 60
max-ecmp-num
Use max-ecmp-num to set the maximum number of ECMP routes.
Syntax
max-ecmp-num number
Default
The maximum number of ECMP routes is 8.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies the maximum number of ECMP routes, in the range of 1 to 32.
Usage guidelines
When one or multiple ECMP routes fail, the default ECMP mode enables the device to reallocate all traffic to the remaining routes.
The enhanced ECMP mode enables the device to reallocate only the traffic of the failed routes to the remaining routes.
Examples
# Set the maximum number of ECMP routes to 10.
<Sysname> system-view
[Sysname] max-ecmp-num 10
The configuration will take effect at the next reboot. Continue? [Y/N]:y
Reboot device to make the configuration take effect.
After reboot, the maximum number of ECMP routes is 10.
protocol lifetime
Use protocol lifetime to set the maximum lifetime for IPv4 or IPv6 routes in the RIB.
Use undo protocol lifetime to restore the default.
Syntax
protocol protocol lifetime seconds
undo protocol protocol lifetime
Default
The maximum lifetime for IPv4 or IPv6 routes in the RIB is 480 seconds.
Views
RIB IPv4 address family view, RIB IPv6 address family view
Predefined user roles
network-admin
Parameters
seconds: Sets the maximum lifetime for routes in the RIB, in the range of 0 to 900 seconds. When this argument is set to 0, RIB entries immediately age out when a protocol switchover occurs.
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 OSPF routes in the RIB to 60 seconds.
<Sysname> system-view
[Sysname] rib
[Sysname-rib] address-family ipv4
[Sysname-rib-ipv4] protocol ospf lifetime 60
reset ip routing-table statistics protocol
Use reset ip routing-table statistics protocol to clear IPv4 route statistics.
Syntax
reset ip routing-table statistics protocol { protocol | all } [ standby slot slot-number ]
Views
User view
Predefined user roles
network-admin
Parameters
protocol: Clears route statistics for a routing protocol. It can be bgp, direct, isis, ospf, rip, or static.
all: Clears route statistics for all IPv4 routing protocols.
standby slot slot-number: Clears backup IPv4 route statistics for an IRF member device. If you do not specify this option, the command clears IPv4 route statistics.
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 { protocol | all } [ standby slot slot-number ]
Views
User view
Predefined user roles
network-admin
Parameters
protocol: Clears route statistics for an IPv6 routing protocol. It can be bgp4+, direct, isisv6, ospfv3, ripng, or static.
all: Clears route statistics for all IPv6 routing protocols.
standby slot slot-number: Clears backup IPv6 route statistics for an IRF member device. If you do not specify this option, the command clears IPv6 route statistics.
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]
switch-routing-mode ipv6-128
Use switch-routing-mode ipv6-128 to enable support for IPv6 routes with prefixes longer than 64 bits.
Use undo switch-routing-mode ipv6-128 to disable support for IPv6 routes with prefixes longer than 64 bits.
Syntax
switch-routing-mode ipv6-128
undo switch-routing-mode ipv6-128
Default
The device does not support IPv6 routes with prefixes longer than 64 bits.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command takes effect at next reboot. Make sure the reboot does not impact your network.
Examples
# Enable support for IPv6 routes with prefixes longer than 64 bits.
[Sysname] switch-routing-mode ipv6-128
Reboot device to make the configuration take effect.