display ipv6 routing-table

Function

The display ipv6 routing-table command displays information about the IPv6 routing table.

Format

display ipv6 routing-table [ verbose | brief ]

display ipv6 routing-table ipv6-address [ prefix-length ] [ longer-match ] [ verbose | brief ]

display ipv6 routing-table ipv6-address1 [ prefix-length1 ] ipv6-address2 prefix-length2 [ verbose | brief ]

display ipv6 routing-table acl { acl6-number [ verbose | brief ]

display ipv6 routing-table ipv6-prefix ipv6-prefix-name [ verbose | brief ]

Parameters

Parameter	Description	Value
verbose	Displays detailed information about active and inactive routes in the current routing table.	-
brief	Displays brief information about active routes in the current routing table.	-
ipv6-address	Specifies the destination IPv6 address.	-
prefix-length	Specifies the length of the IPv6 address prefix.	-
longer-match	Displays only the routes that match the specified network or mask.	-
ipv6-address1/ipv6-address2	Specifies the IPv6 address. ipv6-address1 and ipv6-address2 together determine an address range. Only the routes in the address range are displayed.	-
prefix-length1/prefix-length2	Specifies the length of the IPv6 address prefix.	-
acl	Uses ACL6 to filter the command output. If the specified ACL6 does not exist, information about all active routes is displayed.	-
acl6-number	Specifies the number of a basic ACL6.	The number is an integer ranges from 2000 to 2999.
ipv6-prefix ipv6-prefix-name	Specifies the name of the IPv6 prefix list.	The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The command output without the verbose parameter includes the destination address, prefix length, protocol type, preference, cost, next hop, outbound interface, tunnel ID, label value carried by the route, and route status.

An iterated route is counted as one route no matter how many outbound interfaces and next hops the route finds.

This command without the parameter verbose displays the currently preferred routes only.

When using the display ipv6 routing-table ipv6-address prefix-length [ longer-match ] [ verbose ] command, you can select parameters in the command as required.

If ipv6-address prefix-length is specified, the IPv6 routes that accurately match the destination address are displayed.
If ipv6-address prefix-length longer-match is specified, the IPv6 routes with the destination address within the specified address range are displayed. If the prefix length is 0, all routes in the IPv6 routing table are displayed.

For example, there are four routes in the routing table, 2000::20/128, 2000::/100, 2000::/64, and 1000::/64.

If the display ipv6 routing-table 2000:: 64 command is used, only 2000::/64 is displayed.
If the display ipv6 routing-table 2000:: command is used, only 2000::/100 is displayed.
If the display ipv6 routing-table 2000:: 127 longer-match command is used, only 2000::/100 and 2000::/64 are displayed.
If the display ipv6 routing-table 2000:: 0 longer-match command is used, four routes are displayed.

Precautions

If the specified ipv6-prefix ipv6-prefix-name does not exist, the command displays all of the currently preferred routes.

Example

# Display the summary of the current routing table.

<sysname> display ipv6 routing-table
Routing Table : Public
         Destinations : 4        Routes : 4

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : 2001:db8:112::                  PrefixLength : 64
 NextHop      : 2001:db8:112::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

 Destination  : 2001:db8:112::2                 PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

 Destination  : FE80::                          PrefixLength : 10
 NextHop      : ::                              Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D

# Display brief information about routes in the routing table.

<sysname> display ipv6 routing-table brief

Routing Table : Public
         Destinations : 1        Routes : 1
 
Format :          
Destination/Mask                             Protocol
Nexthop                                      Interface
------------------------------------------------------------------------------  
 ::1/128                                     Direct
  ::1                                        InLoopBack0

**Table 1** Description of the **display ipv6 routing-table** command output
Item	Description
Routing Tables: Public	Indicates a public routing table.
Destinations	Indicates the total number of destination networks or hosts.
Routes	Indicates the total number of routes.
Destination	Address of the destination network or host
PrefixLength	Length of the prefix
NextHop	IPv6 address of the next hop
Preference	Preference of the route
Cost	Route cost
Protocol	Name of the routing protocol
RelayNextHop	Iterated next hop
TunnelID	Tunnel ID The value 0x0 indicates that no tunnel is used or the tunnel is not set up.
Interface	Outbound interface through which the next hop is reachable
Flags	Indicates the route flag: R: indicates an iterated route. D: indicates that the route is downloaded to the Forwarding Information Base (FIB) table.
Destination/Mask	Address and mask of the destination network or host

# Display detailed information about routes in the routing table.

<sysname> display ipv6 routing-table verbose

Routing Table : Public
         Destinations : 2        Routes : 2

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Direct
 State        : Active NoAdv                    Cost         : 0
 Entry ID     : 1                               EntryFlags   : 0x80010050
 Reference Cnt: 1                               Tag          : 0
 Priority     : high                            Age          : 84410sec
 IndirectID   : 0x0
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : 2001:db8:1::1                   PrefixLength : 128
 NextHop      : 2001:db8:2::2                   Preference   : 60
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Static
 State        : Active Adv Relied               Cost         : 0
 Entry ID     : 2                               EntryFlags   : 0x80020140
 Reference Cnt: 1                               Tag          : 0
 Priority     : high                            Age          : 79036sec
 IndirectID   : 0x80000001
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : RD

**Table 2** Description of the **display ipv6 routing-table verbose** command output
Item	Description
Neighbour	IP address of the neighbor interface
ProcessID	Process ID of the routing protocol
Label	Label value carried by the route
State	Current status of the route Active: indicates active routes. Invalid: indicates invalid routes. Inactive: indicates inactive routes. NoAdv: indicates the routes that cannot be advertised. Adv: indicates the routes that can be advertised. Del: indicates the routes to be deleted. Relied: indicates the route that finds the next hop and outbound interface or the route that finds the tunnel during packet forwarding. Stale: indicates the routes with the stale flag. The routes are used in GR.
Entry ID	Keyword of the retrieval index of routes in the routing table
EntryFlags	Information about route flags
Reference Cnt	Number of times that a route is referenced
Tag	Administrative tag for routes. The value is an integer ranging from 0 to 4294967295.
Priority	Indicates the convergence priority of a route. low: indicates that the convergence priority of a route is low. medium: indicates that the convergence priority of a route is medium. high: indicates that the convergence priority of a route is high. critical: indicates that the convergence priority of a route is critical.
IndirectID	Indicates the keyword of indirect next hop, which is generated by the system and cannot be configured by users. If the route is not iterated, the value is 0x0. If the route is iterated, the value is not 0x0.
Age	Time since the route is generated

# Display the summary of the active routes that match ACL6 2000.

<sysname> display ipv6 routing-table acl 2000
Routes Matched by Access list  2000  :
Summary Count : 2

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : 2001:db8:111::                  PrefixLength : 64
 NextHop      : 2001:db8:111::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

# Display the summary of the specified route. There is one matching route in the mask range.

<sysname> display ipv6 routing-table 2001:db8:111::1 64
Routing Table :Public
Summary Count : 1

 Destination  : 2001:db8:111::                  PrefixLength : 64
 NextHop      : 2001:db8:111::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

# Display IPv6 routes in the specified address range.

<sysname> display ipv6 routing-table 2001:db8:111::1 64 2001:db8:111::2 128
Routing Table :
Summary Count : 2

 Destination  : 2001:db8:111::                  PrefixLength : 64
 NextHop      : 2001:db8:111::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

 Destination  : 2001:db8:111::2                 PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

# Display the summary of the active routes that match the prefix list named abc2.

<sysname> display ipv6 routing-table ipv6-prefix abc2
Routes Matched by Prefix-list : abc2
Summary Count: 3

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : 2001:db8:112::                  PrefixLength : 64
 NextHop      : 2001:db8:112::1                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D

 Destination  : 112::1                          PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : GigabitEthernet0/0/10           Flags        : D