06-Layer 3 - IP Routing Command Reference

HomeSupportSwitchesH3C S7500E Switch SeriesReference GuidesCommand ReferencesH3C S7500E Switch Series Command References-Release7178-6W10006-Layer 3 - IP Routing Command Reference
01-Basic IP routing commands
Title Size Download
01-Basic IP routing commands 160.44 KB

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

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

mdc-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 ip routing-table

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing table information for the public network.

verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.

Examples

# Display brief information about active routes in the routing table.

<Sysname> display ip routing-table

 

         Destinations : 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    GE1/0/1

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

Table 1 Command output

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: GigabitEthernet1/0/1

BkTunnel ID: Invalid        BkInterface: N/A

 

...

Table 2 Command output

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.

·     TunE—Tunnel.

OrigTblID

Original routing table ID.

OrigVrf

Original VPN that the route belongs to.

TableID

ID of the routing table.

OrigAs

Original AS number.

NibID

ID of the next hop.

LastAs

Last AS number.

AttrID

Attribute ID.

Neighbor

Address of the neighbor determined by the routing protocol.

Flags

Flags of the route.

OrigNextHop

Next hop address of the route.

RealNextHop

Real next hop of the route.

BkLabel

Backup label.

BkNexthop

Backup next hop.

Interface

Output interface for packets to be forwarded along the route.

BkTunnel ID

Backup tunnel ID.

BkInterface

Backup output interface.

Summary Count

Number of routes.

 

display ip routing-table acl

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

acl-number: Specifies a basic ACL by its number in the range of 2000 to 2999.

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

Usage guidelines

If the specified ACL does not exist or has no rules configured, the command displays information about all routes.

Examples

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

<Sysname> system-view

[Sysname] acl 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   GE1/0/1

192.168.1.0/32      Direct 0    0            192.168.1.111   GE1/0/1

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   GE1/0/1

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: GigabitEthernet1/0/1

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: GigabitEthernet1/0/1

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: GigabitEthernet1/0/1

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 [ vpn-instance vpn-instance-name ] ip-address [ mask | mask-length ] [ longer-match ] [ verbose ]

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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.

Usage guidelines

Executing the command with different parameters yields different outputs.

·     display ip routing-table ip-address

¡     The system ANDs the entered destination IP address with the subnet mask in each active route entry.

¡     The system ANDs the destination IP address in each active route entry with its own subnet mask.

If the two operations yield the same result for an entry, the entry is displayed.

·     display ip routing-table ip-address mask

¡     The system ANDs the entered destination IP address with the entered subnet mask.

¡     The system ANDs the destination IP address in each active route entry with the entered subnet mask.

If the two operations yield the same result for an entry with a subnet mask not greater than the entered subnet mask, the entry is displayed.

·     display ip routing-table ip-address longer-match

¡     The system ANDs the entered destination IP address with the subnet mask in each active route entry.

¡     The system ANDs the destination IP address in each active route entry with its own subnet mask.

If the two operations yield the same result for multiple entries, the entry with the longest mask length is displayed.

·     display ip routing-table ip-address mask longer-match

¡     The system ANDs the entered destination IP address with the entered subnet mask.

¡     The system ANDs the destination IP address in each active route entry with the entered subnet mask.

If the two operations yield the same result for multiple entries with a mask not greater than the entered subnet mask, the entry with the longest mask length is displayed.

·     display ip routing-table ip-address1 to ip-address2

The system displays active route entries with destinations in the range of ip-address1/32 to ip-address2/32.

Examples

# Display brief information about the routes to the destination IP address 11.0.0.1.

<Sysname> display ip routing-table 11.0.0.1

 

Summary Count : 3

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

11.0.0.0/8          Static 60   0            0.0.0.0         NULL0

11.0.0.0/16         Static 60   0            0.0.0.0         NULL0

11.0.0.0/24         Static 60   0            0.0.0.0         NULL0

# Display brief information about the routes to the destination IP address 11.0.0.1 and mask length 20.

<Sysname> display ip routing-table 11.0.0.1 20

 

Summary Count : 2

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

11.0.0.0/8          Static 60   0            0.0.0.0         NULL0

11.0.0.0/16         Static 60   0            0.0.0.0         NULL0

# Display brief information about the most specific route to the destination address 11.0.0.1.

<Sysname> display ip routing-table 11.0.0.1 longer-match

 

Summary Count : 1

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

11.0.0.0/24         Static 60   0            0.0.0.0         NULL0

# Display brief information about the most specific route to the destination IP address 11.0.0.1 and mask length 20.

<Sysname> display ip routing-table 11.0.0.1 20 longer-match

 

Summary Count : 1

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

11.0.0.0/16         Static 60   0            0.0.0.0         NULL0

# Display brief information about the routes to destination addresses in the range of 1.1.1.0 to 5.5.5.0.

<Sysname> display ip routing-table 1.1.1.0 to 5.5.5.0

 

Summary Count : 4

 

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

1.1.1.1/32          Direct 0    0            127.0.0.1       InLoop0

2.2.2.0/24          Direct 0    0            2.2.2.1         Vlan2

3.3.3.1/32          Direct 0    0            127.0.0.1       InLoop0

4.4.4.1/32          Direct 0    0            127.0.0.1       InLoop0

For command output, see Table 1.

display ip routing-table prefix-list

Use display ip routing-table prefix-list to display routes permitted by an IP prefix list.

Syntax

display ip routing-table [ vpn-instance vpn-instance-name ] prefix-list prefix-list-name [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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

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

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] ip prefix-list test permit 1.1.1.0 24

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

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

 

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         GE1/0/2

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: GigabitEthernet1/0/2

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 [ vpn-instance vpn-instance-name ] protocol protocol [ inactive | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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.

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   GE1/0/1

192.168.80.0/32     Direct 0    0            192.168.80.10   GE1/0/1

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   GE1/0/1

 

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

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 [ vpn-instance vpn-instance-name ] statistics

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, 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

 

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

Proto

Protocol that installed the route.

route

Number of routes installed by the protocol.

active

Number of active routes.

added

Number of routes added to the routing table after the router started up or the routing table was cleared most recently.

deleted

Number of routes marked as deleted, which will be cleared after a period.

Total

Total number of routes.

 

display ip routing-table summary

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays brief routing table information for the public network.

Examples

# Display brief routing table information.

<Sysname> display ip routing-table summary

 

Max ECMP: 16

Max Active Route: 1048576

Remain Active Route: 1048568

# Display brief routing table information for VPN instance vpn1.

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

 

Max ECMP: 16

Max Active Route: 1048576

Remain Active Route: 1048568

Threshold value percentage of max active routes: 100%

Table 4 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 percentage of max active routes

Alarm threshold of active routes specified by using the routing-table limit command in a VPN instance:

·     Threshold value of active routes alert—This field is displayed when the alarm threshold is specified by using the routing-table limit number simply-alert command. When the number of active routes exceeds the alarm threshold, the system logs the event and sends traps but still accepts active routes.

·     Threshold value percentage of max active routes—This field is displayed when the alarm threshold is specified by using the routing-table limit number warn-threshold command, in the range of 1 to 100 in percentage. When the percentage of active routes exceeds the alarm threshold, the system logs the event and sends traps but still accepts active routes. If the number of active routes reaches the maximum number, no more routes can be added. The percentage of active routes equals the number of active routes divided by the maximum number of active routes supported in a VPN instance, and multiplied by 100.

 

display ipv6 rib attribute

Use display ipv6 rib attribute to display route attribute information in the IPv6 RIB.

Syntax

display ipv6 rib attribute [ attribute-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

attribute-id: Specifies a route attribute by its ID 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+

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

display ipv6 rib graceful-restart

Use display ipv6 rib graceful-restart to display IPv6 RIB GR state information.

Syntax

display ipv6 rib graceful-restart

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display IPv6 RIB GR state information.

<Sysname> display ipv6 rib graceful-restart

RIB GR state     : Phase2-calculation end

RCOM GR State    : Flush end

Protocol GR state:

 No.  Protocol   Lifetime FD   State    Start/End

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

 1    DIRECT6    480      29   End      No/No

 2    STATIC6    480      32   End      No/No

 3    ISISV6     480      30   End      No/No

 4    BGP4+      480      31   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-name [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

self-originated: Displays information about next hops of self-originated routes in the IPv6 RIB.

nib-id: Specifies a NIB by its ID 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.

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

mdc-admin

mdc-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 5 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.

VrfNthp

VPN to which the next hop belongs.

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 6 Command output

Field

Description

x nexthop(s)

Number of next hops.

Tnl-Policy

Tunnel policy.

PrefixIndex

Prefix index of the next hop for an ECMP route.

Vrf

VPN name.

OrigNexthop

Original next hop.

RealNexthop

Real next hop.

Interface

Output interface.

localAddr

Local interface address.

RelyDepth

Recursion depth.

TunnelCnt

Number of tunnels after route recursion.

TunnelID

ID of the tunnel after route recursion.

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.

Examples

# Display brief information about active routes in the IPv6 routing table.

<Sysname> display ipv6 routing-table

 

Destinations : 3 Routes : 3

 

Destination: ::1/128                                     Protocol  : Direct

NextHop    : ::1                                         Preference: 0

Interface  : InLoop0                                     Cost      : 0

 

Destination: FE80::/10                                   Protocol  : Direct

NextHop    : ::                                          Preference: 0

Interface  : InLoop0                                     Cost      : 0

 

Destination: FF00::/8                                    Protocol  : Direct

NextHop    : ::                                          Preference: 0

Interface  : NULL0                                       Cost      : 0

Table 7 Command output

Field

Description

Destinations

Number of destination addresses.

Routes

Number of routes.

Destination

IPv6 address and prefix of the destination network or host.

NextHop

Next hop address of the route.

Preference

Preference of the route.

Interface

Output interface for packets to be forwarded along the route.

Protocol

Protocol that installed the route.

Cost

Cost of the route.

Summary Count

Number of routes.

 

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

<Sysname> display ipv6 routing-table verbose

 

Destinations : 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: 0x20000003          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: InLoop0

 

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

Table 8 Command output

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.

Tag

Tag of the route.

State

Route status:

·     Active—Active unicast route.

·     Adv—Route that can be advertised.

·     Inactive—Inactive route.

·     NoAdv—Route that the router must not advertise.

·     Vrrp—Routes generated by VRRP.

·     TunE—Tunnel.

OrigTblID

Original routing table ID.

OrigVrf

Original VPN that the route belongs to.

TableID

ID of the routing table.

OrigAs

Original AS number.

NibID

ID of the next hop.

LastAs

Last AS number.

AttrID

Attribute ID.

Neighbor

Address of the neighbor determined by the routing protocol.

Flags

Flags of the route.

OrigNextHop

Next hop address of the route.

RealNextHop

Real next hop of the route.

BkLabel

Backup label.

BkNexthop

Backup next hop.

Interface

Output interface for packets to be forwarded along the route.

BkTunnel ID

Backup tunnel ID.

BkInterface

Backup output interface.

 

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 acl-number [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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.

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

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

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

ipv6-address: Specifies a destination IPv6 address.

prefix-length: Specifies the prefix length in the range of 0 to 128.

longer-match: Displays the route entry with the longest prefix.

ipv6-address1 to ipv6-address2: Specifies a destination IPv6 address range.

verbose: Displays detailed routing table information, including information about both active and inactive routes. If you do not specify this keyword, the command displays only brief information about active routes.

Usage guidelines

Executing the command with different parameters yields different output.

·     display ipv6 routing-table ipv6-address

¡     The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.

¡     The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.

If the two operations yield the same result for an entry, the entry is displayed.

·     display ipv6 routing-table ipv6-address prefix-length

¡     The system ANDs the entered destination IPv6 address with the entered prefix length.

¡     The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.

If the two operations yield the same result for an entry with a prefix length not greater than the entered prefix length, the entry is displayed.

·     display ipv6 routing-table ipv6-address longer-match

¡     The system ANDs the entered destination IPv6 address with the prefix length in each active route entry.

¡     The system ANDs the destination IPv6 address in each active route entry with the prefix length in the entry.

If the two operations yield the same result for multiple entries, the entry with the longest prefix length is displayed.

·     display ipv6 routing-table ipv6-address prefix-length longer-match

¡     The system ANDs the entered destination IPv6 address with the entered prefix length.

¡     The system ANDs the destination IPv6 address in each active route entry with the entered prefix length.

If the two operations yield the same result for multiple entries with a prefix length not greater than the entered prefix length, the entry with the longest prefix length is displayed.

·     display ipv6 routing-table ipv6-address1 to ipv6-address2

The system displays route entries with destinations in the range of ipv6-address1/128 to ipv6-address2/128.

Examples

# Display brief information about the routes to the destination IPv6 address 10::1 127.

<Sysname> display ipv6 routing-table 10::1 127

 

Summary Count: 3

 

Destination: 10::/64                                     Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

 

Destination: 10::/68                                     Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

 

Destination: 10::/120                                    Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

# Display brief information about the most specific route to the destination IPv6 address 10::1 and prefix length 127.

<Sysname> display ipv6 routing-table 10::1 127 longer-match

 

Summary Count : 1

 

Destination: 10::/120                                    Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

# Display brief information about the routes to destination addresses in the range of 100:: to 300::.

<Sysname> display ipv6 routing-table 100:: to 300::

 

Summary Count : 3

 

Destination: 100::/64                                    Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

 

Destination: 200::/64                                    Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

 

Destination: 300::/64                                    Protocol  : Static

NextHop    : ::                                          Preference: 60

Interface  : NULL0                                       Cost      : 0

For command output, see Table 7.

display ipv6 routing-table prefix-list

Use display ipv6 routing-table prefix-list to display information about IPv6 routes permitted by an IPv6 prefix list.

Syntax

display ipv6 routing-table [ vpn-instance vpn-instance-name ] prefix-list prefix-list-name [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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

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

Usage guidelines

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

Examples

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

<Sysname> system-view

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

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

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

 

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

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

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays routing information for the public network.

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.

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  : GE1/0/2                                     Cost      : 0

 

Destination: 2::2/128                                    Protocol  : Static

NextHop    : fe80::3                                     Preference: 60

Interface  : GE1/0/2                                     Cost      : 0

 

Destination: 3::3/128                                    Protocol  : Static

NextHop    : 2::2                                        Preference: 60

Interface  : GE1/0/2                                     Cost      : 0

 

Static Routing table Status : <Inactive>

Summary Count : 0

For command output, see Table 7.

display ipv6 routing-table statistics

Use display ipv6 routing-table statistics to display IPv6 route statistics.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays route statistics for the public network.

Examples

# Display IPv6 route statistics for the public network.

<Sysname> display ipv6 routing-table statistics

 

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 9 Command output

Field

Description

Proto

Protocol that installed the route.

route

Number of routes installed by the protocol.

active

Number of active routes.

added

Number of routes added to the routing table after the router started up or the routing table was cleared most recently.

deleted

Number of routes marked as deleted, which will be cleared after a period.

Total

Total number of routes.

 

display ipv6 routing-table summary

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays brief IPv6 routing table information for the public network.

Examples

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

<Sysname> display ipv6 routing-table summary

 

Max ECMP: 16

Max Active Route: 1048576

Remain Active Route: 1048568

# Display brief IPv6 routing table information for VPN instance vpn1.

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

 

Max ECMP: 16

Max Active Route: 1048576

Remain Active Route: 1048568

Threshold value percentage of max active routes: 100%

For command output, see Table 4.

display max-ecmp-num

Use display max-ecmp-num to display the maximum number of ECMP routes.

Syntax

display max-ecmp-num

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display the maximum number of ECMP routes.

<Sysname> display max-ecmp-num

  Max-ECMP-Num in use: 6

  Max-ECMP-Num at the next reboot: 10

Table 10 Command output

Field

Description

Max-ECMP-Num in use

Maximum number of current ECMP routes in use.

Max-ECMP-Num at the next reboot

Maximum number of ECMP routes at the next reboot of the device.

 

display rib attribute

Use display rib attribute to display route attribute information in the RIB.

Syntax

display rib attribute [ attribute-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

attribute-id: Specifies a route attribute by its ID 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

        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

Table 11 Command output

Field

Description

Protocol

Protocol that generates the attribute.

Ext-communities number

Number of the extended community attribute values.

Ext-communities value

Values of the extended community attribute. This field displays N/A when no values exist, and it can display a maximum of 20 values.

Communities number

Number of the COMMUNITY attribute values.

Communities value

Values of the COMMUNITY attribute. This field displays N/A when no values exist, and it can display a maximum of 20 values.

AS-path number

Number of ASs in the AS_PATH attribute.

AS-path value

Values of the AS_PATH attribute, including AS_SET, AS_SEQUENCE, confederation AS_SET, and confederation AS_SEQUENCE. This field displays N/A when no values exist, and it can display a maximum of 20 values.

 

display rib graceful-restart

Use display rib graceful-restart to display RIB GR state information.

Syntax

display rib graceful-restart

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display RIB GR state information.

<Sysname> display rib graceful-restart

RIB GR state     : Phase2-calculation end

RCOM GR State    : Flush end

Protocol GR state:

 No.  Protocol   Lifetime FD   State    Start/End

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

 1    DIRECT     100      30   End      No/No

 2    STATIC     480      34   End      No/No

 3    OSPF       480      36   End      No/No

 4    ISIS       480      32   End      No/No

 5    BGP        480      31   End      No/No

 6    LDP        480      35   End      No/No

 7    SLSP       480      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 unfinishedNSR has not finished optimal route selection.

·     Phase1-calculation end—Optimal route selection phase 1 completes.

·     Notification end—All routes have been delivered to the route management module.

·     Phase2-calculation end—Optimal route selection phase 2 completes.

·     Flush start—Starts to flush routes to the FIB.

·     Flush end—Completes flushing routes to the FIB.

No.

Protocol number.

Lifetime

Lifetime (in seconds) of routes/labels in the RIB during GR.

FD

Handle between the protocol and the RIB.

State

Protocol GR state:

·     InitInitialization state.

·     ListenListening state.

·     Idle.

·     Active.

·     StartGR starts.

·     EndGR 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-name [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

self-originated: Displays information about next hops of self-originated routes in the RIB.

nib-id: Specifies a NIB by its ID 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.

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

 

...

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.

UserKey0

Reserved data 1.

UserKey1

Reserved data 2.

VrfNthp

VPN to which the next hop belongs.

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:

·     IPIP forwarding.

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

 

...

Table 14 Command output

Field

Description

Policy

Tunnel policy name.

x nexthop (s)

Number of next hops.

PrefixIndex

Prefix index of the next hop for an ECMP route.

Vrf

VPN name.

OrigNexthop

Original next hop.

RealNexthop

Real next hop.

Interface

Output interface.

LocalAddr

Local interface address.

RelyDepth

Recursion depth.

TunnelCnt

Number of tunnels after route recursion.

TunnelID

ID of the tunnel after route recursion.

RefCnt

Reference count of the next hop.

FlushRefCnt

Reference count of the next hop that is flushed to the FIB.

Flag

Flag of the next hop.

Version

Version of the next hop.

 

display route-direct nib

Use display route-direct nib to display next hop information for direct routes.

Syntax

display route-direct nib [ nib-id ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

nib-id: Specifies a NIB by its ID 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 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.

UserKey0

Reserved data 1.

UserKey1

Reserved data 2.

VrfNthp

VPN to which the next hop belongs.

Nexthop

Next hop address.

IFIndex

Interface index.

LocalAddr

Local interface IP address.

 

# Display detailed next hop information for direct routes.

<Sysname> display route-direct nib verbose

Total number of nexthop(s): 116

 

      NibID: 0x10000000        Sequence: 0

       Type: 0x1                Flushed: Yes

   UserKey0: 0x0                VrfNthp: 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 16 Command output

Field

Description

x nexthop(s)

Number of next hops.

PrefixIndex

Prefix index of the next hop for an ECMP route.

Vrf

VPN name.

OrigNexthop

Original next hop.

RealNexthop

Real next hop.

Interface

Output interface.

localAddr

Local interface address.

RelyDepth

Recursion depth.

TunnelCnt

Number of tunnels after route recursion.

TunnelID

ID of the tunnel after route recursion.

RefCnt

Reference count of the next hop.

FlushRefCnt

Reference count of the next hop that is flushed to the FIB.

Flag

Flag of the next hop.

Version

Version of the next hop.

 

fib lifetime

Use fib lifetime to set the maximum lifetime for IPv4 or IPv6 routes in the FIB.

Use undo fib lifetime to restore the default.

Syntax

fib lifetime seconds

undo fib lifetime

Default

The maximum lifetime for IPv4 or IPv6 routes in the FIB is 600 seconds.

Views

RIB IPv4 address family view, RIB IPv6 address family view

Predefined user roles

network-admin

mdc-admin

Parameters

seconds: Specifies the maximum lifetime for routes in the FIB, in the range of 0 to 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 configure the maximum number of ECMP routes.

Syntax

max-ecmp-num number

Default

The maximum number of ECMP routes is 16.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

number: Specifies the maximum number of ECMP routes. The value range for this argument is 1 to 32.

Examples

# Configure the maximum number of ECMP routes as 10.

<Sysname> system-view

[Sysname] max-ecmp-num 10

The configuration will take effect at the next reboot. Continue? [Y/N]:y

Reboot device to make the configuration take effect.

After reboot, the maximum number of ECMP routes is 10.

non-stop-routing

Use non-stop-routing to enable RIB NSR.

Use undo non-stop-routing to restore the default.

Syntax

non-stop-routing

undo non-stop-routing

Default

RIB NSR is disabled.

Views

RIB IPv4 address family view, RIB IPv6 address family view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable NSR for the RIB IPv4 address family.

<Sysname> system-view

[Sysname] rib

[Sysname-rib] address-family ipv4

[Sysname-rib-ipv4] non-stop-routing

protocol lifetime

Use protocol lifetime to set the maximum lifetime for IPv4 or IPv6 routes and labels in the RIB.

Use undo protocol lifetime to restore the default.

Syntax

protocol protocol lifetime seconds

undo protocol protocol lifetime

Default

The maximum lifetime for IPv4 or IPv6 routes and labels in the RIB is 480 seconds.

Views

RIB IPv4 address family view, RIB IPv6 address family view

Predefined user roles

network-admin

mdc-admin

Parameters

protocol: Specifies a routing protocol. It can be bgp, direct, isis, ldp, ospf, rip, static, or static-lsp.

seconds: Specifies the maximum lifetime for routes and labels in the RIB, in the range of 1 to 900 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 OSPF routes and labels 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 [ vpn-instance vpn-instance-name ] { protocol | all }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Clears the IPv4 route statistics for an MPLS L3VPN instance specified by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command clears IPv4 route statistics for the public network.

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.

Examples

# Clear all IPv4 route statistics for the public network.

<Sysname> reset ip routing-table statistics protocol all

reset ipv6 routing-table statistics protocol

Use reset ipv6 routing-table statistics protocol to clear IPv6 route statistics.

Syntax

reset ipv6 routing-table statistics protocol [ vpn-instance vpn-instance-name ] { protocol | all }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Clears route statistics for an MPLS L3VPN instance specified by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command clears the IPv6 route statistics for the public network.

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.

Examples

# Clear all IPv6 route statistics for the public network.

<Sysname> reset ipv6 routing-table statistics protocol all

rib

Use rib to enter RIB view.

Use undo rib to remove all configurations in RIB view.

Syntax

rib

undo rib

Views

System view

Predefined user roles

network-admin

mdc-admin

Examples

# Enter RIB view.

<Sysname> system-view

[Sysname] rib

[Sysname-rib]

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网